Imported Upstream version 2.5.1p3

[debian/amanda] / man / amrestore.8

diff --git a/man/amrestore.8 b/man/amrestore.8
index 15849198be90a42b12e4852db4ec644c8579e251..551d48287fe408ce4a29910ce5ccfac7e6832517 100644 (file)
--- a/man/amrestore.8
+++ b/man/amrestore.8
@@ -1,40 +1,32 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "AMRESTORE" 8 "" "" ""
+.\"     Title: amrestore
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
+.\"      Date: 02/07/2007
+.\"    Manual: 
+.\"    Source: 
+.\"
+.TH "AMRESTORE" "8" "02/07/2007" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l

 .SH "NAME"
 .SH "NAME"

-amrestore - extract backup images from an Amanda tape
+amrestore \- extract backup images from an Amanda tape

 .SH "SYNOPSIS"
 .HP 10
 .SH "SYNOPSIS"
 .HP 10

-\fBamrestore\fR [-r -c -C] [-b \fIblocksize\fR] [-f \fIfileno\fR] [-l \fIlabel\fR] [-p] [-h] \fItapedevice\fR| \fIholdingfile\fR  [\fIhostname\fR [\fIdiskname\fR [\fIdatestamp\fR [\fIhostname\fR [\fIdiskname\fR [\fIdatestamp\fR ...]]]]]]
+\fBamrestore\fR [\-r | \-c | \-C] [\-b | \fIblocksize\fR] [\-f | \fIfileno\fR] [\-l | \fIlabel\fR] [\-p] [\-h] \fItapedevice\fR|\ \fIholdingfile\fR  [\fIhostname\fR [\fIdiskname\fR [\fIdatestamp\fR [\fIhostname\fR [\fIdiskname\fR [\fIdatestamp\fR | ...]]]]]]

 .SH "DESCRIPTION"
 .PP
 \fBAmrestore\fR
 extracts backup images from the tape mounted on
 .SH "DESCRIPTION"
 .PP
 \fBAmrestore\fR
 extracts backup images from the tape mounted on

-\fBtapedevice\fR
+\fItapedevice\fR

 or from the holding disk file
 or from the holding disk file

-\fBholdingfile\fR
+\fIholdingfile\fR

 that match
 that match

-\fBhostname\fR,
-\fBdiskname\fR
+\fIhostname\fR,
+\fIdiskname\fR

 and
 and

-\fBdatestamp\fR
+\fIdatestamp\fR

 patterns given on the command line. The tape or holding file must be in a format written by the
 \fBamdump\fR
 or
 patterns given on the command line. The tape or holding file must be in a format written by the
 \fBamdump\fR
 or


@@ -42,205 +34,223 @@ or
 program.
 .PP
 If
 program.
 .PP
 If

-\fBdiskname\fR
+\fIdiskname\fR

 is not specified, all backups on the tape for the previous
 is not specified, all backups on the tape for the previous

-\fBhostname\fR
+\fIhostname\fR

 are candidates. If
 are candidates. If

-\fBdatestamp\fR
+\fIdatestamp\fR

 is not specified, all backups on the tape for the previous
 is not specified, all backups on the tape for the previous

-\fBhostname\fR
+\fIhostname\fR

 and
 and

-\fBdiskname\fR
+\fIdiskname\fR

 are candidates. If no
 are candidates. If no

-\fBhostname\fR,
-\fBdiskname\fR
+\fIhostname\fR,
+\fIdiskname\fR

 or
 or

-\fBdatestamp\fR
+\fIdatestamp\fR

 are specified, every backup on the tape is a candidate.
 .PP
 are specified, every backup on the tape is a candidate.
 .PP

-\fBHostname\fR
+\fIHostname\fR

 and
 and

-\fBdiskname\fR
+\fIdiskname\fR

 are special expressions described in the "HOST & DISK EXPRESSION" section of
 \fBamanda\fR(8).
 are special expressions described in the "HOST & DISK EXPRESSION" section of
 \fBamanda\fR(8).

