ZIP_SOURCE_STAT

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

---

BSD mandoc
 

NAME

zip_source_stat - get information about zip_source  

LIBRARY

libzip -lzip)  

SYNOPSIS

In zip.h Ft int Fn zip_source_stat zip_source_t *source zip_stat_t *sb  

DESCRIPTION

The Fn zip_source_stat function obtains information about the zip source source

The sb argument is a pointer to a Ft 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 Fn zip_stat_init 3 before calling Fn 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_source5  

HISTORY

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

---

 

Index

NAME

LIBRARY

SYNOPSIS

DESCRIPTION

RETURN VALUES

SEE ALSO

HISTORY

AUTHORS