| 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 selected portions of the file system |
| 10 | hierarchy on DECtape or mag tape. |
| 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 | .s3 |
| 21 | The function portion of |
| 22 | the key is specified by one of the following letters: |
| 23 | .s3 |
| 24 | .lp +8 4 |
| 25 | \fBr\fR The indicated files and directories, together with |
| 26 | all subdirectories, are dumped |
| 27 | onto the tape. |
| 28 | If files with the same names |
| 29 | already exist, they are replaced. |
| 30 | `Same' is determined by string comparison, so |
| 31 | `./abc' can never be the same as `/usr/dmr/abc' even |
| 32 | if `/usr/dmr' is the current directory. |
| 33 | If no file argument is given, `\fB.\fR' is the default. |
| 34 | .s3 |
| 35 | .lp +8 4 |
| 36 | \fBu\fR updates the tape. |
| 37 | .bd u |
| 38 | is the same as |
| 39 | .bd r, |
| 40 | but a file is replaced only if its |
| 41 | modification date is later than the date stored on the tape; |
| 42 | that is to say, if it has changed since it was dumped. |
| 43 | .bd u |
| 44 | is the default command if none is given. |
| 45 | .s3 |
| 46 | .lp +8 4 |
| 47 | \fBd\fR deletes the named files and directories from |
| 48 | the tape. At least one file argument must be given. |
| 49 | This function is not permitted on magtapes. |
| 50 | .s3 |
| 51 | .lp +8 4 |
| 52 | \fBx\fR extracts the named files from the tape to the file system. |
| 53 | The owner, mode, and date-modified are restored to what they |
| 54 | were when the file was dumped. |
| 55 | If no file argument is given, the entire contents of the |
| 56 | tape are extracted. |
| 57 | .s3 |
| 58 | .lp +8 4 |
| 59 | \fBt\fR lists the names of all files stored on the tape which |
| 60 | are the same as or are hierarchically below |
| 61 | the file arguments. If no file argument is given, |
| 62 | the entire contents of the tape is listed. |
| 63 | .s3 |
| 64 | .i0 |
| 65 | The following characters may be used in addition to the letter |
| 66 | which selects the function desired. |
| 67 | .s3 |
| 68 | .lp +10 6 |
| 69 | \fBm\fR Specifies magtape as opposed to DECtape. |
| 70 | .s3 |
| 71 | .lp +10 6 |
| 72 | \fB0,...,7\fR This |
| 73 | modifier selects the drive on which the tape is mounted. |
| 74 | For DECtape, `x' is default; for magtape |
| 75 | `0' is the default. |
| 76 | .s3 |
| 77 | .lp +10 6 |
| 78 | \fBv\fR Normally |
| 79 | .it tp |
| 80 | does its work silently. The |
| 81 | .bd v |
| 82 | (verbose) |
| 83 | option causes it to type the name of each file it treats |
| 84 | preceded by the function letter. |
| 85 | With the |
| 86 | .bd t |
| 87 | function, |
| 88 | .bd v |
| 89 | gives more information about the |
| 90 | tape entries than just the name. |
| 91 | .s3 |
| 92 | .lp +10 6 |
| 93 | \fBc\fR means a fresh dump is being created; the tape directory |
| 94 | will be zeroed before beginning. Usable only with |
| 95 | .bd r |
| 96 | and |
| 97 | .bd u. |
| 98 | This option is assumed with magtape since |
| 99 | it is impossible to selectively overwrite |
| 100 | magtape. |
| 101 | .s3 |
| 102 | .lp +10 6 |
| 103 | \fBf\fR causes new entries on tape to be `fake' in that |
| 104 | no data is present for these entries. |
| 105 | Such fake entries cannot be extracted. |
| 106 | Usable only with |
| 107 | .bd r |
| 108 | and |
| 109 | .bd u. |
| 110 | .s3 |
| 111 | .lp +10 6 |
| 112 | \fBi\fR Errors reading and writing the |
| 113 | tape are noted, but no action is taken. |
| 114 | Normally, errors cause a return to the command level. |
| 115 | .s3 |
| 116 | .lp +10 6 |
| 117 | \fBw\fR causes |
| 118 | .it tp |
| 119 | to pause before treating each file, type |
| 120 | the indicative letter and the file name (as with v) |
| 121 | and await the user's response. Response |
| 122 | .bd y |
| 123 | means `yes', so the file is treated. Null response |
| 124 | means `no', and the file does not take part |
| 125 | in whatever is being done. Response |
| 126 | .bd x |
| 127 | means `exit'; |
| 128 | the |
| 129 | .it tp |
| 130 | command terminates immediately. In the |
| 131 | .bd x |
| 132 | function, |
| 133 | files previously asked about |
| 134 | have been extracted already. |
| 135 | With |
| 136 | .bd "r, u," |
| 137 | and |
| 138 | .bd d |
| 139 | no change has been made to the tape. |
| 140 | .s3 |
| 141 | .i0 |
| 142 | .sh FILES |
| 143 | /dev/tap? |
| 144 | .br |
| 145 | /dev/mt? |
| 146 | .sh DIAGNOSTICS |
| 147 | Several; the non-obvious one is |
| 148 | `Phase error', which means the file changed after it was selected for |
| 149 | dumping but before it was dumped. |
| 150 | .sh BUGS |