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

SEE ALSO

       slack(8), rsync(1)