Changeset a569125 in freewrt for tools/paxmirabilis/src/tar.1
- Timestamp:
- Feb 16, 2012, 10:14:16 PM (14 years ago)
- Branches:
- freewrt_1_0, freewrt_2_0
- Children:
- 7417b08
- Parents:
- 3784d08
- File:
-
- 1 edited
-
tools/paxmirabilis/src/tar.1 (modified) (19 diffs)
Legend:
- Unmodified
- Added
- Removed
-
tools/paxmirabilis/src/tar.1
r3784d08 ra569125 1 .\" $MirOS: src/bin/pax/tar.1,v 1.11 2009/10/27 18:47:27 tg Exp $ 2 .\" $OpenBSD: tar.1,v 1.48 2007/05/31 19:19:15 jmc Exp $ 3 .\" 1 .\" $MirOS: src/bin/pax/tar.1,v 1.22 2012/02/12 02:49:41 tg Exp $ 2 .\" $OpenBSD: tar.1,v 1.55 2010/12/02 04:08:27 tedu Exp $ 3 .\" 4 .\" Copyright (c) 2005, 2008, 2009, 2011, 2012 5 .\" Thorsten Glaser <tg@mirbsd.org> 4 6 .\" Copyright (c) 1996 SigmaSoft, Th. Lockert 5 7 .\" All rights reserved. … … 24 26 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25 27 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 .\"27 .\" $OpenBSD: tar.1,v 1.48 2007/05/31 19:19:15 jmc Exp $28 .\"29 28 .\"- 30 29 .\" Try to make GNU groff and AT&T nroff more compatible 31 .\" * ` generates ‘ in g roff, so use \`32 .\" * ' generates ’ in g roff, \' generates ´, so use \*(aq33 .\" * - generates ‐ in g roff, \- generates −, fixed in tmac/mdoc/doc-groff30 .\" * ` generates ‘ in gnroff, so use \` 31 .\" * ' generates ’ in gnroff, \' generates ´, so use \*(aq 32 .\" * - generates ‐ in gnroff, \- generates −, so .tr it to - 34 33 .\" thus use - for hyphens and \- for minus signs and option dashes 35 34 .\" * ~ is size-reduced and placed atop in groff, so use \*(TI 36 35 .\" * ^ is size-reduced and placed atop in groff, so use \*(ha 37 36 .\" * \(en does not work in nroff, so use \*(en 37 .\" The section after the "doc" macropackage has been loaded contains 38 .\" additional code to convene between the UCB mdoc macropackage (and 39 .\" its variant as BSD mdoc in groff) and the GNU mdoc macropackage. 40 .\" 38 41 .ie \n(.g \{\ 42 . if \*[.T]ascii .tr \-\N'45' 43 . if \*[.T]latin1 .tr \-\N'45' 44 . if \*[.T]utf8 .tr \-\N'45' 45 . ds <= \[<=] 46 . ds >= \[>=] 47 . ds Rq \[rq] 48 . ds Lq \[lq] 49 . ds sL \(aq 50 . ds sR \(aq 51 . if \*[.T]utf8 .ds sL ` 52 . if \*[.T]ps .ds sL ` 53 . if \*[.T]utf8 .ds sR ' 54 . if \*[.T]ps .ds sR ' 39 55 . ds aq \(aq 40 56 . ds TI \(ti … … 50 66 .\" 51 67 .\" Implement .Dd with the Mdocdate RCS keyword 68 .\" 52 69 .rn Dd xD 53 70 .de Dd … … 61 78 .\" with -mandoc, it might implement .Mx itself, but we want to 62 79 .\" use our own definition. And .Dd must come *first*, always. 63 .Dd $Mdocdate: October 27 2009 $ 80 .\" 81 .Dd $Mdocdate: February 12 2012 $ 82 .\" 83 .\" Check which macro package we use 84 .\" 85 .ie \n(.g \{\ 86 . ie d volume-ds-1 .ds tT gnu 87 . el .ds tT bsd 88 .\} 89 .el .ds tT ucb 64 90 .\" 65 91 .\" Implement .Mx (MirBSD) 66 .de Mx 67 .nr cF \\n(.f 68 .nr cZ \\n(.s 69 .ds aa \&\f\\n(cF\s\\n(cZ 70 .if \\n(aC==0 \{\ 71 . ie \\n(.$==0 \&MirOS\\*(aa 72 . el .aV \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 73 .\} 74 .if \\n(aC>\\n(aP \{\ 75 . nr aP \\n(aP+1 76 . ie \\n(C\\n(aP==2 \{\ 77 . as b1 \&MirOS\ #\&\\*(A\\n(aP\\*(aa 78 . ie \\n(aC>\\n(aP \{\ 79 . nr aP \\n(aP+1 92 .\" 93 .ie "\*(tT"gnu" \{\ 94 . eo 95 . de Mx 96 . nr curr-font \n[.f] 97 . nr curr-size \n[.ps] 98 . ds str-Mx \f[\n[curr-font]]\s[\n[curr-size]u] 99 . ds str-Mx1 \*[Tn-font-size]\%MirOS\*[str-Mx] 100 . if !\n[arg-limit] \ 101 . if \n[.$] \{\ 102 . ds macro-name Mx 103 . parse-args \$@ 104 . \} 105 . if (\n[arg-limit] > \n[arg-ptr]) \{\ 106 . nr arg-ptr +1 107 . ie (\n[type\n[arg-ptr]] == 2) \ 108 . as str-Mx1 \~\*[arg\n[arg-ptr]] 109 . el \ 110 . nr arg-ptr -1 111 . \} 112 . ds arg\n[arg-ptr] "\*[str-Mx1] 113 . nr type\n[arg-ptr] 2 114 . ds space\n[arg-ptr] "\*[space] 115 . nr num-args (\n[arg-limit] - \n[arg-ptr]) 116 . nr arg-limit \n[arg-ptr] 117 . if \n[num-args] \ 118 . parse-space-vector 119 . print-recursive 120 .. 121 . ec 122 . ds sP \s0 123 . ds tN \*[Tn-font-size] 124 .\} 125 .el \{\ 126 . de Mx 127 . nr cF \\n(.f 128 . nr cZ \\n(.s 129 . ds aa \&\f\\n(cF\s\\n(cZ 130 . if \\n(aC==0 \{\ 131 . ie \\n(.$==0 \&MirOS\\*(aa 132 . el .aV \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 133 . \} 134 . if \\n(aC>\\n(aP \{\ 135 . nr aP \\n(aP+1 136 . ie \\n(C\\n(aP==2 \{\ 137 . as b1 \&MirOS\ #\&\\*(A\\n(aP\\*(aa 138 . ie \\n(aC>\\n(aP \{\ 139 . nr aP \\n(aP+1 140 . nR 141 . \} 142 . el .aZ 143 . \} 144 . el \{\ 145 . as b1 \&MirOS\\*(aa 80 146 . nR 81 147 . \} 82 . el .aZ83 148 . \} 84 . el \{\85 . as b1 \&MirOS\\*(aa86 . nR87 . \}88 .\}89 149 .. 90 .Dt TAR 1 150 .\} 151 .\"- 152 .ie \ng==1 \{\ 153 . ds nc mircpio 154 . ds np mirpax 155 . ds nt mirtar 156 . ds nm mirtar 157 . Dt MIRTAR 1 158 .\} 159 .el .ie \ng==2 \{\ 160 . ds nc paxcpio 161 . ds np pax 162 . ds nt paxtar 163 . ds nm paxtar 164 . Dt PAXTAR 1 165 .\} 166 .el \{\ 167 . ds nc cpio 168 . ds np pax 169 . ds nt tar 170 . ds nm tar 171 . Dt TAR 1 172 .\} 173 .\"- 91 174 .Os MirBSD 92 175 .Sh NAME 176 .ie \ng==1 \{\ 177 .Nm mirtar 178 .Nd tape archiver 179 .\} 180 .el .ie \ng==2 \{\ 181 .Nm paxtar 182 .Nd tape archiver 183 .\} 184 .el \{\ 93 185 .Nm tar 94 186 .Nd tape archiver 187 .\} 95 188 .Sh SYNOPSIS 96 .Nm tar189 .Nm \*(nm 97 190 .Sm off 98 .No { Cm crtux No } Op Cm 014578 befHhLmOoPRSpqsvwXZz191 .No { Cm crtux No } Op Cm 014578AbefHhJjLmNOoPRSpqsvwXZz 99 192 .Sm on 100 193 .Bk -words … … 102 195 .Op Fl C Ar directory 103 196 .Op Fl I Ar file 104 .Op Ar file ...197 .Op Ar 105 198 .Ek 106 .Pp 107 .Nm tar 199 .Nm \*(nm 108 200 .No { Ns Fl crtux Ns } 109 .Op Fl 014578eHhLmOoPpqRSvwXZz 201 .Bk -words 202 .Op Fl 014578AeHhJjLmNOoPpqRSvwXZz 110 203 .Op Fl b Ar blocking-factor 111 204 .Op Fl C Ar directory … … 114 207 .Op Fl M Ar flag 115 208 .Op Fl s Ar replstr 116 .Op Ar file ... 209 .Op Ar 210 .Ek 117 211 .Sh DESCRIPTION 118 212 The … … 132 226 .Nm 133 227 and must not be prefixed by a hyphen 134 .Pq Sq - .228 .Pq Sq \- . 135 229 Option arguments, if any, are processed as subsequent arguments to 136 230 .Nm … … 190 284 flags may be used: 191 285 .Bl -tag -width Ds 286 .It Fl A 287 Write Unix Archiver libraries instead of tape archives. 192 288 .It Fl b Ar blocking-factor 193 289 Set blocking factor to use for the archive. … … 221 317 This is a positional argument which reads the names of files to 222 318 archive or extract from the given file, one per line. 319 .It Fl J 320 Use the xz utility to compress the archive. 321 .It Fl j 322 Use the bzip2 utility to compress the archive. 223 323 .It Fl L 224 324 Synonym for the … … 228 328 Configure the archive normaliser. 229 329 .Ar flag 230 is either a num ber or a string, optionally prefixed with231 . Dq no-232 to turn it off. 233 See 234 . Xr cpio 1235 for a comprehensive list and compatibility notes. 330 is either a numeric value compatible to 331 .Xr strtonum 3 332 which is directly stored in the flags word, or 333 one of the following values, optionally prefixed with 334 .Dq no\- 335 to turn them off: 236 336 .Pp 237 337 .Bl -tag -width xxxxxx -compact 238 338 .It Ar inodes 239 339 0x0001: Serialise inodes, zero device info. 340 .br 341 (cpio, sv4cpio, sv4crc) 240 342 .It Ar links 241 343 0x0002: Store content of hard links only once. 344 .br 345 (cpio, sv4cpio, sv4crc) 242 346 .It Ar mtime 243 347 0x0004: Zero out the file modification time. 348 .br 349 (ar, cpio, sv4cpio, sv4crc, ustar) 244 350 .It Ar uidgid 245 351 0x0008: Set owner to 0:0 (root:wheel). 352 .br 353 (ar, cpio, sv4cpio, sv4crc, ustar) 354 .It Ar verb 355 0x0010: Debug this option. 356 .It Ar debug 357 0x0020: Debug file header storage. 246 358 .It Ar lncp 247 0x0040: Extract hard links by copying if linking fails. 359 0x0040: Extract hard links by copy if link fails. 360 .It Ar numid 361 0x0080: Use only numeric uid and gid values. 362 .br 363 (ustar) 364 .It Ar gslash 365 0x0100: Append a slash after directory names. 366 .br 367 (ustar) 368 .It Ar set 369 0x0003: Keep ownership and mtime intact. 370 .It Ar dist 371 0x008B: Clean everything except mtime. 372 .It Ar norm 373 0x008F: Clean everything. 374 .It Ar root 375 0x0089: Clean owner and device information. 248 376 .El 249 377 .Pp 250 This option is only implemented for the cpio, sv4cpio,378 This option is only implemented for the ar, cpio, sv4cpio, 251 379 sv4crc, and ustar file format writing routines. 252 For the ustar format, the253 .Ar inodes254 and255 .Ar links256 specifiers are ignored.257 380 .It Fl m 258 381 Do not preserve modification time. 382 .It Fl N 383 Same as 384 .Fl M Ar numid . 259 385 .It Fl O 260 386 If reading, extract files to standard output. … … 263 389 .It Fl o 264 390 Don't write directory information that the older (V7) style 265 .Nm 391 .Nm tar 266 392 is unable to decode. 267 393 This implies the … … 353 479 standard error in the following format: 354 480 .Pp 355 .D1 Em original-pathname No >>Em new-pathname481 .D1 Em original-pathname No \*(Gt\*(Gt Em new-pathname 356 482 .Pp 357 483 File or archive member names that substitute to the empty string … … 368 494 Do not cross mount points in the file system. 369 495 .It Fl Z 370 Compress archive using 371 .Xr compress 1 . 496 Use the 497 .Xr compress 1 498 utility to compress the archive. 372 499 .It Fl z 373 Compress archive using 374 .Xr gzip 1 . 500 Use the 501 .Xr gzip 1 502 utility to compress the archive. 375 503 .El 376 504 .Pp … … 392 520 default archive name 393 521 .El 522 .Sh EXIT STATUS 523 The 524 .Nm 525 utility exits with one of the following values: 526 .Pp 527 .Bl -tag -width Ds -offset indent -compact 528 .It 0 529 All files were processed successfully. 530 .It 1 531 An error occurred. 532 .El 394 533 .Sh EXAMPLES 395 534 Create an archive on the default tape drive, containing the files named … … 398 537 .Pa sekve : 399 538 .Pp 400 .Dl $ tarc bonvole sekve539 .Dl $ \*(nm c bonvole sekve 401 540 .Pp 402 541 Output a … … 409 548 .Pa foriru.tar.gz : 410 549 .Pp 411 .Dl $ tarzcf foriru.tar.gz bonvole sekve550 .Dl $ \*(nm zcf foriru.tar.gz bonvole sekve 412 551 .Pp 413 552 Verbosely create an archive, called … … 418 557 .Pa *.c : 419 558 .Pp 420 .Dl $ tarzcvf backup.tar.gz *.c559 .Dl $ \*(nm zcvf backup.tar.gz *.c 421 560 .Pp 422 561 Verbosely list, but do not extract, all files ending in … … 426 565 Note that the glob pattern has been quoted to avoid expansion by the shell: 427 566 .Pp 428 .Dl $ tar tvzf backup.tar.gz '*.jpeg'567 .Dl $ \*(nm tvzf backup.tar.gz \*(aq*.jpeg\*(aq 429 568 .Pp 430 569 For more detailed examples, see 431 .Xr pax1 .570 .Xr \*(np 1 . 432 571 .Sh DIAGNOSTICS 433 .Nm434 will exit with one of the following values:435 .Bl -tag -width 2n -offset indent436 .It 0437 All files were processed successfully.438 .It 1439 An error occurred.440 .El441 .Pp442 572 Whenever 443 573 .Nm … … 472 602 specific archive format specification. 473 603 .Sh SEE ALSO 604 .Xr ar 1 , 474 605 .Xr cpio 1 , 606 .ie \ng==1 \{\ 607 .Xr mircpio 1 , 608 .Xr mirpax 1 , 609 .Xr pax 1 , 610 .Xr tar 1 , 611 .Xr deb 5 612 .\} 613 .el .ie \ng==2 \{\ 614 .Xr pax 1 , 615 .Xr paxcpio 1 , 616 .Xr tar 1 , 617 .Xr deb 5 618 .\} 619 .el \{\ 475 620 .Xr pax 1 621 .\} 476 622 .Sh HISTORY 477 623 A 478 .Nm 624 .Nm tar 479 625 command first appeared in 480 626 .At v7 . 481 627 .Sh AUTHORS 482 628 Keith Muller at the University of California, San Diego. 629 .Pp 630 .Mx 631 extensions by 632 .An Thorsten Glaser Aq tg@mirbsd.org . 483 633 .Sh CAVEATS 484 The 485 .Fl L 486 flag is not portable to other versions of 487 .Nm 488 where it may have a different meaning. 489 The 490 .Fl R , 491 .Fl S , 492 and 493 .Fl M 494 options are extensions specific to 495 .Mx . 634 The flags 635 .Fl AJjLMNRS 636 are not portable to other implementations of 637 .Nm tar 638 where they may have a different meaning.
Note:
See TracChangeset
for help on using the changeset viewer.
