source-git / libarchive

Clone
Source Code
GIT

Blame doc/html/archive_write_set_options.3.html

c8 c8s master
  1.   cc8190ec3d70c1de180e29fbbd40106e3d7cc46b
  2.   doc
  3.   html
  4.   archive_write_set_options.3.html
Blob History Raw
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
"http://www.w3.org/TR/html4/loose.dtd">
Packit Service 1d0348 
<html>
Packit Service 1d0348 
<head>
Packit Service 1d0348 
<meta name="generator" content="groff -Thtml, see www.gnu.org">
Packit Service 1d0348 
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
Packit Service 1d0348 
<meta name="Content-Style" content="text/css">
Packit Service 1d0348 
<style type="text/css">
Packit Service 1d0348 
       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
Packit Service 1d0348 
       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
Packit Service 1d0348 
       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
Packit Service 1d0348 
       h1      { text-align: center }
Packit Service 1d0348 
</style>
Packit Service 1d0348 
<title></title>
Packit Service 1d0348 
</head>
Packit Service 1d0348 
<body>
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
ARCHIVE_WRITE_OPTIONS(3) BSD Library Functions Manual
Packit Service 1d0348 
ARCHIVE_WRITE_OPTIONS(3)
Packit Service 1d0348
Packit Service 1d0348 
NAME
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_filter_option,
Packit Service 1d0348 
archive_write_set_format_option,
Packit Service 1d0348 
archive_write_set_option,
Packit Service 1d0348 
archive_write_set_options — functions
Packit Service 1d0348 
controlling options for writing archives
Packit Service 1d0348
Packit Service 1d0348 
LIBRARY
Packit Service 1d0348
Packit Service 1d0348 
Streaming Archive Library
Packit Service 1d0348 
(libarchive, -larchive)
Packit Service 1d0348
Packit Service 1d0348 
SYNOPSIS
Packit Service 1d0348
Packit Service 1d0348 
int
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_filter_option(struct archive *,
Packit Service 1d0348 
const char *module,
Packit Service 1d0348 
const char *option,
Packit Service 1d0348 
const char *value);
Packit Service 1d0348
Packit Service 1d0348 
int
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_format_option(struct archive *,
Packit Service 1d0348 
const char *module,
Packit Service 1d0348 
const char *option,
Packit Service 1d0348 
const char *value);
Packit Service 1d0348
Packit Service 1d0348 
int
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_option(struct archive *,
Packit Service 1d0348 
const char *module,
Packit Service 1d0348 
const char *option,
Packit Service 1d0348 
const char *value);
Packit Service 1d0348
Packit Service 1d0348 
int
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_options(struct archive *,
Packit Service 1d0348 
const char *options);
Packit Service 1d0348
Packit Service 1d0348 
DESCRIPTION
Packit Service 1d0348
Packit Service 1d0348 
These functions provide a way
Packit Service 1d0348 
for libarchive clients to configure specific write
Packit Service 1d0348 
modules.
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_filter_option(),
Packit Service 1d0348 
archive_write_set_format_option()
Packit Service 1d0348
Packit Service 1d0348 
Specifies an option that will
Packit Service 1d0348 
be passed to currently-registered filters (including
Packit Service 1d0348 
decompression filters) or format readers.
Packit Service 1d0348
Packit Service 1d0348 
If
Packit Service 1d0348 
option and value are both NULL, these
Packit Service 1d0348 
functions will do nothing and ARCHIVE_OK will be
Packit Service 1d0348 
returned. If option is NULL but value is not,
Packit Service 1d0348 
these functions will do nothing and ARCHIVE_FAILED
Packit Service 1d0348 
will be returned.
Packit Service 1d0348
Packit Service 1d0348 
If
Packit Service 1d0348 
module is not NULL, option and value
Packit Service 1d0348 
will be provided to the filter or reader named
Packit Service 1d0348 
module. The return value will be either
Packit Service 1d0348 
ARCHIVE_OK if the option was successfully handled or
Packit Service 1d0348 
ARCHIVE_WARN if the option was unrecognized by the
Packit Service 1d0348 
module or could otherwise not be handled. If there is no
Packit Service 1d0348 
such module, ARCHIVE_FAILED will be returned.
Packit Service 1d0348
Packit Service 1d0348 
If
Packit Service 1d0348 
module is NULL, option and value will
Packit Service 1d0348 
be provided to every registered module. If any module
Packit Service 1d0348 
returns ARCHIVE_FATAL, this value will be returned
Packit Service 1d0348 
immediately. Otherwise, ARCHIVE_OK will be returned
Packit Service 1d0348 
if any module accepts the option, and ARCHIVE_FAILED
Packit Service 1d0348 
in all other cases.
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_option()
Packit Service 1d0348
Packit Service 1d0348 
Calls
Packit Service 1d0348 
archive_write_set_format_option(), then
Packit Service 1d0348 
archive_write_set_filter_option(). If either function
Packit Service 1d0348 
returns ARCHIVE_FATAL, ARCHIVE_FATAL will be
Packit Service 1d0348 
returned immediately. Otherwise, greater of the two values
Packit Service 1d0348 
will be returned.
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
archive_write_set_options()
Packit Service 1d0348
Packit Service 1d0348 
options is a
Packit Service 1d0348 
comma-separated list of options. If options is NULL
Packit Service 1d0348 
or empty, ARCHIVE_OK will be returned
Packit Service 1d0348 
immediately.
Packit Service 1d0348
Packit Service 1d0348 
Individual
Packit Service 1d0348 
options have one of the following forms:
Packit Service 1d0348
Packit Service 1d0348 
option=value
Packit Service 1d0348
Packit Service 1d0348 
The option/value pair will be
Packit Service 1d0348 
provided to every module. Modules that do not accept an
Packit Service 1d0348 
option with this name will ignore it.
Packit Service 1d0348
Packit Service 1d0348 
option
Packit Service 1d0348
Packit Service 1d0348 
The option will
Packit Service 1d0348 
be provided to every module with a value of
Packit Service 1d0348 
’’1’’.
Packit Service 1d0348
Packit Service 1d0348 
!option
Packit Service 1d0348
Packit Service 1d0348 
The option will be provided to
Packit Service 1d0348 
every module with a NULL value.
Packit Service 1d0348
Packit Service 1d0348 
module:option=value, module:option,
Packit Service 1d0348 
module:!option
Packit Service 1d0348
Packit Service 1d0348 
As above, but the corresponding
Packit Service 1d0348 
option and value will be provided only to modules whose name
Packit Service 1d0348 
matches module.
Packit Service 1d0348
Packit Service 1d0348 
OPTIONS
Packit Service 1d0348 
Filter gzip
Packit Service 1d0348 
compression-level
Packit Service 1d0348
Packit Service 1d0348 
The value is interpreted as a
Packit Service 1d0348 
decimal integer specifying the gzip compression level.
Packit Service 1d0348
Packit Service 1d0348 
Filter xz
Packit Service 1d0348 
compression-level
Packit Service 1d0348
Packit Service 1d0348 
The value is interpreted as a
Packit Service 1d0348 
decimal integer specifying the compression level.
Packit Service 1d0348
Packit Service 1d0348 
Format mtree
Packit Service 1d0348 
cksum, device, flags, gid,
Packit Service 1d0348 
gname, indent, link, md5,
Packit Service 1d0348 
mode, nlink, rmd160, sha1,
Packit Service 1d0348 
sha256, sha384, sha512, size,
Packit Service 1d0348 
time, uid, uname
Packit Service 1d0348
Packit Service 1d0348 
Enable a particular keyword in
Packit Service 1d0348 
the mtree output. Prefix with an exclamation mark to disable
Packit Service 1d0348 
the corresponding keyword. The default is equivalent to
Packit Service 1d0348 
’’device, flags, gid, gname, link, mode, nlink,
Packit Service 1d0348 
size, time, type, uid, uname’’.
Packit Service 1d0348
Packit Service 1d0348 
all
Packit Service 1d0348
Packit Service 1d0348 
Enables all of
Packit Service 1d0348 
the above keywords.
Packit Service 1d0348
Packit Service 1d0348 
use-set
Packit Service 1d0348
Packit Service 1d0348 
Enables generation of
Packit Service 1d0348 
/set lines that specify default values for the
Packit Service 1d0348 
following files and/or directories.
Packit Service 1d0348
Packit Service 1d0348 
indent
Packit Service 1d0348
Packit Service 1d0348 
XXX needs
Packit Service 1d0348 
explanation XXX
Packit Service 1d0348
Packit Service 1d0348 
Format iso9660 - volume metadata
Packit Service 1d0348
Packit Service 1d0348 
These options are used to set
Packit Service 1d0348 
standard ISO9660 metadata.
Packit Service 1d0348
Packit Service 1d0348 
abstract-file=filename
Packit Service 1d0348
Packit Service 1d0348 
The file with the specified
Packit Service 1d0348 
name will be identified in the ISO9660 metadata as holding
Packit Service 1d0348 
the abstract for this volume. Default: none.
Packit Service 1d0348
Packit Service 1d0348 
application-id=filename
Packit Service 1d0348
Packit Service 1d0348 
The file with the specified
Packit Service 1d0348 
name will be identified in the ISO9660 metadata as holding
Packit Service 1d0348 
the application identifier for this volume. Default:
Packit Service 1d0348 
none.
Packit Service 1d0348
Packit Service 1d0348 
biblio-file=filename
Packit Service 1d0348
Packit Service 1d0348 
The file with the specified
Packit Service 1d0348 
name will be identified in the ISO9660 metadata as holding
Packit Service 1d0348 
the bibliography for this volume. Default: none.
Packit Service 1d0348
Packit Service 1d0348 
copyright-file=filename
Packit Service 1d0348
Packit Service 1d0348 
The file with the specified
Packit Service 1d0348 
name will be identified in the ISO9660 metadata as holding
Packit Service 1d0348 
the copyright for this volume. Default: none.
Packit Service 1d0348
Packit Service 1d0348 
publisher=filename
Packit Service 1d0348
Packit Service 1d0348 
The file with the specified
Packit Service 1d0348 
name will be identified in the ISO9660 metadata as holding
Packit Service 1d0348 
the publisher information for this volume. Default:
Packit Service 1d0348 
none.
Packit Service 1d0348
Packit Service 1d0348 
volume-id=string
Packit Service 1d0348
Packit Service 1d0348 
The specified string will be
Packit Service 1d0348 
used as the Volume Identifier in the ISO9660 metadata. It is
Packit Service 1d0348 
limited to 32 bytes. Default: none.
Packit Service 1d0348
Packit Service 1d0348 
Format iso9660 - boot support
Packit Service 1d0348
Packit Service 1d0348 
These options are used to make
Packit Service 1d0348 
an ISO9660 image that can be directly booted on various
Packit Service 1d0348 
systems.
Packit Service 1d0348
Packit Service 1d0348 
boot=filename
Packit Service 1d0348
Packit Service 1d0348 
The file matching this name
Packit Service 1d0348 
will be used as the El Torito boot image file.
Packit Service 1d0348
Packit Service 1d0348 
boot-catalog=name
Packit Service 1d0348
Packit Service 1d0348 
The name that will be used for
Packit Service 1d0348 
the El Torito boot catalog. Default: boot.catalog
Packit Service 1d0348
Packit Service 1d0348 
boot-info-table
Packit Service 1d0348
Packit Service 1d0348 
The boot image file provided by
Packit Service 1d0348 
the boot=filename option will be edited with
Packit Service 1d0348 
appropriate boot information in bytes 8 through 64. Default:
Packit Service 1d0348 
disabled
Packit Service 1d0348
Packit Service 1d0348 
boot-load-seg=hexadecimal-number
Packit Service 1d0348
Packit Service 1d0348 
The load segment for a
Packit Service 1d0348 
no-emulation boot image.
Packit Service 1d0348
Packit Service 1d0348 
boot-load-size=decimal-number
Packit Service 1d0348
Packit Service 1d0348 
The number of
Packit Service 1d0348 
"virtual" 512-byte sectors to be loaded from a
Packit Service 1d0348 
no-emulation boot image. Some very old BIOSes can only load
Packit Service 1d0348 
very small images, setting this value to 4 will often allow
Packit Service 1d0348 
such BIOSes to load the first part of the boot image (which
Packit Service 1d0348 
will then need to be intelligent enough to load the rest of
Packit Service 1d0348 
itself). This should not be needed unless you are trying to
Packit Service 1d0348 
support systems with very old BIOSes. This defaults to the
Packit Service 1d0348 
full size of the image.
Packit Service 1d0348
Packit Service 1d0348 
boot-type=value
Packit Service 1d0348
Packit Service 1d0348 
Specifies the boot semantics
Packit Service 1d0348 
used by the El Torito boot image: If the value is
Packit Service 1d0348 
fd, then the boot image is assumed to be a bootable
Packit Service 1d0348 
floppy image. If the value is hd, then the
Packit Service 1d0348 
boot image is assumed to be a bootable hard disk image. If
Packit Service 1d0348 
the value is no-emulation, the boot image is
Packit Service 1d0348 
used without floppy or hard disk emulation. If the boot
Packit Service 1d0348 
image is exactly 1.2MB, 1.44MB, or 2.88MB, then the default
Packit Service 1d0348 
is fd, otherwise the default is
Packit Service 1d0348 
no-emulation.
Packit Service 1d0348
Packit Service 1d0348 
Format iso9660 - filename and size extensions
Packit Service 1d0348
Packit Service 1d0348 
Various extensions to the base
Packit Service 1d0348 
ISO9660 format.
Packit Service 1d0348
Packit Service 1d0348 
allow-ldots
Packit Service 1d0348
Packit Service 1d0348 
If enabled, allows filenames to
Packit Service 1d0348 
begin with a leading period. If disabled, filenames that
Packit Service 1d0348 
begin with a leading period will have that period replaced
Packit Service 1d0348 
by an underscore character in the standard ISO9660
Packit Service 1d0348 
namespace. This does not impact names stored in the
Packit Service 1d0348 
Rockridge or Joliet extension area. Default: disabled.
Packit Service 1d0348
Packit Service 1d0348 
allow-lowercase
Packit Service 1d0348
Packit Service 1d0348 
If enabled, allows filenames to
Packit Service 1d0348 
contain lowercase characters. If disabled, filenames will be
Packit Service 1d0348 
forced to uppercase. This does not impact names stored in
Packit Service 1d0348 
the Rockridge or Joliet extension area. Default:
Packit Service 1d0348 
disabled.
Packit Service 1d0348
Packit Service 1d0348 
allow-multidot
Packit Service 1d0348
Packit Service 1d0348 
If enabled, allows filenames to
Packit Service 1d0348 
contain multiple period characters, in violation of the
Packit Service 1d0348 
ISO9660 specification. If disabled, additional periods will
Packit Service 1d0348 
be converted to underscore characters. This does not impact
Packit Service 1d0348 
names stored in the Rockridge or Joliet extension area.
Packit Service 1d0348 
Default: disabled.
Packit Service 1d0348
Packit Service 1d0348 
allow-period
Packit Service 1d0348
Packit Service 1d0348 
If enabled, allows filenames to
Packit Service 1d0348 
contain trailing period characters, in violation of the
Packit Service 1d0348 
ISO9660 specification. If disabled,trailing periods will be
Packit Service 1d0348 
converted to underscore characters. This does not impact
Packit Service 1d0348 
names stored in the Rockridge or Joliet extension area.
Packit Service 1d0348 
Default: disabled.
Packit Service 1d0348
Packit Service 1d0348 
allow-pvd-lowercase
Packit Service 1d0348
Packit Service 1d0348 
If enabled, the Primary Volume
Packit Service 1d0348 
Descriptor may contain lowercase ASCII characters, in
Packit Service 1d0348 
violation of the ISO9660 specification. If disabled,
Packit Service 1d0348 
characters will be converted to uppercase ASCII. Default:
Packit Service 1d0348 
disabled.
Packit Service 1d0348
Packit Service 1d0348 
allow-sharp-tilde
Packit Service 1d0348
Packit Service 1d0348 
If enabled, sharp and tilde
Packit Service 1d0348 
characters will be permitted in filenames, in violation if
Packit Service 1d0348 
the ISO9660 specification. If disabled, such characters will
Packit Service 1d0348 
be converted to underscore characters. Default:
Packit Service 1d0348 
disabled.
Packit Service 1d0348
Packit Service 1d0348 
allow-vernum
Packit Service 1d0348
Packit Service 1d0348 
If enabled, version numbers
Packit Service 1d0348 
will be included with files. If disabled, version numbers
Packit Service 1d0348 
will be suppressed, in violation of the ISO9660 standard.
Packit Service 1d0348 
This does not impact names stored in the Rockridge or Joliet
Packit Service 1d0348 
extension area. Default: enabled.
Packit Service 1d0348
Packit Service 1d0348 
iso-level
Packit Service 1d0348
Packit Service 1d0348 
This enables support for file
Packit Service 1d0348 
size and file name extensions in the core ISO9660 area. The
Packit Service 1d0348 
name extensions specified here do not affect the names
Packit Service 1d0348 
stored in the Rockridge or Joliet extension areas.
Packit Service 1d0348
Packit Service 1d0348 
iso-level=1
Packit Service 1d0348
Packit Service 1d0348 
The most compliant form of
Packit Service 1d0348 
ISO9660 image. Filenames are limited to 8.3 uppercase
Packit Service 1d0348 
format, directory names are limited to 8 uppercase
Packit Service 1d0348 
characters, files are limited to 4 GiB, the complete ISO9660
Packit Service 1d0348 
image cannot exceed 4 GiB.
Packit Service 1d0348
Packit Service 1d0348 
iso-level=2
Packit Service 1d0348
Packit Service 1d0348 
Filenames are limited to 30
Packit Service 1d0348 
uppercase characters with a 30-character extension,
Packit Service 1d0348 
directory names are limited to 30 characters, files are
Packit Service 1d0348 
limited to 4 GiB.
Packit Service 1d0348
Packit Service 1d0348 
iso-level=3
Packit Service 1d0348
Packit Service 1d0348 
As with iso-level=2,
Packit Service 1d0348 
except that files may exceed 4 GiB.
Packit Service 1d0348
Packit Service 1d0348 
iso-level=4
Packit Service 1d0348
Packit Service 1d0348 
As with iso-level=3,
Packit Service 1d0348 
except that filenames may be up to 193 characters and may
Packit Service 1d0348 
include arbitrary 8-bit characters.
Packit Service 1d0348
Packit Service 1d0348 
joliet
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348 
Microsoft’s
Packit Service 1d0348 
Joliet extensions store a completely separate set of
Packit Service 1d0348 
directory information about each file. In particular, this
Packit Service 1d0348 
information includes Unicode filenames of up to 255
Packit Service 1d0348 
characters. Default: enabled.
Packit Service 1d0348
Packit Service 1d0348 
limit-depth
Packit Service 1d0348
Packit Service 1d0348 
If enabled, libarchive will use
Packit Service 1d0348 
directory relocation records to ensure that no pathname
Packit Service 1d0348 
exceeds the ISO9660 limit of 8 directory levels. If
Packit Service 1d0348 
disabled, no relocation will occur. Default: enabled.
Packit Service 1d0348
Packit Service 1d0348 
limit-dirs
Packit Service 1d0348
Packit Service 1d0348 
If enabled, libarchive will
Packit Service 1d0348 
cause an error if there are more than 65536 directories. If
Packit Service 1d0348 
disabled, there is no limit on the number of directories.
Packit Service 1d0348 
Default: enabled
Packit Service 1d0348
Packit Service 1d0348 
pad
Packit Service 1d0348
Packit Service 1d0348 
If enabled, 300
Packit Service 1d0348 
kiB of zero bytes will be appended to the end of the
Packit Service 1d0348 
archive. Default: enabled
Packit Service 1d0348
Packit Service 1d0348 
relaxed-filenames
Packit Service 1d0348
Packit Service 1d0348 
If enabled, all 7-bit ASCII
Packit Service 1d0348 
characters are permitted in filenames (except lowercase
Packit Service 1d0348 
characters unless allow-lowercase is also specified).
Packit Service 1d0348 
This violates ISO9660 standards. This does not impact names
Packit Service 1d0348 
stored in the Rockridge or Joliet extension area. Default:
Packit Service 1d0348 
disabled.
Packit Service 1d0348
Packit Service 1d0348 
rockridge
Packit Service 1d0348
Packit Service 1d0348 
The Rockridge extensions store
Packit Service 1d0348 
an additional set of POSIX-style file information with each
Packit Service 1d0348 
file, including mtime, atime, ctime, permissions, and long
Packit Service 1d0348 
filenames with arbitrary 8-bit characters. These extensions
Packit Service 1d0348 
also support symbolic links and other POSIX file types.
Packit Service 1d0348 
Default: enabled.
Packit Service 1d0348
Packit Service 1d0348 
Format iso9660 - zisofs support
Packit Service 1d0348
Packit Service 1d0348 
The zisofs extensions permit
Packit Service 1d0348 
each file to be independently compressed using a
Packit Service 1d0348 
gzip-compatible compression. This can provide significant
Packit Service 1d0348 
size savings, but requires the reading system to have
Packit Service 1d0348 
support for these extensions. These extensions are disabled
Packit Service 1d0348 
by default.
Packit Service 1d0348
Packit Service 1d0348 
compression-level=number
Packit Service 1d0348
Packit Service 1d0348 
The compression level used by
Packit Service 1d0348 
the deflate compressor. Ranges from 0 (least effort) to 9
Packit Service 1d0348 
(most effort). Default: 6
Packit Service 1d0348
Packit Service 1d0348 
zisofs
Packit Service 1d0348
Packit Service 1d0348 
Synonym for
Packit Service 1d0348 
zisofs=direct.
Packit Service 1d0348
Packit Service 1d0348 
zisofs=direct
Packit Service 1d0348
Packit Service 1d0348 
Compress each file in the
Packit Service 1d0348 
archive. Unlike zisofs=indirect, this is handled
Packit Service 1d0348 
entirely within libarchive and does not require a separate
Packit Service 1d0348 
utility. For best results, libarchive tests each file and
Packit Service 1d0348 
will store the file uncompressed if the compression does not
Packit Service 1d0348 
actually save any space. In particular, files under 2k will
Packit Service 1d0348 
never be compressed. Note that boot image files are never
Packit Service 1d0348 
compressed.
Packit Service 1d0348
Packit Service 1d0348 
zisofs=indirect
Packit Service 1d0348
Packit Service 1d0348 
Recognizes files that have
Packit Service 1d0348 
already been compressed with the mkzftree utility and
Packit Service 1d0348 
sets up the necessary file metadata so that readers will
Packit Service 1d0348 
correctly identify these as zisofs-compressed files.
Packit Service 1d0348
Packit Service 1d0348 
zisofs-exclude=filename
Packit Service 1d0348
Packit Service 1d0348 
Specifies a filename that
Packit Service 1d0348 
should not be compressed when using zisofs=direct.
Packit Service 1d0348 
This option can be provided multiple times to suppress
Packit Service 1d0348 
compression on many files.
Packit Service 1d0348
Packit Service 1d0348 
Format zip
Packit Service 1d0348 
compression
Packit Service 1d0348
Packit Service 1d0348 
The value is either
Packit Service 1d0348 
’’store’’ or
Packit Service 1d0348 
’’deflate’’ to indicate how the
Packit Service 1d0348 
following entries should be compressed. Note that this
Packit Service 1d0348 
setting is ignored for directories, symbolic links, and
Packit Service 1d0348 
other special entries.
Packit Service 1d0348
Packit Service 1d0348 
experimental
Packit Service 1d0348
Packit Service 1d0348 
This boolean option enables or
Packit Service 1d0348 
disables experimental Zip features that may not be
Packit Service 1d0348 
compatible with other Zip implementations.
Packit Service 1d0348
Packit Service 1d0348 
fakecrc32
Packit Service 1d0348
Packit Service 1d0348 
This boolean option disables
Packit Service 1d0348 
CRC calculations. All CRC fields are set to zero. It should
Packit Service 1d0348 
not be used except for testing purposes.
Packit Service 1d0348
Packit Service 1d0348 
hdrcharset
Packit Service 1d0348
Packit Service 1d0348 
This sets the character set
Packit Service 1d0348 
used for filenames.
Packit Service 1d0348
Packit Service 1d0348 
zip64
Packit Service 1d0348
Packit Service 1d0348 
Zip64
Packit Service 1d0348 
extensions provide additional file size information for
Packit Service 1d0348 
entries larger than 4 GiB. They also provide extended file
Packit Service 1d0348 
offset and archive size information when archives exceed 4
Packit Service 1d0348 
GiB. By default, the Zip writer selectively enables these
Packit Service 1d0348 
extensions only as needed. In particular, if the file size
Packit Service 1d0348 
is unknown, the Zip writer will include Zip64 extensions to
Packit Service 1d0348 
guard against the possibility that the file might be larger
Packit Service 1d0348 
than 4 GiB.
Packit Service 1d0348
Packit Service 1d0348 
Setting this
Packit Service 1d0348 
boolean option will force the writer to use Zip64 extensions
Packit Service 1d0348 
even for small files that would not otherwise require them.
Packit Service 1d0348 
This is primarily useful for testing.
Packit Service 1d0348
Packit Service 1d0348 
Disabling this
Packit Service 1d0348 
option with !zip64 will force the Zip writer to avoid
Packit Service 1d0348 
Zip64 extensions: It will reject files with size greater
Packit Service 1d0348 
than 4 GiB, it will reject any new entries once the total
Packit Service 1d0348 
archive size reaches 4 GiB, and it will not use Zip64
Packit Service 1d0348 
extensions for files with unknown size. In particular, this
Packit Service 1d0348 
can improve compatibility when generating archives where the
Packit Service 1d0348 
entry sizes are not known in advance.
Packit Service 1d0348
Packit Service 1d0348 
EXAMPLES
Packit Service 1d0348
Packit Service 1d0348 
The following example creates an
Packit Service 1d0348 
archive write handle to create a gzip-compressed ISO9660
Packit Service 1d0348 
format image. The two options here specify that the ISO9660
Packit Service 1d0348 
archive will use kernel.img as the boot image for El
Packit Service 1d0348 
Torito booting, and that the gzip compressor should use the
Packit Service 1d0348 
maximum compression level.
Packit Service 1d0348
Packit Service 1d0348 
a =
Packit Service 1d0348 
archive_write_new();
Packit Service 1d0348 
archive_write_add_filter_gzip(a);
Packit Service 1d0348 
archive_write_set_format_iso9660(a);
Packit Service 1d0348 
archive_write_set_options(a,
Packit Service 1d0348 
"boot=kernel.img,compression=9");
Packit Service 1d0348 
archive_write_open_filename(a, filename, blocksize);
Packit Service 1d0348
Packit Service 1d0348 
ERRORS
Packit Service 1d0348
Packit Service 1d0348 
More detailed error codes and
Packit Service 1d0348 
textual descriptions are available from the
Packit Service 1d0348 
archive_errno() and archive_error_string()
Packit Service 1d0348 
functions.
Packit Service 1d0348
Packit Service 1d0348 
SEE ALSO
Packit Service 1d0348
Packit Service 1d0348 
tar(1), libarchive(3),
Packit Service 1d0348 
archive_read_set_options(3), archive_write(3)
Packit Service 1d0348
Packit Service 1d0348 
HISTORY
Packit Service 1d0348
Packit Service 1d0348 
The libarchive library
Packit Service 1d0348 
first appeared in FreeBSD 5.3.
Packit Service 1d0348
Packit Service 1d0348 
AUTHORS
Packit Service 1d0348
Packit Service 1d0348 
The options support for
Packit Service 1d0348 
libarchive was originally implemented by Michihiro
Packit Service 1d0348 
NAKAJIMA.
Packit Service 1d0348
Packit Service 1d0348 
BUGS
Packit Service 1d0348
Packit Service 1d0348 
BSD February 2, 2012
Packit Service 1d0348 
BSD
Packit Service 1d0348
Packit Service 1d0348 
</body>
Packit Service 1d0348 
</html>

Powered by Pagure 5.13.3

SSH Hostkey/Fingerprint | Documentation