sd(5)

The interactive commands support a subset of the standard X Toolkit options to control the appearance of the GUI. The supported options are: -bg, -background, -fg, -foreground, -display, -name, -xrm. and -synchronous. See the X(1) manual page for a definition of these options.

Causes the command to operate on target_selections which are software depots rather than root directories.

(Optional) Causes the command to operate on target_selections that are alternate root directories (root file systems other than /).

Note that you cannot use this option to relocate software during installation. You must use the l=location syntax in the software selection component.

Runs the command in interactive mode (Graphical User Interface).

(HP-UX 10.* only) Runs the command in linkinstall mode, which makes software installed under a server's shared root available to a diskless client's private root.

When run in linkinstall mode, swinstall:

Mounts are created by examining the share_link product attribute. Not all products support linkinstall. Some products may be visible without creating a new mount if they reside under an existing one.

Previews the task by executing the session through the analysis phase and exiting before the command begins to perform the actual task. This option only applies to non-interactive sessions.

Recursively include all objects to the fileset level using swlist, (and to the end_target level using the HP OpenView Software Distributor swjob command).

Undo variation of the operation, unconfiguring software using swconfig, unregistering the specified objects using swreg, (or removing the specified jobs using the HP OpenView Software Distributor swjob command).

Turns on verbose output to stdout. (The command log file is not affected by this option.) By default, verbose output is enabled for all the SD commands.

List the SDU data model revisions that swpackage supports.

Specifies particular attributes to display or modify using swlist, swmodify, (or the HP OpenView Software Distributor swjob command).

Specifies the pathname of an exported catalog which stores copies of the response files created by request scripts.

Save the current options and operands to session_file. You can enter a relative or absolute path with the file name. The default directory for session files is $HOME/.sw/sessions/. You can recall a session file with the -S session_file option. From an interactive session, you can save session information into a file at any time with the File/Save Session or File/Save Session As option. You can save session information from a command-line session with the -C session_file option. In addition, each command automatically creates a session file of the most recent session information and names the file $HOME/.sw/sessions/sw<task>.last.

Deletes an existing entry from the ACL associated with the specified objects using swacl.

Read the list of selections from software_file instead of (or in addition to) the command line operands.

Assigns the ACL contained in acl_file to the specified object using swacl.

(HP OpenView Software Distributor only) Executes the previously scheduled job. This option is used by the swagentd to initiate scheduled jobs.

List all objects at the specified level when using swlist, or define the level of the objects when using swacl, or swreg.

Adds a new ACL entry or changes the permissions of an existing entry using swacl.

(HP OpenView Software Distributor only) Schedules the command for the specified date and time.

Specifies source depot, PSF file, or tape from which software will be installed, copied, listed, or packaged.

Execute swinstall or swcopy based on the options and operands saved from a previous session, as defined in session_file. You can save session information to a file with the -C session_file option.

Read the list of target_selections from target_file instead of (or in addition to) the command line operands.

Set the session option to value and override the default value (or a value in an alternate option_file specified with the -X option). Multiple -x options can be specified.

Read the session options and behaviors from option_file. These values defined in this file override the default values.

the system-wide default values.

the user-specific default values.

The location of the agent program invoked by the daemon.

Applies to swagentd.

Causes the target agent to automatically exit after Execute phase, or after a failed Analysis phase. This is forced to false when the controller is using an interactive UI, or when -p (preview) is used. This enhances network reliability and performance. The default is true means the target agent automatically exits when appropriate. If set to false, the target agent will not exit until the controller ends the session.

Applies to swconfig, swcopy, swinstall, swremove, swverify.

Causes a target agent to exit if it has been inactive for the specified time. This can be used to make target agents more quickly detect lost network connections since RPC can take as long as 130 minutes to detect a lost connection. The recommended value is the longest period of inactivity expected in your environment. For command line invocation, a value between 10 minutes and 60 minutes is suitable. A value of 60 minutes or more is recommended when the GUI will be used. The default of 10000 is slightly less than 7 days.

Applies to swcopy, swinstall, swjob, swlist, swremove, swverify.

Prevents the installation of an older revision of fileset that already exists at the targets. (Many software products do not support "downdating".) If set to true, the older revision can be installed.

Applies to swinstall.