-\fBDatestamp\fR
+\fIDatestamp\fR

 are special expression described in the "DATESTAMP EXPRESSION" section of
 \fBamanda\fR(8). For example, if
 are special expression described in the "DATESTAMP EXPRESSION" section of
 \fBamanda\fR(8). For example, if

-\fBdiskname\fR
+\fIdiskname\fR

 is "rz[23]a", it would match disks
 \fBrz2a\fR
 and
 \fBrz3a\fR.
 .PP
 is "rz[23]a", it would match disks
 \fBrz2a\fR
 and
 \fBrz3a\fR.
 .PP

-\fBDatestamp\fR
+\fIDatestamp\fR

 is useful if
 \fBamflush\fR
 writes multiple backup runs to a single tape.
 .PP
 Unless
 is useful if
 \fBamflush\fR
 writes multiple backup runs to a single tape.
 .PP
 Unless

-\fB-p\fR
+\fB\-p\fR

 is used, candidate backup images are extracted to files in the current directory named:
 .PP
 is used, candidate backup images are extracted to files in the current directory named:
 .PP

-\fBhostname.diskname.datestamp.dumplevel\fR
+\fIhostname.diskname.datestamp.dumplevel\fR

 .PP
 Amrestore doesn't use a changer, it restore from the tape already loaded in the
 .PP
 Amrestore doesn't use a changer, it restore from the tape already loaded in the

-\fBtapedevice.\fR
+\fItapedevice.\fR

 .SH "OPTIONS"
 .SH "OPTIONS"

-.TP
-\fB-b\fR
+.PP
+\fB\-b\fR
+.RS 4

 Set the blocksize used to read the tape or holding file. All holding files must be read with a blocksize of 32 KBytes.
 \fBAmrestore\fR
 should normally be able to determine the blocksize for tapes on its own and not need this parameter.
 Set the blocksize used to read the tape or holding file. All holding files must be read with a blocksize of 32 KBytes.
 \fBAmrestore\fR
 should normally be able to determine the blocksize for tapes on its own and not need this parameter.

+.RE

 .PP
 The default is 32 KBytes.
 .PP
 The default is 32 KBytes.

-.TP
-\fB-f\fR
+.PP
+\fB\-f\fR
+.RS 4

 Do a rewind followed by a fsf <fileno> before trying to restore an image.
 Do a rewind followed by a fsf <fileno> before trying to restore an image.

-.TP
-\fB-l\fR
+.RE
+.PP
+\fB\-l\fR
+.RS 4

 Check if we restoring from the tape with the right
 Check if we restoring from the tape with the right

-\fBlabel\fR
-.TP
-\fB-p\fR
+\fIlabel\fR
+.RE
+.PP
+\fB\-p\fR
+.RS 4

 Pipe output. The first matching backup image is sent to standard output, which is normally a pipe to
 \fBrestore\fR
 or
 \fBtar\fR, then
 \fBamrestore\fR
 Pipe output. The first matching backup image is sent to standard output, which is normally a pipe to
 \fBrestore\fR
 or
 \fBtar\fR, then
 \fBamrestore\fR

-quits. It may be run again to continue selecting backups to process. Make sure you specify the no-rewind
-\fBtapedevice\fR
+quits. It may be run again to continue selecting backups to process. Make sure you specify the no\-rewind
+\fItapedevice\fR

 when doing this.
 when doing this.

+.RE

 .PP
 Note:
 \fBrestore\fR
 may report "short read" errors when reading from a pipe. Most versions of
 \fBrestore\fR
 support a blocking factor option to let you set the read block size, and you should set it to 2. See the example below.
 .PP
 Note:
 \fBrestore\fR
 may report "short read" errors when reading from a pipe. Most versions of
 \fBrestore\fR
 support a blocking factor option to let you set the read block size, and you should set it to 2. See the example below.

-.TP
-\fB-c\fR
+.PP
+\fB\-c\fR
+.RS 4

 Compress output using the fastest method the compression program provides.
 \fBAmrestore\fR
 normally writes output files in a format understood by
 \fBrestore\fR
 or
 \fBtar\fR, even if the backups on the tape are compressed. With the
 Compress output using the fastest method the compression program provides.
 \fBAmrestore\fR
 normally writes output files in a format understood by
 \fBrestore\fR
 or
 \fBtar\fR, even if the backups on the tape are compressed. With the

