![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to dist.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / dist / man|
Return to dist.1 CVS log | Up to [Research Unix] / researchv10no / cmd / dist / man |
1.1 root 1: .TH DIST 1
2: .SH NAME
3: dist \(em distribute files to a remote machine
4: .SH SYNOPSIS
5: .ft CW
6: dist [-nv] [-d \fIhosts\fP] [-[Ff] \fIhostfile\fP] [-D \fIold\fP=\fInew\fP] [-[Xx] \fIcommand\fP] \fIfile ...\fP
7: .sp
8: dist -q [-v] [\fIsystems ...\fP]
9: .sp
10: dist -r [-v] [-D \fIold=new\fP] [-R \fIrootdir\fP] \fIsystem\fP [\fIjob ...\fP]
11: .SH DESCRIPTION
12: .I Dist
13: distributes files to other systems, where they are installed
14: under the same names.
15: .I Dist
16: operates by packing the files with
17: .IR mkdist (1),
18: and queueing the resulting package in a spool directory to be
19: picked up by the remote systems.
20: .PP
21: .I Dist
22: has several forms of use. In the first (default) form,
23: .I dist
24: packages the named files and queues them for remote systems.
25: By default, the list of remote systems is taken from
26: .BR /usr/lib/dist/destinations/default .
27: The
28: .B -d
29: option allows a list of destination systems to be specified as
30: a single argument (containing system names separated by spaces).
31: Similarly, the
32: .B -f
33: option allows a list of systems to be taken from a file.
34: The
35: .B -F
36: option is like
37: .BR -f ,
38: except it looks in a standard place for the file.
39: Multiple
40: .BR -d ,
41: .BR -f ,
42: and
43: .BR -F
44: options may be combined. If any destinations are specified via
45: the command line, the default destinations file is not read.
46: The
47: .BR -D ,
48: .BR -X ,
49: and
50: .B -x
51: options are passed to
52: .IR mkdist .
53: By default, after packaging and queueing the files for distribution,
54: .I dist
55: notifies each remote system that the package is available, and the
56: remote system then dials back and immediately downloads the package. The
57: .B -n
58: option suppresses this notification.
59: .PP
60: In the second form, when the
61: .B -q
62: option is given,
63: .I dist
64: displays the queue contents on each remote system named in the
65: command line. If no remote systems are named,
66: .I dist
67: displays the local queue.
68: .PP
69: The third form, with the
70: .B -r
71: option, makes a network call to the named system
72: and attempts to download and install the named jobs.
73: If no jobs are named, it attempts to download all jobs
74: on the remote system. The
75: .B -D
76: and
77: .B -R
78: options are passed to
79: .IR insdist (1).
80: The
81: .B -r
82: form is rarely used, since the default behavior is for
83: remote systems to automatically dial back when a package
84: is announced.
85: .PP
86: In all three forms of the command, the
87: .B -v
88: option enables verbose output.
89: .SH FILES
90: .TF /usr/lib/dist/destinations/default
91: .TP
92: .F /usr/lib/dist/*
93: Supporting programs.
94: .TP
95: .F /usr/lib/dist/destinations/default
96: List of default destination systems.
97: .TP
98: .F /usr/lib/dist/destinations/*
99: Destination files for the
100: .B -F
101: option.
102: .TP
103: .F /usr/spool/dist
104: Spool directory.
105: .TP
106: .F /usr/spool/dist/Q.*
107: Spool subdirectories.
108: .TP
109: .F /usr/spool/dist/log
110: Log file.
111: .SH "SEE ALSO"
112: .IR mkdist (1)
113: .SH BUGS
114: .B -v
115: should provide more verbose output.
116: .br
117: Logging needs improvement.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.