summaryrefslogtreecommitdiffstats
path: root/Utilities/cmlibarchive/libarchive/archive_write_data.3
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-07-20 15:36:18 (GMT)
committerBrad King <brad.king@kitware.com>2017-07-20 15:36:18 (GMT)
commit6df1bda1c57193b289866389a994ea79a2f5e1d8 (patch)
tree7bf31a5dc1702e7a0faebe654da69f5c5eaeca90 /Utilities/cmlibarchive/libarchive/archive_write_data.3
parentb6674431af4790ba5deea9e5e6bd7b2620beb69e (diff)
parent11f3dcb04887fccf38a8eda19d498bf7a5060486 (diff)
downloadCMake-6df1bda1c57193b289866389a994ea79a2f5e1d8.zip
CMake-6df1bda1c57193b289866389a994ea79a2f5e1d8.tar.gz
CMake-6df1bda1c57193b289866389a994ea79a2f5e1d8.tar.bz2
Merge branch 'upstream-LibArchive' into update-libarchive
* upstream-LibArchive: LibArchive 2017-07-09 (98a69539)
Diffstat (limited to 'Utilities/cmlibarchive/libarchive/archive_write_data.3')
-rw-r--r--Utilities/cmlibarchive/libarchive/archive_write_data.324
1 files changed, 22 insertions, 2 deletions
diff --git a/Utilities/cmlibarchive/libarchive/archive_write_data.3 b/Utilities/cmlibarchive/libarchive/archive_write_data.3
index 0cdd25f..9c16cd9 100644
--- a/Utilities/cmlibarchive/libarchive/archive_write_data.3
+++ b/Utilities/cmlibarchive/libarchive/archive_write_data.3
@@ -24,11 +24,12 @@
.\"
.\" $FreeBSD$
.\"
-.Dd February 2, 2012
+.Dd February 28, 2017
.Dt ARCHIVE_WRITE_DATA 3
.Os
.Sh NAME
-.Nm archive_write_data
+.Nm archive_write_data ,
+.Nm archive_write_data_block
.Nd functions for creating archives
.Sh LIBRARY
Streaming Archive Library (libarchive, -larchive)
@@ -36,8 +37,27 @@ Streaming Archive Library (libarchive, -larchive)
.In archive.h
.Ft la_ssize_t
.Fn archive_write_data "struct archive *" "const void *" "size_t"
+.Ft la_ssize_t
+.Fn archive_write_data_block "struct archive *" "const void *" "size_t size" "int64_t offset"
.Sh DESCRIPTION
+.Bl -tag -width indent
+.It Fn archive_write_data
+Write data corresponding to the header just written.
+.It Fn archive_write_data_block
Write data corresponding to the header just written.
+This is like
+.Fn archive_write_data
+except that it performs a seek on the file being
+written to the specified offset before writing the data.
+This is useful when restoring sparse files from archive
+formats that support sparse files.
+Returns number of bytes written or -1 on error.
+(Note: This is currently not supported for
+.Tn archive_write
+handles, only for
+.Tn archive_write_disk
+handles.
+.El
.\" .Sh EXAMPLE
.\"
.Sh RETURN VALUES