| [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. |
|---|
