MKPKG(8) MKPKG(8)
NAME
mkpkg, inspkg, seal, unseal - package files for automatic
software distribution
SYNOPSIS
mkpkg [ option ... ] file ...
inspkg [ option ... ] [ file ... ]
seal [ option ] [ file ... ]
unseal [ option ] [ file ... ]
DESCRIPTION
These programs are used by ship(8) to keep files identical
across machines.
Mkpkg packages files and writes the result on the standard
output. Inspkg installs the named packages or the standard
input.
Non-existent files given to mkpkg are deleted upon installa-
tion. Directories are copied with all their contents. Hard
links are reproduced. Symbolic links and special files are
reproduced with the same inode contents. File modification
and access times and owner and group names are reproduced as
far as possible. Old versions of files are removed before
installation: inspkg needs write permission in containing
directories.
Options for both mkpkg and inspkg:
-v Place running commentary on the standard error
file.
-Dpath1=path2
Pretend that any pathname beginning with path1
really begins with path2. Relative pathnames are
extended to full pathnames before comparison.
Options for mkpkg; only one may occur:
-xcommand Include in the package instructions to execute
the shell command after all files have been
installed. Command is unaffected by option -D.
-Xfile Include in the package instructions to run the
shell script file after all files have been
installed. The file name is subject to option
-D.
Options for inspkg:
MKPKG(8) MKPKG(8)
-n Skip the actual installation, but verify the
input packages and produce a backup if requested.
-b Write on the standard output a backup package
that contains whatever was destroyed.
A package is an ar(1) archive containing an extra ASCII file
named
Seal concatenates the named files or the standard input onto
the standard output in an error-detecting form suitable for
shipment by mail(1). Unseal reverses the process, concate-
nating copies of all the original inputs onto the standard
output. When asd(8) uses uucp(1), it sends sealed packages.
A sealed file is printable, has fewer than 128 characters
per line, and has no lines consisting of a single period.
The first line is `!<seal>' and the last one begins with
`!end'. Other lines, such as mail headers, can be added to
either end of a sealed file without hindering unseal.
Options for seal and unseal:
-k A key will be demanded to encrypt the checksum
calculation.
-K keyfile Same, but taking the first line of keyfile as the
key.
SEE ALSO
ar(1), cpio(1), tar(1), bundle(1), ship(8), ar(5), asd(8)
BUGS
The pipeline `mkpkg ... | inspkg' fails if input and output
files overlap.
Inspkg fills any holes in files.