DragonFly On-Line Manual Pages

slack.conf(5)            DragonFly File Formats Manual           slack.conf(5)

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:

              o      /path/to/dir

                     Use a local directory.

              o      somehost:/path/to/dir

                     Use given directory on a remote host via rsync over SSH.

              o      rsync://somehost/module

                     Use module on a remote rsyncd server (directly over the
                     network).

              o      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)

File formats                      2005-05-23                     slack.conf(5)