tap(1) - Unix First Edition Manual Page
11/3/71TAP (I)

NAME tap -- manipulate DECtape
SYNOPSIS tap [ key ] [ name ... ]
DESCRIPTION tap saves and restores selected portions of the file systemhierarchy on DECtape. Its actions are controlled by the key

argument. The key is a string of characters containing atmost one function letter and possibly one or more function modifiers. Other arguments to the command are file ordirectory names specifying which files are to be dumped, restored, or tabled. The function portion of the key is specified by one of thefollowing letters:

r The indicated files and directories, together withall subdirectories, are dumped onto the tape. If

files with the same names already exists, they arereplaced (hence the r ). "Same" is determined by string comparison, so "./abc" can never be the sameas "/usr/dmr/abc even if "/usr/dmr" is the current directory. If no file argument is given, "/" is thedefault.

u updates the tape. u is the same as r, but a file isreplaced only if its modification date is later than

the date stored on the tape; that is to say, if ithas changed since it was dumped. u is the default command if none is given. d deletes the named files and directoriesfrom the tape. At least one file argument must be

given. x extracts the named files from the tape to the filesystem. The owner, mode, and date--modified are

restored to what they were when the file was dumped.If no file argument is given, the entire contents of the tape are extracted. t lists the names of all files stored on the tapewhich are the same as or are hierarchically below

the file arguments. If no file argument is given,the entire contents of the tape are tabled.

1 is the same as t except that an expanded listing isproduced giving all the available information about

the listed files. The following characters may be used in addition to theletter which selects the function desired.

11/3/71TAP (I)

0, ..., 7 This modifier selects the drive on which thetape is mounted. "0" is the default.

v Normally tap does its work silently. The v (verbose)option causes it to type the name of each file it

treats preceded by a letter to indicate what ishappening.

r file is being replaceda file is being added (not there before) x file is being extractedd file is being deleted

The v option can be used with r, u, d, and x only. c means a fresh dump is being created; thetape directory will be zeroed before beginning.

Usable only with r and u. f causes new entries copied on tape to be `fake' inthat only the entries, not the data associated with

the entries are updated. Such fake entries cannot beextracted. Usable only with r' and u.

w causes tap to pause before treating eachfile, type the indicative letter and the

file name (as with v) await the user's response.Response "y" means "yes", so the file is treated. Null response means "no" , and the file does nottake part in whatever is being done. Response "x" means exit ; the tap command terminates immediately.In the x function, files previously asked about have been extracted already. With r, u and d no changehas been made to the tape.

m make (create) directories during an x if necessary.

i ignore tape errors. It is suggested that this optionbe used with caution to read

damaged tapes.
FILES /dev/tap0 ... /dev/tap7
DIAGNOSTICS RK open errorRK read error

RK write errorDirectory checksum

Directory overflow

11/3/71TAP (I)

RK overflow Phase error (a file has changed after it was selected fordumping but before it was dumped)

BUGS All references to "RK" should read "tape." The m optiondoes not work correctly in all cases. The i option is not

yet implemented.