diff options
Diffstat (limited to 'archivers/libarchive/files/doc/html/bsdtar.1.html')
-rw-r--r-- | archivers/libarchive/files/doc/html/bsdtar.1.html | 148 |
1 files changed, 74 insertions, 74 deletions
diff --git a/archivers/libarchive/files/doc/html/bsdtar.1.html b/archivers/libarchive/files/doc/html/bsdtar.1.html index ff7e6de0b15..8f42def5aad 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: Mon Sep 3 22:55:11 2018 --> +<!-- Creator : groff version 1.22.4 --> +<!-- CreationDate: Wed Jun 12 21:10:19 2019 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -54,10 +54,9 @@ 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’’ -option word. This usage is provided for compatibility with -historical implementations. See COMPATIBILITY below for -details.</p> +synopsis form shows a “bundled” option word. +This usage is provided for compatibility with historical +implementations. See COMPATIBILITY below for details.</p> <p style="margin-left:6%; margin-top: 1em">The other synopsis forms show the preferred usage. The first option to @@ -176,9 +175,9 @@ format,</p> <p style="margin-left:24%;"><b>tar -a -jcf</b> <i>archive.tgz source.c source.h</i></p> -<p style="margin-left:17%;">ignores the -’’-j’’ option, and creates a new -archive with restricted pax format and gzip compression,</p> +<p style="margin-left:17%;">ignores the “-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> <i>archive.xxx source.c source.h</i></p> @@ -232,7 +231,8 @@ options and before extracting any files.</p> <p style="margin-left:17%;">(x mode only) Before removing file system objects to replace them, clear platform-specific -file flags that might prevent removal.</p> +file attributes or file flags that might prevent +removal.</p> <p style="margin-top: 1em"><b>--exclude</b> <i>pattern</i></p> @@ -242,27 +242,34 @@ 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>--exclude-vcs</b></p> + +<p style="margin-left:17%;">Do not process files or +directories internally used by the version control systems +’CVS’, ’RCS’, ’SCCS’, +’SVN’, ’Arch’, ’Bazaar’, +’Mercurial’ and ’Darcs’.</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> +or extract platform-specific file attributes or 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 -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 -must be compatible with the format of the existing archive -on disk.</p> +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 must be compatible with the format of the +existing archive on disk.</p> <p style="margin-top: 1em"><b>-f</b> <i>file</i>, <b>--file</b> <i>file</i></p> @@ -443,16 +450,16 @@ to the time stored in the archive.</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> +file 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> -<p style="margin-left:17%;">(c, r, u modes only) Do not -recursively archive the contents of directories.</p> +<p style="margin-left:17%;">Do not operate recursively on +the content of directories.</p> <p style="margin-top: 1em"><b>--newer</b> <i>date</i></p> @@ -514,21 +521,18 @@ user in c, r, u and x 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> +archive or extract file attributes or 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 +specific. Do not archive or extract ACLs and extended file 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 @@ -540,17 +544,17 @@ is run as non-root.</p> <p style="margin-top: 1em"><b>--no-same-permissions</b></p> <p style="margin-left:17%;">(x mode only) Do not extract -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> +full permissions (SGID, SUID, sticky bit, file attributes or +file flags, extended file attributes and ACLs). This is the +reverse of <b>-p</b> and the default behavior if <b>tar</b> +is run as non-root.</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> +archive or extract extended file 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> @@ -739,8 +743,8 @@ 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, -size, time, type, uid, uname’’.</p> +“device, flags, gid, gname, link, mode, nlink, size, +time, type, uid, uname”.</p> <p><b>mtree:all</b></p> @@ -805,11 +809,11 @@ 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, ACLs, extended attributes and -extended file flags, if available, for each item extracted -from the archive. This is te reverse of +including file modes, file attributes or file flags, +extended file attributes and ACLs, if available, for each +item extracted from the archive. This is the reverse of <b>--no-same-permissions</b> and the default if <b>tar</b> -is being run by root and can be partially overridden by also +is being run as root. It can be partially overridden by also specifying <b>--no-acls</b>, <b>--no-fflags</b>, <b>--no-mac-metadata</b> or <b>--no-xattrs</b>.</p> @@ -894,13 +898,12 @@ checks.</p> <p style="margin-left:17%;">In x or t mode, <b>tar</b> will 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 -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’’. Note: If you are +<i>filename</i>. The special name “-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”. Note: If you are generating lists of files using find(1), you probably want to use <b>-n</b> as well.</p> @@ -974,7 +977,7 @@ 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 +or extract extended file 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> @@ -1118,10 +1121,9 @@ $ tar -cvf output.tar @input.mtree</p> <p style="margin-left:6%; margin-top: 1em">The <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 various @@ -1249,18 +1251,16 @@ 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 -dropped from IEEE Std 1003.1-2001 -(’’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 -for pax.</p> +9945-1:1996 (“POSIX.1”) but was dropped from +IEEE Std 1003.1-2001 (“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 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 -pax command.</p> +1003.1-2001 (“POSIX.1”) for the pax command.</p> <p style="margin-top: 1em"><b>HISTORY</b></p> @@ -1281,9 +1281,9 @@ 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 -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 +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> <p style="margin-left:6%; margin-top: 1em">The <b>-C</b> @@ -1349,8 +1349,8 @@ information to be lost. (This is a consequence of the incompatible ways that different archive formats store hardlink information.)</p> -<p style="margin-left:6%; margin-top: 1em">BSD -October 1, 2017 BSD</p> +<p style="margin-left:6%; margin-top: 1em">BSD June 3, +2019 BSD</p> <hr> </body> </html> |