-\fB-c\fR
+\fB\-c\fR

 or
 or

-\fB-C\fR
+\fB\-C\fR

 option,
 \fBamrestore\fR
 writes all files in compressed format, even if the backups on the tape are not compressed. Output file names will have a
 option,
 \fBamrestore\fR
 writes all files in compressed format, even if the backups on the tape are not compressed. Output file names will have a

-.Z
+\fB.Z\fR

 or
 or

-.gz
+\fB.gz\fR

 extension depending on whether
 \fBcompress\fR
 or
 \fBgzip\fR
 is the preferred compression program. This option is useful when the current directory disk is small.
 extension depending on whether
 \fBcompress\fR
 or
 \fBgzip\fR
 is the preferred compression program. This option is useful when the current directory disk is small.

-.TP
-\fB-C\fR
+.RE
+.PP
+\fB\-C\fR
+.RS 4

 Compress output using the best method the compression program provides (may be very CPU intensive). See the notes above about the
 Compress output using the best method the compression program provides (may be very CPU intensive). See the notes above about the

-\fB-c\fR
+\fB\-c\fR

 option.
 option.

-.TP
-\fB-r\fR
+.RE
+.PP
+\fB\-r\fR
+.RS 4

 Raw output. Backup images are output exactly as they are on the tape, including the
 \fBamdump\fR
 headers. Output file names will have a
 Raw output. Backup images are output exactly as they are on the tape, including the
 \fBamdump\fR
 headers. Output file names will have a

-.RAW
+\fB.RAW\fR

 extension. This option is only useful for debugging and other strange circumstances.
 extension. This option is only useful for debugging and other strange circumstances.

-.TP
-\fB-h\fR
+.RE
+.PP
+\fB\-h\fR
+.RS 4

 Header output. The tape header block is output at the beginning of each file. This is like
 Header output. The tape header block is output at the beginning of each file. This is like

-\fB-r\fR
+\fB\-r\fR

 except
 except

-\fB-c\fR
+\fB\-c\fR

 or
 or

-\fB-C\fR
+\fB\-C\fR

 may also be used to compress the result.
 \fBAmrecover\fR
 uses the header to determine the restore program to use.
 may also be used to compress the result.
 \fBAmrecover\fR
 uses the header to determine the restore program to use.

+.RE
+.PP
+If a header is written (\-r or \-h), only 32 KBytes are output regardless of the tape blocksize. This makes the resulting image usable as a holding file.

 .PP
 .PP

-If a header is written (-r or -h), only 32 KBytes are output regardless of the tape blocksize. This makes the resulting image usable as a holding file.
-.TP
-\fB-o\fR \fIconfigoption\fR
+\fB\-o\fR \fIconfigoption\fR
+.RS 4

 See the "\fBCONFIGURATION OVERWRITE\fR" section in
 \fBamanda\fR(8).
 See the "\fBCONFIGURATION OVERWRITE\fR" section in
 \fBamanda\fR(8).

+.RE

 .SH "EXAMPLES"
 .PP
 The following does an interactive restore of disk
 .SH "EXAMPLES"
 .PP
 The following does an interactive restore of disk

-\fBrz3g\fR
+\fIrz3g\fR

 from host
 from host

-\fBseine\fR, to restore particular files. Note the use of the
+\fIseine\fR, to restore particular files. Note the use of the

 \fBb\fR
 option to
 \fBb\fR
 option to

-\fBrestore\fR, which causes it to read in units of two 512-byte blocks (1 Kbyte) at a time. This helps keep it from complaining about short reads.
+\fBrestore\fR, which causes it to read in units of two 512\-byte blocks (1 Kbyte) at a time. This helps keep it from complaining about short reads.

 .sp
 .sp

+.RS 4

 .nf
 .nf

-
-% amrestore -p /dev/nrmt9 seine rz3g | restore -ivbf 2 -
-
+% amrestore \-p /dev/nrmt9 seine rz3g | restore \-ivbf 2 \-

 .fi
 .fi

