recover

The recover program searches (browses) the client file index for a specified client and recovers files from backup volumes to the specified client. The client file index entries are created when the files are backed up with the save command. When you use the interactive version of the recover program, nwrecover, the client file index is presented in a graphical display format that is similar to a UNIX filesystem.

In the automatic mode (-a option) or save set recover mode (-S option), the files specified on the command line are recovered immediately without browsing the client file index. Use of the save set recover mode (-S option) is restricted to users in the operator group. If you run the recover program without the -S option, and users in the operator group can recover any file.

You can specify one or more path arguments to limit the directories and files to just those you want to recover. If you specify the path argument, the beginning of each path name as it exists in the save set must exactly match one of the paths before it can be recovered. Filename matching using meta characters (for example, *, ?, or [...]) is not allowed. You can use a path that ends with a slash character to force a match to a specific directory.

The following example describes the format and options available for the recover program:

recover [-f] [-n] [-q] [-i {nNyYrR}]

[-d destination] [-c client] [-t date]

[-s server] [dir]
recover [-f] [-n] [-q] [-i {nNyYrR}]

[-d destination] [-c client] [-t date]

[-s server] -a path
recover [-f] [-n] [-q] [-i {nNyYrR}]

[-d destination] [-t date] -s server

-S ssid[/cloneid] [-S ssid[/cloneid]] [path]

• Use the -a option to cause the recover program to automatically recover files without browsing the client file index.

• Use the -c client to specify the name of the machine from which the save sets were originally saved. When you browse a directory that was saved by a different client, the pathnames displayed reflect the filesystem of the client that saved the files. By default, the save and recover programs determine the client machine name from the filesystem table. If you specified the -L option with the save program, the -c client option may not be necessary (see "save " for information about the options available for the save program). You cannot use the -c client option in conjunction with the -S ssid[/cloneid] option.

• Use the -d destination option to specify the destination directory where you relocate the recovered file. Relative paths are interpreted in relation to the current working directory.

• Use the -f option to force recovered files to overwrite any existing files whenever a filename conflict occurs. This option is the equivalent of specifying the combined -iY option.

• Use the -i option with one of the following choices to specify the initial default overwrite response to use when a file name conflict occurs: nNyYrR. You can only specify one letter choice in conjunction with the -i option. The -i option produces the same results as the uasm -i option when you run uasm in recover mode.

• Use the -n option to use the recover program without creating any directories or files.

• Use the -q option to turn off the default verbose mode for the recover program.

• Use the -s server option to specify the Backup server from which you want to recover data. This option is required when you use the save set recover mode (-S). If you omit the -s server option, the default is the server of the first directory marked for recovery, if the server is a network file server as well as a Backup server. If the server is not a network file server or a Backup server, the current server or a machine with a logical name of nsrhost entered in the host table is considered.

• Use the -S ssid[/cloneid] option to use the recover program in save set recover mode. Use this mode to implement batch file recovery without the need for client file indexes. The value of ssid specifies the save set IDs for the save sets you want to recover. When multiple clone instances exist for a save set, you can specify a clone ID to select the particular clone instance you want to recover. If you do not specify the path argument, the entire contents of the save set are recovered.

• Use the -t date option to display or recover files as of the specified date. You cannot use this option in conjunction with the -S ssid option.

  Refer to the recover(1m) man page for more information on how to use the recover program in interactive mode, as well as to view a listing of the more common error messages encountered.