PACKAGE(1)

NAME
package - maintain local disk configuration

SYNOPSIS
/etc/package [ -vnsky ] [ -c conf ]

DESCRIPTION
Package maintains files and directories on a machine's local disk as specified in a configuration file. Each machine using package is assumes to have access to a distributed filesystem such as Vice II from which master copies of files may be fetched. Package uses file modification times to determine when a file is current or not.

The format of the configuration file is the following:

type file [proto] [username[groupname]] [mode]

The type field specifies one of B, C, D, F, L, S standing for block special device, charactor special device, directory, regular file, symbolic link, and socket respectively. Directory type specifications may also have a following X to specify a lost+found directory or an R to specify that any extra files not configured in that directory are to be removed. (Use this option carefully.) Similarly the regular file specification may have a following I to specify that this file is only to be copied into place if the file is not present, likewise a following O specifies that when a file is updated the old copy should be renamed with a suffix of .old.

The file field specifies an absolute path of the local file.

The proto field specifies a major and minor device number when used in a block or charactor special device entry or the prefix to used to name the master file (or real file in the case of a symbolic link.) If the letter A is appended to update mode then the proto field specifies and absolute path and does not have the file appended to it to form the path. If the letter Q is appended to update mode then when this file is update package will exit with the status of 4. (This only works for file modes.)

The username, groupname, and mode are all optional and when not specified the permissions of the master file are used.

Normally the configuration file is named /etc/package.SYS where ``SYS'' reflects the actual system type of the machine, as defined by the /usr/andrew/bin/sys program. Other configuration files may be specified by the c flag. However, the actual system type will be supplied by package and must not be give in the name.

Normally package prints out what is is doing, unless the s flag is given. The v flag increases the level of verbosity of the output.

The n flag is used to tell package not to do any actual work but instead just tell what it would do. (This is useful in debugging configuration files.)

By default, package will not update a file if it exists and none of the write bits are set. The y flag enables updating of these files. The k prohibits updating of these files, and is present for compatibility.

FILES
/etc/package.SYS - default package configuration file