Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ZIP_SOURCE_STAT(3)	     Library Functions Manual	      ZIP_SOURCE_STAT(3)

NAME
     zip_source_stat -- get information about zip_source

LIBRARY
     libzip (-lzip)

SYNOPSIS
     #include <zip.h>

     int
     zip_source_stat(zip_source_t *source, zip_stat_t *sb);

DESCRIPTION
     The  zip_source_stat()  function  obtains	information about the zip source
     source

     The sb argument is a pointer to a	struct	zip_source_stat  (shown  below),
     into which information about the zip source is placed.

     struct zip_source_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 initialized with zip_stat_init(3)
     before calling zip_source_stat().

     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 ac-
     cessing 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

     NOTE: Some fields may only be filled out after all data has been read  from
     the source, for example the crc or size fields.

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

SEE ALSO
     libzip(3), zip_source(5)

HISTORY
     zip_source_stat() was added in libzip 1.0.

AUTHORS
     Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>

FreeBSD ports 15.quarterly	December 18, 2017	      ZIP_SOURCE_STAT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zip_source_stat&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help