swremove.1m (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

swremove(1M) swremove(1M)

locate the product’s installed ﬁles. The conﬁgure script is only run when

SW_ROOT_DIRECTORY

is /.

SW_SESSION_OPTIONS

Contains the pathname of a ﬁle containing the value of every option for a particular

command, including software and target selections. This lets scripts retrieve any com-

mand options and values other than the ones provided explicitly by other environment

variables. For example, when the ﬁle pointed to by

SW_SESSIONS_OPTIONS

made available to a request script, the targets option contains a list of

software_collection_specs for all targets speciﬁed for the command. When the ﬁle

pointed to by

SW_SESSIONS_OPTIONS

is made available to other scripts, the targets

option contains the single software_collection_spec for the targets on which the script

is being executed.

SW_SOFTWARE_SPEC

This variable contains the fully qualiﬁed software speciﬁcation of the current product

or ﬁleset. The software speciﬁcation allows the product or ﬁleset to be uniquely

identiﬁed.

Additional environment variables that affect scripts for

swremove are:

PRE_UNIX95

This variable and the UNIX95 variable are exported with a value that forces "classic"

behavior of swremove instead of UNIX95 behavior. For HP-UX 10.30 and later ver-

sions, this variable is set to "1".

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 ﬁleset 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

Indicates whether a reboot is scheduled for a ﬁleset selected for removal. Because all

HP-UX kernel ﬁlesets are also reboot ﬁlesets, 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

"classic" behavior of swremove instead of UNIX95 behavior. For the 10.30 or later

release of HP-UX, this variable is cleared.

Environment variables that affect

swremove in SRP:

SW_ALLOW_LOCAL_SRP_OPS

This variable is usually not set. If it is set to TRUE or 1, this variable allows

swremove to run on a local SRP. If a value other than TRUE or 1 is speciﬁed, or if a

value is not speciﬁed, a local SRP does not support swremove.

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.

12 Hewlett-Packard Company − 12 − HP-UX 11i Version 3: September 2011