HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

s
swremove(1M) swremove(1M)
(Hewlett-Packard Company)
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 value of this variables is always equal to the
value of SW_SESSION_IS_KERNEL
.
SW_SESSION_IS_UPDATE
A value of 1 indicates the SD command was invoked during an Operating System update.
This variable is set by the update-ux
command.
UNIX95 This variable, along with the PRE_U95 variable, is exported with a value that forces "clas-
sic" behavior of swremove instead of
UNIX95 behavior. For the 10.30 or later release of
HP-UX, this variable is cleared.
Signals
The
swremove command catches 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 completion, 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.
Each agent will complete the removal task (if the execution phase has already started) before it wraps up.
This avoids leaving software in a corrupt state.
Terminal Support
For in-depth information about terminal support refer to:
• The Software Distributor Administration Guide.
• Start the GUI or TUI, select the Help menu, then select the Keyboard... option to access the
Keyboard Reference Guide.
RETURN VALUES
An interactive
swremove session always returns 0. A non-interactive
swremove session returns:
0 The software_selections were successfully removed.
1 The remove operation failed on all target_selections.
2 The remove operation failed on some target_selections.
DIAGNOSTICS
The
swremove command writes to stdout, stderr, and to specific log files.
Standard Output
An interactive swremove session does not write to stdout. A non-interactive swremove session writes
messages for significant events. These include:
• a begin and end session message,
• selection, analysis, and execution task messages for each target_selection.
Standard Error
An interactive swremove session does not write to stderr. A non-interactive swremove session writes
messages for all WARNING and ERROR conditions to stderr.
Logging
Both interactive and non-interactive swremove sessions log summary events at the host where the com-
mand was invoked. They log detailed events to the swagent logfile associated with each target_selection.
Section 1M−−992 Hewlett-Packard Company − 11 − HP-UX 11i Version 1: September 2005