Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  CDRSTR (1)


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


See Also


cdrstr [ --help ] [ -c, --compress=TYPE ] [ -d, --device=PATH ] [ -h, --host=HOST ] [ -p, --prefix=NAME ] [ -t, --test ] [ -V, --version ] [ -z, --zip-here ] TARGETDIR


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


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


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


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


John-Paul Gignac <>
Search for    or go to Top of page |  Section 1 |  Main Index

--> CDRSTR (1) Mar 6, 2002

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.