ManPageArchiveWriteFormat3.wiki 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208
  1. ARCHIVE_WRITE_FORMAT(3) manual page
  2. == NAME ==
  3. '''archive_write_set_format''',
  4. '''archive_write_set_format_7zip''',
  5. '''archive_write_set_format_ar''',
  6. '''archive_write_set_format_ar_bsd''',
  7. '''archive_write_set_format_ar_svr4''',
  8. '''archive_write_set_format_by_name''',
  9. '''archive_write_set_format_cpio''',
  10. '''archive_write_set_format_cpio_bin''',
  11. '''archive_write_set_format_cpio_newc''',
  12. '''archive_write_set_format_cpio_odc''',
  13. '''archive_write_set_format_cpio_pwb''',
  14. '''archive_write_set_format_filter_by_ext''',
  15. '''archive_write_set_format_filter_by_ext_def''',
  16. '''archive_write_set_format_gnutar''',
  17. '''archive_write_set_format_iso9660''',
  18. '''archive_write_set_format_mtree''',
  19. '''archive_write_set_format_mtree_classic''',
  20. '''archive_write_set_format_mtree_default''',
  21. '''archive_write_set_format_pax''',
  22. '''archive_write_set_format_pax_restricted''',
  23. '''archive_write_set_format_raw''',
  24. '''archive_write_set_format_shar''',
  25. '''archive_write_set_format_shar_dump''',
  26. '''archive_write_set_format_ustar''',
  27. '''archive_write_set_format_v7tar''',
  28. '''archive_write_set_format_warc''',
  29. '''archive_write_set_format_xar''',
  30. '''archive_write_set_format_zip'''
  31. - functions for creating archives
  32. == LIBRARY ==
  33. Streaming Archive Library (libarchive, -larchive)
  34. == SYNOPSIS ==
  35. '''<nowiki>#include <archive.h></nowiki>'''
  36. <br>
  37. ''int''
  38. <br>
  39. '''archive_write_set_format'''(''struct archive *'', ''int code'');
  40. <br>
  41. ''int''
  42. <br>
  43. '''archive_write_set_format_7zip'''(''struct archive *'');
  44. <br>
  45. ''int''
  46. <br>
  47. '''archive_write_set_format_ar'''(''struct archive *'');
  48. <br>
  49. ''int''
  50. <br>
  51. '''archive_write_set_format_ar_bsd'''(''struct archive *'');
  52. <br>
  53. ''int''
  54. <br>
  55. '''archive_write_set_format_ar_svr4'''(''struct archive *'');
  56. <br>
  57. ''int''
  58. <br>
  59. '''archive_write_set_format_by_name'''(''struct archive *'', ''const char *name'');
  60. <br>
  61. ''int''
  62. <br>
  63. '''archive_write_set_format_cpio'''(''struct archive *'');
  64. <br>
  65. ''int''
  66. <br>
  67. '''archive_write_set_format_cpio_bin'''(''struct archive *'');
  68. <br>
  69. ''int''
  70. <br>
  71. '''archive_write_set_format_cpio_newc'''(''struct archive *'');
  72. <br>
  73. ''int''
  74. <br>
  75. '''archive_write_set_format_cpio_odc'''(''struct archive *'');
  76. <br>
  77. ''int''
  78. <br>
  79. '''archive_write_set_format_cpio_pwb'''(''struct archive *'');
  80. <br>
  81. ''int''
  82. <br>
  83. '''archive_write_set_format_filter_by_ext'''(''struct archive *'', ''const char *filename'');
  84. <br>
  85. ''int''
  86. <br>
  87. '''archive_write_set_format_filter_by_ext_def'''(''struct archive *'', ''const char *filename'', ''const char *def_ext'');
  88. <br>
  89. ''int''
  90. <br>
  91. '''archive_write_set_format_gnutar'''(''struct archive *'');
  92. <br>
  93. ''int''
  94. <br>
  95. '''archive_write_set_format_iso9660'''(''struct archive *'');
  96. <br>
  97. ''int''
  98. <br>
  99. '''archive_write_set_format_mtree'''(''struct archive *'');
  100. <br>
  101. ''int''
  102. <br>
  103. '''archive_write_set_format_pax'''(''struct archive *'');
  104. <br>
  105. ''int''
  106. <br>
  107. '''archive_write_set_format_pax_restricted'''(''struct archive *'');
  108. <br>
  109. ''int''
  110. <br>
  111. '''archive_write_set_format_raw'''(''struct archive *'');
  112. <br>
  113. ''int''
  114. <br>
  115. '''archive_write_set_format_shar'''(''struct archive *'');
  116. <br>
  117. ''int''
  118. <br>
  119. '''archive_write_set_format_shar_dump'''(''struct archive *'');
  120. <br>
  121. ''int''
  122. <br>
  123. '''archive_write_set_format_ustar'''(''struct archive *'');
  124. <br>
  125. ''int''
  126. <br>
  127. '''archive_write_set_format_v7tar'''(''struct archive *'');
  128. <br>
  129. ''int''
  130. <br>
  131. '''archive_write_set_format_warc'''(''struct archive *'');
  132. <br>
  133. ''int''
  134. <br>
  135. '''archive_write_set_format_xar'''(''struct archive *'');
  136. <br>
  137. ''int''
  138. <br>
  139. '''archive_write_set_format_zip'''(''struct archive *'');
  140. == DESCRIPTION ==
  141. These functions set the format that will be used for the archive.
  142. The library can write a variety of common archive formats.
  143. <dl>
  144. <dt>'''archive_write_set_format'''()</dt><dd>
  145. Sets the format based on the format code (see
  146. ''archive.h''
  147. for the full list of format codes).
  148. In particular, this can be used in conjunction with
  149. '''archive_format'''()
  150. to create a new archive with the same format as an existing archive.
  151. </dd><dt>'''archive_write_set_format_by_name'''()</dt><dd>
  152. Sets the corresponding format based on the common name.
  153. </dd><dt>
  154. '''archive_write_set_format_filter_by_ext'''()
  155. '''archive_write_set_format_filter_by_ext_def'''()
  156. </dt> <dd>
  157. Sets both filters and format based on the output filename.
  158. Supported extensions: .7z, .zip, .jar, .cpio, .iso, .a, .ar, .tar, .tgz, .tar.gz, .tar.bz2, .tar.xz
  159. </dd><dt>
  160. '''archive_write_set_format_7zip'''()
  161. '''archive_write_set_format_ar_bsd'''()
  162. '''archive_write_set_format_ar_svr4'''()
  163. '''archive_write_set_format_cpio'''()
  164. '''archive_write_set_format_cpio_bin'''()
  165. '''archive_write_set_format_cpio_newc'''()
  166. '''archive_write_set_format_cpio_odc'''()
  167. '''archive_write_set_format_cpio_pwb'''()
  168. '''archive_write_set_format_gnutar'''()
  169. '''archive_write_set_format_iso9660'''()
  170. '''archive_write_set_format_mtree'''()
  171. '''archive_write_set_format_mtree_classic'''()
  172. '''archive_write_set_format_pax'''()
  173. '''archive_write_set_format_pax_restricted'''()
  174. '''archive_write_set_format_raw'''()
  175. '''archive_write_set_format_shar'''()
  176. '''archive_write_set_format_shar_dump'''()
  177. '''archive_write_set_format_ustar'''()
  178. '''archive_write_set_format_v7tar'''()
  179. '''archive_write_set_format_warc'''()
  180. '''archive_write_set_format_xar'''()
  181. '''archive_write_set_format_zip'''()
  182. </dt> <dd>
  183. Set the format as specified.
  184. More details on the formats supported by libarchive can be found in the
  185. [[ManPageLibarchiveFormats5]]
  186. manual page.
  187. </dd></dl>
  188. == RETURN VALUES ==
  189. These functions return
  190. '''ARCHIVE_OK'''
  191. on success, or
  192. '''ARCHIVE_FATAL'''.
  193. == ERRORS ==
  194. Detailed error codes and textual descriptions are available from the
  195. '''archive_errno'''()
  196. and
  197. '''archive_error_string'''()
  198. functions.
  199. == SEE ALSO ==
  200. [[ManPageBsdtar1]],
  201. [[ManPageArchiveWrite3]],
  202. [[ManPageArchiveWriteSetOptions3]],
  203. [[ManPageLibarchive3]],
  204. [[ManPageCpio5]],
  205. [[ManPageLibarchiveFormats5]],
  206. [[ManPageMtree5]],
  207. [[ManPageTar5]]