FreeBSD manual
download PDF document: zip_source_window_create.3.pdf
ZIP_SOURCE_WINDOW_CREATE(3) FreeBSD Library Functions Manual
NAME
zip_source_window_create - create zip data source overlay
LIBRARY
libzip (-lzip)
SYNOPSIS
#include <zip.h>
zip_source_t *
zip_source_window_create(zip_source_t *source, zip_uint64_t start,
zip_int64_t len, zip_error_t *error);
DESCRIPTION
The zip_source_window_create() function create a zip source from an
underlying zip source, restricting access to a particular window starting
at byte start and having size len. If len is -1, the window spans to the
end of the underlying source.
zip_source_window() and zip_source_window_create() don't take ownership
of source. The caller is responsible for freeing it. (This is different
to other layered sources.)
RETURN VALUES
Upon successful completion, the created source is returned. Otherwise,
NULL is returned and the error code in error is set to indicate the
error.
ERRORS
zip_source_window_create() fails if:
[ZIP_ER_INVAL] src is NULL; there is an integer overflow adding start
and len; or len is less than -1.
[ZIP_ER_MEMORY] Required memory could not be allocated.
SEE ALSO
libzip(3), zip_source(3) zip_source(3)
HISTORY
zip_source_window_create() was added in libzip 1.8.0.
AUTHORS
Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>
FreeBSD 14.0-RELEASE-p11 April 29, 2021 FreeBSD 14.0-RELEASE-p11