SPLITPIPE(1) Manual Page
NAME
splitpipe - spread piped input over a number of volumes (DVD's, CD's etc)
SYNOPSIS
splitpipe -o command [--buffer-size, -b] [--volume-size, -s] [--help, -h] [--no-prompt, -n] [--verbose, -v] [--debug, -d] [--version]
DESCRIPTION
splitpipe(1) accepts input, either from files, pipes or sockets and, using a large buffer for performance reasons, outputs it over one or more volumes. Volumes can be DVD's, CD's, floppies, hard disks or files.
This allows the operator to make, for example, tar(1) archives larger than a single DVD.
Volumes contain markers to signify which backup session they belong to, and their order in the set. Furthermore, a running checksum is kept to guarantee data integrity.
Volumes created by splitpipe(1) can be read by joinpipe(1)
EXAMPLES
To backup /home to one or more DVDs:
# tar czf - /home | splitpipe -c dvd -o 'growisofs -Z /dev/dvd=/dev/stdin'
To restore:
# joinpipe /dev/dvd | tar xzf -
OPTIONS
- --help, -h
- Print a helpful message
- --version
- Print version information
- --ouput program, -o
- This specifies a script, either shell, or a program that is called for each volume. Mandatory.
- --buffer-size, -b
- Configures the size of the buffer between input and output. In megabytes. Defaults to 10.
- --volume-size, -s
- Sets the maximum size of volume output to this number of kilobytes. Alternatively, a preset size may be specified. Currently defined volume sizes are: floppy, cd, cd-80, cdr-80, dvd and dvd-5. Run splitpipe --help for the most up to date list.
- --no-prompt, -n
- Do not prompt the user to change volumes. Mostly useful when writing to files, but might also come in handy with automated disk changers.
- --verbose, -v
- Be verbose, but not overly so.
- --debug, -d
- Give large amounts of debugging output, possibly damaging performance
BUGS
Does not yet allow retrying failed output, even when the failed data is still available in the ringbuffer.
AUTHOR
Written by Netherlabs Computer Consulting BV, bert hubert, <ahu@ds9a.nl>
RESOURCES
Website: http://ds9a.nl/splitpipe
SEE ALSO
joinpipe(1), splitpipe(5)
COPYING
Copyright © 2005 Netherlabs Computer Consulting. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 2.