rpms/tar
7
0
Fork 0
Code Issues Pull Requests Releases Activity

man: sync with help2man

Browse Source 
Version: 1.27.1-2
This commit is contained in:
Pavel Raiskup 2013-11-29 08:31:44 +01:00
parent 5a94f6c0b2
commit e6f5bb4d09
3 changed files with 211 additions and 190 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

367
last_help2man_run
View File

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

29
tar.1
View File

@ -1,12 +1,12 @@
.\" This file was originally generated by help2man .\" 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 .SH NAME
tar \- an archiver tool tar \- an archiver tool
.SH SYNOPSIS .SH SYNOPSIS
.B tar .B tar
[\fIOPTION\fR...] [\fIFILE\fR]... [\fIOPTION\fR...] [\fIFILE\fR]...
.SH DESCRIPTION .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. restore individual files from the archive.
Note that this manual page contains just very brief description (or more like 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 and
.B tar .B tar
programs are properly installed at your site, the command programs are properly installed at your site, the command
.B `info tar' .B 'info tar'
should give you access to the complete manual. should give you access to the complete manual.
.SH EXAMPLES .SH EXAMPLES
.TP .TP
@ -139,6 +139,10 @@ handle sparse files efficiently
don't replace existing files when extracting, don't replace existing files when extracting,
treat them as errors treat them as errors
.TP .TP
\fB\-\-keep\-directory\-symlink\fR
preserve existing symlinks to directories when
extracting
.TP
\fB\-\-keep\-newer\-files\fR \fB\-\-keep\-newer\-files\fR
don't replace existing files that are newer than don't replace existing files that are newer than
their archive copies their archive copies
@ -238,7 +242,8 @@ try extracting files with the same ownership as
exists in the archive (default for superuser) exists in the archive (default for superuser)
.TP .TP
\fB\-s\fR, \fB\-\-preserve\-order\fR, \fB\-\-same\-order\fR \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 .IP
.SH \fBHandling of extended file attributes:\fR .SH \fBHandling of extended file attributes:\fR
.TP .TP
@ -433,7 +438,8 @@ follow hard links; archive and dump the files they
refer to refer to
.TP .TP
\fB\-K\fR, \fB\-\-starting\-file\fR=\fIMEMBER\-NAME\fR \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 .TP
\fB\-\-newer\-mtime\fR=\fIDATE\fR \fB\-\-newer\-mtime\fR=\fIDATE\fR
compare date and time when data changed only 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 stay in local file system when creating archive
.TP .TP
\fB\-P\fR, \fB\-\-absolute\-names\fR \fB\-P\fR, \fB\-\-absolute\-names\fR
don't strip leading `/'s from file names don't strip leading '/'s from file names
.TP .TP
\fB\-\-recursion\fR \fB\-\-recursion\fR
recurse into directories (default) recurse into directories (default)
@ -494,7 +500,7 @@ patterns match file name start
ignore case ignore case
.TP .TP
\fB\-\-no\-anchored\fR \fB\-\-no\-anchored\fR
patterns match after any `/' (default for patterns match after any '/' (default for
exclusion) exclusion)
.TP .TP
\fB\-\-no\-ignore\-case\fR \fB\-\-no\-ignore\-case\fR
@ -504,13 +510,13 @@ case sensitive matching (default)
verbatim string matching verbatim string matching
.TP .TP
\fB\-\-no\-wildcards\-match\-slash\fR \fB\-\-no\-wildcards\-match\-slash\fR
wildcards do not match `/' wildcards do not match '/'
.TP .TP
\fB\-\-wildcards\fR \fB\-\-wildcards\fR
use wildcards (default) use wildcards (default)
.TP .TP
\fB\-\-wildcards\-match\-slash\fR \fB\-\-wildcards\-match\-slash\fR
wildcards match `/' (default for exclusion) wildcards match '/' (default for exclusion)
.IP .IP
.SH \fBInformative output:\fR .SH \fBInformative output:\fR
.TP .TP
@ -551,6 +557,9 @@ show tar defaults
when listing or extracting, list each directory when listing or extracting, list each directory
that does not match search criteria that does not match search criteria
.TP .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 \fB\-\-show\-transformed\-names\fR, \fB\-\-show\-stored\-names\fR
show file or archive names after transformation show file or archive names after transformation
.TP .TP
@ -597,7 +606,7 @@ print program version
Mandatory or optional arguments to long options are also mandatory or optional Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options. for any corresponding short options.
.PP .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: The version control may be set with \fB\-\-backup\fR or VERSION_CONTROL, values are:
.TP .TP
none, off none, off

5
tar.spec
View File

@ -5,7 +5,7 @@ Summary: A GNU file archiving program
Name: tar Name: tar
Epoch: 2 Epoch: 2
Version: 1.27.1 Version: 1.27.1
Release: 1%{?dist} Release: 2%{?dist}
License: GPLv3+ License: GPLv3+
Group: Applications/Archiving Group: Applications/Archiving
URL: http://www.gnu.org/software/tar/ URL: http://www.gnu.org/software/tar/
@ -163,6 +163,9 @@ fi
%{_infodir}/tar.info* %{_infodir}/tar.info*
%changelog %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 * Mon Nov 18 2013 Pavel Raiskup <praiskup@redhat.com> - 1.27.1-1
- minor version update to 1.27.1 - minor version update to 1.27.1