use(1)

use1

Frontend to the usepackage environment manager

Usage

use [-vs] [-f file] package ...

use -l

Overview

Usepackage is an environment management program. It is based on the principle of packages - collections of executables that share a common set of necessary environment variables, such as PATH, MANPATH or LD_LIBRARY_PATH.

For each given package, use sources the appropriate environment information into the current shell. The environment information is specified in a configuration file, see usepackage(1).

Options

-v

Output verbose information to the standard error stream.

-s

Silence warnings for un-matched packages. This is useful in a shell rc script when a package is known not to be available on all architectures that the shell is used on.

-f file

Specify an alternate initial configuration file.

-l

List available packages and groups.

Files

/usr/share/usepackage/usepackage.conf

The default configuration file.

/usr/share/usepackage/use.csh

Shell setup for csh and derivatives.

/usr/share/usepackage/use.bsh

Shell setup for bourne shell and derivatives.

/usr/share/usepackage/use.ksh

Shell setup for ksh.

/usr/bin/usepackage

The underlying Usepackage executable.

Environment

Other than the reading and re-definition of environment variables for package setup, use also uses the following environment variables for user configuration:

PACKAGES_PATH

Colon-separated path list giving the directories to search for configuration files. Shell-style tilde (~) user-directory escapes are expanded.

HOME

If present in the environment, this is used to provide the expansion for the tilde (~) user-directory.

SHELL

If present in the environment, the last path component of this is used for shell matching (see SYNTAX) and detecting the style of environment output that should be used, see usepackage(1).

Releases

11 releases since Debian 3.1 (Sarge); the text changed 3 times.

  1. 3.1–5.0
  2. 6.0–8
  3. 9–10
  4. 11–13

-v since Debian 6.0 (Squeeze).

From usepackage 1.14-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.