Requires that the software products which are being installed be "compatible" with the target selections. (All of the target selections must match the list of supported systems defined for each selected product.) If set to true, target compatibility is not enforced.

Applies to swconfig, swinstall, and swverify.

Prevents the installation or configuration of another, independent version of a product when a version already is already installed or configured at the target.

If set to true, another version of an existing product can be installed into a new location, or can be configured in its new location. Multiple versions can only be installed if a product is locatable. Multiple configured versions will not work unless the product supports it.

Applies to swconfig, swinstall, and swverify.

Defines the alternate source which the agent will use when the use_alternate_source option is set to true. The alternate source is specified using the syntax:

If the host portion is not specified, then the local host is used. If the path portion is not specified, then the path sent by the command is used. The protocol sequence and endpoint given by the option swagent.rpc_binding_info are used when the agent attempts to contact an alternate source depot.

Applies to swagent.

Executes a request script, which asks for a user response. If ask=as_needed, swinstall executes the request script only if a response file does not already exist in the control directory. See swask(1M) for more information on request scripts.

Applies to swask, swconfig, and swinstall.

Normally set to true. Specifies whether the removal of a kernel fileset should rebuild the kernel or not. If the kernel rebuild succeeds, the system automatically reboots. If set to false, the system continues to run the current kernel.

If the auto_kernel_build option is set to true, the autoreboot option must also be set to true. If the auto_kernel_build option is set to false, the value of the autoreboot option does not matter.

Applies to swremove only.

Prevents the installation or removal of software requiring a reboot from the non-interactive interface. If set to true, then software can be installed or removed, after which the target system(s) will automatically reboot.

An interactive session always asks for confirmation before software requiring a reboot is installed or removed.

If the auto_kernel_build option is set to true, the autoreboot option must also be set to true. If the auto_kernel_build option is set to false, the value of the autoreboot option does not matter.

Applies to swinstall and swremove.

Causes swinstall to remove the original files as they are updated. If an error occurs during the installation (e.g. network failure), then the original files are lost, and the installation must be re-tried.

If set to true, all files are saved as backup copies until all filesets in the current product loading are complete; then they are removed. At the cost of a temporary increase in disk space and slower performance, this allows for automatic recovery of the original filesets in that product if the load fails.

Applies only to swinstall.

Controls automatic job removal of completed jobs. If the job is automatically removed, job information (job status or target log files) cannot be queried with swjob.

Install jobs to PCs can not be automatically removed. They should not be removed until the job completes on all PC targets.

Controls the automatic selection of prerequisite and corequisite software that is not explicitly selected by the user. When set to true, the requisite software is automatically selected for configuration. When set to false, requisite software which is not explicitly selected is not automatically selected for configuration.

Applies to swconfig, swcopy, swinstall, and swverify.

Controls the automatic selection of dependent software that is not explicitly selected by the user. A dependent is the opposite of a requisite. A dependent fileset has established either a prerequisite or a corequisite on the fileset under discussion. Specifying true causes dependent software to be automatically selected for the operation. The default, false causes dependent software, which is not explicitly selected, to not be automatically selected for the operation.

Applies to swconfig and swremove.

Automatically selects the latest patches (based on superseding and ancestor attributes) for a software object that a user selects for a swinstall or swcopy operation. When set to false, the patches corresponding to the selected object will not be automatically selected.

The patch_filter option can be used in conjunction with autoselect_patches.

Applies to swask, swinstall, and swcopy.

If true, bundles that are sticky will be automatically installed, or copied, along with the software it is made up of. If false, the software can be installed, or copied, without automatically including sticky bundles that contain it.

For swremove, if set to true, any bundle with the is_sticky attribute set to true is removed automatically when the last of its contents is removed. If set to false, the sticky bundles will not be automatically removed.

Applies to swcopy, swinstall, and swremove.

Causes swverify to verify the time stamp, size, and checksum attributes of files. If set to false, these attributes are not verified.

Applies to swverify.

Causes swverify to verify the mode, owner, UID, group, and GID attributes of installed files. If set to false, these attributes are not verified.

Applies to swverify.

Causes swverify to verify that the prerequisite and corequisite dependencies of the software selections are being met. If set to false, these checks are not performed.

Applies to swverify.

