|
|
1.1 root 1: .TH SHIP 8
2: .CT 1 comm_mach sa_nonmortals
3: .SH NAME
4: ship, shipstat \(mi automatic software distribution
5: .SH SYNOPSIS
6: .B ship
7: [
8: .I option ...
9: ]
10: [
11: .I file ...
12: ]
13: .PP
14: .B shipstat
15: .SH DESCRIPTION
16: .I Ship
17: distributes the named files to other computers, where
18: the files are installed under the same names.
19: Shipping privileges are determined
20: by the network manager on the receiving machine;
21: see
22: .IR svcmgr (8).
23: .PP
24: Destinations are taken from environment variable
25: .BR dest ,
26: or from
27: .F /usr/lib/asd/dest/default
28: if
29: .B dest
30: is empty.
31: If a destination is the name of a file in
32: .FR /usr/lib/asd/dest ,
33: it is replaced by the contents of that file,
34: each word of which is then examined in the same way.
35: Otherwise the destination is a network address.
36: The sending machine is omitted unless explicitly named in
37: the environment variable,
38: or unless option
39: .B -f
40: is present or environment variable
41: .B force
42: has a non-empty value.
43: .PP
44: .I Ship
45: uses
46: .I inspkg
47: and
48: .IR mkpkg (8)
49: to do its work.
50: Links among the named files are imitated
51: on the receiving computer, and
52: named files that do not exist on the sending
53: computer are deleted on the receiving computer.
54: Other options are the same as those of
55: .IR mkpkg :
56: .PP
57: .TP \w'\-X file 'u
58: .B -v
59: Emit running commentary on the standard error file.
60: .TP
61: .BI -D path1 = path2
62: Pretend that any
63: .I file
64: name that begins with
65: .I path1
66: really begins with
67: .IR path2 .
68: Relative pathnames are extended to full pathnames before comparison.
69: .TP
70: .BI -x command
71: .br
72: .ns
73: .TP
74: .BI -X file
75: Include in the package instructions to execute the shell
76: .I command
77: or run the shell script
78: .I file
79: after all files have been installed.
80: Only one of these options may occur.
81: The
82: .I file
83: name in
84: .BR -X
85: is affected by
86: .BR -D .
87: .PP
88: Shipments are generally acknowledged by mail after each destination
89: has been tried at least once;
90: see
91: .IR asd (8)
92: for details.
93: .PP
94: .I Shipstat
95: reports the status of all its caller's
96: incomplete shipments,
97: with the most recent first.
98: .SH FILES
99: .TF/usr/lib/asd/dest/default
100: .TP
101: .F /usr/lib/asd/dest/*
102: distribution lists
103: .TP
104: .F
105: /usr/lib/asd/dest/default
106: default distribution list
107: .TP
108: .BI /usr/spool/asd/ logname
109: outgoing spool directories
110: .SH SEE ALSO
111: .IR mkpkg (8),
112: .IR asd (8),
113: .IR svcmgr (8)
114: .SH BUGS
115: The
116: .B -f
117: option, if given, must be the first option and
118: must not be combined with any other.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.