|
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_READ_OPTIONS(3) BSD Library Functions Manual
|
|
Packit Service |
1d0348 |
ARCHIVE_READ_OPTIONS(3)
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
NAME
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
archive_read_set_filter_option,
|
|
Packit Service |
1d0348 |
archive_read_set_format_option,
|
|
Packit Service |
1d0348 |
archive_read_set_option,
|
|
Packit Service |
1d0348 |
archive_read_set_options — functions
|
|
Packit Service |
1d0348 |
controlling options for reading 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_read_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_read_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_read_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_read_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 read
|
|
Packit Service |
1d0348 |
modules.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
archive_read_set_filter_option(),
|
|
Packit Service |
1d0348 |
archive_read_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 that of the module.
|
|
Packit Service |
1d0348 |
If there is no such module, ARCHIVE_FAILED will be
|
|
Packit Service |
1d0348 |
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_read_set_option()
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Calls
|
|
Packit Service |
1d0348 |
archive_read_set_format_option(), then
|
|
Packit Service |
1d0348 |
archive_read_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_read_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 |
Calls
|
|
Packit Service |
1d0348 |
archive_read_set_option() with each option in turn.
|
|
Packit Service |
1d0348 |
If any archive_read_set_option() call returns
|
|
Packit Service |
1d0348 |
ARCHIVE_FATAL, ARCHIVE_FATAL 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 |
Format iso9660
|
|
Packit Service |
1d0348 |
joliet
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Support Joliet
|
|
Packit Service |
1d0348 |
extensions. Defaults to enabled, use !joliet to
|
|
Packit Service |
1d0348 |
disable.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
rockridge
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Support RockRidge extensions.
|
|
Packit Service |
1d0348 |
Defaults to enabled, use !rockridge to disable.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Format tar
|
|
Packit Service |
1d0348 |
compat-2x
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Libarchive 2.x incorrectly
|
|
Packit Service |
1d0348 |
encoded Unicode filenames on some platforms. This option
|
|
Packit Service |
1d0348 |
mimics the libarchive 2.x filename handling so that such
|
|
Packit Service |
1d0348 |
archives can be read correctly.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
hdrcharset
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
The value is used as a
|
|
Packit Service |
1d0348 |
character set name that will be used when translating
|
|
Packit Service |
1d0348 |
filenames.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
mac-ext
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Support Mac OS metadata
|
|
Packit Service |
1d0348 |
extension that records data in special files beginning with
|
|
Packit Service |
1d0348 |
a period and underscore. Defaults to enabled on Mac OS,
|
|
Packit Service |
1d0348 |
disabled on other platforms. Use !mac-ext to
|
|
Packit Service |
1d0348 |
disable.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
read_concatenated_archives
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Ignore zeroed blocks in the
|
|
Packit Service |
1d0348 |
archive, which occurs when multiple tar archives have been
|
|
Packit Service |
1d0348 |
concatenated together. Without this option, only the
|
|
Packit Service |
1d0348 |
contents of the first concatenated archive would be
|
|
Packit Service |
1d0348 |
read.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
ERRORS
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
Detailed error codes and textual
|
|
Packit Service |
1d0348 |
descriptions are available from the archive_errno()
|
|
Packit Service |
1d0348 |
and archive_error_string() functions.
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
SEE ALSO
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
tar(1), libarchive(3),
|
|
Packit Service |
1d0348 |
archive_write_set_options(3), archive_read(3)
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
BSD
|
|
Packit Service |
1d0348 |
February 2, 2012 BSD
|
|
Packit Service |
1d0348 |
|
|
Packit Service |
1d0348 |
</body>
|
|
Packit Service |
1d0348 |
</html>
|