DragonFly On-Line Manual Pages

Search: Section:  

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

                                 March 6, 2002                       CDRSTR(1)

Search: Section: