Annotation of researchv10no/cmd/odist/man/dist.1, revision 1.1.1.1

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)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.