Fetching contributors…
Cannot retrieve contributors at this time
290 lines (289 sloc) 7.62 KB
.\" DO NOT MODIFY THIS FILE! It was generated by helptoman 0.0.
.TH tar (Free paxutils) 1 "October 1998" "tar (Free paxutils) 2.4f" "GNU User's Manual"
tar (Free paxutils) \- short documentation for tar (Free paxutils) 2.4f
.B tar (Free paxutils)
.RI [FILE]...
The `tar' tool saves many files together into a single tape or disk archive,
and is able to restore individual files from the archive.
If a long option shows an argument as mandatory, then it is mandatory
for the equivalent short option also. Similarly for optional arguments.
.SS "Main operation mode:"
\fB\-t\fR, \fB\-\-list\fR
list the contents of an archive
\fB\-x\fR, \fB\-\-extract\fR, \fB\-\-get\fR
extract files from an archive
\fB\-c\fR, \fB\-\-create\fR
create a new archive
\fB\-d\fR, \fB\-\-diff\fR, \fB\-\-compare\fR
find differences between archive and file system
\fB\-r\fR, \fB\-\-append\fR
append files to the end of an archive
\fB\-A\fR, \fB\-\-catenate\fR
append tar files to an archive
same as \fB\-A\fR
delete from the archive (not on mag tapes!)
.SS "Operation modifiers:"
\fB\-W\fR, \fB\-\-verify\fR
attempt to verify the archive after writing it
remove files after adding them to the archive
\fB\-k\fR, \fB\-\-keep\-old\-files\fR
don't overwrite existing files when extracting
\fB\-u\fR, \fB\-\-update\fR
replace entries or extract files only if newer
\fB\-U\fR, \fB\-\-unlink\-first\fR
remove each file prior to extracting over it
empty hierarchies prior to extracting directory
\fB\-S\fR, \fB\-\-sparse\fR
handle sparse files efficiently
\fB\-O\fR, \fB\-\-to\-stdout\fR
extract files to standard output
\fB\-G\fR, \fB\-\-incremental\fR
handle old GNU-format incremental backup
\fB\-g\fR, \fB\-\-listed\-incremental\fR
handle new GNU-format incremental backup
prepend PREFIX to each name in create archive
do not exit with nonzero on unreadable files
.SS "Handling of file attributes:"
force NAME as owner for added files
force NAME as group for added files
force (symbolic) mode CHANGES for added files
don't change access times on dumped files
\fB\-m\fR, \fB\-\-modification\-time\fR
don't extract file modified time
try extracting files with the same ownership
always use numbers for user/group names
\fB\-p\fR, \fB\-\-same\-permissions\fR
extract all protection information
same as \fB\-p\fR
\fB\-s\fR, \fB\-\-same\-order\fR
sort names to extract to match archive
same as \fB\-s\fR
do not restore any file attribute
same as both \fB\-p\fR and \fB\-s\fR
.SS "Device selection and switching:"
\fB\-f\fR, \fB\-\-file\fR=\fIARCHIVE\fR
use archive file or device ARCHIVE
archive file is local even if has a colon
use remote COMMAND instead of rsh
specify drive and density
\fB\-M\fR, \fB\-\-multi\-volume\fR
create/list/extract multi-volume archive
\fB\-L\fR, \fB\-\-tape\-length\fR=\fINUM\fR
change tape after writing NUM x 1024 bytes
\fB\-F\fR, \fB\-\-info\-script\fR=\fIFILE\fR
run script at end of each tape (implies \fB\-M\fR)
same as \fB\-F\fR FILE
use/update the volume number in FILE
.SS "Device blocking:"
\fB\-b\fR, \fB\-\-blocking\-factor\fR=\fIBLOCKS\fR
BLOCKS x 512 bytes per record
SIZE bytes per record, multiple of 512
\fB\-i\fR, \fB\-\-ignore\-zeros\fR
ignore zeroed blocks in archive (means EOF)
\fB\-B\fR, \fB\-\-read\-full\-records\fR
reblock as we read (for 4.2BSD pipes)
.SS "Archive format selection:"
\fB\-V\fR, \fB\-\-label\fR=\fINAME\fR
create archive with volume name NAME
at list/extract time, a globbing PATTERN
\fB\-o\fR, \fB\-\-old\-archive\fR, \fB\-\-portability\fR
write a V7 format archive
write a POSIX conformant archive
\fB\-z\fR, \fB\-\-gzip\fR
filter the archive through gzip
\fB\-Z\fR, \fB\-\-compress\fR
filter the archive through compress
filter through PROG (must accept \fB\-d\fR)
.SS "Local file selection:"
\fB\-C\fR, \fB\-\-directory\fR=\fIDIR\fR
change to directory DIR
\fB\-T\fR, \fB\-\-files\-from\fR=\fINAME\fR
get names to extract or create from file NAME
\fB\-T\fR reads null-terminated names, disable \fB\-C\fR
exclude files, given as a globbing PATTERN
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
exclude globbing patterns listed in FILE
\fB\-P\fR, \fB\-\-absolute\-names\fR
don't strip leading `/'s from file names
\fB\-h\fR, \fB\-\-dereference\fR
dump instead the files symlinks point to
avoid descending automatically in directories
\fB\-l\fR, \fB\-\-one\-file\-system\fR
stay in local file system when creating archive
\fB\-K\fR, \fB\-\-starting\-file\fR=\fINAME\fR
begin at file NAME in the archive
\fB\-N\fR, \fB\-\-newer\fR=\fIDATE\fR
only store files newer than DATE
compare date and time when data changed only
same as \fB\-N\fR
backup before removal, choose version control
backup before removal, override usual suffix
.SS "Informative output:"
print this help, then exit
print tar program version number, then exit
\fB\-v\fR, \fB\-\-verbose\fR
verbosely list files processed
write a progress dot every ten records
print directory names while reading the archive
print total bytes written while creating archive
\fB\-R\fR, \fB\-\-block\-number\fR
insert archive block number within each message
\fB\-w\fR, \fB\-\-interactive\fR
ask for confirmation for every action
same as \fB\-w\fR
The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
The version control may be set with \fB\-\-backup\fR or VERSION_CONTROL, values are:
t, numbered
make numbered backups
nil, existing
numbered if numbered backups exist, simple otherwise
never, simple
always make simple backups
This `tar' cannot produce `--posix' archives. Also, if POSIXLY_CORRECT
is set in the environment, extensions are disallowed with `--posix'.
Support for POSIX is only partially implemented, don't depend on it yet.
ARCHIVE may be FILE, HOST:FILE or USER@HOST:FILE; and FILE may be a file
or a device. *This* `tar' defaults to `-f- \fB\-b20\fR'.
Report bugs to <>.
The full documentation for
.B tar (Free paxutils)
is maintained as a Texinfo manual. If the
.B info
.B tar (Free paxutils)
programs are properly installed at your site, the command
.B info tar (Free paxutils)
should allow you to access the manual as an hypertext.
Copyright (C) 1988, 92, 93, 94, 95, 96, 97 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
Written by John Gilmore and Jay Fenlason.