zip_fdopen(3) [debian man page]

ZIP_FDOPEN(3)						     Library Functions Manual						     ZIP_FDOPEN(3)

NAME

       zip_fdopen - open zip archive using open file descriptor

LIBRARY

       libzip (-lzip)

SYNOPSIS

       #include <zip.h>

       struct zip * 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

       struct  zip,  used  to  manipulate the archive, is returned.  In contrast to zip_open(3), using the archive can only be opened in read-only
       mode.  The fd argument may not be used any longer after calling The are specified by or'ing the following values, or 0 for none of them.

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

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

RETURN VALUES

       Upon successful completion zip_fdopen returns a

       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  indi-
       cate the error.	In the error case, fd remains unchanged.

ERRORS

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

	      [ZIP_ER_INCONS]
		  Inconsistencies were found in the file specified by path and ZIP_CHECKCONS was specified.

	      [ZIP_ER_INVAL]
		  The flags argument is invalid.  Not all zip_open(3) flags are allowed for see DESCRIPTION.

	      [ZIP_ER_MEMORY]
		  Required memory could not be allocated.

	      [ZIP_ER_NOZIP]
		  The file specified by fd is not a zip archive.

	      [ZIP_ER_OPEN]
		  The file specified by fd could not be prepared for use by libzip(3).

	      [ZIP_ER_READ]
		  A read error occurred; see for details.

	      [ZIP_ER_SEEK]
		  The file specified by fd does not allow seeks.

SEE ALSO

       libzip(3), zip_close(3), zip_error_to_str(3), zip_open(3)

AUTHORS

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

NiH								 February 1, 2010						     ZIP_FDOPEN(3)

ZIP_STAT(3)						     Library Functions Manual						       ZIP_STAT(3)

NAME

       zip_stat , - .Nm zip_stat_index get information about file

LIBRARY

       libzip (-lzip)

SYNOPSIS

       #include <zip.h>

       int zip_stat(struct zip *archive, const char *fname, int flags, struct zip_stat *sb);

       int zip_stat_index(struct zip *archive, int index, int flags, struct zip_stat *sb);

DESCRIPTION

       The  zip_stat  function obtains information about the file named fname in archive.  The flags argument specifies how the name lookup should
       be done.  Its values are described in zip_name_locate(3).  Also, ZIP_FL_UNCHANGED may be or'ed to it to request information about the orig-
       inal file in the archive, ignoring any changes made.

       The zip_stat_index function obtains information about the file at position index.

       The sb argument is a pointer to a

       struct zip_stat (shown below), into which information about the file is placed.	struct zip_stat {
	   zip_uint64_t valid;		       /* which fields have valid values */
	   const char *name;		       /* name of the file */
	   zip_uint64_t index;		       /* index within archive */
	   zip_uint64_t size;		       /* size of file (uncompressed) */
	   zip_uint64_t comp_size;	       /* size of file (compressed) */
	   time_t mtime;		       /* modification time */
	   zip_uint32_t crc;		       /* crc of file data */
	   zip_uint16_t comp_method;	       /* compression method used */
	   zip_uint16_t encryption_method;     /* encryption method used */
	   zip_uint32_t  flags; 		 /*  reserved for future use */ }; The structure pointed to by sb must be allocated before calling
       zip_stat or zip_stat_index.

       The valid field of the structure specifies which other fields are valid.  Check if the flag defined by the following defines are  in  valid
       before accessing the fields:

	      ZIP_STAT_NAME		    name

	      ZIP_STAT_INDEX		    index

	      ZIP_STAT_SIZE		    size

	      ZIP_STAT_COMP_SIZE	    comp_size

	      ZIP_STAT_MTIME		    mtime

	      ZIP_STAT_CRC		    crc

	      ZIP_STAT_COMP_METHOD	    comp_method

	      ZIP_STAT_ENCRYPTION_METHOD    encryption_method

	      ZIP_STAT_FLAGS		    flags

RETURN VALUES

       Upon successful completion 0 is returned.  Otherwise, -1 is returned and the error information in archive is set to indicate the error.

ERRORS

       The function zip_stat can fail for any of the errors specified for the routine zip_name_locate(3).

       The  function  zip_stat_index fails and sets the error information to ZIP_ER_INVAL if index is invalid.	If ZIP_FL_UNCHANGED is not set and
       no information can be obtained from the source callback, the error information is set to ZIP_ER_CHANGED.

SEE ALSO

       libzip(3), zip_get_num_entries(3), zip_name_locate(3), zip_stat_init(3)

AUTHORS

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

NiH								 February 14, 2011						       ZIP_STAT(3)