Causes swverify to run the fileset/product verify scripts for installed software. If set to false, these scripts are not executed.

Applies to swverify.

Causes swverify to not verify those files marked as volatile (i.e. can be changed). If set to true, volatile files are also checked (for installed software).

Applies to swverify.

Provides the "codeword" needed to unlock protected HP CD-ROM software.

Some HP software products are shipped on CD-ROM as "protected" products. That is, they cannot be installed or copied unless a "codeword" and "customer ID" are provided. The codeword is found on the CD-ROM certificate which you received from HP. You may use this default specification on the command line or the SD-UX Interactive User Interface to enter the codeword.

This default stores the codeword for future reference; it needs to be entered only once. If a new HP product is purchased and a previous codeword has already been entered for that CD-ROM, just enter the new codeword as usual and the codewords will be merged internally.

Defines the command called to compress files before installing, copying or packaging. If the compression_type option is set to other than gzip or compress, this path must be changed.

Applies to swpackage and swagent.

If set to true, files are compressed, if not already compressed, before transfer from a source. This will enhance performance on slower networks for swcopy and swinstall. and will result in smaller depots for swcopy and swpackage, unless the uncompress_files is also set to true.

Applies to swcopy, swinstall, and swpackage.

Defines the default compression type used by the agent when it compresses files during or after transmission. If uncompress_files is set to false, the compression_type is recorded for each file compressed so that the correct uncompression can later be applied during a swinstall, or a swcopy with uncompress_files set to true. The compress_cmd specified must produce files with the compression_type specified. The uncompress_cmd must be able to process files of the compression_type specified unless the format is gzip, which is uncompressed by the internal uncompressor (funzip).

Applies to swagent.

Defines the script called by the agent to perform release-specific configure cleanup steps.

Applies to swagent.

When adding or deleting control file objects, this option lists the tags of those control files. There is no supplied default. If there is more than one tag, they must be separated by whitespace and surrounded by quotes.

Applies to swmodify.

Specifies the location of a depot for the controller to access to resolve selections. Setting this option can reduce network traffic between the controller and the target. Use the target selection syntax to specify the location:

This option has no effect on which sources the target uses and is ignored when used with an Interactive User Interface.

Applies to swcopy, swconfig, swinstall, swremove, and swverify.

If creating a target depot, swpackage will create Access Control Lists (ACLs) for the depot (if it is new) and all products being packaged into it. If set to false, and if the user is the superuser, swpackage will not create ACLs. (The swpackage command never creates ACLs when software is packaged on to a distribution tape.)

Applies to swpackage.

Causes the agent to create the target directory if it does not already exist. If set to false, a new target directory will not be created. This option can prevent the erroneous creation of new target depots.

Applies to swcopy and swinstall.

This number, also printed on the Software Certificate, is used to "unlock" protected software and restrict its installation to a specific site or owner. It is entered using the -x customer_id= option or by using the Interactive User Interface. The customer_id can be used on any HP-UX 10.0X compatible HP9000 system.

Causes swinstall to automatically configure the software_selections after they are installed. When an alternate root directory is specified, swinstall never performs the configuration task, since only hosts using the software should be configured. If set to true, this option allows configuration to be deferred even when the root directory is /.

When installing a successive version of a product, it will not be configured if another version is already configured. The swconfig command must be run separately.

Applies to swinstall.

Defines the default distribution directory to read as the source (when the source_type is directory). The -s option overrides this default.

Applies to swcopy, swinstall, and swpackage.

Defines the default distribution directory of the target depot. The target_selection operand overrides this default.

Applies to swacl, swcopy, swlist, swmodify, swpackage, swreg, swremove, and swverify.

Defines the default location of the target tape device file. The target_selection operand overrides this default.

Applies to swpackage.

Requires that all dependencies specified by the software_selections be resolved either in the specified source, or at the target_selections themselves.

The swconfig, swcopy, and swinstall commands will not proceed unless the dependencies have also been selected or already exist at the target in the correct state (INSTALLED, CONFIGURED, or AVAILABLE). This prevents unusable software from being installed on the system. It also ensures that depots contain usable sets of software.

For swremove, if a selected fileset has dependents (i.e. other software depends on the fileset) and they are not selected, do not remove the selected filesets.

