FreeBSD Manual Pages
CDRSTR(1) 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 cur- rent 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 dis- advantage 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 sup- port 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 di- rectory 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, depend- ing 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> Mar 6, 2002 CDRSTR(1)
NAME | SYNOPSIS | OPTIONS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cdrstr&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>