NAME

       archive_write_data — functions for creating archives

LIBRARY

       Streaming Archive Library (libarchive, -larchive)

SYNOPSIS

       #include <archive.h>

       la_ssize_t
       archive_write_data(struct archive *, const void *, size_t);

DESCRIPTION

       Write data corresponding to the header just written.

RETURN VALUES

       This function returns the number of bytes actually written, or a negative error code on error.

ERRORS

       Detailed   error   codes   and   textual   descriptions   are  available  from  the  archive_errno()  and
       archive_error_string() functions.

BUGS

       In libarchive 3.x, this function sometimes returns zero on success instead of  returning  the  number  of
       bytes  written.   Specifically, this occurs when writing to an archive_write_disk handle.  Clients should
       treat any value less than zero as an error and consider any non-negative value as success.

SEE ALSO

       tar(1), libarchive(3), archive_write_finish_entry(3),  archive_write_set_options(3),  cpio(5),  mtree(5),
       tar(5)

Debian                                          February 2, 2012                           ARCHIVE_WRITE_DATA(3)