If set to false, dependencies will still be checked, but not enforced. Corequisite dependencies, if not enforced, may keep the selected software from working properly. Prerequisite dependencies, if not enforced, may cause the installation or configuration to fail.

Applies to swconfig, swcopy, swinstall, swremove, and swverify.

Prevents a command from proceeding past the analysis phase if the disk space required is beyond the available free space of the impacted file systems. If set to false, then the install, copy, or package operation will use the file systems' minfree space and may fail because it reaches the file system's absolute limit.

Applies to swcopy, swinstall, and swpackage.

Prevents swinstall from proceeding past the kernel build phase if the kernel build processes fail. If set to false, then the install operation will continue (without suspension if in the interactive mode) despite failure or warnings from either the system preparation process or the kernel build process.

Applies to swinstall.

If a fileset/product checkinstall or checkremove script fails (i.e. returns with exit code 1), none of the filesets in that product will be installed or removed. If set to false, the install or remove operation will proceed even when a check script fails.

Applies to swinstall and swremove.

When adding or deleting file objects, this option lists the pathnames of those file objects. There is no supplied default. If there is more than one pathname, they must be separated by whitespace.

Applies to swmodify.

Do not follow symbolic links in the package source files, but include the symbolic links in the packaged products. A value of true for this keyword causes swpackage to follow symbolic links in the package source files and include the files they reference in the packaged products.

Applies to swpackage.

By default, the job information is removed from the central controller only after removing the job information stored on each of the targets succeeds. If the job should be removed regardless of the success of the removal of job information from targets, set this option to true.

Applies to swjob.

This option applies only to the Interactive User Interface when no SD-OV license is in effect on a system that is a diskless server. It causes swremove to run in a single target mode, even though a diskless server normally causes swremove to run in multi-target mode.

Do not include each source file's revision attribute in the products being packaged. Because this operation is time consuming, by default the revision attributes are not included. If set to true, swpackage will execute what(1) and possibly ident(1) (in that order) to try to determine a file's revision attribute.

Applies to swpackage.

Defines the script called by the agent to perform release-specific install cleanup steps immediately after the last postinstall script has been run. For an OS update, this script should at least remove commands that were saved by the install_setup script. This script is executed after all filesets have been installed, just before the reboot to the new operating system.

Applies to swagent.

Defines the script called by the agent to perform release-specific install preparation. For an OS update, this script should at least copy commands needed for the checkinstall, preinstall, and postinstall scripts to a path where they can be accessed while the real commands are being updated. This script is executed before any kernel filesets are loaded.

Applies to swagent.

Defines the polling interval, in minutes, used by the daemon. It specifies how often a PC install job will be polled in order to cache the progress of remote targets on the controller.

Applies to swinstall.

This is an ASCII string giving a title to a job. It is displayed along with the job ID to provide additional identifying information about a job when swjob is invoked.

Applies to swconfig, swcopy, swinstall, swremove, and swverify.

Defines the script called by the agent for kernel building.

Applies to swagent.

Defines the path to the system's bootable kernel. This path is passed to the kernel_build_cmd via the SW_KERNEL_PATH environment variable.

Applies to swagent.

Specifies the POSIX layout_version to which the SD commands conform when writing distributions and swlist output. Supported values are "1.0" (default) and "0.8". SD for HP-UX version 10.10 and later can read or write either layout version.

SD object and attribute syntax conforms to the layout_version 1.0 specification of the IEEE POSIX 1387.2 Software Administration standard. SD commands still accept the keyword names associated with the older layout version, but you should use layout_version=0.8 only to create distributions readable by older versions of SD.

The version used by swpackage can be controlled by specifying the layout_version attribute in the product specification file (PSF). However, if the layout_version attribute in the PSF is 1.0, the is_locatable attribute defaults to true in all cases, and must be explicitly set to false. (See swpackage(4) for more information on PSFs.)

Layout version 1.0 adds significant functionality not recognized by systems supporting only 0.8, including:

In addition to adding new attributes and objects, layout_version 1.0 changes the following preexisting 0.8 objects and attributes as follows:

Applies to swpackage, swcopy, swmodify, and swlist.

Specifies a software level for swlist, swacl, or swreg.

For swlist:

