Restore command principles

Syntax of the restore command

The restore command syntax is as follows:

restore options [arguments] [files ...]

options can be one restore type with modifiers.

Rules for using the restore command

Follow these rules when you enter the restore command:

Specify one and only one restore type.
Specify multiple options without intervening spaces.
Enter the arguments for each option in the order that you specify the options. Separate each argument from the next with a space.
If the destination for each file is the same as the location from which it was backed up, you do not need to explicitly specify a destination.

Example of a simple restore command

The following command illustrates the restore command syntax. It restores all the files in the dump tape to the same destinations from which they were backed up.

Restore types

A restore type specifies the type of restore you are performing. For a restore from tape, you must specify one and only one restore type. The following table summarizes the restore types.

Restore type	Meaning	Option	For more information, see...
Restart	Restarts data recovery after an interruption.	`R`	Specifying a resumed restore
Qtree table of contents	Lists qtree names and qtree information in a restore.	`T`	Specifying a table-of-contents restore
Full	Rebuilds the file system or subtree. If you are applying incrementals, you must specify this option.	`r`	Specifying a full restore
File table of contents	Lists file names in a restore.	`t`	Specifying a table-of-contents restore
File	Extracts an individual file or subtree from the backup.	`x`	Specifying an individual file restore

Modifiers

Modifiers specify optional actions. The following table summarizes the modifiers.

Option	Meaning	For more information, see...
`A`	Specifies not to restore Windows NT ACLs.	Specifying no Windows NT ACLs
`D`	Specifies the directory into which the files are restored. Argument The directory into which you are restoring files. Without an argument, the files are restored to the directory from which they were backed up.	Specifying the restore destination
`F`	Forces `restore` to continue regardless of inode limitations.	Specifying ignoring inode limitations
`N`	Reads backup tapes without writing to the filer.	Specifying a test restore
`Q`	Ignores qtree information.	Specifying no qtree information
`b`	Specifies the blocking factor. Argument The blocking factor that you used in the backup that you are restoring	Specifying the blocking factor
`f`	Specifies the tape device for each tape file. Argument The name of one or more tape devices, separated by commas	Specifying tape devices
`s`	Specifies the relative position of a tape file if multiple tape files exist on a tape. File numbering starts at 1 from the current tape position. Argument The tape file number	Specifying a single tape file on a multifile tape
`v`	Specifies that `restore` displays the inode number of each file restored.	Specifying detailed status output
`y`	Specifies that `restore` not ask whether it should terminate when it gets an error.	Specifying automatic confirmations

Executing a restore command

Follow these steps to execute a restore command.

Step	Action
1	Place the tape containing the first tape file of the backup in the tape drive that you specify.
2	Enter the `restore` command.
3	If prompted, insert the next tape of the backup that you are restoring into the appropriate tape drive.
4	Repeat Step 3 until the restore is complete.

Restore command principles

Syntax of the restore command

Rules for using the restore command

Example of a simple restore command

Restore types

Modifiers

Argument

Argument

Argument

Argument

Executing a restore command