1 --- tar-1.13.25.orig/debian/tar.1
2 +++ tar-1.13.25/debian/tar.1
4 +.\" @(#)tar.1 1.11.1 93/19/22 PJV;
5 +.TH TAR 1 "22 September 1993"
7 +tar \- The GNU version of the tar archiving utility
13 +.B A --catenate --concatenate \||\| c --create \||\| d --diff --compare \||\| r --append \||\| t --list \||\| u --update \||\| x -extract --get
18 +.B -b, --block-size N
21 +.B -B, --read-full-blocks
24 +.B -C, --directory DIR
30 +.B -f, --file [HOSTNAME:]F
36 +.B -F, --info-script F --new-volume-script F
42 +.B -g, --listed-incremental F
48 +.B -i, --ignore-zeros
54 +.B --ignore-failed-read
57 +.B -k, --keep-old-files
60 +.B -K, --starting-file F
63 +.B -l, --one-file-system
66 +.B -L, --tape-length N
69 +.B -m, --modification-time
72 +.B -M, --multi-volume
75 +.B -N, --after-date DATE, --newer DATE
78 +.B -o, --old-archive, --portability
84 +.B -p, --same-permissions, --preserve-permissions
87 +.B -P, --absolute-names
93 +.B -R, --record-number
99 +.B -s, --same-order, --preserve-order
111 +.B -T, --files-from F
129 +.B -w, --interactive, --confirmation
138 +.B -X, --exclude-from FILE
141 +.B -Z, --compress, --uncompress
144 +.B -z, --gzip, --ungzip
147 +.B --use-compress-program PROG
153 +.B --rsh-command=CMD
159 +.I filename1 [ filename2, ... filenameN ]
161 +.I directory1 [ directory2, ...directoryN ]
164 +This manual page documents the GNU version of
166 +, an archiving program designed to store and extract files from
167 +an archive file known as a
171 +may be made on a tape drive, however, it is also common
175 +The first argument to
177 +must be one of the options:
179 +followed by any optional functions.
180 +The final arguments to
182 +are the names of the files or directories which should be archived. The use
183 +of a directory name always implies that the subdirectories below should be
184 +included in the archive.
187 +.B tar -xvvf foo.tar
190 +.B tar -xvvzf foo.tar.gz
191 +extract gzipped foo.tar.gz
193 +.B tar -cvvf foo.tar foo/
194 +tar contents of folder foo in foo.tar
195 +.SH "FUNCTION LETTERS"
197 +.B One of the following options must be used:
199 +.B -A, --catenate, --concatenate
200 +append tar files to an archive
203 +create a new archive
205 +.B -d, --diff, --compare
206 +find differences between archive and file system
209 +delete from the archive (not for use on mag tapes!)
212 +append files to the end of an archive
215 +list the contents of an archive
218 +only append files that are newer than copy in archive
220 +.B -x, --extract, --get
221 +extract files from an archive
225 +don't change access times on dumped files
227 +.B -b, --block-size N
228 +block size of Nx512 bytes (default N=20)
230 +.B -B, --read-full-blocks
231 +reblock as we read (for reading 4.2BSD pipes)
233 +.B -C, --directory DIR
234 +change to directory DIR
237 +print directory names while reading the archive
239 +.B -f, --file [HOSTNAME:]F
240 +use archive file or device F (default "-", meaning stdin/stdout)
243 +archive file is local even if has a colon
245 +.B -F, --info-script F --new-volume-script F
246 +run script at end of each tape (implies -M)
248 +.B -G, --incremental
249 +create/list/extract old GNU-format incremental backup
251 +.B -g, --listed-incremental F
252 +create/list/extract new GNU-format incremental backup
254 +.B -h, --dereference
255 +don't dump symlinks; dump the files they point to
257 +.B -i, --ignore-zeros
258 +ignore blocks of zeros in archive (normally mean EOF)
261 +filter archive through bzip2, use to decompress .bz2 files
263 +.B --ignore-failed-read
264 +don't exit with non-zero status on unreadable files
266 +.B -k, --keep-old-files
267 +keep existing files; don't overwrite them from archive
269 +.B -K, --starting-file F
270 +begin at file F in the archive
272 +.B -l, --one-file-system
273 +stay in local file system when creating an archive
275 +.B -L, --tape-length N
276 +change tapes after writing N*1024 bytes
278 +.B -m, --modification-time
279 +don't extract file modified time
281 +.B -M, --multi-volume
282 +create/list/extract multi-volume archive
284 +.B -N, --after-date DATE, --newer DATE
285 +only store files newer than DATE
287 +.B -o, --old-archive, --portability
288 +write a V7 format archive, rather than ANSI format
291 +extract files to standard output
293 +.B -p, --same-permissions, --preserve-permissions
294 +extract all protection information
296 +.B -P, --absolute-paths
297 +don't strip leading `/'s from file names
302 +.B -R, --record-number
303 +show record number within archive with each message
306 +remove files after adding them to the archive
308 +.B -s, --same-order, --preserve-order
309 +list of names to extract is sorted to match archive
312 +create extracted files with the same ownership
315 +always use numbers for user/group names
318 +handle sparse files efficiently
320 +.B -T, --files-from F
321 +get names to extract or create from file F
324 +-T reads null-terminated names, disable -C
327 +print total bytes written with --create
330 +verbosely list files processed
333 +create archive with volume name NAME
336 +print tar program version number
338 +.B -w, --interactive, --confirmation
339 +ask for confirmation for every action
342 +attempt to verify the archive after writing it
347 +.B -X, --exclude-from FILE
348 +exclude files listed in FILE
350 +.B -Z, --compress, --uncompress
351 +filter the archive through compress
353 +.B -z, --gzip, --ungzip
354 +filter the archive through gzip
356 +.B --use-compress-program PROG
357 +filter the archive through PROG (which must accept -d)
360 +block the output of compression program for tapes
362 +.B --rsh-command=CMD
363 +Use remote COMMAND instead of `rsh'. This option exists so that
364 +people who use something other than the standard `rsh' (e.g., a
365 +Kerberized `rsh') can access a remote device.
368 +specify drive and density
371 +The GNU folks, in general, abhor man pages, and create info documents instead.
372 +The maintainer of tar falls into this category. This man page is neither
373 +complete, nor current, and was included in the Debian Linux packaging of tar
374 +entirely to reduce the frequency with which the lack of a man page gets
375 +reported as a bug in our defect tracking system.
377 +If you really want to understand tar, then you should run info and read the
378 +tar info pages, or use the info mode in emacs.