Blame doc/html/archive_write_blocksize.3.html

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

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

ARCHIVE_WRITE_BLOCKSI... BSD Library Functions Manual

Packit 08bd4c
ARCHIVE_WRITE_BLOCKSI...

Packit 08bd4c
Packit 08bd4c

NAME

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_get_bytes_per_block,

Packit 08bd4c
archive_write_set_bytes_per_block,
Packit 08bd4c
archive_write_get_bytes_in_last_block,
Packit 08bd4c
archive_write_set_bytes_in_last_block
Packit 08bd4c
functions for creating archives

Packit 08bd4c
Packit 08bd4c

LIBRARY

Packit 08bd4c
Packit 08bd4c

Streaming Archive Library

Packit 08bd4c
(libarchive, -larchive)

Packit 08bd4c
Packit 08bd4c

SYNOPSIS

Packit 08bd4c
Packit 08bd4c

#include

Packit 08bd4c
<archive.h>

Packit 08bd4c
Packit 08bd4c

int

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_get_bytes_per_block(struct archive *);

Packit 08bd4c
Packit 08bd4c

int

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_set_bytes_per_block(struct archive *,

Packit 08bd4c
int bytes_per_block);

Packit 08bd4c
Packit 08bd4c

int

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_get_bytes_in_last_block(struct archive *);

Packit 08bd4c
Packit 08bd4c

int

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_set_bytes_in_last_block(struct archive *,

Packit 08bd4c
int);

Packit 08bd4c
Packit 08bd4c

DESCRIPTION

Packit 08bd4c
archive_write_set_bytes_per_block()

Packit 08bd4c
Packit 08bd4c

Sets the block size used for

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

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_get_bytes_per_block()

Packit 08bd4c
Packit 08bd4c

Retrieve the block size to be

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

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_set_bytes_in_last_block()

Packit 08bd4c
Packit 08bd4c

Sets the block size used for

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

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_get_bytes_in_last_block()

Packit 08bd4c
Packit 08bd4c

Retrieve the currently-set

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

Packit 08bd4c
Packit 08bd4c

RETURN VALUES

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_set_bytes_per_block()

Packit 08bd4c
and archive_write_set_bytes_in_last_block() return
Packit 08bd4c
ARCHIVE_OK on success, or ARCHIVE_FATAL.

Packit 08bd4c
Packit 08bd4c
Packit 08bd4c

archive_write_get_bytes_per_block()

Packit 08bd4c
and archive_write_get_bytes_in_last_block() return
Packit 08bd4c
currently configured block size (

Packit 08bd4c
Packit 08bd4c

-1 indicates the default block size ), or

Packit 08bd4c
ARCHIVE_FATAL.

Packit 08bd4c
Packit 08bd4c

ERRORS

Packit 08bd4c
Packit 08bd4c

Detailed error codes and textual

Packit 08bd4c
descriptions are available from the archive_errno()
Packit 08bd4c
and archive_error_string() functions.

Packit 08bd4c
Packit 08bd4c

SEE ALSO

Packit 08bd4c
Packit 08bd4c

tar(1), libarchive(3),

Packit 08bd4c
archive_write_set_options(3), cpio(5), mtree(5), tar(5)

Packit 08bd4c
Packit 08bd4c

BSD

Packit 08bd4c
February 2, 2012 BSD

Packit 08bd4c

Packit 08bd4c
</body>
Packit 08bd4c
</html>