NAME

linkfarm - manage symbolic links to package files

SYNOPSIS

linkfarm [-cDnRVv] [-d stowdir] [-s subdir] [-t target] package

DESCRIPTION

The linkfarm command is used to manage a "linkfarm", a directory tree of symbolic links in target to the files in the package sub-directory of stowdir. The default action is to create a linkfarm to a package.

The following command-line options are supported:

-c
Check whether a package contains a linkfarm in target. If package has no symbolic links in target that correspond to its files, then return 0, otherwise return 1.

-D
Delete the linkfarm for package.

-d stowdir
Set stowdir as the directory in which package can be found. The default stowdir is the packages sub-directory in the default target directory.

-n
Don't actually execute the commands for removing and creating the symbolic links and directories.

-R
Delete and re-create the linkfarm for package.

-s subdir
The root of the package hierarchy for the linkfarm is the subdir sub-directory in the package. By default, assume the root of the package hierarchy is simply the package directory.

-t target
Set target as the directory in which to create and delete the linkfarm for package. The default target directory is /usr/pkg but may be overridden by the LOCALBASE environment variable.

-V
Print version number and exit.

-v
Turn on verbose output. Specifying -v multiple times increases the level of verbosity.

ENVIRONMENT

LOCALBASE
The standard packages directory, /usr/pkg, can be overridden by specifying an alternative directory in the LOCALBASE environment variable. This affects the default target and stowdir directories.

PLIST_IGNORE_FILES
This can be used to specify files in package that should ignored when creating and deleting symbolic links in target. PLIST_IGNORE_FILES is a space-separated list of shell glob patterns that match files relative to the package directory, and it defaults to "info/dir *[~#] *.OLD *.orig *,v".

SEE ALSO

lndir(1), pkg_view(1)

AUTHORS

The linkfarm utility was written by Alistair G. Crooks <agc@NetBSD.org>
.