DragonFly On-Line Manual Pages

Search: Section:  

CDSPLIT(1)             DragonFly General Commands Manual            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>

                                 March 6, 2002                      CDSPLIT(1)

Search: Section: