V10/man/adm/man8/ship.8

.TH SHIP 8
.CT 1 comm_mach sa_nonmortals
.SH NAME
ship, shipstat \(mi automatic software distribution
.SH SYNOPSIS
.B ship
[
.I option ...
]
[
.I file ...
]
.PP
.B shipstat
.SH DESCRIPTION
.I Ship
distributes the named files to other computers, where
the files are installed under the same names.
Shipping privileges are determined
by the network manager on the receiving machine;
see
.IR svcmgr (8).
.PP
Destinations are taken from environment variable
.BR dest ,
or from
.F /usr/lib/asd/dest/default
if
.B dest
is empty.
If a destination is the name of a file in
.FR /usr/lib/asd/dest ,
it is replaced by the contents of that file,
each word of which is then examined in the same way.
Otherwise the destination is a network address.
The sending machine is omitted unless explicitly named in
the environment variable,
or unless option
.B -f
is present or environment variable
.B force
has a non-empty value.
.PP
.I Ship
uses
.I inspkg
and 
.IR mkpkg (8)
to do its work.
Links among the named files are imitated
on the receiving computer, and
named files that do not exist on the sending
computer are deleted on the receiving computer.
Other options are the same as those of
.IR mkpkg :
.PP
.TP \w'\-X file 'u
.B -v
Emit running commentary on the standard error file.
.TP
.BI -D path1 = path2
Pretend that any
.I file
name that begins with
.I path1
really begins with
.IR path2 .
Relative pathnames are extended to full pathnames before comparison.
.TP
.BI -x command
.br
.ns
.TP
.BI -X file
Include in the package instructions to execute the shell
.I command
or run the shell script
.I file
after all files have been installed.
Only one of these options may occur.
The
.I file 
name in
.BR -X
is affected by
.BR -D .
.PP
Shipments are generally acknowledged by mail after each destination
has been tried at least once;
see
.IR asd (8)
for details.
.PP
.I Shipstat
reports the status of all its caller's
incomplete shipments,
with the most recent first.
.SH FILES
.TF/usr/lib/asd/dest/default
.TP
.F /usr/lib/asd/dest/*
distribution lists
.TP
.F
/usr/lib/asd/dest/default
default distribution list
.TP
.BI /usr/spool/asd/ logname
outgoing spool directories
.SH SEE ALSO
.IR mkpkg (8),
.IR asd (8),
.IR svcmgr (8)
.SH BUGS
The
.B -f
option, if given, must be the first option and
must not be combined with any other.