6.0c;rbak (read_backup), revision 6.0c, 83/07/07
RBAK (READ_BACKUP) -- Restore or index a magnetic tape backup file.
usage: RBAK {-F fileno|-FID id} [-DEV M<u>] [-INT|-INDEX] [-SLA|-NSLA]
[-ANYS] [-REO] [-PR pn] [-CR|-R|-MS|-MD] [-L|-LD|-LF|-LL]
[-DACL|-SACL] [-PDT] {{-ALL|pn} [-AS disk_pn]}... {CL}
FORMAT
RBAK {pathname [-AS disk_pathname] ... | -ALL} [options]
RBAK restores a magnetic tape backup file which was written with WBAK
(WRITE_BACKUP). Use WBAK and RBAK to backup disks and to transfer
information between separate DOMAIN installations. (Use the RWMT
(READ_WRITE_MAGTAPE) command to transfer information to and from
non-DOMAIN installations.)
RBAK operates in either "index" or "interchange" mode. To restore
objects to disk, use interchange mode (-INT). To list object names
on standard output, without restoring any information to disk, use
index mode (-INDEX).
COMMAND LINE SUMMARY (Complete description follows.)
-F fileno|CUR specify backup file number to read. CUR for current position
-FID fileid specify a 1-17 character backup file ID to read; the file
set is searched for this file ID
-DEV M<unit> specify magtape unit number, M0-M7
-INT cause READ_BACKUP to operate in "interchange" mode
-INDEX cause READ_BACKUP to operate in "index" mode
-SLA cause the backup file label to be displayed
-NSLA suppress the display of the backup file label
-ANYS cause READ_BACKUP to accept any section of the backup file
-REOpen cause previous volume to be reopened, and suppress reading
of tape volume label
-CR cause objects to be restored only name does not exist
-R cause objects restored from tape to replace existing ones
which have the same name
-MD cause directories restored from tape to be merged with
existing directories which have the same name
-MS like -MD, except that preference is given to objects read
from the backup file ('source' objects) when names conflict
-PR preserve the specified objects; valid only when -MS is used
-L cause the names of all files, directories, and links to be
written to standard output
-LD, -LF, -LL cause the names of all files (-LF), directories (-LD), or
links (-LL) saved to be written to standard output
-DACL apply the destination directory's default acl for the object
-SACL apply the acl in effect when the file or directory was
written on the tape
-ALL cause all files, directories, and links in the backup file
to be restored or indexed
-AS cause the specified pathname on tape to be restored as
a different pathname
-PDT preserve the date-time modified and the date-time used
of the saved object
FULL DESCRIPTION
ARGUMENTS
pathname
(optional) Specify name of object to be indexed or restored to disk.
This may be a directory, file, or link. If the object is
being restored, the new disk object will have the same name.
If you wish the disk file to be saved under a different
name, use -AS (below). Multiple pathnames are permitted.
Default if omitted: must use -ALL.
OPTIONS
(Default options are indicated by "(D)".)
= Tape File Identifiers =
(One of the following options is required.)
-F file_no Read the backup file with the file number specified.
You assigned this number with WBAK.
-F CUR Begin reading at current tape position.
-FID file_id Read the backup file name specified. You assigned
this name using WBAK.
= Mode Control =
-INT (D) Select "interchange" mode. Tape files are restored
to disk.
-INDEX Select "index" mode. Tape file names are listed on
standard output; no information is restored to disk.
= Catalog Control =
-ALL Restore or index all the objects on the tape. This
option is required if you do not use the 'pathname'
argument to indicate a particular object to be indexed
or restored.
-AS pathname1 Restore the object specified and assign a different
disk pathname ('pathname1'). This option is only
valid when used with the 'pathname' argument on the
RBAK command line.
-CR (D) Specify create mode. RBAK does not restore objects
if their names already exist on disk. It prints an
error message if a name exists on both disk and tape,
and continues.
-R Specify replace mode. RBAK deletes the existing disk
object, and replaces it with the object read from tape.
-MS Specify merge-source mode. Similar to replace mode.
If an object already exists on disk, RBAK deletes the
disk version and restores the tape version (the source).
However, if the object is a directory, RBAK merges the
tape directory's contents with the disk directory.
- PR pathname... Valid only when used with -MS. Preserve specified
objects on the disk. Multiple pathnames and wildcarding
are permitted. If the objects exist on disk, they will
NOT be overwritten by synonymous tape objects.
-MD Specify merge-destination mode. Similar to create mode.
If an object already exists on disk (the destination)
RBAK does not restore the tape version, and retains the
disk version. However, if the object is a directory RBAK
merges the tape directory's contents with the disk
directory.
= Label Control =
-SLA (D) Display the tape file label on standard output.
-NSLA Do not display the tape file label.
= Listing Control =
You may include the -L option, or any combination of -LD, -LF and -LL.
-L Write all the file, directory, and link names to standard
output.
-LD Write all directory names to standard output.
-LF Write all filenames to standard output.
-LL Write all linknames to standard output.
= Tape Control =
-ANYS Force RBAK to accept any section of the backup file.
When a backup file spans multiple tape volumes, RBAK
normally begins with the tape volume containing the
backup file's first section, and proceeds to the
tape volume containing the second section, and so on.
If you know which tape volume contains the object you
want to restore or index, use this option. This lets
RBAK start at any section of the backup file.
-REO Force previous volume to be reopened, and suppress
reading of tape volume label. Use only when tape has
not been repositioned since last WBAK or RBAK.
-DEV Munit Specify magtape unit number. 'unit' is an integer (0-3)
and is required (i.e., -DEV M2). If this option is
omitted, RBAK assumes device M0.
= ACL Control =
-DACL (D) Assign the destination directory's default ACL to the
object being restored.
-SACL Retain the restored object's orginal ACL.
= DTM/DTU Control =
-PDT Preserve the object's original date-time modified and
date-time used.
RBAK uses the command line parser, and so also accepts the standard command
options listed in HELP CL.
EXAMPLES
$ rbak -f 1 fred/soup Read "fred/soup" in backup file 1 and restore it
to disk. "Fred/soup" may be a directory, file,
or link.
$ rbak -f 1 fred/soup -as //node5/noodle Restore "fred/soup" and place
it in "noodle" on node5.
RELATED TOPICS
More information is available. Type:
- HELP WBAK
for details about writing tape backup files.
- HELP RWMT
for details about reading or writing tapes from non-DOMAIN
installations.
- HELP MAGTAPE
for general information on magnetic tape usage and support.