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

FreeBSD Manual Pages

  
 
  

home | help
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 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
	      instead.

DESCRIPTION
       This manual page	documents briefly the cdrstr filesystem	restore	 util-
       ity.

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

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

EXAMPLES
       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 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	direc-
	      tory /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)

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

home | help