NAME

       cback-span - Span staged data among multiple discs

SYNOPSIS

       cback-span [switches]

DESCRIPTION

       This  is  the  Cedar  Backup span tool.  It is intended for use by people who back up more
       data than can fit on a single disc.  It allows a user to split (span) staged data  between
       more  than  one  disc.  It can't be a Cedar Backup extension in the usual sense because it
       requires user input when switching media.

       Generally, one can run the cback-span command with no arguments.  This will start it using
       the  default  configuration  file,  the  default  log file, etc.  You only need to use the
       switches if you need to change the default behavior.

       This command takes most of its configuration from the  Cedar  Backup  configuration  file,
       specifically  the  store  section.   Then,  more  information  is  gathered  from the user
       interactively while the command is running.

SWITCHES

       -h, --help
              Display usage/help listing.

       -V, --version
              Display version information.

       -b, --verbose
              Print verbose output to the screen as well writing to the logfile. When this option
              is  enabled,  most  information  that would normally be written to the logfile will
              also be written to the screen.

       -c, --config
              Specify the path to an alternate configuration  file.   The  default  configuration
              file is /etc/cback.conf.

       -l, --logfile
              Specify   the   path  to  an  alternate  logfile.   The  default  logfile  file  is
              /var/log/cback.log.

       -o, --owner
              Specify the ownership  of  the  logfile,  in  the  form  user:group.   The  default
              ownership  is root:adm, to match the Debian standard for most logfiles.  This value
              will only be used when creating a new logfile.  If the logfile already exists  when
              the cback script is executed, it will retain its existing ownership and mode.  Only
              user and group names may be used, not numeric uid and gid values.

       -m, --mode
              Specify the permissions for the logfile, using the numeric  mode  as  in  chmod(1).
              The default mode is 640 (-rw-r-----).  This value will only be used when creating a
              new logfile.  If the logfile already exists when the cback script is  executed,  it
              will retain its existing ownership and mode.

       -O, --output
              Record  some  sub-command  output  to the logfile. When this option is enabled, all
              output from system commands will be logged. This might be useful for  debugging  or
              just  for  reference. Cedar Backup uses system commands mostly for dealing with the
              CD recorder and its media.

       -d, --debug
              Write debugging information to the logfile. This option produces a high  volume  of
              output,  and  would  generally only be needed when debugging a problem. This option
              implies the --output option, as well.

       -s, --stack
              Dump a Python stack trace instead of  swallowing  exceptions.   This  forces  Cedar
              Backup  to dump the entire Python stack trace associated with an error, rather than
              just progating last message it received back up to the user interface.  Under  some
              circumstances, this is useful information to include along with a bug report.

RETURN VALUES

       This command returns 0 (zero) upon normal completion, and six other error codes related to
       particular errors.

       1      The Python interpreter version is < 2.5.

       2      Error processing command-line arguments.

       3      Error configuring logging.

       4      Error parsing indicated configuration file.

       5      Backup was interrupted with a CTRL-C or similar.

       6      Other error during processing.

NOTES

       Cedar Backup itself is designed to run as root, since otherwise it's difficult to back  up
       system directories or write the CD or DVD device.  However, this command can be run safely
       as any user that has read access to the Cedar Backup staging directories and write  access
       to the CD or DVD device.

SEE ALSO

       cback(1)

FILES

       /etc/cback.conf - Default configuration file

       /var/log/cback.log - Default log file

BUGS

       Report bugs to <support@cedar-solutions.com>.

AUTHOR

       Written by Kenneth J. Pronovici <pronovic@ieee.org>.

COPYRIGHT

       Copyright (c) 2007,2010 Kenneth J. Pronovici.
       This  is  free software; see the source for copying conditions.  There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.