man: sync with help2man
Version: 1.27.1-2
This commit is contained in:
Pavel Raiskup
parent
5a94f6c0b2
commit
e6f5bb4d09
@ -1,272 +1,277 @@
|
||||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.12.
|
||||
.TH TAR "1" "February 2013" "tar 1.26" "User Commands"
|
||||
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
|
||||
.TH TAR "1" "November 2013" "tar 1.27.1" "User Commands"
|
||||
.SH NAME
|
||||
tar \- manual page for tar 1.26
|
||||
tar \- manual page for tar 1.27.1
|
||||
.SH SYNOPSIS
|
||||
.B tar
|
||||
[\fIOPTION\fR...] [\fIFILE\fR]...
|
||||
.SH DESCRIPTION
|
||||
GNU `tar' saves many files together into a single tape or disk archive, and can
|
||||
GNU 'tar' saves many files together into a single tape or disk archive, and can
|
||||
restore individual files from the archive.
|
||||
.SH EXAMPLES
|
||||
.TP
|
||||
tar \fB\-cf\fR archive.tar foo bar
|
||||
tar \-cf archive.tar foo bar
|
||||
# Create archive.tar from files foo and bar.
|
||||
.TP
|
||||
tar \fB\-tvf\fR archive.tar
|
||||
tar \-tvf archive.tar
|
||||
# List all files in archive.tar verbosely.
|
||||
.TP
|
||||
tar \fB\-xf\fR archive.tar
|
||||
tar \-xf archive.tar
|
||||
# Extract all files from archive.tar.
|
||||
.IP
|
||||
Main operation mode:
|
||||
.TP
|
||||
\fB\-A\fR, \fB\-\-catenate\fR, \fB\-\-concatenate\fR
|
||||
\-A, \-\-catenate, \-\-concatenate
|
||||
append tar files to an archive
|
||||
.TP
|
||||
\fB\-c\fR, \fB\-\-create\fR
|
||||
\-c, \-\-create
|
||||
create a new archive
|
||||
.TP
|
||||
\fB\-d\fR, \fB\-\-diff\fR, \fB\-\-compare\fR
|
||||
\-d, \-\-diff, \-\-compare
|
||||
find differences between archive and file system
|
||||
.TP
|
||||
\fB\-\-delete\fR
|
||||
\-\-delete
|
||||
delete from the archive (not on mag tapes!)
|
||||
.TP
|
||||
\fB\-r\fR, \fB\-\-append\fR
|
||||
\-r, \-\-append
|
||||
append files to the end of an archive
|
||||
.TP
|
||||
\fB\-t\fR, \fB\-\-list\fR
|
||||
\-t, \-\-list
|
||||
list the contents of an archive
|
||||
.TP
|
||||
\fB\-\-test\-label\fR
|
||||
\-\-test\-label
|
||||
test the archive volume label and exit
|
||||
.TP
|
||||
\fB\-u\fR, \fB\-\-update\fR
|
||||
\-u, \-\-update
|
||||
only append files newer than copy in archive
|
||||
.TP
|
||||
\fB\-x\fR, \fB\-\-extract\fR, \fB\-\-get\fR
|
||||
\-x, \-\-extract, \-\-get
|
||||
extract files from an archive
|
||||
.IP
|
||||
Operation modifiers:
|
||||
.TP
|
||||
\fB\-\-check\-device\fR
|
||||
\-\-check\-device
|
||||
check device numbers when creating incremental
|
||||
archives (default)
|
||||
.TP
|
||||
\fB\-g\fR, \fB\-\-listed\-incremental\fR=\fIFILE\fR
|
||||
\-g, \-\-listed\-incremental=FILE
|
||||
handle new GNU\-format incremental backup
|
||||
.TP
|
||||
\fB\-G\fR, \fB\-\-incremental\fR
|
||||
\-G, \-\-incremental
|
||||
handle old GNU\-format incremental backup
|
||||
.TP
|
||||
\fB\-\-ignore\-failed\-read\fR
|
||||
\-\-ignore\-failed\-read
|
||||
do not exit with nonzero on unreadable files
|
||||
.TP
|
||||
\fB\-\-level\fR=\fINUMBER\fR
|
||||
\-\-level=NUMBER
|
||||
dump level for created listed\-incremental archive
|
||||
.TP
|
||||
\fB\-n\fR, \fB\-\-seek\fR
|
||||
\-n, \-\-seek
|
||||
archive is seekable
|
||||
.TP
|
||||
\fB\-\-no\-check\-device\fR
|
||||
\-\-no\-check\-device
|
||||
do not check device numbers when creating
|
||||
incremental archives
|
||||
.TP
|
||||
\fB\-\-no\-seek\fR
|
||||
\-\-no\-seek
|
||||
archive is not seekable
|
||||
.TP
|
||||
\fB\-\-occurrence\fR[=\fINUMBER\fR]
|
||||
\-\-occurrence[=NUMBER]
|
||||
process only the NUMBERth occurrence of each file
|
||||
in the archive; this option is valid only in
|
||||
conjunction with one of the subcommands \fB\-\-delete\fR,
|
||||
\fB\-\-diff\fR, \fB\-\-extract\fR or \fB\-\-list\fR and when a list of
|
||||
conjunction with one of the subcommands \-\-delete,
|
||||
\-\-diff, \-\-extract or \-\-list and when a list of
|
||||
files is given either on the command line or via
|
||||
the \fB\-T\fR option; NUMBER defaults to 1
|
||||
the \-T option; NUMBER defaults to 1
|
||||
.TP
|
||||
\fB\-\-sparse\-version\fR=\fIMAJOR[\fR.MINOR]
|
||||
\-\-sparse\-version=MAJOR[.MINOR]
|
||||
set version of the sparse format to use (implies
|
||||
\fB\-\-sparse\fR)
|
||||
\-\-sparse)
|
||||
.TP
|
||||
\fB\-S\fR, \fB\-\-sparse\fR
|
||||
\-S, \-\-sparse
|
||||
handle sparse files efficiently
|
||||
.IP
|
||||
Overwrite control:
|
||||
.TP
|
||||
\fB\-k\fR, \fB\-\-keep\-old\-files\fR
|
||||
\-k, \-\-keep\-old\-files
|
||||
don't replace existing files when extracting,
|
||||
treat them as errors
|
||||
.TP
|
||||
\fB\-\-keep\-newer\-files\fR
|
||||
\-\-keep\-directory\-symlink
|
||||
preserve existing symlinks to directories when
|
||||
extracting
|
||||
.TP
|
||||
\-\-keep\-newer\-files
|
||||
don't replace existing files that are newer than
|
||||
their archive copies
|
||||
.TP
|
||||
\fB\-\-no\-overwrite\-dir\fR
|
||||
\-\-no\-overwrite\-dir
|
||||
preserve metadata of existing directories
|
||||
.TP
|
||||
\fB\-\-overwrite\fR
|
||||
\-\-overwrite
|
||||
overwrite existing files when extracting
|
||||
.TP
|
||||
\fB\-\-overwrite\-dir\fR
|
||||
\-\-overwrite\-dir
|
||||
overwrite metadata of existing directories when
|
||||
extracting (default)
|
||||
.TP
|
||||
\fB\-\-recursive\-unlink\fR
|
||||
\-\-recursive\-unlink
|
||||
empty hierarchies prior to extracting directory
|
||||
.TP
|
||||
\fB\-\-remove\-files\fR
|
||||
\-\-remove\-files
|
||||
remove files after adding them to the archive
|
||||
.TP
|
||||
\fB\-\-skip\-old\-files\fR
|
||||
\-\-skip\-old\-files
|
||||
don't replace existing files when extracting,
|
||||
silently skip over them
|
||||
.TP
|
||||
\fB\-U\fR, \fB\-\-unlink\-first\fR
|
||||
\-U, \-\-unlink\-first
|
||||
remove each file prior to extracting over it
|
||||
.TP
|
||||
\fB\-W\fR, \fB\-\-verify\fR
|
||||
\-W, \-\-verify
|
||||
attempt to verify the archive after writing it
|
||||
.IP
|
||||
Select output stream:
|
||||
.HP
|
||||
\fB\-\-ignore\-command\-error\fR ignore exit codes of children
|
||||
\-\-ignore\-command\-error ignore exit codes of children
|
||||
.TP
|
||||
\fB\-\-no\-ignore\-command\-error\fR
|
||||
\-\-no\-ignore\-command\-error
|
||||
treat non\-zero exit codes of children as
|
||||
error
|
||||
.TP
|
||||
\fB\-O\fR, \fB\-\-to\-stdout\fR
|
||||
\-O, \-\-to\-stdout
|
||||
extract files to standard output
|
||||
.TP
|
||||
\fB\-\-to\-command\fR=\fICOMMAND\fR
|
||||
\-\-to\-command=COMMAND
|
||||
pipe extracted files to another program
|
||||
.IP
|
||||
Handling of file attributes:
|
||||
.TP
|
||||
\fB\-\-atime\-preserve\fR[=\fIMETHOD\fR]
|
||||
\-\-atime\-preserve[=METHOD]
|
||||
preserve access times on dumped files, either
|
||||
by restoring the times after reading
|
||||
(METHOD='replace'; default) or by not setting the
|
||||
times in the first place (METHOD='system')
|
||||
.TP
|
||||
\fB\-\-delay\-directory\-restore\fR
|
||||
\-\-delay\-directory\-restore
|
||||
delay setting modification times and
|
||||
permissions of extracted directories until the end
|
||||
of extraction
|
||||
.TP
|
||||
\fB\-\-group\fR=\fINAME\fR
|
||||
\-\-group=NAME
|
||||
force NAME as group for added files
|
||||
.TP
|
||||
\fB\-\-mode\fR=\fICHANGES\fR
|
||||
\-\-mode=CHANGES
|
||||
force (symbolic) mode CHANGES for added files
|
||||
.TP
|
||||
\fB\-\-mtime\fR=\fIDATE\-OR\-FILE\fR
|
||||
\-\-mtime=DATE\-OR\-FILE
|
||||
set mtime for added files from DATE\-OR\-FILE
|
||||
.TP
|
||||
\fB\-m\fR, \fB\-\-touch\fR
|
||||
\-m, \-\-touch
|
||||
don't extract file modified time
|
||||
.TP
|
||||
\fB\-\-no\-delay\-directory\-restore\fR
|
||||
cancel the effect of \fB\-\-delay\-directory\-restore\fR
|
||||
\-\-no\-delay\-directory\-restore
|
||||
cancel the effect of \-\-delay\-directory\-restore
|
||||
option
|
||||
.TP
|
||||
\fB\-\-no\-same\-owner\fR
|
||||
\-\-no\-same\-owner
|
||||
extract files as yourself (default for ordinary
|
||||
users)
|
||||
.TP
|
||||
\fB\-\-no\-same\-permissions\fR
|
||||
\-\-no\-same\-permissions
|
||||
apply the user's umask when extracting permissions
|
||||
from the archive (default for ordinary users)
|
||||
.TP
|
||||
\fB\-\-numeric\-owner\fR
|
||||
\-\-numeric\-owner
|
||||
always use numbers for user/group names
|
||||
.TP
|
||||
\fB\-\-owner\fR=\fINAME\fR
|
||||
\-\-owner=NAME
|
||||
force NAME as owner for added files
|
||||
.TP
|
||||
\fB\-p\fR, \fB\-\-preserve\-permissions\fR, \fB\-\-same\-permissions\fR
|
||||
\-p, \-\-preserve\-permissions, \-\-same\-permissions
|
||||
extract information about file permissions
|
||||
(default for superuser)
|
||||
.TP
|
||||
\fB\-\-preserve\fR
|
||||
same as both \fB\-p\fR and \fB\-s\fR
|
||||
\-\-preserve
|
||||
same as both \-p and \-s
|
||||
.TP
|
||||
\fB\-\-same\-owner\fR
|
||||
\-\-same\-owner
|
||||
try extracting files with the same ownership as
|
||||
exists in the archive (default for superuser)
|
||||
.TP
|
||||
\fB\-s\fR, \fB\-\-preserve\-order\fR, \fB\-\-same\-order\fR
|
||||
sort names to extract to match archive
|
||||
\-s, \-\-preserve\-order, \-\-same\-order
|
||||
member arguments are listed in the same order as
|
||||
the files in the archive
|
||||
.IP
|
||||
Handling of extended file attributes:
|
||||
.TP
|
||||
\fB\-\-acls\fR
|
||||
\-\-acls
|
||||
Enable the POSIX ACLs support
|
||||
.TP
|
||||
\fB\-\-no\-acls\fR
|
||||
\-\-no\-acls
|
||||
Disable the POSIX ACLs support
|
||||
.TP
|
||||
\fB\-\-no\-selinux\fR
|
||||
\-\-no\-selinux
|
||||
Disable the SELinux context support
|
||||
.TP
|
||||
\fB\-\-no\-xattrs\fR
|
||||
\-\-no\-xattrs
|
||||
Disable extended attributes support
|
||||
.TP
|
||||
\fB\-\-selinux\fR
|
||||
\-\-selinux
|
||||
Enable the SELinux context support
|
||||
.TP
|
||||
\fB\-\-xattrs\fR
|
||||
\-\-xattrs
|
||||
Enable extended attributes support
|
||||
.TP
|
||||
\fB\-\-xattrs\-exclude\fR=\fIMASK\fR
|
||||
\-\-xattrs\-exclude=MASK
|
||||
specify the exclude pattern for xattr keys
|
||||
.TP
|
||||
\fB\-\-xattrs\-include\fR=\fIMASK\fR
|
||||
\-\-xattrs\-include=MASK
|
||||
specify the include pattern for xattr keys
|
||||
.IP
|
||||
Device selection and switching:
|
||||
.TP
|
||||
\fB\-f\fR, \fB\-\-file\fR=\fIARCHIVE\fR
|
||||
\-f, \-\-file=ARCHIVE
|
||||
use archive file or device ARCHIVE
|
||||
.TP
|
||||
\fB\-\-force\-local\fR
|
||||
\-\-force\-local
|
||||
archive file is local even if it has a colon
|
||||
.TP
|
||||
\fB\-F\fR, \fB\-\-info\-script\fR=\fINAME\fR, \fB\-\-new\-volume\-script\fR=\fINAME\fR
|
||||
run script at end of each tape (implies \fB\-M\fR)
|
||||
\-F, \-\-info\-script=NAME, \-\-new\-volume\-script=NAME
|
||||
run script at end of each tape (implies \-M)
|
||||
.TP
|
||||
\fB\-L\fR, \fB\-\-tape\-length\fR=\fINUMBER\fR
|
||||
\-L, \-\-tape\-length=NUMBER
|
||||
change tape after writing NUMBER x 1024 bytes
|
||||
.TP
|
||||
\fB\-M\fR, \fB\-\-multi\-volume\fR
|
||||
\-M, \-\-multi\-volume
|
||||
create/list/extract multi\-volume archive
|
||||
.TP
|
||||
\fB\-\-rmt\-command\fR=\fICOMMAND\fR
|
||||
\-\-rmt\-command=COMMAND
|
||||
use given rmt COMMAND instead of rmt
|
||||
.TP
|
||||
\fB\-\-rsh\-command\fR=\fICOMMAND\fR
|
||||
\-\-rsh\-command=COMMAND
|
||||
use remote COMMAND instead of rsh
|
||||
.TP
|
||||
\fB\-\-volno\-file\fR=\fIFILE\fR
|
||||
\-\-volno\-file=FILE
|
||||
use/update the volume number in FILE
|
||||
.IP
|
||||
Device blocking:
|
||||
.TP
|
||||
\fB\-b\fR, \fB\-\-blocking\-factor\fR=\fIBLOCKS\fR
|
||||
\-b, \-\-blocking\-factor=BLOCKS
|
||||
BLOCKS x 512 bytes per record
|
||||
.TP
|
||||
\fB\-B\fR, \fB\-\-read\-full\-records\fR
|
||||
\-B, \-\-read\-full\-records
|
||||
reblock as we read (for 4.2BSD pipes)
|
||||
.TP
|
||||
\fB\-i\fR, \fB\-\-ignore\-zeros\fR
|
||||
\-i, \-\-ignore\-zeros
|
||||
ignore zeroed blocks in archive (means EOF)
|
||||
.TP
|
||||
\fB\-\-record\-size\fR=\fINUMBER\fR
|
||||
\-\-record\-size=NUMBER
|
||||
NUMBER of bytes per record, multiple of 512
|
||||
.IP
|
||||
Archive format selection:
|
||||
.TP
|
||||
\fB\-H\fR, \fB\-\-format\fR=\fIFORMAT\fR
|
||||
\-H, \-\-format=FORMAT
|
||||
create archive of the given format
|
||||
.IP
|
||||
FORMAT is one of the following:
|
||||
@ -289,267 +294,271 @@ POSIX 1003.1\-1988 (ustar) format
|
||||
v7
|
||||
old V7 tar format
|
||||
.TP
|
||||
\fB\-\-old\-archive\fR, \fB\-\-portability\fR
|
||||
same as \fB\-\-format\fR=\fIv7\fR
|
||||
\-\-old\-archive, \-\-portability
|
||||
same as \-\-format=v7
|
||||
.TP
|
||||
\fB\-\-pax\-option\fR=\fIkeyword[[\fR:]=value][,keyword[[:]=value]]...
|
||||
\-\-pax\-option=keyword[[:]=value][,keyword[[:]=value]]...
|
||||
control pax keywords
|
||||
.TP
|
||||
\fB\-\-posix\fR
|
||||
same as \fB\-\-format\fR=\fIposix\fR
|
||||
\-\-posix
|
||||
same as \-\-format=posix
|
||||
.TP
|
||||
\fB\-V\fR, \fB\-\-label\fR=\fITEXT\fR
|
||||
\-V, \-\-label=TEXT
|
||||
create archive with volume name TEXT; at
|
||||
list/extract time, use TEXT as a globbing pattern
|
||||
for volume name
|
||||
.IP
|
||||
Compression options:
|
||||
.TP
|
||||
\fB\-a\fR, \fB\-\-auto\-compress\fR
|
||||
\-a, \-\-auto\-compress
|
||||
use archive suffix to determine the compression
|
||||
program
|
||||
.TP
|
||||
\fB\-I\fR, \fB\-\-use\-compress\-program\fR=\fIPROG\fR
|
||||
filter through PROG (must accept \fB\-d\fR)
|
||||
\-I, \-\-use\-compress\-program=PROG
|
||||
filter through PROG (must accept \-d)
|
||||
.TP
|
||||
\fB\-j\fR, \fB\-\-bzip2\fR
|
||||
\-j, \-\-bzip2
|
||||
filter the archive through bzip2
|
||||
.TP
|
||||
\fB\-J\fR, \fB\-\-xz\fR
|
||||
\-J, \-\-xz
|
||||
filter the archive through xz
|
||||
.TP
|
||||
\fB\-\-lzip\fR
|
||||
\-\-lzip
|
||||
filter the archive through lzip
|
||||
.TP
|
||||
\fB\-\-lzma\fR
|
||||
filter the archive through lzma
|
||||
\-\-lzma
|
||||
filter the archive through xz \-\-format=lzma
|
||||
.HP
|
||||
\fB\-\-lzop\fR
|
||||
\-\-lzop
|
||||
.TP
|
||||
\fB\-\-no\-auto\-compress\fR
|
||||
\-\-no\-auto\-compress
|
||||
do not use archive suffix to determine the
|
||||
compression program
|
||||
.TP
|
||||
\fB\-z\fR, \fB\-\-gzip\fR, \fB\-\-gunzip\fR, \fB\-\-ungzip\fR
|
||||
\-z, \-\-gzip, \-\-gunzip, \-\-ungzip
|
||||
filter the archive through gzip
|
||||
.TP
|
||||
\fB\-Z\fR, \fB\-\-compress\fR, \fB\-\-uncompress\fR
|
||||
\-Z, \-\-compress, \-\-uncompress
|
||||
filter the archive through compress
|
||||
.IP
|
||||
Local file selection:
|
||||
.TP
|
||||
\fB\-\-add\-file\fR=\fIFILE\fR
|
||||
\-\-add\-file=FILE
|
||||
add given FILE to the archive (useful if its name
|
||||
starts with a dash)
|
||||
.TP
|
||||
\fB\-\-backup\fR[=\fICONTROL\fR]
|
||||
\-\-backup[=CONTROL]
|
||||
backup before removal, choose version CONTROL
|
||||
.TP
|
||||
\fB\-C\fR, \fB\-\-directory\fR=\fIDIR\fR
|
||||
\-C, \-\-directory=DIR
|
||||
change to directory DIR
|
||||
.TP
|
||||
\fB\-\-exclude\fR=\fIPATTERN\fR
|
||||
\-\-exclude=PATTERN
|
||||
exclude files, given as a PATTERN
|
||||
.TP
|
||||
\fB\-\-exclude\-backups\fR
|
||||
\-\-exclude\-backups
|
||||
exclude backup and lock files
|
||||
.TP
|
||||
\fB\-\-exclude\-caches\fR
|
||||
\-\-exclude\-caches
|
||||
exclude contents of directories containing
|
||||
CACHEDIR.TAG, except for the tag file itself
|
||||
.TP
|
||||
\fB\-\-exclude\-caches\-all\fR
|
||||
\-\-exclude\-caches\-all
|
||||
exclude directories containing CACHEDIR.TAG
|
||||
.TP
|
||||
\fB\-\-exclude\-caches\-under\fR exclude everything under directories containing
|
||||
\-\-exclude\-caches\-under exclude everything under directories containing
|
||||
CACHEDIR.TAG
|
||||
.TP
|
||||
\fB\-\-exclude\-tag\fR=\fIFILE\fR
|
||||
\-\-exclude\-tag=FILE
|
||||
exclude contents of directories containing FILE,
|
||||
except for FILE itself
|
||||
.HP
|
||||
\fB\-\-exclude\-tag\-all\fR=\fIFILE\fR exclude directories containing FILE
|
||||
\-\-exclude\-tag\-all=FILE exclude directories containing FILE
|
||||
.TP
|
||||
\fB\-\-exclude\-tag\-under\fR=\fIFILE\fR
|
||||
\-\-exclude\-tag\-under=FILE
|
||||
exclude everything under directories
|
||||
containing FILE
|
||||
.TP
|
||||
\fB\-\-exclude\-vcs\fR
|
||||
\-\-exclude\-vcs
|
||||
exclude version control system directories
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-dereference\fR
|
||||
\-h, \-\-dereference
|
||||
follow symlinks; archive and dump the files they
|
||||
point to
|
||||
.TP
|
||||
\fB\-\-hard\-dereference\fR
|
||||
\-\-hard\-dereference
|
||||
follow hard links; archive and dump the files they
|
||||
refer to
|
||||
.TP
|
||||
\fB\-K\fR, \fB\-\-starting\-file\fR=\fIMEMBER\-NAME\fR
|
||||
begin at member MEMBER\-NAME in the archive
|
||||
\-K, \-\-starting\-file=MEMBER\-NAME
|
||||
begin at member MEMBER\-NAME when reading the
|
||||
archive
|
||||
.TP
|
||||
\fB\-\-newer\-mtime\fR=\fIDATE\fR
|
||||
\-\-newer\-mtime=DATE
|
||||
compare date and time when data changed only
|
||||
.TP
|
||||
\fB\-\-no\-null\fR
|
||||
disable the effect of the previous \fB\-\-null\fR option
|
||||
\-\-no\-null
|
||||
disable the effect of the previous \-\-null option
|
||||
.TP
|
||||
\fB\-\-no\-recursion\fR
|
||||
\-\-no\-recursion
|
||||
avoid descending automatically in directories
|
||||
.TP
|
||||
\fB\-\-no\-unquote\fR
|
||||
do not unquote filenames read with \fB\-T\fR
|
||||
\-\-no\-unquote
|
||||
do not unquote filenames read with \-T
|
||||
.HP
|
||||
\fB\-\-null\fR \fB\-T\fR reads null\-terminated names, disable \fB\-C\fR
|
||||
\-\-null \-T reads null\-terminated names, disable \-C
|
||||
.TP
|
||||
\fB\-N\fR, \fB\-\-newer\fR=\fIDATE\-OR\-FILE\fR, \fB\-\-after\-date\fR=\fIDATE\-OR\-FILE\fR
|
||||
\-N, \-\-newer=DATE\-OR\-FILE, \-\-after\-date=DATE\-OR\-FILE
|
||||
only store files newer than DATE\-OR\-FILE
|
||||
.TP
|
||||
\fB\-\-one\-file\-system\fR
|
||||
\-\-one\-file\-system
|
||||
stay in local file system when creating archive
|
||||
.TP
|
||||
\fB\-P\fR, \fB\-\-absolute\-names\fR
|
||||
don't strip leading `/'s from file names
|
||||
\-P, \-\-absolute\-names
|
||||
don't strip leading '/'s from file names
|
||||
.TP
|
||||
\fB\-\-recursion\fR
|
||||
\-\-recursion
|
||||
recurse into directories (default)
|
||||
.TP
|
||||
\fB\-\-suffix\fR=\fISTRING\fR
|
||||
\-\-suffix=STRING
|
||||
backup before removal, override usual suffix ('~'
|
||||
unless overridden by environment variable
|
||||
SIMPLE_BACKUP_SUFFIX)
|
||||
.TP
|
||||
\fB\-T\fR, \fB\-\-files\-from\fR=\fIFILE\fR
|
||||
\-T, \-\-files\-from=FILE
|
||||
get names to extract or create from FILE
|
||||
.TP
|
||||
\fB\-\-unquote\fR
|
||||
unquote filenames read with \fB\-T\fR (default)
|
||||
\-\-unquote
|
||||
unquote filenames read with \-T (default)
|
||||
.TP
|
||||
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
|
||||
\-X, \-\-exclude\-from=FILE
|
||||
exclude patterns listed in FILE
|
||||
.IP
|
||||
File name transformations:
|
||||
.TP
|
||||
\fB\-\-strip\-components\fR=\fINUMBER\fR
|
||||
\-\-strip\-components=NUMBER
|
||||
strip NUMBER leading components from file
|
||||
names on extraction
|
||||
.TP
|
||||
\fB\-\-transform\fR=\fIEXPRESSION\fR, \fB\-\-xform\fR=\fIEXPRESSION\fR
|
||||
\-\-transform=EXPRESSION, \-\-xform=EXPRESSION
|
||||
use sed replace EXPRESSION to transform file
|
||||
names
|
||||
.IP
|
||||
File name matching options (affect both exclude and include patterns):
|
||||
.TP
|
||||
\fB\-\-anchored\fR
|
||||
\-\-anchored
|
||||
patterns match file name start
|
||||
.TP
|
||||
\fB\-\-ignore\-case\fR
|
||||
\-\-ignore\-case
|
||||
ignore case
|
||||
.TP
|
||||
\fB\-\-no\-anchored\fR
|
||||
patterns match after any `/' (default for
|
||||
\-\-no\-anchored
|
||||
patterns match after any '/' (default for
|
||||
exclusion)
|
||||
.TP
|
||||
\fB\-\-no\-ignore\-case\fR
|
||||
\-\-no\-ignore\-case
|
||||
case sensitive matching (default)
|
||||
.TP
|
||||
\fB\-\-no\-wildcards\fR
|
||||
\-\-no\-wildcards
|
||||
verbatim string matching
|
||||
.TP
|
||||
\fB\-\-no\-wildcards\-match\-slash\fR
|
||||
wildcards do not match `/'
|
||||
\-\-no\-wildcards\-match\-slash
|
||||
wildcards do not match '/'
|
||||
.TP
|
||||
\fB\-\-wildcards\fR
|
||||
\-\-wildcards
|
||||
use wildcards (default)
|
||||
.TP
|
||||
\fB\-\-wildcards\-match\-slash\fR
|
||||
wildcards match `/' (default for exclusion)
|
||||
\-\-wildcards\-match\-slash
|
||||
wildcards match '/' (default for exclusion)
|
||||
.IP
|
||||
Informative output:
|
||||
.TP
|
||||
\fB\-\-checkpoint\fR[=\fINUMBER\fR]
|
||||
\-\-checkpoint[=NUMBER]
|
||||
display progress messages every NUMBERth record
|
||||
(default 10)
|
||||
.TP
|
||||
\fB\-\-checkpoint\-action\fR=\fIACTION\fR
|
||||
\-\-checkpoint\-action=ACTION
|
||||
execute ACTION on each checkpoint
|
||||
.TP
|
||||
\fB\-\-full\-time\fR
|
||||
\-\-full\-time
|
||||
print file time to its full resolution
|
||||
.TP
|
||||
\fB\-\-index\-file\fR=\fIFILE\fR
|
||||
\-\-index\-file=FILE
|
||||
send verbose output to FILE
|
||||
.TP
|
||||
\fB\-l\fR, \fB\-\-check\-links\fR
|
||||
\-l, \-\-check\-links
|
||||
print a message if not all links are dumped
|
||||
.TP
|
||||
\fB\-\-no\-quote\-chars\fR=\fISTRING\fR
|
||||
\-\-no\-quote\-chars=STRING
|
||||
disable quoting for characters from STRING
|
||||
.TP
|
||||
\fB\-\-quote\-chars\fR=\fISTRING\fR
|
||||
\-\-quote\-chars=STRING
|
||||
additionally quote characters from STRING
|
||||
.TP
|
||||
\fB\-\-quoting\-style\fR=\fISTYLE\fR
|
||||
\-\-quoting\-style=STYLE
|
||||
set name quoting style; see below for valid STYLE
|
||||
values
|
||||
.TP
|
||||
\fB\-R\fR, \fB\-\-block\-number\fR
|
||||
\-R, \-\-block\-number
|
||||
show block number within archive with each message
|
||||
.TP
|
||||
\fB\-\-show\-defaults\fR
|
||||
\-\-show\-defaults
|
||||
show tar defaults
|
||||
.TP
|
||||
\fB\-\-show\-omitted\-dirs\fR
|
||||
\-\-show\-omitted\-dirs
|
||||
when listing or extracting, list each directory
|
||||
that does not match search criteria
|
||||
.TP
|
||||
\fB\-\-show\-transformed\-names\fR, \fB\-\-show\-stored\-names\fR
|
||||
\-\-show\-snapshot\-field\-ranges
|
||||
show valid ranges for snapshot\-file fields
|
||||
.TP
|
||||
\-\-show\-transformed\-names, \-\-show\-stored\-names
|
||||
show file or archive names after transformation
|
||||
.TP
|
||||
\fB\-\-totals\fR[=\fISIGNAL\fR]
|
||||
\-\-totals[=SIGNAL]
|
||||
print total bytes after processing the archive;
|
||||
with an argument \- print total bytes when this
|
||||
SIGNAL is delivered; Allowed signals are: SIGHUP,
|
||||
SIGQUIT, SIGINT, SIGUSR1 and SIGUSR2; the names
|
||||
without SIG prefix are also accepted
|
||||
.TP
|
||||
\fB\-\-utc\fR
|
||||
\-\-utc
|
||||
print file modification times in UTC
|
||||
.TP
|
||||
\fB\-v\fR, \fB\-\-verbose\fR
|
||||
\-v, \-\-verbose
|
||||
verbosely list files processed
|
||||
.TP
|
||||
\fB\-\-warning\fR=\fIKEYWORD\fR
|
||||
\-\-warning=KEYWORD
|
||||
warning control
|
||||
.TP
|
||||
\fB\-w\fR, \fB\-\-interactive\fR, \fB\-\-confirmation\fR
|
||||
\-w, \-\-interactive, \-\-confirmation
|
||||
ask for confirmation for every action
|
||||
.IP
|
||||
Compatibility options:
|
||||
.TP
|
||||
\fB\-o\fR
|
||||
when creating, same as \fB\-\-old\-archive\fR; when
|
||||
extracting, same as \fB\-\-no\-same\-owner\fR
|
||||
\-o
|
||||
when creating, same as \-\-old\-archive; when
|
||||
extracting, same as \-\-no\-same\-owner
|
||||
.IP
|
||||
Other options:
|
||||
.TP
|
||||
\-?, \fB\-\-help\fR
|
||||
\-?, \-\-help
|
||||
give this help list
|
||||
.TP
|
||||
\fB\-\-restrict\fR
|
||||
\-\-restrict
|
||||
disable use of some potentially harmful options
|
||||
.TP
|
||||
\fB\-\-usage\fR
|
||||
\-\-usage
|
||||
give a short usage message
|
||||
.TP
|
||||
\fB\-\-version\fR
|
||||
\-\-version
|
||||
print program version
|
||||
.PP
|
||||
Mandatory or optional arguments to long options are also mandatory or optional
|
||||
for any corresponding short options.
|
||||
.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:
|
||||
The backup suffix is '~', unless set with \-\-suffix or SIMPLE_BACKUP_SUFFIX.
|
||||
The version control may be set with \-\-backup or VERSION_CONTROL, values are:
|
||||
.TP
|
||||
none, off
|
||||
never make backups
|
||||
@ -563,7 +572,7 @@ numbered if numbered backups exist, simple otherwise
|
||||
never, simple
|
||||
always make simple backups
|
||||
.PP
|
||||
Valid arguments for the \fB\-\-quoting\-style\fR option are:
|
||||
Valid arguments for the \-\-quoting\-style option are:
|
||||
.IP
|
||||
literal
|
||||
shell
|
||||
@ -575,14 +584,14 @@ locale
|
||||
clocale
|
||||
.PP
|
||||
*This* tar defaults to:
|
||||
\fB\-\-format\fR=\fIgnu\fR \fB\-f\-\fR \fB\-b20\fR \fB\-\-quoting\-style\fR=\fIescape\fR \fB\-\-rmt\-command=\fR/sbin/rmt
|
||||
\fB\-\-rsh\-command=\fR/usr/bin/rsh
|
||||
\-\-format=gnu \-f\- \-b20 \-\-quoting\-style=escape \-\-rmt\-command=/etc/rmt
|
||||
\-\-rsh\-command=/usr/bin/ssh
|
||||
.SH AUTHOR
|
||||
Written by John Gilmore and Jay Fenlason.
|
||||
.SH "REPORTING BUGS"
|
||||
Report bugs to <bug\-tar@gnu.org>.
|
||||
.SH COPYRIGHT
|
||||
Copyright \(co 2011 Free Software Foundation, Inc.
|
||||
Copyright \(co 2013 Free Software Foundation, Inc.
|
||||
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
|
||||
.br
|
||||
This is free software: you are free to change and redistribute it.
|
||||
|
||||
29
tar.1
29
tar.1
@ -1,12 +1,12 @@
|
||||
.\" This file was originally generated by help2man
|
||||
.TH TAR "1" "February 2013" "tar 1.26" "User Commands"
|
||||
.TH TAR "1" "November 2013" "tar 1.27.1" "User Commands"
|
||||
.SH NAME
|
||||
tar \- an archiver tool
|
||||
.SH SYNOPSIS
|
||||
.B tar
|
||||
[\fIOPTION\fR...] [\fIFILE\fR]...
|
||||
.SH DESCRIPTION
|
||||
GNU `tar' saves many files together into a single tape or disk archive, and can
|
||||
GNU 'tar' saves many files together into a single tape or disk archive, and can
|
||||
restore individual files from the archive.
|
||||
|
||||
Note that this manual page contains just very brief description (or more like
|
||||
@ -20,7 +20,7 @@ is maintained as a Texinfo manual. If the
|
||||
and
|
||||
.B tar
|
||||
programs are properly installed at your site, the command
|
||||
.B `info tar'
|
||||
.B 'info tar'
|
||||
should give you access to the complete manual.
|
||||
.SH EXAMPLES
|
||||
.TP
|
||||
@ -139,6 +139,10 @@ handle sparse files efficiently
|
||||
don't replace existing files when extracting,
|
||||
treat them as errors
|
||||
.TP
|
||||
\fB\-\-keep\-directory\-symlink\fR
|
||||
preserve existing symlinks to directories when
|
||||
extracting
|
||||
.TP
|
||||
\fB\-\-keep\-newer\-files\fR
|
||||
don't replace existing files that are newer than
|
||||
their archive copies
|
||||
@ -238,7 +242,8 @@ try extracting files with the same ownership as
|
||||
exists in the archive (default for superuser)
|
||||
.TP
|
||||
\fB\-s\fR, \fB\-\-preserve\-order\fR, \fB\-\-same\-order\fR
|
||||
sort names to extract to match archive
|
||||
member arguments are listed in the same order as
|
||||
the files in the archive
|
||||
.IP
|
||||
.SH \fBHandling of extended file attributes:\fR
|
||||
.TP
|
||||
@ -433,7 +438,8 @@ follow hard links; archive and dump the files they
|
||||
refer to
|
||||
.TP
|
||||
\fB\-K\fR, \fB\-\-starting\-file\fR=\fIMEMBER\-NAME\fR
|
||||
begin at member MEMBER\-NAME in the archive
|
||||
begin at member MEMBER\-NAME when reading the
|
||||
archive
|
||||
.TP
|
||||
\fB\-\-newer\-mtime\fR=\fIDATE\fR
|
||||
compare date and time when data changed only
|
||||
@ -456,7 +462,7 @@ only store files newer than DATE\-OR\-FILE
|
||||
stay in local file system when creating archive
|
||||
.TP
|
||||
\fB\-P\fR, \fB\-\-absolute\-names\fR
|
||||
don't strip leading `/'s from file names
|
||||
don't strip leading '/'s from file names
|
||||
.TP
|
||||
\fB\-\-recursion\fR
|
||||
recurse into directories (default)
|
||||
@ -494,7 +500,7 @@ patterns match file name start
|
||||
ignore case
|
||||
.TP
|
||||
\fB\-\-no\-anchored\fR
|
||||
patterns match after any `/' (default for
|
||||
patterns match after any '/' (default for
|
||||
exclusion)
|
||||
.TP
|
||||
\fB\-\-no\-ignore\-case\fR
|
||||
@ -504,13 +510,13 @@ case sensitive matching (default)
|
||||
verbatim string matching
|
||||
.TP
|
||||
\fB\-\-no\-wildcards\-match\-slash\fR
|
||||
wildcards do not match `/'
|
||||
wildcards do not match '/'
|
||||
.TP
|
||||
\fB\-\-wildcards\fR
|
||||
use wildcards (default)
|
||||
.TP
|
||||
\fB\-\-wildcards\-match\-slash\fR
|
||||
wildcards match `/' (default for exclusion)
|
||||
wildcards match '/' (default for exclusion)
|
||||
.IP
|
||||
.SH \fBInformative output:\fR
|
||||
.TP
|
||||
@ -551,6 +557,9 @@ show tar defaults
|
||||
when listing or extracting, list each directory
|
||||
that does not match search criteria
|
||||
.TP
|
||||
\fB\-\-show\-snapshot\-field\-ranges\fR
|
||||
show valid ranges for snapshot\-file fields
|
||||
.TP
|
||||
\fB\-\-show\-transformed\-names\fR, \fB\-\-show\-stored\-names\fR
|
||||
show file or archive names after transformation
|
||||
.TP
|
||||
@ -597,7 +606,7 @@ print program version
|
||||
Mandatory or optional arguments to long options are also mandatory or optional
|
||||
for any corresponding short options.
|
||||
.PP
|
||||
The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
|
||||
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
|
||||
none, off
|
||||
|
||||
5
tar.spec
5
tar.spec
@ -5,7 +5,7 @@ Summary: A GNU file archiving program
|
||||
Name: tar
|
||||
Epoch: 2
|
||||
Version: 1.27.1
|
||||
Release: 1%{?dist}
|
||||
Release: 2%{?dist}
|
||||
License: GPLv3+
|
||||
Group: Applications/Archiving
|
||||
URL: http://www.gnu.org/software/tar/
|
||||
@ -163,6 +163,9 @@ fi
|
||||
%{_infodir}/tar.info*
|
||||
|
||||
%changelog
|
||||
* Fri Nov 29 2013 Pavel Raiskup <praiskup@redhat.com> - 1.27.1-2
|
||||
- sync manual page contents with help2man output
|
||||
|
||||
* Mon Nov 18 2013 Pavel Raiskup <praiskup@redhat.com> - 1.27.1-1
|
||||
- minor version update to 1.27.1
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user