+.RE

 .sp
 .PP
 The next example extracts all backup images for host
 .sp
 .PP
 The next example extracts all backup images for host

-\fBseine\fR. This is the usual way to extract all data for a host after a disk crash.
+\fIseine\fR. This is the usual way to extract all data for a host after a disk crash.

 .sp
 .sp

+.RS 4

 .nf
 .nf

-

 % amrestore /dev/nrmt9 seine
 % amrestore /dev/nrmt9 seine

-

 .fi
 .fi

+.RE

 .sp
 .PP
 If the backup datestamp in the above example is
 19910125
 and
 .sp
 .PP
 If the backup datestamp in the above example is
 19910125
 and

-\fBseine\fR
+\fIseine\fR

 has level 0 backups of disks
 has level 0 backups of disks

-\fBrz1a\fR
+\fIrz1a\fR

 and
 and

-\fBrz1g\fR
+\fIrz1g\fR

 on the tape, these files will be created in the current directory:
 .sp
 on the tape, these files will be created in the current directory:
 .sp

+.RS 4

 .nf
 .nf

-

 seine.rz1a.19910125.0
 seine.rz1g.19910125.0
 seine.rz1a.19910125.0
 seine.rz1g.19910125.0

-

 .fi
 .fi

+.RE

 .sp
 .PP
 You may also use
 \fBamrestore\fR
 to extract a backup image from a holding disk file that has not yet been flushed to tape:
 .sp
 .sp
 .PP
 You may also use
 \fBamrestore\fR
 to extract a backup image from a holding disk file that has not yet been flushed to tape:
 .sp

+.RS 4

 .nf
 .nf

-
-% amrestore -p /amanda/20001119/seine.rz1a.2 | restore -ivbf 2 -
-
+% amrestore \-p /amanda/20001119/seine.rz1a.2 | restore \-ivbf 2 \-

 .fi
 .fi

+.RE

 .sp
 .PP
 \fBAmrestore\fR
 may be used to generate a listing of images on a tape:
 .sp
 .sp
 .PP
 \fBAmrestore\fR
 may be used to generate a listing of images on a tape:
 .sp

+.RS 4

 .nf
 .nf

-
-% mt -f /dev/nrmt9 rewind
-% amrestore -p /dev/nrmt9 no-such-host > /dev/null
-
+% mt \-f /dev/nrmt9 rewind
+% amrestore \-p /dev/nrmt9 no\-such\-host > /dev/null

 .fi
 .fi

+.RE

 .sp
 .PP
 This asks
 \fBamrestore\fR
 to find images for host
 .sp
 .PP
 This asks
 \fBamrestore\fR
 to find images for host

-\fBno-such-host\fR. It will not find any entries that match, but along the way will report each image it skips.
+\fBno\-such\-host\fR. It will not find any entries that match, but along the way will report each image it skips.

 .SH "CAVEATS"
 .PP
 .SH "CAVEATS"
 .PP

-\fBGNU-tar\fR
+\fBGNU\-tar\fR

 must be used to restore files from backup images created with the GNUTAR dumptype. Vendor tar programs sometimes fail to read GNU tar images.
 .SH "AUTHOR"
 .PP
 must be used to restore files from backup images created with the GNUTAR dumptype. Vendor tar programs sometimes fail to read GNU tar images.
 .SH "AUTHOR"
 .PP


@@ -249,11 +259,11 @@ James da Silva,
 .PP
 Stefan G. Weichinger,
 <sgw@amanda.org>, maintainer of the
 .PP
 Stefan G. Weichinger,
 <sgw@amanda.org>, maintainer of the

-\fBAmanda\fR-documentation: XML-conversion
+\fIAmanda\fR\-documentation: XML\-conversion

 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),
 \fBamdump\fR(8),
 \fBamflush\fR(8),
 .SH "SEE ALSO"
 .PP
 \fBamanda\fR(8),
 \fBamdump\fR(8),
 \fBamflush\fR(8),

-\fBtar\fR(1)\fBrestore\fR(8)
-
+\fBtar\fR(1)
+\fBrestore\fR(8)