TP(I) 10/15/73 TP(I)
NAME
tp - manipulate DECtape and magtape
SYNOPSIS
tp [ key ] [ name ... ]
DESCRIPTION
Tp saves and restores selected portions of the file system
hierarchy on DECtape or mag tape. Its actions are
controlled by the key argument. The key is a string of
characters containing at most one function letter and
possibly one or more function modifiers. Other arguments to
the command are file or directory names specifying which
files are to be dumped, restored, or listed.
The function portion of the key is specified by one of the
following letters:
r The indicated files and directories, together with
all subdirectories, are dumped onto the tape. If
files with the same names already exist, they are
replaced. `Same' is determined by string
comparison, so `./abc' can never be the same as
`/usr/dmr/abc' even if `/usr/dmr' is the current
directory. If no file argument is given, `.' is the
default.
u updates the tape. u is the same as r, but a file
is replaced only if its modification date is later
than the date stored on the tape; that is to say, if
it has changed since it was dumped. u is the
default command if none is given.
d deletes the named files and directories from the
tape. At least one file argument must be given.
This function is not permitted on magtapes.
x extracts the named files from the tape to the file
system. The owner, mode, and date-modified are
restored to what they were when the file was dumped.
If no file argument is given, the entire contents of
the tape are extracted.
t lists the names of all files stored on the tape
which are the same as or are hierarchically below
the file arguments. If no file argument is given,
the entire contents of the tape is listed.
The following characters may be used in addition to the
letter which selects the function desired.
m Specifies magtape as opposed to DECtape.
0,...,7This modifier selects the drive on which the tape
is mounted. For DECtape, `x' is default; for
magtape `0' is the default.
v Normally tp does its work silently. The v
(verbose) option causes it to type the name of
each file it treats preceded by the function
letter. With the t function, v gives more
information about the tape entries than just the
name.
c means a fresh dump is being created; the tape
directory will be zeroed before beginning. Usable
only with r and u. This option is assumed with
magtape since it is impossible to selectively
overwrite magtape.
f causes new entries on tape to be `fake' in that
no data is present for these entries. Such fake
entries cannot be extracted. Usable only with r
and u.
i Errors reading and writing the tape are noted,
but no action is taken. Normally, errors cause a
return to the command level.
w causes tp to pause before treating each file,
type the indicative letter and the file name (as
with v) and await the user's response. Response y
means `yes', so the file is treated. Null
response means `no', and the file does not take
part in whatever is being done. Response x means
`exit'; the tp command terminates immediately. In
the x function, files previously asked about have
been extracted already. With r, u, and d no
change has been made to the tape.
FILES
/dev/tap?
/dev/mt?
DIAGNOSTICS
Several; the non-obvious one is `Phase error', which means
the file changed after it was selected for dumping but
before it was dumped.
BUGS