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.5 February 2, 2012 DragonFly 3.5