9.5;rbak (read_backup), revision 9.7, 87/10/06
RBAK (READ_BACKUP) -- Restore or index a magnetic media backup file.
usage: RBAK {-F fileno|-FID id} [-DEV | M<u> | F | CT] [-INT|-INDEX]
[-SLA|-NSLA] [-ANYS] [-REO] [-PR pn]
[-CR|-R|-MS|-MD] [-FORCE] [-DU]
[-L|-LD|-LF|-LL] [-RETEN|-NRETEN]
[-REWIND] [-DACL|-SACL] [-PDT]
{{-ALL|pn} [-AS disk_pn]}... {CL}
FORMAT
RBAK {pathname [-AS disk_pathname] ... | -ALL} [options]
RBAK restores a magnetic media 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 type 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 backup media volume label
-CR cause objects to be restored only name does not exist
-R cause objects restored from backup media 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 backup media 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 pathname 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
-RETEN retension a cartridge tape
-NRETEN do not retension a cartridge tape
-REWIND rewind a cartridge tape
-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 backup media
-ALL cause all files, directories, and links in the backup file
to be restored or indexed
-AS pathname cause the specified pathname on backup media 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)."
Backup 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 position on the backup media.
-FID file_id Read the backup file name specified. You assigned this
name using WBAK.
Mode Control
-INT (D) Select "interchange" mode. Backup files are restored to
disk.
-INDEX Select "index" mode. Backup file names are listed on
standard output; no information is restored to disk.
Catalog Control
-ALL Restore or index all the objects in the backup file
specified. 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 backup media, and
continues.
-R Specify replace mode. RBAK deletes the existing disk
object, and replaces it with the object read from backup
media.
-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 backup media version (the source).
However, if the object is a directory, RBAK merges the
backup media 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 backup media
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 backup media version, and retains the
disk version. However, if the object is a directory RBAK
merges the backup media directory's contents with the disk
directory.
Label Control
-SLA (D) Display the backup media file label on standard output.
-NSLA Do not display the backup media 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.
Backup Device Control
-ANYS Force RBAK to accept any section of the backup file. When
a backup file spans multiple backup media volumes, RBAK
normally begins with the backup media volume containing the
backup file's first section, and proceeds to the backup
media volume containing the second section, and so on. If
you know which backup media 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 backup media volume label. Use only when backup media
has not been repositioned since last WBAK or RBAK.
-DEV d[unit] Specify device type and unit number. 'd' must be either
'M' (for reel-to-reel magnetic tape), 'CT' (for cartridge
tape), or 'F' (for floppy), depending on which drive is
being used. 'unit' is an integer (0-3). Both are required
for reel-to-reel tapes (i.e., -DEV M2). A unit number is
NOT required for floppy disks and cartridge tapes (i.e.,
-DEV F). If this option is omitted, RBAK assumes device
M0.
CAUTION: Floppy disk support for this command is limited.
In particular, error detection during reads and
writes is poor. DO NOT use this command with
floppy disks when the data being placed on the
floppy disks are critical and unrecoverable.
-RETEN Retension the cartridge tape (unwind to the end, then
rewind). This can be helpful if you have encountered
cartridge tape reading errors. Retensioning requires about
1.5 minutes to complete.
-NRETEN (D) Do not retension the cartridge tape.
-REWIND Rewind the cartridge tape after reading or indexing. If
this option is omitted, the cartridge tape is left
positioned to the next tape file. This option is valid
ONLY for the cartridge tape; reel-to-reel tapes get rewound
automatically when removed from the drive.
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.
$ rbak -dev ct -rewind Rewind the cartridge tape prior to removing it
from the tape unit.
RELATED TOPICS
More information is available. Type:
- HELP WBAK
for details about writing magnetic media backup files.
- HELP RWMT
for details about reading or writing tapes from non-DOMAIN installations.
- HELP MEDIA
for general information on removable magnetic media usage and support.