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

       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(3)

HISTORY
       zip_source_stat() was added in libzip 1.0.

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

FreeBSD	Ports 14.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+14.3.quarterly>

home | help