1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
<!-- Creator : groff version 1.23.0 -->
<!-- CreationDate: Mon Jan 5 10:42:45 2026 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title></title>
</head>
<body>
<hr>
<p><i>ARCHIVE_WRITE_FREE</i>(3) Library Functions Manual
<i>ARCHIVE_WRITE_FREE</i>(3)</p>
<p style="margin-top: 1em"><b>NAME</b></p>
<p style="margin-left:9%;">archive_write_fail,
archive_write_close, archive_write_finish,
archive_write_free — functions for creating
archives</p>
<p style="margin-top: 1em"><b>LIBRARY</b></p>
<p style="margin-left:9%;">Streaming Archive Library
(libarchive, -larchive)</p>
<p style="margin-top: 1em"><b>SYNOPSIS</b></p>
<p style="margin-left:9%;"><b>#include
<archive.h></b></p>
<p style="margin-left:9%; margin-top: 1em"><i>int</i></p>
<p style="margin-left:14%;"><b>archive_write_fail</b>(<i>struct archive *</i>);</p>
<p style="margin-left:9%; margin-top: 1em"><i>int</i></p>
<p style="margin-left:14%;"><b>archive_write_close</b>(<i>struct archive *</i>);</p>
<p style="margin-left:9%; margin-top: 1em"><i>int</i></p>
<p style="margin-left:14%;"><b>archive_write_finish</b>(<i>struct archive *</i>);</p>
<p style="margin-left:9%; margin-top: 1em"><i>int</i></p>
<p style="margin-left:14%;"><b>archive_write_free</b>(<i>struct archive *</i>);</p>
<p style="margin-top: 1em"><b>DESCRIPTION <br>
archive_write_fail</b>()</p>
<p style="margin-left:19%;">Always returns
<b>ARCHIVE_FATAL</b>. This marks the archive object as being
unusable; after calling this function, the only call that
can succeed is <b>archive_write_free</b>() to release the
resources. This can be used to speed recovery when the
archive creation must be aborted. Note that the created
archive is likely to be malformed in this case;</p>
<p style="margin-top: 1em"><b>archive_write_close</b>()</p>
<p style="margin-left:19%;">Complete the archive and invoke
the close callback.</p>
<p style="margin-top: 1em"><b>archive_write_finish</b>()</p>
<p style="margin-left:19%;">This is a deprecated synonym
for <b>archive_write_free</b>().</p>
<p style="margin-top: 1em"><b>archive_write_free</b>()</p>
<p style="margin-left:19%;">Invokes
<b>archive_write_close</b>() if necessary, then releases all
resources. If you need detailed information about
<b>archive_write_close</b>() failures, you should be careful
to call it separately, as you cannot obtain error
information after <b>archive_write_free</b>() returns.</p>
<p style="margin-top: 1em"><b>RETURN VALUES</b></p>
<p style="margin-left:9%;">These functions return
<b>ARCHIVE_OK</b> on success, or <b>ARCHIVE_FATAL</b>.</p>
<p style="margin-top: 1em"><b>ERRORS</b></p>
<p style="margin-left:9%;">Detailed error codes and textual
descriptions are available from the <b>archive_errno</b>()
and <b>archive_error_string</b>() functions.</p>
<p style="margin-top: 1em"><b>SEE ALSO</b></p>
<p style="margin-left:9%;"><i>tar</i>(1),
<i>archive_write_set_options</i>(3), <i>libarchive</i>(3),
<i>cpio</i>(5), <i>mtree</i>(5), <i>tar</i>(5) Debian
February 2, 2012 <i>ARCHIVE_WRITE_FREE</i>(3)</p>
<hr>
</body>
</html>
|
