View Source: tar(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
TAR
!!!TAR
NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
FUNCTION LETTERS
OTHER OPTIONS
BUGS
----
!!NAME


tar - The GNU version of the tar archiving utility
!!SYNOPSIS


__tar__ [[ __-__ ] __A --catenate --concatenate | c
--create | d --diff --compare | r --append | t --list | u
--update | x -extract --get__ [[ __--atime-preserve__ ]
[[ __-b, --block-size N__ ] [[ __-B,
--read-full-blocks__ ] [[ __-C, --directory DIR__ ] [[
__--checkpoint__ ] [[ __-f, --file [[HOSTNAME:]F__ ] [[
__--force-local__ ] [[ __-F, --info-script F
--new-volume-script F__ ] [[ __-G, --incremental__ ] [[
__-g, --listed-incremental F__ ] [[ __-h,
--dereference__ ] [[ __-i, --ignore-zeros__ ] [[ __-j,
--bzip2__ ] [[ __--ignore-failed-read__ ] [[ __-k,
--keep-old-files__ ] [[ __-K, --starting-file F__ ] [[
__-l, --one-file-system__ ] [[ __-L, --tape-length N__
] [[ __-m, --modification-time__ ] [[ __-M,
--multi-volume__ ] [[ __-N, --after-date DATE, --newer
DATE__ ] [[ __-o, --old-archive, --portability__ ] [[
__-O, --to-stdout__ ] [[ __-p, --same-permissions,
--preserve-permissions__ ] [[ __-P, --absolute-names__ ]
[[ __--preserve__ ] [[ __-R, --record-number__ ] [[
__--remove-files__ ] [[ __-s, --same-order,
--preserve-order__ ] [[ __--same-owner__ ] [[
__--numeric-owner__ ] [[ __-S, --sparse__ ] [[ __-T,
--files-from F__ ] [[ __--null__ ] [[ __--totals__ ] [[
__-v, --verbose__ ] [[ __-V, --label NAME__ ] [[
__--version__ ] [[ __-w, --interactive,
--confirmation__ ] [[ __-W, --verify__ ] [[
__--exclude=FILE__ ] [[ __-X, --exclude-from FILE__ ] [[
__-Z, --compress, --uncompress__ ] [[ __-z, --gzip,
--ungzip__ ] [[ __--use-compress-program PROG__ ] [[
__--block-compress__ ] [[ __--rsh-command=CMD__ ] [[
__-[[0-7][[lmh]__ ]


''filename1 [[ filename2, ... filenameN ]''


''directory1 [[ directory2, ...directoryN ]''
!!DESCRIPTION


This manual page documents the GNU version of __tar__ ,
an archiving program designed to store and extract files
from an archive file known as a ''tarfile.'' A
''tarfile'' may be made on a tape drive, however, it is
also common to write a ''tarfile'' to a normal file. The
first argument to __tar__ must be one of the options:
__Acdrtux__, followed by any optional functions. The
final arguments to __tar__ are the names of the files or
directories which should be archived. The use of a directory
name always implies that the subdirectories below should be
included in the archive.
!!EXAMPLES


__tar -xvvf foo.tar__


extract foo.tar


__tar -xvvzf foo.tar.gz__


extract gzipped foo.tar.gz


__tar -cvvf foo.tar foo/__


tar contents of folder foo in foo.tar
!!FUNCTION LETTERS


__One of the following options must be
used:__


__-A, --catenate, --concatenate__


append tar files to an archive


__-c, --create__


create a new archive


__-d, --diff, --compare__


find differences between archive and file
system


__--delete__


delete from the archive (not for use on mag
tapes!)


__-r, --append__


append files to the end of an archive


__-t, --list__


list the contents of an archive


__-u, --update__


only append files that are newer than copy in
archive


__-x, --extract, --get__


extract files from an archive
!!OTHER OPTIONS


__--atime-preserve__


don't change access times on dumped files


__-b, --block-size N__


block size of Nx512 bytes (default N=20)


__-B, --read-full-blocks__


reblock as we read (for reading 4.2BSD pipes)


__-C, --directory DIR__


change to directory DIR


__--checkpoint__


print directory names while reading the archive


__-f, --file [[HOSTNAME:]F__


use archive file or device F (default


__--force-local__


archive file is local even if has a colon


__-F, --info-script F --new-volume-script
F__


run script at end of each tape (implies -M)


__-G, --incremental__


create/list/extract old GNU-format incremental
backup


__-g, --listed-incremental F__


create/list/extract new GNU-format incremental
backup


__-h, --dereference__


don't dump symlinks; dump the files they point
to


__-i, --ignore-zeros__


ignore blocks of zeros in archive (normally mean
EOF)


__-j, --bzip2__


filter archive through bzip2, use to decompress .bz2
files


__--ignore-failed-read__


don't exit with non-zero status on unreadable
files


__-k, --keep-old-files__


keep existing files; don't overwrite them from
archive


__-K, --starting-file F__


begin at file F in the archive


__-l, --one-file-system__


stay in local file system when creating an
archive


__-L, --tape-length N__


change tapes after writing N*1024 bytes


__-m, --modification-time__


don't extract file modified time


__-M, --multi-volume__


create/list/extract multi-volume archive


__-N, --after-date DATE, --newer DATE__


only store files newer than DATE


__-o, --old-archive, --portability__


write a V7 format archive, rather than ANSI
format


__-O, --to-stdout__


extract files to standard output


__-p, --same-permissions,
--preserve-permissions__


extract all protection information


__-P, --absolute-paths__


don't strip leading `/'s from file names


__--preserve__


like -p -s


__-R, --record-number__


show record number within archive with each
message


__--remove-files__


remove files after adding them to the archive


__-s, --same-order, --preserve-order__


list of names to extract is sorted to match
archive


__--same-owner__


create extracted files with the same ownership


__--numeric-owner__


always use numbers for user/group names


__-S, --sparse__


handle sparse files efficiently


__-T, --files-from F__


get names to extract or create from file F


__--null__


-T reads null-terminated names, disable -C


__--totals__


print total bytes written with --create


__-v, --verbose__


verbosely list files processed


__-V, --label NAME__


create archive with volume name NAME


__--version__


print tar program version number


__-w, --interactive, --confirmation__


ask for confirmation for every action


__-W, --verify__


attempt to verify the archive after writing it


__--exclude=FILE__


exclude file FILE


__-X, --exclude-from FILE__


exclude files listed in FILE


__-Z, --compress, --uncompress__


filter the archive through compress


__-z, --gzip, --ungzip__


filter the archive through gzip


__--use-compress-program PROG__


filter the archive through PROG (which must accept
-d)


__--block-compress__


block the output of compression program for
tapes


__--rsh-command=CMD__


Use remote COMMAND instead of `rsh'. This option exists so
that people who use something other than the standard `rsh'
(e.g., a Kerberized `rsh') can access a remote
device.


__-[[0-7][[lmh]__


specify drive and density
!!BUGS


The GNU folks, in general, abhor man pages, and create info
documents instead. The maintainer of tar falls into this
category. This man page is neither complete, nor current,
and was included in the Debian Linux packaging of tar
entirely to reduce the frequency with which the lack of a
man page gets reported as a bug in our defect tracking
system.


If you really want to understand tar, then you should run
info and read the tar info pages, or use the info mode in
emacs.
----
23 pages link to tar(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Monday, June 3, 2002 6:51:13 pm by "perry"
Edit PageHistory Diff Info LikePages