xfm.install1x

Usage

Overview

xfm.install is a Bourne shell script that copies the default configuration files that ship as part of xfm into the user's $HOME/.xfm directory. If this directory is already present, the user is prompted to overwwrite it, unless the script is invoked with the noninteractive (-n) option, in which case the script will change nothing and exit with an error.

Options

-n

run non-interactively, aborting if configuration directory already present

Operands

None.

Stdin

If $HOME/.xfm already exists and xfm.install is not given the -n option, the user will be prompted to overwrite the directory, and the user's answer will be read from standard input.

Input files

xfm.install copies configuration files from the /usr/X11R6/lib/X11/xfm/dot.xfm directory.

Environment

The following environment variables affect the execution of xfm.install:

HOME

The pathname of the user's home directory.

Asyncrhonous events

Default.

Stdout

xfm.install reports all error and diagnostic messages to standard output, including a message indicating success.

Stderr

Not used; however, the commands and utilities used by xfm.install may issue diagnostics to standard error.

Output files

The input files described above are copied to $HOME/.xfm.

Extended description

None.

Exit status

xfm.install exits with status 1 if any problems are encountered.

Consequences of errors

The user's $HOME/.xfm directory is not atomically replaced, thus it is possible for the user's xfm configuration data to be lost.

Application usage

xfm.install is called internally by xfm if no $HOME/.xfm directory is found.

Examples

None.

Future directions

None.