VMSBACKUP(1) RISC/os Reference Manual VMSBACKUP(1)
NAME
vmsbackup - read a VMS backup tape
SYNOPSIS
vmsbackup -{tx}[cdevw][s setnumber][f tapefile] [ name ... ]
DESCRIPTION
vmsbackup reads a backup tape generated by VMS version 4 or
earlier, converting the files to UNIX format and writing the
files to disc. The default operation of the program is to
go through an entire tape, extracting every file and writing
it to disc. This may be modified by the following options.
c Use complete filenames, including the version number.
A colon and the octal version number will be appended
to all filenames. A colon, rather than a semicolon, is
used since the UNIX Shell uses the semicolon as the
line separator. Using a colon prevents the user from
having to escape the semicolon when referencing the
filename. This option is useful only when multiple
versions of the same file are on a single tape or when
a file of the same name already exists in the destina-
tion directory. The default is to ignore version
numbers.
d use the directory structure from VMS, the default value
is off.
e Process all filename extensions. Since this program is
mainly intended to move source code and possibly data
from a DEC system to a UNIX system, the default is to
ignore all files whose filename extension specifies
system dependent data. The file types which will be
ignored, unless the e option is specified, are
exe VMS executable file
lib VMS object library file
obj RSX object file
odl RSX overlay description file
olb RSX object library file
pmd RSX post mortem dump file
stb RSX task symbol table file
sys RSX bootable system file
tsk RSX executable task file
f
Use the next argument in the command line as the tape device to
be used, rather than the default.
The optional
user
portion of the pathname specifies the login name to use on the
remote system.
Printed 11/19/92 Page 1
VMSBACKUP(1) RISC/os Reference Manual VMSBACKUP(1)
If it is not supplied, the current user's login name will be used.
In all the cases, the user must have the appropriate
permissions on the remote machine, in order to use this facility.
The default is
/dev/rmt8
(drive 0, raw mode, 1600 bpi).
This must be a raw mode tape device.
ssaveset
Process only the given saveset number.
t
Produce a table of contents (a directory listing) on the standard output
of the files on tape.
v
Verbose output.
Normally
vmsbackup
does its work silently.
The verbose option will cause the filenames of the files being read from
tape to disk to be output on the standard output.
w
vmsbackup
prints the action to be taken followed by file name, then
wait for user confirmation. If a word beginning with `y'
is given, the action is done. Any other input means don't do it.
x
extract the named files from the tape.
The optional
name
argument specifies one or more filenames to be
searched for specifically on the tape and only those files are to be processed.
The name may contain the sh(1) meta-characters *?![].
FILES
/dev/rmtx
ERRORS
The filename match uses the complete VMS file names.
BUGS
vmsbackup is a user-contributed utility. MIPS makes no war-
ranty for its function. vmsbackup will be moved to a direc-
tory of non-supported contributed programs in a future
release.
Page 2 Printed 11/19/92