PKG(1)

NAME
pkg - manage package installation, upgrades etc.

SYNOPSIS
pkg [ --add <package> ... | --remove <package> ... | --describe <package> | --info <string> | --install <archive>|<device> ... | --list | --rebuild | --target <directory> ]

DESCRIPTION
pkg is a mechanism for managing the installation and removal of packages. Each package resides in its own private directory and is linked into a user nominated target directory in order to make it available for use. Each package contains instructions as to how the mapping between the package structure and the target structure should be performed. When two or more packages are mapped into the same target directory pkg ensures that if the same file can be obtained from either package it uses the latest version available.

OPTIONS

Options are processed in the order they are found on the command line. Care should be taken to say what you mean!

--add <package>
    Add the given package to the current target directory. This only lists the package as a member of the target directory. The target directory requires rebuilding in order to make the package available to users.

--remove <package>
    Remove the given package from the current target directory. This only removes the package from the list of members. The target directory requires rebuilding in order to remove the old package files.

--describe <package>
    Give a short description of the given package.

--info <string>
    Search the map for the current target directory and print information on each entry that contains the given string. The string may be a regular expression in the style of egrep.

--install <archive> | <device>
    Extract from the given archive and add each package found to the current target directory. If a device is specified it is mounted and each archive found on it is extracted and each package added to the current target directory.

--list
    Lists the packages installed in the current target directory.

--rebuild
    Rebuilds the current target directory according to the instructions contained in the installed packages. Files in the target directory which belonged to packages which have been removed are themselves removed. Files which exist in the target directory but do not belong to any installed package are left unchanged - unless otherwise overwritten by a file from a newly installed package.

--target <directory>
    Sets the current target directory to the given directory. This overrides the initial default target directory which is defined in the configuration file.

EXAMPLES

Install the package TeX and rebuild the target directory. The package is to be located using the default search path and installed in the default target directory both of which are determined by reading the /etc/default/pkg file.

pkg --add TeX --rebuild

Install the TeX and LaTeX packages in /usr/local, then add the Xdvi package and rebuild /usr/local. /usr/local is not necessarily the default target directory.

pkg --target /usr/local --add TeX --LaTeX

pkg --target /usr/local --add Xdvi --rebuild

BUGS
None known...

FILES
/etc/default/package - configuration for pkg

SEE ALSO