Lists all objects down to the specified level. Both the specified level(s) and the depth of the specified software_selections control the depth of the swlist output. The supported software levels are:

The supported depot and root levels are:

The machine, user, and group levels apply only to HP OpenView Software Distributor PC target files.

For swacl:

The level option defines the level of ACLs to view or modify:

For swreg:

The level option defines the level of object to register or unregister:

Applies to swacl, swlist, and swreg.

Controls whether numeric identification numbers are prepended to logfile messages produced by SD:

Applies to swconfig, swcopy, swinstall, swreg, swremove, and swverify.

The logdetail option controls the amount of detail written to the log file. When set to true, this option adds detailed task information (such as options specified, progress statements, and additional summary information) to the log file. This information is in addition to log information controlled by the loglevel option.

Here are the possible combinations of loglevel and logdetail options:

Applies to swconfig, swcopy, swinstall, swreg, swremove, and swverify.

Defines the default log file for each SD command. (The agent log files are always located relative to the target depot or target root, e.g. /var/spool/sw/swagent.log and /var/adm/sw/swagent.log.)

Applies to all commands except swacl, swlist, and swjob (HP OpenView Software Distributor).

Controls the log level for the events logged to the command logfile, the target agent logfile, and the source agent logfile by prepending identification numbers to SD logfile messages. This information is in addition to the detail controlled by the logdetail option. See logdetail for more information.

A value of

Applies to swconfig, swcopy, swinstall, swmodify, swpackage, swremove, and swverify.

If set to true, software selection is done by locating filesets on the source that match the target system's installed filesets. If multiple targets are specified, the first in the list is used as the basis for selections.

Applies to swinstall.

The maximum number of agents that are permitted to run simultaneously. The value of -1 means that there is no limit.

Applies to swagentd.

If creating a distribution tape, this keyword specifies the capacity of the tape in Mbytes. This option is required if the media is not a DDS tape or a disk file. Without this option, swpackage sets the size to 1330 Mbytes for tape and "free space up to minfree" on a disk file.

Applies to swpackage.

Defines the type of distribution to create. The recognized types are directory and tape.

Applies to swpackage.

Defines how often, in minutes, the daemon will wake up and scan the job queue to determine if any scheduled jobs need to be initiated or if any PC install jobs need their remote target status cached locally (see job_polling_interval ). If set to 0, no scheduled jobs will be initiated, and no caching of PC install jobs will occur.

Applies to swagentd.

By default, the SD commands attempt to mount all filesystems in the /etc/fstab file at the beginning of the analysis phase, to ensure that all listed filesystems are mounted before proceeding. This policy helps to ensure that files are not loaded into a directory that may be below a future mount point, and that the expected files are available for a remove or verify operation.

If set to false, the mount operation is not attempted, and no check of the current mounts is performed.

Applies to swconfig, swcopy, swinstall, swremove, and swverify.

Defines the command called by the agent to mount all filesystems.

Applies to swagent.

Defines the default objects to register or unregister. There is no supplied default (see select_local above). If there is more than one object, they must be separated by spaces.

Applies to swreg.

Defines the attributes which are listed in the non-verbose listing.

Applies to swlist and HP OpenView Software Distributor's swjob.

This option can be used in conjunction with os_release to specify fileset selection for an HP-UX update. os_name should only be specified from the command line. Refer to the SD readme file for correct syntax. You can display the readme file by entering:

swlist -d -a readme SW-DIST [@ host:/depot ]

Applies to swinstall.

This option can be used in conjunction with os_name to specify fileset selection for an HP-UX update. os_release should only be specified from the command line. Refer to the SD readme file for correct syntax. You can display the readme file by entering:

swlist -d -a readme SW-DIST [@ host:/depot ]

Applies to swinstall.

If set to true, swpackage will package the specified products such that the target depot will not contain the files that make up a product. Instead, swpackage inserts references to the original source files used to build a product. This behavior allows products to be packaged without consuming the full disk space of copying all the source files into the target depot.

Applies to swpackage.

Commits a patch by removing files saved for patch rollback. When set to true, and run with swmodify, you cannot roll back (remove) a patch unless you remove the associated base software that the patch modified.

Applies to swmodify.

Specifies a software_specification for a patch filter. The default value is *.*.

