NAME

cdsplit - Copy the output of any shell command onto one or more CD-R(W)s

SYNOPSIS

cdsplit [ -1, --single ] [ -b, --blank ] [ -h, --help ] [ -I, --no-iso ] [ -n, --name=NAME ] [ -s, --speed=SPEED ] [ -S, --cdsize=SIZE ] [ -t, --test ] [ -V, --version ] [ -w, --workdir=PATH ] DEVICE COMMAND

OPTIONS

-1, --single: Burn the last disk in single session mode. Normally, the last disk is burned in multisession mode, allowing for additional data to be appended to the end of it.
-b, --blank: Blank all disks before writing.
-h, --help: Show usage message and quit.
-I, --no-iso: This option can only be used in conjunction with --test. It prevents the input chunks from being rolled up into ISO files. By default, ISO 9660 images are created, ready to be burned onto CD.
-n, --name=NAME: Set the filename prefix to be used on the CD. If the entire image fits on one CD then this will be the actual filename on that CD. Otherwise, a dot and the disk number will be appended to the end of each filename. The default filename prefix is 'cdbkup'.
-s, --speed=SPEED: Set the burn speed. The default is 2.
-S, --cdsize=SIZE: Specify the size of the output media in bytes. Normally, cdsplit attempts to autodetect the size of the disk and uses a default of 650,000,000 bytes if autodetection fails. This option disables autodetection.
Unless --no-iso is specified, SIZE must be large enough to account for both high-level and low-level filesystem overhead. So you should expect any ISO images to be significantly smaller than the given value. If --no-iso is specified then SIZE is the exact maximum filesize.
-t, --test: Do not use the CD-ROM burner. In this mode, the backup proceeds normally, except that the backup files are saved to the current directory instead of being burned onto CD-R(W)s. The output is normally packaged up into ISO images, unless --no-iso is specified.
If -t is used, the following options are ignored: -1, -b, -s.
-V, --version: Print the version number and exit.
-w, --workdir=PATH: Set the working directory as specified. If it doesn't exist, it will be created.

DESCRIPTION

This manual page documents briefly the CDSplit backup utility.

CDSplit executes the given shell command, and interactively copies its STDOUT onto one or more (as necessary) CD-R(W)s. For each disk, it asks the user to insert the disk into the CD burner and to press enter. It also offers the ability to retry each step when errors occur. CDSplit will automatically use available space on multisession disks.

DEVICES

The device specified on the command line is the SCSI device for the CD-ROM burner. For more information, see cdrecord (1).

AUTHOR