shlib_debug_enable.5 (2010 09)

s
shlib_debug_enable(5)
HP Integrity Systems Only
shlib_debug_enable(5)
(Tunable Kernel Parameters)
NAME
shlib_debug_enable - dynamically enable or disable online shared library debugging support
VALUES
Fail Safe
0 (off)
Default
0 (off) shlib_debug_enable
semantics is disabled
Allowed values
0 (off)
1 (on)
DESCRIPTION
This tunable dynamically enables (1) or disables (0) the online shared library debugging feature. When
this tunable is enabled, shared libraries of a running (active) application can be debugged.
Who Is Expected to Change This Tunable?
System administrators and developers who want to change the default behavior of
shlib_debug_enable
.
Restrictions on Changing
Changes to this tunable take effect immediately. There is no need to reboot the system.
When Should the Tunable Be Turned On?
When there is a need to debug a shared library of a running (active) application, this tunable can be
turned on.
When this feature/tunable is not enabled, debugging of shared libraries can be done at application start
time through the
chatr +dbg command. See chatr (1).
What Are the Side Effects of Turning the Tunable On?
If an application which is being debugged for shared libraries is not MPAS (Mostly Private Address
Space) executable, then the application will be converted to an MPAS executable type. After the conver-
sion, all rules which apply to regular MPAS executable type does apply to the converted application until
the process exits. The rules apply even after being detached from the debugger.
When Should the Tunable Be Turned Off?
Administrators and/or developers who will not need the online debugging feature of shared libraries.
What Are the Side Effects of Turning the Tunable Off?
When this tunable is disabled, then online debugging of shared libraries will not be possible beyond the
existing hardware break point facility. With hardware break points, only a limited number of break-
points can be set.
What Other Tunables Should Be Changed at the Same Time?
None.
WARNINGS
All HP-UX kernel tunable parameters are release specific. This parameter may be removed or have its
meaning changed in future releases of HP-UX.
Installation of optional kernel software, from HP or other vendors, may cause changes to tunable parame-
ter values. After installation, some tunable parameters may no longer be at the default or recommended
values. For information about the effects of installation on tunable values, consult the documentation for
the kernel software being installed. For information about optional kernel software that was factory
installed on your system, see HP-UX Release Notes at
http://www.hp.com/go/hpux-core-docs.
AUTHOR
shlib_debug_enable was developed by HP.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1