Imported Upstream version 2.5.1
[debian/amanda] / docs / amrecover.8.txt
index f957e7de39b2d361fbbf242ff6893a30a9947785..0833bc8301edbc7bd044e6127b239ec1794f203c 100644 (file)
@@ -1,47 +1,53 @@
 
                              amrecover
-Prev  Chapter 35. The AMANDA Manual Pages.  Next
+Prev  Chapter 36. The Amanda Manual Pages.  Next
 
 -------------------------------------------------------------------------------
 
 Name
 
-amrecover \14 AMANDA index database browser
+amrecover \14 Amanda index database browser
 
 Synopsis
 
-amrecover [[-C ] config ] [ -s index-server ] [ -t tape-server ] [ -d tape-
-device ]
+amrecover [[-C ] | config ] [ -s | index-server ] [ -t | tape-server ] [ -d |
+tape-device ] [ -o | clientconfigoption ]*
 
 DESCRIPTION
 
-Amrecover browses the database of AMANDA index files to determine which tapes
+Amrecover browses the database of Amanda index files to determine which tapes
 contain files to recover. Furthermore, it is able to recover files.
 In order to restore files in place, you must invoke amrecover from the root of
 the backed up filesystem, or use lcd to move into that directory, otherwise a
 directory tree that resembles the backed up filesystem will be created in the
 current directory. See the examples below for details.
-See the amanda(8) man page for more details about AMANDA.
+Amrecover will read the amanda-client.conf file and the config/amanda-
+client.conf file.
+See the amanda(8) man page for more details about Amanda.
 
 OPTIONS
 
 
 Note
 
-The listed defaults map to the values you ran the configure-script with.
+The Default values are those set at compile-time. Use amrestore to recover
+client-encrypted or client-custom-compressed tapes.
 
 
   [ -C ] config
-      AMANDA configuration (default: daily).
+      Amanda configuration.
 
   -s index-server
-      Host that runs the index daemon (default: oops).
+      Host that runs the index daemon.
 
   -t tape-server
-      Host that runs the tape server daemon (default: 192.168.0.10).
+      Host that runs the tape server daemon.
 
   -d tape-device
-      Tape device to use on the tape server host (default: /dev/nst0).
+      Tape device to use on the tape server host.
+
+  -o clientconfigoption
+      See the "CONFIGURATION OVERWRITE" section in amanda(8).
 
 
 COMMANDS
@@ -57,8 +63,8 @@ be extracted from the backup system. The following commands are available:
       Specifies which host to look at backup files for (default: the local
       host).
 
-  setdate YYYY-MM-DD
-      Set the date (default: today). File listing commands only return
+  setdate YYYY-MM-DD-HH-MM[-SS] | YYYY-MM-DD
+      Set the restore time (default: now). File listing commands only return
       information on backup images for this day, for the day before with the
       next lower dump level, and so on, until the most recent level 0 backup on
       or before the specified date is encountered.
@@ -67,8 +73,8 @@ be extracted from the backup system. The following commands are available:
       1996-07-01 was a level 0 backup
       1996-07-02 through 1996-07-05 were level 1 backups
       1996-07-06 through 1997-07-08 were level 2 backups
-      then if 1997-07-08 is the requested date, files from the following days
-      would be used:
+      then the command setdate 1997-07-08-00 would yield files from the
+      following days:
 
       1997-07-08 (the latest level 2 backup)
       1997-07-05 (the latest level 1 backup)
@@ -86,7 +92,7 @@ be extracted from the backup system. The following commands are available:
 
 
 
-  setdisk diskname mountpoint
+  setdisk diskname [mountpoint]
       Specifies which disk to consider (default: the disk holding the working
       directory where amrecover is started). It can only be set after the host
       is set with sethost. Diskname is the device name specified in the
@@ -94,17 +100,20 @@ be extracted from the backup system. The following commands are available:
       host. If mountpoint is not specified, all pathnames will be relative to
       the (unknown) mount point instead of full pathnames.
 
+  listhost [diskdevice]
+      List all host
+
   listdisk [diskdevice]
       List all diskname
 
   settape [[server]:][tapedev|default]
       Specifies the host to use as the tape server, and which of its tape
       devices to use. If the server is omitted, but the colon is not, the
-      server name reverts to 192.168.0.10, the configure-time default. If the
-      tape device is omitted, it remains unchanged. To use the default tape
-      device selected by the tape server, the word default must be specified.
-      If no argument is specified, or the argument is an empty string, no
-      changes occur, and the current settings are displayed.
+      server name reverts to the configure-time default. If the tape device is
+      omitted, it remains unchanged. To use the default tape device selected by
+      the tape server, the word default must be specified. If no argument is
+      specified, or the argument is an empty string, no changes occur, and the
+      current settings are displayed.
       If you want amrecover to use your changer, the tapedev must be equal to
       the amrecover_changer setting on the server.
       If you need to change the protocol (tape:, rait:, file:, null:) then you
@@ -181,7 +190,7 @@ be extracted from the backup system. The following commands are available:
   list file
       Display the contents of the restore list. If a file name is specified,
       the restore list is written to that file. This can be used to manually
-      extract the files from the AMANDA tapes with amrestore.
+      extract the files from the Amanda tapes with amrestore.
 
   clear
       Clear the restore list.
@@ -211,7 +220,7 @@ The following shows the recovery of an old syslog file.
   syslog.7: No such file or directory
   # amrecover
   AMRECOVER Version 2.4.2. Contacting server on oops ...
-  220 oops AMANDA index server (2.4.2) ready.
+  220 oops Amanda index server (2.4.2) ready.
   Setting restore date to today (1997-12-09)
   200 Working date set to 1997-12-09.
   200 Config set to daily.
@@ -336,16 +345,22 @@ ENVIRONMENT
 
 PAGER The ls and list commands will use $PAGER to display the file lists.
 Defaults to more if PAGER is not set.
+AMANDA_SERVER If set, $AMANDA_SERVER will be used as index-server. The value
+will take precedence over the compiled default, but will be overridden by the -
+s switch.
+AMANDA_TAPE_SERVER If set, $AMANDA_TAPE_SERVER will be used as tape-server. The
+value will take precedence over the compiled default, but will be overridden by
+the -t switch.
 
 AUTHOR
 
 Alan M. McIvor <alan@kauri.auck.irl.cri.nz> : Original text
-Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the AMANDA-documentation:
+Stefan G. Weichinger, <sgw@amanda.org>, maintainer of the Amanda-documentation:
 XML-conversion
 
 SEE ALSO
 
-amanda(8), amrestore(8), readline(3)
+amanda(8), amanda-client.conf(5), amrestore(8), amfetchdump(8), readline(3)
 -------------------------------------------------------------------------------
 
 Prev     Up       Next