diff options
Diffstat (limited to 'archivers/libarchive/files/doc/html/bsdtar.1.html')
-rw-r--r-- | archivers/libarchive/files/doc/html/bsdtar.1.html | 160 |
1 files changed, 119 insertions, 41 deletions
diff --git a/archivers/libarchive/files/doc/html/bsdtar.1.html b/archivers/libarchive/files/doc/html/bsdtar.1.html index 92e798af951..8e9edc809a6 100644 --- a/archivers/libarchive/files/doc/html/bsdtar.1.html +++ b/archivers/libarchive/files/doc/html/bsdtar.1.html @@ -1,5 +1,5 @@ <!-- Creator : groff version 1.22.3 --> -<!-- CreationDate: Sun Jun 19 19:54:10 2016 --> +<!-- CreationDate: Sat Feb 25 11:22:08 2017 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -54,7 +54,7 @@ and ISO 9660 cdrom images and can create tar, pax, cpio, ar, zip, 7-zip, and shar archives.</p> <p style="margin-left:6%; margin-top: 1em">The first -synopsis form shows a ’’bundled’’ +synopsis form shows a ‘‘bundled’’ option word. This usage is provided for compatibility with historical implementations. See COMPATIBILITY below for details.</p> @@ -123,7 +123,7 @@ modes.</p> <p style="margin-top: 1em"><b>@</b><i>archive</i></p> -<p style="margin-left:17%;">(c and r mode only) The +<p style="margin-left:17%;">(c and r modes only) The specified archive is opened and the entries in it will be appended to the current archive. As a simple example,</p> @@ -179,7 +179,7 @@ format,</p> <i>archive.tgz source.c source.h</i></p> <p style="margin-left:17%;">ignores the -’’-j’’ option, and creates a new +‘‘-j’’ option, and creates a new archive with restricted pax format and gzip compression,</p> <p style="margin-left:24%;"><b>tar −a −jcf</b> @@ -189,6 +189,17 @@ archive with restricted pax format and gzip compression,</p> suffix, creates a new archive with restricted pax format and bzip2 compression.</p> +<p style="margin-top: 1em"><b>−−acls</b></p> + +<p style="margin-left:17%; margin-top: 1em">(c, r, u, x +modes only) Archive or extract POSIX.1e or NFSv4 ACLs. This +is the reverse of <b>−−no-acls</b> and the +default behavior in c, r, and u modes (except Mac OS X) or +if <b>tar</b> is run in x mode as root. On Mac OS X this +option translates extended ACLs to NFSv4 ACLs. To store +extended ACLs the <b>−−mac-metadata</b> option +is preferred.</p> + <p style="margin-top: 1em"><b>−B</b>, <b>−−read-full-blocks</b></p> @@ -227,12 +238,6 @@ to the current directory after processing any file system objects to replace them, clear platform-specific file flags that might prevent removal.</p> - -<p style="margin-top: 1em"><b>−−disable-copyfile</b></p> - -<p style="margin-left:17%;">Mac OS X specific. Disable the -use of copyfile(3).</p> - <p style="margin-top: 1em"><b>−−exclude</b> <i>pattern</i></p> @@ -241,15 +246,23 @@ directories that match the specified pattern. Note that exclusions take precedence over patterns or filenames specified on the command line.</p> +<p style="margin-top: 1em"><b>−−fflags</b></p> + +<p style="margin-left:17%;">(c, r, u, x modes only) Archive +or extract file flags. This is the reverse of +<b>−−no-fflags</b> and the default behavior in +c, r, and u modes or if <b>tar</b> is run in x mode as +root.</p> + <p style="margin-top: 1em"><b>−−format</b> <i>format</i></p> <p style="margin-left:17%;">(c, r, u mode only) Use the specified format for the created archive. Supported formats -include ’’cpio’’, -’’pax’’, -’’shar’’, and -’’ustar’’. Other formats may also be +include ‘‘cpio’’, +‘‘pax’’, +‘‘shar’’, and +‘‘ustar’’. Other formats may also be supported; see libarchive-formats(5) for more information about currently-supported formats. In r and u modes, when extending an existing archive, the format specified here @@ -290,14 +303,14 @@ group database.</p> <p style="margin-top: 1em"><b>−H</b></p> -<p style="margin-left:17%; margin-top: 1em">(c and r mode +<p style="margin-left:17%; margin-top: 1em">(c and r modes only) Symbolic links named on the command line will be followed; the target of the link will be archived, not the link itself.</p> <p style="margin-top: 1em"><b>−h</b></p> -<p style="margin-left:17%; margin-top: 1em">(c and r mode +<p style="margin-left:17%; margin-top: 1em">(c and r modes only) Synonym for <b>−L</b>.</p> <p style="margin-top: 1em"><b>−I</b></p> @@ -312,9 +325,9 @@ only) Synonym for <b>−L</b>.</p> <p style="margin-top: 1em"><b>−−hfsCompression</b></p> -<p style="margin-left:17%;">(x mode only) Mac OS X -specific(v10.6 or later). Compress extracted regular files -with HFS+ compression.</p> +<p style="margin-left:17%;">(x mode only) Mac OS X specific +(v10.6 or later). Compress extracted regular files with HFS+ +compression.</p> <p style="margin-top: 1em"><b>−−ignore-zeros</b></p> @@ -340,7 +353,7 @@ when filtering archives. For example, the command</p> <p style="margin-left:17%;">creates a new archive <i>new.tar</i> containing only the entries from -<i>old.tgz</i> containing the string ’foo’.</p> +<i>old.tgz</i> containing the string ‘foo’.</p> <p style="margin-top: 1em"><b>−J</b>, <b>−−xz</b></p> @@ -379,7 +392,7 @@ the archive being extracted.</p> <p style="margin-top: 1em"><b>−L</b>, <b>−−dereference</b></p> -<p style="margin-left:17%;">(c and r mode only) All +<p style="margin-left:17%;">(c and r modes only) All symbolic links will be followed. Normally, symbolic links are archived as such. With this option, the target of the link will be archived instead.</p> @@ -427,6 +440,16 @@ list modes, this option is ignored.</p> modification time. By default, the modification time is set to the time stored in the archive.</p> + +<p style="margin-top: 1em"><b>−−mac-metadata</b></p> + +<p style="margin-left:17%;">(c, r, u and x mode only) Mac +OS X specific. Archive or extract extended ACLs and extended +attributes using copyfile(3) in AppleDouble format. This is +the reverse of <b>−−no-mac-metadata</b>. and the +default behavior in c, r, and u modes or if <b>tar</b> is +run in x mode as root.</p> + <p style="margin-top: 1em"><b>−n</b>, <b>−−norecurse</b>, <b>−−no-recursion</b></p> @@ -487,6 +510,37 @@ often used to read filenames output by the <b>−print0</b> option to find(1).</p> +<p style="margin-top: 1em"><b>−−no-acls</b></p> + +<p style="margin-left:17%;">(c, r, u, x modes only) Do not +archive or extract POSIX.1e or NFSv4 ACLs. This is the +reverse of <b>−−acls</b> and the default +behavior if <b>tar</b> is run as non-root in x mode (on Mac +OS X also in c, r and u modes).</p> + + +<p style="margin-top: 1em"><b>−−no-fflags</b></p> + +<p style="margin-left:17%;">(c, r, u, x modes only) Do not +archive or extract file flags. This is the reverse of +<b>−−fflags</b> and the default behavior if +<b>tar</b> is run as non-root in x mode.</p> + + +<p style="margin-top: 1em"><b>−−no-mac-metadata</b></p> + +<p style="margin-left:17%;">(x mode only) Mac OS X +specific. Do not archive or extract ACLs and extended +attributes using copyfile(3) in AppleDouble format. This is +the reverse of <b>−−mac-metadata</b>. and the +default behavior if <b>tar</b> is run as non-root in x +mode.</p> + +<p style="margin-top: 1em"><b>−n</b>, +<b>−−norecurse</b>, +<b>−−no-recursion</b></p> + + <p style="margin-top: 1em"><b>−−no-same-owner</b></p> <p style="margin-left:17%;">(x mode only) Do not extract @@ -501,7 +555,19 @@ owner and group IDs. This is the reverse of full permissions (SGID, SUID, sticky bit, ACLs, extended attributes or extended file flags). This is the reverse of <b>−p</b> and the default behavior if <b>tar</b> is -run as non-root.</p> +run as non-root and can be overridden by also specifying +<b>−−acls</b>, <b>−−fflags</b>, +<b>−−mac-metadata, −−same-owner</b>, +<b>−−same-permissions</b> and +<b>−−xattrs</b>.</p> + + +<p style="margin-top: 1em"><b>−−no-xattrs</b></p> + +<p style="margin-left:17%;">(c, r, u, x modes only) Do not +archive or extract extended attributes. This is the reverse +of <b>−−xattrs</b> and the default behavior if +<b>tar</b> is run as non-root in x mode.</p> <p style="margin-top: 1em"><b>−−numeric-owner</b></p> @@ -692,7 +758,7 @@ output. Supported keywords include: <b>cksum</b>, <b>nlink</b>, <b>rmd160</b>, <b>sha1</b>, <b>sha256</b>, <b>sha384</b>, <b>sha512</b>, <b>size</b>, <b>time</b>, <b>uid</b>, <b>uname</b>. The default is equivalent to: -’’device, flags, gid, gname, link, mode, nlink, +‘‘device, flags, gid, gname, link, mode, nlink, size, time, type, uid, uname’’.</p> <p><b>mtree:all</b></p> @@ -759,12 +825,16 @@ option suppresses these behaviors.</p> <p style="margin-left:17%;">(x mode only) Preserve file permissions. Attempt to restore the full permissions, -including owner, file modes, file flags and ACLs, if -available, for each item extracted from the archive. This is -the default, if <b>tar</b> is being run by root and can be -overridden by also specifying -<b>−−no-same-owner</b> and -<b>−−no-same-permissions</b>.</p> +including owner, file modes, ACLs, extended atributes and +extended file flags, if available, for each item extracted +from the archive. This is the default, if <b>tar</b> is +being run by root and can be overridden by also specifying +<b>−−no-acls</b>, +<b>−−no-fflags</b>, +<b>−−no-mac-metadata, +−−no-same-owner</b>, +<b>−−no-same-permissions</b> and +<b>−−no-xattrs</b>.</p> <p style="margin-top: 1em"><b>−−passphrase</b> <i>passphrase</i></p> @@ -852,18 +922,18 @@ checks.</p> read the list of names to be extracted from <i>filename</i>. In c mode, <b>tar</b> will read names to be archived from <i>filename</i>. The special name -’’-C’’ on a line by itself will +‘‘-C’’ on a line by itself will cause the current directory to be changed to the directory specified on the following line. Names are terminated by newlines unless <b>−−null</b> is specified. Note that <b>−−null</b> also disables the special -handling of lines containing ’’-C’’. +handling of lines containing ‘‘-C’’. Note: If you are generating lists of files using find(1), you probably want to use <b>−n</b> as well.</p> <p style="margin-top: 1em"><b>−−totals</b></p> -<p style="margin-left:17%;">(c, r, u mode only) After +<p style="margin-left:17%;">(c, r, u modes only) After archiving all files, print a summary to stderr.</p> <p style="margin-top: 1em"><b>−U</b>, @@ -937,6 +1007,14 @@ patterns from the specified file. See <b>−−exclude</b> for more information about the handling of exclusions.</p> +<p style="margin-top: 1em"><b>−−xattrs</b></p> + +<p style="margin-left:17%;">(c, r, u, x modes only) Archive +or extract extended attributes. This is the reverse of +<b>−−no-xattrs</b> and the default behavior in +c, r, and u modes or if <b>tar</b> is run in x mode as +root.</p> + <p style="margin-top: 1em"><b>−y</b></p> <p style="margin-left:17%; margin-top: 1em">(c mode only) @@ -1080,10 +1158,10 @@ $ tar -cvf output.tar @input.mtree</p> <b>−−newer</b> and <b>−−newer-mtime</b> switches accept a variety of common date and time specifications, including -’’12 Mar 2005 7:14:29pm’’, -’’2005-03-12 19:14’’, -’’5 minutes ago’’, and -’’19:14 PST May 1’’.</p> +‘‘12 Mar 2005 7:14:29pm’’, +‘‘2005-03-12 19:14’’, +‘‘5 minutes ago’’, and +‘‘19:14 PST May 1’’.</p> <p style="margin-left:6%; margin-top: 1em">The <b>−−options</b> argument can be used to control @@ -1213,9 +1291,9 @@ libarchive-formats(5), tar(5)</p> <p style="margin-left:6%;">There is no current POSIX standard for the tar command; it appeared in ISO/IEC -9945-1:1996 (’’POSIX.1’’) but was +9945-1:1996 (‘‘POSIX.1’’) but was dropped from IEEE Std 1003.1-2001 -(’’POSIX.1’’). The options supported +(‘‘POSIX.1’’). The options supported by this implementation were developed by surveying a number of existing tar implementations as well as the old POSIX specification for tar and the current POSIX specification @@ -1223,7 +1301,7 @@ for pax.</p> <p style="margin-left:6%; margin-top: 1em">The ustar and pax interchange file formats are defined by IEEE Std -1003.1-2001 (’’POSIX.1’’) for the +1003.1-2001 (‘‘POSIX.1’’) for the pax command.</p> <p style="margin-top: 1em"><b>HISTORY</b></p> @@ -1245,7 +1323,7 @@ library. It was first released with FreeBSD 5.4 in May, <p style="margin-top: 1em"><b>BUGS</b></p> <p style="margin-left:6%;">This program follows ISO/IEC -9945-1:1996 (’’POSIX.1’’) for the +9945-1:1996 (‘‘POSIX.1’’) for the definition of the <b>−l</b> option. Note that GNU tar prior to version 1.15 treated <b>−l</b> as a synonym for the <b>−−one-file-system</b> option.</p> @@ -1314,7 +1392,7 @@ incompatible ways that different archive formats store hardlink information.)</p> <p style="margin-left:6%; margin-top: 1em">BSD -September 16, 2014 BSD</p> +February 24, 2017 BSD</p> <hr> </body> </html> |