CDRSTR(1)CDRSTR(1)NAMEcdrstr - Restore a backed up filesystem from one or more CD-R(W)s
SYNOPSIScdrstr [ --help ] [ -c, --compress=TYPE ] [ -d, --device=PATH ] [ -h,
--host=HOST ] [ -p, --prefix=NAME ] [ -t, --test ] [ -V, --version ] [
-z, --zip-here ] TARGETDIR
OPTIONS--help Show usage message and quit.
-c, --compress=TYPE
Decompress using the specified compression format. Possible
options are gz for gzip compression, bz2 for bzip2 compression
or none for no compression. The default is gz.
-d, --device=PATH
Use the specified CD-ROM device. The default is /dev/cdrom.
-h, --host=HOST
Specify the hostname where the filesystem is to be restored.
The CD-ROM drive is assumed to be on the localhost. The trans‐
fer is done via SSH, so make sure that the remote machine is
running an SSH server, and that the local machine has an SSH
client installed. If this parameter is not specified, then the
restore is performed on the local machine.
-p, --prefix=NAME
Specify the filename prefix as used on the CD images. The
default value ('') normally works fine. The first CD is always
searched for files matching the shell pattern NAME*. If multi‐
ple matches are found, the user is prompted to choose one of
them. If the selected file ends with '.1', then the backup is
assumed to be multidisk.
-t, --test
Do not use the CD-ROM drive. In this mode, the restore proceeds
normally, except that the backup files are searched for in the
current directory, rather than on CD-ROMs. The CD-ROM drive is
never actually mounted or unmounted. When -t is used, the -d
option is ignored.
-V, --version
Print the version number and exit.
-z, --zip-here
For remote restores, perform decompression locally. This has
the advantage of decreased CPU load on the remote machine, but
the disadvantage of increased network traffic.
You can also use this option as an ugly workaround if you are
using bzip2 compression with an old version of tar that doesn't
yet support the -j option. In this case, cdrstr will use pipes
instead.
DESCRIPTION
This manual page documents briefly the cdrstr filesystem restore util‐
ity.
cdrstr performs a full or incremental restore of a filesystem from CD-
Rs. The filesystem is restored into the specified target directory.
This directory is usually the mount point of a newly formatted filesys‐
tem.
To perform a complete restore, begin with a blank filesystem or direc‐
tory, and use this command to restore the most recent full (usually
level 0) backup. When this restore is complete, use this command to
restore the next higher level backup that is more recent than the one
just completed. Continue in this way until you've restored the most
recent incremental backup.
Ordinarily, this procedure should only involve two or three steps,
depending on your backup strategy. (Eg, the most recent monthly backup
(level 0), the most recent weekly backup, and the most recent daily
backup.) For more information, see the section on BACKUP LEVELS in
cdbkup (1).
EXAMPLEScdrstr /mnt
Restores a filesystem from the CD in /dev/cdrom into the direc‐
tory /mnt on the local machine (which is presumably the mount
point of a new filesystem). This same command line can be used
to perform each level of an incremental restore. Make sure to
do the restores in the right order!
cdrstr-p my.webserver.org-2001-06-26-0 /mnt
Restores a particular level 0 backup from the CD in /dev/cdrom
into the directory /mnt on the local machine.
cdrstr-h my.webserver.org /mnt
Restores a filesystem from the CD in /dev/cdrom into the direc‐
tory /mnt on the specified remote machine.
SEE ALSOcdappend(1), cdbkup(1), cdcat(1), cdsplit(1).
AUTHOR
John-Paul Gignac <jp@gignac.org>
Mar 6, 2002 CDRSTR(1)