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 read-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
non- 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_READ
-
A read error occurred; see
errno
for details.
- Bq Er ZIP_ER_SEEK
-
The file specified by
fd
does not allow seeks.
SEE ALSO
libzip(3),
zip_close3,
zip_error_strerror3,
zip_open3
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 tk@giga.or.at
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- ERRORS
-
- SEE ALSO
-
- HISTORY
-
- AUTHORS
-
This document was created by
man2html,
using the manual pages.
Time: 05:38:08 GMT, May 18, 2024