www.LinuxHowtos.org

ZIP_FDOPEN

Section: C Library Functions (3)
Index Return to Main Contents

BSD mandoc

NAME

zip_fdopen - open zip archive using open file descriptor

LIBRARY

libzip -lzip)

SYNOPSIS

In zip.h Ft zip_t * Fn zip_fdopen int fd int flags int *errorp

DESCRIPTION

The zip archive specified by the open file descriptor fd is opened and a pointer to a Ft struct zip , used to manipulate the archive, is returned. In contrast to zip_open3, using zip_fdopen the archive can only be opened in rea-only mode. The fd argument may not be used any longer after calling zip_fdopen The Fa flags are specified by or 'ing the following values, or 0 for none of them.

ZIP_CHECKCONS: Perform additional stricter consistency checks on the archive, and error if they fail.

If an error occurs and errorp is no- NULL it will be set to the corresponding error code.

RETURN VALUES

Upon successful completion Fn zip_fdopen returns a Ft struct zip pointer, and fd should not be used any longer, nor passed to close(2). Otherwise, NULL is returned and *errorp is set to indicate the error. In the error case, fd remains unchanged.

ERRORS

The file specified by fd is prepared for use by libzip(3) unless:

Bq Er ZIP_ER_INCONS: Inconsistencies were found in the file specified by path This error is often caused by specifying ZIP_CHECKCONS but can also happen without it.
Bq Er ZIP_ER_INVAL: The flags argument is invalid. Not all zip_open3 flags are allowed for zip_fdopen see Sx DESCRIPTION .
Bq Er ZIP_ER_MEMORY: Required memory could not be allocated.
Bq Er ZIP_ER_NOZIP: The file specified by fd is not a zip archive.
Bq Er ZIP_ER_OPEN: The file specified by fd could not be prepared for use by libzip(3).
Bq Er ZIP_ER_OPNOTSUPP: This functionality has been disabled at compile time.
Bq Er ZIP_ER_READ: A read error occurred; see errno for details.
Bq Er ZIP_ER_SEEK: The file specified by fd does not allow seeks.

HISTORY

Fn zip_fdopen was added in libzip 1.0.

AUTHORS

An -nosplit An Dieter Baron Aq Mt dillo@nih.at and An Thomas Klausner Aq Mt wiz@gatalith.at