This option can be used in conjunction with the autoselect_patches and patch_match_target options to filter the selected patches to meet the criteria specified by software_specification.

Applies to swask, swcopy, and swinstall,

If set to true, this option selects the latest patches (software identified by the is_patch attribute) that correspond to software on the target root or depot.

The patch_filter= option can be used in conjunction with patch_match_target.

Applies to swcopy and swinstall.

Specifies the attributes displayed for each object listed when the -l patch option is invoked and when no -a or -v option is specified. The default display attributes are title and patch_state.

Applies to swlist and swjob.

Saves patched files, which permits future rollback of patches. When set to false, patches cannot be rolled back (removed) unless the base software modified by the patch is removed at the same time.

Applies to swinstall.

The status information displayed for a PC install job is as recent as the last time the daemon polled remote targets for information (see the option job_polling_interval). If the most recent status is wanted set this option to true.

Applies to swjob.

Defines in seconds the polling interval used by interactive (GUI) sessions. It specifies how often each target agent will be polled to obtain status information about the task being performed. When operating across wide-area networks, the polling interval can be increased to reduce network overhead.

Applies to swcopy, swinstall, and swremove.

Defines the command called by the agent to reboot the system.

Applies to swagent.

Prevents software which is already in the CONFIGURED state from being reconfigured. If set to true, CONFIGURED software can be reconfigured.

Applies to swconfig.

Causes swcopy to register a newly created depot with the local swagentd. This action allows other SD commands to automatically "see" this depot. If set to false, a new depot will not be automatically registered. (It can be registered later with the swreg command.)

Applies to swcopy.

Causes swinstall to register a newly created alternate root with the local swagentd. This action allows other SD commands to automatically "see" this root. If set to false, a new root will not be automatically registered. (It can be registered later with the swreg command.)

Applies to swinstall.

When re-installing (or re-copying) an existing version of a fileset, this option causes that fileset to be skipped, i.e. not re-installed. If set to true, the fileset will be re-installed (re-copied).

Applies to swinstall and swcopy.

Causes all the files in a fileset to always be re-installed, re-copied, or re-packaged, even when the file already exists at the target and is identical to the new file. If set to false, files that have the same checksum (see next option), size and time stamp will not be re-installed, re-copied, or re-packaged. This check enhances performance on slow networks or slow disks.

Applies to swinstall, swcopy, and swpackage.

This option affects the operation when the reinstall_files option is set to false. It causes the checksums of the new and old file to be computed and compared to determine if the new file should replace the old one. (The checksum is slower, but is a more robust way to check for files being equivalent.) If set to false, the checksums are not computed, and files are (not) reinstalled based only on their size and time stamp. For swpackage, the default value for this option is false.

Applies to swcopy, swinstall, and swpackage.

Remove an empty depot when the last product is removed. If set to false, an empty depot will not be removed, preserving any depot ACLs.

Applies to swremove.

When an install job to a PC is removed the software associated with that job is automatically removed from the PC depot. If the software that is part of this job is the same software being used by another job, then be sure to not delete the software as part of the job removal. If the software on the PC depot should be retained, set this option to false.

Applies to swjob.

Controls whether swcopy automatically removes obsolete filesets from target products in the target depot. If set to true, swcopy removes obsolete filesets from the target products that were written to during the copy process. Removal occurs after the copy is complete. Filesets are defined as obsolete if they were not part of the most recent packaging of the product residing on the source depot.

Applies to swcopy.

Defines the script called by the agent to perform release-specific removal preparation. For an OS update, this script invokes the tlink command when a fileset is removed.

Applies to swagentd.

Defines the number of times a lost source connection will be retried during file transfers. A lost connection is one that has timed out. When used in conjunction with the rpc_timeout option, the success of installing over slow or busy networks can be increased. If set to zero, then any rpc_timeout to the source will cause the task to abort. If set from 1 to 9, then the install of each fileset will be attempted that number of times. The reinstall_files option should also be set to false to avoid installing files within the fileset that were successfully installed.

Applies to swcopy and swinstall.

Defines the protocol sequence(s) and endpoint(s) on which the daemon listens and on which the other commands use to contact the daemon. If the connection fails for one protocol sequence, the next is attempted. SD supports both the tcp (ncacn_ip_tcp:[2121]) and udp (ncadg_ip_udp:[2121]) protocol sequence on most platforms.

