restore.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

restore(1M) restore(1M)

NAME

restore, rrestore - restore ﬁle system incrementally, local or across network

SYNOPSIS

/usr/sbin/restore

key [ name ... ]

/usr/sbin/rrestore

key [ name ... ]

DESCRIPTION

The

restore and rrestore commands read tapes previously dumped by the

dump or rdump com-

mand (see dump(1M) and rdump (1M)).

Actions taken are controlled by the key argument where key is a string of characters containing not more

than one function letter and possibly one or more function modiﬁers. One or more name arguments, if

present, are ﬁle or directory names specifying the ﬁles that are to be restored. Unless the

h modiﬁer is

speciﬁed (see below), the appearance of a directory name refers to the ﬁles and (recursively) subdirec-

tories of that directory.

Function Portion of key

The function portion of the key is speciﬁed by one of the following letters:

r Read the tape and load into the current directory. r should be used only after careful con-

sideration, and only to restore a complete dump tape onto a clear ﬁle system, or to restore an

incremental dump tape after a full level zero restore. Thus,

/usr/sbin/newfs -F hfs /dev/rdisk/disk2

/usr/sbin/mount /dev/disk/disk2 /mnt

cd /mnt

restore r

is a typical sequence to restore a complete dump. Another restore or rrestore can then

be performed to restore an incremental dump on top of this. Note that restore and rre-

store leave a ﬁle restoresymtab

in the root directory of the ﬁle system to pass informa-

tion between incremental restore passes. This ﬁle should be removed when the last incre-

mental tape has been restored. A

dump or rdump followed by a newfs and a restore or

rrestore is used to change the size of a ﬁle system (see newfs(1M)).

R restore and rrestore request a particular tape of a multivolume set on which to restart

a full restore (see r above). This provides a means for interrupting and restarting restore

and rrestore.

x Extract the named ﬁles from the tape. If the named ﬁle matches a directory whose contents

had been written onto the tape, and the h modiﬁer is not speciﬁed, the directory is recursively

extracted. The owner, modiﬁcation time, and mode are restored (if possible). If no ﬁle argu-

ment is given, the root directory is extracted, which results in the entire contents of the tape

being extracted, unless h has been speciﬁed.

t Names of the speciﬁed ﬁles are listed if they occur on the tape. If no ﬁle argument is given,

the root directory is listed, which results in the entire content of the tape being listed, unless

h has been speciﬁed.

s The next argument to restore is used as the dump ﬁle number to recover. This is useful if

there is more than one dump ﬁle on a tape.

i This mode allows interactive restoration of ﬁles from a dump tape. After reading in the direc-

tory information from the tape, restore and rrestore provide a shell-like interface that

allows the user to move around the directory tree selecting ﬁles to be extracted. The available

commands are given below; for those commands that require an argument, the default is the

current directory.

add [arg] The current directory or speciﬁed argument is added to the list of ﬁles to be

extracted. If a directory is speciﬁed, it and all its descendents are added to

the extraction list (unless the h key is speciﬁed on the command line). File

names on the extraction list are displayed with a leading * when listed by

ls.

cd [arg] Change the current working directory to the speciﬁed argument.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
restore(1M) restore(1M) NAME restore, rrestore - restore file system incrementally, local or across network SYNOPSIS /usr/sbin/restore key [ name ... ] /usr/sbin/rrestore key [ name ... ] DESCRIPTION The restore and rrestore commands read tapes previously dumped by the dump or rdump command (see dump(1M) and rdump(1M)). Actions taken are controlled by the key argument where key is a string of characters containing not more than one function letter and possibly one or more function modifiers.
PAGE 2
restore(1M) restore(1M) delete [arg] The current directory or specified argument is deleted from the list of files to be extracted. If a directory is specified, it and all its descendents are deleted from the extraction list (unless h is specified on the command line). The most expedient way to extract files from a directory is to add the directory to the extraction list, then delete unnecessary files. extract All files named on the extraction list are extracted from the dump tape.
PAGE 3
restore(1M) restore(1M) volume. There are numerous consistency checks that can be listed by restore and rrestore. Most checks are self-explanatory or can ‘‘never happen’’. Here are some common errors: filename : not found on tape The specified file name was listed in the tape directory but not found on the tape. This is caused by tape read errors while looking for the file, and from using a dump tape created on an active file system.
PAGE 4
(Notes) A (Notes) rA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010