bin/122600: [patch] Document tar -o option in c mode
Romain Tartiere
romain at blogreen.org
Wed Apr 9 15:40:02 UTC 2008
>Number: 122600
>Category: bin
>Synopsis: [patch] Document tar -o option in c mode
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-bugs
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Wed Apr 09 15:40:01 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator: Romain Tartiere
>Release: FreeBSD 7.0-STABLE i386
>Organization:
>Environment:
System: FreeBSD marvin.blogreen.org 7.0-STABLE FreeBSD 7.0-STABLE #12: Tue Mar 4 14:26:24 CET 2008 root at marvin.blogreen.org:/usr/obj/usr/src/sys/MARVIN i386
>Description:
Although bsdtar man page tells ...
| -o (x mode only) [SNIP]
... using -o in create mode is possible and has an impact on the generated tarball.
>How-To-Repeat:
> mkdir A
> tar cvf 1.tar A
a A
> tar covf 2.tar A
a A
> md5 1.tar 2.tar
MD5 (1.tar) = 7d829a3e65d463140258b1873641a5e1
MD5 (2.tar) = e6b7f9435cfb97ed0c93fac0893d9adc
>
>Fix:
According to src/usr.bin/tar/bsdtar.c:599, bsdtar attempt to behave like GNU tar:
599 case 'c':
600 /*
601 * In GNU tar, -o means "old format." The
602 * "ustar" format is the closest thing
603 * supported by libarchive.
604 */
605 bsdtar->create_format = "ustar";
606 /* TODO: bsdtar->create_format = "v7"; */
607 break;
The following patch completes the documentation:
--- patch-bsdtar.1 begins here ---
--- /usr/src/usr.bin/tar/bsdtar.1 2008-02-11 00:24:16.000000000 +0100
+++ bsdtar.1 2008-04-09 17:27:14.000000000 +0200
@@ -282,8 +282,11 @@
In list (-t) mode, the file listing will be written to stderr rather than
the usual stdout.
.It Fl o
-(x mode only)
-Use the user and group of the user running the program rather
+In c mode, attempt to be behave like GNU tar and create an old format
+archive using the
+.Dq ustar
+format.
+In x mode, use the user and group of the user running the program rather
than those specified in the archive.
Note that this has no significance unless
.Fl p
--- patch-bsdtar.1 ends here ---
>Release-Note:
>Audit-Trail:
>Unformatted:
More information about the freebsd-bugs
mailing list