summaryrefslogtreecommitdiff
path: root/static/v10/man1/dist.1
diff options
context:
space:
mode:
Diffstat (limited to 'static/v10/man1/dist.1')
-rw-r--r--static/v10/man1/dist.184
1 files changed, 84 insertions, 0 deletions
diff --git a/static/v10/man1/dist.1 b/static/v10/man1/dist.1
new file mode 100644
index 00000000..a3e3edf4
--- /dev/null
+++ b/static/v10/man1/dist.1
@@ -0,0 +1,84 @@
+.TH DIST 1
+.SH NAME
+dist \(mi distribute files to remote systems
+.SH SYNOPSIS
+.\".BI "dist [ " system " | -[Ff] " file " ] [ -n ] " files
+.BI "dist [ " system " | -[Ff] " file " ] " files
+.PP
+.B "dist -q ["
+.I system
+.B "| -[Ff]"
+.I file
+.B "]"
+.PP
+.B "dist -r ["
+.I system
+.B "| -[Ff]"
+.I file
+.B "]"
+.SH DESCRIPTION
+.I Dist
+distributes files to other systems, where they are installed
+under the same names.
+.I Dist
+operates by packaging the files with
+.IR mkpkg (1),
+and queuing the resulting package in a spool directory to be
+picked up by the remote systems.
+.PP
+The remote systems' names are given as a single argument, containing
+the system names (in the format of
+.IR ipc (3))
+separated by white space; alternatively, the
+.B -f
+option may be used to specify a file containing a list of system names.
+The
+.B -F
+option is identical to
+.B -f
+except
+.I dist
+looks for the file in a standard directory.
+.PP
+The
+.I dist
+command has two forms of use. In the first form,
+.I dist
+packages a group of files and queues them for transmission.
+.\"If the
+.\".B -n
+.\"option is specified, the remote systems are notified that the package
+.\"is available.
+The
+.I file
+arguments may be either file names or options for
+.IR mkpkg (1).
+.PP
+When
+.B -q
+is given,
+.I dist
+queries the named systems and displays the contents of their transmission
+queues; if no systems are given the local queue is displayed
+by default.
+.PP
+When
+.B -r
+is given,
+.I dist
+calls the named system and installs any packages it has queued for
+the local system.
+.SH EXAMPLES
+Distribute a new binary for grep to all vaxes:
+.IP
+.B "dist -F vaxes /bin/grep"
+.SH FILES
+.B /usr/lib/dist/*
+.br
+.B /usr/lib/dist/destinations/*
+.br
+.B /usr/spool/dist/*
+.SH "SEE ALSO"
+.IR mkpkg (1),
+.IR dist (5),
+.IR dist (8)