home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man1 / tp.1 < prev    next >
Encoding:
Text File  |  1975-06-26  |  3.6 KB  |  159 lines
  1. .th TP I 10/15/73
  2. .sh NAME
  3. tp  \*-  manipulate DECtape and magtape
  4. .sh SYNOPSIS
  5. .bd tp
  6. [ key ] [ name ... ]
  7. .sh DESCRIPTION
  8. .it Tp
  9. saves and restores files
  10. on DECtape or magtape.
  11. Its actions are controlled by the
  12. .it key
  13. argument.
  14. The key is a string of characters containing
  15. at most one function letter and possibly
  16. one or more function modifiers.
  17. Other arguments to the command are file or directory
  18. names specifying which files are to be dumped, restored,
  19. or listed.
  20. In all cases, appearance of a directory name refers to
  21. the files and (recursively) subdirectories of that directory.
  22. .s3
  23. The function portion of
  24. the key is specified by one of the following letters:
  25. .s3
  26. .lp +8 4
  27. \fBr\fR    The named files
  28. are written
  29. on the tape.
  30. If files with the same names
  31. already exist, they are replaced.
  32. `Same' is determined by string comparison, so
  33. `./abc' can never be the same as `/usr/dmr/abc' even
  34. if `/usr/dmr' is the current directory.
  35. If no file argument is given, `\fB.\fR' is the default.
  36. .s3
  37. .lp +8 4
  38. \fBu\fR    updates the tape.
  39. .bd u
  40. is like
  41. .bd r,
  42. but a file is replaced only if its
  43. modification date is later than the date stored on the tape;
  44. that is to say, if it has changed since it was dumped.
  45. .bd u
  46. is the default command if none is given.
  47. .s3
  48. .lp +8 4
  49. \fBd\fR    deletes the named files from
  50. the tape.
  51. At least one name argument must be given.
  52. This function is not permitted on magtapes.
  53. .s3
  54. .lp +8 4
  55. \fBx\fR    extracts the named files from the tape to the file system.
  56. The owner and mode are restored.
  57. If no file argument is given, the entire contents of the
  58. tape are extracted.
  59. .s3
  60. .lp +8 4
  61. \fBt\fR    lists the names of the specified files.
  62. If no file argument is given,
  63. the entire contents of the tape is listed.
  64. .s3
  65. .i0
  66. The following characters may be used in addition to the letter
  67. which selects the function desired.
  68. .s3
  69. .lp +10 6
  70. \fBm\fR    Specifies magtape as opposed to DECtape.
  71. .s3
  72. .lp +10 6
  73. \fB0,...,7\fR    This
  74. modifier selects the drive on which the tape is mounted.
  75. For DECtape, `x' is default; for magtape
  76. `0' is the default.
  77. .s3
  78. .lp +10 6
  79. \fBv\fR    Normally
  80. .it tp
  81. does its work silently.
  82. The
  83. .bd v
  84. (verbose)
  85. option causes it to type the name of each file it treats
  86. preceded by the function letter.
  87. With the
  88. .bd t
  89. function,
  90. .bd v
  91. gives more information about the
  92. tape entries than just the name.
  93. .s3
  94. .lp +10 6
  95. \fBc\fR    means a fresh dump is being created; the tape directory
  96. is zeroed before beginning.
  97. Usable only with
  98. .bd r
  99. and
  100. .bd u.
  101. This option is assumed with magtape since
  102. it is impossible to selectively overwrite
  103. magtape.
  104. .s3
  105. .lp +10 6
  106. \fBf\fR    causes new entries on tape to be `fake' in that
  107. no data is present for these entries.
  108. Such fake entries cannot be extracted.
  109. Usable only with
  110. .bd r
  111. and
  112. .bd u.
  113. .s3
  114. .lp +10 6
  115. \fBi\fR    Errors reading and writing the
  116. tape are noted, but no action is taken.
  117. Normally, errors cause a return to the command level.
  118. .s3
  119. .lp +10 6
  120. \fBw\fR    causes
  121. .it tp
  122. to pause before treating each file, type
  123. the indicative letter and the file name (as with v)
  124. and await the user's response.
  125. Response
  126. .bd y
  127. means `yes', so the file is treated.
  128. Null response
  129. means `no', and the file does not take part
  130. in whatever is being done.
  131. Response
  132. .bd x
  133. means `exit';
  134. the
  135. .it tp
  136. command terminates immediately.
  137. In the
  138. .bd x
  139. function,
  140. files previously asked about
  141. have been extracted already.
  142. With
  143. .bd "r, u,"
  144. and
  145. .bd d
  146. no change has been made to the tape.
  147. .s3
  148. .i0
  149. .sh FILES
  150. /dev/tap?
  151. .br
  152. /dev/mt?
  153. .sh DIAGNOSTICS
  154. Several; the non-obvious one is
  155. `Phase error', which means the file changed after it was selected for
  156. dumping but before it was dumped.
  157. .sh BUGS
  158. A single file with several links to it is treated like several files.
  159.