DIST(5)

NAME
dist - spool directory structure for dist

SYNOPSIS
/usr/spool/dist/Q.*/

/usr/spool/dist/Q.*/ctl

/usr/spool/dist/Q.*/data

/usr/spool/dist/Q.*/files

/usr/spool/dist/Q.*/[1-9]*.busy

/usr/spool/dist/Q.*/[1-9]*.done

DESCRIPTION
The dist spool directory contains distributions queued for transmission to remote systems, and is also used as the working directory when unpacking distributions received from remote systems.

Each job has its own subdirectory of the spool directory. Several files with conventional names appear in this per-job directory, as well as files with generated names containing status information for each remote system in the job.

The files in a job's spool directory include:

ctl The control file contains a list of identifying numbers and remote system names. The identifying number is used in file names containing status information for corresponding remote system, since network names may not be legal file names. The file contains a sequence of lines; each line contains an identifying number, a space, and the corresponding remote system name.

data
    The data file contains the output of mkpkg(1) for the distribution.

files
    A list of file names specified in the command line that created the job. This is mainly used as a key for superseding jobs: if a new job is created that contains a superset of the files of some old job, the old job is marked as completed for all remote systems it has in common with the new job.

[1-9]*.busy
    An empty lock file indicating that the identified system is currently receiving the distribution.

[1-9]*.done
    Status file indicating that the identified system is finished with the distribution. This file is empty if and only if the distribution was successfully installed; otherwise it contains any error messages from the remote system.

FILES
/usr/spool/dist/*

SEE ALSO
dist(1), dist(8)