Library Table of Contents Index Previous Next Comments

Using the restore command

Specifying a table-of-contents restore

About displaying a table of contents of a tape file  Top

You can display a table of contents of the files or qtrees in a tape file rather than do an actual data restore. This is useful in determining what files or qtrees are on a tape and their locations. For qtrees, the restore lists qtree properties.

A table-of-contents restore takes much less time than a full restore because only the list of files in the backup is read. However, it uses a lot of CPU time because of the extensive output produced.

Use Remote Shell for a table-of-contents restore  Top

In general, you should run a table-of-contents restore from a Remote Shell connection because an enormous output is generated. Usually, you can control the output more easily when it is sent to a client console rather than to the filer console. Client consoles are also more flexible and enable you to save output.

Furthermore, you rarely need to change tapes with the t option. The command needs to read only the directory information from the tape and none of the files or qtrees. Because directory information tends to constitute a small part of a backup, it is almost always located on one tape. Also, table-of-contents restores work with multiple tape files specified on the command line.

Types of table-of-contents restores  Top

You can specify two kinds of tables of contents: file and qtree. You cannot combine the two types in a single command.

Type

Meaning

Option

File

Lists all the file names in a backup. If you specify path names, only the files in the path names are listed.

t

Qtree

Lists qtrees and their settings for security style and Windows NT oplocks for all qtrees. If you specify qtree names, the information for only those qtrees is listed if they are in the backup.

T

Specifying table-of-contents restores  Top

To specify a table-of-contents restore, complete the following step.

Step

Action

1

Use the T or t option in the restore command line, with files as an argument. If there is no argument, the entire content of a backup is listed.

Example

The following command lists all files in a backup:

Example

The following command lists all qtree names in a backup:

Library Table of Contents Index Previous Next Comments