summaryrefslogtreecommitdiff
path: root/archivers/libarchive/files/doc/html/archive_write_open.3.html
diff options
context:
space:
mode:
authorjoerg <joerg@pkgsrc.org>2017-02-25 20:53:51 +0000
committerjoerg <joerg@pkgsrc.org>2017-02-25 20:53:51 +0000
commitc8fcd52665c6781876ed54832bd7f6ea46348688 (patch)
treeb5165a0dff599b0ae48d70b5104febf7f8732828 /archivers/libarchive/files/doc/html/archive_write_open.3.html
parentf67a2b170587775e96627a49fc615267312586d3 (diff)
downloadpkgsrc-c8fcd52665c6781876ed54832bd7f6ea46348688.tar.gz
Import libarchive-3.3.1.
Diffstat (limited to 'archivers/libarchive/files/doc/html/archive_write_open.3.html')
-rw-r--r--archivers/libarchive/files/doc/html/archive_write_open.3.html23
1 files changed, 16 insertions, 7 deletions
diff --git a/archivers/libarchive/files/doc/html/archive_write_open.3.html b/archivers/libarchive/files/doc/html/archive_write_open.3.html
index 5c692848a94..3bd43f143d9 100644
--- a/archivers/libarchive/files/doc/html/archive_write_open.3.html
+++ b/archivers/libarchive/files/doc/html/archive_write_open.3.html
@@ -1,5 +1,5 @@
<!-- Creator : groff version 1.22.3 -->
-<!-- CreationDate: Sun Jun 19 19:54:08 2016 -->
+<!-- CreationDate: Sat Feb 25 11:22:06 2017 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
@@ -83,7 +83,8 @@ archive_write_open</b>()</p>
archive, and prepare for writing entries. This is the most
generic form of this function, which accepts pointers to
three callback functions which will be invoked by the
-compression layer to write the constructed archive.</p>
+compression layer to write the constructed archive. This
+does not alter the default archive padding.</p>
<p style="margin-top: 1em"><b>archive_write_open_fd</b>()</p>
@@ -115,7 +116,7 @@ require correct blocking.</p>
<b>archive_write_open</b>() that accepts a filename. A NULL
argument indicates that the output should be written to
standard output; an argument of
-&rsquo;&rsquo;-&rsquo;&rsquo; will open a file with that
+&lsquo;&lsquo;-&rsquo;&rsquo; will open a file with that
name. If you have not invoked
<b>archive_write_set_bytes_in_last_block</b>(), then
<b>archive_write_open_filename</b>() will adjust the
@@ -138,12 +139,19 @@ block of memory that will receive the archive. The final
updated after each write to reflect how much of the buffer
is currently in use. You should be careful to ensure that
this variable remains allocated until after the archive is
-closed.</p>
+closed. This function will disable padding unless you have
+specifically set the block size.</p>
<p style="margin-left:6%;">More information about the
<i>struct archive</i> object and the overall design of the
library can be found in the libarchive(3) overview.</p>
+<p style="margin-left:6%; margin-top: 1em">Note that the
+convenience forms above vary in how they block the output.
+See archive_write_blocksize(3) if you need to control the
+block size used for writes or the end-of-file padding
+behavior.</p>
+
<p style="margin-top: 1em"><b>CLIENT CALLBACKS</b></p>
<p style="margin-left:6%;">To use this library, you will
@@ -220,9 +228,10 @@ and <b>archive_error_string</b>() functions.</p>
<p style="margin-top: 1em"><b>SEE ALSO</b></p>
<p style="margin-left:6%;">tar(1), libarchive(3),
-archive_write(3), archive_write_filter(3),
-archive_write_format(3), archive_write_new(3),
-archive_write_set_options(3), cpio(5), mtree(5), tar(5)</p>
+archive_write(3), archive_write_blocksize(3),
+archive_write_filter(3), archive_write_format(3),
+archive_write_new(3), archive_write_set_options(3), cpio(5),
+mtree(5), tar(5)</p>
<p style="margin-left:6%; margin-top: 1em">BSD
February&nbsp;2, 2012 BSD</p>