RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C)
-------------------------------------------------------------------------------
restorebsd
PURPOSE
Reads tapes dumped with the dumpbsd command.
SYNTAX
+----------+ +------------------+ +--------+
/etc/restorebsd ---| one of |---| +--------------+ |---| |---|
| +------+ | +-| v |-+ ^ +- name -+ |
+-| r + |-+ ^| F input_file || +------------+
| R i | || y ||
| x | || m ||
+------+ || h ||
|| b ||
|| c ||
|| d ||
|| s ||
|+--------------+|
+----------------+
DESCRIPTION
Note: The restorebsd command is not used to port information between AIX and
BSD systems. The tar command is used for compatibility with BSD
systems.
The restorebsd command reads the tape or specified device dumped with the
dumpbsd command. Its actions are controlled by the flags described below.
Other arguments to the command are file or directory names specifying the files
that are to be restored. Unless the h flag is specified, the appearance of a
directory name refers to the files and (recursively) subdirectories of that
directory.
FLAGS
You can specify one of the following flags to describe the function:
r The tape is read and loaded into the current directory. This should
not be done lightly; the r key should only be used to restore a
complete dump tape onto a clear file system or to restore an
incremental dump tape after a full level zero restore. Thus
Processed November 8, 1990 RESTOREBSD(8,C) 1
RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C)
/etc/mkfs /dev/rhd?
/etc/mount /dev/hd? /mnt
cd /mnt
restorebsd r
is a typical sequence to restore a complete dump. Another restorebsd
can be done to get an incremental dump in on top of this. Note that
restorebsd leaves a file restoresymtable in the root directory to pass
information between incremental restore passes. This file should be
removed when the last incremental tape has been restored.
R The restorebsd command requests a particular tape of a multi-volume set
on which to restart a full restore (see the r key above). This allows
restorebsd to be interrupted and then restarted.
x The named files are extracted from the tape. If the named file matches
a directory whose contents had been written onto the tape, and the h
key is not specified, the directory is recursively extracted. The
owner, modification time, and mode are restored (if possible). If no
file argument is given, then the root directory is extracted, which
results in the entire content of the tape being extracted, unless the h
key has been specified.
t The names of the specified files are listed if they occur on the tape.
If no file argument is given, then the root directory is listed, which
results in the entire content of the tape being listed, unless the h
key has been specified. The t key replaces the function of the old
dumpdir program.
i This mode allows interactive restoration of files from a dump tape.
After reading in the directory information from the tape, restorebsd
provides a shell like interface that allows the user to move around the
directory tree selecting files to be extracted. The available commands
are given below; for those commands that require an argument, the
default is the current directory.
ls [arg] List the current or specified directory. Entries that are
directories are appended with a "/". Entries that have
been marked for extraction are prepended with a "*". If
the verbose key is set the inode number of each entry is
also listed.
cd arg Change the current working directory to the specified
argument.
pwd Print the full path name of the current working directory.
add [arg] The current directory or specified argument is added to the
list of files to be extracted. If a directory is
specified, then it and all its descendents are added to the
extraction list (unless the h key is specified on the
Processed November 8, 1990 RESTOREBSD(8,C) 2
RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C)
command line). Files that are on the extraction list are
prepended with a "*" when they are listed by ls.
delete [arg]
The current directory or specified argument is deleted from
the list of files to be extracted. If a directory is
specified, then it and all its descendents are deleted from
the extraction list (unless the h key is specified on the
command line). The most expedient way to extract most of
the files from a directory is to add the directory to the
extraction list and then delete those files that are not
needed.
extract All the files that are on the extraction list are extracted
from the dump tape. restorebsd will ask which volume the
user wishes to mount. The fastest way to extract a few
files is to start with the last volume, and work towards
the first volume.
setmodes All the directories that have been added to the extraction
list have their owner, modes, and times set; nothing is
extracted from the tape. This is useful for cleaning up
after a restore has been prematurely aborted.
verbose The sense of the v key is toggled. When set, the verbose
key causes the ls command to list the inode numbers of all
entries. It also causes restorebsd to print out
information about each file as it is extracted.
help List a summary of the available commands.
quit Restore immediately exits, even if the extraction list is
not empty.
D Toggles debugging mode.
x Immediate quit (same as quit command).
The following flags can be used to modify the function of restorebsd:
v Normally restorebsd does its work silently. The v (verbose) key causes
it to type the name of each file it treats preceded by its file type.
f The next argument to restorebsd is used as the name of the archive
device instead of /dev/rmt?. If the name of the file is "-",
restorebsd reads from standard input. Thus, dumpbsd and restorebsd can
be used in a pipeline to dump and restore a file system with the
command
/etc/dumpbsd 0f - /usr | (cd /mnt; /etc/restorebsd xf -)
Processed November 8, 1990 RESTOREBSD(8,C) 3
RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C)
F The next argument to restorebsd is used as the name of a file from
which interactive input is read. Normally, standard input (or the
controlling terminal if the f key specifies standard input) is read.
This flag allows the interactive mode of restorebsd to be driven from a
command file when the archive file is standard input. The interactive
interface, the prompt for next volume number, and the prompt to set the
access mode for "." are affected. Error recovery interaction and
verifying operator readiness are not affected. For example, if the
file inputfile contains
add
delete foo
add foo/bar
extract
1
yes
quit
then the command
/etc/restorebsd iF inputfile
will use the interactive mode to automatically mark everything for
extraction, unmark the directory foo, mark foo/bar, extract the marked
files, specify volume 1, set the access mode for ".", and quit. The
easiest way to determine the commands needed is to do the restore by
hand once, and write down everything that you type.
y The restorebsd command will not ask whether it should abort the restore
if gets a tape error. It will always try to skip over the bad tape
block(s) and continue as best it can.
m The restorebsd command will extract by inode numbers rather than by
file name. This is useful if only a few files are being extracted, and
one wants to avoid regenerating the complete path name to the file.
h The restorebsd command extracts the actual directory, rather than the
files that it references. This prevents hierarchical restoration of
complete subtrees from the tape.
b The next argument to restorebsd is used as the block size of the tape
(in kilobytes). If this key is not present, restorebsd tries to
determine the block size dynamically.
c Convert an old style dump tape (pre 4.2BSD file system).
d Debug mode. The restorebsd command will perform many internal
consistency checks and print out the debugging information.
s The next argument to restorebsd is used as the number (1 origin) of the
dump file to restore. Allows more than one dump file on a tape.
Processed November 8, 1990 RESTOREBSD(8,C) 4
RESTOREBSD(8,C) AIX Commands Reference RESTOREBSD(8,C)
FILES
/dev/rmt? The default tape drive.
/tmp/rstdir* File containing directories on the tape.
/tmp/rstmode* Owner, mode, and time stamps for directories.
./restoresymtable Information passed between incremental restores.
Note: The restorebsd command is not used to port information between AIX and
BSD systems. The tar command is used for compatibility with BSD
systems.
RELATED INFORMATION
See the following commands: "backup," "dumpbsd," "mount," "mkfs,"
"rrestore," and "rdump."
Processed November 8, 1990 RESTOREBSD(8,C) 5