source-git / libarchive

Clone
Source Code
GIT

Blame doc/html/archive_write_set_options.3.html

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

Powered by Pagure 5.13.3

SSH Hostkey/Fingerprint | Documentation