|
|
1.1 root 1: .TH DIST 1
2: .SH NAME
3: dist \(mi distribute files to remote systems
4: .SH SYNOPSIS
5: .\".BI "dist [ " system " | -[Ff] " file " ] [ -n ] " files
6: .BI "dist [ " system " | -[Ff] " file " ] " files
7: .PP
8: .B "dist -q ["
9: .I system
10: .B "| -[Ff]"
11: .I file
12: .B "]"
13: .PP
14: .B "dist -r ["
15: .I system
16: .B "| -[Ff]"
17: .I file
18: .B "]"
19: .SH DESCRIPTION
20: .I Dist
21: distributes files to other systems, where they are installed
22: under the same names.
23: .I Dist
24: operates by packaging the files with
25: .IR mkpkg (1),
26: and queuing the resulting package in a spool directory to be
27: picked up by the remote systems.
28: .PP
29: The remote systems' names are given as a single argument, containing
30: the system names (in the format of
31: .IR ipc (3))
32: separated by white space; alternatively, the
33: .B -f
34: option may be used to specify a file containing a list of system names.
35: The
36: .B -F
37: option is identical to
38: .B -f
39: except
40: .I dist
41: looks for the file in a standard directory.
42: .PP
43: The
44: .I dist
45: command has two forms of use. In the first form,
46: .I dist
47: packages a group of files and queues them for transmission.
48: .\"If the
49: .\".B -n
50: .\"option is specified, the remote systems are notified that the package
51: .\"is available.
52: The
53: .I file
54: arguments may be either file names or options for
55: .IR mkpkg (1).
56: .PP
57: When
58: .B -q
59: is given,
60: .I dist
61: queries the named systems and displays the contents of their transmission
62: queues; if no systems are given the local queue is displayed
63: by default.
64: .PP
65: When
66: .B -r
67: is given,
68: .I dist
69: calls the named system and installs any packages it has queued for
70: the local system.
71: .SH EXAMPLES
72: Distribute a new binary for grep to all vaxes:
73: .IP
74: .B "dist -F vaxes /bin/grep"
75: .SH FILES
76: .B /usr/lib/dist/*
77: .br
78: .B /usr/lib/dist/destinations/*
79: .br
80: .B /usr/spool/dist/*
81: .SH "SEE ALSO"
82: .IR mkpkg (1),
83: .IR dist (5),
84: .IR dist (8)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.