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.