ARCHIVE_WRITE_FORMAT(3) manual page 
== 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 == 
'''<nowiki>#include <archive.h></nowiki>''' 
<br> 
'''int''' 
<br> 
'''archive_write_set_format_cpio'''(''struct archive *''); 
<br> 
'''int''' 
<br> 
'''archive_write_set_format_pax'''(''struct archive *''); 
<br> 
'''int''' 
<br> 
'''archive_write_set_format_pax_restricted'''(''struct archive *''); 
<br> 
'''int''' 
<br> 
'''archive_write_set_format_shar'''(''struct archive *''); 
<br> 
'''int''' 
<br> 
'''archive_write_set_format_shar_dump'''(''struct archive *''); 
<br> 
'''int''' 
<br> 
'''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" 
archives, 
enhanced 
"dump" 
shar archives that store a variety of file attributes and handle binary files, 
and 
POSIX-standard 
"ustar" 
archives. 
The pax interchange format is a backwards-compatible tar format that 
adds key/value attributes to each entry and supports arbitrary 
filenames, linknames, uids, sizes, etc. 
"Restricted pax interchange format" 
is the library default; this is the same as pax format, but suppresses 
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) 
