Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tp(1) [v7 man page]

TP(1)							      General Commands Manual							     TP(1)

NAME
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 is known to work only with x. 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/mt? 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. deprecated TP(1)

Check Out this Related Man Page

ANSITAPE(LOCAL) 														   ANSITAPE(LOCAL)

NAME
ansitape - ANSI standard tape handler SYNOPSIS
ansitape [key] [keyargs] [files] DESCRIPTION
Ansitape reads and writes magnetic tapes written in ANSI standard format (called ``Files-11'' by DEC). Tapes written by ansitape are labeled with the first 6 characters of the machine name by default. Actions are controlled by the key argument. The key is a string of characters containing at most one function letter. Other arguments to the command are a tape label and file names specifying which files are to be written onto or extracted from the tape. The function portion of the key is specified by one of the following letters: r The named files are written at the end of the tape. The c function implies this. x The named files are extracted from the tape. If no file argument is given, the entire contents of the tape is extracted. Note that if the tape has duplicated file names, only the last file of a given name can be extracted. t The names of the specified files are listed each time they occur on the tape. If no file argument is given, all files on the tape are listed. c Create a new tape; writing begins at the beginning of the tape instead of after the last file. This command implies r. The following characters may be used in addition to the letter which selects the function desired. f This argument allows the selection of a different tape device. The next word in the keyargs list is taken to be the full name of a device to write the tape on. The default is /dev/rmt12. n The n option allows the user to specify as the next argument in the keyargs list, a control file containing the names of files to put on the tape. If the file name is '-', the control file will, instead, be read from standard input. The control file contains one line for each file to be placed on the tape. Each line has two names, the name of the file on the local machine, and the name it is to have when placed on the tape. This allows for more convenient flattening of hierarchies when placing them on tape. If the second name is omitted, the UNIX file name will be used on the tape also. This argument can only be used with the r and c functions. l The l option allows the user to specify the label to be placed on the tape. The next argument in the keyargs list is taken as the tape label, which will be space padded or truncated to six characters. This option is meaningless unless c is also specified. v Normally ansitape works relatively silently. The v (verbose) option causes it to type information about each file as it processes it. b The b option allows the user to select the blocksize to be used for the tape. By default, ansitape uses the maximum block size permitted by the ANSI standard, 2048. Some systems will permit a much large block size, and if large files are being put on the tape it may be advantageous to do so. Ansitape will take the next argument of the keyargs list as the blocksize for the tape. Values below 18 or above 32k will be limited to that range. The standard scale factors b=512 and k=1024 are accepted. Ansitape will not copy directories, character or block special files, symbolic links, sockets, or binary executables. Attempts to put these on tape will result in warnings, and they will be skipped completely. FILES
/dev/rmt12 DIAGNOSTICS
A warning message will be generated when a record exceeds the maximum record length and the affected file will be truncated. BUGS
Ansitape quietly truncates names longer than 17 characters. ANSI 'f' format files can be read but not written. Multivolume tapes can not be handled. 4/10/85 UCB Local ANSITAPE(LOCAL)
Man Page