| [c5dbf71] | 1 | Submitted By: Joe Ciccone <jciccone@gmail.com>
|
|---|
| 2 | Date: 2010-08-08
|
|---|
| 3 | Initial Package Version: 1.22
|
|---|
| 4 | Origin: Debian
|
|---|
| 5 | Upstream Status: Unknown
|
|---|
| 6 | Description: This patch adds a man page for tar generated by the perl script
|
|---|
| 7 | from debian.
|
|---|
| 8 |
|
|---|
| 9 | diff -Naur tar-1.23.orig/doc/Makefile.am tar-1.23/doc/Makefile.am
|
|---|
| 10 | --- tar-1.23.orig/doc/Makefile.am 2010-01-26 06:30:20.000000000 -0500
|
|---|
| 11 | +++ tar-1.23/doc/Makefile.am 2010-08-08 10:36:52.898076457 -0400
|
|---|
| 12 | @@ -17,6 +17,7 @@
|
|---|
| 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 | info_TEXINFOS = tar.texi
|
|---|
| 18 | tar_TEXINFOS = \
|
|---|
| 19 | dumpdir.texi\
|
|---|
| 20 | diff -Naur tar-1.23.orig/doc/Makefile.in tar-1.23/doc/Makefile.in
|
|---|
| 21 | --- tar-1.23.orig/doc/Makefile.in 2010-03-10 05:51:41.000000000 -0500
|
|---|
| 22 | +++ tar-1.23/doc/Makefile.in 2010-08-08 10:37:04.922326231 -0400
|
|---|
| 23 | @@ -165,7 +165,7 @@
|
|---|
| 24 | MAKEINFOHTML = $(MAKEINFO) --html
|
|---|
| 25 | AM_MAKEINFOHTMLFLAGS = $(AM_MAKEINFOFLAGS)
|
|---|
| 26 | DVIPS = dvips
|
|---|
| 27 | -am__installdirs = "$(DESTDIR)$(infodir)"
|
|---|
| 28 | +am__installdirs = "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)"
|
|---|
| 29 | am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
|
|---|
| 30 | am__vpath_adj = case $$p in \
|
|---|
| 31 | $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
|
|---|
| 32 | @@ -187,6 +187,9 @@
|
|---|
| 33 | am__base_list = \
|
|---|
| 34 | sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
|
|---|
| 35 | sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
|
|---|
| 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@
|
|---|
| 42 | @@ -827,6 +831,7 @@
|
|---|
| 43 | top_build_prefix = @top_build_prefix@
|
|---|
| 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\
|
|---|
| 50 | @@ -1049,6 +1054,44 @@
|
|---|
| 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: $(man_MANS)
|
|---|
| 55 | + @$(NORMAL_INSTALL)
|
|---|
| 56 | + test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)"
|
|---|
| 57 | + @list=''; test -n "$(man1dir)" || exit 0; \
|
|---|
| 58 | + { for i in $$list; do echo "$$i"; done; \
|
|---|
| 59 | + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
|
|---|
| 60 | + sed -n '/\.1[a-z]*$$/p'; \
|
|---|
| 61 | + } | while read p; do \
|
|---|
| 62 | + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
|
|---|
| 63 | + echo "$$d$$p"; echo "$$p"; \
|
|---|
| 64 | + done | \
|
|---|
| 65 | + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
|
|---|
| 66 | + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
|
|---|
| 67 | + sed 'N;N;s,\n, ,g' | { \
|
|---|
| 68 | + list=; while read file base inst; do \
|
|---|
| 69 | + if test "$$base" = "$$inst"; then list="$$list $$file"; else \
|
|---|
| 70 | + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \
|
|---|
| 71 | + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \
|
|---|
| 72 | + fi; \
|
|---|
| 73 | + done; \
|
|---|
| 74 | + for i in $$list; do echo "$$i"; done | $(am__base_list) | \
|
|---|
| 75 | + while read files; do \
|
|---|
| 76 | + test -z "$$files" || { \
|
|---|
| 77 | + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \
|
|---|
| 78 | + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \
|
|---|
| 79 | + done; }
|
|---|
| 80 | +
|
|---|
| 81 | +uninstall-man1:
|
|---|
| 82 | + @$(NORMAL_UNINSTALL)
|
|---|
| 83 | + @list=''; test -n "$(man1dir)" || exit 0; \
|
|---|
| 84 | + files=`{ for i in $$list; do echo "$$i"; done; \
|
|---|
| 85 | + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
|
|---|
| 86 | + sed -n '/\.1[a-z]*$$/p'; \
|
|---|
| 87 | + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
|
|---|
| 88 | + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
|
|---|
| 89 | + test -z "$$files" || { \
|
|---|
| 90 | + echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \
|
|---|
| 91 | + cd "$(DESTDIR)$(man1dir)" && rm -f $$files; }
|
|---|
| 92 | tags: TAGS
|
|---|
| 93 | TAGS:
|
|---|
| 94 |
|
|---|
| 95 | @@ -1057,6 +1100,19 @@
|
|---|
| 96 |
|
|---|
| 97 |
|
|---|
| 98 | distdir: $(DISTFILES)
|
|---|
| 99 | + @list='$(MANS)'; if test -n "$$list"; then \
|
|---|
| 100 | + list=`for p in $$list; do \
|
|---|
| 101 | + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
|
|---|
| 102 | + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \
|
|---|
| 103 | + if test -n "$$list" && \
|
|---|
| 104 | + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \
|
|---|
| 105 | + echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \
|
|---|
| 106 | + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \
|
|---|
| 107 | + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \
|
|---|
| 108 | + echo " typically \`make maintainer-clean' will remove them" >&2; \
|
|---|
| 109 | + exit 1; \
|
|---|
| 110 | + else :; fi; \
|
|---|
| 111 | + else :; fi
|
|---|
| 112 | @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
|---|
| 113 | topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
|---|
| 114 | list='$(DISTFILES)'; \
|
|---|
| 115 | @@ -1091,9 +1147,9 @@
|
|---|
| 116 | dist-info
|
|---|
| 117 | check-am: all-am
|
|---|
| 118 | check: check-am
|
|---|
| 119 | -all-am: Makefile $(INFO_DEPS)
|
|---|
| 120 | +all-am: Makefile $(INFO_DEPS) $(MANS)
|
|---|
| 121 | installdirs:
|
|---|
| 122 | - for dir in "$(DESTDIR)$(infodir)"; do \
|
|---|
| 123 | + for dir in "$(DESTDIR)$(infodir)" "$(DESTDIR)$(man1dir)"; do \
|
|---|
| 124 | test -z "$$dir" || $(MKDIR_P) "$$dir"; \
|
|---|
| 125 | done
|
|---|
| 126 | install: install-am
|
|---|
| 127 | @@ -1141,7 +1197,7 @@
|
|---|
| 128 |
|
|---|
| 129 | info-am: $(INFO_DEPS)
|
|---|
| 130 |
|
|---|
| 131 | -install-data-am: install-info-am
|
|---|
| 132 | +install-data-am: install-info-am install-man
|
|---|
| 133 |
|
|---|
| 134 | install-dvi: install-dvi-am
|
|---|
| 135 |
|
|---|
| 136 | @@ -1215,7 +1271,7 @@
|
|---|
| 137 | install-info --info-dir="$(DESTDIR)$(infodir)" "$(DESTDIR)$(infodir)/$$relfile" || :;\
|
|---|
| 138 | done; \
|
|---|
| 139 | else : ; fi
|
|---|
| 140 | -install-man:
|
|---|
| 141 | +install-man: install-man1
|
|---|
| 142 |
|
|---|
| 143 | install-pdf: install-pdf-am
|
|---|
| 144 |
|
|---|
| 145 | @@ -1263,7 +1319,9 @@
|
|---|
| 146 | ps-am: $(PSS)
|
|---|
| 147 |
|
|---|
| 148 | uninstall-am: uninstall-dvi-am uninstall-html-am uninstall-info-am \
|
|---|
| 149 | - uninstall-pdf-am uninstall-ps-am
|
|---|
| 150 | + uninstall-man uninstall-pdf-am uninstall-ps-am
|
|---|
| 151 | +
|
|---|
| 152 | +uninstall-man: uninstall-man1
|
|---|
| 153 |
|
|---|
| 154 | .MAKE: install-am install-strip
|
|---|
| 155 |
|
|---|
| 156 | @@ -1272,14 +1330,15 @@
|
|---|
| 157 | dvi-am html html-am info info-am install install-am \
|
|---|
| 158 | install-data install-data-am install-dvi install-dvi-am \
|
|---|
| 159 | install-exec install-exec-am install-html install-html-am \
|
|---|
| 160 | - install-info install-info-am install-man install-pdf \
|
|---|
| 161 | - install-pdf-am install-ps install-ps-am install-strip \
|
|---|
| 162 | - installcheck installcheck-am installdirs maintainer-clean \
|
|---|
| 163 | - maintainer-clean-aminfo maintainer-clean-generic \
|
|---|
| 164 | - maintainer-clean-vti mostlyclean mostlyclean-aminfo \
|
|---|
| 165 | - mostlyclean-generic mostlyclean-vti pdf pdf-am ps ps-am \
|
|---|
| 166 | - uninstall uninstall-am uninstall-dvi-am uninstall-html-am \
|
|---|
| 167 | - uninstall-info-am uninstall-pdf-am uninstall-ps-am
|
|---|
| 168 | + install-info install-info-am install-man install-man1 \
|
|---|
| 169 | + install-pdf install-pdf-am install-ps install-ps-am \
|
|---|
| 170 | + install-strip installcheck installcheck-am installdirs \
|
|---|
| 171 | + maintainer-clean maintainer-clean-aminfo \
|
|---|
| 172 | + maintainer-clean-generic maintainer-clean-vti mostlyclean \
|
|---|
| 173 | + mostlyclean-aminfo mostlyclean-generic mostlyclean-vti pdf \
|
|---|
| 174 | + pdf-am ps ps-am uninstall uninstall-am uninstall-dvi-am \
|
|---|
| 175 | + uninstall-html-am uninstall-info-am uninstall-man \
|
|---|
| 176 | + uninstall-man1 uninstall-pdf-am uninstall-ps-am
|
|---|
| 177 |
|
|---|
| 178 |
|
|---|
| 179 | header.texi: $(top_srcdir)/src/tar.h
|
|---|
| 180 | diff -Naur tar-1.23.orig/doc/tar.1 tar-1.23/doc/tar.1
|
|---|
| 181 | --- tar-1.23.orig/doc/tar.1 1969-12-31 19:00:00.000000000 -0500
|
|---|
| 182 | +++ tar-1.23/doc/tar.1 2010-08-08 10:36:35.725827411 -0400
|
|---|
| 183 | @@ -0,0 +1,364 @@
|
|---|
| 184 | +.\" generated by script on Sun Aug 8 10:29:46 2010
|
|---|
| 185 | +.Dd Aug 8, 2010
|
|---|
| 186 | +.Dt TAR 1
|
|---|
| 187 | +.Sh NAME
|
|---|
| 188 | +.Nm tar
|
|---|
| 189 | +.Nd The GNU version of the tar archiving utility
|
|---|
| 190 | +.Sh SYNOPSIS
|
|---|
| 191 | +.Nm tar
|
|---|
| 192 | +.Oo Fl Oc Cm A Fl \-catenate \-concatenate Cm \||\| c Fl \-create Cm \||\| d Fl \-diff \-compare Cm \||\| Fl \-delete Cm \||\| r Fl \-append Cm \||\| t Fl \-list Cm \||\| Fl \-test\-label Cm \||\| u Fl \-update Cm \||\| x Fl \-extract \-get
|
|---|
| 193 | +.Op Ar options
|
|---|
| 194 | +.Op Ar pathname ...
|
|---|
| 195 | +.Sh DESCRIPTION
|
|---|
| 196 | +.Nm Tar
|
|---|
| 197 | +stores and extracts files from a tape or disk archive.
|
|---|
| 198 | +.Pp
|
|---|
| 199 | +The first argument to
|
|---|
| 200 | +tar
|
|---|
| 201 | +should be a function; either one of the letters
|
|---|
| 202 | +.Cm Acdrtux ,
|
|---|
| 203 | +or one of the long function names.
|
|---|
| 204 | +A function letter need not be prefixed with ``\-'', and may be combined
|
|---|
| 205 | +with other single-letter options.
|
|---|
| 206 | +A long function name must be prefixed with
|
|---|
| 207 | +.Cm \\-\\- .
|
|---|
| 208 | +Some options take a parameter; with the single-letter form
|
|---|
| 209 | +these must be given as separate arguments.
|
|---|
| 210 | +With the long form, they may be given by appending
|
|---|
| 211 | +.Cm = Ns Ar value
|
|---|
| 212 | +to the option.
|
|---|
| 213 | +.Sh FUNCTION LETTERS
|
|---|
| 214 | +Main operation mode:
|
|---|
| 215 | +.Bl -tag -width flag
|
|---|
| 216 | +.It Fl A , Fl \-catenate , Fl \-concatenate
|
|---|
| 217 | +append tar files to an archive
|
|---|
| 218 | +.It Fl c , Fl \-create
|
|---|
| 219 | +create a new archive
|
|---|
| 220 | +.It Fl d , Fl \-diff , Fl \-compare
|
|---|
| 221 | +find differences between archive and file system
|
|---|
| 222 | +.It Fl \-delete
|
|---|
| 223 | +delete from the archive (not on mag tapes!)
|
|---|
| 224 | +.It Fl r , Fl \-append
|
|---|
| 225 | +append files to the end of an archive
|
|---|
| 226 | +.It Fl t , Fl \-list
|
|---|
| 227 | +list the contents of an archive
|
|---|
| 228 | +.It Fl \-test\-label
|
|---|
| 229 | +test the archive volume label and exit
|
|---|
| 230 | +.It Fl u , Fl \-update
|
|---|
| 231 | +only append files newer than copy in archive
|
|---|
| 232 | +.It Fl x , Fl \-extract , Fl \-get
|
|---|
| 233 | +extract files from an archive
|
|---|
| 234 | +.El
|
|---|
| 235 | +.Sh OTHER OPTIONS
|
|---|
| 236 | +Operation modifiers:
|
|---|
| 237 | +.Bl -tag -width flag
|
|---|
| 238 | +.It \-[0\-7][lmh]
|
|---|
| 239 | +specify drive and density
|
|---|
| 240 | +.It Fl a , Fl \-auto\-compress
|
|---|
| 241 | +use archive suffix to determine the compression program
|
|---|
| 242 | +.It Fl \-add\-file Ns \= Ns Ar FILE
|
|---|
| 243 | +add given FILE to the archive (useful if its name starts with a dash)
|
|---|
| 244 | +.It Fl \-anchored
|
|---|
| 245 | +patterns match file name start
|
|---|
| 246 | +.It Fl \-no\-anchored
|
|---|
| 247 | +patterns match after any `/' (default for exclusion)
|
|---|
| 248 | +.It Fl \-atime\-preserve
|
|---|
| 249 | +preserve access times on dumped files, either by restoring the times
|
|---|
| 250 | +.It Fl \-no\-auto\-compress
|
|---|
| 251 | +do not use archive suffix to determine the compression program
|
|---|
| 252 | +.It Fl b , Fl \-blocking\-factor Ar BLOCKS
|
|---|
| 253 | +BLOCKS x 512 bytes per record
|
|---|
| 254 | +.It Fl B , Fl \-read\-full\-records
|
|---|
| 255 | +reblock as we read (for 4.2BSD pipes)
|
|---|
| 256 | +.It Fl \-backup
|
|---|
| 257 | +backup before removal, choose version CONTROL
|
|---|
| 258 | +.It Fl C , Fl \-directory Ar DIR
|
|---|
| 259 | +change to directory DIR
|
|---|
| 260 | +.It Fl \-check\-device
|
|---|
| 261 | +check device numbers when creating incremental archives (default)
|
|---|
| 262 | +.It Fl \-no\-check\-device
|
|---|
| 263 | +do not check device numbers when creating incremental archives
|
|---|
| 264 | +.It Fl \-checkpoint
|
|---|
| 265 | +display progress messages every NUMBERth record (default 10)
|
|---|
| 266 | +.It Fl \-checkpoint\-action Ns \= Ns Ar ACTION
|
|---|
| 267 | +execute ACTION on each checkpoint
|
|---|
| 268 | +.It Fl \-delay\-directory\-restore
|
|---|
| 269 | +delay setting modification times and permissions of extracted
|
|---|
| 270 | +.It Fl \-no\-delay\-directory\-restore
|
|---|
| 271 | +cancel the effect of --delay-directory-restore option
|
|---|
| 272 | +.It Fl \-exclude Ns \= Ns Ar PATTERN
|
|---|
| 273 | +exclude files, given as a PATTERN
|
|---|
| 274 | +.It Fl \-exclude\-backups
|
|---|
| 275 | +exclude backup and lock files
|
|---|
| 276 | +.It Fl \-exclude\-caches
|
|---|
| 277 | +exclude contents of directories containing CACHEDIR.TAG,
|
|---|
| 278 | +.It Fl \-exclude\-caches\-all
|
|---|
| 279 | +exclude directories containing CACHEDIR.TAG
|
|---|
| 280 | +.It Fl \-exclude\-caches\-under
|
|---|
| 281 | +exclude everything under directories containing CACHEDIR.TAG
|
|---|
| 282 | +.It Fl \-exclude\-tag Ns \= Ns Ar FILE
|
|---|
| 283 | +exclude contents of directories containing FILE, except
|
|---|
| 284 | +.It Fl \-exclude\-tag\-all Ns \= Ns Ar FILE
|
|---|
| 285 | +exclude directories containing FILE
|
|---|
| 286 | +.It Fl \-exclude\-tag\-under Ns \= Ns Ar FILE
|
|---|
| 287 | +exclude everything under directories containing FILE
|
|---|
| 288 | +.It Fl \-exclude\-vcs
|
|---|
| 289 | +exclude version control system directories
|
|---|
| 290 | +.It Fl f , Fl \-file Ar ARCHIVE
|
|---|
| 291 | +use archive file or device ARCHIVE
|
|---|
| 292 | +.It Fl F , Fl \-info\-script , Fl \-new\-volume\-script Ar NAME
|
|---|
| 293 | +run script at end of each tape (implies -M)
|
|---|
| 294 | +.It Fl \-force\-local
|
|---|
| 295 | +archive file is local even if it has a colon
|
|---|
| 296 | +.It Fl g , Fl \-listed\-incremental Ar FILE
|
|---|
| 297 | +handle new GNU-format incremental backup
|
|---|
| 298 | +.It Fl G , Fl \-incremental
|
|---|
| 299 | +handle old GNU-format incremental backup
|
|---|
| 300 | +.It Fl \-group Ns \= Ns Ar NAME
|
|---|
| 301 | +force NAME as group for added files
|
|---|
| 302 | +.It Fl h , Fl \-dereference
|
|---|
| 303 | +follow symlinks; archive and dump the files they point to
|
|---|
| 304 | +.It Fl H , Fl \-format Ar FORMAT
|
|---|
| 305 | +create archive of the given formatFORMAT is one of the following:
|
|---|
| 306 | +.Bl -tag -width flag
|
|---|
| 307 | +.It Fl \-format=gnu
|
|---|
| 308 | +GNU tar 1.13.x format
|
|---|
| 309 | +.It Fl \-format=oldgnu
|
|---|
| 310 | +GNU format as per tar <= 1.12
|
|---|
| 311 | +.It Fl \-format=pax
|
|---|
| 312 | +POSIX 1003.1-2001 (pax) format
|
|---|
| 313 | +.It Fl \-format=posix
|
|---|
| 314 | +same as pax
|
|---|
| 315 | +.It Fl \-format=ustar
|
|---|
| 316 | +POSIX 1003.1-1988 (ustar) format
|
|---|
| 317 | +.It Fl \-format=v7
|
|---|
| 318 | +old V7 tar format
|
|---|
| 319 | +.El
|
|---|
| 320 | +.It Fl \-hard\-dereference
|
|---|
| 321 | +follow hard links; archive and dump the files they refer to
|
|---|
| 322 | +.It Fl i , Fl \-ignore\-zeros
|
|---|
| 323 | +ignore zeroed blocks in archive (means EOF)
|
|---|
| 324 | +.It Fl I , Fl \-use\-compress\-program Ar PROG
|
|---|
| 325 | +filter through PROG (must accept -d)
|
|---|
| 326 | +.It Fl \-ignore\-case
|
|---|
| 327 | +ignore case
|
|---|
| 328 | +.It Fl \-no\-ignore\-case
|
|---|
| 329 | +case sensitive matching (default)
|
|---|
| 330 | +.It Fl \-ignore\-command\-error
|
|---|
| 331 | +ignore exit codes of children
|
|---|
| 332 | +.It Fl \-no\-ignore\-command\-error
|
|---|
| 333 | +treat non-zero exit codes of children as error
|
|---|
| 334 | +.It Fl \-ignore\-failed\-read
|
|---|
| 335 | +do not exit with nonzero on unreadable files
|
|---|
| 336 | +.It Fl \-index\-file Ns \= Ns Ar FILE
|
|---|
| 337 | +send verbose output to FILE
|
|---|
| 338 | +.It Fl j , Fl \-bzip2
|
|---|
| 339 | +
|
|---|
| 340 | +.It Fl J , Fl \-xz
|
|---|
| 341 | +
|
|---|
| 342 | +.It Fl k , Fl \-keep\-old\-files
|
|---|
| 343 | +don't replace existing files when extracting
|
|---|
| 344 | +.It Fl K , Fl \-starting\-file Ar MEMBER-NAME
|
|---|
| 345 | +begin at member MEMBER-NAME in the archive
|
|---|
| 346 | +.It Fl \-keep\-newer\-files
|
|---|
| 347 | +don't replace existing files that are newer than their archive copies
|
|---|
| 348 | +.It Fl l , Fl \-check\-links
|
|---|
| 349 | +print a message if not all links are dumped
|
|---|
| 350 | +.It Fl L , Fl \-tape\-length Ar NUMBER
|
|---|
| 351 | +change tape after writing NUMBER x 1024 bytes
|
|---|
| 352 | +.It Fl \-level Ns \= Ns Ar NUMBER
|
|---|
| 353 | +dump level for created listed-incremental archive
|
|---|
| 354 | +.It Fl \-lzip
|
|---|
| 355 | +
|
|---|
| 356 | +.It Fl \-lzma
|
|---|
| 357 | +
|
|---|
| 358 | +.It Fl \-lzop
|
|---|
| 359 | +
|
|---|
| 360 | +.It Fl m , Fl \-touch
|
|---|
| 361 | +don't extract file modified time
|
|---|
| 362 | +.It Fl M , Fl \-multi\-volume
|
|---|
| 363 | +create/list/extract multi-volume archive
|
|---|
| 364 | +.It Fl \-mode Ns \= Ns Ar CHANGES
|
|---|
| 365 | +force (symbolic) mode CHANGES for added files
|
|---|
| 366 | +.It Fl \-mtime Ns \= Ns Ar DATE-OR-FILE
|
|---|
| 367 | +set mtime for added files from DATE-OR-FILE
|
|---|
| 368 | +.It Fl n , Fl \-seek
|
|---|
| 369 | +archive is seekable
|
|---|
| 370 | +.It Fl N , Fl \-newer , Fl \-after\-date Ar DATE-OR-FILE
|
|---|
| 371 | +only store files newer than DATE-OR-FILE
|
|---|
| 372 | +.It Fl \-newer\-mtime Ns \= Ns Ar DATE
|
|---|
| 373 | +compare date and time when data changed only
|
|---|
| 374 | +.It Fl \-null
|
|---|
| 375 | +-T reads null-terminated names, disable -C
|
|---|
| 376 | +.It Fl \-no\-null
|
|---|
| 377 | +disable the effect of the previous --null option
|
|---|
| 378 | +.It Fl \-numeric\-owner
|
|---|
| 379 | +always use numbers for user/group names
|
|---|
| 380 | +.It Fl O , Fl \-to\-stdout
|
|---|
| 381 | +extract files to standard output
|
|---|
| 382 | +.It Fl \-occurrence
|
|---|
| 383 | +process only the NUMBERth occurrence of each file in the archive;
|
|---|
| 384 | +.It Fl \-old\-archive , Fl \-portability
|
|---|
| 385 | +same as --format=v7
|
|---|
| 386 | +.It Fl \-one\-file\-system
|
|---|
| 387 | +stay in local file system when creating archive
|
|---|
| 388 | +.It Fl \-overwrite
|
|---|
| 389 | +overwrite existing files when extracting
|
|---|
| 390 | +.It Fl \-overwrite\-dir
|
|---|
| 391 | +overwrite metadata of existing directories when extracting (default)
|
|---|
| 392 | +.It Fl \-no\-overwrite\-dir
|
|---|
| 393 | +preserve metadata of existing directories
|
|---|
| 394 | +.It Fl \-owner Ns \= Ns Ar NAME
|
|---|
| 395 | +force NAME as owner for added files
|
|---|
| 396 | +.It Fl p , Fl \-preserve\-permissions , Fl \-same\-permissions
|
|---|
| 397 | +extract information about file permissions (default for superuser)
|
|---|
| 398 | +.It Fl P , Fl \-absolute\-names
|
|---|
| 399 | +don't strip leading `/'s from file names
|
|---|
| 400 | +.It Fl \-pax\-option Ns \= Ns Ar keyword[[:]=value][,keyword[[:]=value]]...
|
|---|
| 401 | +control pax keywords
|
|---|
| 402 | +.It Fl \-posix
|
|---|
| 403 | +same as --format=posix
|
|---|
| 404 | +.It Fl \-preserve
|
|---|
| 405 | +same as both -p and -s
|
|---|
| 406 | +.It Fl \-quote\-chars Ns \= Ns Ar STRING
|
|---|
| 407 | +additionally quote characters from STRING
|
|---|
| 408 | +.It Fl \-no\-quote\-chars Ns \= Ns Ar STRING
|
|---|
| 409 | +disable quoting for characters from STRING
|
|---|
| 410 | +.It Fl \-quoting\-style Ns \= Ns Ar STYLE
|
|---|
| 411 | +set name quoting style; see below for valid STYLE values
|
|---|
| 412 | +.It Fl R , Fl \-block\-number
|
|---|
| 413 | +show block number within archive with each message
|
|---|
| 414 | +.It Fl \-record\-size Ns \= Ns Ar NUMBER
|
|---|
| 415 | +NUMBER of bytes per record, multiple of 512
|
|---|
| 416 | +.It Fl \-recursion
|
|---|
| 417 | +recurse into directories (default)
|
|---|
| 418 | +.It Fl \-no\-recursion
|
|---|
| 419 | +avoid descending automatically in directories
|
|---|
| 420 | +.It Fl \-recursive\-unlink
|
|---|
| 421 | +empty hierarchies prior to extracting directory
|
|---|
| 422 | +.It Fl \-remove\-files
|
|---|
| 423 | +remove files after adding them to the archive
|
|---|
| 424 | +.It Fl \-restrict
|
|---|
| 425 | +disable use of some potentially harmful options
|
|---|
| 426 | +.It Fl \-rmt\-command Ns \= Ns Ar COMMAND
|
|---|
| 427 | +use given rmt COMMAND instead of rmt
|
|---|
| 428 | +.It Fl \-rsh\-command Ns \= Ns Ar COMMAND
|
|---|
| 429 | +use remote COMMAND instead of rsh
|
|---|
| 430 | +.It Fl s , Fl \-preserve\-order , Fl \-same\-order
|
|---|
| 431 | +sort names to extract to match archive
|
|---|
| 432 | +.It Fl S , Fl \-sparse
|
|---|
| 433 | +handle sparse files efficiently
|
|---|
| 434 | +.It Fl \-same\-owner
|
|---|
| 435 | +try extracting files with the same ownership as exists in the archive (default for superuser)
|
|---|
| 436 | +.It Fl \-no\-same\-owner
|
|---|
| 437 | +extract files as yourself (default for ordinary users)
|
|---|
| 438 | +.It Fl \-no\-same\-permissions
|
|---|
| 439 | +apply the user's umask when extracting permissions from the archive (default for ordinary users)
|
|---|
| 440 | +.It Fl \-no\-seek
|
|---|
| 441 | +archive is not seekable
|
|---|
| 442 | +.It Fl \-show\-defaults
|
|---|
| 443 | +show tar defaults
|
|---|
| 444 | +.It Fl \-show\-omitted\-dirs
|
|---|
| 445 | +when listing or extracting, list each directory that does not match search criteria
|
|---|
| 446 | +.It Fl \-show\-transformed\-names , Fl \-show\-stored\-names
|
|---|
| 447 | +show file or archive names after transformation
|
|---|
| 448 | +.It Fl \-sparse\-version Ns \= Ns Ar MAJOR[.MINOR]
|
|---|
| 449 | +set version of the sparse format to use (implies --sparse)
|
|---|
| 450 | +.It Fl \-strip\-components Ns \= Ns Ar NUMBER
|
|---|
| 451 | +strip NUMBER leading components from file names on extraction
|
|---|
| 452 | +.It Fl \-suffix Ns \= Ns Ar STRING
|
|---|
| 453 | +backup before removal, override usual suffix ('~' unless overridden by environment variable SIMPLE_BACKUP_SUFFIX)
|
|---|
| 454 | +.It Fl T , Fl \-files\-from Ar FILE
|
|---|
| 455 | +get names to extract or create from FILE
|
|---|
| 456 | +.It Fl \-to\-command Ns \= Ns Ar COMMAND
|
|---|
| 457 | +pipe extracted files to another program
|
|---|
| 458 | +.It Fl \-totals
|
|---|
| 459 | +print total bytes after processing the archive;
|
|---|
| 460 | +.It Fl \-transform , Fl \-xform Ar EXPRESSION
|
|---|
| 461 | +use sed replace EXPRESSION to transform file names
|
|---|
| 462 | +.It Fl U , Fl \-unlink\-first
|
|---|
| 463 | +remove each file prior to extracting over it
|
|---|
| 464 | +.It Fl \-unquote
|
|---|
| 465 | +unquote filenames read with -T (default)
|
|---|
| 466 | +.It Fl \-no\-unquote
|
|---|
| 467 | +do not unquote filenames read with -T
|
|---|
| 468 | +.It Fl \-utc
|
|---|
| 469 | +print file modification dates in UTC
|
|---|
| 470 | +.It Fl v , Fl \-verbose
|
|---|
| 471 | +verbosely list files processed
|
|---|
| 472 | +.It Fl V , Fl \-label Ar TEXT
|
|---|
| 473 | +create archive with volume name TEXT; at list/extract time, use TEXT as a globbing pattern for volume name
|
|---|
| 474 | +.It Fl \-volno\-file Ns \= Ns Ar FILE
|
|---|
| 475 | +use/update the volume number in FILE
|
|---|
| 476 | +.It Fl w , Fl \-interactive , Fl \-confirmation
|
|---|
| 477 | +ask for confirmation for every action
|
|---|
| 478 | +.It Fl W , Fl \-verify
|
|---|
| 479 | +attempt to verify the archive after writing it
|
|---|
| 480 | +.It Fl \-warning Ns \= Ns Ar KEYWORD
|
|---|
| 481 | +warning control
|
|---|
| 482 | +.It Fl \-wildcards
|
|---|
| 483 | +use wildcards (default for exclusion)
|
|---|
| 484 | +.It Fl \-wildcards\-match\-slash
|
|---|
| 485 | +wildcards match `/' (default for exclusion)
|
|---|
| 486 | +.It Fl \-no\-wildcards\-match\-slash
|
|---|
| 487 | +wildcards do not match `/'
|
|---|
| 488 | +.It Fl \-no\-wildcards
|
|---|
| 489 | +verbatim string matching
|
|---|
| 490 | +.It Fl X , Fl \-exclude\-from Ar FILE
|
|---|
| 491 | +exclude patterns listed in FILE
|
|---|
| 492 | +.It Fl z , Fl \-gzip , Fl \-gunzip Fl \-ungzip
|
|---|
| 493 | +
|
|---|
| 494 | +.It Fl Z , Fl \-compress , Fl \-uncompress
|
|---|
| 495 | +
|
|---|
| 496 | +.El
|
|---|
| 497 | +.Sh ENVIRONMENT
|
|---|
| 498 | +The behavior of tar is controlled by the following environment variables,
|
|---|
| 499 | +among others:
|
|---|
| 500 | +.Bl -tag -width Ds
|
|---|
| 501 | +.It Ev SIMPLE_BACKUP_SUFFIX
|
|---|
| 502 | +Backup prefix to use when extracting, if
|
|---|
| 503 | +.Fl \-suffix
|
|---|
| 504 | +is not specified.
|
|---|
| 505 | +The backup suffix defaults to `~' if neither is specified.
|
|---|
| 506 | +.It Ev TAR_OPTIONS
|
|---|
| 507 | +Options to prepend to those specified on the command line, separated by
|
|---|
| 508 | +whitespace. Embedded backslashes may be used to escape whitespace or
|
|---|
| 509 | +backslashes within an option.
|
|---|
| 510 | +.It Ev TAPE
|
|---|
| 511 | +Device or file to use for the archive if
|
|---|
| 512 | +.Fl \-file
|
|---|
| 513 | +is not specified.
|
|---|
| 514 | +If this environment variable is unset, use stdin or stdout instead.
|
|---|
| 515 | +.El
|
|---|
| 516 | +.Sh EXAMPLES
|
|---|
| 517 | +Create archive.tar from files foo and bar.
|
|---|
| 518 | +.Bd -literal -offset indent -compact
|
|---|
| 519 | +tar \-cf archive.tar foo bar
|
|---|
| 520 | +.Ed
|
|---|
| 521 | +List all files in archive.tar verbosely.
|
|---|
| 522 | +.Bd -literal -offset indent -compact
|
|---|
| 523 | +tar \-tvf archive.tar
|
|---|
| 524 | +.Ed
|
|---|
| 525 | +Extract all files from archive.tar.
|
|---|
| 526 | +.Bd -literal -offset indent -compact
|
|---|
| 527 | +tar \-xf archive.tar
|
|---|
| 528 | +.Ed
|
|---|
| 529 | +.Sh SEE ALSO
|
|---|
| 530 | +.\" libarchive
|
|---|
| 531 | +.Xr tar 5 ,
|
|---|
| 532 | +.\" man-pages
|
|---|
| 533 | +.Xr symlink 7 ,
|
|---|
| 534 | +.Xr rmt 8
|
|---|
| 535 | +.Sh HISTORY
|
|---|
| 536 | +The
|
|---|
| 537 | +.Nm tar
|
|---|
| 538 | +command appeared in
|
|---|
| 539 | +.At v7 .
|
|---|
| 540 | +.Sh BUGS
|
|---|
| 541 | +The GNU folks, in general, abhor man pages, and create info documents instead.
|
|---|
| 542 | +Unfortunately, the info document describing tar is licensed under the GFDL with
|
|---|
| 543 | +invariant cover texts, which makes it impossible to include any text
|
|---|
| 544 | +from that document in this man page.
|
|---|
| 545 | +Most of the text in this document was automatically extracted from the usage
|
|---|
| 546 | +text in the source.
|
|---|
| 547 | +It may not completely describe all features of the program.
|
|---|
