[ce3a096] | 1 | Submitted By: Jim Gifford (jim at cross-lfs dot org) |
---|
[2bfaabe] | 2 | Date: 2009-03-06 |
---|
| 3 | Initial Package Version: 1.22 |
---|
[ce3a096] | 4 | Origin: Debian |
---|
| 5 | Upstream Status: N/A |
---|
| 6 | Description: This Patch adds and man-page to TAR. This has been |
---|
| 7 | added as per numerous requests. |
---|
| 8 | |
---|
[2bfaabe] | 9 | diff -Naur tar-1.22.orig/doc/Makefile.am tar-1.22/doc/Makefile.am |
---|
| 10 | --- tar-1.22.orig/doc/Makefile.am 2008-04-14 05:03:12.000000000 -0700 |
---|
| 11 | +++ tar-1.22/doc/Makefile.am 2009-03-05 20:50:20.245637658 -0800 |
---|
[ce3a096] | 12 | @@ -17,6 +17,8 @@ |
---|
| 13 | ## along with this program; if not, write to the Free Software Foundation, |
---|
| 14 | ## Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. |
---|
| 15 | |
---|
| 16 | +man_MANS = tar.1 |
---|
| 17 | + |
---|
| 18 | info_TEXINFOS = tar.texi |
---|
| 19 | tar_TEXINFOS = \ |
---|
| 20 | dumpdir.texi\ |
---|
[2bfaabe] | 21 | diff -Naur tar-1.22.orig/doc/Makefile.in tar-1.22/doc/Makefile.in |
---|
| 22 | --- tar-1.22.orig/doc/Makefile.in 2009-03-04 23:05:25.000000000 -0800 |
---|
| 23 | +++ tar-1.22/doc/Makefile.in 2009-03-05 20:50:20.245637658 -0800 |
---|
| 24 | @@ -146,13 +146,16 @@ |
---|
[ce3a096] | 25 | MAKEINFOHTML = $(MAKEINFO) --html |
---|
| 26 | AM_MAKEINFOHTMLFLAGS = $(AM_MAKEINFOFLAGS) |
---|
| 27 | DVIPS = dvips |
---|
| 28 | -am__installdirs = "$(DESTDIR)$(infodir)" |
---|
| 29 | +am__installdirs = "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)" |
---|
| 30 | am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; |
---|
| 31 | am__vpath_adj = case $$p in \ |
---|
| 32 | $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ |
---|
| 33 | *) f=$$p;; \ |
---|
| 34 | esac; |
---|
| 35 | am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; |
---|
| 36 | +man1dir = $(mandir)/man1 |
---|
| 37 | +NROFF = nroff |
---|
| 38 | +MANS = $(man_MANS) |
---|
| 39 | DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) |
---|
| 40 | ACLOCAL = @ACLOCAL@ |
---|
| 41 | ALLOCA = @ALLOCA@ |
---|
[2bfaabe] | 42 | @@ -645,6 +648,7 @@ |
---|
[ce3a096] | 43 | target_alias = @target_alias@ |
---|
| 44 | top_builddir = @top_builddir@ |
---|
| 45 | top_srcdir = @top_srcdir@ |
---|
| 46 | +man_MANS = tar.1 |
---|
| 47 | info_TEXINFOS = tar.texi |
---|
| 48 | tar_TEXINFOS = \ |
---|
| 49 | dumpdir.texi\ |
---|
[2bfaabe] | 50 | @@ -858,6 +862,51 @@ |
---|
[ce3a096] | 51 | echo " rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]"; \ |
---|
| 52 | rm -f $$i $$i-[0-9] $$i-[0-9][0-9] $$i_i[0-9] $$i_i[0-9][0-9]; \ |
---|
| 53 | done |
---|
| 54 | +install-man1: $(man1_MANS) $(man_MANS) |
---|
| 55 | + @$(NORMAL_INSTALL) |
---|
| 56 | + test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" |
---|
| 57 | + @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ |
---|
| 58 | + l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ |
---|
| 59 | + for i in $$l2; do \ |
---|
| 60 | + case "$$i" in \ |
---|
| 61 | + *.1*) list="$$list $$i" ;; \ |
---|
| 62 | + esac; \ |
---|
| 63 | + done; \ |
---|
| 64 | + for i in $$list; do \ |
---|
| 65 | + if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ |
---|
| 66 | + else file=$$i; fi; \ |
---|
| 67 | + ext=`echo $$i | sed -e 's/^.*\\.//'`; \ |
---|
| 68 | + case "$$ext" in \ |
---|
| 69 | + 1*) ;; \ |
---|
| 70 | + *) ext='1' ;; \ |
---|
| 71 | + esac; \ |
---|
| 72 | + inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ |
---|
| 73 | + inst=`echo $$inst | sed -e 's/^.*\///'`; \ |
---|
| 74 | + inst=`echo $$inst | sed '$(transform)'`.$$ext; \ |
---|
| 75 | + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ |
---|
| 76 | + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst"; \ |
---|
| 77 | + done |
---|
| 78 | +uninstall-man1: |
---|
| 79 | + @$(NORMAL_UNINSTALL) |
---|
| 80 | + @list='$(man1_MANS) $(dist_man1_MANS) $(nodist_man1_MANS)'; \ |
---|
| 81 | + l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ |
---|
| 82 | + for i in $$l2; do \ |
---|
| 83 | + case "$$i" in \ |
---|
| 84 | + *.1*) list="$$list $$i" ;; \ |
---|
| 85 | + esac; \ |
---|
| 86 | + done; \ |
---|
| 87 | + for i in $$list; do \ |
---|
| 88 | + ext=`echo $$i | sed -e 's/^.*\\.//'`; \ |
---|
| 89 | + case "$$ext" in \ |
---|
| 90 | + 1*) ;; \ |
---|
| 91 | + *) ext='1' ;; \ |
---|
| 92 | + esac; \ |
---|
| 93 | + inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ |
---|
| 94 | + inst=`echo $$inst | sed -e 's/^.*\///'`; \ |
---|
| 95 | + inst=`echo $$inst | sed '$(transform)'`.$$ext; \ |
---|
| 96 | + echo " rm -f '$(DESTDIR)$(man1dir)/$$inst'"; \ |
---|
| 97 | + rm -f "$(DESTDIR)$(man1dir)/$$inst"; \ |
---|
| 98 | + done |
---|
| 99 | tags: TAGS |
---|
| 100 | TAGS: |
---|
| 101 | |
---|
[2bfaabe] | 102 | @@ -896,9 +945,9 @@ |
---|
[ce3a096] | 103 | dist-info |
---|
| 104 | check-am: all-am |
---|
| 105 | check: check-am |
---|
| 106 | -all-am: Makefile $(INFO_DEPS) |
---|
| 107 | +all-am: Makefile $(INFO_DEPS) $(MANS) |
---|
| 108 | installdirs: |
---|
| 109 | - for dir in "$(DESTDIR)$(infodir)"; do \ |
---|
| 110 | + for dir in "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)"; do \ |
---|
| 111 | test -z "$$dir" || $(MKDIR_P) "$$dir"; \ |
---|
| 112 | done |
---|
| 113 | install: install-am |
---|
[2bfaabe] | 114 | @@ -945,7 +994,7 @@ |
---|
[ce3a096] | 115 | |
---|
| 116 | info-am: $(INFO_DEPS) |
---|
| 117 | |
---|
| 118 | -install-data-am: install-info-am |
---|
| 119 | +install-data-am: install-info-am install-man |
---|
| 120 | |
---|
| 121 | install-dvi: install-dvi-am |
---|
| 122 | |
---|
[2bfaabe] | 123 | @@ -1010,7 +1059,7 @@ |
---|
[ce3a096] | 124 | install-info --info-dir="$(DESTDIR)$(infodir)" "$(DESTDIR)$(infodir)/$$relfile" || :;\ |
---|
| 125 | done; \ |
---|
| 126 | else : ; fi |
---|
| 127 | -install-man: |
---|
| 128 | +install-man: install-man1 |
---|
| 129 | |
---|
| 130 | install-pdf: install-pdf-am |
---|
| 131 | |
---|
[2bfaabe] | 132 | @@ -1054,7 +1103,9 @@ |
---|
[ce3a096] | 133 | ps-am: $(PSS) |
---|
| 134 | |
---|
| 135 | uninstall-am: uninstall-dvi-am uninstall-html-am uninstall-info-am \ |
---|
| 136 | - uninstall-pdf-am uninstall-ps-am |
---|
| 137 | + uninstall-man uninstall-pdf-am uninstall-ps-am |
---|
| 138 | + |
---|
| 139 | +uninstall-man: uninstall-man1 |
---|
| 140 | |
---|
| 141 | .MAKE: install-am install-strip |
---|
| 142 | |
---|
[2bfaabe] | 143 | @@ -1063,14 +1114,15 @@ |
---|
[ce3a096] | 144 | html-am info info-am install install-am install-data \ |
---|
| 145 | install-data-am install-dvi install-dvi-am install-exec \ |
---|
| 146 | install-exec-am install-html install-html-am install-info \ |
---|
| 147 | - install-info-am install-man install-pdf install-pdf-am \ |
---|
| 148 | - install-ps install-ps-am install-strip installcheck \ |
---|
| 149 | - installcheck-am installdirs maintainer-clean \ |
---|
| 150 | + install-info-am install-man install-man1 install-pdf \ |
---|
| 151 | + install-pdf-am install-ps install-ps-am install-strip \ |
---|
| 152 | + installcheck installcheck-am installdirs maintainer-clean \ |
---|
| 153 | maintainer-clean-aminfo maintainer-clean-generic \ |
---|
| 154 | maintainer-clean-vti mostlyclean mostlyclean-aminfo \ |
---|
| 155 | mostlyclean-generic mostlyclean-vti pdf pdf-am ps ps-am \ |
---|
| 156 | uninstall uninstall-am uninstall-dvi-am uninstall-html-am \ |
---|
| 157 | - uninstall-info-am uninstall-pdf-am uninstall-ps-am |
---|
| 158 | + uninstall-info-am uninstall-man uninstall-man1 \ |
---|
| 159 | + uninstall-pdf-am uninstall-ps-am |
---|
| 160 | |
---|
| 161 | |
---|
| 162 | header.texi: $(top_srcdir)/src/tar.h |
---|
[2bfaabe] | 163 | diff -Naur tar-1.22.orig/doc/tar.1 tar-1.22/doc/tar.1 |
---|
| 164 | --- tar-1.22.orig/doc/tar.1 1969-12-31 16:00:00.000000000 -0800 |
---|
| 165 | +++ tar-1.22/doc/tar.1 2009-03-05 20:52:59.235825673 -0800 |
---|
| 166 | @@ -0,0 +1,400 @@ |
---|
[ce3a096] | 167 | +.\" @(#)tar.1 1.11.1 93/19/22 PJV; |
---|
| 168 | +.TH TAR 1 "29 Aug 2007" |
---|
| 169 | +.SH NAME |
---|
| 170 | +tar \- The GNU version of the tar archiving utility |
---|
| 171 | +.SH SYNOPSIS |
---|
| 172 | +.B tar |
---|
| 173 | +[ |
---|
| 174 | +.B \- |
---|
| 175 | +] |
---|
| 176 | +.B A \-\-catenate \-\-concatenate \||\| c \-\-create \||\| d \-\-diff \-\-compare \||\| \-\-delete \||\| r \-\-append \||\| t \-\-list \||\| u \-\-update \||\| x \-\-extract \-\-get |
---|
| 177 | +.I [ options ] |
---|
| 178 | +.I pathname [ pathname ... ] |
---|
| 179 | +.SH DESCRIPTION |
---|
| 180 | +.LP |
---|
| 181 | +This manual page documents the GNU version of |
---|
| 182 | +.B tar |
---|
| 183 | +, an archiving program designed to store and extract files from |
---|
| 184 | +an archive file known as a |
---|
| 185 | +.IR tarfile. |
---|
| 186 | +A |
---|
| 187 | +.IR tarfile |
---|
| 188 | +may be made on a tape drive, however, it is also common |
---|
| 189 | +to write a |
---|
| 190 | +.IR tarfile |
---|
| 191 | +to a normal file. |
---|
| 192 | +The first argument to |
---|
| 193 | +.B tar |
---|
| 194 | +must be one of the options: |
---|
| 195 | +.BR Acdrtux , |
---|
| 196 | +followed by any optional functions. |
---|
| 197 | +The final arguments to |
---|
| 198 | +.B tar |
---|
| 199 | +are the names of the files or directories which should be archived. The use |
---|
| 200 | +of a directory name always implies that the subdirectories below should be |
---|
| 201 | +included in the archive. |
---|
| 202 | +.SH EXAMPLES |
---|
| 203 | +.TP |
---|
| 204 | +.B tar \-xvvf foo.tar |
---|
| 205 | +extract foo.tar |
---|
| 206 | +.TP |
---|
| 207 | +.B tar \-xvvzf foo.tar.gz |
---|
| 208 | +extract gzipped foo.tar.gz |
---|
| 209 | +.TP |
---|
| 210 | +.B tar \-cvvf foo.tar foo/ |
---|
| 211 | +tar contents of folder foo in foo.tar |
---|
| 212 | +.SH "FUNCTION LETTERS" |
---|
| 213 | +.TP |
---|
| 214 | +.B One of the following options must be used: |
---|
| 215 | +.TP |
---|
| 216 | +.B \-A, \-\-catenate, \-\-concatenate |
---|
| 217 | +append tar files to an archive |
---|
| 218 | +.TP |
---|
| 219 | +.B \-c, \-\-create |
---|
| 220 | +create a new archive |
---|
| 221 | +.TP |
---|
| 222 | +.B \-d, \-\-diff, \-\-compare |
---|
| 223 | +find differences between archive and file system |
---|
| 224 | +.TP |
---|
| 225 | +.B \-\-delete |
---|
| 226 | +delete from the archive (not for use on mag tapes!) |
---|
| 227 | +.TP |
---|
| 228 | +.B \-r, \-\-append |
---|
| 229 | +append files to the end of an archive |
---|
| 230 | +.TP |
---|
| 231 | +.B \-t, \-\-list |
---|
| 232 | +list the contents of an archive |
---|
| 233 | +.TP |
---|
| 234 | +.B \-u, \-\-update |
---|
| 235 | +only append files that are newer than copy in archive |
---|
| 236 | +.TP |
---|
| 237 | +.B \-x, \-\-extract, \-\-get |
---|
| 238 | +extract files from an archive |
---|
| 239 | +.SH "OTHER OPTIONS" |
---|
| 240 | +.TP |
---|
| 241 | +.B \-\-allow\-name\-mangling |
---|
| 242 | +re-enable handling of GNUTYPE_NAMES which is now disabled by default |
---|
| 243 | +.TP |
---|
| 244 | +.B \-\-anchored |
---|
| 245 | +force exclusion patterns to match initial subsequences |
---|
| 246 | +.TP |
---|
| 247 | +.B \-\-atime\-preserve |
---|
| 248 | +don't change access times on dumped files |
---|
| 249 | +.TP |
---|
| 250 | +.B \-a, \-\-auto\-compress |
---|
| 251 | +with \-\-create, selects compression algorithm basing on the suffix |
---|
| 252 | +of the archive file name |
---|
| 253 | +.TP |
---|
| 254 | +.B \-b, \-\-blocking\-factor N |
---|
| 255 | +use record size of Nx512 bytes (default N=20) |
---|
| 256 | +.TP |
---|
| 257 | +.B \-B, \-\-read\-full\-records |
---|
| 258 | +reblock as we read (for reading 4.2BSD pipes) |
---|
| 259 | +.TP |
---|
| 260 | +.B \-\-backup[\=TYPE] |
---|
| 261 | +back up files instead of overwriting (TYPE=numbered, existing, simple) |
---|
| 262 | +.TP |
---|
| 263 | +.B \-C, \-\-directory DIR |
---|
| 264 | +change to directory DIR |
---|
| 265 | +.TP |
---|
| 266 | +.B \-\-checkpoint |
---|
| 267 | +print periodic checkpoints |
---|
| 268 | +.TP |
---|
| 269 | +.B \-\-checkpoint\-action |
---|
| 270 | +this action allows to specify an action to be executed upon hitting a |
---|
| 271 | +checkpoint. Recognized actions are: dot, echo (the default), |
---|
| 272 | +echo\=string, ttyout\=string, exec\=cmdline, and sleep\=value. Any number |
---|
| 273 | +of `\-\-checkpoint\-action' options can be specified, the actions will be |
---|
| 274 | +executed in order of their appearance in the command line. |
---|
| 275 | +.TP |
---|
| 276 | +.B \-\-check\-device |
---|
| 277 | +enables comparing device numbers. This is the default. |
---|
| 278 | +.TP |
---|
| 279 | +.B \-\-no\-check\-device |
---|
| 280 | +disables comparing device numbers during preparatory stage of an |
---|
| 281 | +incremental dump. |
---|
| 282 | +This allows to avoid creating full dumps if the device numbers change |
---|
| 283 | +(e.g. when using an LVM snapshot) |
---|
| 284 | +.TP |
---|
| 285 | +.B \-\-exclude=PATTERN |
---|
| 286 | +exclude files matching PATTERN |
---|
| 287 | +.TP |
---|
| 288 | +.B \-f, \-\-file [HOSTNAME:]F |
---|
| 289 | +use archive file or device F (otherwise value of TAPE environment variable; if unset, "\-", meaning stdin/stdout) |
---|
| 290 | +.TP |
---|
| 291 | +.B \-F, \-\-info\-script F, \-\-new\-volume\-script F |
---|
| 292 | +run script at end of each tape (implies \-M) |
---|
| 293 | +.TP |
---|
| 294 | +.B \-\-force\-local |
---|
| 295 | +archive file is local even if it has a colon |
---|
| 296 | +.TP |
---|
| 297 | +.B \-G, \-\-incremental |
---|
| 298 | +create/list/extract old GNU-format incremental backup |
---|
| 299 | +.TP |
---|
| 300 | +.B \-g, \-\-listed\-incremental F |
---|
| 301 | +create/list/extract new GNU-format incremental backup |
---|
| 302 | +.TP |
---|
| 303 | +.B \-\-group G |
---|
| 304 | +set group to G while adding files |
---|
| 305 | +.TP |
---|
| 306 | +.B \-h, \-\-dereference |
---|
| 307 | +don't dump symlinks; dump the files they point to |
---|
| 308 | +.TP |
---|
| 309 | +.B \-\-hard\-dereference |
---|
| 310 | +during archive creation, dereferences hard links and stores the files |
---|
| 311 | +they refer to, instead of creating usual hard link members (type '1') |
---|
| 312 | +.TP |
---|
| 313 | +.B \-\-help |
---|
| 314 | +print help message |
---|
| 315 | +.TP |
---|
| 316 | +.B \-i, \-\-ignore\-zeros |
---|
| 317 | +ignore blocks of zeros in archive (normally mean EOF) |
---|
| 318 | +.TP |
---|
| 319 | +.B \-\-ignore\-case |
---|
| 320 | +ignore case when excluding files |
---|
| 321 | +.TP |
---|
| 322 | +.B \-\-ignore\-failed\-read |
---|
| 323 | +don't exit with non-zero status on unreadable files |
---|
| 324 | +.TP |
---|
| 325 | +.B \-j, \-\-bzip2 |
---|
| 326 | +filter archive through bzip2, use to decompress .bz2 files. |
---|
| 327 | +WARNING: some previous versions of tar used option \-I to |
---|
| 328 | +filter through bzip2. When writing scripts, use \-\-bzip2 |
---|
| 329 | +instead of \-j so that both older and newer tar versions |
---|
| 330 | +will work. |
---|
| 331 | +.TP |
---|
[2bfaabe] | 332 | +.B \-J, \-\-xz |
---|
| 333 | +selects XZ compression algorithm |
---|
| 334 | +.TP |
---|
[ce3a096] | 335 | +.B \-k, \-\-keep\-old\-files |
---|
| 336 | +keep existing files; don't overwrite them from archive |
---|
| 337 | +.TP |
---|
| 338 | +.B \-K, \-\-starting\-file F |
---|
| 339 | +begin at file F in the archive |
---|
| 340 | +.TP |
---|
[2bfaabe] | 341 | +.B \-\-lzip |
---|
[4588a6c] | 342 | +selects Lzip compression algorithm |
---|
[2bfaabe] | 343 | +.TP |
---|
[ce3a096] | 344 | +.B \-\-lzma |
---|
| 345 | +selects LZMA compression algorithm |
---|
| 346 | +.TP |
---|
| 347 | +.B \-l, \-\-check\-links |
---|
| 348 | +print a message if not all links are dumped |
---|
| 349 | +.TP |
---|
| 350 | +.B \-L, \-\-tape\-length N |
---|
| 351 | +change tapes after writing N*1024 bytes |
---|
| 352 | +.TP |
---|
| 353 | +.B \-m, \-\-touch |
---|
| 354 | +don't extract file modified time |
---|
| 355 | +.TP |
---|
| 356 | +.BI \-\-transform " expr" |
---|
| 357 | +applies filename transformations. |
---|
| 358 | +The argument to this option can be a list of replace expressions, separated |
---|
| 359 | +by semicolon (as in `sed'). |
---|
| 360 | +Filename transformations are applied to symbolic link targets during both |
---|
| 361 | +creation and extraction. |
---|
| 362 | +This option may be specified any number of |
---|
| 363 | +times, the specified transofrmations will be applied in turn. |
---|
| 364 | +.TP |
---|
| 365 | +.B \-M, \-\-multi\-volume |
---|
| 366 | +create/list/extract multi-volume archive |
---|
| 367 | +.TP |
---|
| 368 | +.B \-\-mode M |
---|
| 369 | +set permissions to M while adding files |
---|
| 370 | +.TP |
---|
| 371 | +.B \-N, \-\-after\-date DATE, \-\-newer DATE |
---|
| 372 | +only store files newer than DATE |
---|
| 373 | +.TP |
---|
| 374 | +.B \-\-newer\-mtime DATE |
---|
| 375 | +only store files whose contents have changed after DATE |
---|
| 376 | +.TP |
---|
| 377 | +.B \-\-no\-anchored |
---|
| 378 | +allow exclusion patterns to match any substring (the default) |
---|
| 379 | +.TP |
---|
| 380 | +.B \-\-no\-ignore\-case |
---|
| 381 | +match patterns case sensitively (the default) |
---|
| 382 | +.TP |
---|
| 383 | +.B \-\-no\-recursion |
---|
| 384 | +do not recurse into subdirectories |
---|
| 385 | +.TP |
---|
| 386 | +.B \-o, \-\-no\-same\-owner |
---|
| 387 | +extract files with owner set to current user (the default for non-root |
---|
| 388 | +users) |
---|
| 389 | +.TP |
---|
| 390 | +.B \-\-no\-same\-permissions |
---|
| 391 | +apply umask to extracted files (the default for non-root users) |
---|
| 392 | +.TP |
---|
| 393 | +.B \-\-no\-wildcards |
---|
| 394 | +do not use wildcards when excluding files |
---|
| 395 | +.TP |
---|
| 396 | +.B \-\-no\-wildcards\-match\-slash |
---|
| 397 | +don't let wildcards match "/" when excluding files |
---|
| 398 | +.TP |
---|
| 399 | +.B \-\-null |
---|
| 400 | +for \-T, use "NUL" instead of newline as filename terminator |
---|
| 401 | +.TP |
---|
| 402 | +.B \-\-numeric\-owner |
---|
| 403 | +always use numbers for user/group names |
---|
| 404 | +.TP |
---|
| 405 | +.B \-\-old\-archive, \-\-portability |
---|
| 406 | +write a V7 format archive, rather than ANSI format. These options are |
---|
| 407 | +deprecated, please use |
---|
| 408 | +.B \-\-format\=v7 |
---|
| 409 | +instead. |
---|
| 410 | +.TP |
---|
| 411 | +.B \-\-one\-file\-system |
---|
| 412 | +stay in local file system when creating an archive |
---|
| 413 | +.TP |
---|
| 414 | +.B \-\-owner O |
---|
| 415 | +set owner to O while adding files |
---|
| 416 | +.TP |
---|
| 417 | +.B \-O, \-\-to\-stdout |
---|
| 418 | +extract files to standard output |
---|
| 419 | +.TP |
---|
| 420 | +.B \-p, \-\-same\-permissions, \-\-preserve\-permissions |
---|
| 421 | +ignore umask when extracting files (the default for root) |
---|
| 422 | +.TP |
---|
| 423 | +.B \-P, \-\-absolute\-names |
---|
| 424 | +don't strip leading `/'s from file names |
---|
| 425 | +.TP |
---|
| 426 | +.B \-\-posix |
---|
| 427 | +create POSIX compliant archive. This option is deprecated, |
---|
| 428 | +please use |
---|
| 429 | +.B \-\-format\=posix |
---|
| 430 | +instead. |
---|
| 431 | +.TP |
---|
| 432 | +.B \-\-preserve |
---|
| 433 | +like \-p \-s |
---|
| 434 | +.TP |
---|
| 435 | +.B \-R, \-\-block\-number |
---|
| 436 | +show block number within archive with each message |
---|
| 437 | +.TP |
---|
| 438 | +.B \-\-record\-size SIZE |
---|
| 439 | +use SIZE bytes per record |
---|
| 440 | +.TP |
---|
| 441 | +.B \-\-recursion |
---|
| 442 | +recurse into directories (the default) |
---|
| 443 | +.TP |
---|
| 444 | +.B \-\-recursive\-unlink |
---|
| 445 | +remove existing directories before extracting directories of the same |
---|
| 446 | +name |
---|
| 447 | +.TP |
---|
| 448 | +.B \-\-remove\-files |
---|
| 449 | +remove files after adding them to the archive |
---|
| 450 | +.TP |
---|
| 451 | +.B \-\-rsh\-command=CMD |
---|
| 452 | +Use remote COMMAND instead of `rsh'. This option exists so that |
---|
| 453 | +people who use something other than the standard `rsh' (e.g., a |
---|
| 454 | +Kerberized `rsh') can access a remote device. |
---|
| 455 | +.TP |
---|
| 456 | +.B \-S, \-\-sparse |
---|
| 457 | +handle sparse files efficiently |
---|
| 458 | +.TP |
---|
| 459 | +.B \-s, \-\-same\-order, \-\-preserve\-order |
---|
| 460 | +list of names to extract is sorted to match archive |
---|
| 461 | +.TP |
---|
| 462 | +.B \-\-same\-owner |
---|
| 463 | +extract files with owner as specified in archive (the default for |
---|
| 464 | +root) |
---|
| 465 | +.TP |
---|
| 466 | +.B \-\-show\-omitted\-dirs |
---|
| 467 | +mention directories that are being skipped over |
---|
| 468 | +.TP |
---|
| 469 | +.BI \-\-strip\-components " n" |
---|
| 470 | +Strip the given number of leading directory components |
---|
| 471 | +.TP |
---|
| 472 | +.B \-\-strip, \-\-strip\-components N |
---|
| 473 | +Strips the first N components from archive members' pathnames when |
---|
| 474 | +unpacking. |
---|
| 475 | +.TP |
---|
| 476 | +.B \-\-suffix SUFFIX |
---|
| 477 | +append SUFFIX to make backup files (default ~) |
---|
| 478 | +.TP |
---|
| 479 | +.B \-T, \-\-files\-from F |
---|
| 480 | +get names to extract or archive from file F |
---|
| 481 | +.TP |
---|
| 482 | +.B \-\-totals |
---|
| 483 | +display total bytes written after creating an archive |
---|
| 484 | +.TP |
---|
| 485 | +.B \-U, \-\-unlink\-first |
---|
| 486 | +unlink & recreate files instead of overwriting |
---|
| 487 | +.TP |
---|
| 488 | +.B \-\-use\-compress\-program PROG |
---|
| 489 | +filter the archive through PROG (which must accept \-d) |
---|
| 490 | +.TP |
---|
| 491 | +.B \-v, \-\-verbose |
---|
| 492 | +verbosely list files processed |
---|
| 493 | +.TP |
---|
| 494 | +.B \-V, \-\-label NAME |
---|
| 495 | +create archive with volume name NAME |
---|
| 496 | +.TP |
---|
| 497 | +.B \-\-version |
---|
| 498 | +print tar program version number |
---|
| 499 | +.TP |
---|
| 500 | +.B \-\-volno\-file F |
---|
| 501 | +keep track of current volume (of a multi-volume archive) in F |
---|
| 502 | +.TP |
---|
| 503 | +.B \-w, \-\-interactive, \-\-confirmation |
---|
| 504 | +ask for confirmation for every action |
---|
| 505 | +.TP |
---|
| 506 | +.B \-W, \-\-verify |
---|
| 507 | +attempt to verify the archive after writing it |
---|
| 508 | +.TP |
---|
| 509 | +.B \-\-wildcards |
---|
| 510 | +use wildcards when excluding files (the default) |
---|
| 511 | +.TP |
---|
| 512 | +.B \-\-wildcards\-match\-slash |
---|
| 513 | +allow wildcards to match "/" (the default) |
---|
| 514 | +.TP |
---|
| 515 | +.B \-X, \-\-exclude\-from=FILE |
---|
| 516 | +exclude files matching patterns listed in FILE |
---|
| 517 | +.TP |
---|
| 518 | +.B \-Z, \-\-compress, \-\-uncompress |
---|
| 519 | +filter the archive through compress |
---|
| 520 | +.TP |
---|
| 521 | +.B \-z, \-\-gzip, \-\-gunzip, \-\-ungzip |
---|
| 522 | +filter the archive through gzip |
---|
| 523 | +.TP |
---|
| 524 | +.B \-[0\-7][lmh] |
---|
| 525 | +specify drive and density |
---|
| 526 | +.SH ENVIRONMENT |
---|
| 527 | +The behavior of tar is controlled by the following environment variables, |
---|
| 528 | +among others: |
---|
| 529 | +.TP |
---|
| 530 | +.B TAPE |
---|
| 531 | +Device or file to use for the archive if \fB--file\fR is not specified. |
---|
| 532 | +If this environment variable is unset, use stdin or stdout instead. |
---|
| 533 | +.TP |
---|
| 534 | +.B TAR_OPTIONS |
---|
| 535 | +Options to prepend to those specified on the command line, separated by |
---|
| 536 | +whitespace. Embedded backslashes may be used to escape whitespace or |
---|
| 537 | +backslashes within an option. |
---|
| 538 | +.LP |
---|
| 539 | +In addition, the value of the blocking factor is made available to info |
---|
| 540 | +and checkpoint scripts via environment variable |
---|
| 541 | +.B TAR_BLOCKING_FACTOR. |
---|
| 542 | +.SH BUGS |
---|
| 543 | +.LP |
---|
| 544 | +The GNU folks, in general, abhor man pages and create info documents instead. |
---|
| 545 | +The maintainer of \fBtar\fR falls into this category. Thus, this man page may |
---|
| 546 | +not be complete nor current, and it is included in the Cross-LFS Build |
---|
| 547 | +because man is a great tool :). This man page was taken from Debian |
---|
| 548 | +Linux and has since been lovingly updated here. |
---|
| 549 | + |
---|
| 550 | +If you want to read the complete documentation for GNU tar, please refer to |
---|
| 551 | +the online version at |
---|
| 552 | +.PP |
---|
| 553 | +.ce 1 |
---|
| 554 | +<http://www.gnu.org/software/tar/manual/index.html> |
---|
| 555 | +.PP |
---|
| 556 | +This man page was created for the Cross LFS Build. It does not describe |
---|
| 557 | +all of the functionality of tar, and it is often out of date. Patches to |
---|
| 558 | +improve the coverage and/or accuracy of this man page are appreciated, and |
---|
| 559 | +should be filed as tickets in bug reporting system for Cross-LFS and |
---|
| 560 | +not submitted to the GNU tar maintainers. The URL for the Cross-LFS bug |
---|
| 561 | +reporting system is at |
---|
| 562 | +.PP |
---|
| 563 | +.ce 1 |
---|
| 564 | +<http://trac.cross-lfs.org> |
---|
| 565 | +.PP |
---|
| 566 | + |
---|