    TP(I)                        10/15/73                       TP(I)

    NAME
         tp  -  manipulate DECtape and magtape

    SYNOPSIS
         tp [ key ] [ name ... ]

    DESCRIPTION
         Tp  saves and restores files on DECtape or magtape.  Its ac-
         tions 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  argu-
         ments  to the command are file or directory names specifying
         which files are to be dumped, restored, or listed.   In  all
         cases,  appearance  of  a directory name refers to the files
         and (recursively) subdirectories of that directory.

         The function portion of the key is specified by one  of  the
         following letters:

             r   The  named  files are written on the tape.  If files
                 with the same names  already  exist,  they  are  re-
                 placed.   `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 like r, but a  file  is  re-
                 placed  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 from the tape.  At least one
                 name  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  and  mode are restored.  If no
                 file argument is given, the entire contents  of  the
                 tape are extracted.

             t   lists  the names of the specified files.  If no file
                 argument is given, the entire contents of  the  tape
                 is listed.

         The following characters may be used in addition to the let-
         ter 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 mag-
                   tape `0' is the default.

             v     Normally tp does its work silently.  The  v  (ver-

                                  - 1 -

    TP(I)                        10/15/73                       TP(I)

                   bose)  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  di-
                   rectory  is  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 en-
                   tries 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  re-
                   turn 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  re-
                   sponse means `no', and the file does not take part
                   in whatever is being done.  Response x means  `ex-
                   it';  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 be-
         fore it was dumped.

    BUGS
         A single file with several links to it is treated like  sev-
         eral files.

                                  - 2 -