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