The value (or values for swagentd) can have following form:

Applies to all commands except swask, swpackage, and swmodify.

Defines the protocol sequence(s) and endpoint(s) used when the agent attempts to contact an alternate source depot specified by the alternate_sourceoption. HP-UX supports both the udp(ncadg_ip_udp:[2121]) and tcp(ncacn_ip_tcp:[2121]) protocol sequence/endpoint. SD on SunOS only supports udp (ncadg_ip_udp:[2121]). By default udp is used.

Applies to swagentd.

Relative length of the communications timeout. This is a value in the range from 0 to 9 and is interpreted by the DCE RPC. Higher values mean longer times; you may need a higher value for a slow or busy network. Lower values will give faster recognition on attempts to contact hosts that are not up, or are not running swagentd. Each value is approximately twice as long as the preceding value. A value of 5 is about 30 seconds for the ncadg_ip_udp protocol sequence. This option may not have any noticeable impact when using the ncacn_ip_tcp protocol sequence.

Applies to all commands except swpackage and swmodify.

If no target_selections are specified, select the default target_directory of the local host as the target_selection for the command.

Applies to swacl, swconfig, swcopy, swinstall, swlist, swreg, swremove, and swverify.

Defines the default software_selections. There is no supplied default. If there is more than one software selection, they must be separated by spaces. Software is usually specified in a software input file, as operands on the command line, or in the GUI.

Applies to all commands except swreg and HP OpenView Software Distributor's swjob.

Indicates the software view to be used by the interactive interface of the commands and by swlist for the default listing level. It can be set to products, all_bundles, or a bundle category tag (to indicate to show only bundles of that category).

Applies to swcopy, swinstall, swlist, and swremove.

Defines the default location of the source CD-ROM. This syntax can be host:path.

Applies to swinstall.

If both source and target machine are updated to HP-UX version 10.30 or later, the system administrator at the source depot machine can set this option to track which user pulls which software from a depot on the source machine and when the software is pulled. (Note that a user running swinstall/swcopy from a target machine cannot set this option; only the administrator of the source depot machine can set it.)

When source_depot_audit is set to true, a swaudit.log file is created on the source depot (for writable directory depots) or in /var/tmp (for tar images, CD-ROMs, or other non-writable depots).

Users can invoke the swlist interactive user interface (using swlist -i -d) to view, print, or save the audit information on a remote or local depot. Users can view audit information based on language preference, as long as the system has the corresponding SD message catalog files on it. For example, a user can view the source audit information in Japanese during one invocation of swlist, then view the same information in English at the next invocation.

Applies to swagent, swinstall, and swlist.

Defines the default location of the source product specification file (PSF). The host:path syntax is not allowed, only a valid path can be specified. The -s option overrides this value.

Applies to swpackage and swmodify.

Defines the default location of the source tape, usually the character-special file of a local tape device. If the host:path syntax is used, the host must match the local host. The -s option overrides this value.

Applies to swcopy and swinstall.

Defines the default source type: cdrom, file, directory, or tape. The source type derived from the -s option overrides this value.

Applies to swcopy, swinstall, and swpackage. (The values cdrom, and tape apply to swcopy and swinstall only. The value file applies to swpackage only.)

Defines the path to the kernel's template file. This path is passed to the system_prep_cmd via the SW_SYSTEM_FILE_PATH environment variable.

Applies to swagent.

Defines the kernel build preparation script called by the agent. This script must do any necessary preparation so that control scripts can correctly configure the kernel about to be built. This script is called before any kernel filesets have been loaded.

Applies to swagent.

Defines the default target_selections. There is no supplied default (see select_local above). If there is more than one target selection, they must be separated by spaces. Targets are usually specified in a target input file, as operands on the command line, or in the GUI.

Applies to all commands.

Defines the command to uncompress files when installing, copying, or packaging. This command processes files which were stored on the media in a compressed format. If the compression_type of the file is gzip then the internal uncompression (funzip) is used instead of the external uncompress_cmd.

Applies to swpackage and swagent.

If the files being transferred from a source are compressed, setting this option will uncompress the files before storing them on the target depot.

Applies to swcopy and swpackage.

