diff options
Diffstat (limited to 'static/unix-v10/man1/tap.1')
| -rw-r--r-- | static/unix-v10/man1/tap.1 | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/static/unix-v10/man1/tap.1 b/static/unix-v10/man1/tap.1 new file mode 100644 index 00000000..14530539 --- /dev/null +++ b/static/unix-v10/man1/tap.1 @@ -0,0 +1,147 @@ +.pa 1 +.he 'TAP (I)'3/15/72'TAP (I)' +.ti 0 +NAME tap -- manipulate DECtape +.sp +.ti 0 +SYNOPSIS tap___ [ key ] [ name ... ] +.sp +.ti 0 +DESCRIPTION tap___ +saves and restores selected portions of the file system +hierarchy on DECtape. +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 tabled. + +The function portion of +the key is specified by one of the following letters: + +.in +6 +.ti -3 +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 (hence the "r"). +"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. + +.ti -3 +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. + +.ti -3 +d deletes the named files and directories from +the tape. At least one file argument must be given. + +.ti -3 +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. + +.ti -3 +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 are tabled. + +.ti -3 +l is the same as t_ except that an expanded listing +is produced giving all the available information about the +listed files. + +.in -6 +The following characters may be used in addition to the letter +which selects the function desired. + +.in +6 +.ti -3 +0, ..., 7 This modifier selects the drive on which the tape is mounted. +"0" is the default. + +.ti -3 +v Normally tap___ does its work silently. The v_ (verbose) +option causes it to type the name of each file it treats +preceded by a letter to indicate what is happening. + +.in +2 + r file is being replaced +.nf + a file is being added (not there before) +.fi + x file is being extracted + d file is being deleted + +.in -2 +The v_ option can be used with r_, u_, d_, and x_ only. + +.ti -3 +c means a fresh dump is being created; the tape directory +will be zeroed before beginning. Usable only with r_ and u_. + +.ti -3 +f causes +new entries copied 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_. + +.ti -3 +w causes tap___ 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 tap___ 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. + +.ti -3 +m make (create) directories during an x_ if necessary. +.in -6 +.sp +.ti 0 +FILES /dev/tap? +.sp +.ti 0 +SEE ALSO mt(I) +.sp +.ti 0 +DIAGNOSTICS Tape open error +.br +Tape read error +.br +Tape write error +.br +Directory checksum +.br +Directory overflow +.br +Tape overflow +.br +Phase error (a file has changed after it was selected for +dumping but before it was dumped) +.br +.sp +.ti 0 +BUGS Asks +about "fake" entries on "xw", when it should ignore +them. +If a fake entry is extracted, and the file already +exists on disk, the extraction does not take +place (as is correct), but the mode and user ID of the file +are set to 0. |