tp(1) tp(1)NAME tp - copies files to or from a tp archive SYNOPSIS tp d[[0...7] [i] [m] [v] [w]] [file-in-archive]... tp r[[0...7] [c] [i] [m] [v] [w]] [file-in-archive]... tp t[[0...7] [i] [m] [v] [w]] [file-in-archive]... tp u[[0...7] [c] [i] [m] [v] [w]] [file-in-archive]... tp x[[0...7] [f] [i] [m] [v] [w]] [file-in-archive]... ARGUMENTS 0...7 Selects the drive on which the tape is mounted. Normally, 0 is the default. -c Creates a fresh dump; the tape directory is cleared before beginning. This option is assumed with magnetic tape since it is impossible to selectively overwrite magnetic tape. -d Deletes the named file-in-archive from the tape. At least one name argument must be given. This function is not permitted on magnetic tapes. -f Uses the first file-in-archive rather than a tape, as the archive. This option is known to work only with the x function. file-in-archive Specifies a file that resides in the archive from which data is being read. If file-in-archive is a directory, the program refers to the files and (recursively) subdirectories of that directory. -i Notes the errors when reading and writing the tape, but no action is taken. Normally, errors cause a return to the command level. -m Specifies magnetic tape as opposed to DECtape. -r Writes a file-in-archive onto 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/sbo/abc even if /usr/sbo is the current directory. If file-in-archive is not given, . is the default. -t Lists the names of the specified file-in-archive. If January 1992 1
tp(1) tp(1)file-in-archive is not given, the entire contents of the tape is listed. -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. -v Types the name of each file it treats preceded by the function letter. Normally tp does its work silently. When used with the t function, v gives more information about the tape entries than just the name. -w Pauses before treating each file, types the indicative letter and the filename (as with v) and awaits 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. When used with the x function, files previously asked about have been extracted already. When used with the r, u, and d functions, no change has been made to the tape. -x Extracts file-in-archive from the tape to the file system. The owner and mode are restored. If file-in-archive is not given, the entire contents of the tape are extracted. DESCRIPTION tp saves and restores files within an archive, which frequently takes the form of magnetic tape media. Its actions are controlled by the key argument. The tp program is useful for importing tapes made on older systems. EXAMPLES Enter this command: tp x file1 to extract file1 from a tp formatted magnetic tape mounted on drive 0. STATUS MESSAGES AND VALUES Several; the nonobvious one is Phase error, which means the file changed after it was selected for dumping but before it was dumped. 2 January 1992
tp(1) tp(1)LIMITATIONS 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 avoids the problem. tp does not copy zero-length files to tape. FILES /bin/tp Executable file /dev/tap? Device file /dev/mt? Device file SEE ALSO ar(1), cpio(1), tar(1) dump.bsd(1M) in A/UX System Administrator's Reference January 1992 3