Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tp(1) [bsd man page]

TP(1)							      General Commands Manual							     TP(1)

tp - manipulate tape archive SYNOPSIS
tp [ key ] [ name ... ] DESCRIPTION
Tp saves and restores files on DECtape or magtape. Its actions are controlled by the key argument. The key is a string of characters con- taining 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 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 replaced. `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 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. 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 letter which selects the function desired. m Specifies magtape as opposed to DECtape. 0,...,7 This modifier selects the drive on which the tape is mounted. For DECtape, x is default; for magtape `0' is the default. v Normally tp does its work silently. The v (verbose) 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 directory is cleared before beginning. Usable only with r and u. This option is assumed with magtape since it is impossible to selectively overwrite magtape. i Errors reading and writing the tape are noted, but no action is taken. Normally, errors cause a return to the command level. f Use the first named file, rather than a tape, as the archive. This option currently acts like m; i.e. r implies c, and neither d nor u are permitted. 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 response means `no', and the file does not take part in whatever is being done. Response x means `exit'; 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/rmt? SEE ALSO
ar(1), tar(1) DIAGNOSTICS
Several; the non-obvious one is `Phase error', which means the file changed after it was selected for dumping but before it was dumped. BUGS
A single file with several links to it is treated like several files. Binary-coded control information makes magnetic tapes written by tp difficult to carry to other machines; tar(1) avoids the problem. 7th Edition April 29, 1985 TP(1)

Check Out this Related Man Page

RESTOR(1M)																RESTOR(1M)

restor - incremental file system restore SYNOPSIS
restor key [ argument ... ] DESCRIPTION
Restor is used to read magtapes dumped with the dump command. The key specifies what is to be done. Key is one of the characters rRxt optionally combined with f. f Use the first argument as the name of the tape instead of the default. r or R The tape is read and loaded into the file system specified in argument. This should not be done lightly (see below). If the key is R restor asks which tape of a multi volume set to start on. This allows restor to be interrupted and then restarted (an icheck -s must be done before restart). x Each file on the tape named by an argument is extracted. The file name has all `mount' prefixes removed; for example, /usr/bin/lpr is named /bin/lpr on the tape. The file extracted is placed in a file with a numeric name supplied by restor (actually the inode number). In order to keep the amount of tape read to a minimum, the following procedure is recommended: Mount volume 1 of the set of dump tapes. Type the restor command. Restor will announce whether or not it found the files, give the number it will name the file, and rewind the tape. It then asks you to `mount the desired tape volume'. Type the number of the volume you choose. On a multivolume dump the recom- mended procedure is to mount the last through the first volume in that order. Restor checks to see if any of the files requested are on the mounted tape (or a later tape, thus the reverse order) and doesn't read through the tape if no files are. If you are working with a single volume dump or the number of files being restored is large, respond to the query with `1' and restor will read the tapes in sequential order. If you have a hierarchy to restore you can use dumpdir(1) to produce the list of names and a shell script to move the resulting files to their homes. t Print the date the tape was written and the date the filesystem was dumped from. The r option should only be used to restore a complete dump tape onto a clear file system or to restore an incremental dump tape onto this. Thus /etc/mkfs /dev/rp0 40600 restor r /dev/rp0 is a typical sequence to restore a complete dump. Another restor can be done to get an incremental dump in on top of this. A dump followed by a mkfs and a restor is used to change the size of a file system. FILES
default tape unit varies with installation rst* SEE ALSO
dump(1), mkfs(1), dumpdir(1) DIAGNOSTICS
There are various diagnostics involved with reading the tape and writing the disk. There are also diagnostics if the i-list or the free list of the file system is not large enough to hold the dump. If the dump extends over more than one tape, it may ask you to change tapes. Reply with a new-line when the next tape has been mounted. BUGS
There is redundant information on the tape that could be used in case of tape reading problems. Unfortunately, restor doesn't use it. RESTOR(1M)
Man Page