9.5;rbak (read_backup), revision 9.5, 86/11/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 permitte