8.0;rbak (read_backup), revision 8.0, 84/05/14
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]
[-FORCE] [-DU] [-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 d<unit> specify device and unit number
-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
-FORCE force object deletion if you have owner rights, even if you
don't have delete rights.
-DU delete when unlocked
-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
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; however, wildcarding is not supported.
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.
-FORCE Force object deletion if you have owner rights, even if you
don't have delete rights.
-DU Delete when unlocked. If the object to be deleted is
locked when RBAK is invoked, the delete operation will be
performed when the object is unlocked.
-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...
Preserve specified objects on the disk. Multiple pathnames
and wildcarding are permitted. If the objects exist on
disk, they will NOT be overwritten by tape versions. This
option must be used with the -MS option.
-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 dunit Specify device unit number. 'd' must be either 'M' (for
magtape) or 'F' (for floppy), depending on which drive is
being used. 'unit' is an integer (0-3). Both are 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.
This command 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.