DragonFly On-Line Manual Pages


ARCHIVE_WRITE_FORM... DragonFly Library Functions Manual ARCHIVE_WRITE_FORM...

NAME

archive_write_set_format_cpio, archive_write_set_format_pax, archive_write_set_format_pax_restricted, archive_write_set_format_shar, archive_write_set_format_shar_dump, archive_write_set_format_ustar -- functions for creating archives

LIBRARY

Streaming Archive Library (libarchive, -larchive)

SYNOPSIS

#include <archive.h> int archive_write_set_format_cpio(struct archive *); int archive_write_set_format_pax(struct archive *); int archive_write_set_format_pax_restricted(struct archive *); int archive_write_set_format_shar(struct archive *); int archive_write_set_format_shar_dump(struct archive *); int archive_write_set_format_ustar(struct archive *);

DESCRIPTION

These functions set the format that will be used for the archive. The library can write POSIX octet-oriented cpio format archives, POSIX- standard ``pax interchange'' format archives, traditional ``shar'' ar- chives, enhanced ``dump'' shar archives that store a variety of file attributes and handle binary files, and POSIX-standard ``ustar'' ar- chives. The pax interchange format is a backwards-compatible tar format that adds key/value attributes to each entry and supports arbitrary file- names, linknames, uids, sizes, etc. ``Restricted pax interchange format'' is the library default; this is the same as pax format, but sup- presses the pax extended header for most normal files. In most cases, this will result in ordinary ustar archives.

RETURN VALUES

These functions return ARCHIVE_OK on success, or ARCHIVE_FATAL.

ERRORS

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

SEE ALSO

tar(1), libarchive(3), archive_write(3), archive_write_set_options(3), cpio(5), mtree(5), tar(5) DragonFly 3.7 February 2, 2012 DragonFly 3.7