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_source3
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 tk@giga.or.at
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- SEE ALSO
-
- HISTORY
-
- AUTHORS
-
This document was created by
man2html,
using the manual pages.
Time: 09:17:29 GMT, May 23, 2024