1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
.TH TAR 1
.CT 1 comm_dev
.SH NAME
tar \- tape archiver
.SH SYNOPSIS
.B tar
.I key
[
.I file ...
]
.SH DESCRIPTION
.PP
.I Tar
saves and restores files, normally on magnetic
on tape.
The
.I key
is a string that contains
at most one function letter plus optional modifiers.
Other arguments to the command are names of
files or directories to be dumped or restored.
A directory name implies all the contained
files and subdirectories (recursively).
.PP
The function is one of the following letters:
.TP
.B r
The named files
are written
on the end of the tape.
.TP
.B x
Extract the named files from the tape.
If a file is a directory, the directory is extracted recursively.
Owners and modes are restored if possible.
If no file argument is given, extract the entire tape.
If the tape contains multiple entries for a file,
the latest one wins.
.TP
.B t
List all occurrences of each
.I file
on tape, or of all files if there are no
.I file
arguments.
.TP
.B u
Add the named files if they
are not on the tape or are newer than the tape version.
.TP
.B c
Create a new tape; writing begins at the beginning
of the tape instead of after the last file.
.TP
.B o
Omit owner and modes
of directories, for compatibility with
old versions of
.I tar.
.TP
.B p
Restore files to their original modes,
ignoring the present
.IR umask (2).
Setuid and sticky information
will be restored when
.IR tar
is executed by the super-user.
.PP
The modifiers are:
.TP
.BR 0 ,..., 7
Select a tape drive.
The default is
.BR 1 .
Incompatible with modifier
.BR f .
.TP
.B v
(verbose)
Print the name of each file treated
preceded by the function letter.
With
.BR t ,
give more details about the
tape entries.
.TP
.B w
Print the action to be taken followed by file name, then
wait for user confirmation.
If the answer begins with
.LR y ,
the action is performed.
Any other input means
don't do it.
.TP
.B f
Use the next argument as the name of the archive instead of
the default
.F /dev/rmt1 .
If the name of the file is
.LR - ,
tar writes to
standard output or reads from standard input, whichever is
appropriate.
.I Tar
can be used to move hierarchies thus:
.IP
.L
(cd fromdir; tar cf - .) | (cd todir; tar xf -)
.TP
.BI b
Write output in
.IR n \(mu512-byte
blocks, where
.I n
is the next argument,
default 20, maximum 40.
Useful for raw magnetic tape archives (see
.B f
above); destructive for disk archives.
.TP
.B l
Complain if links cannot be resolved.
If
.B l
is not specified, no
error messages are printed.
.TP
.B L
Write information needed to re-create symbolic links
on the tape instead of following the links.
Tapes thus written cannot be read on older versions of
.I tar .
.SH FILES
.F /dev/rmt?
.br
.F /tmp/tar*
.SH SEE ALSO
.IR cpio (1),
.IR bundle (1),
.IR mt (4)
.SH BUGS
There is no way to ask for any but the last
occurrence of a file.
.br
Tape errors are handled ungracefully.
.br
The
.B u
option can be slow, and works only with archives on disk files.
.br
File names are limited to
100 characters.
|
