Man Linux: Main Page and Category List


       cback-span - Span staged data among multiple discs


       cback-span [switches]


       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.


       -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

       -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.


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

       1      The Python interpreter version is < 2.3.

       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.


       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.




       /etc/cback.conf - Default configuration file

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


       Report bugs to <>.


       Written by Kenneth J. Pronovici <>.


       Copyright (c) 2007 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