|
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>
|