NAME

slack.conf - configuration file for slack

DESCRIPTION

The file /etc/slack.conf contains configuration information for slack(8) and its backends. It should contain one keyword-value pair per line, separated by an '=' sign. Keywords must consist solely of capital letters and underscores. Values may take any appropriate format, but must not begin with a space. Comments start with '#', and all text from the '#' to the end of a line is ignored. Trailing whitespace on lines is ignored. Empty lines or lines consisting of only whitespace and comments are ignored.

Valid keywords are:

SOURCE: The master source for slack roles. It can be in one of four forms:

/path/to/dir
Use a local directory.
somehost:/path/to/dir
Use given directory on a remote host via rsync over SSH.
rsync://somehost/module
Use module on a remote rsyncd server (directly over the network).
somehost::module
Use the rsync daemon protocol over SSH to the given host. See “USING RSYNC-DAEMON FEATURES VIA A REMOTE-SHELL CONNECTION” in rsync(1)

: All forms of SOURCE are passed directly to rsync, so you can do things like add “user@” before the host on any remote forms. For more about what rsync can do, see its manual page, of course.
: For the last form, however, we do a little magic. rsync treats the last two forms equivalently, so we overload the last form by automatically passing “-e ssh” to rsync when we see it. This hack lets us tell slack to use this nice feature of rsync just using the SOURCE config option.

ROOT: The root filesystem into which to install slack roles. Usually '/'.
ROLE_LIST: The location of the role list, which lists the roles to be installed by default on each host.
This can be a path relative to the source, or can be an entirely separate location if it starts with a slash or a hostname (optionally preceeded by user@).
CACHE: A local cache directory, used as a local mirror of the SOURCE.
STAGE: A local staging directory, used as an intermediate stage when installing files.
BACKUP_DIR: A directory in which to keep dated backups for rollbacks.

EXAMPLE

A typical file might look like this:

# slack.conf configuration file SOURCE=slack-master:/slack # source is on a remote # host named "slack-master" ROLE_LIST=slack-master:/roles.conf ROOT=/ CACHE=/var/cache/slack STAGE=/var/lib/slack/stage BACKUP_DIR=/var/lib/slack/backups

FILES

/etc/slack.conf

NAME

DESCRIPTION

EXAMPLE

FILES

SEE ALSO