carta
archive_read_support_filter_xz(3)

archive_read_support_filter_xz3

Functions for reading streaming archives

Part of archive_read_filter(3).

Usage

int

int

int

int

int

int

int

int

int

int

int

int

int

int

int

int

int

Library

Streaming Archive Library (libarchive, -larchive)

Overview

archive_read_support_filter_bzip2(), archive_read_support_filter_compress(), archive_read_support_filter_grzip(), archive_read_support_filter_gzip(), archive_read_support_filter_lrzip(), archive_read_support_filter_lz4(), archive_read_support_filter_lzma(), archive_read_support_filter_lzop(), archive_read_support_filter_none(), archive_read_support_filter_rpm(), archive_read_support_filter_uu(), archive_read_support_filter_xz(), archive_read_support_filter_zstd(), Enables auto-detection code and decompression support for the specified compression. These functions may fall back on external programs if an appropriate library was not available at build time. Decompression using an external program is usually slower than decompression through built-in libraries. Note that “none” is always enabled by default.

archive_read_support_filter_all()

Enables all available decompression filters.

archive_read_support_filter_by_code()

Enables a single filter specified by the filter code. This function does not work with ARCHIVE_FILTER_PROGRAM. Note: In statically-linked executables, this will cause your program to include support for every filter. If executable size is a concern, you may wish to avoid using this function.

archive_read_support_filter_program()

Data is fed through the specified external program before being dearchived. Note that this disables automatic detection of the compression format, so it makes no sense to specify this in conjunction with any other decompression option.

archive_read_support_filter_program_signature()

This feeds data through the specified external program but only if the initial bytes of the data match the specified signature value.

Return values

These functions return ARCHIVE_OK if the compression is fully supported, ARCHIVE_WARN if the compression is supported only through an external program, or ARCHIVE_FATAL on error.

archive_read_support_filter_none() always succeeds.

Errors

Detailed error codes and textual descriptions are available from the archive_errno() and archive_error_string() functions.

History

  • FreeBSD 16.0-CURRENT (2026-10-27): the text shown here
  • FreeBSD 15.1-RELEASE to FreeBSD 14.1-RELEASE
  • FreeBSD 14.0-RELEASE
  • FreeBSD 13.5-RELEASE to FreeBSD 13.4-RELEASE
  • FreeBSD 13.3-RELEASE to FreeBSD 12.3-RELEASE
  • FreeBSD 12.2-RELEASE
  • FreeBSD 12.1-RELEASE to FreeBSD 12.0-RELEASE
  • FreeBSD 11.4-RELEASE
  • FreeBSD 11.3-RELEASE to FreeBSD 11.2-RELEASE
  • FreeBSD 11.1-RELEASE to FreeBSD 10.4-RELEASE
  • FreeBSD 10.3-RELEASE to FreeBSD 10.0-RELEASE

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.