CDSPLIT(1)

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

SEE ALSO
cdappend(1), cdbkup(1), cdcat(1), cdrecord(1), cdrstr(1).

AUTHOR
John-Paul Gignac <jp@gignac.org>