DragonFly On-Line Manual Pages

ZIP_SOURCE_FILE(3)         Library Functions Manual         ZIP_SOURCE_FILE(3)

NAME
       zip_source_file - create data source from a file

LIBRARY
       libzip (-lzip)

SYNOPSIS
       zip_source_t * zip_source_file zip_t *archive const char *fname
       zip_uint64_t start zip_int64_t len zip_source_t *
       zip_source_file_create const char *fname zip_uint64_t start zip_int64_t
       len zip_error_t *error

DESCRIPTION
       The functions zip_source_file and zip_source_file_create create a zip
       source from a file.  They open fname and read len bytes from offset
       start from it.  If len is 0 or -1, the whole file (starting from start)
       is used.

       If the file supports seek, the source can be used to open a zip archive
       from.

       The file is opened and read when the data from the source is used,
       usually by zip_close or zip_open_from_source.

RETURN VALUES
       Upon successful completion, the created source is returned.  Otherwise,
       NULL is returned and the error code in archive or error is set to
       indicate the error.

ERRORS
       zip_source_file and zip_source_file_create fail if:

       [ZIP_ER_INVAL]   fname, start, or len are invalid.

       [ZIP_ER_MEMORY]  Required memory could not be allocated.

       [ZIP_ER_OPEN]    Opening fname failed.

SEE ALSO
       libzip(3), zip_add(3), zip_replace(3), zip_source(3)

AUTHORS
       Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>

NiH                             March 11, 2015              ZIP_SOURCE_FILE(3)