Empowers each target agent to use its own, configured alternate source, instead of the one specified by the user. If false, each target agent will use the same source, namely the source specified by the user and validated by the command. If true, each target agent will instead use its own configured value for the source.

Applies to swcopy and swinstall.

Controls the verbosity of a non-interactive command's output:

For the swlist command, a verbose listing includes all attributes that have been defined for the appropriate level of each software_selection operand. The attributes are listed, one per line, prefaced by the attribute keyword.

The -v option overrides this default if it is set to 0.

Applies to all commands.

Prevents the installation, copying, or packaging of files to a target which exists on a remote (NFS) file system. Also prevents the removal of files from a remote file system. All files destined for (or already on) a remote file system will be skipped.

If set to true and if the superuser has write permission on the remote file system, the remote files will not be skipped, but will be installed, copied, packaged, or removed.

Applies to swcopy, swinstall, swpackage, and swremove.

the system-wide default list of hosts,

the user-specific default list of hosts.

the system-wide default list of patch filters.

the user-specific default list of patch filters.

Determines the language in which messages are displayed. If LANG is not specified or is set to the empty string, a default value of C is used. See lang(5) for more information.

NOTE: The language in which the SD agent and daemon log messages are displayed is set by the system configuration variable script, /etc/rc.config.d/LANG. For example, /etc/rc.config.d/LANG, must be set to LANG=ja_JP.SJIS or LANG=ja_JP.eucJP to make the agent and daemon log messages display in Japanese.

This variable applies to all SD commands except swgettools.

Defines the current directory of the script being executed, either a temporary catalog directory, or a directory within in the Installed Products Database (IPD). This variable tells scripts where other control scripts for the software are located (e.g. subscripts).

Defines the location of the product, which may have been changed from the default product directory. When combined with the SW_ROOT_DIRECTORY, this variable tells scripts where the product files are located.

A PATH variable which defines a minimum set of commands available to for use in a control script (e.g. /sbin:/usr/bin).

Defines the root directory in which the session is operating, either "/" or an alternate root directory. This variable tells control scripts the root directory in which the products are installed. A script must use this directory as a prefix to SW_LOCATION to locate the product's installed files. The configure script is only run when SW_ROOT_DIRECTORY is "/".

Contains the pathname of a file containing the value of every option for a particular command, including software and target selections. This lets scripts retrieve any command options and values other than the ones provided explicitly by other environment variables. For example, when the file pointed to by SW_SESSIONS_OPTIONS is made available to a request script, the targets option contains a list of software_collection_specs for all targets specified for the command. When the file 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.

This variable contains the fully qualified software specification of the current product or fileset. The software specification allows the product or fileset to be uniquely identified.

Only applies to swinstall. This variable is normally unset. If it is set, the actions necessary for preparing the system file /stand/system cannot be accomplished from within the postinstall scripts, but instead must be accomplished by the configurescripts. This occurs whenever software is installed to a directory other than /, such as for a cluster client system. This variable should be read only by the configure and postinstall scripts of a kernel fileset. The swinstall command sets these environment variables for use by the kernel preparation and build scripts.

Only applies to swinstall. This variable is normally unset. If it is set, the swinstall session is being run as the back end of an initial system software installation ("cold" install).

Only applies to swinstall. The path to the kernel. The default value is /stand/vmunix, defined by the swagent option or kernel_path.

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.

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.

Only applies to swinstall. The path to the kernel's system file. The default value is /stand/system.

The commands log messages to /var/adm/sw/sw<task>.log. (The user can specify a different logfile by modifying the logfile option.)

A swagent process performs the actual swacl, swconfig, swcopy, swinstall, swremove, and swverify operation at each target_selection. For operations on target root objects, the swagent logs messages to the file var/adm/sw/swagent.log beneath the root directory (e.g. / or an alternate root directory). For operations on target depot objects, the swagent logs messages to the file swagent.log beneath the depot directory (e.g. /var/spool/sw).

The swagentd running on a host logs events to the file /var/adm/sw/swagentd.log.

If both source and target machine are updated to HP-UX version 10.30 or later, the system administrator at the source depot machine can track which user pulls which software from a depot on the source machine and when the software is pulled. Refer to the source_depot_audit option in swagent(1M) for more information.