CDRSTR(1)

NAME
cdrstr - Restore a backed up filesystem from one or more CD-R(W)s

SYNOPSIS
cdrstr [ --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 transfer 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 multiple 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 utility.

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

To perform a complete restore, begin with a blank filesystem or directory, 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).

EXAMPLES

cdrstr /mnt
    Restores a filesystem from the CD in /dev/cdrom into the directory /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 directory /mnt on the specified remote machine.

SEE ALSO
cdappend(1), cdbkup(1), cdcat(1), cdsplit(1).

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