Return to dist.1 CVS log

Up to [Research Unix] / researchv10no / cmd / dist / man

Annotation of researchv10no/cmd/dist/man/dist.1, revision 1.1

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.