Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

298 lines (297 sloc) 7.869 kb
." DO NOT MODIFY THIS FILE! It was generated by help2man 1.5.1.3.
.TH TAR 1 "June 1999" "tar (Free paxutils) 2.4i" "FSF"
.SH NAME
tar \- manual page for tar (Free paxutils) 2.4i
.SH SYNOPSIS
.B tar
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
The `tar' tool saves many files together into a single tape or disk archive,
and is able to restore individual files from the archive.
.PP
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:"
.TP
\fB\-t\fR, \fB\-\-list\fR
list the contents of an archive
.TP
\fB\-x\fR, \fB\-\-extract\fR, \fB\-\-get\fR
extract files from an archive
.TP
\fB\-c\fR, \fB\-\-create\fR
create a new archive
.TP
\fB\-d\fR, \fB\-\-diff\fR, \fB\-\-compare\fR
find differences between archive and file system
.TP
\fB\-r\fR, \fB\-\-append\fR
append files to the end of an archive
.TP
\fB\-A\fR, \fB\-\-catenate\fR
append tar files to an archive
.TP
\fB\-\-concatenate\fR
same as \fB\-A\fR
.TP
\fB\-\-delete\fR
delete from the archive (not on mag tapes!)
.SS "Operation modifiers:"
.TP
\fB\-q\fR, \fB\-\-quick\fR
assume the archive has no duplicate members
.TP
\fB\-W\fR, \fB\-\-verify\fR
attempt to verify the archive after writing it
.TP
\fB\-\-remove\-files\fR
remove files after adding them to the archive
.TP
\fB\-k\fR, \fB\-\-keep\-old\-files\fR
don't overwrite existing files when extracting
.TP
\fB\-u\fR, \fB\-\-update\fR
replace entries or extract files only if newer
.TP
\fB\-U\fR, \fB\-\-unlink\-first\fR
remove each file prior to extracting over it
.TP
\fB\-\-recursive\-unlink\fR
empty hierarchies prior to extracting directory
.TP
\fB\-S\fR, \fB\-\-sparse\fR
handle sparse files efficiently
.TP
\fB\-O\fR, \fB\-\-to\-stdout\fR
extract files to standard output
.TP
\fB\-G\fR, \fB\-\-incremental\fR
handle old GNU-format incremental backup
.TP
\fB\-g\fR, \fB\-\-listed\-incremental\fR
handle new GNU-format incremental backup
.TP
\fB\-\-name\-prefix\fR=\fIPREFIX\fR
prepend PREFIX to each name in create archive
.TP
\fB\-\-ignore\-failed\-read\fR
do not exit with nonzero on unreadable files
.SS "Handling of file attributes:"
.TP
\fB\-\-owner\fR=\fINAME\fR
force NAME as owner for added files
.TP
\fB\-\-group\fR=\fINAME\fR
force NAME as group for added files
.TP
\fB\-\-mode\fR=\fICHANGES\fR
force (symbolic) mode CHANGES for added files
.TP
\fB\-\-atime\-preserve\fR
don't change access times on dumped files
.TP
\fB\-m\fR, \fB\-\-modification\-time\fR
don't extract file modified time
.TP
\fB\-\-same\-owner\fR
try extracting files with the same ownership
.TP
\fB\-\-numeric\-owner\fR
always use numbers for user/group names
.TP
\fB\-p\fR, \fB\-\-same\-permissions\fR
extract all protection information
.TP
\fB\-\-preserve\-permissions\fR
same as \fB\-p\fR
.TP
\fB\-s\fR, \fB\-\-same\-order\fR
sort names to extract to match archive
.TP
\fB\-\-preserve\-order\fR
same as \fB\-s\fR
.TP
\fB\-\-no\-attributes\fR
do not restore any file attribute
.TP
\fB\-\-preserve\fR
same as both \fB\-p\fR and \fB\-s\fR
.SS "Device selection and switching:"
.TP
\fB\-f\fR, \fB\-\-file\fR=\fIARCHIVE\fR
use archive file or device ARCHIVE
.TP
\fB\-\-force\-local\fR
archive file is local even if has a colon
.TP
\fB\-\-rsh\-command\fR=\fICOMMAND\fR
use remote COMMAND instead of rsh
.TP
\fB\-[0\-7][lmh]\fR
specify drive and density
.TP
\fB\-M\fR, \fB\-\-multi\-volume\fR
create/list/extract multi-volume archive
.TP
\fB\-L\fR, \fB\-\-tape\-length\fR=\fINUM\fR
change tape after writing NUM x 1024 bytes
.TP
\fB\-F\fR, \fB\-\-info\-script\fR=\fIFILE\fR
run script at end of each tape (implies \fB\-M\fR)
.TP
\fB\-\-new\-volume\-script\fR=\fIFILE\fR
same as \fB\-F\fR FILE
.TP
\fB\-\-volno\-file\fR=\fIFILE\fR
use/update the volume number in FILE
.SS "Device blocking:"
.TP
\fB\-b\fR, \fB\-\-blocking\-factor\fR=\fIBLOCKS\fR
BLOCKS x 512 bytes per record
.TP
\fB\-\-record\-size\fR=\fISIZE\fR
SIZE bytes per record, multiple of 512
.TP
\fB\-i\fR, \fB\-\-ignore\-zeros\fR
ignore zeroed blocks in archive (means EOF)
.TP
\fB\-B\fR, \fB\-\-read\-full\-records\fR
reblock as we read (for 4.2BSD pipes)
.SS "Archive format selection:"
.TP
\fB\-V\fR, \fB\-\-label\fR=\fINAME\fR
create archive with volume name NAME
.TP
\fB\&...\fR=\fIPATTERN\fR
at list/extract time, a globbing PATTERN
.TP
\fB\-o\fR, \fB\-\-old\-archive\fR, \fB\-\-portability\fR
write a V7 format archive
.TP
\fB\-\-posix\fR
write a POSIX conformant archive
.TP
\fB\-z\fR, \fB\-\-gzip\fR
filter the archive through `gzip'
.TP
\fB\-Z\fR, \fB\-\-compress\fR
filter the archive through `compress'
.TP
\fB\-\-use\-compress\-program\fR=\fIPROG\fR
filter through `PROG' (must accept \fB\-d\fR)
.TP
\fB\-y\fR, \fB\-\-per\-file\-compress\fR
compress archived files independently
.SS "Local file selection:"
.TP
\fB\-C\fR, \fB\-\-directory\fR=\fIDIR\fR
change to directory DIR
.TP
\fB\-T\fR, \fB\-\-files\-from\fR=\fINAME\fR
get names to extract or create from file NAME
.TP
\fB\-\-null\fR
names from \fB\-T\fR option are NUL terminated
.TP
\fB\-\-exclude\fR=\fIPATTERN\fR
exclude files, given as a globbing PATTERN
.TP
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
exclude globbing patterns listed in FILE
.TP
\fB\-P\fR, \fB\-\-absolute\-names\fR
don't strip leading `/'s from file names
.TP
\fB\-h\fR, \fB\-\-dereference\fR
dump instead the files symlinks point to
.TP
\fB\-\-no\-recursion\fR
avoid descending automatically in directories
.TP
\fB\-l\fR, \fB\-\-one\-file\-system\fR
stay in local file system when creating archive
.TP
\fB\-K\fR, \fB\-\-starting\-file\fR=\fINAME\fR
begin at file NAME in the archive
.TP
\fB\-N\fR, \fB\-\-newer\fR=\fIDATE\fR
only store files newer than DATE
.TP
\fB\-\-newer\-mtime\fR
compare date and time when data changed only
.TP
\fB\-\-after\-date\fR=\fIDATE\fR
same as \fB\-N\fR
.TP
\fB\-\-backup\fR[=\fICONTROL\fR]
backup before removal, choose version control
.TP
\fB\-\-suffix\fR=\fISUFFIX\fR
backup before removal, override usual suffix
.SS "Informative output:"
.TP
\fB\-\-help\fR
print this help, then exit
.TP
\fB\-\-version\fR
print tar program version number, then exit
.TP
\fB\-v\fR, \fB\-\-verbose\fR
verbosely list files processed
.TP
\fB\-\-checkpoint\fR
write a progress dot every ten records
.TP
\fB\-\-show\-omitted\-dirs\fR
print directory names while reading the archive
.TP
\fB\-\-totals\fR
print total bytes written while creating archive
.TP
\fB\-R\fR, \fB\-\-block\-number\fR
insert archive block number within each message
.TP
\fB\-w\fR, \fB\-\-interactive\fR
ask for confirmation for every action
.TP
\fB\-\-confirmation\fR
same as \fB\-w\fR
.PP
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:
.TP
t, numbered
make numbered backups
.TP
nil, existing
numbered if numbered backups exist, simple otherwise
.TP
never, simple
always make simple backups
.PP
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'.
.SH "REPORTING BUGS"
Report bugs to <tar-bugs@iro.umontreal.ca>.
.SH "SEE ALSO"
The full documentation for
.B tar
is maintained as a Texinfo manual. If the
.B info
and
.B tar
programs are properly installed at your site, the command
.IP
.B info tar
.PP
should give you access to the complete manual.
.SH COPYRIGHT
Copyright \(co 1988, 92, 93, 94, 95, 96, 97 Free Software Foundation, Inc.
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH AUTHOR
Written by John Gilmore and Jay Fenlason.
Jump to Line
Something went wrong with that request. Please try again.