Blame doc/html/archive_write_blocksize.3.html

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348
"http://www.w3.org/TR/html4/loose.dtd">
Packit Service 1d0348
<html>
Packit Service 1d0348
<head>
Packit Service 1d0348
<meta name="generator" content="groff -Thtml, see www.gnu.org">
Packit Service 1d0348
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
Packit Service 1d0348
<meta name="Content-Style" content="text/css">
Packit Service 1d0348
<style type="text/css">
Packit Service 1d0348
       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
Packit Service 1d0348
       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
Packit Service 1d0348
       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
Packit Service 1d0348
       h1      { text-align: center }
Packit Service 1d0348
</style>
Packit Service 1d0348
<title></title>
Packit Service 1d0348
</head>
Packit Service 1d0348
<body>
Packit Service 1d0348
Packit Service 1d0348

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

ARCHIVE_WRITE_BLOCKSI... BSD Library Functions Manual

Packit Service 1d0348
ARCHIVE_WRITE_BLOCKSI...

Packit Service 1d0348
Packit Service 1d0348

NAME

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_get_bytes_per_block,

Packit Service 1d0348
archive_write_set_bytes_per_block,
Packit Service 1d0348
archive_write_get_bytes_in_last_block,
Packit Service 1d0348
archive_write_set_bytes_in_last_block
Packit Service 1d0348
functions for creating archives

Packit Service 1d0348
Packit Service 1d0348

LIBRARY

Packit Service 1d0348
Packit Service 1d0348

Streaming Archive Library

Packit Service 1d0348
(libarchive, -larchive)

Packit Service 1d0348
Packit Service 1d0348

SYNOPSIS

Packit Service 1d0348
Packit Service 1d0348

#include

Packit Service 1d0348
<archive.h>

Packit Service 1d0348
Packit Service 1d0348

int

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_get_bytes_per_block(struct archive *);

Packit Service 1d0348
Packit Service 1d0348

int

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_set_bytes_per_block(struct archive *,

Packit Service 1d0348
int bytes_per_block);

Packit Service 1d0348
Packit Service 1d0348

int

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_get_bytes_in_last_block(struct archive *);

Packit Service 1d0348
Packit Service 1d0348

int

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_set_bytes_in_last_block(struct archive *,

Packit Service 1d0348
int);

Packit Service 1d0348
Packit Service 1d0348

DESCRIPTION

Packit Service 1d0348
archive_write_set_bytes_per_block()

Packit Service 1d0348
Packit Service 1d0348

Sets the block size used for

Packit Service 1d0348
writing the archive data. Every call to the write callback
Packit Service 1d0348
function, except possibly the last one, will use this value
Packit Service 1d0348
for the length. The default is to use a block size of 10240
Packit Service 1d0348
bytes. Note that a block size of zero will suppress internal
Packit Service 1d0348
blocking and cause writes to be sent directly to the write
Packit Service 1d0348
callback as they occur.

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_get_bytes_per_block()

Packit Service 1d0348
Packit Service 1d0348

Retrieve the block size to be

Packit Service 1d0348
used for writing. A value of -1 here indicates that the
Packit Service 1d0348
library should use default values. A value of zero indicates
Packit Service 1d0348
that internal blocking is suppressed.

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_set_bytes_in_last_block()

Packit Service 1d0348
Packit Service 1d0348

Sets the block size used for

Packit Service 1d0348
writing the last block. If this value is zero, the last
Packit Service 1d0348
block will be padded to the same size as the other blocks.
Packit Service 1d0348
Otherwise, the final block will be padded to a multiple of
Packit Service 1d0348
this size. In particular, setting it to 1 will cause the
Packit Service 1d0348
final block to not be padded. For compressed output, any
Packit Service 1d0348
padding generated by this option is applied only after the
Packit Service 1d0348
compression. The uncompressed data is always unpadded. The
Packit Service 1d0348
default is to pad the last block to the full block size
Packit Service 1d0348
(note that archive_write_open_filename() will set
Packit Service 1d0348
this based on the file type). Unlike the other
Packit Service 1d0348
’’set’’ functions, this function can
Packit Service 1d0348
be called after the archive is opened.

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_get_bytes_in_last_block()

Packit Service 1d0348
Packit Service 1d0348

Retrieve the currently-set

Packit Service 1d0348
value for last block size. A value of -1 here indicates that
Packit Service 1d0348
the library should use default values.

Packit Service 1d0348
Packit Service 1d0348

RETURN VALUES

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_set_bytes_per_block()

Packit Service 1d0348
and archive_write_set_bytes_in_last_block() return
Packit Service 1d0348
ARCHIVE_OK on success, or ARCHIVE_FATAL.

Packit Service 1d0348
Packit Service 1d0348
Packit Service 1d0348

archive_write_get_bytes_per_block()

Packit Service 1d0348
and archive_write_get_bytes_in_last_block() return
Packit Service 1d0348
currently configured block size (

Packit Service 1d0348
Packit Service 1d0348

-1 indicates the default block size ), or

Packit Service 1d0348
ARCHIVE_FATAL.

Packit Service 1d0348
Packit Service 1d0348

ERRORS

Packit Service 1d0348
Packit Service 1d0348

Detailed error codes and textual

Packit Service 1d0348
descriptions are available from the archive_errno()
Packit Service 1d0348
and archive_error_string() functions.

Packit Service 1d0348
Packit Service 1d0348

SEE ALSO

Packit Service 1d0348
Packit Service 1d0348

tar(1), libarchive(3),

Packit Service 1d0348
archive_write_set_options(3), cpio(5), mtree(5), tar(5)

Packit Service 1d0348
Packit Service 1d0348

BSD

Packit Service 1d0348
February 2, 2012 BSD

Packit Service 1d0348

Packit Service 1d0348
</body>
Packit Service 1d0348
</html>