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)
relative to the depot directory (e.g. /var/spool/sw/catalog/swlock).
All commands set fcntl(2) read locks on roots and depots using the swlock file mentioned above. When a
read lock is set, it prevents other SD commands from performing modifications (i.e. from setting write
locks).
If an SD process has died prematurely and no other SD agents are running, you can remove the swlock
file to unlock the root or depot.
RETURN VALUES
Each SD command invocation returns:
0 The sw<task> successfully completed.
1 The sw<task> failed on all target_selections.
2 The sw<task> failed on some target_selections.
DIAGNOSTICS
The swconfig, swcopy, swinstall, swmodify, swpackage, swremove, and swverify com-
mands support a preview mode, where operation will proceed through the analysis of each target_selection,
then exit before the actual task is performed.
You can use the sd interactive interface or the
swjob command to view the current status of any job or
the controller and target log files.
Standard Output
When non-interactive, the commands write messages for significant events. These events include:
• a begin and end task message,
• a message for starting the task on each host, and
• a message for completing the task on each host.
When the
verbose option is set, summary messages about the task are also sent to the standard output.
Standard Error
When non-interactive, the commands also write messages for the following significant error events:
• a message for each host failing analysisand
• a message for each host failing the actual task.
Logging
All commands log major events on the host where the command was invoked. They log detailed events to
the swagent log associated with each target_selection.
Command Log
The commands log messages to
/var/adm/sw/sw<task>
.log. (You can specify a different logfile
by modifying the
logfile option.)
Target Log
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 mes-
sages 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
.
Source Depot Audit Log
If both source and target machine are updated to SD revision B11.00 or later, the system administra-
tor 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.
FILES
/dev/rmt/0m
Default source tape location. (Note that SD can read both tar and cpio tape depots.)
/etc/fstab
List of volumes that should be mounted.
HP-UX Release 11i: December 2000 − 30 − Section 5−−325
___
___