Man page - zip_stat_index(3)
Packages contains this manual
- zip_file_attributes_init(3)
- zip_file_get_comment(3)
- zip_source_filep_create(3)
- zip_register_progress_callback_with_state(3)
- zip_file_extra_fields_count_by_id(3)
- zip_file_replace(3)
- zip_source_seek_write(3)
- zip_name_locate(3)
- zip_dir_add(3)
- zip_set_archive_flag(3)
- zip_ftell(3)
- zip_source_win32a(3)
- zip_unchange(3)
- zip_source_begin_write_cloning(3)
- zip_delete(3)
- zip_file_extra_field_delete(3)
- zip_error_fini(3)
- zip_fclose(3)
- zip_file_set_comment(3)
- zip_file_extra_field_delete_by_id(3)
- zip_source_zip_create(3)
- zip_error_set_from_source(3)
- zip_rename(3)
- zip_source_filep(3)
- zip_source_buffer_fragment(3)
- zip_file_set_mtime(3)
- zip_source_window_create(3)
- zip_file_extra_field_set(3)
- zip_source_rollback_write(3)
- zip_replace(3)
- zip_source_begin_write(3)
- libzip(3)
- zip_source_layered_create(3)
- zip_stat_index(3)
- zip_errors(3)
- zip_file_strerror(3)
- zip_source_is_seekable(3)
- zip_file_get_error(3)
- zip_set_default_password(3)
- zip_source_write(3)
- zip_source_close(3)
- zip_source_seek_compute_offset(3)
- zip_file_set_dostime(3)
- zip_set_file_compression(3)
- zip_discard(3)
- zip_source_win32handle(3)
- zip_source_win32w_create(3)
- zip_register_cancel_callback_with_state(3)
- zip_source_file_create(3)
- zip_get_error(3)
- zip_fopen_encrypted(3)
- zip_get_archive_comment(3)
- zip_error_to_data(3)
- zip_source_win32a_create(3)
- zip_error_to_str(3)
- zip_get_num_entries(3)
- zip_close(3)
- zip_source_file(3)
- zip_source_function_create(3)
- zip_source_win32handle_create(3)
- zip_file_is_seekable(3)
- zip_fopen_index(3)
- zip_set_file_comment(3)
- zip_open(3)
- zip_fopen_index_encrypted(3)
- zip_strerror(3)
- zip_source_buffer(3)
- zip_file_error_get(3)
- zip_register_progress_callback(3)
- zip_unchange_all(3)
- zip_file_add(3)
- zip_error_clear(3)
- zip_source_buffer_fragment_create(3)
- zip_open_from_source(3)
- zip_source_commit_write(3)
- zip_source(3)
- zip_source_free(3)
- zip_source_open(3)
- zip_source_zip_file(3)
- zip_set_archive_comment(3)
- zip_file_rename(3)
- zip_stat(3)
- zip_fseek(3)
- zip_error_code_zip(3)
- zip_source_tell_write(3)
- zip_error_init(3)
- zip_source_buffer_create(3)
- zip_error_strerror(3)
- zip_get_num_files(3)
- zip_fdopen(3)
- zip_add(3)
- zip_file_extra_field_get_by_id(3)
- zip_source_read(3)
- zip_libzip_version(3)
- zip_file_error_clear(3)
- zip_source_win32w(3)
- zip_unchange_archive(3)
- zip_add_dir(3)
- zip_source_make_command_bitmap(3)
- zip_error_code_system(3)
- zip_file_set_external_attributes(3)
- zip_source_tell(3)
- zip_encryption_method_supported(3)
- zip_error_get(3)
- zip_source_zip(3)
- zip_fread(3)
- zip_error_init_with_code(3)
- zip_fopen(3)
- zip_file_get_external_attributes(3)
- zip_get_file_comment(3)
- zip_file_extra_fields_count(3)
- zip_stat_init(3)
- zip_source_error(3)
- zip_source_function(3)
- zip_get_name(3)
- zip_error_system_type(3)
- zip_compression_method_supported(3)
- zip_source_stat(3)
- zip_source_layered(3)
- zip_source_keep(3)
- zip_error_set(3)
- zip_error_get_sys_type(3)
- zip_source_zip_file_create(3)
- zip_source_is_deleted(3)
- zip_file_set_encryption(3)
- zip_file_extra_field_get(3)
- zip_get_archive_flag(3)
- zip_source_seek(3)
apt-get install libzip-dev
Manual
ZIP_STAT (3) Library Functions Manual ZIP_STAT (3)
NAME
zip_stat, zip_stat_index ā get information about file
LIBRARY
libzip (-lzip)
SYNOPSIS
#include <zip.h>
int
zip_stat ( zip_tĀ *archive , constĀ charĀ *fname , zip_flags_tĀ flags , zip_stat_tĀ *sb );
int
zip_stat_index ( zip_tĀ *archive , zip_uint64_tĀ index , zip_flags_tĀ flags , zip_stat_tĀ *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 original 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)
HISTORY
zip_stat () was added in libzip 0.6. In libzip 0.11 the type of flags was changed from int to zip_flags_t .
zip_stat_index () was added in libzip 0.6. In libzip 0.10 the type of index was changed from int to zip_uint64_t . In libzip 0.11 the type of flags was changed from int to zip_flags_t .
AUTHORS
Dieter Baron < dillo@nih.at > and Thomas Klausner < wiz@gatalith.at > Debian December 18, 2017 ZIP_STAT (3)