X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famfetchdump.8;h=10fe5eb48f477e3555c0094319df494437996794;hb=691567b16c13087b31ee4c2b6d038e57872fae82;hp=2ae33aab42ca632f8f146f39a14e558149266b07;hpb=d5853102f67d85d8e169f9dbe973ad573306c215;p=debian%2Famanda diff --git a/man/amfetchdump.8 b/man/amfetchdump.8 index 2ae33aa..10fe5eb 100644 --- a/man/amfetchdump.8 +++ b/man/amfetchdump.8 @@ -1,13 +1,22 @@ '\" t .\" Title: amfetchdump .\" Author: John Stange -.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 -.\" Date: 06/01/2010 +.\" Generator: DocBook XSL Stylesheets v1.76.1 +.\" Date: 01/10/2013 .\" Manual: System Administration Commands -.\" Source: Amanda 3.1.0 +.\" Source: Amanda 3.3.3 .\" Language: English .\" -.TH "AMFETCHDUMP" "8" "06/01/2010" "Amanda 3\&.1\&.0" "System Administration Commands" +.TH "AMFETCHDUMP" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- @@ -22,29 +31,27 @@ amfetchdump \- extract backup images from multiple Amanda tapes\&. .SH "SYNOPSIS" .HP \w'\fBamfetchdump\fR\ 'u -\fBamfetchdump\fR [\-phcClawns] [\-d\ \fIdevice\fR] [\-O\ \fIdirectory\fR] [\-b\ \fIblocksize\fR] [\-\-header\-fd\ \fIfd\fR] [\-\-header\-file\ \fIfilename\fR] [\-o\ \fIconfigoption\fR]... \fIconfig\fR \fIhostname\fR [\fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]] +\fBamfetchdump\fR [\-c | \-C | \-l] [\-p | \-n] [\-a] [\-O\ \fIdirectory\fR] [\-d\ \fIdevice\fR] [\-h | \-\-header\-file\ \fIfilename\fR | \-\-header\-fd\ \fIfd\fR] [\-\-decompress | \-\-no\-decompress | \-\-server\-decompress | \-\-client\-decompress] [\-\-extract\ \-\-directory\fI\ directory\fR\ [\-\-data\-path\fI\ amanda|directtcp\fR]\ [\-\-application\-property\ \fINAME=VALUE\fR]*] [\-\-decrypt | \-\-no\-decrypt | \-\-server\-decrypt | \-\-client\-decrypt] [\-\-exact_match] [\fB\-o\fR\ \fIconfigoption\fR...] \fIconfig\fR \fIhostname\fR [\fIdisk\fR\ [\ \fIdate\fR\ [\ \fIlevel\fR\ [\ \fIhostname\fR\ [\&.\&.\&.]\ ]\ ]\ ]] .SH "DESCRIPTION" .PP \fBAmfetchdump\fR -pulls one or more matching dumps from tape or from the holding disk, handling the reassembly of multi\-tape split dump files as well as any tape autochanger operations\&. +pulls one or more matching dumps from tape or from the holding disk, handling the reassembly of multi\-tape split dump files as well as any tape autochanger operations\&. The dump are by default decompressed and decrypted\&. .PP -It will automatically use the logs created by -\fBamdump\fR(8) -to locate available dumps on tape, in the same way that the +It will automatically use the Amanda catalog to locate available dumps on tape, in the same way that the \fBfind\fR feature of \fBamadmin\fR(8) -lists available dumps\&. If these logs are unavailable, it can search tape\-by\-tape to find what it needs, and can generate new logs to serve as an emergency tape inventory\&. +lists available dumps\&. .PP The \fIhostname\fR, \fIdiskname\fR, \fIdatestamp\fR, and \fIlevel\fR -dump pattern\-matching works as in -\fBamrestore\fR(8), with the added requirement that at minimum a +dump specifications are further described in +\fBamanda-match\fR(7)\&. Note that at minimum a \fIhostname\fR -must be specified when not in inventory mode\&. +must be specified\&. .PP Unless \fB\-p\fR @@ -98,11 +105,84 @@ Compress output, fastest method available\&. Compress output, smallest file size method available\&. .RE .PP +\fB\-\-decompress\fR +.RS 4 +Always do the decompression, this is the default\&. +.RE +.PP +\fB\-\-no\-decompress\fR +.RS 4 +Never do the decompression\&. +.RE +.PP +\fB\-\-server\-decompress\fR +.RS 4 +Do the decompression only if the compression was done on the server\&. +.RE +.PP +\fB\-\-client\-decompress\fR +.RS 4 +Do the decompression only if the compression was done on the client\&. +.RE +.PP +\fB\-\-decrypt\fR +.RS 4 +Always do the decryption, this is the default\&. +.RE +.PP +\fB\-\-no\-decrypt\fR +.RS 4 +Never do the decryption\&. +.RE +.PP +\fB\-\-server\-decrypt\fR +.RS 4 +Do the decryption only if the encryption was done on the server\&. +.RE +.PP +\fB\-\-client\-decrypt\fR +.RS 4 +Do the decryption only if the encryption was done on the client\&. +.RE +.PP +\fB\-\-exact\-match\fR +.RS 4 +The host and disk are parsed as exact values +.RE +.PP +\fB\-\-extract\fR +.RS 4 +Extract the backup on the server in the +\fIdirectory\fR +directory\&. +.RE +.PP +\fB\-\-directory\fR \fIdirectory\fR +.RS 4 +Where to extract the backup with the +\fB\-\-extract\fR +option\&. +.sp +Warning: All files in that directory can be removed\&. +.RE +.PP +\fB\-\-data\-path\fR amanda|directtcp +.RS 4 +The data path to use with +\fB\-\-extract\fR, the default is to use the fatest data path\&. +.RE +.PP +\fB\-\-application\-property\fR \fINAME=VALUE\fR +.RS 4 +Application property to send to the application with +\fB\-\-extract\&.\fR +.RE +.PP \fB\-l\fR .RS 4 -Leave dumps in the compressed/uncompressed state in which they were found on tape\&. By default, -\fBamfetchdump\fR -will automatically uncompress when restoring\&. +Leave dumps in the compressed/uncompressed and encrypted/unencrypted state in which they were found on tape\&. It is a synonym for +\fB\-\-no\-decompression\fR +\fB\-\-no\-decryption\fR .RE .PP \fB\-a\fR @@ -125,12 +205,12 @@ See the "\fBCONFIGURATION OVERRIDE\fR" section in All the examples here assume your configuration is called \fISetA\fR\&. .PP -Here\'s a simple case, restoring all known dumps of the host vanya to the current working directory\&. +Here\*(Aqs a simple case, restoring all known dumps of the host vanya to the current working directory\&. .nf $ amfetchdump SetA vanya .fi .PP -A more likely scenario involves restoring a particular dump from a particular date\&. We\'ll pipe this one to +A more likely scenario involves restoring a particular dump from a particular date\&. We\*(Aqll pipe this one to \fBGNU\-tar\fR as well, to automatically extract the dump\&. .nf @@ -139,7 +219,7 @@ $ amfetchdump \-p SetA vanya /home 20051020 | gtar \-xvpf \- .SH "CAVEATS" .PP \fBAmfetchdump\fR -is dependent on accessing your server\'s config, tape changer, and (normally) dump logs\&. As such, it\'s not necessarily the most useful tool when those have all been wiped out and you desperately need to pull things from your tape\&. Pains have been taken to make it as capable as possible, but for seriously minimialist restores, look to +is dependent on accessing your server\*(Aqs config, tape changer, and (normally) dump logs\&. As such, it\*(Aqs not necessarily the most useful tool when those have all been wiped out and you desperately need to pull things from your tape\&. Pains have been taken to make it as capable as possible, but for seriously minimialist restores, look to \fBamrestore\fR(8) or \fBdd\fR(8) @@ -147,10 +227,9 @@ instead\&. .SH "SEE ALSO" .PP \fBamanda\fR(8), +\fBamanda-match\fR(7), \fBamadmin\fR(8), -\fBamrestore\fR(8), -\fBtar\fR(1), -\fBrestore\fR(8) +\fBamrestore\fR(8) .PP The Amanda Wiki: : http://wiki.zmanda.com/