tar: removed 1.5 patches, updated tar.1 man-page, added rmt.8 man-page
This commit is contained in:
parent
7be125ee1d
commit
e6a153e25b
@ -7,3 +7,5 @@ drwxr-xr-x root/root usr/lib/tar/
|
|||||||
drwxr-xr-x root/root usr/man/
|
drwxr-xr-x root/root usr/man/
|
||||||
drwxr-xr-x root/root usr/man/man1/
|
drwxr-xr-x root/root usr/man/man1/
|
||||||
-rw-r--r-- root/root usr/man/man1/tar.1.gz
|
-rw-r--r-- root/root usr/man/man1/tar.1.gz
|
||||||
|
drwxr-xr-x root/root usr/man/man8/
|
||||||
|
-rw-r--r-- root/root usr/man/man8/rmt.8.gz
|
||||||
|
@ -1,3 +1,4 @@
|
|||||||
|
6a56bc4bb64fc9bb48d28e66a30ad937 rmt.8
|
||||||
3127a182050481f5dd5108a40228adbc tar-1.16-rootp.patch
|
3127a182050481f5dd5108a40228adbc tar-1.16-rootp.patch
|
||||||
d6fe544e834a8f9db6e6c7c2d38ec100 tar-1.16.tar.bz2
|
d6fe544e834a8f9db6e6c7c2d38ec100 tar-1.16.tar.bz2
|
||||||
3f32d11defc901c8487566a1cddae663 tar.1
|
ee376e4ebc14d72d243b4dd4f2b9553d tar.1
|
||||||
|
@ -6,7 +6,7 @@ name=tar
|
|||||||
version=1.16
|
version=1.16
|
||||||
release=1
|
release=1
|
||||||
source=(http://ftp.gnu.org/gnu/$name/$name-$version.tar.bz2 \
|
source=(http://ftp.gnu.org/gnu/$name/$name-$version.tar.bz2 \
|
||||||
$name-$version-rootp.patch tar.1)
|
$name-$version-rootp.patch tar.1 rmt.8)
|
||||||
|
|
||||||
build() {
|
build() {
|
||||||
cd $name-$version
|
cd $name-$version
|
||||||
@ -17,5 +17,6 @@ build() {
|
|||||||
make
|
make
|
||||||
make DESTDIR=$PKG install
|
make DESTDIR=$PKG install
|
||||||
rm -rf $PKG/{sbin,share}
|
rm -rf $PKG/{sbin,share}
|
||||||
install -D -m 644 ../tar.1 $PKG/usr/man/man1/tar.1
|
install -D -m 644 $SRC/tar.1 $PKG/usr/man/man1/tar.1
|
||||||
|
install -D -m 644 $SRC/rmt.8 $PKG/usr/man/man8/rmt.8
|
||||||
}
|
}
|
||||||
|
223
tar/rmt.8
Normal file
223
tar/rmt.8
Normal file
@ -0,0 +1,223 @@
|
|||||||
|
.\" Copyright (c) 1983, 1991, 1993
|
||||||
|
.\" The Regents of the University of California. All rights reserved.
|
||||||
|
.\"
|
||||||
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
.\" modification, are permitted provided that the following conditions
|
||||||
|
.\" are met:
|
||||||
|
.\" 1. Redistributions of source code must retain the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer.
|
||||||
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
|
.\" 3. All advertising materials mentioning features or use of this software
|
||||||
|
.\" must display the following acknowledgement:
|
||||||
|
.\" This product includes software developed by the University of
|
||||||
|
.\" California, Berkeley and its contributors.
|
||||||
|
.\" 4. Neither the name of the University nor the names of its contributors
|
||||||
|
.\" may be used to endorse or promote products derived from this software
|
||||||
|
.\" without specific prior written permission.
|
||||||
|
.\"
|
||||||
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||||
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||||
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||||
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||||
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||||
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||||
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||||
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||||
|
.\" SUCH DAMAGE.
|
||||||
|
.\"
|
||||||
|
.\" @(#)rmt.8 8.2 (Berkeley) 12/11/93
|
||||||
|
.\"
|
||||||
|
.Dd December 11, 1993
|
||||||
|
.Dt RMT 8
|
||||||
|
.Os BSD 4.2
|
||||||
|
.Sh NAME
|
||||||
|
.Nm rmt
|
||||||
|
.Nd remote magtape protocol module
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.Nm rmt
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
.Nm Rmt
|
||||||
|
is a program used by tar, cpio, mt, and the remote dump and restore
|
||||||
|
programs in manipulating a magnetic tape drive through an interprocess
|
||||||
|
communication connection.
|
||||||
|
.Nm Rmt
|
||||||
|
is normally started up with an
|
||||||
|
.Xr rexec 3
|
||||||
|
or
|
||||||
|
.Xr rcmd 3
|
||||||
|
call or the
|
||||||
|
.Xr rsh 1
|
||||||
|
command.
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Nm rmt
|
||||||
|
program accepts requests specific to the manipulation of
|
||||||
|
magnetic tapes, performs the commands, then responds with
|
||||||
|
a status indication. All responses are in
|
||||||
|
.Tn ASCII
|
||||||
|
and in
|
||||||
|
one of two forms.
|
||||||
|
Successful commands have responses of:
|
||||||
|
.Bd -filled -offset indent
|
||||||
|
.Sm off
|
||||||
|
.Sy A Ar number No \en
|
||||||
|
.Sm on
|
||||||
|
.Ed
|
||||||
|
.Pp
|
||||||
|
.Ar Number
|
||||||
|
is an
|
||||||
|
.Tn ASCII
|
||||||
|
representation of a decimal number.
|
||||||
|
Unsuccessful commands are responded to with:
|
||||||
|
.Bd -filled -offset indent
|
||||||
|
.Sm off
|
||||||
|
.Xo Sy E Ar error-number
|
||||||
|
.No \en Ar error-message
|
||||||
|
.No \en
|
||||||
|
.Xc
|
||||||
|
.Sm on
|
||||||
|
.Ed
|
||||||
|
.Pp
|
||||||
|
.Ar Error-number
|
||||||
|
is one of the possible error
|
||||||
|
numbers described in
|
||||||
|
.Xr intro 2
|
||||||
|
and
|
||||||
|
.Ar error-message
|
||||||
|
is the corresponding error string as printed
|
||||||
|
from a call to
|
||||||
|
.Xr perror 3 .
|
||||||
|
The protocol is comprised of the
|
||||||
|
following commands, which are sent as indicated - no spaces are supplied
|
||||||
|
between the command and its arguments, or between its arguments, and
|
||||||
|
.Ql \en
|
||||||
|
indicates that a newline should be supplied:
|
||||||
|
.Bl -tag -width Ds
|
||||||
|
.Sm off
|
||||||
|
.It Xo Sy \&O Ar device
|
||||||
|
.No \en Ar mode No \en
|
||||||
|
.Xc
|
||||||
|
Open the specified
|
||||||
|
.Ar device
|
||||||
|
using the indicated
|
||||||
|
.Ar mode .
|
||||||
|
.Ar Device
|
||||||
|
is a full pathname and
|
||||||
|
.Ar mode
|
||||||
|
is an
|
||||||
|
.Tn ASCII
|
||||||
|
representation of a decimal
|
||||||
|
number suitable for passing to
|
||||||
|
.Xr open 2 .
|
||||||
|
If a device had already been opened, it is
|
||||||
|
closed before a new open is performed.
|
||||||
|
.It Xo Sy C Ar device No \en
|
||||||
|
.Xc
|
||||||
|
Close the currently open device. The
|
||||||
|
.Ar device
|
||||||
|
specified is ignored.
|
||||||
|
.It Xo Sy L
|
||||||
|
.Ar offset No \en
|
||||||
|
.Ar whence No \en
|
||||||
|
.Xc
|
||||||
|
.Sm on
|
||||||
|
Perform an
|
||||||
|
.Xr lseek 2
|
||||||
|
operation using the specified parameters.
|
||||||
|
The response value is that returned from the
|
||||||
|
.Xr lseek
|
||||||
|
call.
|
||||||
|
.Sm off
|
||||||
|
.It Sy W Ar count No \en
|
||||||
|
.Sm on
|
||||||
|
Write data onto the open device.
|
||||||
|
.Nm Rmt
|
||||||
|
reads
|
||||||
|
.Ar count
|
||||||
|
bytes from the connection, aborting if
|
||||||
|
a premature end-of-file is encountered.
|
||||||
|
The response value is that returned from
|
||||||
|
the
|
||||||
|
.Xr write 2
|
||||||
|
call.
|
||||||
|
.Sm off
|
||||||
|
.It Sy R Ar count No \en
|
||||||
|
.Sm on
|
||||||
|
Read
|
||||||
|
.Ar count
|
||||||
|
bytes of data from the open device.
|
||||||
|
If
|
||||||
|
.Ar count
|
||||||
|
exceeds the size of the data buffer (10 kilobytes), it is
|
||||||
|
truncated to the data buffer size.
|
||||||
|
.Nm rmt
|
||||||
|
then performs the requested
|
||||||
|
.Xr read 2
|
||||||
|
and responds with
|
||||||
|
.Sm off
|
||||||
|
.Sy A Ar count-read No \en
|
||||||
|
.Sm on
|
||||||
|
if the read was
|
||||||
|
successful; otherwise an error in the
|
||||||
|
standard format is returned. If the read
|
||||||
|
was successful, the data read is then sent.
|
||||||
|
.Sm off
|
||||||
|
.It Xo Sy I Ar operation
|
||||||
|
.No \en Ar count No \en
|
||||||
|
.Xc
|
||||||
|
.Sm on
|
||||||
|
Perform a
|
||||||
|
.Dv MTIOCOP
|
||||||
|
.Xr ioctl 2
|
||||||
|
command using the specified parameters.
|
||||||
|
The parameters are interpreted as the
|
||||||
|
.Tn ASCII
|
||||||
|
representations of the decimal values
|
||||||
|
to place in the
|
||||||
|
.Ar mt_op
|
||||||
|
and
|
||||||
|
.Ar mt_count
|
||||||
|
fields of the structure used in the
|
||||||
|
.Xr ioctl
|
||||||
|
call. The return value is the
|
||||||
|
.Ar count
|
||||||
|
parameter when the operation is successful.
|
||||||
|
.It Sy S
|
||||||
|
Return the status of the open device, as
|
||||||
|
obtained with a
|
||||||
|
.Dv MTIOCGET
|
||||||
|
.Xr ioctl
|
||||||
|
call. If the operation was successful,
|
||||||
|
an ``ack'' is sent with the size of the
|
||||||
|
status buffer, then the status buffer is
|
||||||
|
sent (in binary).
|
||||||
|
.El
|
||||||
|
.Sm on
|
||||||
|
.Pp
|
||||||
|
Any other command causes
|
||||||
|
.Nm rmt
|
||||||
|
to exit.
|
||||||
|
.Sh DIAGNOSTICS
|
||||||
|
All responses are of the form described above.
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr tar 1 ,
|
||||||
|
.Xr cpio 1 ,
|
||||||
|
.Xr mt 1 ,
|
||||||
|
.Xr rsh 1 ,
|
||||||
|
.Xr rcmd 3 ,
|
||||||
|
.Xr rexec 3 ,
|
||||||
|
.Xr mtio 4 ,
|
||||||
|
.Xr rdump 8 ,
|
||||||
|
.Xr rrestore 8
|
||||||
|
.Sh BUGS
|
||||||
|
People should be discouraged from using this for a remote
|
||||||
|
file access protocol.
|
||||||
|
.Sh HISTORY
|
||||||
|
The
|
||||||
|
.Nm
|
||||||
|
command appeared in
|
||||||
|
.Bx 4.2 .
|
@ -1,15 +0,0 @@
|
|||||||
--- src/extract.c.orig 2005-12-25 23:41:40.820662032 +0100
|
|
||||||
+++ src/extract.c 2005-12-25 23:42:56.056224488 +0100
|
|
||||||
@@ -112,8 +112,10 @@ void
|
|
||||||
extr_init (void)
|
|
||||||
{
|
|
||||||
we_are_root = geteuid () == 0;
|
|
||||||
- same_permissions_option += we_are_root;
|
|
||||||
- same_owner_option += we_are_root;
|
|
||||||
+
|
|
||||||
+ /* Don't keep permissions by default if we are root. */
|
|
||||||
+ /* same_permissions_option += we_are_root; */
|
|
||||||
+ /* same_owner_option += we_are_root; */
|
|
||||||
|
|
||||||
/* Save 'root device' to avoid purging mount points.
|
|
||||||
FIXME: Should the same be done after handling -C option ? */
|
|
@ -1,26 +0,0 @@
|
|||||||
Submitted By: Jim Gifford (patches at jg555 dot com)
|
|
||||||
Date: 2005-03-19
|
|
||||||
Initial Package Version: 1.15.1
|
|
||||||
Origin: Tar Bug Reports List
|
|
||||||
Upstream Status: Applied
|
|
||||||
Description: Fixes large file corruptions using option -S
|
|
||||||
http://lists.gnu.org/archive/html/bug-tar/2005-03/msg00004.html
|
|
||||||
--- tar-1.15.1/src/sparse.c.orig 2005-03-20 04:23:34.144506120 +0000
|
|
||||||
+++ tar-1.15.1/src/sparse.c 2005-03-20 04:23:56.842055568 +0000
|
|
||||||
@@ -1,6 +1,6 @@
|
|
||||||
/* Functions for dealing with sparse files
|
|
||||||
|
|
||||||
- Copyright (C) 2003, 2004 Free Software Foundation, Inc.
|
|
||||||
+ Copyright (C) 2003, 2004, 2005 Free Software Foundation, Inc.
|
|
||||||
|
|
||||||
This program is free software; you can redistribute it and/or modify it
|
|
||||||
under the terms of the GNU General Public License as published by the
|
|
||||||
@@ -182,7 +182,7 @@
|
|
||||||
{
|
|
||||||
static char buffer[BLOCKSIZE];
|
|
||||||
size_t count;
|
|
||||||
- size_t offset = 0;
|
|
||||||
+ off_t offset = 0;
|
|
||||||
struct sp_array sp = {0, 0};
|
|
||||||
|
|
||||||
if (!lseek_or_error (file, 0, SEEK_SET))
|
|
404
tar/tar.1
404
tar/tar.1
@ -1,5 +1,5 @@
|
|||||||
.\" @(#)tar.1 1.11.1 93/19/22 PJV;
|
.\" @(#)tar.1 1.11.1 93/19/22 PJV;
|
||||||
.TH TAR 1 "22 September 1993"
|
.TH TAR 1 "15 May 2006"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
tar \- The GNU version of the tar archiving utility
|
tar \- The GNU version of the tar archiving utility
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
@ -7,146 +7,9 @@ tar \- The GNU version of the tar archiving utility
|
|||||||
[
|
[
|
||||||
.B \-
|
.B \-
|
||||||
]
|
]
|
||||||
.B A --catenate --concatenate \||\| c --create \||\| d --diff --compare \||\| r --append \||\| t --list \||\| u --update \||\| x -extract --get
|
.B A \-\-catenate \-\-concatenate \||\| c \-\-create \||\| d \-\-diff \-\-compare \||\| \-\-delete \||\| r \-\-append \||\| t \-\-list \||\| u \-\-update \||\| x \-\-extract \-\-get
|
||||||
[
|
.I [ options ]
|
||||||
.B --atime-preserve
|
.I pathname [ pathname ... ]
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -b, --block-size N
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -B, --read-full-blocks
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -C, --directory DIR
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --checkpoint
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -f, --file [HOSTNAME:]F
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --force-local
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -F, --info-script F --new-volume-script F
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -G, --incremental
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -g, --listed-incremental F
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -h, --dereference
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -i, --ignore-zeros
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --ignore-failed-read
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -k, --keep-old-files
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -K, --starting-file F
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -l, --one-file-system
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -L, --tape-length N
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -m, --modification-time
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -M, --multi-volume
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -N, --after-date DATE, --newer DATE
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -o, --old-archive, --portability
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -O, --to-stdout
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -p, --same-permissions, --preserve-permissions
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -P, --absolute-paths
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --preserve
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -R, --record-number
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --remove-files
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -s, --same-order, --preserve-order
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --same-owner
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -S, --sparse
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -T, --files-from F
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --null
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --totals
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -v, --verbose
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -V, --label NAME
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --version
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -w, --interactive, --confirmation
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -W, --verify
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --exclude FILE
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -X, --exclude-from FILE
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -Z, --compress, --uncompress
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -z, --gzip, --ungzip
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --use-compress-program PROG
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B --block-compress
|
|
||||||
]
|
|
||||||
[
|
|
||||||
.B -[0-7][lmh]
|
|
||||||
]
|
|
||||||
.TP
|
|
||||||
.I filename1 [ filename2, ... filenameN ]
|
|
||||||
.TP
|
|
||||||
.I directory1 [ directory2, ...directoryN ]
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.LP
|
.LP
|
||||||
This manual page documents the GNU version of
|
This manual page documents the GNU version of
|
||||||
@ -170,166 +33,281 @@ The final arguments to
|
|||||||
are the names of the files or directories which should be archived. The use
|
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
|
of a directory name always implies that the subdirectories below should be
|
||||||
included in the archive.
|
included in the archive.
|
||||||
|
.SH EXAMPLES
|
||||||
|
.TP
|
||||||
|
.B tar \-xvvf foo.tar
|
||||||
|
extract foo.tar
|
||||||
|
.TP
|
||||||
|
.B tar \-xvvzf foo.tar.gz
|
||||||
|
extract gzipped foo.tar.gz
|
||||||
|
.TP
|
||||||
|
.B tar \-cvvf foo.tar foo/
|
||||||
|
tar contents of folder foo in foo.tar
|
||||||
.SH "FUNCTION LETTERS"
|
.SH "FUNCTION LETTERS"
|
||||||
.TP
|
.TP
|
||||||
.B One of the following options must be used:
|
.B One of the following options must be used:
|
||||||
.TP
|
.TP
|
||||||
.B -A, --catenate, --concatenate
|
.B \-A, \-\-catenate, \-\-concatenate
|
||||||
append tar files to an archive
|
append tar files to an archive
|
||||||
.TP
|
.TP
|
||||||
.B -c, --create
|
.B \-c, \-\-create
|
||||||
create a new archive
|
create a new archive
|
||||||
.TP
|
.TP
|
||||||
.B -d, --diff, --compare
|
.B \-d, \-\-diff, \-\-compare
|
||||||
find differences between archive and file system
|
find differences between archive and file system
|
||||||
.TP
|
.TP
|
||||||
.B --delete
|
.B \-\-delete
|
||||||
delete from the archive (not for use on mag tapes!)
|
delete from the archive (not for use on mag tapes!)
|
||||||
.TP
|
.TP
|
||||||
.B -r, --append
|
.B \-r, \-\-append
|
||||||
append files to the end of an archive
|
append files to the end of an archive
|
||||||
.TP
|
.TP
|
||||||
.B -t, --list
|
.B \-t, \-\-list
|
||||||
list the contents of an archive
|
list the contents of an archive
|
||||||
.TP
|
.TP
|
||||||
.B -u, --update
|
.B \-u, \-\-update
|
||||||
only append files that are newer than copy in archive
|
only append files that are newer than copy in archive
|
||||||
.TP
|
.TP
|
||||||
.B -x, --extract, --get
|
.B \-x, \-\-extract, \-\-get
|
||||||
extract files from an archive
|
extract files from an archive
|
||||||
.SH "OTHER OPTIONS"
|
.SH "OTHER OPTIONS"
|
||||||
.TP
|
.TP
|
||||||
.B --atime-preserve
|
.B \-\-anchored
|
||||||
|
force exclusion patterns to match initial subsequences
|
||||||
|
.TP
|
||||||
|
.B \-\-atime\-preserve
|
||||||
don't change access times on dumped files
|
don't change access times on dumped files
|
||||||
.TP
|
.TP
|
||||||
.B -b, --block-size N
|
.B \-b, \-\-blocking\-factor N
|
||||||
block size of Nx512 bytes (default N=20)
|
use record size of Nx512 bytes (default N=20)
|
||||||
.TP
|
.TP
|
||||||
.B -B, --read-full-blocks
|
.B \-B, \-\-read\-full\-records
|
||||||
reblock as we read (for reading 4.2BSD pipes)
|
reblock as we read (for reading 4.2BSD pipes)
|
||||||
|
.TP
|
||||||
|
.B \-\-backup [TYPE]
|
||||||
|
back up files instead of overwriting (TYPE=numbered, existing, simple)
|
||||||
.TP
|
.TP
|
||||||
.B -C, --directory DIR
|
.B \-C, \-\-directory DIR
|
||||||
change to directory DIR
|
change to directory DIR
|
||||||
.TP
|
.TP
|
||||||
.B --checkpoint
|
.B \-\-checkpoint
|
||||||
print directory names while reading the archive
|
print periodic checkpoints
|
||||||
.TP
|
.TP
|
||||||
.B -f, --file [HOSTNAME:]F
|
.B \-\-exclude=PATTERN
|
||||||
use archive file or device F (default /dev/rmt0)
|
exclude files matching PATTERN
|
||||||
.TP
|
.TP
|
||||||
.B --force-local
|
.B \-f, \-\-file [HOSTNAME:]F
|
||||||
archive file is local even if has a colon
|
use archive file or device F (default "\-", meaning stdin/stdout)
|
||||||
.TP
|
.TP
|
||||||
.B -F, --info-script F --new-volume-script F
|
.B \-F, \-\-info\-script F, \-\-new\-volume\-script F
|
||||||
run script at end of each tape (implies -M)
|
run script at end of each tape (implies \-M)
|
||||||
.TP
|
.TP
|
||||||
.B -G, --incremental
|
.B \-\-force\-local
|
||||||
|
archive file is local even if it has a colon
|
||||||
|
.TP
|
||||||
|
.B \-G, \-\-incremental
|
||||||
create/list/extract old GNU-format incremental backup
|
create/list/extract old GNU-format incremental backup
|
||||||
.TP
|
.TP
|
||||||
.B -g, --listed-incremental F
|
.B \-g, \-\-listed\-incremental F
|
||||||
create/list/extract new GNU-format incremental backup
|
create/list/extract new GNU-format incremental backup
|
||||||
|
.TP
|
||||||
|
.B \-\-group G
|
||||||
|
set group to G while adding files
|
||||||
.TP
|
.TP
|
||||||
.B -h, --dereference
|
.B \-h, \-\-dereference
|
||||||
don't dump symlinks; dump the files they point to
|
don't dump symlinks; dump the files they point to
|
||||||
.TP
|
.TP
|
||||||
.B -i, --ignore-zeros
|
.B \-\-help
|
||||||
|
print help message
|
||||||
|
.TP
|
||||||
|
.B \-i, \-\-ignore\-zeros
|
||||||
ignore blocks of zeros in archive (normally mean EOF)
|
ignore blocks of zeros in archive (normally mean EOF)
|
||||||
.TP
|
.TP
|
||||||
.B --ignore-failed-read
|
.B \-\-ignore\-case
|
||||||
|
ignore case when excluding files
|
||||||
|
.TP
|
||||||
|
.B \-\-ignore\-failed\-read
|
||||||
don't exit with non-zero status on unreadable files
|
don't exit with non-zero status on unreadable files
|
||||||
.TP
|
.TP
|
||||||
.B -k, --keep-old-files
|
.B \-j, \-\-bzip2
|
||||||
|
filter archive through bzip2, use to decompress .bz2 files.
|
||||||
|
WARNING: some previous versions of tar used option \-I to
|
||||||
|
filter through bzip2. When writing scripts, use \-\-bzip2
|
||||||
|
instead of \-j so that both older and newer tar versions
|
||||||
|
will work.
|
||||||
|
.TP
|
||||||
|
.B \-k, \-\-keep\-old\-files
|
||||||
keep existing files; don't overwrite them from archive
|
keep existing files; don't overwrite them from archive
|
||||||
.TP
|
.TP
|
||||||
.B -K, --starting-file F
|
.B \-K, \-\-starting\-file F
|
||||||
begin at file F in the archive
|
begin at file F in the archive
|
||||||
.TP
|
.TP
|
||||||
.B -l, --one-file-system
|
.B \-l, \-\-one\-file\-system
|
||||||
stay in local file system when creating an archive
|
stay in local file system when creating an archive
|
||||||
.TP
|
.TP
|
||||||
.B -L, --tape-length N
|
.B \-L, \-\-tape\-length N
|
||||||
change tapes after writing N*1024 bytes
|
change tapes after writing N*1024 bytes
|
||||||
.TP
|
.TP
|
||||||
.B -m, --modification-time
|
.B \-m, \-\-touch
|
||||||
don't extract file modified time
|
don't extract file modified time
|
||||||
.TP
|
.TP
|
||||||
.B -M, --multi-volume
|
.B \-M, \-\-multi\-volume
|
||||||
create/list/extract multi-volume archive
|
create/list/extract multi-volume archive
|
||||||
.TP
|
.TP
|
||||||
.B -N, --after-date DATE, --newer DATE
|
.B \-\-mode M
|
||||||
|
set permissions to M while adding files
|
||||||
|
.TP
|
||||||
|
.B \-N, \-\-after\-date DATE, \-\-newer DATE
|
||||||
only store files newer than DATE
|
only store files newer than DATE
|
||||||
.TP
|
.TP
|
||||||
.B -o, --old-archive, --portability
|
.B \-\-newer\-mtime DATE
|
||||||
|
only store files whose contents have changed after DATE
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-anchored
|
||||||
|
allow exclusion patterns to match any substring (the default)
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-ignore\-case
|
||||||
|
match patterns case sensitively (the default)
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-recursion
|
||||||
|
do not recurse into subdirectories
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-same\-owner
|
||||||
|
extract files with owner set to current user (the default for non-root
|
||||||
|
users)
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-same\-permissions
|
||||||
|
apply umask to extracted files (the default for non-root users)
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-wildcards
|
||||||
|
do not use wildcards when excluding files
|
||||||
|
.TP
|
||||||
|
.B \-\-no\-wildcards\-match\-slash
|
||||||
|
don't let wildcards match "/" when excluding files
|
||||||
|
.TP
|
||||||
|
.B \-\-null
|
||||||
|
for \-T, use "NUL" instead of newline as filename terminator
|
||||||
|
.TP
|
||||||
|
.B \-\-numeric\-owner
|
||||||
|
always use numbers for user/group names
|
||||||
|
.TP
|
||||||
|
.B \-o, \-\-old\-archive, \-\-portability
|
||||||
write a V7 format archive, rather than ANSI format
|
write a V7 format archive, rather than ANSI format
|
||||||
.TP
|
.TP
|
||||||
.B -O, --to-stdout
|
.B \-\-owner O
|
||||||
|
set owner to O while adding files
|
||||||
|
.TP
|
||||||
|
.B \-O, \-\-to\-stdout
|
||||||
extract files to standard output
|
extract files to standard output
|
||||||
.TP
|
.TP
|
||||||
.B -p, --same-permissions, --preserve-permissions
|
.B \-p, \-\-same\-permissions, \-\-preserve\-permissions
|
||||||
extract all protection information
|
ignore umask when extracting files (the default for root)
|
||||||
.TP
|
.TP
|
||||||
.B -P, --absolute-paths
|
.B \-P, \-\-absolute\-names
|
||||||
don't strip leading `/'s from file names
|
don't strip leading `/'s from file names
|
||||||
.TP
|
.TP
|
||||||
.B --preserve
|
.B \-\-posix
|
||||||
like -p -s
|
create POSIX compliant archive
|
||||||
.TP
|
.TP
|
||||||
.B -R, --record-number
|
.B \-\-preserve
|
||||||
show record number within archive with each message
|
like \-p \-s
|
||||||
|
.TP
|
||||||
|
.B \-R, \-\-block\-number
|
||||||
|
show block number within archive with each message
|
||||||
|
.TP
|
||||||
|
.B \-\-record\-size SIZE
|
||||||
|
use SIZE bytes per record
|
||||||
|
.TP
|
||||||
|
.B \-\-recursion
|
||||||
|
recurse into directories (the default)
|
||||||
|
.TP
|
||||||
|
.B \-\-recursive\-unlink
|
||||||
|
remove existing directories before extracting directories of the same
|
||||||
|
name
|
||||||
.TP
|
.TP
|
||||||
.B --remove-files
|
.B \-\-remove\-files
|
||||||
remove files after adding them to the archive
|
remove files after adding them to the archive
|
||||||
.TP
|
.TP
|
||||||
.B -s, --same-order, --preserve-order
|
.B \-\-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.
|
||||||
|
.TP
|
||||||
|
.B \-S, \-\-sparse
|
||||||
|
handle sparse files efficiently
|
||||||
|
.TP
|
||||||
|
.B \-s, \-\-same\-order, \-\-preserve\-order
|
||||||
list of names to extract is sorted to match archive
|
list of names to extract is sorted to match archive
|
||||||
.TP
|
.TP
|
||||||
.B --same-owner
|
.B \-\-same\-owner
|
||||||
create extracted files with the same ownership
|
extract files with owner as specified in archive (the default for
|
||||||
|
root)
|
||||||
.TP
|
.TP
|
||||||
.B -S, --sparse
|
.B \-\-show\-omitted\-dirs
|
||||||
handle sparse files efficiently
|
mention directories that are being skipped over
|
||||||
|
.TP
|
||||||
|
.B \-\-suffix SUFFIX
|
||||||
|
append SUFFIX to make backup files (default ~)
|
||||||
.TP
|
.TP
|
||||||
.B -T, --files-from F
|
.B \-T, \-\-files\-from F
|
||||||
get names to extract or create from file F
|
get names to extract or archive from file F
|
||||||
.TP
|
.TP
|
||||||
.B --null
|
.B \-\-totals
|
||||||
-T reads null-terminated names, disable -C
|
display total bytes written after creating an archive
|
||||||
.TP
|
.TP
|
||||||
.B --totals
|
.B \-U, \-\-unlink\-first
|
||||||
print total bytes written with --create
|
unlink & recreate files instead of overwriting
|
||||||
.TP
|
.TP
|
||||||
.B -v, --verbose
|
.B \-\-use\-compress\-program PROG
|
||||||
|
filter the archive through PROG (which must accept \-d)
|
||||||
|
.TP
|
||||||
|
.B \-v, \-\-verbose
|
||||||
verbosely list files processed
|
verbosely list files processed
|
||||||
.TP
|
.TP
|
||||||
.B -V, --label NAME
|
.B \-V, \-\-label NAME
|
||||||
create archive with volume name NAME
|
create archive with volume name NAME
|
||||||
.TP
|
.TP
|
||||||
.B --version
|
.B \-\-version
|
||||||
print tar program version number
|
print tar program version number
|
||||||
.TP
|
.TP
|
||||||
.B -w, --interactive, --confirmation
|
.B \-\-volno\-file F
|
||||||
|
keep track of current volume (of a multi-volume archive) in F
|
||||||
|
.TP
|
||||||
|
.B \-w, \-\-interactive, \-\-confirmation
|
||||||
ask for confirmation for every action
|
ask for confirmation for every action
|
||||||
.TP
|
.TP
|
||||||
.B -W, --verify
|
.B \-W, \-\-verify
|
||||||
attempt to verify the archive after writing it
|
attempt to verify the archive after writing it
|
||||||
.TP
|
.TP
|
||||||
.B --exclude FILE
|
.B \-\-wildcards
|
||||||
exclude file FILE
|
use wildcards when excluding files (the default)
|
||||||
.TP
|
.TP
|
||||||
.B -X, --exclude-from FILE
|
.B \-\-wildcards\-match\-slash
|
||||||
exclude files listed in FILE
|
allow wildcards to match "/" (the default)
|
||||||
.TP
|
.TP
|
||||||
.B -Z, --compress, --uncompress
|
.B \-X, \-\-exclude\-from=FILE
|
||||||
|
exclude files matching patterns listed in FILE
|
||||||
|
.TP
|
||||||
|
.B \-Z, \-\-compress, \-\-uncompress
|
||||||
filter the archive through compress
|
filter the archive through compress
|
||||||
.TP
|
.TP
|
||||||
.B -z, --gzip, --ungzip
|
.B \-z, \-\-gzip, \-\-gunzip, \-\-ungzip
|
||||||
filter the archive through gzip
|
filter the archive through gzip
|
||||||
.TP
|
.TP
|
||||||
.B --use-compress-program PROG
|
.B \-[0\-7][lmh]
|
||||||
filter the archive through PROG (which must accept -d)
|
|
||||||
.TP
|
|
||||||
.B --block-compress
|
|
||||||
block the output of compression program for tapes
|
|
||||||
.TP
|
|
||||||
.B -[0-7][lmh]
|
|
||||||
specify drive and density
|
specify drive and density
|
||||||
|
.SH BUGS
|
||||||
|
.LP
|
||||||
|
The GNU folks, in general, abhor man pages, and create info documents instead.
|
||||||
|
Unfortunately, the info document describing tar is licensed under the GFDL with
|
||||||
|
invariant cover texts, which violates the Debian Free Software Guidelines. As
|
||||||
|
a result, the info documentation for tar is not included in the Debian package.
|
||||||
|
|
||||||
|
If you want to read the complete documentation for GNU tar, please refer to
|
||||||
|
the online version at <http://www.gnu.org/software/tar/manual/index.html>.
|
||||||
|
|
||||||
|
This man page was created for the Debian distribution. It does not describe
|
||||||
|
all of the functionality of tar, and it is often out of date. Patches to
|
||||||
|
improve the coverage and/or accuracy of this man page are appreciated, and
|
||||||
|
should be filed as wishlist severity bugs against the Debian tar package,
|
||||||
|
not submitted to the GNU tar maintainers.
|
||||||
|
Loading…
Reference in New Issue
Block a user