DIST(1)

NAME
dist - distribute files to remote systems

SYNOPSIS
dist [ system | -[Ff] file ] files

dist -q [ system | -[Ff] file ]

dist -r [ system | -[Ff] file ]

DESCRIPTION
Dist distributes files to other systems, where they are installed under the same names. Dist operates by packaging the files with mkpkg(1), and queuing the resulting package in a spool directory to be picked up by the remote systems.

The remote systems' names are given as a single argument, containing the system names (in the format of ipc(3)) separated by white space; alternatively, the -f option may be used to specify a file containing a list of system names. The -F option is identical to -f except dist looks for the file in a standard directory.

The dist command has two forms of use. In the first form, dist packages a group of files and queues them for transmission. The file arguments may be either file names or options for mkpkg(1).

When -q is given, 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.

When -r is given, dist calls the named system and installs any packages it has queued for the local system.

EXAMPLES
Distribute a new binary for grep to all vaxes:

    dist -F vaxes /bin/grep

FILES
/usr/lib/dist/*
/usr/lib/dist/destinations/*
/usr/spool/dist/*

SEE ALSO
mkpkg(1), dist(5), dist(8)