Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
CDRSTR(1)		    General Commands Manual		     CDRSTR(1)

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

       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 op-
	      tions 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  de-
	      fault  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

       This manual page	documents briefly the cdrstr filesystem	restore	 util-

       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-

       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, de-
       pending 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 cd-
       bkup (1).

       cdrstr /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 /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	direc-
	      tory /mnt	on the specified remote	machine.

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

       John-Paul Gignac	<>

				  Mar 6, 2002			     CDRSTR(1)


Want to link to this manual page? Use this URL:

home | help