1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335
|
. \" @(#)gnutar.1 1.3 04/09/26 Copyr 2004 J. Schilling
. \" Manual Seite fuer gnutar
. \"
.if t .ds a \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'a
.if t .ds o \v'-0.55m'\h'0.00n'\z.\h'0.45n'\z.\v'0.55m'\h'-0.45n'o
.if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u
.if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A
.if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O
.if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.75n'U
.if t .ds s \\(*b
.if t .ds S SS
.if n .ds a ae
.if n .ds o oe
.if n .ds u ue
.if n .ds s sz
.TH GNUTAR 1 "04/09/26" "J\*org Schilling" "Schily\'s USER COMMANDS"
.SH NAME
gnutar \- emulates the GNU version of the tar archiver
.SH SYNOPSIS
.B "gnutar\ "
.I command
[
.I options
]
.I file1 .\|.\|. filen
.SH DESCRIPTION
.PP
This manual page documents the GNU version of
.BR tar ,
an archiving program designed to store and extract files from
an archive file known as a
.IR tarfile.
A
.IR tarfile
may be made on a tape drive, however, it is also common
to write a
.IR tarfile
to a normal file.
The first argument to
.B gnutar
must be one of the options:
.BR Acdrtux ,
followed by any optional functions.
The final arguments to
.B gnutar
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
included in the archive.
.SH COMMAND
.TP
.B "One of the following commands must be used:
.TP
.BR \-A ", " \-\-catenate ", " \-\-concatenate
append tar files to an archive
.TP
.BR \-c ", " \-\-create
create a new archive
.TP
.BR \-d ", " \-\-diff ", " \-\-compare
find differences between archive and file system
.TP
.B \-\-delete
delete from the archive (not for use on mag tapes!)
.TP
.BR \-r ", " \-\-append
append files to the end of an archive
.TP
.BR \-t ", " \-\-list
list the contents of an archive
.TP
.BR \-u ", " \-\-update
only append files that are newer than copy in archive
.TP
.BR \-x ", " \-\-extract ", " \-\-get
extract files from an archive
.SH OPTIONS
.TP
.B \-\-atime\-preserve
don't change access times on dumped files
.TP
.BR \-b ", " \-\-block\-size " N
block size of Nx512 bytes (default N=20)
.TP
.BR \-B ", " \-\-read\-full\-blocks
reblock as we read (for reading 4.2BSD pipes)
.TP
.BR \-C ", " \-\-directory " DIR
change to directory DIR
.TP
.B \-\-checkpoint
print directory names while reading the archive
.TP
.BR \-f ", " \-\-file " [HOSTNAME:]F
use archive file or device F (default /dev/rmt0)
.TP
.B \-\-force\-local
archive file is local even if has a colon
.TP
.BR \-F ", " \-\-info\-script " F, " \-\-new\-volume\-script " F
run script at end of each tape (implies \-M)
.TP
.BR \-G ", " \-\-incremental
create/list/extract old GNU-format incremental backup
.TP
.BR \-g ", " \-\-listed\-incremental " F
create/list/extract new GNU-format incremental backup
.TP
.BR \-h ", " \-\-dereference
don't dump symlinks; dump the files they point to
.TP
.BR \-i ", " \-\-ignore\-zeros
ignore blocks of zeros in archive (normally mean EOF)
.TP
.BR \-j ", " \-\-bzip
filter the archive through bzip2.
.TP
.B \-\-ignore\-failed\-read
don't exit with non-zero status on unreadable files
.TP
.BR \-k ", " \-\-keep\-old\-files
keep existing files; don't overwrite them from archive
.TP
.BR \-K ", " \-\-starting\-file " F
begin at file F in the archive
.TP
.BR \-l ", " \-\-one\-file\-system
stay in local file system when creating an archive
.TP
.BR \-L ", " \-\-tape\-length " N
change tapes after writing N*1024 bytes
.TP
.BR \-m ", " \-\-modification\-time
don't extract file modified time
.TP
.BR \-M ", " \-\-multi\-volume
create/list/extract multi-volume archive
.TP
.BR \-N ", " \-\-after\-date " DATE, " \-\-newer " DATE
only store files newer than DATE
.TP
.BR \-o ", " \-\-old\-archive ", " \-\-portability
write a V7 format archive, rather than ANSI format
.TP
.BR \-O ", " \-\-to\-stdout
extract files to standard output
.TP
.BR \-p ", " \-\-same\-permissions ", " \-\-preserve\-permissions
extract all protection information
.TP
.BR \-P ", " \-\-absolute\-paths
don't strip leading `/'s from file names
.TP
.B \-\-preserve
like
.BR "\-p \-s" .
.TP
.BR \-R ", " \-\-record\-number
show record number within archive with each message
.TP
.B \-\-remove\-files
remove files after adding them to the archive
.TP
.BR \-s ", " \-\-same\-order ", " \-\-preserve\-order
list of names to extract is sorted to match archive
.TP
.B \-\-same\-owner
create extracted files with the same ownership
.TP
.BR \-S ", " \-\-sparse
handle sparse files efficiently
.TP
.BR \-T ", " \-\-files\-from= " F
get names to extract or create from file F
.TP
.B \-\-null
\-T reads null-terminated names, disable \-C
.TP
.B \-\-totals
print total bytes written with \-\-create
.TP
.BR \-v ", " \-\-verbose
verbosely list files processed
.TP
.BR \-V ", " \-\-label " NAME
create archive with volume name NAME
.TP
.B \-\-version
print
.B gnutar
program version number
.TP
.BR \-w ", " \-\-interactive ", " \-\-confirmation
ask for confirmation for every action
.TP
.BR \-W ", " \-\-verify
attempt to verify the archive after writing it
.TP
.BI \-\-exclude " FILE
exclude file FILE
.TP
.BR \-X ", " \-\-exclude\-from " FILE
exclude files listed in FILE
.TP
.BR \-Z ", " \-\-compress ", " \-\-uncompress
filter the archive through compress
.TP
.BR \-z ", " \-\-gzip ", " \-\-ungzip
filter the archive through gzip
.TP
.BI \-\-use\-compress\-program " PROG
filter the archive through PROG (which must accept \-d)
.SH "EXTENDED OPTIONS
.PP
The extended options are options taken from
.BR star .
.TP
.B \-\-help
Prints a summary of the most important options for
.BR gnutar (1)
and exits.
.TP
.B \-\-xhelp
Prints a summary of the less important options for
.BR gnutar (1)
and exits.
.TP
.B \-\-version
Prints the
.B gnutar
version number string and exists.
.TP
.B \-\-debug
print additional debug messages
.TP
.BI xdebug= #
.TP
.BI xd= #
set extended debug level
.TP
.B \-/
don't strip leading '/'s from file names
.TP
.B \-..
don't skip filenames that contain '..' in non-interactive extract
.TP
.B \-\-secure\-links
don't extract links that start with '/' or contain '..'
.TP
.B \-\-acl
handle access control lists
.TP
.B \-\-xfflags
handle extended file flags
.TP
.BI bs= #
set (output) block size to #
.TP
.BI fs= #
set fifo size to #
.TP
.B \-\-no\-fsync
do not call fsync() for each extracted file (may be dangerous)
.TP
.B \-\-time
print timing info
.TP
.B \-\-no\-statistics
do not print statistics
.TP
.B \-\-fifostats
print fifo statistics
.TP
.B \-\-no\-fifo
don't use a fifo to optimize data flow from/to tape
.TP
.B \-\-numeric
don't use user/group name from tape
.PP
The options above are not defined by GNU tar.
.PP
For a complete documentation of the
.B star
based optione check
.BR star (1).
.SH EXAMPLES
.SH ENVIRONMENT
.SH FILES
.SH "SEE ALSO"
.BR spax (1),
.BR suntar (1),
.BR scpio (1),
.BR tar (1),
.BR cpio (1),
.BR pax (1),
.BR rcp (1),
.BR mt (1),
.BR rmt (1),
.BR match (1),
.BR dd (1),
.BR sdd (1),
.BR rsh (1),
.BR ssh (1),
.BR star (1),
.BR star (4/5),
.BR rcmd (3),
.BR fssnap (1m)
.SH DIAGNOSTICS
.SH NOTES
.PP
This
.B gnutar
implementation is based on the
.B star
implementation and does not implement all features of the original GNU tar
program.
.SH BUGS
.SH AUTHOR
.nf
J\*org Schilling
Seestr. 110
D\-13353 Berlin
Germany
.fi
.PP
Mail bugs and suggestions to:
.PP
.B
schilling@fokus.fraunhofer.de
or
.B
js@cs.tu\-berlin.de
or
.B
joerg@schily.isdn.cs.tu\-berlin.de
|