docs: Added UNIX V10 Manuals

1 files changed, 147 insertions, 0 deletions

diff --git a/static/v10/man1/tap.1 b/static/v10/man1/tap.1
new file mode 100644
index 00000000..14530539
--- /dev/null
+++ b/static/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.