Man page - zip_open(3)
Packages contas this manual
- zip_set_default_password(3)
- zip_add(3)
- zip_source_tell(3)
- zip_source_function(3)
- zip_source_zip(3)
- zip_source_buffer_fragment_create(3)
- zip_source_zip_file(3)
- zip_source_stat(3)
- zip_source_win32a_create(3)
- zip_source_zip_create(3)
- zip_register_cancel_callback_with_state(3)
- zip_file_extra_field_delete(3)
- zip_error_system_type(3)
- zip_source_make_command_bitmap(3)
- zip_get_num_files(3)
- zip_source_tell_write(3)
- zip_file_extra_field_get_by_id(3)
- zip_error_code_system(3)
- zip_source(3)
- zip_file_get_error(3)
- zip_file_extra_fields_count(3)
- zip_file_add(3)
- zip_source_rollback_write(3)
- zip_source_win32handle_create(3)
- zip_source_read(3)
- zip_stat(3)
- zip_file_attributes_init(3)
- zip_source_seek_write(3)
- zip_source_close(3)
- zip_file_error_clear(3)
- zip_set_archive_flag(3)
- zip_error_set_from_source(3)
- zip_file_strerror(3)
- zip_error_clear(3)
- zip_discard(3)
- zip_replace(3)
- zip_source_buffer_create(3)
- zip_error_fini(3)
- zip_get_archive_flag(3)
- zip_file_is_seekable(3)
- zip_stat_index(3)
- zip_source_begin_write(3)
- zip_error_get(3)
- zip_ftell(3)
- zip_source_begin_write_cloning(3)
- zip_source_filep(3)
- zip_strerror(3)
- zip_source_keep(3)
- zip_rename(3)
- zip_source_commit_write(3)
- zip_source_win32w(3)
- zip_error_to_str(3)
- zip_register_progress_callback_with_state(3)
- zip_source_zip_file_create(3)
- zip_file_set_mtime(3)
- zip_file_extra_field_set(3)
- zip_file_set_comment(3)
- zip_source_window_create(3)
- zip_source_buffer(3)
- zip_error_init_with_code(3)
- zip_set_archive_comment(3)
- zip_fdopen(3)
- zip_file_extra_fields_count_by_id(3)
- zip_dir_add(3)
- zip_source_buffer_fragment(3)
- zip_error_get_sys_type(3)
- zip_source_open(3)
- zip_source_is_deleted(3)
- zip_unchange_archive(3)
- zip_set_file_comment(3)
- zip_close(3)
- zip_unchange_all(3)
- zip_error_set(3)
- zip_source_error(3)
- zip_error_code_zip(3)
- zip_name_locate(3)
- zip_source_file(3)
- zip_add_dir(3)
- zip_file_extra_field_get(3)
- zip_file_set_dostime(3)
- zip_get_file_comment(3)
- zip_file_get_external_attributes(3)
- zip_get_error(3)
- zip_file_set_external_attributes(3)
- zip_delete(3)
- zip_encryption_method_supported(3)
- zip_source_seek_compute_offset(3)
- zip_source_seek(3)
- zip_fopen_index_encrypted(3)
- zip_error_to_data(3)
- zip_open(3)
- zip_get_archive_comment(3)
- zip_set_file_compression(3)
- zip_get_num_entries(3)
- zip_errors(3)
- zip_file_replace(3)
- zip_fopen(3)
- zip_source_layered_create(3)
- zip_file_get_comment(3)
- zip_source_free(3)
- zip_stat_init(3)
- zip_get_name(3)
- zip_source_win32a(3)
- zip_source_is_seekable(3)
- zip_file_error_get(3)
- zip_source_win32w_create(3)
- zip_open_from_source(3)
- zip_fopen_encrypted(3)
- zip_compression_method_supported(3)
- zip_source_write(3)
- zip_file_extra_field_delete_by_id(3)
- zip_file_rename(3)
- zip_source_function_create(3)
- zip_fopen_index(3)
- zip_fread(3)
- zip_fclose(3)
- zip_register_progress_callback(3)
- zip_error_strerror(3)
- zip_source_win32handle(3)
- zip_error_init(3)
- zip_libzip_version(3)
- zip_fseek(3)
- zip_source_filep_create(3)
- zip_source_file_create(3)
- libzip(3)
- zip_file_set_encryption(3)
- zip_source_layered(3)
- zip_unchange(3)
apt-get install libzip-dev
Manual
| ZIP_OPEN(3) | Library Functions Manual | ZIP_OPEN(3) |
NAME
zip_open,
zip_open_from_source — open
zip archive
LIBRARY
libzip (-lzip)
SYNOPSIS
#include
<zip.h>
zip_t *
zip_open(const
char *path, int
flags, int
*errorp);
zip_t *
zip_open_from_source(zip_source_t
*zs, int flags,
zip_error_t *ze);
DESCRIPTION
The
zip_open()
function opens the zip archive specified by path and
returns a pointer to a struct zip, used to manipulate
the archive. The flags are specified by
or'ing
the following values, or 0 for none of them.
ZIP_CHECKCONS- Perform additional stricter consistency checks on the archive, and error if they fail.
ZIP_CREATE- Create the archive if it does not exist.
ZIP_EXCL- Error if archive already exists.
ZIP_TRUNCATE- If archive exists, ignore its current contents. In other words, handle it the same way as an empty archive.
ZIP_RDONLY- Open archive in read-only mode.
If an error occurs and errorp is
non-NULL, it will be set to the corresponding error
code.
The
zip_open_from_source()
function opens a zip archive encapsulated by the zip_source
zs using the provided flags. In
case of error, the zip_error ze is filled in.
RETURN VALUES
Upon successful completion zip_open() and
zip_open_from_source() return a
struct zip pointer. Otherwise,
NULL is returned and
zip_open() sets *errorp to
indicate the error, while
zip_open_from(source) sets
ze to indicate the error.
EXAMPLES
Here's an example of how you could report errors during
zip_open:
zip_t *za;
int err;
if ((za = zip_open(name, 0, &err)) == NULL) {
zip_error_t error;
zip_error_init_with_code(&error, err);
fprintf(stderr, "%s: cannot open zip archive '%s': %s\n",
progname, name, zip_error_strerror(&error));
zip_error_fini(&error);
return -1;
}
ERRORS
The archive specified by path is opened unless:
- [
ZIP_ER_EXISTS] - The file specified by path exists and
ZIP_EXCLis set. - [
ZIP_ER_INCONS] - Inconsistencies were found in the file specified by
path. This error is often caused by specifying
ZIP_CHECKCONSbut can also happen without it. - [
ZIP_ER_INVAL] - The path argument is
NULL. - [
ZIP_ER_MEMORY] - Required memory could not be allocated.
- [
ZIP_ER_NOENT] - The file specified by path does not exist and
ZIP_CREATEis not set. - [
ZIP_ER_NOZIP] - The file specified by path is not a zip archive.
- [
ZIP_ER_OPEN] - The file specified by path could not be opened.
- [
ZIP_ER_READ] - A read error occurred; see errno for details.
- [
ZIP_ER_SEEK] - The file specified by path does not allow seeks.
zip_open() does not try to
create the file; this is done when calling zip_close(3) and
any errors, like missing write permissions, will be reported then.
SEE ALSO
libzip(3), zip_close(3), zip_error_strerror(3), zip_fdopen(3)
HISTORY
zip_open() and
zip_open_from_source() were added in libzip 1.0.
AUTHORS
Dieter Baron <dillo@nih.at> and Thomas Klausner <wiz@gatalith.at>
| October 9, 2022 | Debian |