[unix-history] / usr / man / cat1 / tp.0



TP(1)		    UNIX Programmer's Manual		    TP(1)


N\bNA\bAM\bME\bE
     tp - manipulate tape archive

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     t\btp\bp [ key ] [ name ... ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bT_\bp saves and restores files on DECtape or magtape.  Its
     actions are controlled by the _\bk_\be_\by argument.  The key is a
     string of characters containing at most one function letter
     and possibly one or more function modifiers.  Other argu-
     ments 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\br	     The named files are written on the tape.  If files
	     with the same names already exist, they are
	     replaced.	`Same' is determined by string com-
	     parison, 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, `.\b.' is the
	     default.

     u\bu	     updates the tape.	u\bu is like r\br,\b, 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\bu is the default
	     command if none is given.

     d\bd	     deletes the named files from the tape.  At least one
	     name argument must be given.  This function is not
	     permitted on magtapes.

     x\bx	     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\bt	     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\bm	       Specifies magtape as opposed to DECtape.

     0\b0,\b,.\b..\b..\b.,\b,7\b7   This modifier selects the drive on which the tape


Printed 7/9/88		 April 29, 1985                         1


TP(1)		    UNIX Programmer's Manual		    TP(1)


	       is mounted.  For DECtape, x\bx is default; for
	       magtape `0' is the default.

     v\bv	       Normally _\bt_\bp does its work silently.  The v\bv (ver-
	       bose) option causes it to type the name of each
	       file it treats preceded by the function letter.
	       With the t\bt function, v\bv gives more information
	       about the tape entries than just the name.

     c\bc	       means a fresh dump is being created; the tape
	       directory is cleared before beginning.  Usable
	       only with r\br and u\bu.\b. This option is assumed with
	       magtape since it is impossible to selectively
	       overwrite magtape.

     i\bi	       Errors reading and writing the tape are noted, but
	       no action is taken.  Normally, errors cause a
	       return to the command level.

     f\bf	       Use the first named file, rather than a tape, as
	       the archive.  This option currently acts like m\bm;
	       _\bi._\be. r\br implies c\bc, and neither d\bd nor u\bu are permit-
	       ted.

     w\bw	       causes _\bt_\bp to pause before treating each file, type
	       the indicative letter and the file name (as with
	       v\bv) and await the user's response.  Response y\by
	       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\bx means
	       `exit'; the _\bt_\bp command terminates immediately.  In
	       the x\bx function, files previously asked about have
	       been extracted already.	With r\br,\b, u\bu,\b, and d\bd no
	       change has been made to the tape.

F\bFI\bIL\bLE\bES\bS
     /dev/tap?
     /dev/rmt?

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     ar(1), tar(1)

D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
     Several; the non-obvious one is `Phase error', which means
     the file changed after it was selected for dumping but
     before it was dumped.

B\bBU\bUG\bGS\bS
     A single file with several links to it is treated like
     several files.


Printed 7/9/88		 April 29, 1985                         2


TP(1)		    UNIX Programmer's Manual		    TP(1)


     Binary-coded control information makes magnetic tapes writ-
     ten by _\bt_\bp difficult to carry to other machines; _\bt_\ba_\br(1)
     avoids the problem.


Printed 7/9/88		 April 29, 1985                         3
Commit	Line	Data
362b077f C	1
	2
	3
	4	TP(1) UNIX Programmer's Manual TP(1)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	tp - manipulate tape archive
	10
	11	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	12	t\btp\bp [ key ] [ name ... ]
	13
	14	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	15	_\bT_\bp saves and restores files on DECtape or magtape. Its
	16	actions are controlled by the _\bk_\be_\by argument. The key is a
	17	string of characters containing at most one function letter
	18	and possibly one or more function modifiers. Other argu-
	19	ments to the command are file or directory names specifying
	20	which files are to be dumped, restored, or listed. In all
	21	cases, appearance of a directory name refers to the files
	22	and (recursively) subdirectories of that directory.
	23
	24	The function portion of the key is specified by one of the
	25	following letters:
	26
	27	r\br The named files are written on the tape. If files
	28	with the same names already exist, they are
	29	replaced. `Same' is determined by string com-
	30	parison, so `./abc' can never be the same as
	31	`/usr/dmr/abc' even if `/usr/dmr' is the current
	32	directory. If no file argument is given, `.\b.' is the
	33	default.
	34
	35	u\bu updates the tape. u\bu is like r\br,\b, but a file is
	36	replaced only if its modification date is later than
	37	the date stored on the tape; that is to say, if it
	38	has changed since it was dumped. u\bu is the default
	39	command if none is given.
	40
	41	d\bd deletes the named files from the tape. At least one
	42	name argument must be given. This function is not
	43	permitted on magtapes.
	44
	45	x\bx extracts the named files from the tape to the file
	46	system. The owner and mode are restored. If no
	47	file argument is given, the entire contents of the
	48	tape are extracted.
	49
	50	t\bt lists the names of the specified files. If no file
	51	argument is given, the entire contents of the tape
	52	is listed.
	53
	54	The following characters may be used in addition to the
	55	letter which selects the function desired.
	56
	57	m\bm Specifies magtape as opposed to DECtape.
	58
	59	0\b0,\b,.\b..\b..\b.,\b,7\b7 This modifier selects the drive on which the tape
	60
	61
	62
	63	Printed 7/9/88 April 29, 1985 1
	64
65
66
67
68
69
70	TP(1) UNIX Programmer's Manual TP(1)
71
72
73
74	is mounted. For DECtape, x\bx is default; for
75	magtape `0' is the default.
76
77	v\bv Normally _\bt_\bp does its work silently. The v\bv (ver-
78	bose) option causes it to type the name of each
79	file it treats preceded by the function letter.
80	With the t\bt function, v\bv gives more information
81	about the tape entries than just the name.
82
83	c\bc means a fresh dump is being created; the tape
84	directory is cleared before beginning. Usable
85	only with r\br and u\bu.\b. This option is assumed with
86	magtape since it is impossible to selectively
87	overwrite magtape.
88
89	i\bi Errors reading and writing the tape are noted, but
90	no action is taken. Normally, errors cause a
91	return to the command level.
92
93	f\bf Use the first named file, rather than a tape, as
94	the archive. This option currently acts like m\bm;
95	_\bi._\be. r\br implies c\bc, and neither d\bd nor u\bu are permit-
96	ted.
97
98	w\bw causes _\bt_\bp to pause before treating each file, type
99	the indicative letter and the file name (as with
100	v\bv) and await the user's response. Response y\by
101	means `yes', so the file is treated. Null
102	response means `no', and the file does not take
103	part in whatever is being done. Response x\bx means
104	`exit'; the _\bt_\bp command terminates immediately. In
105	the x\bx function, files previously asked about have
106	been extracted already. With r\br,\b, u\bu,\b, and d\bd no
107	change has been made to the tape.
108
109	F\bFI\bIL\bLE\bES\bS
110	/dev/tap?
111	/dev/rmt?
112
113	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
114	ar(1), tar(1)
115
116	D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
117	Several; the non-obvious one is `Phase error', which means
118	the file changed after it was selected for dumping but
119	before it was dumped.
120
121	B\bBU\bUG\bGS\bS
122	A single file with several links to it is treated like
123	several files.
124
125
126
127
128
129	Printed 7/9/88 April 29, 1985 2
130
131
132
133
134
135
136	TP(1) UNIX Programmer's Manual TP(1)
137
138
139
140	Binary-coded control information makes magnetic tapes writ-
141	ten by _\bt_\bp difficult to carry to other machines; _\bt_\ba_\br(1)
142	avoids the problem.
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195	Printed 7/9/88 April 29, 1985 3
196
197
198