HP-UX Reference (11i v1 00/12) - 5 Miscellaneous Topics, 7 Device (Special) Files, 9 General Information, Index (vol 9)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man5/!!!intro.5
________________________________________________________________
___ ___
s
sd(5) sd(5)
(Hewlett-Packard Company)
software is installed to a directory other than /, such as for a cluster client system. This vari-
able should be read only by the configure and postinstall scripts of a kernel fileset. The swin-
stall
command sets these environment variables for use by the kernel preparation and build
scripts.
SW_INITIAL_INSTALL
Only applies to swinstall . This variable is normally unset. If it is set, the swinstall ses-
sion is being run as the back end of an initial system software installation ("cold" install).
SW_KERNEL_PATH
Only applies to swinstall. The path to the kernel. The default value is /stand/vmunix,
defined by the swagent option or kernel_path .
SW_SESSION_IS_KERNEL
Indicates whether a kernel build is scheduled for the current install/remove session. A TRUE
value indicates that the selected kernel fileset is scheduled for a kernel build and that changes to
/stand/system are required. A null value indicates that a kernel build is not scheduled and
that changes to /stand/system are not required.
The value of this variable is always equal to the value of
SW_SESSION_IS_REBOOT
.
SW_SESSION_IS_REBOOT
Indicates whether a reboot is scheduled for a fileset selected for removal. Because all HP-UX
kernel filesets are also reboot filesets, the values of this variables is always equal to the value of
SW_SESSION_IS_KERNEL
.
SW_SYSTEM_FILE_PATH
Only applies to swinstall. The path to the kernel’s system file. The default value is
/stand/system .
Signals
The SD commands catch the signals SIGQUIT, SIGINT, and SIGUSR1. If these signals are received, the
command prints a message, sends a Remote Procedure Call (RPC) to the agents to wrap up after comple-
tion, and then exits.
The agent ignores SIGHUP, SIGINT, and SIGQUIT. It immediately exits gracefully after receiving
SIGTERM, SIGUSR1, or SIGUSR2. Killing the agent may leave corrupt software on the system, and thus
should only be done if absolutely necessary. Note that when an SD command is killed, the agent does not
terminate until completing the task in progress.
The daemon ignores SIGHUP, SIGINT and SIGQUIT. It immediately exits gracefully after receiving
SIGTERM and SIGUSR2. After receiving SIGUSR1, it waits for completion of a copy or remove from a
depot session before exiting, so that it can register or unregister depots if necessary. Requests to start new
sessions are refused during this wait.
The following paragraph applies only to swconfig, swcopy, swinstall, swremove, and swverify.
For SIGUSR1, the command sends an RPC to the agents to quit immediately, as if the agent had received a
SIGTERM signal. When SIGUSR1 is sent to the SD Controller, it shuts down target agents with SD revi-
sion B.11.01 or later, then shuts itself down. When the target agent receives the shutdown RPC, it invokes
its handler for signal 15 (SIGTERM), which resembles what happens if a superuser on the target machine
used a kill command on the target agent process.
Locking
SD commands use a common locking mechanism for reading and modifying both root directories and
software depots. This mechanism allows multiple readers but only one writer on a root or depot.
The SD commands which modify software in an (alternate) root directory are restricted from simultaneous
modification using fcntl(2) locking on the file
var/adm/sw/products/swlock
relative to the root directory (e.g. /var/adm/sw/products/swlock).
The SD commands which modify software in a depot are restricted from simultaneous modification using
fcntl(2) locking on the file
catalog/swlock
Section 5−−324 − 29 − HP-UX Release 11i: December 2000
___
___