CMAKE_MINIMUM_REQUIRED(VERSION 3.0.2)
-SET(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR})
+LIST(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR})
PROJECT(libzip C)
+OPTION(ENABLE_COMMONCRYPTO "Enable use of CommonCrypto" ON)
OPTION(ENABLE_GNUTLS "Enable use of GnuTLS" ON)
+OPTION(ENABLE_MBEDTLS "Enable use of mbed TLS" ON)
OPTION(ENABLE_OPENSSL "Enable use of OpenSSL" ON)
-OPTION(ENABLE_COMMONCRYPTO "Enable use of CommonCrypto" ON)
+OPTION(ENABLE_WINDOWS_CRYPTO "Enable use of Windows cryptography libraries" ON)
+
+OPTION(ENABLE_BZIP2 "Enable use of BZip2" ON)
+
+OPTION(BUILD_TOOLS "Build tools in the src directory (zipcmp, zipmerge, ziptool)" ON)
+OPTION(BUILD_REGRESS "Build regression tests" ON)
+OPTION(BUILD_EXAMPLES "Build examples" ON)
+OPTION(BUILD_DOC "Build documentation" ON)
INCLUDE(CheckFunctionExists)
INCLUDE(CheckIncludeFiles)
ELSE()
SET(GNUTLS_FOUND FALSE)
ENDIF()
+IF(ENABLE_MBEDTLS)
+ FIND_PATH(MBEDTLS_INCLUDE_DIR mbedtls/aes.h)
+ FIND_LIBRARY(MBEDTLS_LIBRARIES NAMES mbedtls)
+ELSE()
+ SET(MBEDTLS_LIBRARIES FALSE)
+ENDIF()
IF(ENABLE_OPENSSL)
INCLUDE(FindOpenSSL)
ELSE()
SET(OPENSSL_FOUND FALSE)
ENDIF()
+IF(WIN32)
+ IF(ENABLE_WINDOWS_CRYPTO)
+ SET(WINDOWS_CRYPTO_FOUND TRUE)
+ ENDIF()
+ELSE()
+ SET(WINDOWS_CRYPTO_FOUND FALSE)
+ENDIF()
OPTION(BUILD_SHARED_LIBS "Build shared libraries" ON)
+
+OPTION(SHARED_LIB_VERSIONNING "Add SO version in .so build" ON)
+
FIND_PROGRAM(MDOCTOOL NAMES mandoc groff)
IF (MDOCTOOL)
SET(DOCUMENTATION_FORMAT "mdoc" CACHE STRING "Documentation format")
SET(PACKAGE_NAME ${PACKAGE})
SET(PACKAGE_VERSION_MAJOR "1")
SET(PACKAGE_VERSION_MINOR "5")
-SET(PACKAGE_VERSION_MICRO "1")
+SET(PACKAGE_VERSION_MICRO "2")
#SET(VERSION "${PACKAGE_VERSION_MAJOR}.${PACKAGE_VERSION_MINOR}")
SET(VERSION "${PACKAGE_VERSION_MAJOR}.${PACKAGE_VERSION_MINOR}.${PACKAGE_VERSION_MICRO}")
SET(PACKAGE_VERSION ${VERSION})
#include <linux/fs.h>
int main(int argc, char *argv[]) { unsigned long x = FICLONERANGE; }" HAVE_FICLONERANGE)
+CHECK_C_SOURCE_COMPILES("
+int foo(char * _Nullable bar);
+int main(int argc, char *argv[]) { }" HAVE_NULLABLE)
+
TEST_BIG_ENDIAN(WORDS_BIGENDIAN)
FIND_PACKAGE(ZLIB REQUIRED)
MESSAGE(FATAL_ERROR "-- ZLIB version too old, please install at least v1.1.2")
ENDIF(ZLIB_VERSION_STRING VERSION_LESS "1.1.2")
-FIND_PACKAGE(BZip2)
-IF(BZIP2_FOUND)
- SET (HAVE_LIBBZ2 1)
+IF(ENABLE_BZIP2)
+ FIND_PACKAGE(BZip2)
+ IF(BZIP2_FOUND)
+ SET (HAVE_LIBBZ2 1)
- INCLUDE_DIRECTORIES(${BZIP2_INCLUDE_DIR})
- SET (OPTIONAL_LIBRARY ${BZIP2_LIBRARY})
-ELSE()
- MESSAGE(WARNING "-- bzip2 library not found; bzip2 support disabled")
-ENDIF(BZIP2_FOUND)
+ INCLUDE_DIRECTORIES(${BZIP2_INCLUDE_DIR})
+ SET (OPTIONAL_LIBRARY ${BZIP2_LIBRARY})
+ ELSE()
+ MESSAGE(WARNING "-- bzip2 library not found; bzip2 support disabled")
+ ENDIF(BZIP2_FOUND)
+ENDIF(ENABLE_BZIP2)
IF (COMMONCRYPTO_FOUND)
SET (HAVE_CRYPTO 1)
SET (HAVE_COMMONCRYPTO 1)
-ELSEIF (OPENSSL_FOUND)
+ELSEIF (WINDOWS_CRYPTO_FOUND)
SET (HAVE_CRYPTO 1)
- SET (HAVE_OPENSSL 1)
- INCLUDE_DIRECTORIES(${OPENSSL_INCLUDE_DIR})
- SET (OPTIONAL_LIBRARY ${OPTIONAL_LIBRARY} ${OPENSSL_LIBRARIES})
+ SET (HAVE_WINDOWS_CRYPTO 1)
ELSEIF (GNUTLS_FOUND AND NETTLE_FOUND)
SET (HAVE_CRYPTO 1)
SET (HAVE_GNUTLS 1)
INCLUDE_DIRECTORIES(${GNUTLS_INCLUDE_DIR} ${NETTLE_INCLUDE_DIR})
SET (OPTIONAL_LIBRARY ${OPTIONAL_LIBRARY} ${GNUTLS_LIBRARY} ${NETTLE_LIBRARY})
+ELSEIF (OPENSSL_FOUND)
+ SET (HAVE_CRYPTO 1)
+ SET (HAVE_OPENSSL 1)
+ INCLUDE_DIRECTORIES(${OPENSSL_INCLUDE_DIR})
+ SET (OPTIONAL_LIBRARY ${OPTIONAL_LIBRARY} ${OPENSSL_LIBRARIES})
+ELSEIF (MBEDTLS_LIBRARIES)
+ SET (HAVE_CRYPTO 1)
+ SET (HAVE_MBEDTLS 1)
+ INCLUDE_DIRECTORIES(${MBEDTLS_INCLUDE_DIR})
+ SET (OPTIONAL_LIBRARY ${OPTIONAL_LIBRARY} ${MBEDTLS_LIBRARIES})
ENDIF()
IF (NOT HAVE_CRYPTO)
- MESSAGE(WARNING "-- neither OpenSSL nor GnuTLS found; AES support disabled")
+ MESSAGE(WARNING "-- neither Common Crypto, GnuTLS, mbed TLS, OpenSSL, nor Windows Cryptography found; AES support disabled")
ENDIF()
IF(MSVC)
ENDIF(MSVC)
if(WIN32)
+ if(HAVE_WINDOWS_CRYPTO)
+ SET (OPTIONAL_LIBRARY "${OPTIONAL_LIBRARY}" bcrypt)
+ endif()
if(CMAKE_SYSTEM_NAME MATCHES WindowsPhone OR CMAKE_SYSTEM_NAME MATCHES WindowsStore)
ADD_DEFINITIONS(-DMS_UWP)
- SET (OPTIONAL_LIBRARY "${OPTIONAL_LIBRARY}" bcrypt)
else(CMAKE_SYSTEM_NAME MATCHES WindowsPhone OR CMAKE_SYSTEM_NAME MATCHES WindowsStore)
SET (OPTIONAL_LIBRARY "${OPTIONAL_LIBRARY}" advapi32)
endif(CMAKE_SYSTEM_NAME MATCHES WindowsPhone OR CMAKE_SYSTEM_NAME MATCHES WindowsStore)
# Targets
ADD_SUBDIRECTORY(lib)
+
+IF(BUILD_DOC)
ADD_SUBDIRECTORY(man)
+ENDIF()
+
+IF(BUILD_TOOLS)
ADD_SUBDIRECTORY(src)
+ENDIF()
+
+IF(BUILD_REGRESS)
ADD_SUBDIRECTORY(regress)
+ENDIF()
+
+IF(BUILD_EXAMPLES)
ADD_SUBDIRECTORY(examples)
+ENDIF()
+
# pkgconfig file
SET(prefix ${CMAKE_INSTALL_PREFIX})
SET(ZIP_UINT64_T "unsigned long long")
ENDIF()
+IF(HAVE_NULLABLE)
+ SET(ZIP_NULLABLE_DEFINES)
+ELSE()
+ SET(ZIP_NULLABLE_DEFINES "#define _Nullable
+#define _Nonnull")
+ENDIF()
+
# write out config file
CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/cmake-config.h.in ${CMAKE_CURRENT_BINARY_DIR}/config.h)
CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/cmake-zipconf.h.in ${CMAKE_CURRENT_BINARY_DIR}/zipconf.h)
listed in order of preference:
- Apple's CommonCrypto (available on macOS and iOS)
-- [OpenSSL](https://www.openssl.org/)
-- [GnuTLS](https://www.gnutls.org/).
+- [GnuTLS](https://www.gnutls.org/)
+- [mbed TLS](https://tls.mbed.org/)
+- [OpenSSL](https://www.openssl.org/) >= 1.0.
+- Microsoft Windows Cryptography Framework
If you don't want a library even if it is installed, you can
pass `-DENABLE_<LIBRARY>=OFF` to cmake, where `<LIBRARY>` is one of
-`COMMONCRYPTO`, `OPENSSL`, or `GNUTLS`.
+`COMMONCRYPTO`, `GNUTLS`, `MBEDTLS`, or `OPENSSL`.
The basic usage is
```sh
- `DOCUMENTATION_FORMAT`: choose one of 'man', 'mdoc', and 'html' for
the installed documentation (default: decided by cmake depending on
available tools)
+
+If you want to compile with custom `CFLAGS`, set them in the environment
+before running `cmake`:
+```sh
+CFLAGS=-DMY_CUSTOM_FLAG cmake ..
+```
+
+If you are compiling on a system with a small stack size, add
+`-DZIP_ALLOCATE_BUFFER` to `CFLAGS`.
-You can get verbose build output with by passing `VERBOSE=1` to `make`.
+You can get verbose build output with by passing `VERBOSE=1` to
+`make`.
You can also check the [cmake FAQ](https://cmake.org/Wiki/CMake_FAQ).
+1.5.2 [2019-03-12]
+==================
+* Fix bug in AES encryption affecting certain file sizes
+* Keep file permissions when modifying zip archives
+* Support systems with small stack size.
+* Support mbed TLS as crypto backend.
+* Add nullability annotations.
+
1.5.1 [2018-04-11]
==================
Winzip AES and decryption of legacy PKware encrypted files is
supported. The API is documented by man pages.
-For more information, take a look at the included man pages. You can
-start with [libzip(3)](https://libzip.org/documentation/libzip.html), which lists
-all others. Example source code is in the [examples](examples) and [src](src) subdirectories.
+libzip is fully documented via man pages. HTML versions of the man
+pages are on [libzip.org](https://libzip.org/documentation/) and
+in the [man](man) directory. You can start with
+[libzip(3)](https://libzip.org/documentation/libzip.html), which
+lists
+all others. Example source code is in the [examples](examples) and
+[src](src) subdirectories.
If you have developed an application using libzip, you can find out
about API changes and how to adapt your code for them in the included
[](https://travis-ci.org/nih-at/libzip)
[](https://ci.appveyor.com/project/0-wiz-0/libzip)
-
+[](https://scan.coverity.com/projects/libzip)
David Demelier <demelier.david@gmail.com>
Del Merritt <del@alum.mit.edu>
Dmytro Rybachenko <atmoliton@gmail.com>
+Elvis Angelaccio
+Erwin Haid <erwin.haid@gmx.de>
Eun-cheol Joo
+Florian Delizy <florian.delizy@gmail.com>
François Simon <AT.GFI.Francois.SIMON@sesam-vitale.fr>
Frederik Ramm <frederik@remote.org>
Hanno Böck <hanno@hboeck.de>
HeeMyung
Heiko Becker
Heiko Hund <heiko@ist.eigentlich.net>
+Ilya Voronin
Info-ZIP group
Jan Weiß <jan@geheimwerk.de>
Jay Freeman (saurik) <saurik@saurik.com>
Kohei Yoshida <kohei.yoshida@gmail.com>
Leith Bade <leith@mapbox.com>
Lubomir I. Ivanov <neolit123@gmail.com>
+Maël Nison
Martin Buchholz <martinrb@google.com>
Martin Herkt
Martin Szulecki <m.szulecki@libimobiledevice.org>
+Michael Balzer
Michael Beck <mm.beck@gmx.net>
Michał Janiszewski
Michal Vyskocil <mvyskocil@suse.cz>
Mikhail Gusarov <dottedmag@dottedmag.net>.
+Miklos Vajna
Oliver Kaiser <under.northern.sky@googlemail.com>
Oliver Kuckertz <oliver.kuckertz@mologie.de>
Pascal Terjan <pterjan@gmail.com>
Simon Talbot <simont@nse.co.uk>
Stephen Bryant <steve@bawue.de>
Tarmo Pikaro <tapika@yahoo.com>
+TC
Tim Lunn <Tim@feathertop.org>
Timo Warns <warns@pre-sense.de>
Tom Callaway <tcallawa@redhat.com>
Tomas Hoger <thoger@redhat.com>
+Tomáš Malý
Torsten Paul <Torsten.Paul@gmx.de>
Vassili Courzakis <vcoxvco@googlemail.com>
+William Lee
Wojciech Michalski <wmichalski@quay.pl>
Wolfgang Glunz <Wolfgang.Glunz@gmx.de>
- read/write: total byte count so far
- state of source (opened, EOF reached, ...)
-* add license to generated documentation (man, html)
-
# Later
## macOS / iOS framework
## Features
+* add seek support for AES-encrypted files
* consistently use `_zip_crypto_clear()` for passwords
* support setting extra fields from `zip_source`
* introduce layers of extra fields:
#cmakedefine HAVE_GETPROGNAME
#cmakedefine HAVE_GNUTLS
#cmakedefine HAVE_LIBBZ2
+#cmakedefine HAVE_MBEDTLS
+#cmakedefine HAVE_MKSTEMP
+#cmakedefine HAVE_NULLABLE
#cmakedefine HAVE_OPEN
#cmakedefine HAVE_OPENSSL
-#cmakedefine HAVE_MKSTEMP
#cmakedefine HAVE_SETMODE
#cmakedefine HAVE_SNPRINTF
#cmakedefine HAVE_SSIZE_T_LIBZIP
#cmakedefine HAVE_STDBOOL_H
#cmakedefine HAVE_STRINGS_H
#cmakedefine HAVE_UNISTD_H
+#cmakedefine HAVE_WINDOWS_CRYPTO
#cmakedefine __INT8_LIBZIP ${__INT8_LIBZIP}
#cmakedefine INT8_T_LIBZIP ${INT8_T_LIBZIP}
#cmakedefine UINT8_T_LIBZIP ${UINT8_T_LIBZIP}
#cmakedefine ZIP_STATIC
+${ZIP_NULLABLE_DEFINES}
+
${LIBZIP_TYPES_INCLUDE}
typedef ${ZIP_INT8_T} zip_int8_t;
/*
in-memory.c -- modify zip file in memory
- Copyright (C) 2014-2015 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
windows-open.c -- open zip archive using Windows UTF-16/Unicode file name
- Copyright (C) 2015 Dieter Baron and Thomas Klausner
+ Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
IF(HAVE_COMMONCRYPTO)
SET(LIBZIP_OPTIONAL_FILES ${LIBZIP_OPTIONAL_FILES} zip_crypto_commoncrypto.c
)
+ELSEIF(HAVE_WINDOWS_CRYPTO)
+ SET(LIBZIP_OPTIONAL_FILES ${LIBZIP_OPTIONAL_FILES} zip_crypto_win.c
+)
ELSEIF(HAVE_GNUTLS)
SET(LIBZIP_OPTIONAL_FILES ${LIBZIP_OPTIONAL_FILES} zip_crypto_gnutls.c
)
ELSEIF(HAVE_OPENSSL)
SET(LIBZIP_OPTIONAL_FILES ${LIBZIP_OPTIONAL_FILES} zip_crypto_openssl.c
)
+ELSEIF(HAVE_MBEDTLS)
+ SET(LIBZIP_OPTIONAL_FILES ${LIBZIP_OPTIONAL_FILES} zip_crypto_mbedtls.c
+)
ENDIF()
IF(HAVE_CRYPTO)
ENDIF()
ADD_LIBRARY(zip ${LIBZIP_SOURCES} ${LIBZIP_EXTRA_FILES} ${LIBZIP_OPTIONAL_FILES} ${LIBZIP_OPSYS_FILES})
+
+IF(SHARED_LIB_VERSIONNING)
SET_TARGET_PROPERTIES(zip PROPERTIES VERSION 5.0 SOVERSION 5)
+ENDIF()
+
+
TARGET_LINK_LIBRARIES(zip ${ZLIB_LIBRARY} ${OPTIONAL_LIBRARY})
INSTALL(TARGETS zip
RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
/*
compat.h -- compatibility defines.
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
}
}
}
- /*NOTREACHED*/
+ /*NOTREACHED*/
#endif
}
/*
zip.h -- exported declarations.
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2019 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
struct zip_error {
int zip_err; /* libzip error code (ZIP_ER_*) */
int sys_err; /* copy of errno (E*) or zlib error code */
- char *str; /* string representation or NULL */
+ char * _Nullable str; /* string representation or NULL */
};
#define ZIP_STAT_NAME 0x0001u
struct zip_stat {
zip_uint64_t valid; /* which fields have valid values */
- const char *name; /* name of the file */
+ const char * _Nullable 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) */
};
struct zip_buffer_fragment {
- zip_uint8_t *data;
+ zip_uint8_t * _Nonnull data;
zip_uint64_t length;
};
typedef zip_uint32_t zip_flags_t;
-typedef zip_int64_t (*zip_source_callback)(void *, void *, zip_uint64_t, zip_source_cmd_t);
-typedef void (*zip_progress_callback)(zip_t *, double, void *);
+typedef zip_int64_t (*zip_source_callback)(void * _Nullable, void * _Nullable, zip_uint64_t, zip_source_cmd_t);
+typedef void (*zip_progress_callback)(zip_t * _Nonnull, double, void * _Nullable);
#ifndef ZIP_DISABLE_DEPRECATED
typedef void (*zip_progress_callback_t)(double);
-ZIP_EXTERN void zip_register_progress_callback(zip_t *, zip_progress_callback_t); /* use zip_register_progress_callback_with_state */
-
-ZIP_EXTERN zip_int64_t zip_add(zip_t *, const char *, zip_source_t *); /* use zip_file_add */
-ZIP_EXTERN zip_int64_t zip_add_dir(zip_t *, const char *); /* use zip_dir_add */
-ZIP_EXTERN const char *zip_get_file_comment(zip_t *, zip_uint64_t, int *, int); /* use zip_file_get_comment */
-ZIP_EXTERN int zip_get_num_files(zip_t *); /* use zip_get_num_entries instead */
-ZIP_EXTERN int zip_rename(zip_t *, zip_uint64_t, const char *); /* use zip_file_rename */
-ZIP_EXTERN int zip_replace(zip_t *, zip_uint64_t, zip_source_t *); /* use zip_file_replace */
-ZIP_EXTERN int zip_set_file_comment(zip_t *, zip_uint64_t, const char *, int); /* use zip_file_set_comment */
+ZIP_EXTERN void zip_register_progress_callback(zip_t * _Nonnull, zip_progress_callback_t _Nullable); /* use zip_register_progress_callback_with_state */
+
+ZIP_EXTERN zip_int64_t zip_add(zip_t * _Nonnull, const char * _Nonnull, zip_source_t * _Nonnull); /* use zip_file_add */
+ZIP_EXTERN zip_int64_t zip_add_dir(zip_t * _Nonnull, const char * _Nonnull); /* use zip_dir_add */
+ZIP_EXTERN const char * _Nullable zip_get_file_comment(zip_t * _Nonnull, zip_uint64_t, int * _Nullable, int); /* use zip_file_get_comment */
+ZIP_EXTERN int zip_get_num_files(zip_t * _Nonnull); /* use zip_get_num_entries instead */
+ZIP_EXTERN int zip_rename(zip_t * _Nonnull, zip_uint64_t, const char * _Nonnull); /* use zip_file_rename */
+ZIP_EXTERN int zip_replace(zip_t * _Nonnull, zip_uint64_t, zip_source_t * _Nonnull); /* use zip_file_replace */
+ZIP_EXTERN int zip_set_file_comment(zip_t * _Nonnull, zip_uint64_t, const char * _Nullable, int); /* use zip_file_set_comment */
ZIP_EXTERN int zip_error_get_sys_type(int); /* use zip_error_system_type */
-ZIP_EXTERN void zip_error_get(zip_t *, int *, int *); /* use zip_get_error, zip_error_code_zip / zip_error_code_system */
-ZIP_EXTERN int zip_error_to_str(char *, zip_uint64_t, int, int); /* use zip_error_init_with_code / zip_error_strerror */
-ZIP_EXTERN void zip_file_error_get(zip_file_t *, int *, int *); /* use zip_file_get_error, zip_error_code_zip / zip_error_code_system */
+ZIP_EXTERN void zip_error_get(zip_t * _Nonnull, int * _Nullable, int * _Nullable); /* use zip_get_error, zip_error_code_zip / zip_error_code_system */
+ZIP_EXTERN int zip_error_to_str(char * _Nonnull, zip_uint64_t, int, int); /* use zip_error_init_with_code / zip_error_strerror */
+ZIP_EXTERN void zip_file_error_get(zip_file_t * _Nonnull, int * _Nullable, int * _Nullable); /* use zip_file_get_error, zip_error_code_zip / zip_error_code_system */
#endif
-ZIP_EXTERN int zip_close(zip_t *);
-ZIP_EXTERN int zip_delete(zip_t *, zip_uint64_t);
-ZIP_EXTERN zip_int64_t zip_dir_add(zip_t *, const char *, zip_flags_t);
-ZIP_EXTERN void zip_discard(zip_t *);
-
-ZIP_EXTERN zip_error_t *zip_get_error(zip_t *);
-ZIP_EXTERN void zip_error_clear(zip_t *);
-ZIP_EXTERN int zip_error_code_zip(const zip_error_t *);
-ZIP_EXTERN int zip_error_code_system(const zip_error_t *);
-ZIP_EXTERN void zip_error_fini(zip_error_t *);
-ZIP_EXTERN void zip_error_init(zip_error_t *);
-ZIP_EXTERN void zip_error_init_with_code(zip_error_t *, int);
-ZIP_EXTERN void zip_error_set(zip_error_t *, int, int);
-ZIP_EXTERN const char *zip_error_strerror(zip_error_t *);
-ZIP_EXTERN int zip_error_system_type(const zip_error_t *);
-ZIP_EXTERN zip_int64_t zip_error_to_data(const zip_error_t *, void *, zip_uint64_t);
-
-ZIP_EXTERN int zip_fclose(zip_file_t *);
-ZIP_EXTERN zip_t *zip_fdopen(int, int, int *);
-ZIP_EXTERN zip_int64_t zip_file_add(zip_t *, const char *, zip_source_t *, zip_flags_t);
-ZIP_EXTERN void zip_file_error_clear(zip_file_t *);
-ZIP_EXTERN int zip_file_extra_field_delete(zip_t *, zip_uint64_t, zip_uint16_t, zip_flags_t);
-ZIP_EXTERN int zip_file_extra_field_delete_by_id(zip_t *, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_flags_t);
-ZIP_EXTERN int zip_file_extra_field_set(zip_t *, zip_uint64_t, zip_uint16_t, zip_uint16_t, const zip_uint8_t *, zip_uint16_t, zip_flags_t);
-ZIP_EXTERN zip_int16_t zip_file_extra_fields_count(zip_t *, zip_uint64_t, zip_flags_t);
-ZIP_EXTERN zip_int16_t zip_file_extra_fields_count_by_id(zip_t *, zip_uint64_t, zip_uint16_t, zip_flags_t);
-ZIP_EXTERN const zip_uint8_t *zip_file_extra_field_get(zip_t *, zip_uint64_t, zip_uint16_t, zip_uint16_t *, zip_uint16_t *, zip_flags_t);
-ZIP_EXTERN const zip_uint8_t *zip_file_extra_field_get_by_id(zip_t *, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_uint16_t *, zip_flags_t);
-ZIP_EXTERN const char *zip_file_get_comment(zip_t *, zip_uint64_t, zip_uint32_t *, zip_flags_t);
-ZIP_EXTERN zip_error_t *zip_file_get_error(zip_file_t *);
-ZIP_EXTERN int zip_file_get_external_attributes(zip_t *, zip_uint64_t, zip_flags_t, zip_uint8_t *, zip_uint32_t *);
-ZIP_EXTERN int zip_file_rename(zip_t *, zip_uint64_t, const char *, zip_flags_t);
-ZIP_EXTERN int zip_file_replace(zip_t *, zip_uint64_t, zip_source_t *, zip_flags_t);
-ZIP_EXTERN int zip_file_set_comment(zip_t *, zip_uint64_t, const char *, zip_uint16_t, zip_flags_t);
-ZIP_EXTERN int zip_file_set_encryption(zip_t *, zip_uint64_t, zip_uint16_t, const char *);
-ZIP_EXTERN int zip_file_set_external_attributes(zip_t *, zip_uint64_t, zip_flags_t, zip_uint8_t, zip_uint32_t);
-ZIP_EXTERN int zip_file_set_mtime(zip_t *, zip_uint64_t, time_t, zip_flags_t);
-ZIP_EXTERN const char *zip_file_strerror(zip_file_t *);
-ZIP_EXTERN zip_file_t *zip_fopen(zip_t *, const char *, zip_flags_t);
-ZIP_EXTERN zip_file_t *zip_fopen_encrypted(zip_t *, const char *, zip_flags_t, const char *);
-ZIP_EXTERN zip_file_t *zip_fopen_index(zip_t *, zip_uint64_t, zip_flags_t);
-ZIP_EXTERN zip_file_t *zip_fopen_index_encrypted(zip_t *, zip_uint64_t, zip_flags_t, const char *);
-ZIP_EXTERN zip_int64_t zip_fread(zip_file_t *, void *, zip_uint64_t);
-ZIP_EXTERN zip_int8_t zip_fseek(zip_file_t *, zip_int64_t, int);
-ZIP_EXTERN zip_int64_t zip_ftell(zip_file_t *);
-ZIP_EXTERN const char *zip_get_archive_comment(zip_t *, int *, zip_flags_t);
-ZIP_EXTERN int zip_get_archive_flag(zip_t *, zip_flags_t, zip_flags_t);
-ZIP_EXTERN const char *zip_get_name(zip_t *, zip_uint64_t, zip_flags_t);
-ZIP_EXTERN zip_int64_t zip_get_num_entries(zip_t *, zip_flags_t);
-ZIP_EXTERN const char *zip_libzip_version(void);
-ZIP_EXTERN zip_int64_t zip_name_locate(zip_t *, const char *, zip_flags_t);
-ZIP_EXTERN zip_t *zip_open(const char *, int, int *);
-ZIP_EXTERN zip_t *zip_open_from_source(zip_source_t *, int, zip_error_t *);
-ZIP_EXTERN int zip_register_progress_callback_with_state(zip_t *, double, zip_progress_callback, void (*)(void *), void *);
-ZIP_EXTERN int zip_set_archive_comment(zip_t *, const char *, zip_uint16_t);
-ZIP_EXTERN int zip_set_archive_flag(zip_t *, zip_flags_t, int);
-ZIP_EXTERN int zip_set_default_password(zip_t *, const char *);
-ZIP_EXTERN int zip_set_file_compression(zip_t *, zip_uint64_t, zip_int32_t, zip_uint32_t);
-ZIP_EXTERN int zip_source_begin_write(zip_source_t *);
-ZIP_EXTERN int zip_source_begin_write_cloning(zip_source_t *, zip_uint64_t);
-ZIP_EXTERN zip_source_t *zip_source_buffer(zip_t *, const void *, zip_uint64_t, int);
-ZIP_EXTERN zip_source_t *zip_source_buffer_create(const void *, zip_uint64_t, int, zip_error_t *);
-ZIP_EXTERN zip_source_t *zip_source_buffer_fragment(zip_t *, const zip_buffer_fragment_t *, zip_uint64_t, int);
-ZIP_EXTERN zip_source_t *zip_source_buffer_fragment_create(const zip_buffer_fragment_t *, zip_uint64_t, int, zip_error_t *);
-ZIP_EXTERN int zip_source_close(zip_source_t *);
-ZIP_EXTERN int zip_source_commit_write(zip_source_t *);
-ZIP_EXTERN zip_error_t *zip_source_error(zip_source_t *);
-ZIP_EXTERN zip_source_t *zip_source_file(zip_t *, const char *, zip_uint64_t, zip_int64_t);
-ZIP_EXTERN zip_source_t *zip_source_file_create(const char *, zip_uint64_t, zip_int64_t, zip_error_t *);
-ZIP_EXTERN zip_source_t *zip_source_filep(zip_t *, FILE *, zip_uint64_t, zip_int64_t);
-ZIP_EXTERN zip_source_t *zip_source_filep_create(FILE *, zip_uint64_t, zip_int64_t, zip_error_t *);
-ZIP_EXTERN void zip_source_free(zip_source_t *);
-ZIP_EXTERN zip_source_t *zip_source_function(zip_t *, zip_source_callback, void *);
-ZIP_EXTERN zip_source_t *zip_source_function_create(zip_source_callback, void *, zip_error_t *);
-ZIP_EXTERN int zip_source_is_deleted(zip_source_t *);
-ZIP_EXTERN void zip_source_keep(zip_source_t *);
+ZIP_EXTERN int zip_close(zip_t * _Nonnull);
+ZIP_EXTERN int zip_delete(zip_t * _Nonnull, zip_uint64_t);
+ZIP_EXTERN zip_int64_t zip_dir_add(zip_t * _Nonnull, const char * _Nonnull, zip_flags_t);
+ZIP_EXTERN void zip_discard(zip_t * _Nonnull);
+
+ZIP_EXTERN zip_error_t * _Nonnull zip_get_error(zip_t * _Nonnull);
+ZIP_EXTERN void zip_error_clear(zip_t * _Nonnull);
+ZIP_EXTERN int zip_error_code_zip(const zip_error_t * _Nonnull);
+ZIP_EXTERN int zip_error_code_system(const zip_error_t * _Nonnull);
+ZIP_EXTERN void zip_error_fini(zip_error_t * _Nonnull);
+ZIP_EXTERN void zip_error_init(zip_error_t * _Nonnull);
+ZIP_EXTERN void zip_error_init_with_code(zip_error_t * _Nonnull, int);
+ZIP_EXTERN void zip_error_set(zip_error_t * _Nullable, int, int);
+ZIP_EXTERN const char * _Nonnull zip_error_strerror(zip_error_t * _Nonnull);
+ZIP_EXTERN int zip_error_system_type(const zip_error_t * _Nonnull);
+ZIP_EXTERN zip_int64_t zip_error_to_data(const zip_error_t * _Nonnull, void * _Nonnull, zip_uint64_t);
+
+ZIP_EXTERN int zip_fclose(zip_file_t * _Nonnull);
+ZIP_EXTERN zip_t * _Nullable zip_fdopen(int, int, int * _Nullable);
+ZIP_EXTERN zip_int64_t zip_file_add(zip_t * _Nonnull, const char * _Nonnull, zip_source_t * _Nonnull, zip_flags_t);
+ZIP_EXTERN void zip_file_error_clear(zip_file_t * _Nonnull);
+ZIP_EXTERN int zip_file_extra_field_delete(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, zip_flags_t);
+ZIP_EXTERN int zip_file_extra_field_delete_by_id(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_flags_t);
+ZIP_EXTERN int zip_file_extra_field_set(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, zip_uint16_t, const zip_uint8_t * _Nullable, zip_uint16_t, zip_flags_t);
+ZIP_EXTERN zip_int16_t zip_file_extra_fields_count(zip_t * _Nonnull, zip_uint64_t, zip_flags_t);
+ZIP_EXTERN zip_int16_t zip_file_extra_fields_count_by_id(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, zip_flags_t);
+ZIP_EXTERN const zip_uint8_t * _Nullable zip_file_extra_field_get(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, zip_uint16_t * _Nullable, zip_uint16_t * _Nullable, zip_flags_t);
+ZIP_EXTERN const zip_uint8_t * _Nullable zip_file_extra_field_get_by_id(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_uint16_t * _Nullable, zip_flags_t);
+ZIP_EXTERN const char * _Nullable zip_file_get_comment(zip_t * _Nonnull, zip_uint64_t, zip_uint32_t * _Nullable, zip_flags_t);
+ZIP_EXTERN zip_error_t * _Nonnull zip_file_get_error(zip_file_t * _Nonnull);
+ZIP_EXTERN int zip_file_get_external_attributes(zip_t * _Nonnull, zip_uint64_t, zip_flags_t, zip_uint8_t * _Nullable, zip_uint32_t * _Nullable);
+ZIP_EXTERN int zip_file_rename(zip_t * _Nonnull, zip_uint64_t, const char * _Nonnull, zip_flags_t);
+ZIP_EXTERN int zip_file_replace(zip_t * _Nonnull, zip_uint64_t, zip_source_t * _Nonnull, zip_flags_t);
+ZIP_EXTERN int zip_file_set_comment(zip_t * _Nonnull, zip_uint64_t, const char * _Nullable, zip_uint16_t, zip_flags_t);
+ZIP_EXTERN int zip_file_set_encryption(zip_t * _Nonnull, zip_uint64_t, zip_uint16_t, const char * _Nullable);
+ZIP_EXTERN int zip_file_set_external_attributes(zip_t * _Nonnull, zip_uint64_t, zip_flags_t, zip_uint8_t, zip_uint32_t);
+ZIP_EXTERN int zip_file_set_mtime(zip_t * _Nonnull, zip_uint64_t, time_t, zip_flags_t);
+ZIP_EXTERN const char * _Nonnull zip_file_strerror(zip_file_t * _Nonnull);
+ZIP_EXTERN zip_file_t * _Nullable zip_fopen(zip_t * _Nonnull, const char * _Nonnull, zip_flags_t);
+ZIP_EXTERN zip_file_t * _Nullable zip_fopen_encrypted(zip_t * _Nonnull, const char * _Nonnull, zip_flags_t, const char * _Nullable);
+ZIP_EXTERN zip_file_t * _Nullable zip_fopen_index(zip_t * _Nonnull, zip_uint64_t, zip_flags_t);
+ZIP_EXTERN zip_file_t * _Nullable zip_fopen_index_encrypted(zip_t * _Nonnull, zip_uint64_t, zip_flags_t, const char * _Nullable);
+ZIP_EXTERN zip_int64_t zip_fread(zip_file_t * _Nonnull, void * _Nonnull, zip_uint64_t);
+ZIP_EXTERN zip_int8_t zip_fseek(zip_file_t * _Nonnull, zip_int64_t, int);
+ZIP_EXTERN zip_int64_t zip_ftell(zip_file_t * _Nonnull);
+ZIP_EXTERN const char * _Nullable zip_get_archive_comment(zip_t * _Nonnull, int * _Nullable, zip_flags_t);
+ZIP_EXTERN int zip_get_archive_flag(zip_t * _Nonnull, zip_flags_t, zip_flags_t);
+ZIP_EXTERN const char * _Nullable zip_get_name(zip_t * _Nonnull, zip_uint64_t, zip_flags_t);
+ZIP_EXTERN zip_int64_t zip_get_num_entries(zip_t * _Nonnull, zip_flags_t);
+ZIP_EXTERN const char * _Nonnull zip_libzip_version(void);
+ZIP_EXTERN zip_int64_t zip_name_locate(zip_t * _Nonnull, const char * _Nonnull, zip_flags_t);
+ZIP_EXTERN zip_t * _Nullable zip_open(const char * _Nonnull, int, int * _Nullable);
+ZIP_EXTERN zip_t * _Nullable zip_open_from_source(zip_source_t * _Nonnull, int, zip_error_t * _Nullable);
+ZIP_EXTERN int zip_register_progress_callback_with_state(zip_t * _Nonnull, double, zip_progress_callback _Nullable, void (* _Nullable)(void * _Nullable), void * _Nullable);
+ZIP_EXTERN int zip_set_archive_comment(zip_t * _Nonnull, const char * _Nullable, zip_uint16_t);
+ZIP_EXTERN int zip_set_archive_flag(zip_t * _Nonnull, zip_flags_t, int);
+ZIP_EXTERN int zip_set_default_password(zip_t * _Nonnull, const char * _Nullable);
+ZIP_EXTERN int zip_set_file_compression(zip_t * _Nonnull, zip_uint64_t, zip_int32_t, zip_uint32_t);
+ZIP_EXTERN int zip_source_begin_write(zip_source_t * _Nonnull);
+ZIP_EXTERN int zip_source_begin_write_cloning(zip_source_t * _Nonnull, zip_uint64_t);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_buffer(zip_t * _Nonnull, const void * _Nullable, zip_uint64_t, int);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_buffer_create(const void * _Nullable, zip_uint64_t, int, zip_error_t * _Nullable);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_buffer_fragment(zip_t * _Nonnull, const zip_buffer_fragment_t * _Nonnull, zip_uint64_t, int);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_buffer_fragment_create(const zip_buffer_fragment_t * _Nonnull, zip_uint64_t, int, zip_error_t * _Nullable);
+ZIP_EXTERN int zip_source_close(zip_source_t * _Nonnull);
+ZIP_EXTERN int zip_source_commit_write(zip_source_t * _Nonnull);
+ZIP_EXTERN zip_error_t * _Nonnull zip_source_error(zip_source_t * _Nonnull);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_file(zip_t * _Nonnull, const char * _Nonnull, zip_uint64_t, zip_int64_t);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_file_create(const char * _Nonnull, zip_uint64_t, zip_int64_t, zip_error_t * _Nullable);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_filep(zip_t * _Nonnull, FILE * _Nonnull, zip_uint64_t, zip_int64_t);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_filep_create(FILE * _Nonnull, zip_uint64_t, zip_int64_t, zip_error_t * _Nullable);
+ZIP_EXTERN void zip_source_free(zip_source_t * _Nullable);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_function(zip_t * _Nonnull, zip_source_callback _Nonnull , void * _Nullable);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_function_create(zip_source_callback _Nonnull , void * _Nullable, zip_error_t * _Nullable);
+ZIP_EXTERN int zip_source_is_deleted(zip_source_t * _Nonnull);
+ZIP_EXTERN void zip_source_keep(zip_source_t * _Nonnull);
ZIP_EXTERN zip_int64_t zip_source_make_command_bitmap(zip_source_cmd_t, ...);
-ZIP_EXTERN int zip_source_open(zip_source_t *);
-ZIP_EXTERN zip_int64_t zip_source_read(zip_source_t *, void *, zip_uint64_t);
-ZIP_EXTERN void zip_source_rollback_write(zip_source_t *);
-ZIP_EXTERN int zip_source_seek(zip_source_t *, zip_int64_t, int);
-ZIP_EXTERN zip_int64_t zip_source_seek_compute_offset(zip_uint64_t, zip_uint64_t, void *, zip_uint64_t, zip_error_t *);
-ZIP_EXTERN int zip_source_seek_write(zip_source_t *, zip_int64_t, int);
-ZIP_EXTERN int zip_source_stat(zip_source_t *, zip_stat_t *);
-ZIP_EXTERN zip_int64_t zip_source_tell(zip_source_t *);
-ZIP_EXTERN zip_int64_t zip_source_tell_write(zip_source_t *);
+ZIP_EXTERN int zip_source_open(zip_source_t * _Nonnull);
+ZIP_EXTERN zip_int64_t zip_source_read(zip_source_t * _Nonnull, void * _Nonnull, zip_uint64_t);
+ZIP_EXTERN void zip_source_rollback_write(zip_source_t * _Nonnull);
+ZIP_EXTERN int zip_source_seek(zip_source_t * _Nonnull, zip_int64_t, int);
+ZIP_EXTERN zip_int64_t zip_source_seek_compute_offset(zip_uint64_t, zip_uint64_t, void * _Nonnull, zip_uint64_t, zip_error_t * _Nullable);
+ZIP_EXTERN int zip_source_seek_write(zip_source_t * _Nonnull, zip_int64_t, int);
+ZIP_EXTERN int zip_source_stat(zip_source_t * _Nonnull, zip_stat_t * _Nonnull);
+ZIP_EXTERN zip_int64_t zip_source_tell(zip_source_t * _Nonnull);
+ZIP_EXTERN zip_int64_t zip_source_tell_write(zip_source_t * _Nonnull);
#ifdef _WIN32
ZIP_EXTERN zip_source_t *zip_source_win32a(zip_t *, const char *, zip_uint64_t, zip_int64_t);
ZIP_EXTERN zip_source_t *zip_source_win32a_create(const char *, zip_uint64_t, zip_int64_t, zip_error_t *);
ZIP_EXTERN zip_source_t *zip_source_win32w(zip_t *, const wchar_t *, zip_uint64_t, zip_int64_t);
ZIP_EXTERN zip_source_t *zip_source_win32w_create(const wchar_t *, zip_uint64_t, zip_int64_t, zip_error_t *);
#endif
-ZIP_EXTERN zip_int64_t zip_source_write(zip_source_t *, const void *, zip_uint64_t);
-ZIP_EXTERN zip_source_t *zip_source_zip(zip_t *, zip_t *, zip_uint64_t, zip_flags_t, zip_uint64_t, zip_int64_t);
-ZIP_EXTERN int zip_stat(zip_t *, const char *, zip_flags_t, zip_stat_t *);
-ZIP_EXTERN int zip_stat_index(zip_t *, zip_uint64_t, zip_flags_t, zip_stat_t *);
-ZIP_EXTERN void zip_stat_init(zip_stat_t *);
-ZIP_EXTERN const char *zip_strerror(zip_t *);
-ZIP_EXTERN int zip_unchange(zip_t *, zip_uint64_t);
-ZIP_EXTERN int zip_unchange_all(zip_t *);
-ZIP_EXTERN int zip_unchange_archive(zip_t *);
+ZIP_EXTERN zip_int64_t zip_source_write(zip_source_t * _Nonnull, const void * _Nullable, zip_uint64_t);
+ZIP_EXTERN zip_source_t * _Nullable zip_source_zip(zip_t * _Nonnull, zip_t * _Nonnull, zip_uint64_t, zip_flags_t, zip_uint64_t, zip_int64_t);
+ZIP_EXTERN int zip_stat(zip_t * _Nonnull, const char * _Nonnull, zip_flags_t, zip_stat_t * _Nonnull);
+ZIP_EXTERN int zip_stat_index(zip_t * _Nonnull, zip_uint64_t, zip_flags_t, zip_stat_t * _Nonnull);
+ZIP_EXTERN void zip_stat_init( zip_stat_t * _Nonnull);
+ZIP_EXTERN const char * _Nonnull zip_strerror(zip_t * _Nonnull);
+ZIP_EXTERN int zip_unchange(zip_t * _Nonnull, zip_uint64_t);
+ZIP_EXTERN int zip_unchange_all(zip_t * _Nonnull);
+ZIP_EXTERN int zip_unchange_archive(zip_t * _Nonnull);
#ifdef __cplusplus
}
/*
zip_add.c -- add file via callback function
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_add_dir.c -- add directory
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_add_entry.c -- create and init struct zip_entry
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_algorithm_bzip2.c -- bzip2 (de)compression routines
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_algorithm_deflate.c -- deflate (de)compression routines
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_buffer.c -- bounds checked access to memory buffer
- Copyright (C) 2014-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_close.c -- close zip archive and update changes
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
static int
copy_data(zip_t *za, zip_uint64_t len) {
- zip_uint8_t buf[BUFSIZE];
+ DEFINE_BYTE_ARRAY(buf, BUFSIZE);
size_t n;
double total = (double)len;
+ if (!byte_array_init(buf, BUFSIZE)) {
+ zip_error_set(&za->error, ZIP_ER_MEMORY, 0);
+ return -1;
+ }
+
while (len > 0) {
- n = len > sizeof(buf) ? sizeof(buf) : len;
+ n = len > BUFSIZE ? BUFSIZE : len;
if (_zip_read(za->src, buf, n, &za->error) < 0) {
+ byte_array_fini(buf);
return -1;
}
if (_zip_write(za, buf, n) < 0) {
+ byte_array_fini(buf);
return -1;
}
_zip_progress_update(za->progress, (total - (double)len) / total);
}
+ byte_array_fini(buf);
return 0;
}
static int
copy_source(zip_t *za, zip_source_t *src, zip_int64_t data_length) {
- zip_uint8_t buf[BUFSIZE];
+ DEFINE_BYTE_ARRAY(buf, BUFSIZE);
zip_int64_t n, current;
int ret;
return -1;
}
+ if (!byte_array_init(buf, BUFSIZE)) {
+ zip_error_set(&za->error, ZIP_ER_MEMORY, 0);
+ return -1;
+ }
+
ret = 0;
current = 0;
- while ((n = zip_source_read(src, buf, sizeof(buf))) > 0) {
+ while ((n = zip_source_read(src, buf, BUFSIZE)) > 0) {
if (_zip_write(za, buf, (zip_uint64_t)n) < 0) {
ret = -1;
break;
}
- if (n == sizeof(buf) && za->progress && data_length > 0) {
+ if (n == BUFSIZE && za->progress && data_length > 0) {
current += n;
_zip_progress_update(za->progress, (double)current / (double)data_length);
}
ret = -1;
}
+ byte_array_fini(buf);
+
zip_source_close(src);
return ret;
/*
zip_crypto.h -- crypto definitions
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
#define ZIP_CRYPTO_SHA1_LENGTH 20
#define ZIP_CRYPTO_AES_BLOCK_LENGTH 16
-#if defined(HAVE_OPENSSL)
-#include "zip_crypto_openssl.h"
-#elif defined(HAVE_GNUTLS)
-#include "zip_crypto_gnutls.h"
+#if defined(HAVE_WINDOWS_CRYPTO)
+#include "zip_crypto_win.h"
#elif defined(HAVE_COMMONCRYPTO)
#include "zip_crypto_commoncrypto.h"
+#elif defined(HAVE_GNUTLS)
+#include "zip_crypto_gnutls.h"
+#elif defined(HAVE_OPENSSL)
+#include "zip_crypto_openssl.h"
+#elif defined(HAVE_MBEDTLS)
+#include "zip_crypto_mbedtls.h"
#else
#error "no crypto backend found"
#endif
#include <unistd.h>
void
-_zip_crypto_aes_free(_zip_crypto_aes_t *aes)
-{
+_zip_crypto_aes_free(_zip_crypto_aes_t *aes) {
if (aes == NULL) {
- return;
+ return;
}
CCCryptorRelease(aes);
bool
-_zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out)
-{
+_zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out) {
size_t len;
CCCryptorUpdate(aes, in, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, ZIP_CRYPTO_AES_BLOCK_LENGTH, &len);
return true;
_zip_crypto_aes_t *
-_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error)
-{
+_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error) {
_zip_crypto_aes_t *aes;
CCCryptorStatus ret;
switch (ret) {
case kCCSuccess:
- return aes;
+ return aes;
case kCCMemoryFailure:
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
case kCCParamError:
- zip_error_set(error, ZIP_ER_INVAL, 0);
- return NULL;
+ zip_error_set(error, ZIP_ER_INVAL, 0);
+ return NULL;
default:
- zip_error_set(error, ZIP_ER_INTERNAL, 0);
- return NULL;
+ zip_error_set(error, ZIP_ER_INTERNAL, 0);
+ return NULL;
}
}
void
-_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac)
-{
+_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac) {
if (hmac == NULL) {
- return;
+ return;
}
_zip_crypto_clear(hmac, sizeof(*hmac));
_zip_crypto_hmac_t *
-_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error)
-{
+_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error) {
_zip_crypto_hmac_t *hmac;
if ((hmac = (_zip_crypto_hmac_t *)malloc(sizeof(*hmac))) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
}
CCHmacInit(hmac, kCCHmacAlgSHA1, secret, secret_length);
int fd;
if ((fd = open("/dev/urandom", O_RDONLY)) < 0) {
- return false;
+ return false;
}
if (read(fd, buffer, length) != length) {
- close(fd);
- return false;
+ close(fd);
+ return false;
}
close(fd);
_zip_crypto_hmac_t *_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error);
#define _zip_crypto_hmac_output(hmac, data) (CCHmacFinal((hmac), (data)), true)
-#define _zip_crypto_pbkdf2(key, key_length, salt, salt_length, iterations, output, output_length) \
- (CCKeyDerivationPBKDF(kCCPBKDF2, (const char *)(key), (key_length), (salt), (salt_length), kCCPRFHmacAlgSHA1, (iterations), (output), (output_length)) == kCCSuccess)
+#define _zip_crypto_pbkdf2(key, key_length, salt, salt_length, iterations, output, output_length) (CCKeyDerivationPBKDF(kCCPBKDF2, (const char *)(key), (key_length), (salt), (salt_length), kCCPRFHmacAlgSHA1, (iterations), (output), (output_length)) == kCCSuccess)
#endif /* HAD_ZIP_CRYPTO_COMMONCRYPTO_H */
#include <stdlib.h>
#include "zipint.h"
+
#include "zip_crypto.h"
_zip_crypto_aes_t *
-_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error)
-{
+_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error) {
_zip_crypto_aes_t *aes;
- if ((aes = (_zip_crypto_aes_t *)malloc(sizeof(*aes))) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ if ((aes = (_zip_crypto_aes_t *)malloc(sizeof(*aes))) == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
}
aes->key_size = key_size;
switch (aes->key_size) {
case 128:
- nettle_aes128_set_encrypt_key(&aes->ctx.ctx_128, key);
- break;
+ nettle_aes128_set_encrypt_key(&aes->ctx.ctx_128, key);
+ break;
case 192:
- nettle_aes192_set_encrypt_key(&aes->ctx.ctx_192, key);
- break;
+ nettle_aes192_set_encrypt_key(&aes->ctx.ctx_192, key);
+ break;
case 256:
- nettle_aes256_set_encrypt_key(&aes->ctx.ctx_256, key);
- break;
+ nettle_aes256_set_encrypt_key(&aes->ctx.ctx_256, key);
+ break;
default:
- zip_error_set(error, ZIP_ER_INVAL, 0);
- free(aes);
- return NULL;
+ zip_error_set(error, ZIP_ER_INVAL, 0);
+ free(aes);
+ return NULL;
}
return aes;
}
bool
-_zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out)
-{
+_zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out) {
switch (aes->key_size) {
case 128:
- nettle_aes128_encrypt(&aes->ctx.ctx_128, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, in);
- break;
+ nettle_aes128_encrypt(&aes->ctx.ctx_128, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, in);
+ break;
case 192:
- nettle_aes192_encrypt(&aes->ctx.ctx_192, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, in);
- break;
+ nettle_aes192_encrypt(&aes->ctx.ctx_192, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, in);
+ break;
case 256:
- nettle_aes256_encrypt(&aes->ctx.ctx_256, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, in);
- break;
+ nettle_aes256_encrypt(&aes->ctx.ctx_256, ZIP_CRYPTO_AES_BLOCK_LENGTH, out, in);
+ break;
}
return true;
}
void
-_zip_crypto_aes_free(_zip_crypto_aes_t *aes)
-{
+_zip_crypto_aes_free(_zip_crypto_aes_t *aes) {
if (aes == NULL) {
- return;
+ return;
}
_zip_crypto_clear(aes, sizeof(*aes));
_zip_crypto_hmac_t *
-_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error)
-{
+_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error) {
_zip_crypto_hmac_t *hmac;
int ret;
- if ((hmac = (_zip_crypto_hmac_t *)malloc(sizeof(*hmac))) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ if ((hmac = (_zip_crypto_hmac_t *)malloc(sizeof(*hmac))) == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
}
if ((ret = gnutls_hmac_init(hmac, GNUTLS_MAC_SHA1, secret, secret_length)) < 0) {
- // TODO: set error
- free(hmac);
- return NULL;
+ // TODO: set error
+ free(hmac);
+ return NULL;
}
return hmac;
void
-_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac)
-{
+_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac) {
zip_uint8_t buf[ZIP_CRYPTO_SHA1_LENGTH];
if (hmac == NULL) {
- return;
+ return;
}
gnutls_hmac_deinit(*hmac, buf);
zip_random(zip_uint8_t *buffer, zip_uint16_t length) {
return gnutls_rnd(GNUTLS_RND_KEY, buffer, length) == 0;
}
-
#include <nettle/aes.h>
#include <nettle/pbkdf2.h>
-#include <gnutls/gnutls.h>
#include <gnutls/crypto.h>
+#include <gnutls/gnutls.h>
typedef struct {
union {
- struct aes128_ctx ctx_128;
- struct aes192_ctx ctx_192;
- struct aes256_ctx ctx_256;
+ struct aes128_ctx ctx_128;
+ struct aes192_ctx ctx_192;
+ struct aes256_ctx ctx_256;
} ctx;
zip_uint16_t key_size;
-} _zip_crypto_aes_t;
+} _zip_crypto_aes_t;
#define _zip_crypto_hmac_t gnutls_hmac_hd_t
bool _zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out);
_zip_crypto_aes_t *_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error);
-#define _zip_crypto_hmac(hmac, data, length) (gnutls_hmac(*(hmac), (data), (length)) == 0)
+#define _zip_crypto_hmac(hmac, data, length) (gnutls_hmac(*(hmac), (data), (length)) == 0)
void _zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac);
_zip_crypto_hmac_t *_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error);
#define _zip_crypto_hmac_output(hmac, data) (gnutls_hmac_output(*(hmac), (data)), true)
-#define _zip_crypto_pbkdf2(key, key_length, salt, salt_length, iterations, output, output_length) \
- (pbkdf2_hmac_sha1((key_length), (key), (iterations), (salt_length), (salt), (output_length), (output)), true)
+#define _zip_crypto_pbkdf2(key, key_length, salt, salt_length, iterations, output, output_length) (pbkdf2_hmac_sha1((key_length), (key), (iterations), (salt_length), (salt), (output_length), (output)), true)
#endif /* HAD_ZIP_CRYPTO_GNUTLS_H */
--- /dev/null
+/*
+ zip_crypto_mbedtls.c -- mbed TLS wrapper
+ Copyright (C) 2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#include <stdlib.h>
+
+#include "zipint.h"
+#include "zip_crypto.h"
+
+#include <mbedtls/ctr_drbg.h>
+#include <mbedtls/entropy.h>
+#include <mbedtls/pkcs5.h>
+
+
+_zip_crypto_aes_t *
+_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error) {
+ _zip_crypto_aes_t *aes;
+
+ if ((aes = (_zip_crypto_aes_t *)malloc(sizeof(*aes))) == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
+ }
+
+ mbedtls_aes_init(aes);
+ mbedtls_aes_setkey_enc(aes, (const unsigned char *)key, (unsigned int)key_size);
+
+ return aes;
+}
+
+void
+_zip_crypto_aes_free(_zip_crypto_aes_t *aes) {
+ if (aes == NULL) {
+ return;
+ }
+
+ mbedtls_aes_free(aes);
+ free(aes);
+}
+
+
+_zip_crypto_hmac_t *
+_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error) {
+ _zip_crypto_hmac_t *hmac;
+
+ if (secret_length > INT_MAX) {
+ zip_error_set(error, ZIP_ER_INVAL, 0);
+ return NULL;
+ }
+
+ if ((hmac = (_zip_crypto_hmac_t *)malloc(sizeof(*hmac))) == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
+ }
+
+ mbedtls_md_init(hmac);
+
+ if (mbedtls_md_setup(hmac, mbedtls_md_info_from_type(MBEDTLS_MD_SHA1), 1) != 0) {
+ zip_error_set(error, ZIP_ER_INTERNAL, 0);
+ free(hmac);
+ return NULL;
+ }
+
+ if (mbedtls_md_hmac_starts(hmac, (const unsigned char *)secret, (size_t)secret_length) != 0) {
+ zip_error_set(error, ZIP_ER_INTERNAL, 0);
+ free(hmac);
+ return NULL;
+ }
+
+ return hmac;
+}
+
+
+void
+_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac) {
+ if (hmac == NULL) {
+ return;
+ }
+
+ mbedtls_md_free(hmac);
+ free(hmac);
+}
+
+
+bool
+_zip_crypto_pbkdf2(const zip_uint8_t *key, zip_uint64_t key_length, const zip_uint8_t *salt, zip_uint16_t salt_length, int iterations, zip_uint8_t *output, zip_uint64_t output_length) {
+ mbedtls_md_context_t sha1_ctx;
+ bool ok = true;
+
+ mbedtls_md_init(&sha1_ctx);
+
+ if (mbedtls_md_setup(&sha1_ctx, mbedtls_md_info_from_type(MBEDTLS_MD_SHA1), 1) != 0) {
+ ok = false;
+ }
+
+ if (ok && mbedtls_pkcs5_pbkdf2_hmac(&sha1_ctx, (const unsigned char *)key, (size_t)key_length, (const unsigned char *)salt, (size_t)salt_length, (unsigned int)iterations, (uint32_t)output_length, (unsigned char *)output) != 0) {
+ ok = false;
+ }
+
+ mbedtls_md_free(&sha1_ctx);
+ return ok;
+}
+
+
+typedef struct {
+ mbedtls_entropy_context entropy;
+ mbedtls_ctr_drbg_context ctr_drbg;
+} zip_random_context_t;
+
+ZIP_EXTERN bool
+zip_random(zip_uint8_t *buffer, zip_uint16_t length) {
+ static zip_random_context_t *ctx = NULL;
+ const unsigned char *pers = "zip_crypto_mbedtls";
+
+ if (!ctx) {
+ ctx = (zip_random_context_t *)malloc(sizeof(zip_random_context_t));
+ if (!ctx) {
+ return false;
+ }
+ mbedtls_entropy_init(&ctx->entropy);
+ mbedtls_ctr_drbg_init(&ctx->ctr_drbg);
+ if (mbedtls_ctr_drbg_seed(&ctx->ctr_drbg, mbedtls_entropy_func, &ctx->entropy, pers, strlen(pers)) != 0) {
+ mbedtls_ctr_drbg_free(&ctx->ctr_drbg);
+ mbedtls_entropy_free(&ctx->entropy);
+ free(ctx);
+ ctx = NULL;
+ return false;
+ }
+ }
+
+ return mbedtls_ctr_drbg_random(&ctx->ctr_drbg, (unsigned char *)buffer, (size_t)length) == 0;
+}
--- /dev/null
+/*
+ zip_crypto_mbedtls.h -- definitions for mbedtls wrapper
+ Copyright (C) 2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef HAD_ZIP_CRYPTO_MBEDTLS_H
+#define HAD_ZIP_CRYPTO_MBEDTLS_H
+
+#include <mbedtls/aes.h>
+#include <mbedtls/md.h>
+
+#define _zip_crypto_aes_t mbedtls_aes_context
+#define _zip_crypto_hmac_t mbedtls_md_context_t
+
+_zip_crypto_aes_t *_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error);
+#define _zip_crypto_aes_encrypt_block(aes, in, out) (mbedtls_aes_crypt_ecb((aes), MBEDTLS_AES_ENCRYPT, (in), (out)) == 0)
+void _zip_crypto_aes_free(_zip_crypto_aes_t *aes);
+
+_zip_crypto_hmac_t *_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error);
+#define _zip_crypto_hmac(hmac, data, length) (mbedtls_md_hmac_update((hmac), (data), (length)) == 0)
+#define _zip_crypto_hmac_output(hmac, data) (mbedtls_md_hmac_finish((hmac), (data)) == 0)
+void _zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac);
+
+bool _zip_crypto_pbkdf2(const zip_uint8_t *key, zip_uint64_t key_length, const zip_uint8_t *salt, zip_uint16_t salt_length, int iterations, zip_uint8_t *output, zip_uint64_t output_length);
+
+#endif /* HAD_ZIP_CRYPTO_MBEDTLS_H */
#include <stdlib.h>
#include "zipint.h"
+
#include "zip_crypto.h"
#include <openssl/rand.h>
_zip_crypto_aes_t *
-_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error)
-{
+_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error) {
_zip_crypto_aes_t *aes;
- if ((aes = (_zip_crypto_aes_t *)malloc(sizeof(*aes))) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ if ((aes = (_zip_crypto_aes_t *)malloc(sizeof(*aes))) == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
}
AES_set_encrypt_key(key, key_size, aes);
}
void
-_zip_crypto_aes_free(_zip_crypto_aes_t *aes)
-{
+_zip_crypto_aes_free(_zip_crypto_aes_t *aes) {
if (aes == NULL) {
- return;
+ return;
}
_zip_crypto_clear(aes, sizeof(*aes));
_zip_crypto_hmac_t *
-_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error)
-{
+_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error) {
_zip_crypto_hmac_t *hmac;
if (secret_length > INT_MAX) {
- zip_error_set(error, ZIP_ER_INVAL, 0);
- return NULL;
+ zip_error_set(error, ZIP_ER_INVAL, 0);
+ return NULL;
}
#ifdef USE_OPENSSL_1_0_API
- if ((hmac = (_zip_crypto_hmac_t *)malloc(sizeof(*hmac))) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ if ((hmac = (_zip_crypto_hmac_t *)malloc(sizeof(*hmac))) == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
}
HMAC_CTX_init(hmac);
#else
if ((hmac = HMAC_CTX_new()) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return NULL;
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
}
#endif
if (HMAC_Init_ex(hmac, secret, (int)secret_length, EVP_sha1(), NULL) != 1) {
- zip_error_set(error, ZIP_ER_INTERNAL, 0);
+ zip_error_set(error, ZIP_ER_INTERNAL, 0);
#ifdef USE_OPENSSL_1_0_API
- free(hmac);
+ free(hmac);
#else
- HMAC_CTX_free(hmac);
+ HMAC_CTX_free(hmac);
#endif
- return NULL;
+ return NULL;
}
return hmac;
void
-_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac)
-{
+_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac) {
if (hmac == NULL) {
- return;
+ return;
}
#ifdef USE_OPENSSL_1_0_API
bool
-_zip_crypto_hmac_output(_zip_crypto_hmac_t *hmac, zip_uint8_t *data)
-{
+_zip_crypto_hmac_output(_zip_crypto_hmac_t *hmac, zip_uint8_t *data) {
unsigned int length;
return HMAC_Final(hmac, data, &length) == 1;
zip_random(zip_uint8_t *buffer, zip_uint16_t length) {
return RAND_bytes(buffer, length) == 1;
}
-
-
#define _zip_crypto_hmac_t HMAC_CTX
void _zip_crypto_aes_free(_zip_crypto_aes_t *aes);
-#define _zip_crypto_aes_encrypt_block(aes, in, out) (AES_encrypt((in), (out), (aes)), true)
+#define _zip_crypto_aes_encrypt_block(aes, in, out) (AES_encrypt((in), (out), (aes)), true)
_zip_crypto_aes_t *_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error);
#define _zip_crypto_hmac(hmac, data, length) (HMAC_Update((hmac), (data), (length)) == 1)
_zip_crypto_hmac_t *_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error);
bool _zip_crypto_hmac_output(_zip_crypto_hmac_t *hmac, zip_uint8_t *data);
-#define _zip_crypto_pbkdf2(key, key_length, salt, salt_length, iterations, output, output_length) \
- (PKCS5_PBKDF2_HMAC_SHA1((const char *)(key), (key_length), (salt), (salt_length), (iterations), (output_length), (output)))
+#define _zip_crypto_pbkdf2(key, key_length, salt, salt_length, iterations, output, output_length) (PKCS5_PBKDF2_HMAC_SHA1((const char *)(key), (key_length), (salt), (salt_length), (iterations), (output_length), (output)))
#endif /* HAD_ZIP_CRYPTO_OPENSSL_H */
--- /dev/null
+/*
+ zip_crypto_win.c -- Windows Crypto API wrapper.
+ Copyright (C) 2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+#include <stdlib.h>
+
+#include "zipint.h"
+
+#include "zip_crypto.h"
+
+#define WIN32_LEAN_AND_MEAN
+#define NOCRYPT
+
+#include <Windows.h>
+#include <bcrypt.h>
+
+#pragma comment(lib, "bcrypt.lib")
+
+/*
+
+This code is using the Cryptography API: Next Generation (CNG)
+https://docs.microsoft.com/en-us/windows/desktop/seccng/cng-portal
+
+This API is supported on
+ - Windows Vista or later (client OS)
+ - Windows Server 2008 (server OS)
+ - Windows Embedded Compact 2013 (don't know about Windows Embedded Compact 7)
+
+The code was developed for Windows Embedded Compact 2013 (WEC2013),
+but should be working for all of the above mentioned OSes.
+
+There are 2 restrictions for WEC2013, Windows Vista and Windows Server 2008:
+
+1.) The function "BCryptDeriveKeyPBKDF2" is not available
+
+I found some code which is implementing this function using the deprecated Crypto API here:
+https://www.idrix.fr/Root/content/view/37/54/
+
+I took this code and converted it to the newer CNG API. The original code was more
+flexible, but this is not needed here so i refactored it a bit and just kept what is needed.
+
+The define "HAS_BCRYPTDERIVEKEYPBKDF2" controls whether "BCryptDeriveKeyPBKDF2"
+of the CNG API is used or not. This define must not be set if you are compiling for WEC2013 or Windows Vista.
+
+
+2.) "BCryptCreateHash" can't manage the memory needed for the hash object internally
+
+On Windows 7 or later it is possible to pass NULL for the hash object buffer.
+This is not supported on WEC2013, so we have to handle the memory allocation/deallocation ourselves.
+There is no #ifdef to control that, because this is working for all supported OSes.
+
+*/
+
+#if !defined(WINCE) && !defined(__MINGW32__)
+#define HAS_BCRYPTDERIVEKEYPBKDF2
+#endif
+
+#ifdef HAS_BCRYPTDERIVEKEYPBKDF2
+
+bool
+_zip_crypto_pbkdf2(const zip_uint8_t *key, zip_uint64_t key_length, const zip_uint8_t *salt, zip_uint16_t salt_length, zip_uint16_t iterations, zip_uint8_t *output, zip_uint16_t output_length) {
+ BCRYPT_ALG_HANDLE hAlgorithm = NULL;
+
+ if (!BCRYPT_SUCCESS(BCryptOpenAlgorithmProvider(&hAlgorithm, BCRYPT_SHA1_ALGORITHM, NULL, BCRYPT_ALG_HANDLE_HMAC_FLAG))) {
+ return false;
+ }
+
+ bool result = BCRYPT_SUCCESS(BCryptDeriveKeyPBKDF2(hAlgorithm, (PUCHAR)key, (ULONG)key_length, (PUCHAR)salt, salt_length, iterations, output, output_length, 0));
+
+ BCryptCloseAlgorithmProvider(hAlgorithm, 0);
+
+ return result;
+}
+
+#else
+
+#include <math.h>
+
+#define DIGEST_SIZE 20
+#define BLOCK_SIZE 64
+
+typedef struct {
+ BCRYPT_ALG_HANDLE hAlgorithm;
+ BCRYPT_HASH_HANDLE hInnerHash;
+ BCRYPT_HASH_HANDLE hOuterHash;
+ ULONG cbHashObject;
+ PUCHAR pbInnerHash;
+ PUCHAR pbOuterHash;
+} PRF_CTX;
+
+static void
+hmacFree(PRF_CTX *pContext) {
+ if (pContext->hOuterHash)
+ BCryptDestroyHash(pContext->hOuterHash);
+ if (pContext->hInnerHash)
+ BCryptDestroyHash(pContext->hInnerHash);
+ free(pContext->pbOuterHash);
+ free(pContext->pbInnerHash);
+ if (pContext->hAlgorithm)
+ BCryptCloseAlgorithmProvider(pContext->hAlgorithm, 0);
+}
+
+static BOOL
+hmacPrecomputeDigest(BCRYPT_HASH_HANDLE hHash, PUCHAR pbPassword, DWORD cbPassword, BYTE mask) {
+ BYTE buffer[BLOCK_SIZE];
+ DWORD i;
+
+ if (cbPassword > BLOCK_SIZE) {
+ return FALSE;
+ }
+
+ memset(buffer, mask, sizeof(buffer));
+
+ for (i = 0; i < cbPassword; ++i) {
+ buffer[i] = (char)(pbPassword[i] ^ mask);
+ }
+
+ return BCRYPT_SUCCESS(BCryptHashData(hHash, buffer, sizeof(buffer), 0));
+}
+
+static BOOL
+hmacInit(PRF_CTX *pContext, PUCHAR pbPassword, DWORD cbPassword) {
+ BOOL bStatus = FALSE;
+ ULONG cbResult;
+ BYTE key[DIGEST_SIZE];
+
+ if (!BCRYPT_SUCCESS(BCryptOpenAlgorithmProvider(&pContext->hAlgorithm, BCRYPT_SHA1_ALGORITHM, NULL, 0)) || !BCRYPT_SUCCESS(BCryptGetProperty(pContext->hAlgorithm, BCRYPT_OBJECT_LENGTH, (PUCHAR)&pContext->cbHashObject, sizeof(pContext->cbHashObject), &cbResult, 0)) || ((pContext->pbInnerHash = malloc(pContext->cbHashObject)) == NULL) || ((pContext->pbOuterHash = malloc(pContext->cbHashObject)) == NULL) || !BCRYPT_SUCCESS(BCryptCreateHash(pContext->hAlgorithm, &pContext->hInnerHash, pContext->pbInnerHash, pContext->cbHashObject, NULL, 0, 0)) || !BCRYPT_SUCCESS(BCryptCreateHash(pContext->hAlgorithm, &pContext->hOuterHash, pContext->pbOuterHash, pContext->cbHashObject, NULL, 0, 0))) {
+ goto hmacInit_end;
+ }
+
+ if (cbPassword > BLOCK_SIZE) {
+ BCRYPT_HASH_HANDLE hHash = NULL;
+ PUCHAR pbHashObject = malloc(pContext->cbHashObject);
+
+ bStatus = BCRYPT_SUCCESS(BCryptCreateHash(pContext->hAlgorithm, &hHash, pbHashObject, pContext->cbHashObject, NULL, 0, 0)) && BCRYPT_SUCCESS(BCryptHashData(hHash, pbPassword, cbPassword, 0)) && BCRYPT_SUCCESS(BCryptGetProperty(hHash, BCRYPT_HASH_LENGTH, (PUCHAR)&cbPassword, sizeof(cbPassword), &cbResult, 0)) && BCRYPT_SUCCESS(BCryptFinishHash(hHash, key, cbPassword, 0));
+
+ if (hHash)
+ BCryptDestroyHash(hHash);
+ free(pbHashObject);
+
+ if (!bStatus) {
+ goto hmacInit_end;
+ }
+
+ pbPassword = key;
+ }
+
+ bStatus = hmacPrecomputeDigest(pContext->hInnerHash, pbPassword, cbPassword, 0x36) && hmacPrecomputeDigest(pContext->hOuterHash, pbPassword, cbPassword, 0x5C);
+
+hmacInit_end:
+
+ if (bStatus == FALSE)
+ hmacFree(pContext);
+
+ return bStatus;
+}
+
+static BOOL
+hmacCalculateInternal(BCRYPT_HASH_HANDLE hHashTemplate, PUCHAR pbData, DWORD cbData, PUCHAR pbOutput, DWORD cbOutput, DWORD cbHashObject) {
+ BOOL success = FALSE;
+ BCRYPT_HASH_HANDLE hHash = NULL;
+ PUCHAR pbHashObject = malloc(cbHashObject);
+
+ if (BCRYPT_SUCCESS(BCryptDuplicateHash(hHashTemplate, &hHash, pbHashObject, cbHashObject, 0))) {
+ success = BCRYPT_SUCCESS(BCryptHashData(hHash, pbData, cbData, 0)) && BCRYPT_SUCCESS(BCryptFinishHash(hHash, pbOutput, cbOutput, 0));
+
+ BCryptDestroyHash(hHash);
+ }
+
+ free(pbHashObject);
+
+ return success;
+}
+
+static BOOL
+hmacCalculate(PRF_CTX *pContext, PUCHAR pbData, DWORD cbData, PUCHAR pbDigest) {
+ DWORD cbResult;
+ DWORD cbHashObject;
+
+ return BCRYPT_SUCCESS(BCryptGetProperty(pContext->hAlgorithm, BCRYPT_OBJECT_LENGTH, (PUCHAR)&cbHashObject, sizeof(cbHashObject), &cbResult, 0)) && hmacCalculateInternal(pContext->hInnerHash, pbData, cbData, pbDigest, DIGEST_SIZE, cbHashObject) && hmacCalculateInternal(pContext->hOuterHash, pbDigest, DIGEST_SIZE, pbDigest, DIGEST_SIZE, cbHashObject);
+}
+
+static void xor
+ (LPBYTE ptr1, LPBYTE ptr2, DWORD dwLen) {
+ while (dwLen--)
+ *ptr1++ ^= *ptr2++;
+ }
+
+ BOOL pbkdf2(PUCHAR pbPassword, ULONG cbPassword, PUCHAR pbSalt, ULONG cbSalt, DWORD cIterations, PUCHAR pbDerivedKey, ULONG cbDerivedKey) {
+ BOOL bStatus = FALSE;
+ DWORD l, r, dwULen, i, j;
+ BYTE Ti[DIGEST_SIZE];
+ BYTE V[DIGEST_SIZE];
+ LPBYTE U = malloc(max((cbSalt + 4), DIGEST_SIZE));
+ PRF_CTX prfCtx = {0};
+
+ if (pbPassword == NULL || cbPassword == 0 || pbSalt == NULL || cbSalt == 0 || cIterations == 0 || pbDerivedKey == NULL || cbDerivedKey == 0) {
+ free(U);
+ return FALSE;
+ }
+
+ if (!hmacInit(&prfCtx, pbPassword, cbPassword)) {
+ goto PBKDF2_end;
+ }
+
+ l = (DWORD)ceil((double)cbDerivedKey / (double)DIGEST_SIZE);
+ r = cbDerivedKey - (l - 1) * DIGEST_SIZE;
+
+ for (i = 1; i <= l; i++) {
+ ZeroMemory(Ti, DIGEST_SIZE);
+ for (j = 0; j < cIterations; j++) {
+ if (j == 0) {
+ // construct first input for PRF
+ memcpy(U, pbSalt, cbSalt);
+ U[cbSalt] = (BYTE)((i & 0xFF000000) >> 24);
+ U[cbSalt + 1] = (BYTE)((i & 0x00FF0000) >> 16);
+ U[cbSalt + 2] = (BYTE)((i & 0x0000FF00) >> 8);
+ U[cbSalt + 3] = (BYTE)((i & 0x000000FF));
+ dwULen = cbSalt + 4;
+ }
+ else {
+ memcpy(U, V, DIGEST_SIZE);
+ dwULen = DIGEST_SIZE;
+ }
+
+ if (!hmacCalculate(&prfCtx, U, dwULen, V)) {
+ goto PBKDF2_end;
+ }
+
+ xor(Ti, V, DIGEST_SIZE);
+ }
+
+ if (i != l) {
+ memcpy(&pbDerivedKey[(i - 1) * DIGEST_SIZE], Ti, DIGEST_SIZE);
+ }
+ else {
+ // Take only the first r bytes
+ memcpy(&pbDerivedKey[(i - 1) * DIGEST_SIZE], Ti, r);
+ }
+ }
+
+ bStatus = TRUE;
+
+PBKDF2_end:
+
+ hmacFree(&prfCtx);
+ free(U);
+ return bStatus;
+}
+
+bool
+_zip_crypto_pbkdf2(const zip_uint8_t *key, zip_uint64_t key_length, const zip_uint8_t *salt, zip_uint16_t salt_length, zip_uint16_t iterations, zip_uint8_t *output, zip_uint16_t output_length) {
+ return (key_length <= ZIP_UINT32_MAX) && pbkdf2((PUCHAR)key, (ULONG)key_length, (PUCHAR)salt, salt_length, iterations, output, output_length);
+}
+
+#endif
+
+
+struct _zip_crypto_aes_s {
+ BCRYPT_ALG_HANDLE hAlgorithm;
+ BCRYPT_KEY_HANDLE hKey;
+ ULONG cbKeyObject;
+ PUCHAR pbKeyObject;
+};
+
+_zip_crypto_aes_t *
+_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error) {
+ _zip_crypto_aes_t *aes = (_zip_crypto_aes_t *)calloc(1, sizeof(*aes));
+
+ ULONG cbResult;
+ ULONG key_length = key_size / 8;
+
+ if (aes == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
+ }
+
+ if (!BCRYPT_SUCCESS(BCryptOpenAlgorithmProvider(&aes->hAlgorithm, BCRYPT_AES_ALGORITHM, NULL, 0))) {
+ _zip_crypto_aes_free(aes);
+ return NULL;
+ }
+
+ if (!BCRYPT_SUCCESS(BCryptSetProperty(aes->hAlgorithm, BCRYPT_CHAINING_MODE, (PUCHAR)BCRYPT_CHAIN_MODE_ECB, sizeof(BCRYPT_CHAIN_MODE_ECB), 0))) {
+ _zip_crypto_aes_free(aes);
+ return NULL;
+ }
+
+ if (!BCRYPT_SUCCESS(BCryptGetProperty(aes->hAlgorithm, BCRYPT_OBJECT_LENGTH, (PUCHAR)&aes->cbKeyObject, sizeof(aes->cbKeyObject), &cbResult, 0))) {
+ _zip_crypto_aes_free(aes);
+ return NULL;
+ }
+
+ aes->pbKeyObject = malloc(aes->cbKeyObject);
+
+ if (!BCRYPT_SUCCESS(BCryptGenerateSymmetricKey(aes->hAlgorithm, &aes->hKey, aes->pbKeyObject, aes->cbKeyObject, (PUCHAR)key, key_length, 0))) {
+ _zip_crypto_aes_free(aes);
+ return NULL;
+ }
+
+ return aes;
+}
+
+void
+_zip_crypto_aes_free(_zip_crypto_aes_t *aes) {
+ if (aes == NULL) {
+ return;
+ }
+
+ if (aes->hKey != NULL) {
+ BCryptDestroyKey(aes->hKey);
+ }
+
+ if (aes->pbKeyObject != NULL) {
+ free(aes->pbKeyObject);
+ }
+
+ if (aes->hAlgorithm != NULL) {
+ BCryptCloseAlgorithmProvider(aes->hAlgorithm, 0);
+ }
+
+ free(aes);
+}
+
+bool
+_zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out) {
+ ULONG cbResult;
+ NTSTATUS status = BCryptEncrypt(aes->hKey, (PUCHAR)in, ZIP_CRYPTO_AES_BLOCK_LENGTH, NULL, NULL, 0, (PUCHAR)out, ZIP_CRYPTO_AES_BLOCK_LENGTH, &cbResult, 0);
+ return BCRYPT_SUCCESS(status);
+}
+
+struct _zip_crypto_hmac_s {
+ BCRYPT_ALG_HANDLE hAlgorithm;
+ BCRYPT_HASH_HANDLE hHash;
+ DWORD cbHashObject;
+ PUCHAR pbHashObject;
+ DWORD cbHash;
+ PUCHAR pbHash;
+};
+
+// https://code.msdn.microsoft.com/windowsdesktop/Hmac-Computation-Sample-11fe8ec1/sourcecode?fileId=42820&pathId=283874677
+
+_zip_crypto_hmac_t *
+_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error) {
+ NTSTATUS status;
+ ULONG cbResult;
+ _zip_crypto_hmac_t *hmac;
+
+ if (secret_length > INT_MAX) {
+ zip_error_set(error, ZIP_ER_INVAL, 0);
+ return NULL;
+ }
+
+ hmac = (_zip_crypto_hmac_t *)calloc(1, sizeof(*hmac));
+
+ if (hmac == NULL) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return NULL;
+ }
+
+ status = BCryptOpenAlgorithmProvider(&hmac->hAlgorithm, BCRYPT_SHA1_ALGORITHM, NULL, BCRYPT_ALG_HANDLE_HMAC_FLAG);
+ if (!BCRYPT_SUCCESS(status)) {
+ _zip_crypto_hmac_free(hmac);
+ return NULL;
+ }
+
+ status = BCryptGetProperty(hmac->hAlgorithm, BCRYPT_OBJECT_LENGTH, (PUCHAR)&hmac->cbHashObject, sizeof(hmac->cbHashObject), &cbResult, 0);
+ if (!BCRYPT_SUCCESS(status)) {
+ _zip_crypto_hmac_free(hmac);
+ return NULL;
+ }
+
+ hmac->pbHashObject = malloc(hmac->cbHashObject);
+
+ status = BCryptGetProperty(hmac->hAlgorithm, BCRYPT_HASH_LENGTH, (PUCHAR)&hmac->cbHash, sizeof(hmac->cbHash), &cbResult, 0);
+ if (!BCRYPT_SUCCESS(status)) {
+ _zip_crypto_hmac_free(hmac);
+ return NULL;
+ }
+
+ hmac->pbHash = malloc(hmac->cbHash);
+
+ status = BCryptCreateHash(hmac->hAlgorithm, &hmac->hHash, hmac->pbHashObject, hmac->cbHashObject, (PUCHAR)secret, (ULONG)secret_length, 0);
+ if (!BCRYPT_SUCCESS(status)) {
+ _zip_crypto_hmac_free(hmac);
+ return NULL;
+ }
+
+ return hmac;
+}
+
+void
+_zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac) {
+ if (hmac == NULL) {
+ return;
+ }
+
+ if (hmac->hHash != NULL) {
+ BCryptDestroyHash(hmac->hHash);
+ }
+
+ if (hmac->pbHash != NULL) {
+ free(hmac->pbHash);
+ }
+
+ if (hmac->pbHashObject != NULL) {
+ free(hmac->pbHashObject);
+ }
+
+ if (hmac->hAlgorithm) {
+ BCryptCloseAlgorithmProvider(hmac->hAlgorithm, 0);
+ }
+
+ free(hmac);
+}
+
+bool
+_zip_crypto_hmac(_zip_crypto_hmac_t *hmac, zip_uint8_t *data, zip_uint64_t length) {
+ if (hmac == NULL || length > ULONG_MAX) {
+ return false;
+ }
+
+ return BCRYPT_SUCCESS(BCryptHashData(hmac->hHash, data, (ULONG)length, 0));
+}
+
+bool
+_zip_crypto_hmac_output(_zip_crypto_hmac_t *hmac, zip_uint8_t *data) {
+ if (hmac == NULL) {
+ return false;
+ }
+
+ return BCRYPT_SUCCESS(BCryptFinishHash(hmac->hHash, data, hmac->cbHash, 0));
+}
+
+ZIP_EXTERN bool
+zip_random(zip_uint8_t *buffer, zip_uint16_t length) {
+ return BCRYPT_SUCCESS(BCryptGenRandom(NULL, buffer, length, BCRYPT_USE_SYSTEM_PREFERRED_RNG));
+}
--- /dev/null
+/*
+ zip_crypto_win.h -- Windows Crypto API wrapper.
+ Copyright (C) 2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef HAD_ZIP_CRYPTO_WIN_H
+#define HAD_ZIP_CRYPTO_WIN_H
+
+typedef struct _zip_crypto_aes_s _zip_crypto_aes_t;
+typedef struct _zip_crypto_hmac_s _zip_crypto_hmac_t;
+
+void _zip_crypto_aes_free(_zip_crypto_aes_t *aes);
+_zip_crypto_aes_t *_zip_crypto_aes_new(const zip_uint8_t *key, zip_uint16_t key_size, zip_error_t *error);
+bool _zip_crypto_aes_encrypt_block(_zip_crypto_aes_t *aes, const zip_uint8_t *in, zip_uint8_t *out);
+
+bool _zip_crypto_pbkdf2(const zip_uint8_t *key, zip_uint64_t key_length, const zip_uint8_t *salt, zip_uint16_t salt_length, zip_uint16_t iterations, zip_uint8_t *output, zip_uint16_t output_length);
+
+_zip_crypto_hmac_t *_zip_crypto_hmac_new(const zip_uint8_t *secret, zip_uint64_t secret_length, zip_error_t *error);
+void _zip_crypto_hmac_free(_zip_crypto_hmac_t *hmac);
+bool _zip_crypto_hmac(_zip_crypto_hmac_t *hmac, zip_uint8_t *data, zip_uint64_t length);
+bool _zip_crypto_hmac_output(_zip_crypto_hmac_t *hmac, zip_uint8_t *data);
+
+#endif /* HAD_ZIP_CRYPTO_WIN_H */
/*
zip_delete.c -- delete file from zip archive
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_dir_add.c -- add directory
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_dirent.c -- read directory entry (local or central), clean dirent
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2019 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
struct tm *tm;
tm = localtime(&intime);
+ if (tm == NULL) {
+ /* if localtime() fails, return an arbitrary date (1980-01-01 00:00:00) */
+ *ddate = (1 << 5) + 1;
+ *dtime = 0;
+ return;
+ }
if (tm->tm_year < 80) {
tm->tm_year = 80;
}
/*
zip_discard.c -- discard and free struct zip
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_entry.c -- struct zip_entry helper functions
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_error.c -- zip_error_t helper functions
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_error_clear.c -- clear zip error
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_error_get.c -- get zip error
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_error_get_sys_type.c -- return type of system error code
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_error_sterror.c -- get string representation of struct zip_error
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_error_to_str.c -- get string representation of zip error code
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_extra_field.c -- manipulate extra fields
- Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_extra_field_api.c -- public extra fields API functions
- Copyright (C) 2012-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fclose.c -- close file in zip archive
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fdopen.c -- open read-only archive from file descriptor
- Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
zip_error_init(&error);
if ((src = zip_source_filep_create(fp, 0, -1, &error)) == NULL) {
+ fclose(fp);
_zip_set_open_error(zep, &error, 0);
zip_error_fini(&error);
return NULL;
}
if ((za = zip_open_from_source(src, _flags, &error)) == NULL) {
+ zip_source_free(src);
_zip_set_open_error(zep, &error, 0);
zip_error_fini(&error);
return NULL;
/*
zip_file_add.c -- add file via callback function
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_error_clear.c -- clear zip file error
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_error_get.c -- get zip file error
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_get_comment.c -- get file comment
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_get_external_attributes.c -- get opsys/external attributes
- Copyright (C) 2013-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2013-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_get_offset.c -- get offset of file data in archive.
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_rename.c -- rename file in zip archive
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_replace.c -- replace file via callback function
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_set_comment.c -- set comment for file in archive
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_set_encryption.c -- set encryption for file in archive
- Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2016-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_set_external_attributes.c -- set external attributes for entry
- Copyright (C) 2013-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2013-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_set_mtime.c -- set modification time of entry.
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_file_sterror.c -- get string representation of zip file error
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_filerange_crc.c -- compute CRC32 for a range of a file
- Copyright (C) 2008-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2008-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
int
_zip_filerange_crc(zip_source_t *src, zip_uint64_t start, zip_uint64_t len, uLong *crcp, zip_error_t *error) {
- Bytef buf[BUFSIZE];
+ DEFINE_BYTE_ARRAY(buf, BUFSIZE);
+
zip_int64_t n;
*crcp = crc32(0L, Z_NULL, 0);
return -1;
}
+ if (!byte_array_init(buf, BUFSIZE)) {
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return -1;
+ }
+
while (len > 0) {
n = (zip_int64_t)(len > BUFSIZE ? BUFSIZE : len);
if ((n = zip_source_read(src, buf, (zip_uint64_t)n)) < 0) {
_zip_error_set_from_source(error, src);
+ byte_array_fini(buf);
return -1;
}
if (n == 0) {
zip_error_set(error, ZIP_ER_EOF, 0);
+ byte_array_fini(buf);
return -1;
}
len -= (zip_uint64_t)n;
}
+ byte_array_fini(buf);
+
return 0;
}
/*
zip_fopen.c -- open file in zip archive for reading
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fopen_encrypted.c -- open file for reading with password
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fopen_index.c -- open file in zip archive for reading by index
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fopen_index_encrypted.c -- open file for reading by index w/ password
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fread.c -- read from file
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_fseek.c -- seek in file
- Copyright (C) 2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2016-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_ftell.c -- tell position in file
- Copyright (C) 2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2016-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_archive_comment.c -- get archive comment
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_archive_flag.c -- get archive global flag
- Copyright (C) 2008-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2008-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_encryption_implementation.c -- get encryption implementation
- Copyright (C) 2009-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_file_comment.c -- get file comment
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_name.c -- get filename for a file in zip file
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_num_entries.c -- get number of entries in archive
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_num_files.c -- get number of files in archive
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_hash.c -- hash table string -> uint64
- Copyright (C) 2015-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_io_util.c -- I/O helper functions
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_libzip_version.c -- return run-time version of library
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_memdup.c -- internal zip function, "strdup" with len
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_name_locate.c -- get index by name
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_new.c -- create and init struct zip
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_open.c -- open zip archive by name
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/* treat empty files as empty archives */
if (len == 0) {
if ((za = _zip_allocate_new(src, flags, error)) == NULL) {
- zip_source_free(src);
return NULL;
}
/*
zip_progress.c -- progress reporting
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_random_unix.c -- fill the user's buffer with random stuff (Unix version)
- Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2016-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_random_uwp.c -- fill the user's buffer with random stuff (UWP version)
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_random_win32.c -- fill the user's buffer with random stuff (Windows version)
- Copyright (C) 2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2016-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_rename.c -- rename file in zip archive
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_replace.c -- replace file via callback function
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_set_archive_comment.c -- set archive comment
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_get_archive_flag.c -- set archive global flag
- Copyright (C) 2008-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2008-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_set_default_password.c -- set default password for decryption
- Copyright (C) 2009-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_set_file_comment.c -- set comment for file in archive
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_set_file_compression.c -- set compression for file in archive
- Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_set_name.c -- rename helper function
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_begin_write.c -- start a new file for writing
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_begin_write_cloning.c -- clone part of file for writing
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_buffer.c -- create zip data source from buffer
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
}
if ((fragments = realloc(buffer->fragments, sizeof(buffer->fragments[0]) * capacity)) == NULL) {
- zip_error_set(error, ZIP_ER_MEMORY, 0);
- return false;
+ zip_error_set(error, ZIP_ER_MEMORY, 0);
+ return false;
}
buffer->fragments = fragments;
if ((offsets = realloc(buffer->fragment_offsets, sizeof(buffer->fragment_offsets[0]) * (capacity + 1))) == NULL) {
/*
zip_source_call.c -- invoke callback command on zip_source
- Copyright (C) 2009-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_close.c -- close zip_source (stop reading)
- Copyright (C) 2009-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_commit_write.c -- commit changes to file
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_compress.c -- (de)compression routines
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_crc.c -- pass-through source that calculates CRC32 and size
- Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
st->comp_method = ZIP_CM_STORE;
st->encryption_method = ZIP_EM_NONE;
st->valid |= ZIP_STAT_SIZE | ZIP_STAT_CRC | ZIP_STAT_COMP_SIZE | ZIP_STAT_COMP_METHOD | ZIP_STAT_ENCRYPTION_METHOD;
- ;
}
return 0;
}
/*
zip_source_error.c -- get last error from zip_source
- Copyright (C) 2009-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_file.c -- create data source from file
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_filep.c -- create data source from FILE *
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2019 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
+#include <sys/types.h>
#include <sys/stat.h>
#include "zipint.h"
#endif
case ZIP_SOURCE_COMMIT_WRITE: {
- mode_t mask;
+ mode_t mode;
+ struct stat st;
if (fclose(ctx->fout) < 0) {
ctx->fout = NULL;
zip_error_set(&ctx->error, ZIP_ER_WRITE, errno);
}
ctx->fout = NULL;
+ if (stat(ctx->fname, &st) == 0) {
+ mode = st.st_mode;
+ } else {
+ mode_t mask = umask(022);
+ umask(mask);
+ mode = 0666 & ~mask;
+ }
if (rename(ctx->tmpname, ctx->fname) < 0) {
zip_error_set(&ctx->error, ZIP_ER_RENAME, errno);
return -1;
}
- mask = umask(022);
- umask(mask);
/* not much we can do if chmod fails except make the whole commit fail */
- (void)chmod(ctx->fname, 0666 & ~mask);
+ (void)chmod(ctx->fname, mode);
free(ctx->tmpname);
ctx->tmpname = NULL;
return 0;
/*
zip_source_free.c -- free zip data source
- Copyright (C) 1999-2015 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_function.c -- create zip data source from callback function
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_get_compression_flags.c -- get compression flags for entry
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_is_deleted.c -- was archive was removed?
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_layered.c -- create layered source
- Copyright (C) 2009-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_open.c -- open zip_source (prepare for reading)
- Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_pkware.c -- Traditional PKWARE de/encryption routines
- Copyright (C) 2009-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_read.c -- read data from zip_source
- Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
}
if (len == 0) {
- return 0;
+ return 0;
}
bytes_read = 0;
/*
zip_source_remove.c -- remove empty archive
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_rollback_write.c -- discard changes
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_seek.c -- seek to offset
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
args.offset = offset;
args.whence = whence;
- return (_zip_source_call(src, &args, sizeof(args), ZIP_SOURCE_SEEK) < 0 ? -1 : 0);
+ if (_zip_source_call(src, &args, sizeof(args), ZIP_SOURCE_SEEK) < 0) {
+ return -1;
+ }
+
+ src->eof = 0;
+ return 0;
}
/*
zip_source_seek_write.c -- seek to offset for writing
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_stat.c -- get meta information from zip_source
- Copyright (C) 2009-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_supports.c -- check for supported functions
- Copyright (C) 2014-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_tell.c -- report current offset
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_tell_write.c -- report current offset for writing
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_win32a.c -- create data source from Windows file (ANSI)
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_win32file.c -- create data source from HANDLE (Win32)
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_win32utf8.c -- create data source from Windows file (UTF-8)
- Copyright (C) 1999-2015 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_win32w.c -- create data source from Windows file (UTF-16)
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_window.c -- return part of lower source
- Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
struct window *ctx;
zip_int64_t ret;
zip_uint64_t n, i;
- char b[8192];
ctx = (struct window *)_ctx;
}
if (!ctx->needs_seek) {
+ DEFINE_BYTE_ARRAY(b, BUFSIZE);
+
+ if (!byte_array_init(b, BUFSIZE)) {
+ zip_error_set(&ctx->error, ZIP_ER_MEMORY, 0);
+ return -1;
+ }
+
for (n = 0; n < ctx->start; n += (zip_uint64_t)ret) {
- i = (ctx->start - n > sizeof(b) ? sizeof(b) : ctx->start - n);
+ i = (ctx->start - n > BUFSIZE ? BUFSIZE : ctx->start - n);
if ((ret = zip_source_read(src, b, i)) < 0) {
_zip_error_set_from_source(&ctx->error, src);
+ byte_array_fini(b);
return -1;
}
if (ret == 0) {
zip_error_set(&ctx->error, ZIP_ER_EOF, 0);
+ byte_array_fini(b);
return -1;
}
}
+
+ byte_array_fini(b);
}
+
ctx->offset = ctx->start;
return 0;
/*
zip_source_winzip_aes_decode.c -- Winzip AES decryption routines
- Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
}
if (!_zip_winzip_aes_finish(ctx->aes_ctx, computed)) {
- zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
- return false;
+ zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
+ return false;
}
_zip_winzip_aes_free(ctx->aes_ctx);
ctx->aes_ctx = NULL;
}
ctx->current_position += (zip_uint64_t)n;
- if (!_zip_winzip_aes_decrypt(ctx->aes_ctx, (zip_uint8_t *)data, (zip_uint64_t)n)) {
- zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
- return -1;
- }
+ if (!_zip_winzip_aes_decrypt(ctx->aes_ctx, (zip_uint8_t *)data, (zip_uint64_t)n)) {
+ zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
+ return -1;
+ }
return n;
/*
zip_source_winzip_aes_encode.c -- Winzip AES encryption routines
- Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2009-2019 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
return -1;
}
- if (!_zip_winzip_aes_encrypt(ctx->aes_ctx, data, (zip_uint64_t)ret)) {
- zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
- /* TODO: return partial read? */
- return -1;
- }
+ if (!_zip_winzip_aes_encrypt(ctx->aes_ctx, data, (zip_uint64_t)ret)) {
+ zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
+ /* TODO: return partial read? */
+ return -1;
+ }
if ((zip_uint64_t)ret < length) {
ctx->eof = true;
- if (!_zip_winzip_aes_finish(ctx->aes_ctx, ctx->data)) {
- zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
- /* TODO: return partial read? */
- return -1;
- }
+ if (!_zip_winzip_aes_finish(ctx->aes_ctx, ctx->data)) {
+ zip_error_set(&ctx->error, ZIP_ER_INTERNAL, 0);
+ /* TODO: return partial read? */
+ return -1;
+ }
_zip_winzip_aes_free(ctx->aes_ctx);
ctx->aes_ctx = NULL;
if ((ctx->buffer = _zip_buffer_new(ctx->data, HMAC_LENGTH)) == NULL) {
/* TODO: return partial read? */
return -1;
}
+ buffer_n += _zip_buffer_read(ctx->buffer, data + ret, length - (zip_uint64_t)ret);
}
return (zip_int64_t)(buffer_n + (zip_uint64_t)ret);
/*
zip_source_write.c -- start a new file for writing
- Copyright (C) 2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_zip.c -- create data source from zip file
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_source_zip_new.c -- prepare data structures for zip_fopen/zip_source_zip
- Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_stat.c -- get information about file by name
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_stat_index.c -- get information about file by index
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_stat_init.c -- initialize struct zip_stat.
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_sterror.c -- get string representation of zip error
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_string.c -- string handling (with encoding)
- Copyright (C) 2012-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_unchange.c -- undo changes to file in zip archive
- Copyright (C) 1999-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_unchange.c -- undo changes to all files in zip archive
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_unchange_archive.c -- undo global changes to ZIP archive
- Copyright (C) 2006-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_unchange_data.c -- undo helper function
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zip_utf-8.c -- UTF-8 support functions for libzip
- Copyright (C) 2011-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 2011-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
static const zip_uint16_t _cp437_to_unicode[256] = {
/* 0x00 - 0x0F */
- 0x2007, 0x263A, 0x263B, 0x2665, 0x2666, 0x2663, 0x2660, 0x2022, 0x25D8, 0x25CB, 0x25D9, 0x2642, 0x2640, 0x266A, 0x266B, 0x263C,
+ 0x0000, 0x263A, 0x263B, 0x2665, 0x2666, 0x2663, 0x2660, 0x2022, 0x25D8, 0x25CB, 0x25D9, 0x2642, 0x2640, 0x266A, 0x266B, 0x263C,
/* 0x10 - 0x1F */
0x25BA, 0x25C4, 0x2195, 0x203C, 0x00B6, 0x00A7, 0x25AC, 0x21A8, 0x2191, 0x2193, 0x2192, 0x2190, 0x221F, 0x2194, 0x25B2, 0x25BC,
/*
zip_winzip_aes.c -- Winzip AES de/encryption backend routines
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
#include <string.h>
-
#define MAX_KEY_LENGTH 256
#define PBKDF2_ITERATIONS 1000
};
static bool
-aes_crypt(zip_winzip_aes_t *ctx, zip_uint8_t *data, zip_uint64_t length)
-{
+aes_crypt(zip_winzip_aes_t *ctx, zip_uint8_t *data, zip_uint64_t length) {
zip_uint64_t i, j;
- for (i=0; i < length; i++) {
+ for (i = 0; i < length; i++) {
if (ctx->pad_offset == AES_BLOCK_SIZE) {
for (j = 0; j < 8; j++) {
ctx->counter[j]++;
break;
}
}
- if (!_zip_crypto_aes_encrypt_block(ctx->aes, ctx->counter, ctx->pad)) {
- return false;
- }
+ if (!_zip_crypto_aes_encrypt_block(ctx->aes, ctx->counter, ctx->pad)) {
+ return false;
+ }
ctx->pad_offset = 0;
}
data[i] ^= ctx->pad[ctx->pad_offset++];
zip_winzip_aes_t *
-_zip_winzip_aes_new(const zip_uint8_t *password, zip_uint64_t password_length, const zip_uint8_t *salt, zip_uint16_t encryption_method, zip_uint8_t *password_verify, zip_error_t *error)
-{
+_zip_winzip_aes_new(const zip_uint8_t *password, zip_uint64_t password_length, const zip_uint8_t *salt, zip_uint16_t encryption_method, zip_uint8_t *password_verify, zip_error_t *error) {
zip_winzip_aes_t *ctx;
zip_uint8_t buffer[2 * (MAX_KEY_LENGTH / 8) + WINZIP_AES_PASSWORD_VERIFY_LENGTH];
zip_uint16_t key_size = 0; /* in bits */
- zip_uint16_t key_length; /* in bytes */
+ zip_uint16_t key_length; /* in bytes */
switch (encryption_method) {
case ZIP_EM_AES_128:
memset(ctx->counter, 0, sizeof(ctx->counter));
ctx->pad_offset = ZIP_CRYPTO_AES_BLOCK_LENGTH;
-
+
if (!_zip_crypto_pbkdf2(password, password_length, salt, key_length / 2, PBKDF2_ITERATIONS, buffer, 2 * key_length + WINZIP_AES_PASSWORD_VERIFY_LENGTH)) {
- free(ctx);
- return NULL;
+ free(ctx);
+ return NULL;
}
if ((ctx->aes = _zip_crypto_aes_new(buffer, key_size, error)) == NULL) {
- _zip_crypto_clear(ctx, sizeof(*ctx));
- free(ctx);
- return NULL;
+ _zip_crypto_clear(ctx, sizeof(*ctx));
+ free(ctx);
+ return NULL;
}
if ((ctx->hmac = _zip_crypto_hmac_new(buffer + key_length, key_length, error)) == NULL) {
- _zip_crypto_aes_free(ctx->aes);
- free(ctx);
- return NULL;
+ _zip_crypto_aes_free(ctx->aes);
+ free(ctx);
+ return NULL;
}
if (password_verify) {
bool
-_zip_winzip_aes_encrypt(zip_winzip_aes_t *ctx, zip_uint8_t *data, zip_uint64_t length)
-{
+_zip_winzip_aes_encrypt(zip_winzip_aes_t *ctx, zip_uint8_t *data, zip_uint64_t length) {
return aes_crypt(ctx, data, length) && _zip_crypto_hmac(ctx->hmac, data, length);
}
bool
-_zip_winzip_aes_decrypt(zip_winzip_aes_t *ctx, zip_uint8_t *data, zip_uint64_t length)
-{
+_zip_winzip_aes_decrypt(zip_winzip_aes_t *ctx, zip_uint8_t *data, zip_uint64_t length) {
return _zip_crypto_hmac(ctx->hmac, data, length) && aes_crypt(ctx, data, length);
}
bool
-_zip_winzip_aes_finish(zip_winzip_aes_t *ctx, zip_uint8_t *hmac)
-{
+_zip_winzip_aes_finish(zip_winzip_aes_t *ctx, zip_uint8_t *hmac) {
return _zip_crypto_hmac_output(ctx->hmac, hmac);
}
void
-_zip_winzip_aes_free(zip_winzip_aes_t *ctx)
-{
+_zip_winzip_aes_free(zip_winzip_aes_t *ctx) {
if (ctx == NULL) {
return;
}
/*
zipint.h -- internal declarations.
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
#include "compat.h"
+#ifdef ZIP_ALLOCATE_BUFFER
+#include <stdlib.h>
+#endif
+
#include <zlib.h>
#ifndef _ZIP_COMPILING_DEPRECATED
};
+/* byte array */
+
+/* For performance, we usually keep 8k byte arrays on the stack.
+ However, there are (embedded) systems with a stack size of 12k;
+ for those, use malloc()/free() */
+
+#ifdef ZIP_ALLOCATE_BUFFER
+#define DEFINE_BYTE_ARRAY(buf, size) zip_uint8_t *buf
+#define byte_array_init(buf, size) (((buf) = (zip_uint8_t *)malloc(size)) != NULL)
+#define byte_array_fini(buf) (free(buf))
+#else
+#define DEFINE_BYTE_ARRAY(buf, size) zip_uint8_t buf[size]
+#define byte_array_init(buf, size) (1)
+#define byte_array_fini(buf) ((void)0)
+#endif
+
+
/* bounds checked access to memory buffer */
struct zip_buffer {
/*
zipwin32.h -- internal declarations for Windows.
- Copyright (C) 1999-2015 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ ZIP_SOURCE_GET_ARGS -- validate and cast arguments to source callback
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_GET_ARGS(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">ZIP_SOURCE_GET_ARGS</b> — <span class="Nd">validate and cast
- arguments to source callback</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">ZIP_SOURCE_GET_ARGS</code> —
+<div class="Nd">validate and cast arguments to source callback</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">type *</var>
-<br/>
-<b class="Fn">ZIP_SOURCE_GET_ARGS</b>(<var class="Fa" style="white-space: nowrap;">type</var>,
- <var class="Fa" style="white-space: nowrap;">void *data</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint64_t len</var>,
- <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">ZIP_SOURCE_GET_ARGS</b>() macro casts
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">type *</var>
+ <br/>
+ <code class="Fn">ZIP_SOURCE_GET_ARGS</code>(<var class="Fa" style="white-space: nowrap;">type</var>,
+ <var class="Fa" style="white-space: nowrap;">void *data</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint64_t len</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">ZIP_SOURCE_GET_ARGS</code>() macro casts
<var class="Ar">data</var> to a pointer to <var class="Ar">type</var>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-On success, <b class="Fn">ZIP_SOURCE_GET_ARGS</b>() returns
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+On success, <code class="Fn">ZIP_SOURCE_GET_ARGS</code>() returns
<var class="Ar">data</var>. In case of error, it returns
<code class="Dv">NULL</code> and sets <var class="Ar">error</var>.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">ZIP_SOURCE_GET_ARGS</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">len</var> is less than the size of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">ZIP_SOURCE_GET_ARGS</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">len</var> is less than the size of
<var class="Ar">type</var></dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source_function.html">zip_source_function(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">ZIP_SOURCE_GET_ARGS</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">ZIP_SOURCE_GET_ARGS</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" ZIP_SOURCE_GET_ARGS -- validate and cast arguments to source callback
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_GET_ARGS" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ libzip.mdoc -- general overview of available functions
+ Copyright (C) 2005-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>LIBZIP(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">libzip</b> — <span class="Nd">library for manipulating zip
- archives</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">libzip</code> —
+<div class="Nd">library for manipulating zip archives</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Nm">libzip</b> is a library for reading, creating, and modifying zip
- archives.
-<div class="Pp"></div>
-The main design criteria for <b class="Nm">libzip</b> were:
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;">Do not create corrupt files,
- even in case of errors.</li>
- <li class="It-bullet" style="margin-top: 0.00em;">Do not delete data.</li>
- <li class="It-bullet" style="margin-top: 0.00em;">Be efficient.</li>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Nm">libzip</code> is a library for reading, creating, and modifying
+ zip archives.
+<p class="Pp">The main design criteria for <code class="Nm">libzip</code>
+ were:</p>
+<ul class="Bl-bullet Bl-compact">
+ <li>Do not create corrupt files, even in case of errors.</li>
+ <li>Do not delete data.</li>
+ <li>Be efficient.</li>
</ul>
-<div class="Pp"></div>
-For this reason, when modifying zip archives, <b class="Nm">libzip</b> writes to
- a temporary file and replaces the original zip archive atomically.
-<div class="Pp"></div>
-Below there are two sections listing functions: one for how to read from zip
- archives and one for how to create/modify them.
-<h1 class="Sh" id="READING_ZIP_ARCHIVES">READING ZIP ARCHIVES</h1>
-<h2 class="Ss" id="open_archive">open archive</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_open.html">zip_open(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fdopen.html">zip_fdopen(3)</a></li>
+<p class="Pp">For this reason, when modifying zip archives,
+ <code class="Nm">libzip</code> writes to a temporary file and replaces the
+ original zip archive atomically.</p>
+<p class="Pp">Below there are two sections listing functions: one for how to
+ read from zip archives and one for how to create/modify them.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="READING_ZIP_ARCHIVES"><a class="permalink" href="#READING_ZIP_ARCHIVES">READING
+ ZIP ARCHIVES</a></h1>
+<section class="Ss">
+<h2 class="Ss" id="open_archive"><a class="permalink" href="#open_archive">open
+ archive</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_open.html">zip_open(3)</a></li>
+ <li><a class="Xr" href="zip_fdopen.html">zip_fdopen(3)</a></li>
</ul>
-<h2 class="Ss" id="find_files">find files</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="find_files"><a class="permalink" href="#find_files">find
+ files</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a></li>
</ul>
-<h2 class="Ss" id="read_files">read files</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fopen.html">zip_fopen(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fopen_index_encrypted.html">zip_fopen_index_encrypted(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fread.html">zip_fread(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fseek.html">zip_fseek(3)</a>
- (uncompressed files only)</li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_ftell.html">zip_ftell(3)</a>
- (uncompressed files only)</li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_fclose.html">zip_fclose(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="read_files"><a class="permalink" href="#read_files">read
+ files</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_fopen.html">zip_fopen(3)</a></li>
+ <li><a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a></li>
+ <li><a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a></li>
+ <li><a class="Xr" href="zip_fopen_index_encrypted.html">zip_fopen_index_encrypted(3)</a></li>
+ <li><a class="Xr" href="zip_fread.html">zip_fread(3)</a></li>
+ <li><a class="Xr" href="zip_fseek.html">zip_fseek(3)</a> (uncompressed files
+ only)</li>
+ <li><a class="Xr" href="zip_ftell.html">zip_ftell(3)</a> (uncompressed files
+ only)</li>
+ <li><a class="Xr" href="zip_fclose.html">zip_fclose(3)</a></li>
</ul>
-<h2 class="Ss" id="close_archive">close archive</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_close.html">zip_close(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_discard.html">zip_discard(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="close_archive"><a class="permalink" href="#close_archive">close
+ archive</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_close.html">zip_close(3)</a></li>
</ul>
-<h2 class="Ss" id="miscellaneous">miscellaneous</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_stat.html">zip_stat(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_get_external_attributes.html">zip_file_get_external_attributes(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_get_archive_comment.html">zip_get_archive_comment(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_get_archive_flag.html">zip_get_archive_flag(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_get_name.html">zip_get_name(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_get_num_entries.html">zip_get_num_entries(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="miscellaneous"><a class="permalink" href="#miscellaneous">miscellaneous</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_stat.html">zip_stat(3)</a></li>
+ <li><a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a></li>
+ <li><a class="Xr" href="zip_file_get_external_attributes.html">zip_file_get_external_attributes(3)</a></li>
+ <li><a class="Xr" href="zip_get_archive_comment.html">zip_get_archive_comment(3)</a></li>
+ <li><a class="Xr" href="zip_get_archive_flag.html">zip_get_archive_flag(3)</a></li>
+ <li><a class="Xr" href="zip_get_name.html">zip_get_name(3)</a></li>
+ <li><a class="Xr" href="zip_get_num_entries.html">zip_get_num_entries(3)</a></li>
+ <li><a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a></li>
</ul>
-<h1 class="Sh" id="CREATING/MODIFYING_ZIP_ARCHIVES">CREATING/MODIFYING ZIP
- ARCHIVES</h1>
-<h2 class="Ss" id="create/open_archive">create/open archive</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_open.html">zip_open(3)</a></li>
+</section>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="CREATING/MODIFYING_ZIP_ARCHIVES"><a class="permalink" href="#CREATING/MODIFYING_ZIP_ARCHIVES">CREATING/MODIFYING
+ ZIP ARCHIVES</a></h1>
+<section class="Ss">
+<h2 class="Ss" id="create/open_archive"><a class="permalink" href="#create/open_archive">create/open
+ archive</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_open.html">zip_open(3)</a></li>
</ul>
-<h2 class="Ss" id="add/change_files_and_directories">add/change files and
- directories</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_dir_add.html">zip_dir_add(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_add.html">zip_file_add(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_set_external_attributes.html">zip_file_set_external_attributes(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_set_encryption.html">zip_file_set_encryption(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_set_mtime.html">zip_file_set_mtime(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_set_file_compression.html">zip_set_file_compression(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source_buffer.html">zip_source_buffer(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source_file.html">zip_source_file(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source_filep.html">zip_source_filep(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source_free.html">zip_source_free(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source_function.html">zip_source_function(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source_zip.html">zip_source_zip(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="add/change_files_and_directories"><a class="permalink" href="#add/change_files_and_directories">add/change
+ files and directories</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_dir_add.html">zip_dir_add(3)</a></li>
+ <li><a class="Xr" href="zip_file_add.html">zip_file_add(3)</a></li>
+ <li><a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a></li>
+ <li><a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a></li>
+ <li><a class="Xr" href="zip_file_set_external_attributes.html">zip_file_set_external_attributes(3)</a></li>
+ <li><a class="Xr" href="zip_file_set_encryption.html">zip_file_set_encryption(3)</a></li>
+ <li><a class="Xr" href="zip_file_set_mtime.html">zip_file_set_mtime(3)</a></li>
+ <li><a class="Xr" href="zip_set_file_compression.html">zip_set_file_compression(3)</a></li>
+ <li><a class="Xr" href="zip_source_buffer.html">zip_source_buffer(3)</a></li>
+ <li><a class="Xr" href="zip_source_file.html">zip_source_file(3)</a></li>
+ <li><a class="Xr" href="zip_source_filep.html">zip_source_filep(3)</a></li>
+ <li><a class="Xr" href="zip_source_free.html">zip_source_free(3)</a></li>
+ <li><a class="Xr" href="zip_source_function.html">zip_source_function(3)</a></li>
+ <li><a class="Xr" href="zip_source_zip.html">zip_source_zip(3)</a></li>
</ul>
-<h2 class="Ss" id="rename_files">rename files</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_rename.html">zip_rename(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="rename_files"><a class="permalink" href="#rename_files">rename
+ files</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_rename.html">zip_rename(3)</a></li>
</ul>
-<h2 class="Ss" id="delete_files">delete files</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_delete.html">zip_delete(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="delete_files"><a class="permalink" href="#delete_files">delete
+ files</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_delete.html">zip_delete(3)</a></li>
</ul>
-<h2 class="Ss" id="revert_changes">revert changes</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_unchange.html">zip_unchange(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_unchange_all.html">zip_unchange_all(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_unchange_archive.html">zip_unchange_archive(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="revert_changes"><a class="permalink" href="#revert_changes">revert
+ changes</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_unchange.html">zip_unchange(3)</a></li>
+ <li><a class="Xr" href="zip_unchange_all.html">zip_unchange_all(3)</a></li>
+ <li><a class="Xr" href="zip_unchange_archive.html">zip_unchange_archive(3)</a></li>
</ul>
-<h2 class="Ss" id="read/modify_extra_fields">read/modify extra fields</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_field_by_id.html">zip_file_extra_field_by_id(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_field_delete.html">zip_file_extra_field_delete(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_field_delete_by_id.html">zip_file_extra_field_delete_by_id(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_field_get.html">zip_file_extra_field_get(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_field_set.html">zip_file_extra_field_set(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_fields_count.html">zip_file_extra_fields_count(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_extra_fields_count_by_id.html">zip_file_extra_fields_count_by_id(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="read/modify_extra_fields"><a class="permalink" href="#read/modify_extra_fields">read/modify
+ extra fields</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_file_extra_field_by_id.html">zip_file_extra_field_by_id(3)</a></li>
+ <li><a class="Xr" href="zip_file_extra_field_delete.html">zip_file_extra_field_delete(3)</a></li>
+ <li><a class="Xr" href="zip_file_extra_field_delete_by_id.html">zip_file_extra_field_delete_by_id(3)</a></li>
+ <li><a class="Xr" href="zip_file_extra_field_get.html">zip_file_extra_field_get(3)</a></li>
+ <li><a class="Xr" href="zip_file_extra_field_set.html">zip_file_extra_field_set(3)</a></li>
+ <li><a class="Xr" href="zip_file_extra_fields_count.html">zip_file_extra_fields_count(3)</a></li>
+ <li><a class="Xr" href="zip_file_extra_fields_count_by_id.html">zip_file_extra_fields_count_by_id(3)</a></li>
</ul>
-<h2 class="Ss" id="close_archive">close archive</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_close.html">zip_close(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="close_archive_(writing)"><a class="permalink" href="#close_archive_(writing)">close
+ archive (writing)</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_close.html">zip_close(3)</a></li>
+ <li><a class="Xr" href="zip_discard.html">zip_discard(3)</a></li>
</ul>
-<h2 class="Ss" id="miscellaneous">miscellaneous</h2>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_libzip_version.html">zip_libzip_version(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_register_progress_callback_with_state.html">zip_register_progress_callback_with_state(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_set_archive_comment.html">zip_set_archive_comment(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_set_archive_flag.html">zip_set_archive_flag(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_source.html">zip_source(3)</a></li>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="miscellaneous_(writing)"><a class="permalink" href="#miscellaneous_(writing)">miscellaneous
+ (writing)</a></h2>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_libzip_version.html">zip_libzip_version(3)</a></li>
+ <li><a class="Xr" href="zip_register_progress_callback_with_state.html">zip_register_progress_callback_with_state(3)</a></li>
+ <li><a class="Xr" href="zip_set_archive_comment.html">zip_set_archive_comment(3)</a></li>
+ <li><a class="Xr" href="zip_set_archive_flag.html">zip_set_archive_flag(3)</a></li>
+ <li><a class="Xr" href="zip_source.html">zip_source(3)</a></li>
</ul>
-<h1 class="Sh" id="ERROR_HANDLING">ERROR HANDLING</h1>
-<ul class="Bl-bullet">
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_error_to_str.html">zip_error_to_str(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_strerror.html">zip_strerror(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_file_strerror.html">zip_file_strerror(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_error_get.html">zip_error_get(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_error_get_sys_type.html">zip_error_get_sys_type(3)</a></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><a class="Xr" href="zip_errors.html">zip_errors(3)</a></li>
+</section>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERROR_HANDLING"><a class="permalink" href="#ERROR_HANDLING">ERROR
+ HANDLING</a></h1>
+<ul class="Bl-bullet Bl-compact">
+ <li><a class="Xr" href="zip_error_strerror.html">zip_error_strerror(3)</a></li>
+ <li><a class="Xr" href="zip_strerror.html">zip_strerror(3)</a></li>
+ <li><a class="Xr" href="zip_file_strerror.html">zip_file_strerror(3)</a></li>
+ <li><a class="Xr" href="zip_get_error.html">zip_get_error(3)</a></li>
+ <li><a class="Xr" href="zip_error_init_with_code.html">zip_error_init_with_code(3)</a></li>
+ <li><a class="Xr" href="zip_error_system_type.html">zip_error_system_type(3)</a></li>
+ <li><a class="Xr" href="zip_errors.html">zip_errors(3)</a></li>
</ul>
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
- <td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-date">September 29, 2018</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
-.TH "LIBZIP" "3" "December 18, 2017" "NiH" "Library Functions Manual"
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" libzip.mdoc -- general overview of available functions
+.\" Copyright (C) 2005-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.TH "LIBZIP" "3" "September 29, 2018" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.SH "NAME"
.TP 4n
\fB\(bu\fR
zip_close(3)
-.PD 0
-.TP 4n
-\fB\(bu\fR
-zip_discard(3)
-.PD
.SS "miscellaneous"
.TP 4n
\fB\(bu\fR
\fB\(bu\fR
zip_file_extra_fields_count_by_id(3)
.PD
-.SS "close archive"
+.SS "close archive (writing)"
.TP 4n
\fB\(bu\fR
zip_close(3)
-.SS "miscellaneous"
+.PD 0
+.TP 4n
+\fB\(bu\fR
+zip_discard(3)
+.PD
+.SS "miscellaneous (writing)"
.TP 4n
\fB\(bu\fR
zip_libzip_version(3)
.SH "ERROR HANDLING"
.TP 4n
\fB\(bu\fR
-zip_error_to_str(3)
+zip_error_strerror(3)
.PD 0
.TP 4n
\fB\(bu\fR
zip_file_strerror(3)
.TP 4n
\fB\(bu\fR
-zip_error_get(3)
+zip_get_error(3)
+.TP 4n
+\fB\(bu\fR
+zip_error_init_with_code(3)
.TP 4n
\fB\(bu\fR
-zip_error_get_sys_type(3)
+zip_error_system_type(3)
.TP 4n
\fB\(bu\fR
zip_errors(3)
.\" libzip.mdoc -- general overview of available functions
-.\" Copyright (C) 2005-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2005-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd December 18, 2017
+.Dd September 29, 2018
.Dt LIBZIP 3
.Os
.Sh NAME
.Bl -bullet -compact
.It
.Xr zip_close 3
-.It
-.Xr zip_discard 3
.El
.Ss miscellaneous
.Bl -bullet -compact
.It
.Xr zip_file_extra_fields_count_by_id 3
.El
-.Ss close archive
+.Ss close archive (writing)
.Bl -bullet -compact
.It
.Xr zip_close 3
+.It
+.Xr zip_discard 3
.El
-.Ss miscellaneous
+.Ss miscellaneous (writing)
.Bl -bullet -compact
.It
.Xr zip_libzip_version 3
.Sh ERROR HANDLING
.Bl -bullet -compact
.It
-.Xr zip_error_to_str 3
+.Xr zip_error_strerror 3
.It
.Xr zip_strerror 3
.It
.Xr zip_file_strerror 3
.It
-.Xr zip_error_get 3
+.Xr zip_get_error 3
+.It
+.Xr zip_error_init_with_code 3
.It
-.Xr zip_error_get_sys_type 3
+.Xr zip_error_system_type 3
.It
.Xr zip_errors 3
.El
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_add.mdoc -- add files to zip archive
+ Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ADD(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_add</b>, <b class="Nm">zip_replace</b> —
- <span class="Nd">add file to zip archive or replace file in zip archive
- (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_add</code>, <code class="Nm">zip_replace</code> —
+<div class="Nd">add file to zip archive or replace file in zip archive (obsolete
+ interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_add</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *name</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_replace</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_add</b>() is the obsolete version of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_add</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *name</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_replace</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_add</code>() is the obsolete version of
<a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>. It is the same as
calling <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a> with an
empty <var class="Ar">flags</var> argument. Similarly, the
- <b class="Fn">zip_replace</b>() function is the obsolete version of
+ <code class="Fn">zip_replace</code>() function is the obsolete version of
<a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>. It is the
same as calling
<a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a> with an
empty <var class="Ar">flags</var> argument.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
<a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_add</b>() was added in libzip 0.6. In libzip 0.10 the return
- type was changed from <var class="Vt">int</var> to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_add</code>() was added in libzip 0.6. In libzip 0.10 the
+ return type was changed from <var class="Vt">int</var> to
<var class="Vt">zip_int64_t</var>. It was deprecated in libzip 0.11, use
- <b class="Fn">zip_file_add</b>() instead.
-<div class="Pp"></div>
-<b class="Fn">zip_replace</b>() was added in libzip 0.6. In libzip 0.10 the type
- of <var class="Ar">index</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_uint64_t</var>. It was deprecated in libzip 0.11, use
- <b class="Fn">zip_file_replace</b>() instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+ <code class="Fn">zip_file_add</code>() instead.
+<p class="Pp"><code class="Fn">zip_replace</code>() was added in libzip 0.6. In
+ libzip 0.10 the type of <var class="Ar">index</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_uint64_t</var>. It was
+ deprecated in libzip 0.11, use <code class="Fn">zip_file_replace</code>()
+ instead.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_add.mdoc -- add files to zip archive
+.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ADD" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_add_dir.mdoc -- add directory to zip archive
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ADD_DIR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_add_dir</b> — <span class="Nd">add directory to zip
- archive (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_add_dir</code> —
+<div class="Nd">add directory to zip archive (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_add_dir</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *name</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_add_dir</b>() is the obsolete version of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_add_dir</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *name</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_add_dir</code>() is the obsolete version of
<a class="Xr" href="zip_dir_add.html">zip_dir_add(3)</a>. It is the same as
calling <a class="Xr" href="zip_dir_add.html">zip_dir_add(3)</a> with an empty
flags argument.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_dir_add.html">zip_dir_add(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_add_dir</b>() was added in libzip 0.8. In libzip 0.10 the
- return type was changed from <var class="Vt">int</var> to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_add_dir</code>() was added in libzip 0.8. In libzip 0.10
+ the return type was changed from <var class="Vt">int</var> to
<var class="Vt">zip_int64_t</var>. It was deprecated in libzip 0.11, use
- <b class="Fn">zip_dir_add</b>() instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+ <code class="Fn">zip_dir_add</code>() instead.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_add_dir.mdoc -- add directory to zip archive
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ADD_DIR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_close.mdoc -- close zip archive
+ Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_CLOSE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_close</b> — <span class="Nd">close zip archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_close</code> —
+<div class="Nd">close zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_close</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_close</b>() function writes any changes made to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_close</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_close</code>() function writes any changes made to
<var class="Ar">archive</var> to disk. If <var class="Ar">archive</var>
contains no files, the file is completely removed (no empty archive is
written). If successful, <var class="Ar">archive</var> is freed. If writing
- fails, <b class="Fn">zip_close</b>() fails; <var class="Ar">archive</var> is
- left unchanged and must still be freed.
-<div class="Pp"></div>
-To close and free a zip archive without saving changes, use
- <a class="Xr" href="zip_discard.html">zip_discard(3)</a>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+ fails, <code class="Fn">zip_close</code>() fails;
+ <var class="Ar">archive</var> is left unchanged and must still be freed.
+<p class="Pp">To close and free a zip archive without saving changes, use
+ <a class="Xr" href="zip_discard.html">zip_discard(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_close</b>() will fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_EOF</code>]</dt>
- <dd class="It-tag">Unexpected end-of-file found while reading from a
- file.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INTERNAL</code>]</dt>
- <dd class="It-tag">The callback function of an added or replaced file returned
- an error but failed to report which.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">The <var class="Ar">path</var> argument is
- <code class="Dv">NULL</code>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOZIP</code>]</dt>
- <dd class="It-tag">File is not a zip archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_READ</code>]</dt>
- <dd class="It-tag">A file read failed.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RENAME</code>]</dt>
- <dd class="It-tag">A temporary file could not be renamed to its final
- name.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_SEEK</code>]</dt>
- <dd class="It-tag">A file seek failed.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_TMPOPEN</code>]</dt>
- <dd class="It-tag">A temporary file could not be created.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_WRITE</code>]</dt>
- <dd class="It-tag">A file write failed.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_ZLIB</code>]</dt>
- <dd class="It-tag">An error occurred while (de)compressing a stream with
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_close</code>() will fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_EOF"><code class="Er" id="ZIP_ER_EOF">ZIP_ER_EOF</code></a>]</dt>
+ <dd>Unexpected end-of-file found while reading from a file.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INTERNAL"><code class="Er" id="ZIP_ER_INTERNAL">ZIP_ER_INTERNAL</code></a>]</dt>
+ <dd>The callback function of an added or replaced file returned an error but
+ failed to report which.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd>The <var class="Ar">path</var> argument is
+ <code class="Dv">NULL</code>.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOZIP"><code class="Er" id="ZIP_ER_NOZIP">ZIP_ER_NOZIP</code></a>]</dt>
+ <dd>File is not a zip archive.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_READ"><code class="Er" id="ZIP_ER_READ">ZIP_ER_READ</code></a>]</dt>
+ <dd>A file read failed.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RENAME"><code class="Er" id="ZIP_ER_RENAME">ZIP_ER_RENAME</code></a>]</dt>
+ <dd>A temporary file could not be renamed to its final name.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_SEEK"><code class="Er" id="ZIP_ER_SEEK">ZIP_ER_SEEK</code></a>]</dt>
+ <dd>A file seek failed.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_TMPOPEN"><code class="Er" id="ZIP_ER_TMPOPEN">ZIP_ER_TMPOPEN</code></a>]</dt>
+ <dd>A temporary file could not be created.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_WRITE"><code class="Er" id="ZIP_ER_WRITE">ZIP_ER_WRITE</code></a>]</dt>
+ <dd>A file write failed.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_ZLIB"><code class="Er" id="ZIP_ER_ZLIB">ZIP_ER_ZLIB</code></a>]</dt>
+ <dd>An error occurred while (de)compressing a stream with
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/zlib.html">zlib(3)</a>.</dd>
</dl>
Additionally, any errors returned by the callback function for added or replaced
files will be passed back.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_discard.html">zip_discard(3)</a>,
- <a class="Xr" href="zip_error_get.html">zip_error_get(3)</a>,
<a class="Xr" href="zip_fdopen.html">zip_fdopen(3)</a>,
+ <a class="Xr" href="zip_get_error.html">zip_get_error(3)</a>,
<a class="Xr" href="zip_open.html">zip_open(3)</a>,
<a class="Xr" href="zip_register_progress_callback_with_state.html">zip_register_progress_callback_with_state(3)</a>,
<a class="Xr" href="zip_strerror.html">zip_strerror(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_close</b>() was added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_close</code>() was added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_close.mdoc -- close zip archive
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_CLOSE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.SH "SEE ALSO"
libzip(3),
zip_discard(3),
-zip_error_get(3),
zip_fdopen(3),
+zip_get_error(3),
zip_open(3),
zip_register_progress_callback_with_state(3),
zip_strerror(3)
.\" zip_close.mdoc -- close zip archive
-.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Sh SEE ALSO
.Xr libzip 3 ,
.Xr zip_discard 3 ,
-.Xr zip_error_get 3 ,
.Xr zip_fdopen 3 ,
+.Xr zip_get_error 3 ,
.Xr zip_open 3 ,
.Xr zip_register_progress_callback_with_state 3 ,
.Xr zip_strerror 3
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_delete.mdoc -- delete files from zip archive
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_DELETE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_delete</b> — <span class="Nd">delete file from zip
- archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_delete</code> —
+<div class="Nd">delete file from zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_delete</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_delete</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
The file at position <var class="Ar">index</var> in the zip archive
<var class="Ar">archive</var> is marked as deleted.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_delete</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_delete</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_unchange.html">zip_unchange(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_delete</b>() was added in libzip 0.6. In libzip 0.10 the type
- of <var class="Ar">index</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_uint64_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_delete</code>() was added in libzip 0.6. In libzip 0.10 the
+ type of <var class="Ar">index</var> was changed from <var class="Vt">int</var>
+ to <var class="Vt">zip_uint64_t</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_delete.mdoc -- delete files from zip archive
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_DELETE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_dir_add.mdoc -- add directory to zip archive
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_DIR_ADD(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_dir_add</b> — <span class="Nd">add directory to zip
- archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_dir_add</code> —
+<div class="Nd">add directory to zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_dir_add</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *name</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_dir_add</b>() adds a directory to a zip archive.
- The argument <var class="Ar">archive</var> specifies the zip archive to which
- the directory should be added. <var class="Ar">name</var> is the directory's
- name in the zip archive. The <var class="Ar">flags</var> argument can be any
- of:
-<dl class="Bl-tag" style="margin-left: 20.00ex;">
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">Guess encoding of <var class="Ar">name</var>
- (default).</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_UTF_8</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">name</var> as UTF-8.</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_CP437</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">name</var> as code page 437
- (CP-437).</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_dir_add</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *name</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_dir_add</code>() adds a directory to a zip
+ archive. The argument <var class="Ar">archive</var> specifies the zip archive
+ to which the directory should be added. <var class="Ar">name</var> is the
+ directory's name in the zip archive. The <var class="Ar">flags</var> argument
+ can be any of:
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>Guess encoding of <var class="Ar">name</var> (default).</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_UTF_8"><code class="Dv" id="ZIP_FL_ENC_UTF_8">ZIP_FL_ENC_UTF_8</code></a></dt>
+ <dd>Interpret <var class="Ar">name</var> as UTF-8.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_CP437"><code class="Dv" id="ZIP_FL_ENC_CP437">ZIP_FL_ENC_CP437</code></a></dt>
+ <dd>Interpret <var class="Ar">name</var> as code page 437 (CP-437).</dd>
</dl>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the index of the new entry in the archive is
returned. Otherwise, -1 is returned and the error code in
<var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_dir_add</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
- <dd class="It-tag">There is already an entry called <var class="Ar">name</var>
- in the archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">archive</var> or <var class="Ar">name</var>
- are <code class="Dv">NULL</code>, or invalid UTF-8 encoded file
- names.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_dir_add</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_EXISTS"><code class="Er" id="ZIP_ER_EXISTS">ZIP_ER_EXISTS</code></a>]</dt>
+ <dd>There is already an entry called <var class="Ar">name</var> in the
+ archive.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">archive</var> or <var class="Ar">name</var> are
+ <code class="Dv">NULL</code>, or invalid UTF-8 encoded file names.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_dir_add</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_dir_add</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
<<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
-<h1 class="Sh" id="CAVEATS">CAVEATS</h1>
-<b class="Fn">zip_dir_add</b>() does not look in the file system, it just
- creates one entry in the archive for the provided name.</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
+<code class="Fn">zip_dir_add</code>() does not look in the file system, it just
+ creates one entry in the archive for the provided name.
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_dir_add.mdoc -- add directory to zip archive
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_DIR_ADD" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
Required memory could not be allocated.
.SH "SEE ALSO"
libzip(3),
-zip_add(3)
+zip_file_add(3)
.SH "HISTORY"
\fBzip_dir_add\fR()
was added in libzip 0.11.
.\" zip_dir_add.mdoc -- add directory to zip archive
-.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3
+.Xr zip_file_add 3
.Sh HISTORY
.Fn zip_dir_add
was added in libzip 0.11.
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_discard.mdoc -- close zip archive and discard changes
+ Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_DISCARD(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_discard</b> — <span class="Nd">close zip archive and
- discard changes</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_discard</code> —
+<div class="Nd">close zip archive and discard changes</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_discard</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_discard</b>() function closes
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_discard</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_discard</code>() function closes
<var class="Ar">archive</var> and frees the memory allocated for it. Any
changes to the archive are not written to disk and discarded.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_close.html">zip_close(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_discard</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_discard</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_discard.mdoc -- close zip archive and discard changes
+.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_DISCARD" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_clear.mdoc -- clear error state for archive or file
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_CLEAR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_clear</b>, <b class="Nm">zip_file_error_clear</b>
- — <span class="Nd">clear error state for archive or file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_clear</code>,
+ <code class="Nm">zip_file_error_clear</code> —
+<div class="Nd">clear error state for archive or file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_error_clear</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_file_error_clear</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_clear</b>() function clears the error state for the
- zip archive <var class="Ar">archive</var>.
-<div class="Pp"></div>
-The <b class="Fn">zip_file_error_clear</b>() function does the same for the zip
- file <var class="Ar">file</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_error_clear</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_file_error_clear</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_clear</code>() function clears the error state
+ for the zip archive <var class="Ar">archive</var>.
+<p class="Pp">The <code class="Fn">zip_file_error_clear</code>() function does
+ the same for the zip file <var class="Ar">file</var>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_error_get.html">zip_error_get(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_clear</b>() and <b class="Fn">zip_file_error_clear</b>()
- were added in libzip 0.8.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+ <a class="Xr" href="zip_get_error.html">zip_get_error(3)</a>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_clear</code>() and
+ <code class="Fn">zip_file_error_clear</code>() were added in libzip 0.8.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_clear.mdoc -- clear error state for archive or file
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_CLEAR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
\fIfile\fR.
.SH "SEE ALSO"
libzip(3),
-zip_error_get(3)
+zip_get_error(3)
.SH "HISTORY"
\fBzip_error_clear\fR()
and
.\" zip_error_clear.mdoc -- clear error state for archive or file
-.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Ar file .
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_error_get 3
+.Xr zip_get_error 3
.Sh HISTORY
.Fn zip_error_clear
and
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_code_system.mdoc -- get system error part of zip_error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_CODE_SYSTEM(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_code_system</b> — <span class="Nd">get operating
- system error part of zip_error</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_code_system</code> —
+<div class="Nd">get operating system error part of zip_error</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_error_code_system</b>(<var class="Fa" style="white-space: nowrap;">const
- zip_error_t *ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_code_system</b>() function returns the system
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_error_code_system</code>(<var class="Fa" style="white-space: nowrap;">const
+ zip_error_t *ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_code_system</code>() function returns the system
specific part of the error from the zip_error error <var class="Ar">ze</var>.
For finding out what system reported the error, use
<a class="Xr" href="zip_error_system_type.html">zip_error_system_type(3)</a>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_code_zip.html">zip_error_code_zip(3)</a>,
<a class="Xr" href="zip_error_system_type.html">zip_error_system_type(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_code_system</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_code_system</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_code_system.mdoc -- get system error part of zip_error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_CODE_SYSTEM" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_code_zip.mdoc -- get libzip error part of zip_error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_CODE_ZIP(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_code_zip</b> — <span class="Nd">get libzip error
- part of zip_error</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_code_zip</code> —
+<div class="Nd">get libzip error part of zip_error</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_error_code_zip</b>(<var class="Fa" style="white-space: nowrap;">const
- zip_error_t *ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_code_zip</b>() function returns the libzip specific
- part of the error from the zip_error error <var class="Ar">ze</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_error_code_zip</code>(<var class="Fa" style="white-space: nowrap;">const
+ zip_error_t *ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_code_zip</code>() function returns the libzip
+ specific part of the error from the zip_error error <var class="Ar">ze</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_code_system.html">zip_error_code_system(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_code_zip</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_code_zip</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_code_zip.mdoc -- get libzip error part of zip_error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_CODE_ZIP" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_fini.mdoc -- clean up zip_error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_FINI(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_fini</b> — <span class="Nd">clean up zip_error
- structure</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_fini</code> —
+<div class="Nd">clean up zip_error structure</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_error_fini</b>(<var class="Fa" style="white-space: nowrap;">zip_error_t
- *ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_fini</b>() function cleans up and frees internally
- allocated memory of the zip_error pointed to by <var class="Ar">ze</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_error_fini</code>(<var class="Fa" style="white-space: nowrap;">zip_error_t
+ *ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_fini</code>() function cleans up and frees
+ internally allocated memory of the zip_error pointed to by
+ <var class="Ar">ze</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_init.html">zip_error_init(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_fini</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_fini</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_fini.mdoc -- clean up zip_error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_FINI" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_get.mdoc -- get error codes for archive or file
+ Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_GET(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_get</b>, <b class="Nm">zip_file_error_get</b> —
- <span class="Nd">get error codes for archive or file (obsolete
- interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_get</code>,
+ <code class="Nm">zip_file_error_get</code> —
+<div class="Nd">get error codes for archive or file (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_error_get</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">int *zep</var>,
- <var class="Fa" style="white-space: nowrap;">int *sep</var>);
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_file_error_get</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>, <var class="Fa" style="white-space: nowrap;">int *zep</var>,
- <var class="Fa" style="white-space: nowrap;">int *sep</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_error_get</b>() and
- <b class="Fn">zip_file_error_get</b>() are deprecated. Use
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_error_get</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">int *zep</var>,
+ <var class="Fa" style="white-space: nowrap;">int *sep</var>);</p>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_file_error_get</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>, <var class="Fa" style="white-space: nowrap;">int *zep</var>,
+ <var class="Fa" style="white-space: nowrap;">int *sep</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_error_get</code>() and
+ <code class="Fn">zip_file_error_get</code>() are deprecated. Use
<a class="Xr" href="zip_error_code_system.html">zip_error_code_system(3)</a>,
<a class="Xr" href="zip_error_code_zip.html">zip_error_code_zip(3)</a>,
<a class="Xr" href="zip_file_get_error.html">zip_file_get_error(3)</a>, and
<a class="Xr" href="zip_get_error.html">zip_get_error(3)</a> instead.
-<div class="Pp"></div>
-For <b class="Fn">zip_error_get</b>(), replace
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-int ze, se;
+<p class="Pp">For <code class="Fn">zip_error_get</code>(), replace</p>
+<div class="Bd Pp Bd-indent">
+<pre>
+int ze, se;
zip_error_get(za, &ze, &se);
</pre>
</div>
with
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-int ze, se;
-zip_error_t *error = zip_get_error(za);
-ze = zip_error_code_zip(error);
+<div class="Bd Pp Bd-indent">
+<pre>
+int ze, se;
+zip_error_t *error = zip_get_error(za);
+ze = zip_error_code_zip(error);
se = zip_error_code_system(error);
</pre>
</div>
-For <b class="Fn">zip_file_error_get</b>(), replace
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-int ze, se;
+For <code class="Fn">zip_file_error_get</code>(), replace
+<div class="Bd Pp Bd-indent">
+<pre>
+int ze, se;
zip_file_error_get(zf, &ze, &se);
</pre>
</div>
with
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-int ze, se;
-zip_error_t *error = zip_file_get_error(zf);
-ze = zip_error_code_zip(error);
+<div class="Bd Pp Bd-indent">
+<pre>
+int ze, se;
+zip_error_t *error = zip_file_get_error(zf);
+ze = zip_error_code_zip(error);
se = zip_error_code_system(error);
</pre>
</div>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_code_system.html">zip_error_code_system(3)</a>,
<a class="Xr" href="zip_error_code_zip.html">zip_error_code_zip(3)</a>,
<a class="Xr" href="zip_file_get_error.html">zip_file_get_error(3)</a>,
<a class="Xr" href="zip_get_error.html">zip_get_error(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_get</b>() was added in libzip 0.6. It was deprecated in
- libzip 1.0, use <b class="Fn">zip_get_error</b>(),
- <b class="Fn">zip_error_code_zip</b>(), /
- <b class="Fn">zip_error_code_system</b>() instead.
-<div class="Pp"></div>
-<b class="Fn">zip_file_error_get</b>() was added in libzip 0.6. It was
- deprecated in libzip 1.0, use <b class="Fn">zip_file_get_error</b>(),
- <b class="Fn">zip_error_code_zip</b>(), /
- <b class="Fn">zip_error_code_system</b>() instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_get</code>() was added in libzip 0.6. It was
+ deprecated in libzip 1.0, use <code class="Fn">zip_get_error</code>(),
+ <code class="Fn">zip_error_code_zip</code>(), /
+ <code class="Fn">zip_error_code_system</code>() instead.
+<p class="Pp"><code class="Fn">zip_file_error_get</code>() was added in libzip
+ 0.6. It was deprecated in libzip 1.0, use
+ <code class="Fn">zip_file_get_error</code>(),
+ <code class="Fn">zip_error_code_zip</code>(), /
+ <code class="Fn">zip_error_code_system</code>() instead.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_get.mdoc -- get error codes for archive or file
+.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_GET" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_get_sys_type.mdoc -- get type of error
+ Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_GET_SYS_TYPE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_get_sys_type</b> — <span class="Nd">get type of
- system error code (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_get_sys_type</code> —
+<div class="Nd">get type of system error code (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_error_get_sys_type</b>(<var class="Fa" style="white-space: nowrap;">int
- ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_error_get_sys_type</b>() is deprecated; use
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_error_get_sys_type</code>(<var class="Fa" style="white-space: nowrap;">int
+ ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_error_get_sys_type</code>() is deprecated; use
<a class="Xr" href="zip_error_init_with_code.html">zip_error_init_with_code(3)</a>
and
<a class="Xr" href="zip_error_system_type.html">zip_error_system_type(3)</a>
instead.
-<div class="Pp"></div>
-Replace
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
+<p class="Pp">Replace</p>
+<div class="Bd Pp Bd-indent">
+<pre>
int i = zip_error_get_sys_type(ze);
</pre>
</div>
with
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-zip_error_t error;
-zip_error_init_with_code(&error, ze);
+<div class="Bd Pp Bd-indent">
+<pre>
+zip_error_t error;
+zip_error_init_with_code(&error, ze);
int i = zip_error_system_type(&error);
</pre>
</div>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_init_with_code.html">zip_error_init_with_code(3)</a>,
<a class="Xr" href="zip_error_system_type.html">zip_error_system_type(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_get_sys_type</b>() was added in libzip 0.6. It was
- deprecated in libzip 1.0, use <b class="Fn">zip_error_system_type</b>()
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_get_sys_type</code>() was added in libzip 0.6. It was
+ deprecated in libzip 1.0, use <code class="Fn">zip_error_system_type</code>()
instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_get_sys_type.mdoc -- get type of error
+.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_GET_SYS_TYPE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_init.mdoc -- initialize zip_error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_INIT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_init</b>, <b class="Nm">zip_error_init_with_code</b>
- — <span class="Nd">initialize zip_error structure</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_init</code>,
+ <code class="Nm">zip_error_init_with_code</code> —
+<div class="Nd">initialize zip_error structure</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_error_init</b>(<var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_error_init_with_code</b>(<var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>, <var class="Fa" style="white-space: nowrap;">int ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_init</b>() function initializes the zip_error
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_error_init</code>(<var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>);</p>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_error_init_with_code</code>(<var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>, <var class="Fa" style="white-space: nowrap;">int
+ ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_init</code>() function initializes the zip_error
pointed to by <var class="Ar">error</var>. <var class="Ar">*error</var> must
- be allocated before calling <b class="Fn">zip_error_init</b>().
-<div class="Pp"></div>
-The <b class="Fn">zip_error_init_with_code</b>() function does the same, but
- additionally sets the zip error code to <var class="Ar">ze</var> and sets the
- system error code to the current <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/errno.html">errno(3)</a>
- value, if appropriate.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+ be allocated before calling <code class="Fn">zip_error_init</code>().
+<p class="Pp">The <code class="Fn">zip_error_init_with_code</code>() function
+ does the same, but additionally sets the zip error code to
+ <var class="Ar">ze</var> and sets the system error code to the current
+ <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/errno.html">errno(3)</a> value, if appropriate.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_fini.html">zip_error_fini(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_init</b>() and
- <b class="Fn">zip_error_init_with_code</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_init</code>() and
+ <code class="Fn">zip_error_init_with_code</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_init.mdoc -- initialize zip_error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_INIT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_set.mdoc -- set zip_error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_SET(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_set</b> — <span class="Nd">fill in zip_error
- structure</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_set</code> —
+<div class="Nd">fill in zip_error structure</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_error_set</b>(<var class="Fa" style="white-space: nowrap;">zip_error_t
- *ze</var>, <var class="Fa" style="white-space: nowrap;">int le</var>,
- <var class="Fa" style="white-space: nowrap;">int se</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_set</b>() function sets the zip_error pointed to by
- <var class="Ar">ze</var> to the libzip error code <var class="Ar">le</var> and
- the system error code <var class="Ar">se</var>.
-<div class="Pp"></div>
-<var class="Ar">ze</var> must be allocated and initialized with
- <a class="Xr" href="zip_error_fini.html">zip_error_fini(3)</a> before calling
- <b class="Fn">zip_error</b>(<var class="Fa">set</var>).
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_error_set</code>(<var class="Fa" style="white-space: nowrap;">zip_error_t
+ *ze</var>, <var class="Fa" style="white-space: nowrap;">int le</var>,
+ <var class="Fa" style="white-space: nowrap;">int se</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_set</code>() function sets the zip_error pointed
+ to by <var class="Ar">ze</var> to the libzip error code
+ <var class="Ar">le</var> and the system error code <var class="Ar">se</var>.
+<p class="Pp"><var class="Ar">ze</var> must be allocated and initialized with
+ <a class="Xr" href="zip_error_fini.html">zip_error_fini(3)</a> before
+ calling <code class="Fn">zip_error</code>(<var class="Fa">set</var>).</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_init.html">zip_error_init(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_set</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_set</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_set.mdoc -- set zip_error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_SET" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_strerror.mdoc -- create human-readable version of zip_error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_STRERROR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_strerror</b> — <span class="Nd">create
- human-readable string for zip_error</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_strerror</code> —
+<div class="Nd">create human-readable string for zip_error</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_error_strerror</b>(<var class="Fa" style="white-space: nowrap;">zip_error_t
- *ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_strerror</b>() function returns an error message
- string corresponding to <var class="Ar">ze</var> like
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_error_strerror</code>(<var class="Fa" style="white-space: nowrap;">zip_error_t
+ *ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_strerror</code>() function returns an error
+ message string corresponding to <var class="Ar">ze</var> like
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/strerror.html">strerror(3)</a>. This string will stay
- valid until the next call to <b class="Fn">zip_error_strerror</b>() or until
- <a class="Xr" href="zip_error_fini.html">zip_error_fini(3)</a> is called.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+ valid until the next call to <code class="Fn">zip_error_strerror</code>() or
+ until <a class="Xr" href="zip_error_fini.html">zip_error_fini(3)</a> is
+ called.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/strerror.html">strerror(3)</a>,
<a class="Xr" href="zip_error_fini.html">zip_error_fini(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_strerror</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_strerror</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_strerror.mdoc -- create human-readable version of zip_error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_STRERROR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_system_type.mdoc -- return system type for error
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_SYSTEM_TYPE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_system_type</b> — <span class="Nd">return type of
- system error</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_system_type</code> —
+<div class="Nd">return type of system error</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_error_system_type</b>(<var class="Fa" style="white-space: nowrap;">const
- zip_error_t *ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_error_system_type</b>() function returns the type of the
- system specific part for the zip_error <var class="Ar">ze</var>. Currently,
- the following system types are defined:
-<dl class="Bl-tag" style="margin-left: 11.00ex;">
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><code class="Dv">ZIP_ET_NONE</code></dt>
- <dd class="It-tag">System specific part of <var class="Ar">ze</var> is
- unused.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><code class="Dv">ZIP_ET_SYS</code></dt>
- <dd class="It-tag">System specific part of <var class="Ar">ze</var> is an
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_error_system_type</code>(<var class="Fa" style="white-space: nowrap;">const
+ zip_error_t *ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_error_system_type</code>() function returns the type of
+ the system specific part for the zip_error <var class="Ar">ze</var>.
+ Currently, the following system types are defined:
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_ET_NONE"><code class="Dv" id="ZIP_ET_NONE">ZIP_ET_NONE</code></a></dt>
+ <dd>System specific part of <var class="Ar">ze</var> is unused.</dd>
+ <dt><a class="permalink" href="#ZIP_ET_SYS"><code class="Dv" id="ZIP_ET_SYS">ZIP_ET_SYS</code></a></dt>
+ <dd>System specific part of <var class="Ar">ze</var> is an
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/errno.html">errno(2)</a>.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><code class="Dv">ZIP_ET_ZLIB</code></dt>
- <dd class="It-tag">System specific part of <var class="Ar">ze</var> is a
+ <dt><a class="permalink" href="#ZIP_ET_ZLIB"><code class="Dv" id="ZIP_ET_ZLIB">ZIP_ET_ZLIB</code></a></dt>
+ <dd>System specific part of <var class="Ar">ze</var> is a
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/zlib.html">zlib(3)</a> error.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_code_system.html">zip_error_code_system(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_system_type</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_system_type</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_system_type.mdoc -- return system type for error
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_SYSTEM_TYPE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_to_data.mdoc -- create error data for ZIP_SOURCE_ERROR
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_TO_DATA(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_to_data</b> — <span class="Nd">convert zip_error
- to return value suitable for ZIP_SOURCE_ERROR</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_to_data</code> —
+<div class="Nd">convert zip_error to return value suitable for
+ ZIP_SOURCE_ERROR</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_error_to_data</b>(<var class="Fa" style="white-space: nowrap;">const
- zip_error_t *ze</var>, <var class="Fa" style="white-space: nowrap;">void
- *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- len</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Fn">zip_error_to_data</b>() function converts the zip_error
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_error_to_data</code>(<var class="Fa" style="white-space: nowrap;">const
+ zip_error_t *ze</var>, <var class="Fa" style="white-space: nowrap;">void
+ *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ len</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Fn">zip_error_to_data</code>() function converts the zip_error
<var class="Ar">ze</var> into data suitable as return value for
<code class="Dv">ZIP_SOURCE_ERROR</code>. The data is written into the buffer
<var class="Ar">data</var> of size <var class="Ar">len</var>. If the buffer is
not large enough to hold 2 ints, an error is returned.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_error_to_data</b>() returns 2*(sizeof int) on success, and -1
- on error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_error_to_data</code>() returns 2*(sizeof int) on success,
+ and -1 on error.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source_function.html">zip_source_function(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_to_data</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_to_data</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_to_data.mdoc -- create error data for ZIP_SOURCE_ERROR
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_TO_DATA" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_error_to_str.mdoc -- get string representation of zip error code
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERROR_TO_STR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_error_to_str</b> — <span class="Nd">get string
- representation of zip error (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_error_to_str</code> —
+<div class="Nd">get string representation of zip error (obsolete
+ interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_error_to_str</b>(<var class="Fa" style="white-space: nowrap;">char
- *buf</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">int ze</var>,
- <var class="Fa" style="white-space: nowrap;">int se</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_error_to_str</b>() is deprecated; use
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_error_to_str</code>(<var class="Fa" style="white-space: nowrap;">char
+ *buf</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">int ze</var>,
+ <var class="Fa" style="white-space: nowrap;">int se</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_error_to_str</code>() is deprecated; use
<a class="Xr" href="zip_error_init_with_code.html">zip_error_init_with_code(3)</a>
and <a class="Xr" href="zip_error_strerror.html">zip_error_strerror(3)</a>
instead.
-<div class="Pp"></div>
-Replace
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-char buf[BUFSIZE];
-zip_error_to_str(buf, sizeof(buf), ze, se);
+<p class="Pp">Replace</p>
+<div class="Bd Pp Bd-indent">
+<pre>
+char buf[BUFSIZE];
+zip_error_to_str(buf, sizeof(buf), ze, se);
printf("%s", buf);
</pre>
</div>
with
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-zip_error_t error;
-zip_error_init_with_code(&error, ze);
-printf("%s", zip_error_strerror(&error));
+<div class="Bd Pp Bd-indent">
+<pre>
+zip_error_t error;
+zip_error_init_with_code(&error, ze);
+printf("%s", zip_error_strerror(&error));
zip_error_fini(&error);
</pre>
</div>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_init_with_code.html">zip_error_init_with_code(3)</a>,
<a class="Xr" href="zip_error_strerror.html">zip_error_strerror(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_error_to_str</b>() was added in libzip 0.6. In libzip 0.10 the
- type of <var class="Ar">len</var> was changed from
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_error_to_str</code>() was added in libzip 0.6. In libzip
+ 0.10 the type of <var class="Ar">len</var> was changed from
<var class="Vt">size_t</var> to <var class="Vt">zip_uint64_t</var>. It was
- deprecated in libzip 1.0, use <b class="Fn">zip_error_init_with_code</b>() and
- <b class="Fn">zip_error_strerror</b>() instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+ deprecated in libzip 1.0, use
+ <code class="Fn">zip_error_init_with_code</code>() and
+ <code class="Fn">zip_error_strerror</code>() instead.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_error_to_str.mdoc -- get string representation of zip error code
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_ERROR_TO_STR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_errors.mdoc -- list of all libzip error codes
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+ This file was generated automatically by ./make_zip_errors.sh
+ from ./../lib/zip.h; make changes there.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_ERRORS(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_errors</b> — <span class="Nd">list of all libzip error
- codes</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_errors</code> —
+<div class="Nd">list of all libzip error codes</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
The following error codes are used by libzip:
-<dl class="Bl-tag" style="margin-left: 24.00ex;">
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_CHANGED</code>]</dt>
- <dd class="It-tag">Entry has been changed.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_CLOSE</code>]</dt>
- <dd class="It-tag">Closing zip archive failed.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_COMPNOTSUPP</code>]</dt>
- <dd class="It-tag">Compression method not supported.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_COMPRESSED_DATA</code>]</dt>
- <dd class="It-tag">Compressed data invalid.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_CRC</code>]</dt>
- <dd class="It-tag">CRC error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_DELETED</code>]</dt>
- <dd class="It-tag">Entry has been deleted.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_ENCRNOTSUPP</code>]</dt>
- <dd class="It-tag">Encryption method not supported.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_EOF</code>]</dt>
- <dd class="It-tag">Premature end of file.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
- <dd class="It-tag">File already exists.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_INCONS</code>]</dt>
- <dd class="It-tag">Zip archive inconsistent.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_INTERNAL</code>]</dt>
- <dd class="It-tag">Internal error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_INUSE</code>]</dt>
- <dd class="It-tag">Resource still in use.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">Invalid argument.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Malloc failure.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_MULTIDISK</code>]</dt>
- <dd class="It-tag">Multi-disk zip archives not supported.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag">No such file.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_NOPASSWD</code>]</dt>
- <dd class="It-tag">No password provided.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_NOZIP</code>]</dt>
- <dd class="It-tag">Not a zip archive.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_OK</code>]</dt>
- <dd class="It-tag">No error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">Can't open file.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_OPNOTSUPP</code>]</dt>
- <dd class="It-tag">Operation not supported.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">Read-only archive.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_READ</code>]</dt>
- <dd class="It-tag">Read error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_REMOVE</code>]</dt>
- <dd class="It-tag">Can't remove file.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_RENAME</code>]</dt>
- <dd class="It-tag">Renaming temporary file failed.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_SEEK</code>]</dt>
- <dd class="It-tag">Seek error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_TELL</code>]</dt>
- <dd class="It-tag">Tell error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_TMPOPEN</code>]</dt>
- <dd class="It-tag">Failure to create temporary file.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_WRITE</code>]</dt>
- <dd class="It-tag">Write error.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_WRONGPASSWD</code>]</dt>
- <dd class="It-tag">Wrong password provided.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_ZIPCLOSED</code>]</dt>
- <dd class="It-tag">Containing zip archive was closed.</dd>
- <dt class="It-tag" style="margin-left: -24.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -24.00ex;">[<code class="Er">ZIP_ER_ZLIB</code>]</dt>
- <dd class="It-tag">Zlib error.</dd>
+<dl class="Bl-tag">
+ <dt>[<code class="Er">ZIP_ER_CHANGED</code>]</dt>
+ <dd>Entry has been changed.</dd>
+ <dt>[<code class="Er">ZIP_ER_CLOSE</code>]</dt>
+ <dd>Closing zip archive failed.</dd>
+ <dt>[<code class="Er">ZIP_ER_COMPNOTSUPP</code>]</dt>
+ <dd>Compression method not supported.</dd>
+ <dt>[<code class="Er">ZIP_ER_COMPRESSED_DATA</code>]</dt>
+ <dd>Compressed data invalid.</dd>
+ <dt>[<code class="Er">ZIP_ER_CRC</code>]</dt>
+ <dd>CRC error.</dd>
+ <dt>[<code class="Er">ZIP_ER_DELETED</code>]</dt>
+ <dd>Entry has been deleted.</dd>
+ <dt>[<code class="Er">ZIP_ER_ENCRNOTSUPP</code>]</dt>
+ <dd>Encryption method not supported.</dd>
+ <dt>[<code class="Er">ZIP_ER_EOF</code>]</dt>
+ <dd>Premature end of file.</dd>
+ <dt>[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
+ <dd>File already exists.</dd>
+ <dt>[<code class="Er">ZIP_ER_INCONS</code>]</dt>
+ <dd>Zip archive inconsistent.</dd>
+ <dt>[<code class="Er">ZIP_ER_INTERNAL</code>]</dt>
+ <dd>Internal error.</dd>
+ <dt>[<code class="Er">ZIP_ER_INUSE</code>]</dt>
+ <dd>Resource still in use.</dd>
+ <dt>[<code class="Er">ZIP_ER_INVAL</code>]</dt>
+ <dd>Invalid argument.</dd>
+ <dt>[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
+ <dd>Malloc failure.</dd>
+ <dt>[<code class="Er">ZIP_ER_MULTIDISK</code>]</dt>
+ <dd>Multi-disk zip archives not supported.</dd>
+ <dt>[<code class="Er">ZIP_ER_NOENT</code>]</dt>
+ <dd>No such file.</dd>
+ <dt>[<code class="Er">ZIP_ER_NOPASSWD</code>]</dt>
+ <dd>No password provided.</dd>
+ <dt>[<code class="Er">ZIP_ER_NOZIP</code>]</dt>
+ <dd>Not a zip archive.</dd>
+ <dt>[<code class="Er">ZIP_ER_OK</code>]</dt>
+ <dd>No error.</dd>
+ <dt>[<code class="Er">ZIP_ER_OPEN</code>]</dt>
+ <dd>Can't open file.</dd>
+ <dt>[<code class="Er">ZIP_ER_OPNOTSUPP</code>]</dt>
+ <dd>Operation not supported.</dd>
+ <dt>[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
+ <dd>Read-only archive.</dd>
+ <dt>[<code class="Er">ZIP_ER_READ</code>]</dt>
+ <dd>Read error.</dd>
+ <dt>[<code class="Er">ZIP_ER_REMOVE</code>]</dt>
+ <dd>Can't remove file.</dd>
+ <dt>[<code class="Er">ZIP_ER_RENAME</code>]</dt>
+ <dd>Renaming temporary file failed.</dd>
+ <dt>[<code class="Er">ZIP_ER_SEEK</code>]</dt>
+ <dd>Seek error.</dd>
+ <dt>[<code class="Er">ZIP_ER_TELL</code>]</dt>
+ <dd>Tell error.</dd>
+ <dt>[<code class="Er">ZIP_ER_TMPOPEN</code>]</dt>
+ <dd>Failure to create temporary file.</dd>
+ <dt>[<code class="Er">ZIP_ER_WRITE</code>]</dt>
+ <dd>Write error.</dd>
+ <dt>[<code class="Er">ZIP_ER_WRONGPASSWD</code>]</dt>
+ <dd>Wrong password provided.</dd>
+ <dt>[<code class="Er">ZIP_ER_ZIPCLOSED</code>]</dt>
+ <dd>Containing zip archive was closed.</dd>
+ <dt>[<code class="Er">ZIP_ER_ZLIB</code>]</dt>
+ <dd>Zlib error.</dd>
</dl>
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_errors.mdoc -- list of all libzip error codes
+.\" Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" This file was generated automatically by ./make_zip_errors.sh
+.\" from ./../lib/zip.h; make changes there.
+.\"
.TH "ZIP_ERRORS" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.\" zip_errors.mdoc -- list of all libzip error codes
-.\" Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_fclose.mdoc -- close file in zip archive
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FCLOSE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_fclose</b> — <span class="Nd">close file in zip
- archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_fclose</code> —
+<div class="Nd">close file in zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_fclose</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_fclose</b>() function closes <var class="Ar">file</var>
- and frees the memory allocated for it.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_fclose</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_fclose</code>() function closes
+ <var class="Ar">file</var> and frees the memory allocated for it.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, the error code is returned.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>,
<a class="Xr" href="zip_fread.html">zip_fread(3)</a>,
<a class="Xr" href="zip_fseek.html">zip_fseek(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_fclose</b>() was added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_fclose</code>() was added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_fclose.mdoc -- close file in zip archive
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FCLOSE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_fdopen.mdoc -- open zip archive using existing file descriptor
+ Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FDOPEN(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_fdopen</b> — <span class="Nd">open zip archive using
- open file descriptor</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_fdopen</code> —
+<div class="Nd">open zip archive using open file descriptor</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_t *</var>
-<br/>
-<b class="Fn">zip_fdopen</b>(<var class="Fa" style="white-space: nowrap;">int
- fd</var>, <var class="Fa" style="white-space: nowrap;">int flags</var>,
- <var class="Fa" style="white-space: nowrap;">int *errorp</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_t *</var>
+ <br/>
+ <code class="Fn">zip_fdopen</code>(<var class="Fa" style="white-space: nowrap;">int
+ fd</var>, <var class="Fa" style="white-space: nowrap;">int flags</var>,
+ <var class="Fa" style="white-space: nowrap;">int *errorp</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
The zip archive specified by the open file descriptor <var class="Ar">fd</var>
is opened and a pointer to a <var class="Ft">struct zip</var>, used to
manipulate the archive, is returned. In contrast to
<a class="Xr" href="zip_open.html">zip_open(3)</a>, using
- <b class="Nm">zip_fdopen</b> the archive can only be opened in read-only mode.
- The <var class="Ar">fd</var> argument may not be used any longer after calling
- <b class="Nm">zip_fdopen</b>. The <var class="Fa">flags</var> are specified by
- <i class="Em">or</i><span class="No">'ing</span> the following values, or 0
- for none of them.
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 13.00ex;">
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_CHECKCONS</code></dt>
- <dd class="It-tag">Perform additional stricter consistency checks on the
- archive, and error if they fail.</dd>
+ <code class="Nm">zip_fdopen</code> the archive can only be opened in read-only
+ mode. The <var class="Ar">fd</var> argument may not be used any longer after
+ calling <code class="Nm">zip_fdopen</code>. The <var class="Fa">flags</var>
+ are specified by <i class="Em">or</i><span class="No">'ing</span> the
+ following values, or 0 for none of them.
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_CHECKCONS"><code class="Dv" id="ZIP_CHECKCONS">ZIP_CHECKCONS</code></a></dt>
+ <dd>Perform additional stricter consistency checks on the archive, and error
+ if they fail.</dd>
</dl>
</div>
-<div class="Pp"></div>
-If an error occurs and <var class="Ar">errorp</var> is
- <span class="No">non-</span><code class="Dv">NULL</code>, it will be set to
- the corresponding error code.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-Upon successful completion <b class="Fn">zip_fdopen</b>() returns a
+<p class="Pp">If an error occurs and <var class="Ar">errorp</var> is
+ <span class="No">non-</span><code class="Dv">NULL</code>, it will be set to
+ the corresponding error code.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+Upon successful completion <code class="Fn">zip_fdopen</code>() returns a
<var class="Ft">struct zip</var> pointer, and <var class="Ar">fd</var> should
not be used any longer, nor passed to
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/close.html">close(2)</a>. Otherwise,
<code class="Dv">NULL</code> is returned and <var class="Ar">*errorp</var> is
set to indicate the error. In the error case, <var class="Ar">fd</var> remains
unchanged.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
The file specified by <var class="Ar">fd</var> is prepared for use by
<a class="Xr" href="libzip.html">libzip(3)</a> unless:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INCONS</code>]</dt>
- <dd class="It-tag">Inconsistencies were found in the file specified by
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INCONS"><code class="Er" id="ZIP_ER_INCONS">ZIP_ER_INCONS</code></a>]</dt>
+ <dd>Inconsistencies were found in the file specified by
<var class="Ar">path</var>. This error is often caused by specifying
<code class="Dv">ZIP_CHECKCONS</code> but can also happen without it.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">The <var class="Ar">flags</var> argument is invalid. Not
- all <a class="Xr" href="zip_open.html">zip_open(3)</a> flags are allowed
- for <b class="Nm">zip_fdopen</b>, see
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd>The <var class="Ar">flags</var> argument is invalid. Not all
+ <a class="Xr" href="zip_open.html">zip_open(3)</a> flags are allowed for
+ <code class="Nm">zip_fdopen</code>, see
<a class="Sx" href="#DESCRIPTION">DESCRIPTION</a>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOZIP</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">fd</var> is not a zip
- archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">fd</var> could not be
- prepared for use by <a class="Xr" href="libzip.html">libzip(3)</a>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_READ</code>]</dt>
- <dd class="It-tag">A read error occurred; see <var class="Va">errno</var> for
- details.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_SEEK</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">fd</var> does not
- allow seeks.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOZIP"><code class="Er" id="ZIP_ER_NOZIP">ZIP_ER_NOZIP</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">fd</var> is not a zip archive.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_OPEN"><code class="Er" id="ZIP_ER_OPEN">ZIP_ER_OPEN</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">fd</var> could not be prepared for
+ use by <a class="Xr" href="libzip.html">libzip(3)</a>.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_READ"><code class="Er" id="ZIP_ER_READ">ZIP_ER_READ</code></a>]</dt>
+ <dd>A read error occurred; see <var class="Va">errno</var> for details.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_SEEK"><code class="Er" id="ZIP_ER_SEEK">ZIP_ER_SEEK</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">fd</var> does not allow seeks.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_close.html">zip_close(3)</a>,
- <a class="Xr" href="zip_error_to_str.html">zip_error_to_str(3)</a>,
+ <a class="Xr" href="zip_error_strerror.html">zip_error_strerror(3)</a>,
<a class="Xr" href="zip_open.html">zip_open(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_fdopen</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_fdopen</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_fdopen.mdoc -- open zip archive using existing file descriptor
+.\" Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FDOPEN" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.SH "SEE ALSO"
libzip(3),
zip_close(3),
-zip_error_to_str(3),
+zip_error_strerror(3),
zip_open(3)
.SH "HISTORY"
\fBzip_fdopen\fR()
.\" zip_fdopen.mdoc -- open zip archive using existing file descriptor
-.\" Copyright (C) 2009-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2009-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Sh SEE ALSO
.Xr libzip 3 ,
.Xr zip_close 3 ,
-.Xr zip_error_to_str 3 ,
+.Xr zip_error_strerror 3 ,
.Xr zip_open 3
.Sh HISTORY
.Fn zip_fdopen
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_add.mdoc -- add files to zip archive
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_ADD(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_add</b>, <b class="Nm">zip_file_replace</b> —
- <span class="Nd">add file to zip archive or replace file in zip archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_add</code>, <code class="Nm">zip_file_replace</code>
+ —
+<div class="Nd">add file to zip archive or replace file in zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_file_add</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *name</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_replace</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_file_add</b>() adds a file to a zip archive,
- while <b class="Fn">zip_file_replace</b>() replaces an existing file in a zip
- archive. The argument <var class="Ar">archive</var> specifies the zip archive
- to which the file should be added. <var class="Ar">name</var> is the file's
- name in the zip archive (for <b class="Fn">zip_file_add</b>()), while
- <var class="Ar">index</var> specifies which file should be replaced (for
- <b class="Fn">zip_file_replace</b>()). The <var class="Ar">flags</var>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_file_add</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *name</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_replace</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_file_add</code>() adds a file to a zip
+ archive, while <code class="Fn">zip_file_replace</code>() replaces an existing
+ file in a zip archive. The argument <var class="Ar">archive</var> specifies
+ the zip archive to which the file should be added. <var class="Ar">name</var>
+ is the file's name in the zip archive (for
+ <code class="Fn">zip_file_add</code>()), while <var class="Ar">index</var>
+ specifies which file should be replaced (for
+ <code class="Fn">zip_file_replace</code>()). The <var class="Ar">flags</var>
argument can be any combination of <code class="Dv">ZIP_FL_OVERWRITE</code>
with one of <code class="Dv">ZIP_FL_ENC_*</code>:
-<dl class="Bl-tag" style="margin-left: 20.00ex;">
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_OVERWRITE</code></dt>
- <dd class="It-tag">Overwrite any existing file of the same name. For
- <b class="Nm">zip_file_add</b> only.</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">Guess encoding of <var class="Ar">name</var>
- (default).</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_UTF_8</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">name</var> as UTF-8.</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_CP437</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">name</var> as code page 437
- (CP-437).</dd>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_OVERWRITE"><code class="Dv" id="ZIP_FL_OVERWRITE">ZIP_FL_OVERWRITE</code></a></dt>
+ <dd>Overwrite any existing file of the same name. For
+ <code class="Nm">zip_file_add</code> only.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>Guess encoding of <var class="Ar">name</var> (default).</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_UTF_8"><code class="Dv" id="ZIP_FL_ENC_UTF_8">ZIP_FL_ENC_UTF_8</code></a></dt>
+ <dd>Interpret <var class="Ar">name</var> as UTF-8.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_CP437"><code class="Dv" id="ZIP_FL_ENC_CP437">ZIP_FL_ENC_CP437</code></a></dt>
+ <dd>Interpret <var class="Ar">name</var> as code page 437 (CP-437).</dd>
</dl>
The data is obtained from the <var class="Ar">source</var> argument, see
<a class="Xr" href="zip_source.html">zip_source(3)</a>.
-<div class="Pp"></div>
-<i class="Em">NOTE</i>:
- <a class="Xr" href="zip_source_free.html">zip_source_free(3)</a> should not be
- called on a <var class="Ar">source</var> after it was used successfully in a
- <b class="Nm">zip_file_add</b> or <b class="Nm">zip_file_replace</b> call.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-Upon successful completion, <b class="Fn">zip_file_add</b>() returns the index
- of the new file in the archive, and <b class="Fn">zip_file_replace</b>()
- returns 0. Otherwise, -1 is returned and the error code in
- <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="EXAMPLES">EXAMPLES</h1>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
-zip_source_t *s;
-const char buf="teststring";
-
-if ((s=zip_source_buffer(archive, buffer, sizeof(buf), 0)) == NULL ||
- zip_file_add(archive, name, s, ZIP_FL_ENC_UTF_8) < 0) {
- zip_source_free(s);
- printf("error adding file: %s\n", zip_strerror(archive));
+<p class="Pp"><i class="Em">NOTE</i>:
+ <a class="Xr" href="zip_source_free.html">zip_source_free(3)</a> should not
+ be called on a <var class="Ar">source</var> after it was used successfully
+ in a <code class="Nm">zip_file_add</code> or
+ <code class="Nm">zip_file_replace</code> call.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+Upon successful completion, <code class="Fn">zip_file_add</code>() returns the
+ index of the new file in the archive, and
+ <code class="Fn">zip_file_replace</code>() returns 0. Otherwise, -1 is
+ returned and the error code in <var class="Ar">archive</var> is set to
+ indicate the error.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
+<div class="Bd Bd-indent">
+<pre>
+zip_source_t *s;
+const char *buf="teststring";
+
+if ((s=zip_source_buffer(archive, buf, sizeof(buf), 0)) == NULL ||
+ zip_file_add(archive, name, s, ZIP_FL_ENC_UTF_8) < 0) {
+ zip_source_free(s);
+ printf("error adding file: %s\n", zip_strerror(archive));
}
</pre>
</div>
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_add</b>() and <b class="Fn">zip_file_replace</b>() fail
- if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
- <dd class="It-tag">There is already a file called <var class="Ar">name</var>
- in the archive. (Only applies to <b class="Fn">zip_file_add</b>(), and
- only if <code class="Dv">ZIP_FL_OVERWRITE</code> is not provided).</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">source</var> or <var class="Ar">name</var>
- are <code class="Dv">NULL</code>, or <var class="Ar">index</var> is
- invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">Archive was opened in read-only mode.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_add</code>() and
+ <code class="Fn">zip_file_replace</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_EXISTS"><code class="Er" id="ZIP_ER_EXISTS">ZIP_ER_EXISTS</code></a>]</dt>
+ <dd>There is already a file called <var class="Ar">name</var> in the archive.
+ (Only applies to <code class="Fn">zip_file_add</code>(), and only if
+ <code class="Dv">ZIP_FL_OVERWRITE</code> is not provided).</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">source</var> or <var class="Ar">name</var> are
+ <code class="Dv">NULL</code>, or <var class="Ar">index</var> is
+ invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RDONLY"><code class="Er" id="ZIP_ER_RDONLY">ZIP_ER_RDONLY</code></a>]</dt>
+ <dd>Archive was opened in read-only mode.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_add</b>() and <b class="Fn">zip_file_replace</b>() were
- added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_add</code>() and
+ <code class="Fn">zip_file_replace</code>() were added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_add.mdoc -- add files to zip archive
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_ADD" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.nf
.RS 6n
zip_source_t *s;
-const char buf="teststring";
+const char *buf="teststring";
-if ((s=zip_source_buffer(archive, buffer, sizeof(buf), 0)) == NULL ||
+if ((s=zip_source_buffer(archive, buf, sizeof(buf), 0)) == NULL ||
zip_file_add(archive, name, s, ZIP_FL_ENC_UTF_8) < 0) {
zip_source_free(s);
printf("error adding file: %s\en", zip_strerror(archive));
.\" zip_file_add.mdoc -- add files to zip archive
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Sh EXAMPLES
.Bd -literal -offset indent
zip_source_t *s;
-const char buf="teststring";
+const char *buf="teststring";
-if ((s=zip_source_buffer(archive, buffer, sizeof(buf), 0)) == NULL ||
- zip_file_add(archive, name, s, ZIP_FL_ENC_UTF_8) \*[Lt] 0) {
+if ((s=zip_source_buffer(archive, buf, sizeof(buf), 0)) == NULL ||
+ zip_file_add(archive, name, s, ZIP_FL_ENC_UTF_8) < 0) {
zip_source_free(s);
printf("error adding file: %s\en", zip_strerror(archive));
}
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_extra_field_delete.mdoc -- delete extra field for file in zip
+ Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_EXTRA_FIELD_DELETE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_extra_field_delete</b>,
- <b class="Nm">zip_file_extra_field_delete_by_id</b> —
- <span class="Nd">delete extra field for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_extra_field_delete</code>,
+ <code class="Nm">zip_file_extra_field_delete_by_id</code> —
+<div class="Nd">delete extra field for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_extra_field_delete</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_index</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_extra_field_delete_by_id</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_id</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_index</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_extra_field_delete</b>() function deletes the extra
- field with index <var class="Ar">extra_field_index</var> for the file at
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_extra_field_delete</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_index</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);</p>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_extra_field_delete_by_id</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_id</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_index</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_extra_field_delete</code>() function deletes the
+ extra field with index <var class="Ar">extra_field_index</var> for the file at
position <var class="Ar">index</var> in the zip archive.
-<div class="Pp"></div>
-If <var class="Ar">extra_field_index</var> is
- <code class="Dv">ZIP_EXTRA_FIELD_ALL</code>, then all extra fields will be
- deleted.
-<div class="Pp"></div>
-The following <var class="Ar">flags</var> are supported:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 16.00ex;">
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_CENTRAL</code></dt>
- <dd class="It-tag">Delete extra fields from the archive's central
- directory.</dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_LOCAL</code></dt>
- <dd class="It-tag">Delete extra fields from the local file headers.</dd>
+<p class="Pp">If <var class="Ar">extra_field_index</var> is
+ <code class="Dv">ZIP_EXTRA_FIELD_ALL</code>, then all extra fields will be
+ deleted.</p>
+<p class="Pp">The following <var class="Ar">flags</var> are supported:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_CENTRAL"><code class="Dv" id="ZIP_FL_CENTRAL">ZIP_FL_CENTRAL</code></a></dt>
+ <dd>Delete extra fields from the archive's central directory.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_LOCAL"><code class="Dv" id="ZIP_FL_LOCAL">ZIP_FL_LOCAL</code></a></dt>
+ <dd>Delete extra fields from the local file headers.</dd>
</dl>
</div>
-<div class="Pp"></div>
-The <b class="Fn">zip_file_extra_field_delete_by_id</b>() function deletes the
- extra field with ID (two-byte signature) <var class="Ar">extra_field_id</var>
- and index <var class="Ar">extra_field_index</var> (in other words, the
- <var class="Ar">extra_field_index</var><span class="No">'th</span> extra field
- with ID <var class="Ar">extra_field_id</var>) The other arguments are the same
- as for <b class="Fn">zip_file_extra_field_delete</b>()
- (<code class="Dv">ZIP_EXTRA_FIELD_ALL</code> will delete all extra fields of
- the specified ID).
-<div class="Pp"></div>
-Please note that due to the library design, the index of an extra field may be
- different between central directory and local file headers. For this reason,
- it is not allowed to specify both <code class="Dv">ZIP_FL_CENTRAL</code> and
- <code class="Dv">ZIP_FL_LOCAL</code> in <var class="Ar">flags</var>, except
- when deleting all extra fields (i.e., <var class="Ar">extra_field_index</var>
- being <code class="Dv">ZIP_EXTRA_FIELD_ALL</code>).
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The <code class="Fn">zip_file_extra_field_delete_by_id</code>()
+ function deletes the extra field with ID (two-byte signature)
+ <var class="Ar">extra_field_id</var> and index
+ <var class="Ar">extra_field_index</var> (in other words, the
+ <var class="Ar">extra_field_index</var><span class="No">'th</span> extra
+ field with ID <var class="Ar">extra_field_id</var>) The other arguments are
+ the same as for <code class="Fn">zip_file_extra_field_delete</code>()
+ (<code class="Dv">ZIP_EXTRA_FIELD_ALL</code> will delete all extra fields of
+ the specified ID).</p>
+<p class="Pp">Please note that due to the library design, the index of an extra
+ field may be different between central directory and local file headers. For
+ this reason, it is not allowed to specify both
+ <code class="Dv">ZIP_FL_CENTRAL</code> and
+ <code class="Dv">ZIP_FL_LOCAL</code> in <var class="Ar">flags</var>, except
+ when deleting all extra fields (i.e.,
+ <var class="Ar">extra_field_index</var> being
+ <code class="Dv">ZIP_EXTRA_FIELD_ALL</code>).</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_extra_field_delete</b>() and
- <b class="Fn">zip_file_extra_field_delete_by_id</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_extra_field_delete</code>() and
+ <code class="Fn">zip_file_extra_field_delete_by_id</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_NOENT"><code class="Er" id="ZIP_ER_NOENT">ZIP_ER_NOENT</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_extra_field_get.html">zip_file_extra_field_get(3)</a>,
<a class="Xr" href="zip_file_extra_field_set.html">zip_file_extra_field_set(3)</a>,
<a class="Xr" href="zip_file_extra_fields_count.html">zip_file_extra_fields_count(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_extra_field_delete</b>() and
- <b class="Fn">zip_file_extra_field_delete_by_id</b>() were added in libzip
- 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_extra_field_delete</code>() and
+ <code class="Fn">zip_file_extra_field_delete_by_id</code>() were added in
+ libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_extra_field_delete.mdoc -- delete extra field for file in zip
+.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_EXTRA_FIELD_DELETE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_extra_field_get.mdoc -- get extra field for file in zip
+ Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_EXTRA_FIELD_GET(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_extra_field_get</b>,
- <b class="Nm">zip_file_extra_field_get_by_id</b> — <span class="Nd">get
- extra field for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_extra_field_get</code>,
+ <code class="Nm">zip_file_extra_field_get_by_id</code> —
+<div class="Nd">get extra field for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const zip_uint8_t *</var>
-<br/>
-<b class="Fn">zip_file_extra_field_get</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_index</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t *idp</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t *lenp</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<div class="Pp"></div>
-<var class="Ft">const zip_uint8_t *</var>
-<br/>
-<b class="Fn">zip_file_extra_field_get_by_id</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_id</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_index</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t *lenp</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_extra_field_get</b>() function returns the extra
- field with index <var class="Ar">extra_field_index</var> for the file at
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const zip_uint8_t *</var>
+ <br/>
+ <code class="Fn">zip_file_extra_field_get</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_index</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t *idp</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t *lenp</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);</p>
+<p class="Pp"><var class="Ft">const zip_uint8_t *</var>
+ <br/>
+ <code class="Fn">zip_file_extra_field_get_by_id</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_id</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_index</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t *lenp</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_extra_field_get</code>() function returns the
+ extra field with index <var class="Ar">extra_field_index</var> for the file at
position <var class="Ar">index</var> in the zip archive. This pointer should
not be modified or <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/free.html">free(3)</a>'d, and becomes
invalid when <var class="Ar">archive</var> is closed. If
is returned (i.e., neither the ID nor the length, if the
<var class="Ar">idp</var> and <var class="Ar">lenp</var> arguments are not
provided).
-<div class="Pp"></div>
-The following <var class="Ar">flags</var> are supported:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 18.00ex;">
- <dt class="It-tag" style="margin-left: -18.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -18.00ex;"><code class="Dv">ZIP_FL_CENTRAL</code></dt>
- <dd class="It-tag">Return extra fields from the archive's central
- directory.</dd>
- <dt class="It-tag" style="margin-left: -18.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -18.00ex;"><code class="Dv">ZIP_FL_LOCAL</code></dt>
- <dd class="It-tag">Return extra fields from the local file headers.</dd>
- <dt class="It-tag" style="margin-left: -18.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -18.00ex;"><code class="Dv">ZIP_FL_UNCHANGED</code></dt>
- <dd class="It-tag">Return the original unchanged extra fields, ignoring any
- changes made.</dd>
+<p class="Pp">The following <var class="Ar">flags</var> are supported:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_CENTRAL"><code class="Dv" id="ZIP_FL_CENTRAL">ZIP_FL_CENTRAL</code></a></dt>
+ <dd>Return extra fields from the archive's central directory.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_LOCAL"><code class="Dv" id="ZIP_FL_LOCAL">ZIP_FL_LOCAL</code></a></dt>
+ <dd>Return extra fields from the local file headers.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_UNCHANGED"><code class="Dv" id="ZIP_FL_UNCHANGED">ZIP_FL_UNCHANGED</code></a></dt>
+ <dd>Return the original unchanged extra fields, ignoring any changes
+ made.</dd>
</dl>
</div>
-<div class="Pp"></div>
-The <b class="Fn">zip_file_extra_field_get_by_id</b>() function returns the
- extra field with ID (two-byte signature) <var class="Ar">extra_field_id</var>
- and index <var class="Ar">extra_field_index</var> (in other words, the
- <var class="Ar">extra_field_index</var><span class="No">'th</span> extra field
- with ID <var class="Ar">extra_field_id</var>) The other arguments are the same
- as for <b class="Fn">zip_file_extra_field_get</b>().
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The <code class="Fn">zip_file_extra_field_get_by_id</code>()
+ function returns the extra field with ID (two-byte signature)
+ <var class="Ar">extra_field_id</var> and index
+ <var class="Ar">extra_field_index</var> (in other words, the
+ <var class="Ar">extra_field_index</var><span class="No">'th</span> extra
+ field with ID <var class="Ar">extra_field_id</var>) The other arguments are
+ the same as for <code class="Fn">zip_file_extra_field_get</code>().</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, a pointer to an extra field is returned, or
<code class="Dv">NULL</code> if there is no extra field with that
<var class="Ar">extra_field_index</var> for the file with index
<var class="Ar">index</var>. In case of an error, <code class="Dv">NULL</code>
is returned and the error code in <var class="Ar">archive</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_extra_field_get</b>() and
- <b class="Fn">zip_file_extra_field_get_by_id</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_extra_field_get</code>() and
+ <code class="Fn">zip_file_extra_field_get_by_id</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_NOENT"><code class="Er" id="ZIP_ER_NOENT">ZIP_ER_NOENT</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>, or <var class="Ar">extra_field_index</var>
is not a valid extra file index (for ID
<var class="Ar">extra_field_id</var>).</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_extra_field_delete.html">zip_file_extra_field_delete(3)</a>,
<a class="Xr" href="zip_file_extra_field_set.html">zip_file_extra_field_set(3)</a>,
<a class="Xr" href="zip_file_extra_fields_count.html">zip_file_extra_fields_count(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_extra_field_get</b>() and
- <b class="Fn">zip_file_extra_field_get_by_id</b>() were added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_extra_field_get</code>() and
+ <code class="Fn">zip_file_extra_field_get_by_id</code>() were added in libzip
+ 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
<<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
-<h1 class="Sh" id="CAVEATS">CAVEATS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
Please note that the extra field IDs 0x0001 (ZIP64 extension), 0x6375 (Infozip
UTF-8 comment), and 0x7075 (Infozip UTF-8 file name) can not be read using
- <b class="Fn">zip_file_extra_field_get</b>() since they are used by
- <a class="Xr" href="libzip.html">libzip(3)</a> internally.</div>
+ <code class="Fn">zip_file_extra_field_get</code>() since they are used by
+ <a class="Xr" href="libzip.html">libzip(3)</a> internally.
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_extra_field_get.mdoc -- get extra field for file in zip
+.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_EXTRA_FIELD_GET" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_extra_field_set.mdoc -- set extra field for file in zip
+ Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_EXTRA_FIELD_SET(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_extra_field_set</b> — <span class="Nd">set extra
- field for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_extra_field_set</code> —
+<div class="Nd">set extra field for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_extra_field_set</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_id</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_index</var>, <var class="Fa" style="white-space: nowrap;">const
- zip_uint8_t *extra_field_data</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint16_t len</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_extra_field_set</b>() function sets the extra field
- with ID (two-byte signature) <var class="Ar">extra_field_id</var> and index
- <var class="Ar">extra_field_index</var> for the file at position
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_extra_field_set</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_id</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_index</var>, <var class="Fa" style="white-space: nowrap;">const
+ zip_uint8_t *extra_field_data</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint16_t len</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_extra_field_set</code>() function sets the extra
+ field with ID (two-byte signature) <var class="Ar">extra_field_id</var> and
+ index <var class="Ar">extra_field_index</var> for the file at position
<var class="Ar">index</var> in the zip archive. The extra field's data will be
set to <var class="Ar">extra_field_data</var> and length
<var class="Ar">len</var>. If a new entry shall be appended, set
<var class="Ar">extra_field_index</var> to
<code class="Dv">ZIP_EXTRA_FIELD_NEW</code>.
-<div class="Pp"></div>
-At least one of the following <var class="Ar">flags</var> must be set:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 16.00ex;">
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_CENTRAL</code></dt>
- <dd class="It-tag">Set extra field in the archive's central directory.</dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_LOCAL</code></dt>
- <dd class="It-tag">Set extra field in the local file headers.</dd>
+<p class="Pp">At least one of the following <var class="Ar">flags</var> must be
+ set:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_CENTRAL"><code class="Dv" id="ZIP_FL_CENTRAL">ZIP_FL_CENTRAL</code></a></dt>
+ <dd>Set extra field in the archive's central directory.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_LOCAL"><code class="Dv" id="ZIP_FL_LOCAL">ZIP_FL_LOCAL</code></a></dt>
+ <dd>Set extra field in the local file headers.</dd>
</dl>
</div>
-<div class="Pp"></div>
-Please note that the extra field IDs 0x0001 (ZIP64 extension), 0x6375 (Infozip
- UTF-8 comment), and 0x7075 (Infozip UTF-8 file name) can not be set using
- <b class="Fn">zip_file_extra_field_set</b>() since they are set by
- <a class="Xr" href="libzip.html">libzip(3)</a> automatically when needed.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">Please note that the extra field IDs 0x0001 (ZIP64 extension),
+ 0x6375 (Infozip UTF-8 comment), and 0x7075 (Infozip UTF-8 file name) can not
+ be set using <code class="Fn">zip_file_extra_field_set</code>() since they
+ are set by <a class="Xr" href="libzip.html">libzip(3)</a> automatically when
+ needed.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_extra_field_set</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">The extra field size is too large (ID and length need 4
- bytes; the maximum length of all extra fields for one file combined is
- 65536 bytes). This error also occurs if
- <var class="Ar">extra_field_index</var> is too large.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_extra_field_set</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd>The extra field size is too large (ID and length need 4 bytes; the maximum
+ length of all extra fields for one file combined is 65536 bytes). This
+ error also occurs if <var class="Ar">extra_field_index</var> is too
+ large.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOENT"><code class="Er" id="ZIP_ER_NOENT">ZIP_ER_NOENT</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_extra_field_delete.html">zip_file_extra_field_delete(3)</a>,
<a class="Xr" href="zip_file_extra_field_get.html">zip_file_extra_field_get(3)</a>,
<a class="Xr" href="zip_file_extra_fields_count.html">zip_file_extra_fields_count(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_extra_field_set</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_extra_field_set</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_extra_field_set.mdoc -- set extra field for file in zip
+.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_EXTRA_FIELD_SET" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_extra_fields_count.mdoc -- count extra field for file in zip
+ Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_EXTRA_FIELDS_COUNT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_extra_fields_count</b>,
- <b class="Nm">zip_file_extra_fields_count_by_id</b> —
- <span class="Nd">count extra fields for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_extra_fields_count</code>,
+ <code class="Nm">zip_file_extra_fields_count_by_id</code> —
+<div class="Nd">count extra fields for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int16_t</var>
-<br/>
-<b class="Fn">zip_file_extra_fields_count</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_int16_t</var>
-<br/>
-<b class="Fn">zip_file_extra_fields_count_by_id</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- extra_field_id</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_extra_fields_count</b>() function counts the extra
- fields for the file at position <var class="Ar">index</var> in the zip
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int16_t</var>
+ <br/>
+ <code class="Fn">zip_file_extra_fields_count</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+<p class="Pp"><var class="Ft">zip_int16_t</var>
+ <br/>
+ <code class="Fn">zip_file_extra_fields_count_by_id</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ extra_field_id</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_extra_fields_count</code>() function counts the
+ extra fields for the file at position <var class="Ar">index</var> in the zip
archive.
-<div class="Pp"></div>
-The following <var class="Ar">flags</var> are supported:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 16.00ex;">
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_CENTRAL</code></dt>
- <dd class="It-tag">Count extra fields from the archive's central
- directory.</dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_LOCAL</code></dt>
- <dd class="It-tag">Count extra fields from the local file headers.</dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -16.00ex;"><code class="Dv">ZIP_FL_UNCHANGED</code></dt>
- <dd class="It-tag">Count the original unchanged extra fields, ignoring any
- changes made.</dd>
+<p class="Pp">The following <var class="Ar">flags</var> are supported:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_CENTRAL"><code class="Dv" id="ZIP_FL_CENTRAL">ZIP_FL_CENTRAL</code></a></dt>
+ <dd>Count extra fields from the archive's central directory.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_LOCAL"><code class="Dv" id="ZIP_FL_LOCAL">ZIP_FL_LOCAL</code></a></dt>
+ <dd>Count extra fields from the local file headers.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_UNCHANGED"><code class="Dv" id="ZIP_FL_UNCHANGED">ZIP_FL_UNCHANGED</code></a></dt>
+ <dd>Count the original unchanged extra fields, ignoring any changes made.</dd>
</dl>
</div>
-<div class="Pp"></div>
-The <b class="Fn">zip_file_extra_fields_count_by_id</b>() function counts the
- extra fields with ID (two-byte signature)
- <var class="Ar">extra_field_id</var>. The other arguments are the same as for
- <b class="Fn">zip_file_extra_fields_count</b>().
-<div class="Pp"></div>
-Extra fields that are the same in the central directory and the local file
- header are merged into one. Therefore, the counts with
- <code class="Dv">ZIP_FL_CENTRAL</code> and
- <code class="Dv">ZIP_FL_LOCAL</code> do not need to add up to the same value
- as when given <code class="Dv">ZIP_FL_CENTRAL|ZIP_FL_LOCAL</code> at the same
- time.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The <code class="Fn">zip_file_extra_fields_count_by_id</code>()
+ function counts the extra fields with ID (two-byte signature)
+ <var class="Ar">extra_field_id</var>. The other arguments are the same as
+ for <code class="Fn">zip_file_extra_fields_count</code>().</p>
+<p class="Pp">Extra fields that are the same in the central directory and the
+ local file header are merged into one. Therefore, the counts with
+ <code class="Dv">ZIP_FL_CENTRAL</code> and
+ <code class="Dv">ZIP_FL_LOCAL</code> do not need to add up to the same value
+ as when given <code class="Dv">ZIP_FL_CENTRAL|ZIP_FL_LOCAL</code> at the
+ same time.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the requested number of extra fields is returned.
Otherwise, -1 is returned and the error code in <var class="Ar">archive</var>
is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_extra_fields_count</b>() and
- <b class="Fn">zip_file_extra_fields_count_by_id</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_extra_fields_count</code>() and
+ <code class="Fn">zip_file_extra_fields_count_by_id</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_NOENT"><code class="Er" id="ZIP_ER_NOENT">ZIP_ER_NOENT</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_extra_field_delete.html">zip_file_extra_field_delete(3)</a>,
<a class="Xr" href="zip_file_extra_field_get.html">zip_file_extra_field_get(3)</a>,
<a class="Xr" href="zip_file_extra_field_set.html">zip_file_extra_field_set(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_extra_fields_count</b>() and
- <b class="Fn">zip_file_extra_fields_count_by_id</b>() were added in libzip
- 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_extra_fields_count</code>() and
+ <code class="Fn">zip_file_extra_fields_count_by_id</code>() were added in
+ libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_extra_fields_count.mdoc -- count extra field for file in zip
+.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_EXTRA_FIELDS_COUNT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_get_comment.mdoc -- get comment for file in zip
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_GET_COMMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_get_comment</b> — <span class="Nd">get comment for
- file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_get_comment</code> —
+<div class="Nd">get comment for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_file_get_comment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
- *lenp</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_get_comment</b>() function returns the comment for
- the file at position <var class="Ar">index</var> in the zip archive. The name
- is in UTF-8 encoding unless <code class="Dv">ZIP_FL_ENC_RAW</code> was
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_file_get_comment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
+ *lenp</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_get_comment</code>() function returns the comment
+ for the file at position <var class="Ar">index</var> in the zip archive. The
+ name is in UTF-8 encoding unless <code class="Dv">ZIP_FL_ENC_RAW</code> was
specified (see below). This pointer should not be modified or
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/free.html">free(3)</a>'d, and becomes invalid when
<var class="Ar">archive</var> is closed. If <var class="Ar">lenp</var> is not
the length of the comment. If <var class="Ar">flags</var> is set to
<code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged comment is
returned.
-<div class="Pp"></div>
-Additionally, the following <var class="Ar">flags</var> are supported:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 19.00ex;">
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_RAW</code></dt>
- <dd class="It-tag">Return the unmodified comment as it is in the ZIP
- archive.</dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">(Default.) Guess the encoding of the comment in the ZIP
- archive and convert it to UTF-8, if necessary.</dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_STRICT</code></dt>
- <dd class="It-tag">Follow the ZIP specification for file names and extend it
- to file comments, expecting them to be encoded in CP-437 in the ZIP
- archive (except if it is a UTF-8 comment from the special extra field).
- Convert it to UTF-8.</dd>
+<p class="Pp">Additionally, the following <var class="Ar">flags</var> are
+ supported:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_ENC_RAW"><code class="Dv" id="ZIP_FL_ENC_RAW">ZIP_FL_ENC_RAW</code></a></dt>
+ <dd>Return the unmodified comment as it is in the ZIP archive.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>(Default.) Guess the encoding of the comment in the ZIP archive and
+ convert it to UTF-8, if necessary.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_STRICT"><code class="Dv" id="ZIP_FL_ENC_STRICT">ZIP_FL_ENC_STRICT</code></a></dt>
+ <dd>Follow the ZIP specification for file names and extend it to file
+ comments, expecting them to be encoded in CP-437 in the ZIP archive
+ (except if it is a UTF-8 comment from the special extra field). Convert it
+ to UTF-8.</dd>
</dl>
</div>
<i class="Em">Note</i>: ASCII is a subset of both CP-437 and UTF-8.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, a pointer to the comment is returned, or
<code class="Dv">NULL</code> if there is no comment. In case of an error,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_get_comment</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_get_comment</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a>,
<a class="Xr" href="zip_get_archive_comment.html">zip_get_archive_comment(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_get_comment</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_get_comment</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_get_comment.mdoc -- get comment for file in zip
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_GET_COMMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_get_error.mdoc -- extract zip_error from zip_file
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_GET_ERROR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_get_error</b> — <span class="Nd">extract zip_error
- from zip_file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_get_error</code> —
+<div class="Nd">extract zip_error from zip_file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_error_t *</var>
-<br/>
-<b class="Fn">zip_file_get_error</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *zf</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Fn">zip_file_get_error</b>() function returns the zip_error associated
- with the zip_file <var class="Ar">zf</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_error_t *</var>
+ <br/>
+ <code class="Fn">zip_file_get_error</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *zf</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Fn">zip_file_get_error</code>() function returns the zip_error
+ associated with the zip_file <var class="Ar">zf</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_get_error</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_get_error</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_get_error.mdoc -- extract zip_error from zip_file
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_GET_ERROR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_get_external_attributes.mdoc -- get external attributes for file in zip
+ Copyright (C) 2013-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_GET_EXTERNAL_ATTRIBUTES(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_get_external_attributes</b> — <span class="Nd">get
- external attributes for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_get_external_attributes</code> —
+<div class="Nd">get external attributes for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_get_external_attributes</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">zip_uint8_t
- *opsys</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
- *attributes</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_get_external_attributes</b>() function returns the
- operating system and external attributes for the file at position
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_get_external_attributes</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">zip_uint8_t
+ *opsys</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
+ *attributes</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_get_external_attributes</code>() function returns
+ the operating system and external attributes for the file at position
<var class="Ar">index</var> in the zip archive. The external attributes
usually contain the operating system-specific file permissions. If
<var class="Ar">flags</var> is set to
<code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged values are
returned. If <var class="Ar">opsys</var> or <var class="Ar">attributes</var>
are <code class="Dv">NULL</code>, they are not filled in.
-<div class="Pp"></div>
-The following operating systems are defined by the zip specification:
-<ul class="Bl-item" style="margin-left: 6.00ex;">
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_ACORN_RISC</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_ALTERNATE_MVS</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_AMIGA</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_ATARI_ST</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_BEOS</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_CPM</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_DOS</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_MACINTOSH</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_MVS</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_OPENVMS</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_OS_2</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_OS_400</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_OS_X</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_TANDEM</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_UNIX</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_VFAT</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_VM_CMS</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_VSE</code></li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_WINDOWS_NTFS</code>
+<p class="Pp">The following operating systems are defined by the zip
+ specification:</p>
+<ul class="Bl-item Bd-indent Bl-compact">
+ <li><a class="permalink" href="#ZIP_OPSYS_ACORN_RISC"><code class="Dv" id="ZIP_OPSYS_ACORN_RISC">ZIP_OPSYS_ACORN_RISC</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_ALTERNATE_MVS"><code class="Dv" id="ZIP_OPSYS_ALTERNATE_MVS">ZIP_OPSYS_ALTERNATE_MVS</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_AMIGA"><code class="Dv" id="ZIP_OPSYS_AMIGA">ZIP_OPSYS_AMIGA</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_ATARI_ST"><code class="Dv" id="ZIP_OPSYS_ATARI_ST">ZIP_OPSYS_ATARI_ST</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_BEOS"><code class="Dv" id="ZIP_OPSYS_BEOS">ZIP_OPSYS_BEOS</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_CPM"><code class="Dv" id="ZIP_OPSYS_CPM">ZIP_OPSYS_CPM</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_DOS"><code class="Dv" id="ZIP_OPSYS_DOS">ZIP_OPSYS_DOS</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_MACINTOSH"><code class="Dv" id="ZIP_OPSYS_MACINTOSH">ZIP_OPSYS_MACINTOSH</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_MVS"><code class="Dv" id="ZIP_OPSYS_MVS">ZIP_OPSYS_MVS</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_OPENVMS"><code class="Dv" id="ZIP_OPSYS_OPENVMS">ZIP_OPSYS_OPENVMS</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_OS_2"><code class="Dv" id="ZIP_OPSYS_OS_2">ZIP_OPSYS_OS_2</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_OS_400"><code class="Dv" id="ZIP_OPSYS_OS_400">ZIP_OPSYS_OS_400</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_OS_X"><code class="Dv" id="ZIP_OPSYS_OS_X">ZIP_OPSYS_OS_X</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_TANDEM"><code class="Dv" id="ZIP_OPSYS_TANDEM">ZIP_OPSYS_TANDEM</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_UNIX"><code class="Dv" id="ZIP_OPSYS_UNIX">ZIP_OPSYS_UNIX</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_VFAT"><code class="Dv" id="ZIP_OPSYS_VFAT">ZIP_OPSYS_VFAT</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_VM_CMS"><code class="Dv" id="ZIP_OPSYS_VM_CMS">ZIP_OPSYS_VM_CMS</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_VSE"><code class="Dv" id="ZIP_OPSYS_VSE">ZIP_OPSYS_VSE</code></a></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_WINDOWS_NTFS"><code class="Dv" id="ZIP_OPSYS_WINDOWS_NTFS">ZIP_OPSYS_WINDOWS_NTFS</code></a>
(uncommon, use <code class="Dv">ZIP_OPSYS_DOS</code> instead)</li>
- <li class="It-item" style="margin-top: 0.00em;"><code class="Dv">ZIP_OPSYS_Z_SYSTEM</code></li>
+ <li><a class="permalink" href="#ZIP_OPSYS_Z_SYSTEM"><code class="Dv" id="ZIP_OPSYS_Z_SYSTEM">ZIP_OPSYS_Z_SYSTEM</code></a></li>
</ul>
-<div class="Pp"></div>
-The defines above follow the PKWARE Inc. Appnote; please note that the InfoZIP
- Appnote has a slightly different mapping.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The defines above follow the PKWARE Inc. Appnote; please note that
+ the InfoZIP Appnote has a slightly different mapping.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, 0 is returned. In case of an error,
<code class="Dv">-1</code> is returned and the error code in
<var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="EXAMPLES">EXAMPLES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
The following code can be used to expand <var class="Ar">attributes</var> if the
operating system is <code class="Dv">ZIP_OPSYS_DOS</code>.
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 0.00ex;">
-<pre class="Li">
-#include <sys/stat.h>
-
-#define FA_RDONLY 0x01 // FILE_ATTRIBUTE_READONLY
-#define FA_DIREC 0x10 // FILE_ATTRIBUTE_DIRECTORY
-
-static mode_t
-_zip_dos_attr2mode(zip_uint32_t attr)
-{
- mode_t m = S_IRUSR | S_IRGRP | S_IROTH;
- if (0 == (attr & FA_RDONLY))
- m |= S_IWUSR | S_IWGRP | S_IWOTH;
-
- if (attr & FA_DIREC)
- m = (S_IFDIR | (m & ~S_IFMT)) | S_IXUSR | S_IXGRP | S_IXOTH;
-
- return m;
+<div class="Bd Pp">
+<pre>
+#include <sys/stat.h>
+
+#define FA_RDONLY 0x01 // FILE_ATTRIBUTE_READONLY
+#define FA_DIREC 0x10 // FILE_ATTRIBUTE_DIRECTORY
+
+static mode_t
+_zip_dos_attr2mode(zip_uint32_t attr)
+{
+ mode_t m = S_IRUSR | S_IRGRP | S_IROTH;
+ if (0 == (attr & FA_RDONLY))
+ m |= S_IWUSR | S_IWGRP | S_IWOTH;
+
+ if (attr & FA_DIREC)
+ m = (S_IFDIR | (m & ~S_IFMT)) | S_IXUSR | S_IXGRP | S_IXOTH;
+
+ return m;
}
</pre>
</div>
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_get_external_attributes</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_get_external_attributes</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_set_external_attributes.html">zip_file_set_external_attributes(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_get_external_attributes</b>() was added in libzip 0.11.2.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_get_external_attributes</code>() was added in libzip
+ 0.11.2.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_get_external_attributes.mdoc -- get external attributes for file in zip
+.\" Copyright (C) 2013-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_GET_EXTERNAL_ATTRIBUTES" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_rename.mdoc -- rename file in zip archive
+ Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_RENAME(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_rename</b> — <span class="Nd">rename file in zip
- archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_rename</code> —
+<div class="Nd">rename file in zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_rename</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">const char
- *name</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_rename</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *name</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
The file at position <var class="Ar">index</var> in the zip archive
<var class="Ar">archive</var> is renamed to <var class="Ar">name</var>. The
<var class="Ar">flags</var> argument can be any of:
-<dl class="Bl-tag" style="margin-left: 20.00ex;">
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">Guess encoding of <var class="Ar">name</var>
- (default).</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_UTF_8</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">name</var> as UTF-8.</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_CP437</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">name</var> as code page 437
- (CP-437).</dd>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>Guess encoding of <var class="Ar">name</var> (default).</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_UTF_8"><code class="Dv" id="ZIP_FL_ENC_UTF_8">ZIP_FL_ENC_UTF_8</code></a></dt>
+ <dd>Interpret <var class="Ar">name</var> as UTF-8.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_CP437"><code class="Dv" id="ZIP_FL_ENC_CP437">ZIP_FL_ENC_CP437</code></a></dt>
+ <dd>Interpret <var class="Ar">name</var> as code page 437 (CP-437).</dd>
</dl>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_rename</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_DELETED</code>]</dt>
- <dd class="It-tag">The file to be renamed has been deleted from the
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_rename</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_DELETED"><code class="Er" id="ZIP_ER_DELETED">ZIP_ER_DELETED</code></a>]</dt>
+ <dd>The file to be renamed has been deleted from the archive.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_EXISTS"><code class="Er" id="ZIP_ER_EXISTS">ZIP_ER_EXISTS</code></a>]</dt>
+ <dd>There is already a file called <var class="Ar">name</var> in the
archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
- <dd class="It-tag">There is already a file called <var class="Ar">name</var>
- in the archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>, <var class="Ar">name is</var>
<code class="Dv">NULL</code>, the empty string, or not a valid UTF-8
encoded string. Also a file cannot be renamed to a directory or vice
versa. Directories are denoted by a trailing slash.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_unchange.html">zip_unchange(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_rename</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_rename</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_rename.mdoc -- rename file in zip archive
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_RENAME" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
\fIarchive\fR
is set to indicate the error.
.SH "ERRORS"
-\fBzip_rename\fR()
+\fBzip_file_rename\fR()
fails if:
.TP 19n
[\fRZIP_ER_DELETED\fR]
.\" zip_file_rename.mdoc -- rename file in zip archive
-.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Ar archive
is set to indicate the error.
.Sh ERRORS
-.Fn zip_rename
+.Fn zip_file_rename
fails if:
.Bl -tag -width Er
.It Bq Er ZIP_ER_DELETED
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_set_comment.mdoc -- set comment for file in zip
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_SET_COMMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_set_comment</b> — <span class="Nd">set comment for
- file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_set_comment</code> —
+<div class="Nd">set comment for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_set_comment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">const char
- *comment</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- len</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_set_comment</b>() function sets the comment for the
- file at position <var class="Ar">index</var> in the zip archive to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_set_comment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *comment</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_set_comment</code>() function sets the comment for
+ the file at position <var class="Ar">index</var> in the zip archive to
<var class="Ar">comment</var> of length <var class="Ar">len</var>. If
<var class="Ar">comment</var> is <code class="Dv">NULL</code> and
<var class="Ar">len</var> is 0, the file comment will be removed. The
<var class="Ar">flags</var> argument can be any of:
-<dl class="Bl-tag" style="margin-left: 20.00ex;">
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">Guess encoding of <var class="Ar">comment</var>
- (default).</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_UTF_8</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">comment</var> as UTF-8.</dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;"><code class="Dv">ZIP_FL_ENC_CP437</code></dt>
- <dd class="It-tag">Interpret <var class="Ar">comment</var> as code page 437
- (CP-437).</dd>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>Guess encoding of <var class="Ar">comment</var> (default).</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_UTF_8"><code class="Dv" id="ZIP_FL_ENC_UTF_8">ZIP_FL_ENC_UTF_8</code></a></dt>
+ <dd>Interpret <var class="Ar">comment</var> as UTF-8.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_CP437"><code class="Dv" id="ZIP_FL_ENC_CP437">ZIP_FL_ENC_CP437</code></a></dt>
+ <dd>Interpret <var class="Ar">comment</var> as code page 437 (CP-437).</dd>
</dl>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_set_comment</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_set_comment</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>, or <var class="Ar">len</var> is less than 0
or longer than the maximum comment length in a zip file (65535), or
<var class="Ar">comment</var> is not a valid UTF-8 encoded string.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">The <var class="Ar">archive</var> was opened in read-only
- mode.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RDONLY"><code class="Er" id="ZIP_ER_RDONLY">ZIP_ER_RDONLY</code></a>]</dt>
+ <dd>The <var class="Ar">archive</var> was opened in read-only mode.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a>,
<a class="Xr" href="zip_get_archive_comment.html">zip_get_archive_comment(3)</a>,
<a class="Xr" href="zip_set_archive_comment.html">zip_set_archive_comment(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_set_comment</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_set_comment</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_set_comment.mdoc -- set comment for file in zip
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_SET_COMMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_set_encryption.mdoc -- set encryption method for file
+ Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_SET_ENCRYPTION(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_set_encryption</b> — <span class="Nd">set
- encryption method for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_set_encryption</code> —
+<div class="Nd">set encryption method for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_set_encryption</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- method</var>, <var class="Fa" style="white-space: nowrap;">const char
- *password</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_set_encryption</b>() function sets the encryption
- method for the file at position <var class="Ar">index</var> in the zip archive
- to <var class="Ar">method</var> using the password
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_set_encryption</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ method</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *password</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_set_encryption</code>() function sets the
+ encryption method for the file at position <var class="Ar">index</var> in the
+ zip archive to <var class="Ar">method</var> using the password
<var class="Ar">password</var>. The <var class="Ar">method</var> is the same
as returned by <a class="Xr" href="zip_stat.html">zip_stat(3)</a>. For the
<var class="Ar">method</var> argument, currently only the following values are
supported:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_EM_NONE</code></dt>
- <dd class="It-tag">No encryption.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_EM_AES_128</code></dt>
- <dd class="It-tag">Winzip AES-128 encryption.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_EM_AES_192</code></dt>
- <dd class="It-tag">Winzip AES-192 encryption.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_EM_AES_256</code></dt>
- <dd class="It-tag">Winzip AES-256 encryption.</dd>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_EM_NONE"><code class="Dv" id="ZIP_EM_NONE">ZIP_EM_NONE</code></a></dt>
+ <dd>No encryption.</dd>
+ <dt><a class="permalink" href="#ZIP_EM_AES_128"><code class="Dv" id="ZIP_EM_AES_128">ZIP_EM_AES_128</code></a></dt>
+ <dd>Winzip AES-128 encryption.</dd>
+ <dt><a class="permalink" href="#ZIP_EM_AES_192"><code class="Dv" id="ZIP_EM_AES_192">ZIP_EM_AES_192</code></a></dt>
+ <dd>Winzip AES-192 encryption.</dd>
+ <dt><a class="permalink" href="#ZIP_EM_AES_256"><code class="Dv" id="ZIP_EM_AES_256">ZIP_EM_AES_256</code></a></dt>
+ <dd>Winzip AES-256 encryption.</dd>
</dl>
-<div class="Pp"></div>
-If <var class="Ar">password</var> is <code class="Dv">NULL</code>, the default
- password provided by
- <a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>
- is used.
-<div class="Pp"></div>
-The current encryption method for a file in a zip archive can be determined
- using <a class="Xr" href="zip_stat.html">zip_stat(3)</a>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">If <var class="Ar">password</var> is <code class="Dv">NULL</code>,
+ the default password provided by
+ <a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>
+ is used.</p>
+<p class="Pp">The current encryption method for a file in a zip archive can be
+ determined using <a class="Xr" href="zip_stat.html">zip_stat(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_set_encryption</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_ENCRNOTSUPP</code>]</dt>
- <dd class="It-tag">Unsupported compression method requested.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_set_encryption</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_ENCRNOTSUPP"><code class="Er" id="ZIP_ER_ENCRNOTSUPP">ZIP_ER_ENCRNOTSUPP</code></a>]</dt>
+ <dd>Unsupported compression method requested.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>, or the argument combination is
invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">Read-only zip file, no changes allowed.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RDONLY"><code class="Er" id="ZIP_ER_RDONLY">ZIP_ER_RDONLY</code></a>]</dt>
+ <dd>Read-only zip file, no changes allowed.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>,
<a class="Xr" href="zip_stat.html">zip_stat(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_set_encryption</b>() was added in libzip 1.2.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_set_encryption</code>() was added in libzip 1.2.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_set_encryption.mdoc -- set encryption method for file
+.\" Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_SET_ENCRYPTION" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_set_external_attributes.mdoc -- set external attributes for file in zip
+ Copyright (C) 2013-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_SET_EXTERNAL_ATTRIBUTES(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_set_external_attributes</b> — <span class="Nd">set
- external attributes for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_set_external_attributes</code> —
+<div class="Nd">set external attributes for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_set_external_attributes</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">zip_uint8_t
- opsys</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
- attributes</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_set_external_attributes</b>() function sets the
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_set_external_attributes</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">zip_uint8_t
+ opsys</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
+ attributes</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_set_external_attributes</code>() function sets the
operating system and external attributes for the file at position
<var class="Ar">index</var> in the zip archive. Currently, no
<var class="Ar">flags</var> are supported.
-<div class="Pp"></div>
-For a list of known <var class="Ar">opsys</var> values, see
- <a class="Xr" href="zip_file_get_external_attributes.html">zip_file_get_external_attributes(3)</a>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">For a list of known <var class="Ar">opsys</var> values, see
+ <a class="Xr" href="zip_file_get_external_attributes.html">zip_file_get_external_attributes(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_set_external_attributes</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_set_external_attributes</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">The <var class="Ar">archive</var> was opened in read-only
- mode.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RDONLY"><code class="Er" id="ZIP_ER_RDONLY">ZIP_ER_RDONLY</code></a>]</dt>
+ <dd>The <var class="Ar">archive</var> was opened in read-only mode.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_get_external_attributes.html">zip_file_get_external_attributes(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_set_external_attributes</b>() was added in libzip 0.11.2.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_set_external_attributes</code>() was added in libzip
+ 0.11.2.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_set_external_attributes.mdoc -- set external attributes for file in zip
+.\" Copyright (C) 2013-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_SET_EXTERNAL_ATTRIBUTES" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_set_mtime.mdoc -- set mtime for file in zip
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_SET_MTIME(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_set_mtime</b> — <span class="Nd">set last
- modification time (mtime) for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_set_mtime</code> —
+<div class="Nd">set last modification time (mtime) for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_file_set_mtime</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">time_t mtime</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_file_set_mtime</b>() function sets the last modification
- time (mtime) for the file at position <var class="Ar">index</var> in the zip
- archive to <var class="Ar">mtime</var>. Currently, no support for any
- <var class="Ar">flags</var> is implemented.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_file_set_mtime</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">time_t
+ mtime</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_file_set_mtime</code>() function sets the last
+ modification time (mtime) for the file at position <var class="Ar">index</var>
+ in the zip archive to <var class="Ar">mtime</var>. Currently, no support for
+ any <var class="Ar">flags</var> is implemented.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_file_set_mtime</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_file_set_mtime</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">The <var class="Ar">archive</var> was opened in read-only
- mode.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RDONLY"><code class="Er" id="ZIP_ER_RDONLY">ZIP_ER_RDONLY</code></a>]</dt>
+ <dd>The <var class="Ar">archive</var> was opened in read-only mode.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_stat.html">zip_stat(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_set_mtime</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_set_mtime</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_set_mtime.mdoc -- set mtime for file in zip
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_SET_MTIME" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_file_strerror.mdoc -- get string representation for a zip error
+ Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FILE_STRERROR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_file_strerror</b>, <b class="Nm">zip_strerror</b> —
- <span class="Nd">get string representation for a zip error</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_file_strerror</code>, <code class="Nm">zip_strerror</code>
+ —
+<div class="Nd">get string representation for a zip error</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_file_strerror</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>);
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_strerror</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_strerror</b>() function returns a string describing the
- last error for the zip archive <var class="Ar">archive</var>, while the
- <b class="Fn">zip_file_strerror</b>() function does the same for a zip file
- <var class="Ar">file</var> (one file in an archive). The returned string must
- not be modified or freed, and becomes invalid when
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_file_strerror</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>);</p>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_strerror</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_strerror</code>() function returns a string describing
+ the last error for the zip archive <var class="Ar">archive</var>, while the
+ <code class="Fn">zip_file_strerror</code>() function does the same for a zip
+ file <var class="Ar">file</var> (one file in an archive). The returned string
+ must not be modified or freed, and becomes invalid when
<var class="Ar">archive</var> or <var class="Ar">file</var>, respectively, is
- closed or on the next call to <b class="Fn">zip_strerror</b>() or
- <b class="Fn">zip_file_strerror</b>(), respectively, for the same archive.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_file_strerror</b>() and <b class="Fn">zip_strerror</b>()
- return a pointer to the error string.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+ closed or on the next call to <code class="Fn">zip_strerror</code>() or
+ <code class="Fn">zip_file_strerror</code>(), respectively, for the same
+ archive.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_file_strerror</code>() and
+ <code class="Fn">zip_strerror</code>() return a pointer to the error string.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_error_to_str.html">zip_error_to_str(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_file_strerror</b>() and <b class="Fn">zip_strerror</b>() were
- added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+ <a class="Xr" href="zip_error_strerror.html">zip_error_strerror(3)</a>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_file_strerror</code>() and
+ <code class="Fn">zip_strerror</code>() were added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_file_strerror.mdoc -- get string representation for a zip error
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FILE_STRERROR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
return a pointer to the error string.
.SH "SEE ALSO"
libzip(3),
-zip_error_to_str(3)
+zip_error_strerror(3)
.SH "HISTORY"
\fBzip_file_strerror\fR()
and
.\" zip_file_strerror.mdoc -- get string representation for a zip error
-.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
return a pointer to the error string.
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_error_to_str 3
+.Xr zip_error_strerror 3
.Sh HISTORY
.Fn zip_file_strerror
and
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_fopen.mdoc -- open file in zip archive for reading
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FOPEN(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_fopen</b>, <b class="Nm">zip_fopen_index</b> —
- <span class="Nd">open file in zip archive for reading</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_fopen</code>, <code class="Nm">zip_fopen_index</code>
+ —
+<div class="Nd">open file in zip archive for reading</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_file_t *</var>
-<br/>
-<b class="Fn">zip_fopen</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_file_t *</var>
-<br/>
-<b class="Fn">zip_fopen_index</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_fopen</b>() function opens the file name
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_file_t *</var>
+ <br/>
+ <code class="Fn">zip_fopen</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+<p class="Pp"><var class="Ft">zip_file_t *</var>
+ <br/>
+ <code class="Fn">zip_fopen_index</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_fopen</code>() function opens the file name
<var class="Ar">fname</var> in <var class="Ar">archive</var>. The
<var class="Ar">flags</var> argument specifies how the name lookup should be
done, according to the values are described in
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>. Also, the
following values may be <i class="Em">or</i><span class="No">'ed</span> to it.
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_FL_COMPRESSED</code></dt>
- <dd class="It-tag">Read the compressed data. Otherwise the data is
- uncompressed by <b class="Fn">zip_fread</b>().</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_FL_UNCHANGED</code></dt>
- <dd class="It-tag">Read the original data from the zip archive, ignoring any
- changes made to the file.</dd>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_COMPRESSED"><code class="Dv" id="ZIP_FL_COMPRESSED">ZIP_FL_COMPRESSED</code></a></dt>
+ <dd>Read the compressed data. Otherwise the data is uncompressed by
+ <code class="Fn">zip_fread</code>().</dd>
+ <dt><a class="permalink" href="#ZIP_FL_UNCHANGED"><code class="Dv" id="ZIP_FL_UNCHANGED">ZIP_FL_UNCHANGED</code></a></dt>
+ <dd>Read the original data from the zip archive, ignoring any changes made to
+ the file.</dd>
</dl>
</div>
-<div class="Pp"></div>
-The <b class="Fn">zip_fopen_index</b>() function opens the file at position
- <var class="Ar">index</var>.
-<div class="Pp"></div>
-If encrypted data is encountered, the functions call
- <a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a> or
- <a class="Xr" href="zip_fopen_index_encrypted.html">zip_fopen_index_encrypted(3)</a>
- respectively, using the default password set with
- <a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The <code class="Fn">zip_fopen_index</code>() function opens the
+ file at position <var class="Ar">index</var>.</p>
+<p class="Pp">If encrypted data is encountered, the functions call
+ <a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a> or
+ <a class="Xr" href="zip_fopen_index_encrypted.html">zip_fopen_index_encrypted(3)</a>
+ respectively, using the default password set with
+ <a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, a <var class="Ft">struct zip_file</var> pointer is
returned. Otherwise, <code class="Dv">NULL</code> is returned and the error
code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_CHANGED</code>]</dt>
- <dd class="It-tag">The file data has been changed.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_COMPNOTSUPP</code>]</dt>
- <dd class="It-tag">The compression method used is not supported.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_ENCRNOTSUPP</code>]</dt>
- <dd class="It-tag">The encryption method used is not supported.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOPASSWD</code>]</dt>
- <dd class="It-tag">The file is encrypted, but no password has been
- provided.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_READ</code>]</dt>
- <dd class="It-tag">A file read error occurred.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_SEEK</code>]</dt>
- <dd class="It-tag">A file seek error occurred.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_WRONGPASSWD</code>]</dt>
- <dd class="It-tag">The provided password does not match the password used for
- encryption. Note that some incorrect passwords are not detected by the
- check done by <b class="Fn">zip_fopen</b>().</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_ZLIB</code>]</dt>
- <dd class="It-tag">Initializing the zlib stream failed.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_CHANGED"><code class="Er" id="ZIP_ER_CHANGED">ZIP_ER_CHANGED</code></a>]</dt>
+ <dd>The file data has been changed.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_COMPNOTSUPP"><code class="Er" id="ZIP_ER_COMPNOTSUPP">ZIP_ER_COMPNOTSUPP</code></a>]</dt>
+ <dd>The compression method used is not supported.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_ENCRNOTSUPP"><code class="Er" id="ZIP_ER_ENCRNOTSUPP">ZIP_ER_ENCRNOTSUPP</code></a>]</dt>
+ <dd>The encryption method used is not supported.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOPASSWD"><code class="Er" id="ZIP_ER_NOPASSWD">ZIP_ER_NOPASSWD</code></a>]</dt>
+ <dd>The file is encrypted, but no password has been provided.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_READ"><code class="Er" id="ZIP_ER_READ">ZIP_ER_READ</code></a>]</dt>
+ <dd>A file read error occurred.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_SEEK"><code class="Er" id="ZIP_ER_SEEK">ZIP_ER_SEEK</code></a>]</dt>
+ <dd>A file seek error occurred.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_WRONGPASSWD"><code class="Er" id="ZIP_ER_WRONGPASSWD">ZIP_ER_WRONGPASSWD</code></a>]</dt>
+ <dd>The provided password does not match the password used for encryption.
+ Note that some incorrect passwords are not detected by the check done by
+ <code class="Fn">zip_fopen</code>().</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_ZLIB"><code class="Er" id="ZIP_ER_ZLIB">ZIP_ER_ZLIB</code></a>]</dt>
+ <dd>Initializing the zlib stream failed.</dd>
</dl>
-<div class="Pp"></div>
-The function <b class="Fn">zip_fopen</b>() may also fail and set
- <var class="Va">zip_err</var> for any of the errors specified for the routine
- <a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>.
-<div class="Pp"></div>
-The function <b class="Fn">zip_fopen_index</b>() may also fail with
- <code class="Er">ZIP_ER_INVAL</code> if <var class="Ar">index</var> is
- invalid.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+<p class="Pp">The function <code class="Fn">zip_fopen</code>() may also fail and
+ set <var class="Va">zip_err</var> for any of the errors specified for the
+ routine
+ <a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>.</p>
+<p class="Pp">The function <code class="Fn">zip_fopen_index</code>() may also
+ fail with <code class="Er">ZIP_ER_INVAL</code> if
+ <var class="Ar">index</var> is invalid.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fclose.html">zip_fclose(3)</a>,
<a class="Xr" href="zip_fread.html">zip_fread(3)</a>,
<a class="Xr" href="zip_get_num_entries.html">zip_get_num_entries(3)</a>,
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>,
<a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_fopen</b>() and <b class="Fn">zip_fopen_index</b>() were added
- in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_fopen</code>() and
+ <code class="Fn">zip_fopen_index</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_fopen.mdoc -- open file in zip archive for reading
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FOPEN" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_fopen_encrypted.mdoc -- open encrypted file in zip archive for reading
+ Copyright (C) 2011-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FOPEN_ENCRYPTED(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_fopen_encrypted</b>,
- <b class="Nm">zip_fopen_index_encrypted</b> — <span class="Nd">open
- encrypted file in zip archive for reading</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_fopen_encrypted</code>,
+ <code class="Nm">zip_fopen_index_encrypted</code> —
+<div class="Nd">open encrypted file in zip archive for reading</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_file_t *</var>
-<br/>
-<b class="Fn">zip_fopen_encrypted</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">const char
- *password</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_file_t *</var>
-<br/>
-<b class="Fn">zip_fopen_index_encrypted</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">const char
- *password</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_fopen_encrypted</b>() function opens the encrypted file
- name <var class="Ar">fname</var> in <var class="Ar">archive</var> using the
- password given in the <var class="Ar">password</var> argument. The
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_file_t *</var>
+ <br/>
+ <code class="Fn">zip_fopen_encrypted</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *password</var>);</p>
+<p class="Pp"><var class="Ft">zip_file_t *</var>
+ <br/>
+ <code class="Fn">zip_fopen_index_encrypted</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *password</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_fopen_encrypted</code>() function opens the encrypted
+ file name <var class="Ar">fname</var> in <var class="Ar">archive</var> using
+ the password given in the <var class="Ar">password</var> argument. The
<var class="Ar">flags</var> argument are the same as for
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>.
-<div class="Pp"></div>
-The <b class="Fn">zip_fopen_index_encrypted</b>() function opens the file at
- position <var class="Ar">index</var>, see
- <a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a>. These
- functions are called automatically by
- <a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>; you only need to call
- them if you want to specify a non-default password (see
- <a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>).
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The <code class="Fn">zip_fopen_index_encrypted</code>() function
+ opens the file at position <var class="Ar">index</var>, see
+ <a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a>. These
+ functions are called automatically by
+ <a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>; you only need to call
+ them if you want to specify a non-default password (see
+ <a class="Xr" href="zip_set_default_password.html">zip_set_default_password(3)</a>).</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, a <var class="Ft">struct zip_file</var> pointer is
returned. Otherwise, <code class="Dv">NULL</code> is returned and the error
code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<dl class="Bl-tag" style="margin-left: 20.00ex;">
- <dt class="It-tag" style="margin-left: -20.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -20.00ex;">[<code class="Er">ZIP_ER_NOPASSWD</code>]</dt>
- <dd class="It-tag">No password was provided.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_NOPASSWD"><code class="Er" id="ZIP_ER_NOPASSWD">ZIP_ER_NOPASSWD</code></a>]</dt>
+ <dd>No password was provided.</dd>
</dl>
-<div class="Pp"></div>
-The function <b class="Fn">zip_fopen_encrypted</b>() may also fail and set
- <var class="Va">zip_err</var> for any of the errors specified for the routine
- <a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>.
-<div class="Pp"></div>
-The function <b class="Fn">zip_fopen_index_encrypted</b>() may also fail and set
- <var class="Va">zip_err</var> for any of the errors specified for the routine
- <a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+<p class="Pp">The function <code class="Fn">zip_fopen_encrypted</code>() may
+ also fail and set <var class="Va">zip_err</var> for any of the errors
+ specified for the routine
+ <a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>.</p>
+<p class="Pp">The function <code class="Fn">zip_fopen_index_encrypted</code>()
+ may also fail and set <var class="Va">zip_err</var> for any of the errors
+ specified for the routine
+ <a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fclose.html">zip_fclose(3)</a>,
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>,
<a class="Xr" href="zip_fread.html">zip_fread(3)</a>,
<a class="Xr" href="zip_get_num_entries.html">zip_get_num_entries(3)</a>,
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_fopen_encrypted</b>() and
- <b class="Fn">zip_fopen_index_encrypted</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_fopen_encrypted</code>() and
+ <code class="Fn">zip_fopen_index_encrypted</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_fopen_encrypted.mdoc -- open encrypted file in zip archive for reading
+.\" Copyright (C) 2011-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FOPEN_ENCRYPTED" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_fread.mdoc -- read from file
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FREAD(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_fread</b> — <span class="Nd">read from file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_fread</code> —
+<div class="Nd">read from file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_fread</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>, <var class="Fa" style="white-space: nowrap;">void *buf</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint64_t nbytes</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_fread</b>() function reads at most
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_fread</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>, <var class="Fa" style="white-space: nowrap;">void *buf</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint64_t nbytes</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_fread</code>() function reads at most
<var class="Ar">nbytes</var> bytes from <var class="Ar">file</var> into
<var class="Ar">buf</var>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
If successful, the number of bytes actually read is returned. Otherwise, -1 is
returned.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fclose.html">zip_fclose(3)</a>,
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>,
<a class="Xr" href="zip_fseek.html">zip_fseek(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_fread</b>() was added in libzip 0.6. In libzip 0.10 the return
- type was changed from <var class="Vt">ssize_t</var> to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_fread</code>() was added in libzip 0.6. In libzip 0.10 the
+ return type was changed from <var class="Vt">ssize_t</var> to
<var class="Vt">zip_int64_t</var>. In libzip 0.10 the type of
<var class="Ar">nbytes</var> was changed from <var class="Vt">size_t</var> to
<var class="Vt">zip_uint64_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_fread.mdoc -- read from file
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FREAD" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_fseek.mdoc -- seek in file
+ Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FSEEK(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_fseek</b> — <span class="Nd">seek in file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_fseek</code> —
+<div class="Nd">seek in file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int8_t</var>
-<br/>
-<b class="Fn">zip_fseek</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- offset</var>, <var class="Fa" style="white-space: nowrap;">int whence</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_fseek</b>() function seeks to the specified
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int8_t</var>
+ <br/>
+ <code class="Fn">zip_fseek</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ offset</var>, <var class="Fa" style="white-space: nowrap;">int
+ whence</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_fseek</code>() function seeks to the specified
<var class="Ar">offset</var> relative to <var class="Ar">whence</var>, just
like <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/fseek.html">fseek(3)</a>.
-<div class="Pp"></div>
-<b class="Nm">zip_fseek</b> only works on uncompressed (stored) data. When
- called on compressed data it will return an error.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-If successful, <b class="Nm">zip_fseek</b> returns 0. Otherwise, -1 is returned.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+<p class="Pp"><code class="Nm">zip_fseek</code> only works on uncompressed
+ (stored) data. When called on compressed data it will return an error.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+If successful, <code class="Nm">zip_fseek</code> returns 0. Otherwise, -1 is
+ returned.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fclose.html">zip_fclose(3)</a>,
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>,
<a class="Xr" href="zip_fread.html">zip_fread(3)</a>,
<a class="Xr" href="zip_ftell.html">zip_ftell(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_fseek</b>() was added in libzip 1.2.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_fseek</code>() was added in libzip 1.2.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_fseek.mdoc -- seek in file
+.\" Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FSEEK" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_ftell.mdoc -- tell position in file
+ Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_FTELL(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_ftell</b> — <span class="Nd">tell position in
- file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_ftell</code> —
+<div class="Nd">tell position in file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_ftell</b>(<var class="Fa" style="white-space: nowrap;">zip_file_t
- *file</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_ftell</b>() function reports the current offset in the
- file.
-<div class="Pp"></div>
-<b class="Nm">zip_ftell</b> only works on uncompressed (stored) data. When
- called on compressed data it will return an error.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-If successful, <b class="Nm">zip_ftell</b> returns the current file position.
- Otherwise, -1 is returned.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_ftell</code>(<var class="Fa" style="white-space: nowrap;">zip_file_t
+ *file</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_ftell</code>() function reports the current offset in
+ the file.
+<p class="Pp"><code class="Nm">zip_ftell</code> only works on uncompressed
+ (stored) data. When called on compressed data it will return an error.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+If successful, <code class="Nm">zip_ftell</code> returns the current file
+ position. Otherwise, -1 is returned.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fclose.html">zip_fclose(3)</a>,
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>,
<a class="Xr" href="zip_fread.html">zip_fread(3)</a>,
<a class="Xr" href="zip_fseek.html">zip_fseek(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_ftell</b>() was added in libzip 1.2.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_ftell</code>() was added in libzip 1.2.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_ftell.mdoc -- tell position in file
+.\" Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_FTELL" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_archive_comment.mdoc -- get zip archive comment
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_ARCHIVE_COMMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_archive_comment</b> — <span class="Nd">get zip
- archive comment</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_archive_comment</code> —
+<div class="Nd">get zip archive comment</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_get_archive_comment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">int *lenp</var>,
- <var class="Fa" style="white-space: nowrap;">zip_flags_t flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_get_archive_comment</b>() function returns the comment for
- the entire zip archive. The name is in UTF-8 encoding unless
- <code class="Dv">ZIP_FL_ENC_RAW</code> was specified (see below). This pointer
- should not be modified or <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/free.html">free(3)</a>'d, and
- becomes invalid when <var class="Ar">archive</var> is closed. If
- <var class="Ar">lenp</var> is not <code class="Dv">NULL</code>, the integer to
- which it points will be set to the length of the comment. If
- <var class="Ar">flags</var> is set to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_get_archive_comment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">int
+ *lenp</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_get_archive_comment</code>() function returns the
+ comment for the entire zip archive. The return value is in UTF-8 encoding
+ unless <code class="Dv">ZIP_FL_ENC_RAW</code> was specified (see below). This
+ pointer should not be modified or
+ <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/free.html">free(3)</a>'d, and becomes invalid when
+ <var class="Ar">archive</var> is closed. If <var class="Ar">lenp</var> is not
+ <code class="Dv">NULL</code>, the integer to which it points will be set to
+ the length of the comment. If <var class="Ar">flags</var> is set to
<code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged comment is
returned.
-<div class="Pp"></div>
-Additionally, the following <var class="Ar">flags</var> are supported:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 19.00ex;">
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_RAW</code></dt>
- <dd class="It-tag">Return the unmodified archive comment as it is in the ZIP
- archive.</dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">(Default.) Guess the encoding of the archive comment in the
- ZIP archive and convert it to UTF-8, if necessary.</dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_STRICT</code></dt>
- <dd class="It-tag">Follow the ZIP specification for file names and extend it
- to the archive comment, thus also expecting it in CP-437 encoding. Convert
- it to UTF-8.</dd>
+<p class="Pp">Additionally, the following <var class="Ar">flags</var> are
+ supported:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_ENC_RAW"><code class="Dv" id="ZIP_FL_ENC_RAW">ZIP_FL_ENC_RAW</code></a></dt>
+ <dd>Return the unmodified archive comment as it is in the ZIP archive.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>(Default.) Guess the encoding of the archive comment in the ZIP archive
+ and convert it to UTF-8, if necessary.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_STRICT"><code class="Dv" id="ZIP_FL_ENC_STRICT">ZIP_FL_ENC_STRICT</code></a></dt>
+ <dd>Follow the ZIP specification for file names and extend it to the archive
+ comment, thus also expecting it in CP-437 encoding. Convert it to
+ UTF-8.</dd>
</dl>
</div>
<i class="Em">Note</i>: ASCII is a subset of both CP-437 and UTF-8.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, a pointer to the comment is returned, or
<code class="Dv">NULL</code> if there is no comment.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_get_file_comment.html">zip_get_file_comment(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_archive_comment</b>() was added in libzip 0.7. In libzip
- 0.11 the type of <var class="Ar">flags</var> was changed from
+ <a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_archive_comment</code>() was added in libzip 0.7. In
+ libzip 0.11 the type of <var class="Ar">flags</var> was changed from
<var class="Vt">int</var> to <var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
- <td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-date">July 22, 2018</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
-.TH "ZIP_GET_ARCHIVE_COMMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_archive_comment.mdoc -- get zip archive comment
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.TH "ZIP_GET_ARCHIVE_COMMENT" "3" "July 22, 2018" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.SH "NAME"
The
\fBzip_get_archive_comment\fR()
function returns the comment for the entire zip archive.
-The name is in UTF-8 encoding unless
+The return value is in UTF-8 encoding unless
\fRZIP_FL_ENC_RAW\fR
was specified (see below).
This pointer should not be modified or
if there is no comment.
.SH "SEE ALSO"
libzip(3),
-zip_get_file_comment(3)
+zip_file_get_comment(3)
.SH "HISTORY"
\fBzip_get_archive_comment\fR()
was added in libzip 0.7.
.\" zip_get_archive_comment.mdoc -- get zip archive comment
-.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd December 18, 2017
+.Dd July 22, 2018
.Dt ZIP_GET_ARCHIVE_COMMENT 3
.Os
.Sh NAME
The
.Fn zip_get_archive_comment
function returns the comment for the entire zip archive.
-The name is in UTF-8 encoding unless
+The return value is in UTF-8 encoding unless
.Dv ZIP_FL_ENC_RAW
was specified (see below).
This pointer should not be modified or
.\" is set to indicate the error.
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_get_file_comment 3
+.Xr zip_file_get_comment 3
.Sh HISTORY
.Fn zip_get_archive_comment
was added in libzip 0.7.
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_archive_flag.mdoc -- get comment for file in zip
+ Copyright (C) 2008-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_ARCHIVE_FLAG(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_archive_flag</b> — <span class="Nd">get status flags
- for zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_archive_flag</code> —
+<div class="Nd">get status flags for zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_get_archive_flag</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flag</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_get_archive_flag</b>() function returns if the flag
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_get_archive_flag</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flag</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_get_archive_flag</code>() function returns if the flag
<var class="Ar">flag</var> is set for the archive
<var class="Ar">archive</var>. The archive flags might have been changed with
- <b class="Fn">zip_set_archive_flag</b>(); if <var class="Ar">flags</var> is
- set to <code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged flags
- are tested.
-<div class="Pp"></div>
-Supported flags are:
-<dl class="Bl-tag" style="margin-left: 18.00ex;">
- <dt class="It-tag" style="margin-left: -18.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -18.00ex;"><code class="Dv">ZIP_AFL_RDONLY</code></dt>
- <dd class="It-tag">The archive is read-only.</dd>
+ <code class="Fn">zip_set_archive_flag</code>(); if <var class="Ar">flags</var>
+ is set to <code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged
+ flags are tested.
+<p class="Pp">Supported flags are:</p>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_AFL_RDONLY"><code class="Dv" id="ZIP_AFL_RDONLY">ZIP_AFL_RDONLY</code></a></dt>
+ <dd>The archive is read-only.</dd>
</dl>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_get_archive_flag</b>() returns 1 if <var class="Ar">flag</var>
- is set for <var class="Ar">archive</var>, 0 if not, and -1 if an error
- occurred.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_get_archive_flag</code>() returns 1 if
+ <var class="Ar">flag</var> is set for <var class="Ar">archive</var>, 0 if not,
+ and -1 if an error occurred.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_set_archive_flag.html">zip_set_archive_flag(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_archive_flag</b>() was added in libzip 0.9. In libzip 0.11
- the type of <var class="Ar">flag</var> was changed from
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_archive_flag</code>() was added in libzip 0.9. In
+ libzip 0.11 the type of <var class="Ar">flag</var> was changed from
<var class="Vt">int</var> to <var class="Vt">zip_flags_t m</var> and the type
of <var class="Ar">flags</var> was changed from <var class="Vt">int</var> to
<var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_archive_flag.mdoc -- get comment for file in zip
+.\" Copyright (C) 2008-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_GET_ARCHIVE_FLAG" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_error.mdoc -- get zip_error for archive
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_ERROR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_error</b> — <span class="Nd">get zip error for
- archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_error</code> —
+<div class="Nd">get zip error for archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_error_t *</var>
-<br/>
-<b class="Fn">zip_get_error</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_get_error</b>() function returns the zip error for the zip
- archive <var class="Ar">archive</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_error_t *</var>
+ <br/>
+ <code class="Fn">zip_get_error</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_get_error</code>() function returns the zip error for
+ the zip archive <var class="Ar">archive</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_code_system.html">zip_error_code_system(3)</a>,
<a class="Xr" href="zip_error_code_zip.html">zip_error_code_zip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_error</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_error</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_error.mdoc -- get zip_error for archive
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_GET_ERROR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_file_comment.mdoc -- get comment for file in zip
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_FILE_COMMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_file_comment</b> — <span class="Nd">get comment for
- file in zip (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_file_comment</code> —
+<div class="Nd">get comment for file in zip (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_get_file_comment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">int *lenp</var>,
- <var class="Fa" style="white-space: nowrap;">int flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_get_file_comment</b>() function is the obsolete version of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_get_file_comment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">int *lenp</var>,
+ <var class="Fa" style="white-space: nowrap;">int flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_get_file_comment</code>() function is the obsolete
+ version of
<a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a>.
The only differences are the types of the <var class="Ar">lenp</var> and
<var class="Ar">flags</var> arguments.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_file_comment</b>() was added in libzip 0.7. In libzip 0.10
- the type of <var class="Ar">index</var> was changed from
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_file_comment</code>() was added in libzip 0.7. In
+ libzip 0.10 the type of <var class="Ar">index</var> was changed from
<var class="Vt">int</var> to <var class="Vt">zip_uint64_t</var>. It was
- deprecated in libzip 0.11, use <b class="Fn">zip_file_get_comment</b>()
+ deprecated in libzip 0.11, use <code class="Fn">zip_file_get_comment</code>()
instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_file_comment.mdoc -- get comment for file in zip
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_GET_FILE_COMMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_name.mdoc -- get name of file by index
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_NAME(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_name</b> — <span class="Nd">get name of file by
- index</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_name</code> —
+<div class="Nd">get name of file by index</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">const char *</var>
-<br/>
-<b class="Fn">zip_get_name</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_get_name</b>() function returns the name of the file at
- position <var class="Ar">index</var> in <var class="Ar">archive</var>. The
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">const char *</var>
+ <br/>
+ <code class="Fn">zip_get_name</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_get_name</code>() function returns the name of the file
+ at position <var class="Ar">index</var> in <var class="Ar">archive</var>. The
name is in UTF-8 encoding unless <code class="Dv">ZIP_FL_ENC_RAW</code> was
specified (see below).
-<div class="Pp"></div>
-If <var class="Ar">flags</var> is set to
- <code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged filename is
- returned. The returned string must not be modified or freed, and becomes
- invalid when <var class="Ar">archive</var> is closed.
-<div class="Pp"></div>
-Additionally, the following <var class="Ar">flags</var> are supported:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 19.00ex;">
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_RAW</code></dt>
- <dd class="It-tag">Return the unmodified names as it is in the ZIP
- archive.</dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">(Default.) Guess the encoding of the name in the ZIP
- archive and convert it to UTF-8, if necessary.</dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -19.00ex;"><code class="Dv">ZIP_FL_ENC_STRICT</code></dt>
- <dd class="It-tag">Follow the ZIP specification and expect CP-437 encoded
- names in the ZIP archive (except if they are explicitly marked as UTF-8).
- Convert it to UTF-8.</dd>
+<p class="Pp">If <var class="Ar">flags</var> is set to
+ <code class="Dv">ZIP_FL_UNCHANGED</code>, the original unchanged filename is
+ returned. The returned string must not be modified or freed, and becomes
+ invalid when <var class="Ar">archive</var> is closed.</p>
+<p class="Pp">Additionally, the following <var class="Ar">flags</var> are
+ supported:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_ENC_RAW"><code class="Dv" id="ZIP_FL_ENC_RAW">ZIP_FL_ENC_RAW</code></a></dt>
+ <dd>Return the unmodified names as it is in the ZIP archive.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>(Default.) Guess the encoding of the name in the ZIP archive and convert
+ it to UTF-8, if necessary.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_STRICT"><code class="Dv" id="ZIP_FL_ENC_STRICT">ZIP_FL_ENC_STRICT</code></a></dt>
+ <dd>Follow the ZIP specification and expect CP-437 encoded names in the ZIP
+ archive (except if they are explicitly marked as UTF-8). Convert it to
+ UTF-8.</dd>
</dl>
</div>
<i class="Em">Note</i>: ASCII is a subset of both CP-437 and UTF-8.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, a pointer to the name is returned. Otherwise,
<code class="Dv">NULL</code> and the error code in
<var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_get_name</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_DELETED</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> refers to a file that has been
- deleted (see <a class="Xr" href="zip_delete.html">zip_delete(3)</a>).</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_get_name</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_DELETED"><code class="Er" id="ZIP_ER_DELETED">ZIP_ER_DELETED</code></a>]</dt>
+ <dd><var class="Ar">index</var> refers to a file that has been deleted (see
+ <a class="Xr" href="zip_delete.html">zip_delete(3)</a>).</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>, or <var class="Ar">index</var> points to an
added file and <code class="Dv">ZIP_FL_UNCHANGED</code> is set.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_name</b>() was added in libzip 0.6. In libzip 0.10 the
- type of <var class="Ar">index</var> was changed from <var class="Vt">int</var>
- to <var class="Vt">zip_uint64_t</var>. In libzip 0.11 the type of
- <var class="Ar">flags</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_name</code>() was added in libzip 0.6. In libzip 0.10
+ the type of <var class="Ar">index</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_uint64_t</var>. In libzip
+ 0.11 the type of <var class="Ar">flags</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_flags_t</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_name.mdoc -- get name of file by index
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_GET_NAME" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_num_entries.mdoc -- get number of files in archive
+ Copyright (C) 2011-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_NUM_ENTRIES(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_num_entries</b> — <span class="Nd">get number of
- files in archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_num_entries</code> —
+<div class="Nd">get number of files in archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_get_num_entries</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_get_num_entries</b>() function returns the number of files
- in <var class="Ar">archive</var>. If <var class="Ar">flags</var> is set to
- <code class="Dv">ZIP_FL_UNCHANGED</code>, the original number of entries is
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_get_num_entries</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_get_num_entries</code>() function returns the number of
+ files in <var class="Ar">archive</var>. If <var class="Ar">flags</var> is set
+ to <code class="Dv">ZIP_FL_UNCHANGED</code>, the original number of entries is
returned.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_get_num_entries</b>() returns the number of files in the zip
- archive, or -1 if <var class="Ar">archive</var> is
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_get_num_entries</code>() returns the number of files in the
+ zip archive, or -1 if <var class="Ar">archive</var> is
<code class="Dv">NULL</code>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a>,
<a class="Xr" href="zip_stat_index.html">zip_stat_index(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_num_entries</b>() was added in libzip 0.10. In libzip 0.11
- the return type was changed from <var class="Vt">zip_uint64_t</var> to
- <var class="Vt">zip_int64_t</var>. In libzip 0.11 the type of
- <var class="Ar">flags</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_num_entries</code>() was added in libzip 0.10. In
+ libzip 0.11 the return type was changed from
+ <var class="Vt">zip_uint64_t</var> to <var class="Vt">zip_int64_t</var>. In
+ libzip 0.11 the type of <var class="Ar">flags</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_flags_t</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_num_entries.mdoc -- get number of files in archive
+.\" Copyright (C) 2011-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_GET_NUM_ENTRIES" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_get_num_files.mdoc -- get number of files in archive
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_GET_NUM_FILES(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_get_num_files</b> — <span class="Nd">get number of files
- in archive (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_get_num_files</code> —
+<div class="Nd">get number of files in archive (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_get_num_files</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_get_num_files</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<i class="Em">This function is deprecated</i>. <i class="Em">Use</i>
<a class="Xr" href="zip_get_num_entries.html">zip_get_num_entries(3)</a>
<i class="Em">instead</i>.
-<div class="Pp"></div>
-The <b class="Fn">zip_get_num_files</b>() function returns the number of files
- in <var class="Ar">archive</var>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_get_num_files</b>() returns the number of files in the zip
- archive, or -1 if <var class="Ar">archive</var> is
+<p class="Pp">The <code class="Fn">zip_get_num_files</code>() function returns
+ the number of files in <var class="Ar">archive</var>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_get_num_files</code>() returns the number of files in the
+ zip archive, or -1 if <var class="Ar">archive</var> is
<code class="Dv">NULL</code>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fopen_index.html">zip_fopen_index(3)</a>,
<a class="Xr" href="zip_stat_index.html">zip_stat_index(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_get_num_files</b>() was added in libzip 0.6. It was deprecated
- in libzip 0.11, use
- <b class="Fn">zip_get_num_entries</b>(<var class="Fa">instead</var>) instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_get_num_files</code>() was added in libzip 0.6. It was
+ deprecated in libzip 0.11, use
+ <code class="Fn">zip_get_num_entries</code>(<var class="Fa">instead</var>)
+ instead.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_get_num_files.mdoc -- get number of files in archive
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_GET_NUM_FILES" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_libzip_version.mdoc -- return run-time version of library
+ Copyright (C) 2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_LIBZIP_VERSION(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_libzip_version</b> — <span class="Nd">return run-time
- version of library</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<h1 class="Sh" title="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm" title="Nm">zip_libzip_version</code> —
+<div class="Nd" title="Nd">return run-time version of library</div>
+<h1 class="Sh" title="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
+<h1 class="Sh" title="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In" title="In">#include
+ <<a class="In" title="In">zip.h</a>></code>
<div class="Pp"></div>
-<var class="Ft">const char *</var>
+<var class="Ft" title="Ft">const char *</var>
<br/>
-<b class="Fn">zip_libzip_version</b>(<var class="Fa" style="white-space: nowrap;">void</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Nm">zip_libzip_version</b> returns the version number of the library
- as string in the format “$MAJOR.$MINOR.$MICRO$SUFFIX” where
- <var class="Ar">$MAJOR</var> is the major version,
- <var class="Ar">$MINOR</var> the minor, <var class="Ar">$MICRO</var> the
- micro, and <var class="Ar">$SUFFIX</var> a suffix that's only set for
+<code class="Fn" title="Fn">zip_libzip_version</code>(<var class="Fa" title="Fa" style="white-space: nowrap;">void</var>);
+<h1 class="Sh" title="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Nm" title="Nm">zip_libzip_version</code> returns the version number
+ of the library as string in the format
+ “$MAJOR.$MINOR.$MICRO$SUFFIX” where
+ <var class="Ar" title="Ar">$MAJOR</var> is the major version,
+ <var class="Ar" title="Ar">$MINOR</var> the minor,
+ <var class="Ar" title="Ar">$MICRO</var> the micro, and
+ <var class="Ar" title="Ar">$SUFFIX</var> a suffix that's only set for
development versions.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
-<a class="Xr" href="libzip.html">libzip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_libzip_version</b>() was added in libzip 1.3.1.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
-<span class="An">Dieter Baron</span>
- <<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
- <span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+<h1 class="Sh" title="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
+<a class="Xr" title="Xr" href="libzip.html">libzip(3)</a>
+<h1 class="Sh" title="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn" title="Fn">zip_libzip_version</code>() was added in libzip
+ 1.3.1.
+<h1 class="Sh" title="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
+<span class="An" title="An">Dieter Baron</span>
+ <<a class="Mt" title="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>>
+ and <span class="An" title="An">Thomas Klausner</span>
+ <<a class="Mt" title="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.27</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_libzip_version.mdoc -- return run-time version of library
+.\" Copyright (C) 2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_LIBZIP_VERSION" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_name_locate.mdoc -- get index of file by name
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_NAME_LOCATE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_name_locate</b> — <span class="Nd">get index of file by
- name</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_name_locate</code> —
+<div class="Nd">get index of file by name</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_name_locate</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_name_locate</b>() function returns the index of the file
- named <var class="Ar">fname</var> in <var class="Ar">archive</var>. If
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_name_locate</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_name_locate</code>() function returns the index of the
+ file named <var class="Ar">fname</var> in <var class="Ar">archive</var>. If
<var class="Ar">archive</var> does not contain a file with that name, -1 is
returned. The <var class="Fa">flags</var> are specified by
<i class="Em">or</i><span class="No">'ing</span> the following values, or 0
for none of them.
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 13.00ex;">
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_FL_NOCASE</code></dt>
- <dd class="It-tag">Ignore case distinctions. (Will only work well if the file
- names are ASCII.) With this flag, <b class="Fn">zip_name_locate</b>() will
- be slow for archives with many files.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_FL_NODIR</code></dt>
- <dd class="It-tag">Ignore directory part of file name in archive. With this
- flag, <b class="Fn">zip_name_locate</b>() will be slow for archives with
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_NOCASE"><code class="Dv" id="ZIP_FL_NOCASE">ZIP_FL_NOCASE</code></a></dt>
+ <dd>Ignore case distinctions. (Will only work well if the file names are
+ ASCII.) With this flag, <code class="Fn">zip_name_locate</code>() will be
+ slow for archives with many files.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_NODIR"><code class="Dv" id="ZIP_FL_NODIR">ZIP_FL_NODIR</code></a></dt>
+ <dd>Ignore directory part of file name in archive. With this flag,
+ <code class="Fn">zip_name_locate</code>() will be slow for archives with
many files.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_FL_ENC_RAW</code></dt>
- <dd class="It-tag">Compare against the unmodified names as it is in the ZIP
- archive.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_FL_ENC_GUESS</code></dt>
- <dd class="It-tag">(Default.) Guess the encoding of the name in the ZIP
- archive and convert it to UTF-8, if necessary, before comparing.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_FL_ENC_STRICT</code></dt>
- <dd class="It-tag">Follow the ZIP specification and expect CP-437 encoded
- names in the ZIP archive (except if they are explicitly marked as UTF-8).
- Convert it to UTF-8 before comparing.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_RAW"><code class="Dv" id="ZIP_FL_ENC_RAW">ZIP_FL_ENC_RAW</code></a></dt>
+ <dd>Compare against the unmodified names as it is in the ZIP archive.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_GUESS"><code class="Dv" id="ZIP_FL_ENC_GUESS">ZIP_FL_ENC_GUESS</code></a></dt>
+ <dd>(Default.) Guess the encoding of the name in the ZIP archive and convert
+ it to UTF-8, if necessary, before comparing.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_ENC_STRICT"><code class="Dv" id="ZIP_FL_ENC_STRICT">ZIP_FL_ENC_STRICT</code></a></dt>
+ <dd>Follow the ZIP specification and expect CP-437 encoded names in the ZIP
+ archive (except if they are explicitly marked as UTF-8). Convert it to
+ UTF-8 before comparing.</dd>
</dl>
</div>
<i class="Em">Note</i>: ASCII is a subset of both CP-437 and UTF-8.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_name_locate</b>() returns the index of the file named
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_name_locate</code>() returns the index of the file named
<var class="Ar">fname</var> or -1, if <var class="Ar">archive</var> does not
contain an entry of that name.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_name_locate</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">One of the arguments is invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag">No entry of the name <var class="Ar">fname</var> is found
- in the archive.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_name_locate</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd>One of the arguments is invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOENT"><code class="Er" id="ZIP_ER_NOENT">ZIP_ER_NOENT</code></a>]</dt>
+ <dd>No entry of the name <var class="Ar">fname</var> is found in the
+ archive.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_get_name.html">zip_get_name(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_name_locate</b>() was added in libzip 0.6. In libzip 0.11 the
- return type was changed from <var class="Vt">int</var> to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_name_locate</code>() was added in libzip 0.6. In libzip
+ 0.11 the return type was changed from <var class="Vt">int</var> to
<var class="Vt">zip_int64_t</var>. In libzip 0.11 the type of
<var class="Ar">flags</var> was changed from <var class="Vt">int</var> to
<var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_name_locate.mdoc -- get index of file by name
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_NAME_LOCATE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_open.mdoc -- open zip archive
+ Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_OPEN(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_open</b>, <b class="Nm">zip_open_from_source</b> —
- <span class="Nd">open zip archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_open</code>, <code class="Nm">zip_open_from_source</code>
+ —
+<div class="Nd">open zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_t *</var>
-<br/>
-<b class="Fn">zip_open</b>(<var class="Fa" style="white-space: nowrap;">const
- char *path</var>, <var class="Fa" style="white-space: nowrap;">int
- flags</var>, <var class="Fa" style="white-space: nowrap;">int *errorp</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_t *</var>
-<br/>
-<b class="Fn">zip_open_from_source</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *zs</var>, <var class="Fa" style="white-space: nowrap;">int flags</var>,
- <var class="Fa" style="white-space: nowrap;">zip_error_t *ze</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_open</b>() function opens the zip archive specified by
- <var class="Ar">path</var> and returns a pointer to a <var class="Ft">struct
- zip</var>, used to manipulate the archive. The <var class="Fa">flags</var> are
- specified by <i class="Em">or</i><span class="No">'ing</span> the following
- values, or 0 for none of them.
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 13.00ex;">
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_CHECKCONS</code></dt>
- <dd class="It-tag">Perform additional stricter consistency checks on the
- archive, and error if they fail.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_CREATE</code></dt>
- <dd class="It-tag">Create the archive if it does not exist.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_EXCL</code></dt>
- <dd class="It-tag">Error if archive already exists.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_TRUNCATE</code></dt>
- <dd class="It-tag">If archive exists, ignore its current contents. In other
- words, handle it the same way as an empty archive.</dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -13.00ex;"><code class="Dv">ZIP_RDONLY</code></dt>
- <dd class="It-tag">Open archive in read-only mode.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_t *</var>
+ <br/>
+ <code class="Fn">zip_open</code>(<var class="Fa" style="white-space: nowrap;">const
+ char *path</var>, <var class="Fa" style="white-space: nowrap;">int
+ flags</var>, <var class="Fa" style="white-space: nowrap;">int
+ *errorp</var>);</p>
+<p class="Pp"><var class="Ft">zip_t *</var>
+ <br/>
+ <code class="Fn">zip_open_from_source</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *zs</var>, <var class="Fa" style="white-space: nowrap;">int flags</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_error_t *ze</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_open</code>() function opens the zip archive specified
+ by <var class="Ar">path</var> and returns a pointer to a
+ <var class="Ft">struct zip</var>, used to manipulate the archive. The
+ <var class="Fa">flags</var> are specified by
+ <i class="Em">or</i><span class="No">'ing</span> the following values, or 0
+ for none of them.
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_CHECKCONS"><code class="Dv" id="ZIP_CHECKCONS">ZIP_CHECKCONS</code></a></dt>
+ <dd>Perform additional stricter consistency checks on the archive, and error
+ if they fail.</dd>
+ <dt><a class="permalink" href="#ZIP_CREATE"><code class="Dv" id="ZIP_CREATE">ZIP_CREATE</code></a></dt>
+ <dd>Create the archive if it does not exist.</dd>
+ <dt><a class="permalink" href="#ZIP_EXCL"><code class="Dv" id="ZIP_EXCL">ZIP_EXCL</code></a></dt>
+ <dd>Error if archive already exists.</dd>
+ <dt><a class="permalink" href="#ZIP_TRUNCATE"><code class="Dv" id="ZIP_TRUNCATE">ZIP_TRUNCATE</code></a></dt>
+ <dd>If archive exists, ignore its current contents. In other words, handle it
+ the same way as an empty archive.</dd>
+ <dt><a class="permalink" href="#ZIP_RDONLY"><code class="Dv" id="ZIP_RDONLY">ZIP_RDONLY</code></a></dt>
+ <dd>Open archive in read-only mode.</dd>
</dl>
</div>
-<div class="Pp"></div>
-If an error occurs and <var class="Ar">errorp</var> is
- non-<code class="Dv">NULL</code>, it will be set to the corresponding error
- code.
-<div class="Pp"></div>
-The <b class="Fn">zip_open_from_source</b>() function opens a zip archive
- encapsulated by the zip_source <var class="Fa">zs</var> using the provided
- <var class="Fa">flags</var>. In case of error, the zip_error
- <var class="Fa">ze</var> is filled in.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-Upon successful completion <b class="Fn">zip_open</b>() and
- <b class="Fn">zip_open_from_source</b>() return a <var class="Ft">struct
+<p class="Pp">If an error occurs and <var class="Ar">errorp</var> is
+ non-<code class="Dv">NULL</code>, it will be set to the corresponding error
+ code.</p>
+<p class="Pp">The <code class="Fn">zip_open_from_source</code>() function opens
+ a zip archive encapsulated by the zip_source <var class="Fa">zs</var> using
+ the provided <var class="Fa">flags</var>. In case of error, the zip_error
+ <var class="Fa">ze</var> is filled in.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+Upon successful completion <code class="Fn">zip_open</code>() and
+ <code class="Fn">zip_open_from_source</code>() return a <var class="Ft">struct
zip</var> pointer. Otherwise, <code class="Dv">NULL</code> is returned and
- <b class="Fn">zip_open</b>() sets <var class="Ar">*errorp</var> to indicate
- the error, while <b class="Fn">zip_open_from</b>(<var class="Fa">source</var>)
- sets <var class="Ar">ze</var> to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
+ <code class="Fn">zip_open</code>() sets <var class="Ar">*errorp</var> to
+ indicate the error, while
+ <code class="Fn">zip_open_from</code>(<var class="Fa">source</var>) sets
+ <var class="Ar">ze</var> to indicate the error.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
The archive specified by <var class="Ar">path</var> is opened unless:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">path</var> exists and
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_EXISTS"><code class="Er" id="ZIP_ER_EXISTS">ZIP_ER_EXISTS</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">path</var> exists and
<code class="Dv">ZIP_EXCL</code> is set.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INCONS</code>]</dt>
- <dd class="It-tag">Inconsistencies were found in the file specified by
+ <dt>[<a class="permalink" href="#ZIP_ER_INCONS"><code class="Er" id="ZIP_ER_INCONS">ZIP_ER_INCONS</code></a>]</dt>
+ <dd>Inconsistencies were found in the file specified by
<var class="Ar">path</var>. This error is often caused by specifying
<code class="Dv">ZIP_CHECKCONS</code> but can also happen without it.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">The <var class="Ar">path</var> argument is
- <code class="Dv">NULL</code>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOENT</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">path</var> does not
- exist and <code class="Dv">ZIP_CREATE</code> is not set.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_NOZIP</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">path</var> is not a
- zip archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">path</var> could not
- be opened.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_READ</code>]</dt>
- <dd class="It-tag">A read error occurred; see <var class="Va">errno</var> for
- details.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_SEEK</code>]</dt>
- <dd class="It-tag">The file specified by <var class="Ar">path</var> does not
- allow seeks.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd>The <var class="Ar">path</var> argument is
+ <code class="Dv">NULL</code>.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOENT"><code class="Er" id="ZIP_ER_NOENT">ZIP_ER_NOENT</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">path</var> does not exist and
+ <code class="Dv">ZIP_CREATE</code> is not set.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_NOZIP"><code class="Er" id="ZIP_ER_NOZIP">ZIP_ER_NOZIP</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">path</var> is not a zip
+ archive.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_OPEN"><code class="Er" id="ZIP_ER_OPEN">ZIP_ER_OPEN</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">path</var> could not be opened.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_READ"><code class="Er" id="ZIP_ER_READ">ZIP_ER_READ</code></a>]</dt>
+ <dd>A read error occurred; see <var class="Va">errno</var> for details.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_SEEK"><code class="Er" id="ZIP_ER_SEEK">ZIP_ER_SEEK</code></a>]</dt>
+ <dd>The file specified by <var class="Ar">path</var> does not allow
+ seeks.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_close.html">zip_close(3)</a>,
- <a class="Xr" href="zip_error_to_str.html">zip_error_to_str(3)</a>,
+ <a class="Xr" href="zip_error_strerror.html">zip_error_strerror(3)</a>,
<a class="Xr" href="zip_fdopen.html">zip_fdopen(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_open</b>() and <b class="Fn">zip_open_from_source</b>() were
- added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_open</code>() and
+ <code class="Fn">zip_open_from_source</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_open.mdoc -- open zip archive
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_OPEN" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.SH "SEE ALSO"
libzip(3),
zip_close(3),
-zip_error_to_str(3),
+zip_error_strerror(3),
zip_fdopen(3)
.SH "HISTORY"
\fBzip_open\fR()
.\" zip_open.mdoc -- open zip archive
-.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Sh SEE ALSO
.Xr libzip 3 ,
.Xr zip_close 3 ,
-.Xr zip_error_to_str 3 ,
+.Xr zip_error_strerror 3 ,
.Xr zip_fdopen 3
.Sh HISTORY
.Fn zip_open
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_register_progress_callback.mdoc -- provide updates during zip_close
+ Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_REGISTER_PROGRESS_CALLBACK(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_register_progress_callback</b> —
- <span class="Nd">provide updates during zip_close (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_register_progress_callback</code> —
+<div class="Nd">provide updates during zip_close (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Vt">typedef void (*zip_progress_callback_t)(double);</var>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_register_progress_callback</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>,
- <var class="Fa" style="white-space: nowrap;">zip_progress_callback_t
- progress_callback</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_register_progress_callback</b>() is the obsolete
- version of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Vt">typedef void
+ (*zip_progress_callback_t)(double);</var></p>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_register_progress_callback</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_progress_callback_t
+ progress_callback</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_register_progress_callback</code>() is the
+ obsolete version of
<a class="Xr" href="zip_register_progress_callback_with_state.html">zip_register_progress_callback_with_state(3)</a>.
-<div class="Pp"></div>
-The <b class="Fn">zip_register_progress_callback</b>() function registers a
- callback function <var class="Ar">progress_callback</var> for the zip archive
- <var class="Ar">archive</var>. This function is called during
- <a class="Xr" href="zip_close.html">zip_close(3)</a> after every zip archive
- entry that's completely written to disk. The value is a
- <var class="Vt">double</var> in the range from 0.0 to 1.0. This can be used to
- provide progress indicators for user interfaces.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+<p class="Pp">The <code class="Fn">zip_register_progress_callback</code>()
+ function registers a callback function
+ <var class="Ar">progress_callback</var> for the zip archive
+ <var class="Ar">archive</var>. This function is called during
+ <a class="Xr" href="zip_close.html">zip_close(3)</a> after every zip archive
+ entry that's completely written to disk. The value is a
+ <var class="Vt">double</var> in the range from 0.0 to 1.0. This can be used
+ to provide progress indicators for user interfaces.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_close.html">zip_close(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_register_progress_callback</b>() was added in libzip 1.2.0. It
- was deprecated in libzip 1.3.0, use
- <b class="Fn">zip_register_progress_callback_with_state</b>() instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_register_progress_callback</code>() was added in libzip
+ 1.2.0. It was deprecated in libzip 1.3.0, use
+ <code class="Fn">zip_register_progress_callback_with_state</code>() instead.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_register_progress_callback.mdoc -- provide updates during zip_close
+.\" Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_REGISTER_PROGRESS_CALLBACK" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_register_progress_callback_with_state.mdoc -- provide updates during zip_close
+ Copyright (C) 2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_REGISTER_PROGRESS_CALLBACK_WITH_STATE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_register_progress_callback_with_state</b> —
- <span class="Nd">provide updates during zip_close</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<h1 class="Sh" title="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm" title="Nm">zip_register_progress_callback_with_state</code>
+ —
+<div class="Nd" title="Nd">provide updates during zip_close</div>
+<h1 class="Sh" title="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
+<h1 class="Sh" title="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In" title="In">#include
+ <<a class="In" title="In">zip.h</a>></code>
<div class="Pp"></div>
-<var class="Vt">typedef void (*zip_progress_callback)(zip_t *, double, void
- *);</var>
+<var class="Vt" title="Vt">typedef void (*zip_progress_callback)(zip_t *,
+ double, void *);</var>
<div class="Pp"></div>
-<var class="Ft">void</var>
+<var class="Ft" title="Ft">void</var>
<br/>
-<b class="Fn">zip_register_progress_callback_with_state</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">double
+<code class="Fn" title="Fn">zip_register_progress_callback_with_state</code>(<var class="Fa" title="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" title="Fa" style="white-space: nowrap;">double
precision</var>,
- <var class="Fa" style="white-space: nowrap;">zip_progress_callback
- callback</var>, <var class="Fa" style="white-space: nowrap;">void
- (*ud_free)(void *)</var>, <var class="Fa" style="white-space: nowrap;">void
- *ud</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_register_progress_callback_with_state</b>() function
- registers a callback function <var class="Ar">callback</var> for the zip
- archive <var class="Ar">archive</var>. The <var class="Ar">precision</var>
- argument is a double in the range from 0.00 to 1.0 that defines the smallest
- change for which the callback should be called (to avoid too frequent calls).
- The <var class="Ar">ud_free</var> function is called during cleanup for
- deleting the userdata supplied in <var class="Ar">ud</var>.
+ <var class="Fa" title="Fa" style="white-space: nowrap;">zip_progress_callback
+ callback</var>, <var class="Fa" title="Fa" style="white-space: nowrap;">void
+ (*ud_free)(void *)</var>,
+ <var class="Fa" title="Fa" style="white-space: nowrap;">void *ud</var>);
+<h1 class="Sh" title="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The
+ <code class="Fn" title="Fn">zip_register_progress_callback_with_state</code>()
+ function registers a callback function
+ <var class="Ar" title="Ar">callback</var> for the zip archive
+ <var class="Ar" title="Ar">archive</var>. The
+ <var class="Ar" title="Ar">precision</var> argument is a double in the range
+ from 0.00 to 1.0 that defines the smallest change for which the callback
+ should be called (to avoid too frequent calls). The
+ <var class="Ar" title="Ar">ud_free</var> function is called during cleanup for
+ deleting the userdata supplied in <var class="Ar" title="Ar">ud</var>.
<div class="Pp"></div>
The callback function is called during
- <a class="Xr" href="zip_close.html">zip_close(3)</a> in regular intervals
- (after every zip archive entry that's completely written to disk, and while
- writing data for entries) with zip archive <var class="Ar">archive</var>, the
- current progression state as a <var class="Vt">double</var>, and the
- user-provided user-data <var class="Ar">ud</var> as arguments. The progression
- state is a <var class="Vt">double</var> in the range from 0.0 to 1.0. This can
+ <a class="Xr" title="Xr" href="zip_close.html">zip_close(3)</a> in regular
+ intervals (after every zip archive entry that's completely written to disk,
+ and while writing data for entries) with zip archive
+ <var class="Ar" title="Ar">archive</var>, the current progression state as a
+ <var class="Vt" title="Vt">double</var>, and the user-provided user-data
+ <var class="Ar" title="Ar">ud</var> as arguments. The progression state is a
+ <var class="Vt" title="Vt">double</var> in the range from 0.0 to 1.0. This can
be used to provide progress indicators for user interfaces.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
-<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_close.html">zip_close(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_register_progress_callback_with_state</b>() was added in
- libzip 1.3.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
-<span class="An">Dieter Baron</span>
- <<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
- <span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+<h1 class="Sh" title="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
+<a class="Xr" title="Xr" href="libzip.html">libzip(3)</a>,
+ <a class="Xr" title="Xr" href="zip_close.html">zip_close(3)</a>
+<h1 class="Sh" title="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn" title="Fn">zip_register_progress_callback_with_state</code>()
+ was added in libzip 1.3.0.
+<h1 class="Sh" title="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
+<span class="An" title="An">Dieter Baron</span>
+ <<a class="Mt" title="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>>
+ and <span class="An" title="An">Thomas Klausner</span>
+ <<a class="Mt" title="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.27</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_register_progress_callback_with_state.mdoc -- provide updates during zip_close
+.\" Copyright (C) 2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_REGISTER_PROGRESS_CALLBACK_WITH_STATE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_rename.mdoc -- rename file in zip archive
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_RENAME(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_rename</b> — <span class="Nd">rename file in zip archive
- (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_rename</code> —
+<div class="Nd">rename file in zip archive (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_rename</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">const char
- *name</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Fn">zip_rename</b>() is the obsolete version of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_rename</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *name</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Fn">zip_rename</code>() is the obsolete version of
<a class="Xr" href="zip_file_rename.html">zip_file_rename(3)</a>. It is the
same as calling
<a class="Xr" href="zip_file_rename.html">zip_file_rename(3)</a> with an empty
flags argument.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_rename.html">zip_file_rename(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_rename</b>() was added in libzip 0.6. In libzip 0.10 the type
- of <var class="Ar">index</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_uint64_t</var>. It was deprecated in libzip 0.11, use
- <b class="Fn">zip_file_rename</b>() instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_rename</code>() was added in libzip 0.6. In libzip 0.10 the
+ type of <var class="Ar">index</var> was changed from <var class="Vt">int</var>
+ to <var class="Vt">zip_uint64_t</var>. It was deprecated in libzip 0.11, use
+ <code class="Fn">zip_file_rename</code>() instead.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_rename.mdoc -- rename file in zip archive
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_RENAME" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_set_archive_comment.mdoc -- set zip archive comment
+ Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SET_ARCHIVE_COMMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_set_archive_comment</b> — <span class="Nd">set zip
- archive comment</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_set_archive_comment</code> —
+<div class="Nd">set zip archive comment</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_set_archive_comment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *comment</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
- len</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_set_archive_comment</b>() function sets the comment for
- the entire zip archive. If <var class="Ar">comment</var> is
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_set_archive_comment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *comment</var>, <var class="Fa" style="white-space: nowrap;">zip_uint16_t
+ len</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_set_archive_comment</code>() function sets the comment
+ for the entire zip archive. If <var class="Ar">comment</var> is
<code class="Dv">NULL</code> and <var class="Ar">len</var> is 0, the archive
comment will be removed. <var class="Ar">comment</var> must be encoded in
ASCII or UTF-8.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_set_archive_comment</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">len</var> is less than 0 or longer than the
- maximum comment length in a zip file (65535), or
- <var class="Ar">comment</var> is not a valid UTF-8 encoded string.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_set_archive_comment</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">len</var> is less than 0 or longer than the maximum
+ comment length in a zip file (65535), or <var class="Ar">comment</var> is
+ not a valid UTF-8 encoded string.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_get_archive_comment.html">zip_get_archive_comment(3)</a>,
- <a class="Xr" href="zip_get_file_comment.html">zip_get_file_comment(3)</a>,
- <a class="Xr" href="zip_set_file_comment.html">zip_set_file_comment(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_set_archive_comment</b>() was added in libzip 0.7. In libzip
- 0.11 the type of <var class="Ar">len</var> was changed from
+ <a class="Xr" href="zip_file_get_comment.html">zip_file_get_comment(3)</a>,
+ <a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a>,
+ <a class="Xr" href="zip_get_archive_comment.html">zip_get_archive_comment(3)</a>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_set_archive_comment</code>() was added in libzip 0.7. In
+ libzip 0.11 the type of <var class="Ar">len</var> was changed from
<var class="Vt">int</var> to <var class="Vt">zip_uint16_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_set_archive_comment.mdoc -- set zip archive comment
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SET_ARCHIVE_COMMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
Required memory could not be allocated.
.SH "SEE ALSO"
libzip(3),
-zip_get_archive_comment(3),
-zip_get_file_comment(3),
-zip_set_file_comment(3)
+zip_file_get_comment(3),
+zip_file_set_comment(3),
+zip_get_archive_comment(3)
.SH "HISTORY"
\fBzip_set_archive_comment\fR()
was added in libzip 0.7.
.\" zip_set_archive_comment.mdoc -- set zip archive comment
-.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2006-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_get_archive_comment 3 ,
-.Xr zip_get_file_comment 3 ,
-.Xr zip_set_file_comment 3
+.Xr zip_file_get_comment 3 ,
+.Xr zip_file_set_comment 3 ,
+.Xr zip_get_archive_comment 3
.Sh HISTORY
.Fn zip_set_archive_comment
was added in libzip 0.7.
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_set_archive_flag.mdoc -- set zip archive flag
+ Copyright (C) 2008-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SET_ARCHIVE_FLAG(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_set_archive_flag</b> — <span class="Nd">set zip archive
- flag</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_set_archive_flag</code> —
+<div class="Nd">set zip archive flag</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_set_archive_flag</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flag</var>, <var class="Fa" style="white-space: nowrap;">int value</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_set_archive_flag</b>() function sets the flag
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_set_archive_flag</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flag</var>, <var class="Fa" style="white-space: nowrap;">int
+ value</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_set_archive_flag</code>() function sets the flag
<var class="Ar">flag</var> for the archive <var class="Ar">archive</var> to
the value <var class="Ar">value</var>.
-<div class="Pp"></div>
-Currently there are no supported flags.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">Currently there are no supported flags.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned, and -1 if an error occurred.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_get_archive_flag.html">zip_get_archive_flag(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_set_archive_flag</b>() was added in libzip 0.9. In libzip 0.11
- the type of <var class="Ar">flag</var> was changed from
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_set_archive_flag</code>() was added in libzip 0.9. In
+ libzip 0.11 the type of <var class="Ar">flag</var> was changed from
<var class="Vt">int</var> to <var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_set_archive_flag.mdoc -- set zip archive flag
+.\" Copyright (C) 2008-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SET_ARCHIVE_FLAG" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_set_default_password.mdoc -- set default password for zip
+ Copyright (C) 2011-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SET_DEFAULT_PASSWORD(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_set_default_password</b> — <span class="Nd">set default
- password for encrypted files in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_set_default_password</code> —
+<div class="Nd">set default password for encrypted files in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_set_default_password</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *password</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_set_default_password</b>() function sets the default
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_set_default_password</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *password</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_set_default_password</code>() function sets the default
password used when accessing encrypted files. If
<var class="Ar">password</var> is <code class="Dv">NULL</code>, the default
password is unset.
-<div class="Pp"></div>
-If you prefer a different password for single files, use
- <a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a>
- instead of <a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>. Usually,
- however, the same password is used for every file in an zip archive.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">If you prefer a different password for single files, use
+ <a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a>
+ instead of <a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>. Usually,
+ however, the same password is used for every file in an zip archive.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_set_default_password</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_set_default_password</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_fopen.html">zip_fopen(3)</a>,
<a class="Xr" href="zip_fopen_encrypted.html">zip_fopen_encrypted(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_set_default_password</b>() was added in libzip 0.10.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_set_default_password</code>() was added in libzip 0.10.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_set_default_password.mdoc -- set default password for zip
+.\" Copyright (C) 2011-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SET_DEFAULT_PASSWORD" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_set_file_comment.mdoc -- set comment for file in zip
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SET_FILE_COMMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_set_file_comment</b> — <span class="Nd">set comment for
- file in zip (obsolete interface)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_set_file_comment</code> —
+<div class="Nd">set comment for file in zip (obsolete interface)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_set_file_comment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">const char
- *comment</var>, <var class="Fa" style="white-space: nowrap;">int len</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_set_file_comment</b>() function is the obsolete version of
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_set_file_comment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *comment</var>, <var class="Fa" style="white-space: nowrap;">int
+ len</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_set_file_comment</code>() function is the obsolete
+ version of
<a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a>.
The only differences are the type of the <var class="Ar">len</var> argument
and the additional <var class="Ar">flags</var> argument.
- <b class="Fn">zip_set_file_comment</b>() is the same as calling
+ <code class="Fn">zip_set_file_comment</code>() is the same as calling
<a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a>
with an empty <var class="Ar">flags</var> argument.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_file_set_comment.html">zip_file_set_comment(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_set_file_comment</b>() was added in libzip 0.7. In libzip 0.10
- the type of <var class="Ar">index</var> was changed from
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_set_file_comment</code>() was added in libzip 0.7. In
+ libzip 0.10 the type of <var class="Ar">index</var> was changed from
<var class="Vt">int</var> to <var class="Vt">zip_uint64_t</var>. It was
- deprecated in libzip 0.11, use <b class="Fn">zip_file_set_comment</b>()
+ deprecated in libzip 0.11, use <code class="Fn">zip_file_set_comment</code>()
instead.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_set_file_comment.mdoc -- set comment for file in zip
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SET_FILE_COMMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_set_file_compression.mdoc -- set compression method and its flags
+ Copyright (C) 2012-2019 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP files.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SET_FILE_COMPRESSION(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_set_file_compression</b> — <span class="Nd">set
- compression method for file in zip</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_set_file_compression</code> —
+<div class="Nd">set compression method for file in zip</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_set_file_compression</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_int32_t
- comp</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
- comp_flags</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_set_file_compression</b>() function sets the compression
- method for the file at position <var class="Ar">index</var> in the zip archive
- to <var class="Ar">comp</var> with the compression method specific
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_set_file_compression</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_int32_t
+ comp</var>, <var class="Fa" style="white-space: nowrap;">zip_uint32_t
+ comp_flags</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_set_file_compression</code>() function sets the
+ compression method for the file at position <var class="Ar">index</var> in the
+ zip archive to <var class="Ar">comp</var> with the compression method specific
<var class="Ar">comp_flags</var>. The <var class="Ar">comp</var> is the same
as returned by <a class="Xr" href="zip_stat.html">zip_stat(3)</a>. For the
<var class="Ar">comp</var> argument, currently only the following values are
supported:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_CM_DEFAULT</code></dt>
- <dd class="It-tag">default compression; currently the same as
- <code class="Dv">ZIP_CM_DEFLATE</code>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_CM_STORE</code></dt>
- <dd class="It-tag">Store the file uncompressed.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_CM_BZIP2</code></dt>
- <dd class="It-tag">Compress the file using the
- <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/bzip2.html">bzip2(1)</a> algorithm.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"><code class="Dv">ZIP_CM_DEFLATE</code></dt>
- <dd class="It-tag">Deflate the file with the
- <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/zlib.html">zlib(3)</a> algorithm and default
- options</dd>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_CM_DEFAULT"><code class="Dv" id="ZIP_CM_DEFAULT">ZIP_CM_DEFAULT</code></a></dt>
+ <dd>default compression; currently the same as
+ <code class="Dv">ZIP_CM_DEFLATE</code>, but <var class="Ar">flags</var>
+ are ignored.</dd>
+ <dt><a class="permalink" href="#ZIP_CM_STORE"><code class="Dv" id="ZIP_CM_STORE">ZIP_CM_STORE</code></a></dt>
+ <dd>Store the file uncompressed.</dd>
+ <dt><a class="permalink" href="#ZIP_CM_BZIP2"><code class="Dv" id="ZIP_CM_BZIP2">ZIP_CM_BZIP2</code></a></dt>
+ <dd>Compress the file using the <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/bzip2.html">bzip2(1)</a>
+ algorithm.</dd>
+ <dt><a class="permalink" href="#ZIP_CM_DEFLATE"><code class="Dv" id="ZIP_CM_DEFLATE">ZIP_CM_DEFLATE</code></a></dt>
+ <dd>Deflate the file with the <a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/zlib.html">zlib(3)</a>
+ algorithm and default options.</dd>
</dl>
-<div class="Pp"></div>
-<i class="Em">NOTE</i>: Only the deflate and store methods can be assumed to be
- universally supported.
-<div class="Pp"></div>
-The <var class="Ar">comp_flags</var> argument defines the compression level, 1
- being fastest compression and 9 highest. Allowed values are 0 (which uses the
- default compression for the algorithm) and 1-9, other values are undefined.
- Further compression method specific flags might be added over time.
-<div class="Pp"></div>
-The current compression method for a file in a zip archive can be determined
- using <a class="Xr" href="zip_stat.html">zip_stat(3)</a>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp"><i class="Em">NOTE</i>: Only the deflate and store methods can be
+ assumed to be universally supported.</p>
+<p class="Pp">The <var class="Ar">comp_flags</var> argument defines the
+ compression level, 1 being fastest compression and 9 highest. Allowed values
+ are 0 (which uses the default compression for the algorithm) and 1-9, other
+ values are undefined. Further compression method specific flags might be
+ added over time.</p>
+<p class="Pp">The current compression method for a file in a zip archive can be
+ determined using <a class="Xr" href="zip_stat.html">zip_stat(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_set_file_compression</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_COMPNOTSUPP</code>]</dt>
- <dd class="It-tag">Unsupported compression method requested.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_set_file_compression</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_COMPNOTSUPP"><code class="Er" id="ZIP_ER_COMPNOTSUPP">ZIP_ER_COMPNOTSUPP</code></a>]</dt>
+ <dd>Unsupported compression method requested.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">archive</var>, or the argument combination is
invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_RDONLY</code>]</dt>
- <dd class="It-tag">Read-only zip file, no changes allowed.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_RDONLY"><code class="Er" id="ZIP_ER_RDONLY">ZIP_ER_RDONLY</code></a>]</dt>
+ <dd>Read-only zip file, no changes allowed.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_stat.html">zip_stat(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_set_file_compression</b>() was added in libzip 0.11.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_set_file_compression</code>() was added in libzip 0.11.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_set_file_compression.mdoc -- set compression method and its flags
+.\" Copyright (C) 2012-2019 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP files.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SET_FILE_COMPRESSION" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.TP 19n
\fRZIP_CM_DEFAULT\fR
default compression; currently the same as
-\fRZIP_CM_DEFLATE\fR.
+\fRZIP_CM_DEFLATE\fR,
+but
+\fIflags\fR
+are ignored.
.TP 19n
\fRZIP_CM_STORE\fR
Store the file uncompressed.
\fRZIP_CM_DEFLATE\fR
Deflate the file with the
zlib(3)
-algorithm and default options
+algorithm and default options.
.PP
\fINOTE\fR:
Only the deflate and store methods can be assumed to be universally
.\" zip_set_file_compression.mdoc -- set compression method and its flags
-.\" Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2012-2019 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP files.
.\" The authors can be contacted at <libzip@nih.at>
.Bl -tag -width ZIP_CM_DEFLATE_XX
.It Dv ZIP_CM_DEFAULT
default compression; currently the same as
-.Dv ZIP_CM_DEFLATE .
+.Dv ZIP_CM_DEFLATE ,
+but
+.Ar flags
+are ignored.
.It Dv ZIP_CM_STORE
Store the file uncompressed.
.It Dv ZIP_CM_BZIP2
.It Dv ZIP_CM_DEFLATE
Deflate the file with the
.Xr zlib 3
-algorithm and default options
+algorithm and default options.
.El
.Pp
.Em NOTE :
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source.mdoc -- description of zip data source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source</b> — <span class="Nd">zip data source
- structure</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source</code> —
+<div class="Nd">zip data source structure</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Vt">zip_source_t *zs</var>;
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Vt">zip_source_t *zs</var>;</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
A <var class="Vt">struct zip_source</var> is a data source used by
<a class="Xr" href="libzip.html">libzip(3)</a> for adding or replacing file
contents for a file in a zip archive. If the source supports seeking, it can
<a class="Xr" href="zip_source_keep.html">zip_source_keep(3)</a> to increase
the reference count, for example if you need the source after
<a class="Xr" href="zip_close.html">zip_close(3)</a>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source_buffer.html">zip_source_buffer(3)</a>,
<a class="Xr" href="zip_source_file.html">zip_source_file(3)</a>,
<a class="Xr" href="zip_source_free.html">zip_source_free(3)</a>,
<a class="Xr" href="zip_source_function.html">zip_source_function(3)</a>,
<a class="Xr" href="zip_source_zip.html">zip_source_zip(3)</a>
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source.mdoc -- description of zip data source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.\" zip_source.mdoc -- description of zip data source
-.\" Copyright (C) 2014-2016 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_begin_write.mdoc -- prepare zip source for writing
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_BEGIN_WRITE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_begin_write</b>,
- <b class="Nm">zip_source_begin_write_cloning</b> —
- <span class="Nd">prepare zip source for writing</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_begin_write</code>,
+ <code class="Nm">zip_source_begin_write_cloning</code> —
+<div class="Nd">prepare zip source for writing</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_begin_write</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_begin_write_cloning</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- offset</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_begin_write</b>() and
- <b class="Fn">zip_source_begin_write_cloning</b>() prepare
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_begin_write</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_begin_write_cloning</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ offset</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_begin_write</code>() and
+ <code class="Fn">zip_source_begin_write_cloning</code>() prepare
<var class="Fa">source</var> for writing. Usually this involves creating
temporary files or allocating buffers.
-<div class="Pp"></div>
-<b class="Fn">zip_source_begin_write_cloning</b>() preserves the first
- <var class="Ar">offset</var> bytes of the original file. This is done
- efficiently, and writes to <var class="Ar">source</var> won't overwrite the
- original data until <b class="Fn">zip_commit_write</b>() is called.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp"><code class="Fn">zip_source_begin_write_cloning</code>() preserves
+ the first <var class="Ar">offset</var> bytes of the original file. This is
+ done efficiently, and writes to <var class="Ar">source</var> won't overwrite
+ the original data until <code class="Fn">zip_commit_write</code>() is
+ called.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_commit_write.html">zip_source_commit_write(3)</a>,
<a class="Xr" href="zip_source_seek_write.html">zip_source_seek_write(3)</a>,
<a class="Xr" href="zip_source_tell_write.html">zip_source_tell_write(3)</a>,
<a class="Xr" href="zip_source_write.html">zip_source_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_begin_write</b>() was added in libzip 1.0.
-<div class="Pp"></div>
-<b class="Fn">zip_source_begin_write_cloning</b>() was added in libzip 1.4.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_begin_write</code>() was added in libzip 1.0.
+<p class="Pp"><code class="Fn">zip_source_begin_write_cloning</code>() was added
+ in libzip 1.4.0.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_begin_write.mdoc -- prepare zip source for writing
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_BEGIN_WRITE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_buffer.mdoc -- create zip data source from buffer
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_BUFFER(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_buffer</b>, <b class="Nm">zip_source_buffer_create</b>
- — <span class="Nd">create zip data source from buffer</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_buffer</code>,
+ <code class="Nm">zip_source_buffer_create</code> —
+<div class="Nd">create zip data source from buffer</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_buffer</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const void
- *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">int freep</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_buffer_create</b>(<var class="Fa" style="white-space: nowrap;">const
- void *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">int freep</var>,
- <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_buffer</b>() and
- <b class="Fn">zip_source_buffer_create</b>() create a zip source from the
- buffer <var class="Ar">data</var> of size <var class="Ar">len</var>. If
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_buffer</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const void
+ *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">int
+ freep</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_buffer_create</code>(<var class="Fa" style="white-space: nowrap;">const
+ void *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">int freep</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_buffer</code>() and
+ <code class="Fn">zip_source_buffer_create</code>() create a zip source from
+ the buffer <var class="Ar">data</var> of size <var class="Ar">len</var>. If
<var class="Ar">freep</var> is non-zero, the buffer will be freed when it is
no longer needed. <var class="Ar">data</var> must remain valid for the
lifetime of the created source.
-<div class="Pp"></div>
-The source can be used to open a zip archive from.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The source can be used to open a zip archive from.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_buffer</b>() and
- <b class="Fn">zip_source_buffer_create</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">len</var> is greater than zero and
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_buffer</code>() and
+ <code class="Fn">zip_source_buffer_create</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">len</var> is greater than zero and
<var class="Ar">data</var> is <code class="Dv">NULL</code>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_open_from_source.html">zip_open_from_source(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_buffer</b>() and
- <b class="Fn">zip_source_buffer_create</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_buffer</code>() and
+ <code class="Fn">zip_source_buffer_create</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_buffer.mdoc -- create zip data source from buffer
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_BUFFER" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
Required memory could not be allocated.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_open_from_source(3),
-zip_replace(3),
zip_source(3)
.SH "HISTORY"
\fBzip_source_buffer\fR()
.\" zip_source_buffer.mdoc -- create zip data source from buffer
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_open_from_source 3 ,
-.Xr zip_replace 3 ,
.Xr zip_source 3
.Sh HISTORY
.Fn zip_source_buffer
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_buffer_fragment.mdoc -- create zip data source from multiple buffers
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_BUFFER_FRAGMENT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_buffer_fragment</b>,
- <b class="Nm">zip_source_buffer_fragment_create</b> —
- <span class="Nd">create zip data source from multiple buffer</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_buffer_fragment</code>,
+ <code class="Nm">zip_source_buffer_fragment_create</code> —
+<div class="Nd">create zip data source from multiple buffer</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_buffer_fragment</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>,
- <var class="Fa" style="white-space: nowrap;">zip_buffer_fragment_t
- *fragments</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- nfragments</var>, <var class="Fa" style="white-space: nowrap;">int
- freep</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_buffer_fragment_create</b>(<var class="Fa" style="white-space: nowrap;">zip_buffer_fragment_t
- *fragments</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- nfragments</var>, <var class="Fa" style="white-space: nowrap;">int
- freep</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_buffer_fragment</b>() and
- <b class="Fn">zip_source_buffer_fragment_create</b>() create a zip source from
- the data in <var class="Ar">fragments</var>. <var class="Ar">nfragments</var>
- specifies the number of fragments. If <var class="Ar">freep</var> is non-zero,
- the data will be freed when it is no longer needed.
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 0.00ex;">
-<pre class="Li">
-struct zip_stat {
- zip_uint8_t *data; /* pointer to the actual data */
- zip_uint64_t length; /* length of this fragment */
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_buffer_fragment</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_buffer_fragment_t
+ *fragments</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ nfragments</var>, <var class="Fa" style="white-space: nowrap;">int
+ freep</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_buffer_fragment_create</code>(<var class="Fa" style="white-space: nowrap;">zip_buffer_fragment_t
+ *fragments</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ nfragments</var>, <var class="Fa" style="white-space: nowrap;">int
+ freep</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_buffer_fragment</code>() and
+ <code class="Fn">zip_source_buffer_fragment_create</code>() create a zip
+ source from the data in <var class="Ar">fragments</var>.
+ <var class="Ar">nfragments</var> specifies the number of fragments. If
+ <var class="Ar">freep</var> is non-zero, the data will be freed when it is no
+ longer needed.
+<div class="Bd Pp">
+<pre>
+struct zip_stat {
+ zip_uint8_t *data; /* pointer to the actual data */
+ zip_uint64_t length; /* length of this fragment */
};
</pre>
</div>
-<div class="Pp"></div>
-The data <var class="Ar">fragments</var> point to must remain valid for the
- lifetime of the created source. <var class="Ar">fragments</var> itself can be
- discarded once the source is created.
-<div class="Pp"></div>
-The source can be used to open a zip archive from.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The data <var class="Ar">fragments</var> point to must remain
+ valid for the lifetime of the created source.
+ <var class="Ar">fragments</var> itself can be discarded once the source is
+ created.</p>
+<p class="Pp">The source can be used to open a zip archive from.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_buffer</b>() and
- <b class="Fn">zip_source_buffer_create</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">nfragments</var> is greater than zero and
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_buffer</code>() and
+ <code class="Fn">zip_source_buffer_create</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">nfragments</var> is greater than zero and
<var class="Ar">fragments</var> is <code class="Dv">NULL</code>.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_open_from_source.html">zip_open_from_source(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_buffer_fragment</b>() and
- <b class="Fn">zip_source_buffer_fragment_create</b>() were added in libzip
- 1.4.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_buffer_fragment</code>() and
+ <code class="Fn">zip_source_buffer_fragment_create</code>() were added in
+ libzip 1.4.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_buffer_fragment.mdoc -- create zip data source from multiple buffers
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_BUFFER_FRAGMENT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
Required memory could not be allocated.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_open_from_source(3),
-zip_replace(3),
zip_source(3)
.SH "HISTORY"
\fBzip_source_buffer_fragment\fR()
.\" zip_source_buffer_fragment.mdoc -- create zip data source from multiple buffers
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_open_from_source 3 ,
-.Xr zip_replace 3 ,
.Xr zip_source 3
.Sh HISTORY
.Fn zip_source_buffer_fragment
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_close.mdoc -- close zip source (open for reading)
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_CLOSE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_close</b> — <span class="Nd">open zip_source
- (which was open for reading)</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_close</code> —
+<div class="Nd">open zip_source (which was open for reading)</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_close</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_close</b>() closes
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_close</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_close</code>() closes
<var class="Fa">source</var>, indicating that no more data will be read.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_free.html">zip_source_free(3)</a>,
<a class="Xr" href="zip_source_open.html">zip_source_open(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_close</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_close</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_close.mdoc -- close zip source (open for reading)
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_CLOSE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_commit_write.mdoc -- finalize changes to zip source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_COMMIT_WRITE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_commit_write</b> — <span class="Nd">finalize
- changes to zip source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_commit_write</code> —
+<div class="Nd">finalize changes to zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_commit_write</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_commit_write</b>() finishes writing data
- to <var class="Fa">source</var> and replaces the original with the newly
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_commit_write</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_commit_write</code>() finishes writing
+ data to <var class="Fa">source</var> and replaces the original with the newly
written data.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>,
<a class="Xr" href="zip_source_seek_write.html">zip_source_seek_write(3)</a>,
<a class="Xr" href="zip_source_tell_write.html">zip_source_tell_write(3)</a>,
<a class="Xr" href="zip_source_write.html">zip_source_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_commit_write</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_commit_write</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_commit_write.mdoc -- finalize changes to zip source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_COMMIT_WRITE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_error.mdoc -- get zip_error for data source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_ERROR(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_error</b> — <span class="Nd">get zip error for
- data source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_error</code> —
+<div class="Nd">get zip error for data source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_error_t *</var>
-<br/>
-<b class="Fn">zip_source_error</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_source_error</b>() function returns the zip error for the
- data source <var class="Ar">source</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_error_t *</var>
+ <br/>
+ <code class="Fn">zip_source_error</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_source_error</code>() function returns the zip error
+ for the data source <var class="Ar">source</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_error_code_system.html">zip_error_code_system(3)</a>,
<a class="Xr" href="zip_error_code_zip.html">zip_error_code_zip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_error</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_error</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_error.mdoc -- get zip_error for data source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_ERROR" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_file.mdoc -- create data source from a file
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_FILE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_file</b>, <b class="Nm">zip_source_file_create</b>
- — <span class="Nd">create data source from a file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_file</code>,
+ <code class="Nm">zip_source_file_create</code> —
+<div class="Nd">create data source from a file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_file</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_file_create</b>(<var class="Fa" style="white-space: nowrap;">const
- char *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_file</b>() and
- <b class="Fn">zip_source_file_create</b>() create a zip source from a file.
- They open <var class="Ar">fname</var> and read <var class="Ar">len</var> bytes
- from offset <var class="Ar">start</var> from it. If <var class="Ar">len</var>
- is 0 or -1, the whole file (starting from <var class="Ar">start</var>) is
- used.
-<div class="Pp"></div>
-If the file supports seek, the source can be used to open a zip archive from.
-<div class="Pp"></div>
-The file is opened and read when the data from the source is used, usually by
- <b class="Fn">zip_close</b>() or <b class="Fn">zip_open_from_source</b>().
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_file</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_file_create</code>(<var class="Fa" style="white-space: nowrap;">const
+ char *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_file</code>() and
+ <code class="Fn">zip_source_file_create</code>() create a zip source from a
+ file. They open <var class="Ar">fname</var> and read <var class="Ar">len</var>
+ bytes from offset <var class="Ar">start</var> from it. If
+ <var class="Ar">len</var> is 0 or -1, the whole file (starting from
+ <var class="Ar">start</var>) is used.
+<p class="Pp">If the file supports seek, the source can be used to open a zip
+ archive from.</p>
+<p class="Pp">The file is opened and read when the data from the source is used,
+ usually by <code class="Fn">zip_close</code>() or
+ <code class="Fn">zip_open_from_source</code>().</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_file</b>() and
- <b class="Fn">zip_source_file_create</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">fname</var>, <var class="Ar">start</var>,
- or <var class="Ar">len</var> are invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">Opening <var class="Ar">fname</var> failed.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_file</code>() and
+ <code class="Fn">zip_source_file_create</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">fname</var>, <var class="Ar">start</var>, or
+ <var class="Ar">len</var> are invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_OPEN"><code class="Er" id="ZIP_ER_OPEN">ZIP_ER_OPEN</code></a>]</dt>
+ <dd>Opening <var class="Ar">fname</var> failed.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_file</b>() and
- <b class="Fn">zip_source_file_create</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_file</code>() and
+ <code class="Fn">zip_source_file_create</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_file.mdoc -- create data source from a file
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_FILE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
failed.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3)
.SH "HISTORY"
\fBzip_source_file\fR()
.\" zip_source_file.mdoc -- create data source from a file
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3
.Sh HISTORY
.Fn zip_source_file
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_filep.mdoc -- create data source from a file stream
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_FILEP(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_filep</b>, <b class="Nm">zip_source_filep_create</b>
- — <span class="Nd">create data source from FILE *</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_filep</code>,
+ <code class="Nm">zip_source_filep_create</code> —
+<div class="Nd">create data source from FILE *</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_filep</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">FILE *file</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint64_t start</var>,
- <var class="Fa" style="white-space: nowrap;">zip_int64_t len</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_filep_create</b>(<var class="Fa" style="white-space: nowrap;">FILE
- *file</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_filep</b>() and
- <b class="Fn">zip_source_filep_create</b>() create a zip source from a file
- stream. They read <var class="Ar">len</var> bytes from offset
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_filep</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">FILE
+ *file</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_filep_create</code>(<var class="Fa" style="white-space: nowrap;">FILE
+ *file</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_filep</code>() and
+ <code class="Fn">zip_source_filep_create</code>() create a zip source from a
+ file stream. They read <var class="Ar">len</var> bytes from offset
<var class="Ar">start</var> from the open file stream
<var class="Ar">file</var>. If <var class="Ar">len</var> is 0 or -1, the whole
file (starting from <var class="Ar">start</var>) is used.
-<div class="Pp"></div>
-If the file stream supports seeking, the source can be used to open a read-only
- zip archive from.
-<div class="Pp"></div>
-The file stream is closed when the source is being freed, usually by
- <a class="Xr" href="zip_close.html">zip_close(3)</a>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">If the file stream supports seeking, the source can be used to
+ open a read-only zip archive from.</p>
+<p class="Pp">The file stream is closed when the source is being freed, usually
+ by <a class="Xr" href="zip_close.html">zip_close(3)</a>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_filep</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">file</var>, <var class="Ar">start</var>, or
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_filep</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">file</var>, <var class="Ar">start</var>, or
<var class="Ar">len</var> are invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_filep</b>() and
- <b class="Fn">zip_source_filep_create</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_filep</code>() and
+ <code class="Fn">zip_source_filep_create</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_filep.mdoc -- create data source from a file stream
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_FILEP" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
Required memory could not be allocated.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3)
.SH "HISTORY"
\fBzip_source_filep\fR()
.\" zip_source_filep.mdoc -- create data source from a file stream
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3
.Sh HISTORY
.Fn zip_source_filep
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_free.mdoc -- free zip data source
+ Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_FREE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_free</b> — <span class="Nd">free zip data
- source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_free</code> —
+<div class="Nd">free zip data source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_source_free</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_free</b>() decrements the reference count
- of <var class="Ar">source</var> and frees it if the reference count drops to
- 0. If <var class="Ar">source</var> is <code class="Dv">NULL</code>, it does
- nothing.
-<div class="Pp"></div>
-<i class="Em">NOTE</i>: This function should not be called on a
- <var class="Ar">source</var> after it was used successfully in a
- <a class="Xr" href="zip_open_from_source.html">zip_open_from_source(3)</a>,
- <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>, or
- <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a> call.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_source_free</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_free</code>() decrements the reference
+ count of <var class="Ar">source</var> and frees it if the reference count
+ drops to 0. If <var class="Ar">source</var> is <code class="Dv">NULL</code>,
+ it does nothing.
+<p class="Pp"><i class="Em">NOTE</i>: This function should not be called on a
+ <var class="Ar">source</var> after it was used successfully in a
+ <a class="Xr" href="zip_open_from_source.html">zip_open_from_source(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>, or
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a> call.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_keep.html">zip_source_keep(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_free</b>() was added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_free</code>() was added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_free.mdoc -- free zip data source
+.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_FREE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_function.mdoc -- create data source from function
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_FUNCTION(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_function</b>,
- <b class="Nm">zip_source_function_create</b> — <span class="Nd">create
- data source from function</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_function</code>,
+ <code class="Nm">zip_source_function_create</code> —
+<div class="Nd">create data source from function</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_function</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>,
- <var class="Fa" style="white-space: nowrap;">zip_source_callback fn</var>,
- <var class="Fa" style="white-space: nowrap;">void *userdata</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_function_create</b>(<var class="Fa" style="white-space: nowrap;">zip_source_callback
- fn</var>, <var class="Fa" style="white-space: nowrap;">void *userdata</var>,
- <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_function</b>() and
- <b class="Fn">zip_source_function_create</b>() creates a zip source from the
- user-provided function <var class="Ar">fn</var>, which must be of the
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_function</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_source_callback fn</var>,
+ <var class="Fa" style="white-space: nowrap;">void *userdata</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_function_create</code>(<var class="Fa" style="white-space: nowrap;">zip_source_callback
+ fn</var>, <var class="Fa" style="white-space: nowrap;">void *userdata</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_function</code>() and
+ <code class="Fn">zip_source_function_create</code>() creates a zip source from
+ the user-provided function <var class="Ar">fn</var>, which must be of the
following type:
-<div class="Pp"></div>
-<var class="Ft">typedef zip_int64_t</var>
- <b class="Fn">(*zip_source_callback)</b>(<var class="Fa">void *userdata</var>,
- <var class="Fa">void *data</var>, <var class="Fa">zip_uint64_t len</var>,
- <var class="Fa">zip_source_cmd_t cmd</var>);
-<div class="Pp"></div>
-<var class="Ar">archive</var> or <var class="Ar">error</var> are used for
- reporting errors and can be <code class="Dv">NULL</code>.
-<div class="Pp"></div>
-When called by the library, the first argument is the
- <var class="Ar">userdata</var> argument supplied to the function. The next two
- arguments are a buffer <var class="Ar">data</var> of size
- <var class="Ar">len</var> when data is passed in or expected to be returned,
- or else <code class="Dv">NULL</code> and 0. The last argument,
- <var class="Ar">cmd</var>, specifies which action the function should perform.
-<div class="Pp"></div>
-Depending on the uses, there are three useful sets of commands to be supported
- by a <b class="Fn">zip_source_callback</b>():
-<dl class="Bl-tag" style="margin-left: 22.00ex;">
- <dt class="It-tag" style="margin-left: -22.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -22.00ex;">read source</dt>
- <dd class="It-tag">Providing streamed data (for file data added to archives).
- Must support <code class="Dv">ZIP_SOURCE_OPEN</code>,
+<p class="Pp"><var class="Ft">typedef zip_int64_t</var>
+ <code class="Fn">(*zip_source_callback)</code>(<var class="Fa">void
+ *userdata</var>, <var class="Fa">void *data</var>,
+ <var class="Fa">zip_uint64_t len</var>, <var class="Fa">zip_source_cmd_t
+ cmd</var>);</p>
+<p class="Pp"><var class="Ar">archive</var> or <var class="Ar">error</var> are
+ used for reporting errors and can be <code class="Dv">NULL</code>.</p>
+<p class="Pp">When called by the library, the first argument is the
+ <var class="Ar">userdata</var> argument supplied to the function. The next
+ two arguments are a buffer <var class="Ar">data</var> of size
+ <var class="Ar">len</var> when data is passed in or expected to be returned,
+ or else <code class="Dv">NULL</code> and 0. The last argument,
+ <var class="Ar">cmd</var>, specifies which action the function should
+ perform.</p>
+<p class="Pp">Depending on the uses, there are three useful sets of commands to
+ be supported by a <code class="Fn">zip_source_callback</code>():</p>
+<dl class="Bl-tag">
+ <dt>read source</dt>
+ <dd>Providing streamed data (for file data added to archives). Must support
+ <code class="Dv">ZIP_SOURCE_OPEN</code>,
<code class="Dv">ZIP_SOURCE_READ</code>,
<code class="Dv">ZIP_SOURCE_CLOSE</code>,
<code class="Dv">ZIP_SOURCE_STAT</code>, and
<code class="Dv">ZIP_SOURCE_ERROR</code>.</dd>
- <dt class="It-tag" style="margin-left: -22.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -22.00ex;">seekable read source</dt>
- <dd class="It-tag">Same as previous, but from a source allowing reading from
- arbitrary offsets (also for read-only zip archive). Must additionally
- support <code class="Dv">ZIP_SOURCE_SEEK</code>,
+ <dt>seekable read source</dt>
+ <dd>Same as previous, but from a source allowing reading from arbitrary
+ offsets (also for read-only zip archive). Must additionally support
+ <code class="Dv">ZIP_SOURCE_SEEK</code>,
<code class="Dv">ZIP_SOURCE_TELL</code>, and
<code class="Dv">ZIP_SOURCE_SUPPORTS</code>.</dd>
- <dt class="It-tag" style="margin-left: -22.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -22.00ex;">read/write source</dt>
- <dd class="It-tag">Same as previous, but additionally allowing writing (also
- for writable zip archives). Must additionally support
+ <dt>read/write source</dt>
+ <dd>Same as previous, but additionally allowing writing (also for writable zip
+ archives). Must additionally support
<code class="Dv">ZIP_SOURCE_BEGIN_WRITE</code>,
<code class="Dv">ZIP_SOURCE_COMMIT_WRITE</code>,
<code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code>,
<code class="Dv">ZIP_SOURCE_TELL_WRITE</code>, and
<code class="Dv">ZIP_SOURCE_REMOVE</code>.</dd>
</dl>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_BEGIN_WRITE</code></h2>
Prepare the source for writing. Use this to create any temporary file(s).
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_BEGIN_WRITE_CLONING</code></h2>
Prepare the source for writing, keeping the first <var class="Ar">len</var>
bytes of the original file. Only implement this command if it is more
efficient than copying the data, and if it does not destructively overwrite
the original file (you still have to be able to execute
<code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code>).
-<div class="Pp"></div>
-The next write should happen at byte <var class="Ar">offset</var>.
+<p class="Pp">The next write should happen at byte
+ <var class="Ar">offset</var>.</p>
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_CLOSE</code></h2>
Reading is done.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_COMMIT_WRITE</code></h2>
Finish writing to the source. Replace the original data with the newly written
data. Clean up temporary files or internal buffers. Subsequently opening and
reading from the source should return the newly written data.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_ERROR</code></h2>
Get error information. <var class="Ar">data</var> points to an array of two
ints, which should be filled with the libzip error code and the corresponding
error codes. If the source stores error information in a zip_error_t, use
<a class="Xr" href="zip_error_to_data.html">zip_error_to_data(3)</a> and
return its return value. Otherwise, return 2 * sizeof(int).
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_FREE</code></h2>
Clean up and free all resources, including <var class="Ar">userdata</var>. The
callback function will not be called again.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_OPEN</code></h2>
Prepare for reading.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_READ</code></h2>
Read data into the buffer <var class="Ar">data</var> of size
<var class="Ar">len</var>. Return the number of bytes placed into
<var class="Ar">data</var> on success, and zero for end-of-file.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_REMOVE</code></h2>
Remove the underlying file. This is called if a zip archive is empty when
closed.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code></h2>
Abort writing to the source. Discard written data. Clean up temporary files or
internal buffers. Subsequently opening and reading from the source should
return the original data.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_SEEK</code></h2>
Specify position to read next byte from, like
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/fseek.html">fseek(3)</a>. Use
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/ZIP_SOURCE_GET_ARGS.html">ZIP_SOURCE_GET_ARGS(3)</a> to
decode the arguments into the following struct:
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 0.00ex;">
-<pre class="Li">
-struct zip_source_args_seek {
- zip_int64_t offset;
- int whence;
+<div class="Bd Pp">
+<pre>
+struct zip_source_args_seek {
+ zip_int64_t offset;
+ int whence;
};
</pre>
</div>
-<div class="Pp"></div>
-If the size of the source's data is known, use
- <a class="Xr" href="zip_source_seek_compute_offset.html">zip_source_seek_compute_offset(3)</a>
- to validate the arguments and compute the new offset.
+<p class="Pp">If the size of the source's data is known, use
+ <a class="Xr" href="zip_source_seek_compute_offset.html">zip_source_seek_compute_offset(3)</a>
+ to validate the arguments and compute the new offset.</p>
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_SEEK_WRITE</code></h2>
Specify position to write next byte to, like
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/fseek.html">fseek(3)</a>. See
<code class="Dv">ZIP_SOURCE_SEEK</code> for details.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_STAT</code></h2>
Get meta information for the input data. <var class="Ar">data</var> points to an
allocated <var class="Vt">struct zip_stat</var>, which should be initialized
using <a class="Xr" href="zip_stat_init.html">zip_stat_init(3)</a> and then
filled in.
-<div class="Pp"></div>
-For uncompressed, unencrypted data, all information is optional. However, fill
- in as much information as is readily available.
-<div class="Pp"></div>
-If the data is compressed, <code class="Dv">ZIP_STAT_COMP_METHOD</code>,
- <code class="Dv">ZIP_STAT_SIZE</code>, and
- <code class="Dv">ZIP_STAT_CRC</code> must be filled in.
-<div class="Pp"></div>
-If the data is encrypted, <code class="Dv">ZIP_STAT_ENCRYPTION_METHOD</code>,
- <code class="Dv">ZIP_STAT_COMP_METHOD</code>,
- <code class="Dv">ZIP_STAT_SIZE</code>, and
- <code class="Dv">ZIP_STAT_CRC</code> must be filled in.
-<div class="Pp"></div>
-Information only available after the source has been read (e.g., size) can be
- omitted in an earlier call. <i class="Em">NOTE</i>:
- <b class="Fn">zip_source_function</b>() may be called with this argument even
- after being called with <code class="Dv">ZIP_SOURCE_CLOSE</code>.
-<div class="Pp"></div>
-Return sizeof(struct zip_stat) on success.
+<p class="Pp">For uncompressed, unencrypted data, all information is optional.
+ However, fill in as much information as is readily available.</p>
+<p class="Pp">If the data is compressed,
+ <code class="Dv">ZIP_STAT_COMP_METHOD</code>,
+ <code class="Dv">ZIP_STAT_SIZE</code>, and
+ <code class="Dv">ZIP_STAT_CRC</code> must be filled in.</p>
+<p class="Pp">If the data is encrypted,
+ <code class="Dv">ZIP_STAT_ENCRYPTION_METHOD</code>,
+ <code class="Dv">ZIP_STAT_COMP_METHOD</code>,
+ <code class="Dv">ZIP_STAT_SIZE</code>, and
+ <code class="Dv">ZIP_STAT_CRC</code> must be filled in.</p>
+<p class="Pp">Information only available after the source has been read (e.g.,
+ size) can be omitted in an earlier call. <i class="Em">NOTE</i>:
+ <code class="Fn">zip_source_function</code>() may be called with this
+ argument even after being called with
+ <code class="Dv">ZIP_SOURCE_CLOSE</code>.</p>
+<p class="Pp">Return sizeof(struct zip_stat) on success.</p>
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_SUPPORTS</code></h2>
Return bitmap specifying which commands are supported. Use
<a class="Xr" href="zip_source_make_command_bitmap.html">zip_source_make_command_bitmap(3)</a>.
If this command is not implemented, the source is assumed to be a read source
without seek support.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_TELL</code></h2>
Return the current read offset in the source, like
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/ftell.html">ftell(3)</a>.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_TELL_WRITE</code></h2>
Return the current write offset in the source, like
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/ftell.html">ftell(3)</a>.
+</section>
+<section class="Ss">
<h2 class="Ss"><code class="Dv">ZIP_SOURCE_WRITE</code></h2>
Write data to the source. Return number of bytes written.
-<h2 class="Ss" id="Return_Values">Return Values</h2>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="Return_Values"><a class="permalink" href="#Return_Values">Return
+ Values</a></h2>
Commands should return -1 on error. <code class="Dv">ZIP_SOURCE_ERROR</code>
will be called to retrieve the error code. On success, commands return 0,
unless specified otherwise in the description above.
-<h2 class="Ss" id="Calling_Conventions">Calling Conventions</h2>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="Calling_Conventions"><a class="permalink" href="#Calling_Conventions">Calling
+ Conventions</a></h2>
The library will always issue <code class="Dv">ZIP_SOURCE_OPEN</code> before
issuing <code class="Dv">ZIP_SOURCE_READ</code>,
<code class="Dv">ZIP_SOURCE_SEEK</code>, or
library wishes to read the data again, it will issue
<code class="Dv">ZIP_SOURCE_OPEN</code> a second time. If the function is
unable to provide the data again, it should return -1.
-<div class="Pp"></div>
-<code class="Dv">ZIP_SOURCE_BEGIN_WRITE</code> or
- <code class="Dv">ZIP_SOURCE_BEGIN_WRITE_CLONING</code> will be called before
- <code class="Dv">ZIP_SOURCE_WRITE</code>,
- <code class="Dv">ZIP_SOURCE_SEEK_WRITE</code>, or
- <code class="Dv">ZIP_SOURCE_TELL_WRITE</code>. When writing is complete,
- either <code class="Dv">ZIP_SOURCE_COMMIT_WRITE</code> or
- <code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code> will be called.
-<div class="Pp"></div>
-<code class="Dv">ZIP_SOURCE_STAT</code> can be issued at any time.
-<div class="Pp"></div>
-<code class="Dv">ZIP_SOURCE_ERROR</code> will only be issued in response to the
- function returning -1.
-<div class="Pp"></div>
-<code class="Dv">ZIP_SOURCE_FREE</code> will be the last command issued; if
- <code class="Dv">ZIP_SOURCE_OPEN</code> was called and succeeded,
- <code class="Dv">ZIP_SOURCE_CLOSE</code> will be called before
- <code class="Dv">ZIP_SOURCE_FREE</code>, and similarly for
- <code class="Dv">ZIP_SOURCE_BEGIN_WRITE</code> or
- <code class="Dv">ZIP_SOURCE_BEGIN_WRITE_CLONING</code> and
- <code class="Dv">ZIP_SOURCE_COMMIT_WRITE</code> or
- <code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code>.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp"><code class="Dv">ZIP_SOURCE_BEGIN_WRITE</code> or
+ <code class="Dv">ZIP_SOURCE_BEGIN_WRITE_CLONING</code> will be called before
+ <code class="Dv">ZIP_SOURCE_WRITE</code>,
+ <code class="Dv">ZIP_SOURCE_SEEK_WRITE</code>, or
+ <code class="Dv">ZIP_SOURCE_TELL_WRITE</code>. When writing is complete,
+ either <code class="Dv">ZIP_SOURCE_COMMIT_WRITE</code> or
+ <code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code> will be called.</p>
+<p class="Pp"><code class="Dv">ZIP_SOURCE_STAT</code> can be issued at any
+ time.</p>
+<p class="Pp"><code class="Dv">ZIP_SOURCE_ERROR</code> will only be issued in
+ response to the function returning -1.</p>
+<p class="Pp"><code class="Dv">ZIP_SOURCE_FREE</code> will be the last command
+ issued; if <code class="Dv">ZIP_SOURCE_OPEN</code> was called and succeeded,
+ <code class="Dv">ZIP_SOURCE_CLOSE</code> will be called before
+ <code class="Dv">ZIP_SOURCE_FREE</code>, and similarly for
+ <code class="Dv">ZIP_SOURCE_BEGIN_WRITE</code> or
+ <code class="Dv">ZIP_SOURCE_BEGIN_WRITE_CLONING</code> and
+ <code class="Dv">ZIP_SOURCE_COMMIT_WRITE</code> or
+ <code class="Dv">ZIP_SOURCE_ROLLBACK_WRITE</code>.</p>
+</section>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error (unless it is <code class="Dv">NULL</code>).
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_function</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_function</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_stat_init.html">zip_stat_init(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_function</b>() and
- <b class="Fn">zip_source_function_create</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_function</code>() and
+ <code class="Fn">zip_source_function_create</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_function.mdoc -- create data source from function
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_FUNCTION" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
Required memory could not be allocated.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3),
zip_stat_init(3)
.SH "HISTORY"
.\" zip_source_function.mdoc -- create data source from function
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
and then filled in.
.Pp
For uncompressed, unencrypted data, all information is optional.
-However, fill in as much information as is readily available.
+However, fill in as much information as is readily available.
.Pp
If the data is compressed,
.Dv ZIP_STAT_COMP_METHOD ,
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3 ,
.Xr zip_stat_init 3
.Sh HISTORY
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_is_deleted.mdoc -- check if zip source is deleted
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_IS_DELETED(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_is_deleted</b> — <span class="Nd">check if
- zip_source is deleted</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_is_deleted</code> —
+<div class="Nd">check if zip_source is deleted</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_is_deleted</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_is_deleted</b>() returns whether the
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_is_deleted</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_is_deleted</code>() returns whether the
zip_source was deleted. This can for example happen when all entries are
removed from a zip archive.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
-<b class="Fn">zip_source_is_deleted</b>() returns 1 if the zip_source is deleted
- and 0 otherwise.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
+<code class="Fn">zip_source_is_deleted</code>() returns 1 if the zip_source is
+ deleted and 0 otherwise.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_is_deleted</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_is_deleted</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_is_deleted.mdoc -- check if zip source is deleted
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_IS_DELETED" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_keep.mdoc -- increment reference count of zip data source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_KEEP(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_keep</b> — <span class="Nd">increment reference
- count of zip data source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_keep</code> —
+<div class="Nd">increment reference count of zip data source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_source_keep</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_keep</b>() increments the reference count
- of <var class="Ar">source</var>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_source_keep</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_keep</code>() increments the reference
+ count of <var class="Ar">source</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_free.html">zip_source_free(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_keep</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_keep</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_keep.mdoc -- increment reference count of zip data source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_KEEP" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_make_command_bitmap -- create bitmap of supported source operations
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_MAKE_COMMAND_BITMAP(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_make_command_bitmap</b> — <span class="Nd">create
- bitmap of supported source operations</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_make_command_bitmap</code> —
+<div class="Nd">create bitmap of supported source operations</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_source_make_command_bitmap</b>(<var class="Fa" style="white-space: nowrap;">zip_source_cmd_t
- command</var>, <var class="Fa" style="white-space: nowrap;">...</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_source_make_command_bitmap</b>() function returns a bitmap
- of source commands suitable as return value for
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_source_make_command_bitmap</code>(<var class="Fa" style="white-space: nowrap;">zip_source_cmd_t
+ command</var>, <var class="Fa" style="white-space: nowrap;">...</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_source_make_command_bitmap</code>() function returns a
+ bitmap of source commands suitable as return value for
<code class="Dv">ZIP_SOURCE_SUPPORTS</code>. It includes all the commands from
the argument list, which must be terminated by -1.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source_function.html">zip_source_function(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_make_command_bitmap</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_make_command_bitmap</code>() was added in libzip
+ 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_make_command_bitmap -- create bitmap of supported source operations
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_MAKE_COMMAND_BITMAP" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_open.mdoc -- open zip source for reading
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_OPEN(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_open</b> — <span class="Nd">open zip_source for
- reading</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_open</code> —
+<div class="Nd">open zip_source for reading</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_open</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_open</b>() opens
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_open</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_open</code>() opens
<var class="Fa">source</var> for reading.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>,
<a class="Xr" href="zip_source_read.html">zip_source_read(3)</a>,
<a class="Xr" href="zip_source_seek.html">zip_source_seek(3)</a>,
<a class="Xr" href="zip_source_tell.html">zip_source_tell(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_open</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_open</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_open.mdoc -- open zip source for reading
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_OPEN" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_read.mdoc -- read data from zip source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_READ(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_read</b> — <span class="Nd">read data from zip
- source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_read</code> —
+<div class="Nd">read data from zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_source_read</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">void *data</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint64_t len</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_read</b>() reads up to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_source_read</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">void
+ *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ len</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_read</code>() reads up to
<var class="Ar">len</var> bytes of data from <var class="Ar">source</var> at
the current read offset into the buffer <var class="Ar">data</var>.
-<div class="Pp"></div>
-The zip source <var class="Ar">source</var> has to be opened for reading by
- calling <a class="Xr" href="zip_source_open.html">zip_source_open(3)</a>
- first.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The zip source <var class="Ar">source</var> has to be opened for
+ reading by calling
+ <a class="Xr" href="zip_source_open.html">zip_source_open(3)</a> first.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion the number of bytes read is returned. Upon reading
end-of-file, zero is returned. Otherwise, -1 is returned and the error
information in <var class="Ar">source</var> is set to indicate the error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_seek.html">zip_source_seek(3)</a>,
<a class="Xr" href="zip_source_tell.html">zip_source_tell(3)</a>,
<a class="Xr" href="zip_source_write.html">zip_source_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_read</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_read</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_read.mdoc -- read data from zip source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_READ" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_rollback_write.mdoc -- undo changes to zip source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_ROLLBACK_WRITE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_rollback_write</b> — <span class="Nd">undo
- changes to zip source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_rollback_write</code> —
+<div class="Nd">undo changes to zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_source_rollback_write</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_rollback_write</b>() reverts changes
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_source_rollback_write</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_rollback_write</code>() reverts changes
written to <var class="Fa">source</var>, restoring the data before
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>
was called. Usually this removes temporary files or frees buffers.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>,
<a class="Xr" href="zip_source_seek_write.html">zip_source_seek_write(3)</a>,
<a class="Xr" href="zip_source_tell_write.html">zip_source_tell_write(3)</a>,
<a class="Xr" href="zip_source_write.html">zip_source_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_rollback_write</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_rollback_write</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_rollback_write.mdoc -- undo changes to zip source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_ROLLBACK_WRITE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_seek.mdoc -- set read offset in source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_SEEK(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_seek</b> — <span class="Nd">set read offset in
- zip source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_seek</code> —
+<div class="Nd">set read offset in zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_seek</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- offset</var>, <var class="Fa" style="white-space: nowrap;">int whence</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_seek</b>() sets the current read offset
- for <var class="Fa">source</var>. Just like in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_seek</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ offset</var>, <var class="Fa" style="white-space: nowrap;">int
+ whence</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_seek</code>() sets the current read
+ offset for <var class="Fa">source</var>. Just like in
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/fseek.html">fseek(3)</a>, depending on the
<var class="Ar">whence</var> argument, the <var class="Ar">offset</var> is
counted relative from:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 10.00ex;">
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><code class="Dv">SEEK_SET</code></dt>
- <dd class="It-tag">start of file</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><code class="Dv">SEEK_CUR</code></dt>
- <dd class="It-tag">current read offset in file</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><code class="Dv">SEEK_END</code></dt>
- <dd class="It-tag">end of file</dd>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#SEEK_SET"><code class="Dv" id="SEEK_SET">SEEK_SET</code></a></dt>
+ <dd>start of file</dd>
+ <dt><a class="permalink" href="#SEEK_CUR"><code class="Dv" id="SEEK_CUR">SEEK_CUR</code></a></dt>
+ <dd>current read offset in file</dd>
+ <dt><a class="permalink" href="#SEEK_END"><code class="Dv" id="SEEK_END">SEEK_END</code></a></dt>
+ <dd>end of file</dd>
</dl>
</div>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_read.html">zip_source_read(3)</a>,
<a class="Xr" href="zip_source_tell.html">zip_source_tell(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_seek</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_seek</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_seek.mdoc -- set read offset in source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_SEEK" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_seek_compute_offset.mdoc - validate arguments and compute offset
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_SEEK_COMPUTE_OFFSET(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_seek_compute_offset</b> —
- <span class="Nd">validate arguments and compute offset</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_seek_compute_offset</code> —
+<div class="Nd">validate arguments and compute offset</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_source_seek_compute_offset</b>(<var class="Fa" style="white-space: nowrap;">zip_uint64_t
- offset</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- length</var>, <var class="Fa" style="white-space: nowrap;">void *data</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint64_t data_length</var>,
- <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_source_seek_compute_offset</code>(<var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ offset</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ length</var>, <var class="Fa" style="white-space: nowrap;">void *data</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint64_t data_length</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
Use this function to compute the offset for a
<code class="Dv">ZIP_SOURCE_SEEK</code> or
<code class="Dv">ZIP_SOURCE_SEEK_WRITE</code> command.
arguments to the source callback, <var class="Ar">offset</var> is the current
offset and <var class="Ar">length</var> is the length of the source data or,
for <code class="Dv">ZIP_SOURCE_SEEK_WRITE</code>, the amount of data written.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
On success, it returns the new offset, on error it returns -1 and sets
<var class="Ar">error</var>.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_seek_compute_offset</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag">One of the arguments is invalid or the seek would place the
- offset outside the data.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_seek_compute_offset</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd>One of the arguments is invalid or the seek would place the offset outside
+ the data.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="zip_source_function.html">zip_source_function(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_seek_compute_offset</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_seek_compute_offset</code>() was added in libzip
+ 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_seek_compute_offset.mdoc - validate arguments and compute offset
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_SEEK_COMPUTE_OFFSET" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_seek_write.mdoc -- set write offset in source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_SEEK_WRITE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_seek_write</b> — <span class="Nd">set write
- offset in zip source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_seek_write</code> —
+<div class="Nd">set write offset in zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_seek_write</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- offset</var>, <var class="Fa" style="white-space: nowrap;">int whence</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_seek_write</b>() sets the current write
- offset for <var class="Fa">source</var>. Just like in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_seek_write</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ offset</var>, <var class="Fa" style="white-space: nowrap;">int
+ whence</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_seek_write</code>() sets the current
+ write offset for <var class="Fa">source</var>. Just like in
<a class="Xr" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/fseek.html">fseek(3)</a>, depending on the
<var class="Ar">whence</var> argument, the <var class="Ar">offset</var> is
counted relative from:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 10.00ex;">
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><code class="Dv">SEEK_SET</code></dt>
- <dd class="It-tag">start of file</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><code class="Dv">SEEK_CUR</code></dt>
- <dd class="It-tag">current write offset in file</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><code class="Dv">SEEK_END</code></dt>
- <dd class="It-tag">end of file</dd>
+<div class="Bd-indent">
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#SEEK_SET"><code class="Dv" id="SEEK_SET">SEEK_SET</code></a></dt>
+ <dd>start of file</dd>
+ <dt><a class="permalink" href="#SEEK_CUR"><code class="Dv" id="SEEK_CUR">SEEK_CUR</code></a></dt>
+ <dd>current write offset in file</dd>
+ <dt><a class="permalink" href="#SEEK_END"><code class="Dv" id="SEEK_END">SEEK_END</code></a></dt>
+ <dd>end of file</dd>
</dl>
</div>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>,
<a class="Xr" href="zip_source_rollback_write.html">zip_source_rollback_write(3)</a>,
<a class="Xr" href="zip_source_tell_write.html">zip_source_tell_write(3)</a>,
<a class="Xr" href="zip_source_write.html">zip_source_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_seek_write</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_seek_write</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_seek_write.mdoc -- set write offset in source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_SEEK_WRITE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_stat.mdoc -- get information about zip source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_STAT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_stat</b> — <span class="Nd">get information about
- zip_source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_stat</code> —
+<div class="Nd">get information about zip_source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_source_stat</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
- *sb</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_source_stat</b>() function obtains information about the
- zip source <var class="Ar">source</var>
-<div class="Pp"></div>
-The <var class="Ar">sb</var> argument is a pointer to a <var class="Ft">struct
- zip_source_stat</var> (shown below), into which information about the zip
- source is placed.
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 0.00ex;">
-<pre class="Li">
-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 */
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_source_stat</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
+ *sb</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_source_stat</code>() function obtains information about
+ the zip source <var class="Ar">source</var>
+<p class="Pp">The <var class="Ar">sb</var> argument is a pointer to a
+ <var class="Ft">struct zip_source_stat</var> (shown below), into which
+ information about the zip source is placed.</p>
+<div class="Bd Pp">
+<pre>
+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 */
};
</pre>
</div>
The structure pointed to by <var class="Ar">sb</var> must be initialized with
- <b class="Fn">zip_stat_init</b>(<var class="Fa">3</var>) before calling
- <b class="Fn">zip_source_stat</b>().
-<div class="Pp"></div>
-The <var class="Ar">valid</var> field of the structure specifies which other
- fields are valid. Check if the flag defined by the following defines are in
- <var class="Ar">valid</var> before accessing the fields:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 35.00ex;">
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_NAME</code></dt>
- <dd class="It-tag"><var class="Ar">name</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_INDEX</code></dt>
- <dd class="It-tag"><var class="Ar">index</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_SIZE</code></dt>
- <dd class="It-tag"><var class="Ar">size</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_COMP_SIZE</code></dt>
- <dd class="It-tag"><var class="Ar">comp_size</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_MTIME</code></dt>
- <dd class="It-tag"><var class="Ar">mtime</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_CRC</code></dt>
- <dd class="It-tag"><var class="Ar">crc</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_COMP_METHOD</code></dt>
- <dd class="It-tag"><var class="Ar">comp_method</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_ENCRYPTION_METHOD</code></dt>
- <dd class="It-tag"><var class="Ar">encryption_method</var></dd>
- <dt class="It-tag" style="margin-left: -35.00ex;"><code class="Dv">ZIP_SOURCE_STAT_FLAGS</code></dt>
- <dd class="It-tag"><var class="Ar">flags</var></dd>
+ <code class="Fn">zip_stat_init</code>(<var class="Fa">3</var>) before calling
+ <code class="Fn">zip_source_stat</code>().
+<p class="Pp">The <var class="Ar">valid</var> field of the structure specifies
+ which other fields are valid. Check if the flag defined by the following
+ defines are in <var class="Ar">valid</var> before accessing the fields:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag Bl-compact">
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_NAME"><code class="Dv" id="ZIP_SOURCE_STAT_NAME">ZIP_SOURCE_STAT_NAME</code></a></dt>
+ <dd><var class="Ar">name</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_INDEX"><code class="Dv" id="ZIP_SOURCE_STAT_INDEX">ZIP_SOURCE_STAT_INDEX</code></a></dt>
+ <dd><var class="Ar">index</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_SIZE"><code class="Dv" id="ZIP_SOURCE_STAT_SIZE">ZIP_SOURCE_STAT_SIZE</code></a></dt>
+ <dd><var class="Ar">size</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_COMP_SIZE"><code class="Dv" id="ZIP_SOURCE_STAT_COMP_SIZE">ZIP_SOURCE_STAT_COMP_SIZE</code></a></dt>
+ <dd><var class="Ar">comp_size</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_MTIME"><code class="Dv" id="ZIP_SOURCE_STAT_MTIME">ZIP_SOURCE_STAT_MTIME</code></a></dt>
+ <dd><var class="Ar">mtime</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_CRC"><code class="Dv" id="ZIP_SOURCE_STAT_CRC">ZIP_SOURCE_STAT_CRC</code></a></dt>
+ <dd><var class="Ar">crc</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_COMP_METHOD"><code class="Dv" id="ZIP_SOURCE_STAT_COMP_METHOD">ZIP_SOURCE_STAT_COMP_METHOD</code></a></dt>
+ <dd><var class="Ar">comp_method</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_ENCRYPTION_METHOD"><code class="Dv" id="ZIP_SOURCE_STAT_ENCRYPTION_METHOD">ZIP_SOURCE_STAT_ENCRYPTION_METHOD</code></a></dt>
+ <dd><var class="Ar">encryption_method</var></dd>
+ <dt><a class="permalink" href="#ZIP_SOURCE_STAT_FLAGS"><code class="Dv" id="ZIP_SOURCE_STAT_FLAGS">ZIP_SOURCE_STAT_FLAGS</code></a></dt>
+ <dd><var class="Ar">flags</var></dd>
</dl>
</div>
-<div class="Pp"></div>
-<i class="Em">NOTE</i>: Some fields may only be filled out after all data has
- been read from the source, for example the <var class="Ar">crc</var> or
- <var class="Ar">size</var> fields.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp"><i class="Em">NOTE</i>: Some fields may only be filled out after
+ all data has been read from the source, for example the
+ <var class="Ar">crc</var> or <var class="Ar">size</var> fields.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">source</var> is set to indicate the
error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_stat</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_stat</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_stat.mdoc -- get information about zip source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_STAT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_tell.mdoc -- report current read offset in source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_TELL(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_tell</b> — <span class="Nd">report current read
- offset in zip source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_tell</code> —
+<div class="Nd">report current read offset in zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_source_tell</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_tell</b>() returns the current read offset
- for <var class="Fa">source</var>. The return value can be passed to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_source_tell</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_tell</code>() returns the current read
+ offset for <var class="Fa">source</var>. The return value can be passed to
<a class="Xr" href="zip_source_seek.html">zip_source_seek(3)</a> with
<var class="Ar">whence</var> set to <code class="Dv">SEEK_SET</code> to return
to the same location in the source.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion the current read offset is returned. Otherwise, -1 is
returned and the error information in <var class="Ar">source</var> is set to
indicate the error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_read.html">zip_source_read(3)</a>,
<a class="Xr" href="zip_source_tell_write.html">zip_source_tell_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_tell</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_tell</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_tell.mdoc -- report current read offset in source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_TELL" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_tell_write.mdoc -- report current write offset in source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_TELL_WRITE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_tell_write</b> — <span class="Nd">report current
- write offset in zip source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_tell_write</code> —
+<div class="Nd">report current write offset in zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_source_tell_write</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_tell_write</b>() returns the current write
- offset for <var class="Fa">source</var>. The return value can be passed to
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_source_tell_write</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_tell_write</code>() returns the current
+ write offset for <var class="Fa">source</var>. The return value can be passed
+ to
<a class="Xr" href="zip_source_seek_write.html">zip_source_seek_write(3)</a>
with <var class="Ar">whence</var> set to <code class="Dv">SEEK_SET</code> to
return to the same location in the source.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion the current write offset is returned. Otherwise, -1
is returned and the error information in <var class="Ar">source</var> is set
to indicate the error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>,
<a class="Xr" href="zip_source_rollback_write.html">zip_source_rollback_write(3)</a>,
<a class="Xr" href="zip_source_tell.html">zip_source_tell(3)</a>,
<a class="Xr" href="zip_source_write.html">zip_source_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_tell_write</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_tell_write</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_tell_write.mdoc -- report current write offset in source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_TELL_WRITE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_win32a.mdoc -- create data source using a win32 ANSI name
+ Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_WIN32A(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_win32a</b>, <b class="Nm">zip_source_win32a_create</b>
- — <span class="Nd">create data source from a Windows ANSI file
- name</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_win32a</code>,
+ <code class="Nm">zip_source_win32a_create</code> —
+<div class="Nd">create data source from a Windows ANSI file name</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_win32a</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_win32a_create</b>(<var class="Fa" style="white-space: nowrap;">const
- char *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_win32a</b>() and
- <b class="Fn">zip_source_win32a_create</b>() create a zip source on Windows
- using a Windows ANSI name. They open <var class="Ar">fname</var> and read
- <var class="Ar">len</var> bytes from offset <var class="Ar">start</var> from
- it. If <var class="Ar">len</var> is 0 or -1, the whole file (starting from
- <var class="Ar">start</var>) is used.
-<div class="Pp"></div>
-If the file supports seek, the source can be used to open a zip archive from.
-<div class="Pp"></div>
-The file is opened and read when the data from the source is used, usually by
- <b class="Fn">zip_close</b>() or <b class="Fn">zip_open_from_source</b>().
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_win32a</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_win32a_create</code>(<var class="Fa" style="white-space: nowrap;">const
+ char *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_win32a</code>() and
+ <code class="Fn">zip_source_win32a_create</code>() create a zip source on
+ Windows using a Windows ANSI name. They open <var class="Ar">fname</var> and
+ read <var class="Ar">len</var> bytes from offset <var class="Ar">start</var>
+ from it. If <var class="Ar">len</var> is 0 or -1, the whole file (starting
+ from <var class="Ar">start</var>) is used.
+<p class="Pp">If the file supports seek, the source can be used to open a zip
+ archive from.</p>
+<p class="Pp">The file is opened and read when the data from the source is used,
+ usually by <code class="Fn">zip_close</code>() or
+ <code class="Fn">zip_open_from_source</code>().</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_win32a</b>() and
- <b class="Fn">zip_source_win32a_create</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">fname</var>, <var class="Ar">start</var>,
- or <var class="Ar">len</var> are invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">Opening <var class="Ar">fname</var> failed.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_win32a</code>() and
+ <code class="Fn">zip_source_win32a_create</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">fname</var>, <var class="Ar">start</var>, or
+ <var class="Ar">len</var> are invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_OPEN"><code class="Er" id="ZIP_ER_OPEN">ZIP_ER_OPEN</code></a>]</dt>
+ <dd>Opening <var class="Ar">fname</var> failed.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_win32handle.html">zip_source_win32handle(3)</a>,
<a class="Xr" href="zip_source_win32w.html">zip_source_win32w(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_win32a</b>() and
- <b class="Fn">zip_source_win32a_create</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_win32a</code>() and
+ <code class="Fn">zip_source_win32a_create</code>() were added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_win32a.mdoc -- create data source using a win32 ANSI name
+.\" Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_WIN32A" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
failed.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3),
zip_source_win32handle(3),
zip_source_win32w(3)
.\" zip_source_win32a.mdoc -- create data source using a win32 ANSI name
-.\" Copyright (C) 2015-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3 ,
.Xr zip_source_win32handle 3 ,
.Xr zip_source_win32w 3
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_handle.mdoc -- create data source from a Windows file handle
+ Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_WIN32HANDLE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_win32handle</b>,
- <b class="Nm">zip_source_win32handle_create</b> —
- <span class="Nd">create data source from a Windows file handle</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_win32handle</code>,
+ <code class="Nm">zip_source_win32handle_create</code> —
+<div class="Nd">create data source from a Windows file handle</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_win32handle</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">HANDLE h</var>,
- <var class="Fa" style="white-space: nowrap;">zip_uint64_t start</var>,
- <var class="Fa" style="white-space: nowrap;">zip_int64_t len</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_win32handle_create</b>(<var class="Fa" style="white-space: nowrap;">HANDLE
- h</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_win32handle</b>() and
- <b class="Fn">zip_source_win32handle_create</b>() create a zip source from a
- Windows file handle. They open <var class="Ar">fname</var> and read
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_win32handle</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">HANDLE h</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint64_t start</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_int64_t len</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_win32handle_create</code>(<var class="Fa" style="white-space: nowrap;">HANDLE
+ h</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
+ *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_win32handle</code>() and
+ <code class="Fn">zip_source_win32handle_create</code>() create a zip source
+ from a Windows file handle. They open <var class="Ar">fname</var> and read
<var class="Ar">len</var> bytes from offset <var class="Ar">start</var> from
it. If <var class="Ar">len</var> is 0 or -1, the whole file (starting from
<var class="Ar">start</var>) is used.
-<div class="Pp"></div>
-If the file supports seek, the source can be used to open a zip archive from.
-<div class="Pp"></div>
-The file is opened and read when the data from the source is used, usually by
- <b class="Fn">zip_close</b>() or <b class="Fn">zip_open_from_source</b>().
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">If the file supports seek, the source can be used to open a zip
+ archive from.</p>
+<p class="Pp">The file is opened and read when the data from the source is used,
+ usually by <code class="Fn">zip_close</code>() or
+ <code class="Fn">zip_open_from_source</code>().</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_w32handle</b>() and
- <b class="Fn">zip_source_w32handle_create</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">fname</var>, <var class="Ar">start</var>,
- or <var class="Ar">len</var> are invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">Opening <var class="Ar">fname</var> failed.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_w32handle</code>() and
+ <code class="Fn">zip_source_w32handle_create</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">fname</var>, <var class="Ar">start</var>, or
+ <var class="Ar">len</var> are invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_OPEN"><code class="Er" id="ZIP_ER_OPEN">ZIP_ER_OPEN</code></a>]</dt>
+ <dd>Opening <var class="Ar">fname</var> failed.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_win32a.html">zip_source_win32a(3)</a>,
<a class="Xr" href="zip_source_win32w.html">zip_source_win32w(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_win32handle</b>() and
- <b class="Fn">zip_source_win32handle_create</b>() were added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_win32handle</code>() and
+ <code class="Fn">zip_source_win32handle_create</code>() were added in libzip
+ 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_handle.mdoc -- create data source from a Windows file handle
+.\" Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_WIN32HANDLE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
failed.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3),
zip_source_win32a(3),
zip_source_win32w(3)
.\" zip_source_handle.mdoc -- create data source from a Windows file handle
-.\" Copyright (C) 2015-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3 ,
.Xr zip_source_win32a 3 ,
.Xr zip_source_win32w 3
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_win32w.mdoc -- create data source using a win32 Unicode name
+ Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_WIN32W(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_win32w</b>, <b class="Nm">zip_source_win32w_create</b>
- — <span class="Nd">create data source from a Windows Unicode file
- name</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_win32w</code>,
+ <code class="Nm">zip_source_win32w_create</code> —
+<div class="Nd">create data source from a Windows Unicode file name</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_win32w</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>);
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_win32w_create</b>(<var class="Fa" style="white-space: nowrap;">const
- char *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>, <var class="Fa" style="white-space: nowrap;">zip_error_t
- *error</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The functions <b class="Fn">zip_source_win32w</b>() and
- <b class="Fn">zip_source_win32w_create</b>() create a zip source on Windows
- using a Windows Unicode name. They open <var class="Ar">fname</var> and read
- <var class="Ar">len</var> bytes from offset <var class="Ar">start</var> from
- it. If <var class="Ar">len</var> is 0 or -1, the whole file (starting from
- <var class="Ar">start</var>) is used.
-<div class="Pp"></div>
-If the file supports seek, the source can be used to open a zip archive from.
-<div class="Pp"></div>
-The file is opened and read when the data from the source is used, usually by
- <b class="Fn">zip_close</b>() or <b class="Fn">zip_open_from_source</b>().
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_win32w</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const wchar_t
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>);</p>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_win32w_create</code>(<var class="Fa" style="white-space: nowrap;">const
+ wchar_t *fname</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_uint64_t start</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_int64_t len</var>,
+ <var class="Fa" style="white-space: nowrap;">zip_error_t *error</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The functions <code class="Fn">zip_source_win32w</code>() and
+ <code class="Fn">zip_source_win32w_create</code>() create a zip source on
+ Windows using a Windows Unicode name. They open <var class="Ar">fname</var>
+ and read <var class="Ar">len</var> bytes from offset
+ <var class="Ar">start</var> from it. If <var class="Ar">len</var> is 0 or -1,
+ the whole file (starting from <var class="Ar">start</var>) is used.
+<p class="Pp">If the file supports seek, the source can be used to open a zip
+ archive from.</p>
+<p class="Pp">The file is opened and read when the data from the source is used,
+ usually by <code class="Fn">zip_close</code>() or
+ <code class="Fn">zip_open_from_source</code>().</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> or <var class="Ar">error</var> is set to
indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_win32w</b>() and
- <b class="Fn">zip_source_win32w_create</b>() fail if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">fname</var>, <var class="Ar">start</var>,
- or <var class="Ar">len</var> are invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_OPEN</code>]</dt>
- <dd class="It-tag">Opening <var class="Ar">fname</var> failed.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_win32w</code>() and
+ <code class="Fn">zip_source_win32w_create</code>() fail if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">fname</var>, <var class="Ar">start</var>, or
+ <var class="Ar">len</var> are invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_OPEN"><code class="Er" id="ZIP_ER_OPEN">ZIP_ER_OPEN</code></a>]</dt>
+ <dd>Opening <var class="Ar">fname</var> failed.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_win32a.html">zip_source_win32a(3)</a>,
<a class="Xr" href="zip_source_win32handle.html">zip_source_win32handle(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_win32w</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_win32w</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
- <td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-date">June 22, 2018</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
-.TH "ZIP_SOURCE_WIN32W" "3" "December 18, 2017" "NiH" "Library Functions Manual"
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_win32w.mdoc -- create data source using a win32 Unicode name
+.\" Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.TH "ZIP_SOURCE_WIN32W" "3" "June 22, 2018" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.SH "NAME"
.br
.PD 0
.HP 4n
-\fBzip_source_win32w\fR(\fIzip_t\ *archive\fR, \fIconst\ char\ *fname\fR, \fIzip_uint64_t\ start\fR, \fIzip_int64_t\ len\fR);
+\fBzip_source_win32w\fR(\fIzip_t\ *archive\fR, \fIconst\ wchar_t\ *fname\fR, \fIzip_uint64_t\ start\fR, \fIzip_int64_t\ len\fR);
.PD
.PP
\fIzip_source_t *\fR
.br
.PD 0
.HP 4n
-\fBzip_source_win32w_create\fR(\fIconst\ char\ *fname\fR, \fIzip_uint64_t\ start\fR, \fIzip_int64_t\ len\fR, \fIzip_error_t\ *error\fR);
+\fBzip_source_win32w_create\fR(\fIconst\ wchar_t\ *fname\fR, \fIzip_uint64_t\ start\fR, \fIzip_int64_t\ len\fR, \fIzip_error_t\ *error\fR);
.PD
.SH "DESCRIPTION"
The functions
failed.
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3),
zip_source_win32a(3),
zip_source_win32handle(3)
.\" zip_source_win32w.mdoc -- create data source using a win32 Unicode name
-.\" Copyright (C) 2015-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd December 18, 2017
+.Dd June 22, 2018
.Dt ZIP_SOURCE_WIN32W 3
.Os
.Sh NAME
.Sh SYNOPSIS
.In zip.h
.Ft zip_source_t *
-.Fn zip_source_win32w "zip_t *archive" "const char *fname" "zip_uint64_t start" "zip_int64_t len"
+.Fn zip_source_win32w "zip_t *archive" "const wchar_t *fname" "zip_uint64_t start" "zip_int64_t len"
.Ft zip_source_t *
-.Fn zip_source_win32w_create "const char *fname" "zip_uint64_t start" "zip_int64_t len" "zip_error_t *error"
+.Fn zip_source_win32w_create "const wchar_t *fname" "zip_uint64_t start" "zip_int64_t len" "zip_error_t *error"
.Sh DESCRIPTION
The functions
.Fn zip_source_win32w
.El
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3 ,
.Xr zip_source_win32a 3 ,
.Xr zip_source_win32handle 3
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_write.mdoc -- write data to zip source
+ Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_WRITE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_write</b> — <span class="Nd">write data to zip
- source</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_write</code> —
+<div class="Nd">write data to zip source</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_int64_t</var>
-<br/>
-<b class="Fn">zip_source_write</b>(<var class="Fa" style="white-space: nowrap;">zip_source_t
- *source</var>, <var class="Fa" style="white-space: nowrap;">const void
- *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- len</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_write</b>() writes
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_int64_t</var>
+ <br/>
+ <code class="Fn">zip_source_write</code>(<var class="Fa" style="white-space: nowrap;">zip_source_t
+ *source</var>, <var class="Fa" style="white-space: nowrap;">const void
+ *data</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ len</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_write</code>() writes
<var class="Ar">len</var> bytes from the buffer <var class="Ar">data</var> to
the zip source <var class="Ar">source</var> at the current write offset.
-<div class="Pp"></div>
-The zip source <var class="Ar">source</var> has to be prepared for writing by
- calling
- <a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>
- first.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+<p class="Pp">The zip source <var class="Ar">source</var> has to be prepared for
+ writing by calling
+ <a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>
+ first.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion the number of bytes written is returned. Otherwise,
-1 is returned and the error information in <var class="Ar">source</var> is
set to indicate the error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>,
<a class="Xr" href="zip_source_begin_write.html">zip_source_begin_write(3)</a>,
<a class="Xr" href="zip_source_rollback_write.html">zip_source_rollback_write(3)</a>,
<a class="Xr" href="zip_source_seek_write.html">zip_source_seek_write(3)</a>,
<a class="Xr" href="zip_source_tell_write.html">zip_source_tell_write(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_write</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_write</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_write.mdoc -- write data to zip source
+.\" Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_WRITE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_source_zip.mdoc -- create data source from zip file
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_SOURCE_ZIP(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_source_zip</b> — <span class="Nd">create data source
- from zip file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_source_zip</code> —
+<div class="Nd">create data source from zip file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">zip_source_t *</var>
-<br/>
-<b class="Fn">zip_source_zip</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_t
- *srcarchive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- srcidx</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
- len</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The function <b class="Fn">zip_source_zip</b>() creates a zip source from a file
- in a zip archive. The <var class="Ar">srcarchive</var> argument is the (open)
- zip archive containing the source zip file at index
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">zip_source_t *</var>
+ <br/>
+ <code class="Fn">zip_source_zip</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_t
+ *srcarchive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ srcidx</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ start</var>, <var class="Fa" style="white-space: nowrap;">zip_int64_t
+ len</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The function <code class="Fn">zip_source_zip</code>() creates a zip source from
+ a file in a zip archive. The <var class="Ar">srcarchive</var> argument is the
+ (open) zip archive containing the source zip file at index
<var class="Ar">srcidx</var>. <var class="Ar">len</var> bytes from offset
<var class="Ar">start</var> will be used in the zip_source. If
<var class="Ar">len</var> is 0 or -1, the rest of the file, starting from
<var class="Ar">start</var>, is used. If <var class="Ar">start</var> is zero
and <var class="Ar">len</var> is -1, the whole file will be copied without
decompressing it.
-<div class="Pp"></div>
-Supported flags are:
-<dl class="Bl-tag" style="margin-left: 21.00ex;">
- <dt class="It-tag" style="margin-left: -21.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -21.00ex;"><code class="Dv">ZIP_FL_UNCHANGED</code></dt>
- <dd class="It-tag">Try to get the original data without any changes that may
- have been made to <var class="Ar">srcarchive</var> after opening it.</dd>
- <dt class="It-tag" style="margin-left: -21.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -21.00ex;"><code class="Dv">ZIP_FL_RECOMPRESS</code></dt>
- <dd class="It-tag">When adding the data from <var class="Ar">srcarchive</var>,
- re-compress it using the current settings instead of copying the
- compressed data.</dd>
+<p class="Pp">Supported flags are:</p>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#ZIP_FL_UNCHANGED"><code class="Dv" id="ZIP_FL_UNCHANGED">ZIP_FL_UNCHANGED</code></a></dt>
+ <dd>Try to get the original data without any changes that may have been made
+ to <var class="Ar">srcarchive</var> after opening it.</dd>
+ <dt><a class="permalink" href="#ZIP_FL_RECOMPRESS"><code class="Dv" id="ZIP_FL_RECOMPRESS">ZIP_FL_RECOMPRESS</code></a></dt>
+ <dd>When adding the data from <var class="Ar">srcarchive</var>, re-compress it
+ using the current settings instead of copying the compressed data.</dd>
</dl>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion, the created source is returned. Otherwise,
<code class="Dv">NULL</code> is returned and the error code in
<var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_source_zip</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_CHANGED</code>]</dt>
- <dd class="It-tag">Unchanged data was requested, but it is not available.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">srcarchive</var>,
- <var class="Ar">srcidx</var>, <var class="Ar">start</var>, or
- <var class="Ar">len</var> are invalid.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_MEMORY</code>]</dt>
- <dd class="It-tag">Required memory could not be allocated.</dd>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_source_zip</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_CHANGED"><code class="Er" id="ZIP_ER_CHANGED">ZIP_ER_CHANGED</code></a>]</dt>
+ <dd>Unchanged data was requested, but it is not available.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">srcarchive</var>, <var class="Ar">srcidx</var>,
+ <var class="Ar">start</var>, or <var class="Ar">len</var> are
+ invalid.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_MEMORY"><code class="Er" id="ZIP_ER_MEMORY">ZIP_ER_MEMORY</code></a>]</dt>
+ <dd>Required memory could not be allocated.</dd>
</dl>
Additionally, it can return all error codes from
- <b class="Fn">zip_stat_index</b>() and <b class="Fn">zip_fopen_index</b>().
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+ <code class="Fn">zip_stat_index</code>() and
+ <code class="Fn">zip_fopen_index</code>().
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
- <a class="Xr" href="zip_add.html">zip_add(3)</a>,
- <a class="Xr" href="zip_replace.html">zip_replace(3)</a>,
+ <a class="Xr" href="zip_file_add.html">zip_file_add(3)</a>,
+ <a class="Xr" href="zip_file_replace.html">zip_file_replace(3)</a>,
<a class="Xr" href="zip_source.html">zip_source(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_source_zip</b>() was added in libzip 1.0.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_source_zip</code>() was added in libzip 1.0.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_source_zip.mdoc -- create data source from zip file
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_SOURCE_ZIP" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
.PD
.SH "SEE ALSO"
libzip(3),
-zip_add(3),
-zip_replace(3),
+zip_file_add(3),
+zip_file_replace(3),
zip_source(3)
.SH "HISTORY"
\fBzip_source_zip\fR()
.\" zip_source_zip.mdoc -- create data source from zip file
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Fn zip_fopen_index .
.Sh SEE ALSO
.Xr libzip 3 ,
-.Xr zip_add 3 ,
-.Xr zip_replace 3 ,
+.Xr zip_file_add 3 ,
+.Xr zip_file_replace 3 ,
.Xr zip_source 3
.Sh HISTORY
.Fn zip_source_zip
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_stat.mdoc -- get information about file
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_STAT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_stat</b>, <b class="Nm">zip_stat_index</b> —
- <span class="Nd">get information about file</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_stat</code>, <code class="Nm">zip_stat_index</code>
+ —
+<div class="Nd">get information about file</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_stat</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
- *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
- *sb</var>);
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_stat_index</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
- flags</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
- *sb</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_stat</b>() function obtains information about the file
- named <var class="Ar">fname</var> in <var class="Ar">archive</var>. The
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_stat</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">const char
+ *fname</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
+ *sb</var>);</p>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_stat_index</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>, <var class="Fa" style="white-space: nowrap;">zip_flags_t
+ flags</var>, <var class="Fa" style="white-space: nowrap;">zip_stat_t
+ *sb</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_stat</code>() function obtains information about the
+ file named <var class="Ar">fname</var> in <var class="Ar">archive</var>. The
<var class="Ar">flags</var> argument specifies how the name lookup should be
done. Its values are described in
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>. Also,
<code class="Dv">ZIP_FL_UNCHANGED</code> may be
<i class="Em">or</i><span class="No">'ed</span> to it to request information
about the original file in the archive, ignoring any changes made.
-<div class="Pp"></div>
-The <b class="Fn">zip_stat_index</b>() function obtains information about the
- file at position <var class="Ar">index</var>.
-<div class="Pp"></div>
-The <var class="Ar">sb</var> argument is a pointer to a <var class="Ft">struct
- zip_stat</var> (shown below), into which information about the file is placed.
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 0.00ex;">
-<pre class="Li">
-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 */
+<p class="Pp">The <code class="Fn">zip_stat_index</code>() function obtains
+ information about the file at position <var class="Ar">index</var>.</p>
+<p class="Pp">The <var class="Ar">sb</var> argument is a pointer to a
+ <var class="Ft">struct zip_stat</var> (shown below), into which information
+ about the file is placed.</p>
+<div class="Bd Pp">
+<pre>
+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 */
};
</pre>
</div>
The structure pointed to by <var class="Ar">sb</var> must be allocated before
- calling <b class="Fn">zip_stat</b>() or <b class="Fn">zip_stat_index</b>().
-<div class="Pp"></div>
-The <var class="Ar">valid</var> field of the structure specifies which other
- fields are valid. Check if the flag defined by the following defines are in
- <var class="Ar">valid</var> before accessing the fields:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 28.00ex;">
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_NAME</code></dt>
- <dd class="It-tag"><var class="Ar">name</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_INDEX</code></dt>
- <dd class="It-tag"><var class="Ar">index</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_SIZE</code></dt>
- <dd class="It-tag"><var class="Ar">size</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_COMP_SIZE</code></dt>
- <dd class="It-tag"><var class="Ar">comp_size</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_MTIME</code></dt>
- <dd class="It-tag"><var class="Ar">mtime</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_CRC</code></dt>
- <dd class="It-tag"><var class="Ar">crc</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_COMP_METHOD</code></dt>
- <dd class="It-tag"><var class="Ar">comp_method</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_ENCRYPTION_METHOD</code></dt>
- <dd class="It-tag"><var class="Ar">encryption_method</var></dd>
- <dt class="It-tag" style="margin-left: -28.00ex;"><code class="Dv">ZIP_STAT_FLAGS</code></dt>
- <dd class="It-tag"><var class="Ar">flags</var></dd>
+ calling <code class="Fn">zip_stat</code>() or
+ <code class="Fn">zip_stat_index</code>().
+<p class="Pp">The <var class="Ar">valid</var> field of the structure specifies
+ which other fields are valid. Check if the flag defined by the following
+ defines are in <var class="Ar">valid</var> before accessing the fields:</p>
+<div class="Bd-indent">
+<dl class="Bl-tag Bl-compact">
+ <dt><a class="permalink" href="#ZIP_STAT_NAME"><code class="Dv" id="ZIP_STAT_NAME">ZIP_STAT_NAME</code></a></dt>
+ <dd><var class="Ar">name</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_INDEX"><code class="Dv" id="ZIP_STAT_INDEX">ZIP_STAT_INDEX</code></a></dt>
+ <dd><var class="Ar">index</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_SIZE"><code class="Dv" id="ZIP_STAT_SIZE">ZIP_STAT_SIZE</code></a></dt>
+ <dd><var class="Ar">size</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_COMP_SIZE"><code class="Dv" id="ZIP_STAT_COMP_SIZE">ZIP_STAT_COMP_SIZE</code></a></dt>
+ <dd><var class="Ar">comp_size</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_MTIME"><code class="Dv" id="ZIP_STAT_MTIME">ZIP_STAT_MTIME</code></a></dt>
+ <dd><var class="Ar">mtime</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_CRC"><code class="Dv" id="ZIP_STAT_CRC">ZIP_STAT_CRC</code></a></dt>
+ <dd><var class="Ar">crc</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_COMP_METHOD"><code class="Dv" id="ZIP_STAT_COMP_METHOD">ZIP_STAT_COMP_METHOD</code></a></dt>
+ <dd><var class="Ar">comp_method</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_ENCRYPTION_METHOD"><code class="Dv" id="ZIP_STAT_ENCRYPTION_METHOD">ZIP_STAT_ENCRYPTION_METHOD</code></a></dt>
+ <dd><var class="Ar">encryption_method</var></dd>
+ <dt><a class="permalink" href="#ZIP_STAT_FLAGS"><code class="Dv" id="ZIP_STAT_FLAGS">ZIP_STAT_FLAGS</code></a></dt>
+ <dd><var class="Ar">flags</var></dd>
</dl>
</div>
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error information in <var class="Ar">archive</var> is set to indicate the
error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-The function <b class="Fn">zip_stat</b>() can fail for any of the errors
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+The function <code class="Fn">zip_stat</code>() can fail for any of the errors
specified for the routine
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>.
-<div class="Pp"></div>
-The function <b class="Fn">zip_stat_index</b>() fails and sets the error
- information to <code class="Er">ZIP_ER_INVAL</code> if
- <var class="Ar">index</var> is invalid. If
- <code class="Dv">ZIP_FL_UNCHANGED</code> is not set and no information can be
- obtained from the source callback, the error information is set to
- <code class="Er">ZIP_ER_CHANGED</code>.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+<p class="Pp">The function <code class="Fn">zip_stat_index</code>() fails and
+ sets the error information to <code class="Er">ZIP_ER_INVAL</code> if
+ <var class="Ar">index</var> is invalid. If
+ <code class="Dv">ZIP_FL_UNCHANGED</code> is not set and no information can
+ be obtained from the source callback, the error information is set to
+ <code class="Er">ZIP_ER_CHANGED</code>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_get_num_entries.html">zip_get_num_entries(3)</a>,
<a class="Xr" href="zip_name_locate.html">zip_name_locate(3)</a>,
<a class="Xr" href="zip_stat_init.html">zip_stat_init(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_stat</b>() was added in libzip 0.6. In libzip 0.11 the type of
- <var class="Ar">flags</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_flags_t</var>.
-<div class="Pp"></div>
-<b class="Fn">zip_stat_index</b>() was added in libzip 0.6. In libzip 0.10 the
- type of <var class="Ar">index</var> was changed from <var class="Vt">int</var>
- to <var class="Vt">zip_uint64_t</var>. In libzip 0.11 the type of
- <var class="Ar">flags</var> was changed from <var class="Vt">int</var> to
- <var class="Vt">zip_flags_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_stat</code>() was added in libzip 0.6. In libzip 0.11 the
+ type of <var class="Ar">flags</var> was changed from <var class="Vt">int</var>
+ to <var class="Vt">zip_flags_t</var>.
+<p class="Pp"><code class="Fn">zip_stat_index</code>() was added in libzip 0.6.
+ In libzip 0.10 the type of <var class="Ar">index</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_uint64_t</var>. In libzip
+ 0.11 the type of <var class="Ar">flags</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_flags_t</var>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_stat.mdoc -- get information about file
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_STAT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_stat_init.mdoc -- init zip_stat structure
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_STAT_INIT(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_stat_init</b> — <span class="Nd">initialize zip_stat
- structure</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_stat_init</code> —
+<div class="Nd">initialize zip_stat structure</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">void</var>
-<br/>
-<b class="Fn">zip_stat_init</b>(<var class="Fa" style="white-space: nowrap;">zip_stat_t
- *sb</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-The <b class="Fn">zip_stat_init</b>() function initializes the members of a
- struct zip_stat. The current members are described in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">void</var>
+ <br/>
+ <code class="Fn">zip_stat_init</code>(<var class="Fa" style="white-space: nowrap;">zip_stat_t
+ *sb</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+The <code class="Fn">zip_stat_init</code>() function initializes the members of
+ a struct zip_stat. The current members are described in
<a class="Xr" href="zip_stat.html">zip_stat(3)</a>, but this function should
be used to initialize it to make sure none are missed. The structure pointed
to by <var class="Ar">sb</var> must be allocated before calling
- <b class="Fn">zip_stat_init</b>().
-<div class="Pp"></div>
-This function should be used by functions provided to
- <a class="Xr" href="zip_source_function.html">zip_source_function(3)</a> when
- returning <code class="Dv">ZIP_SOURCE_STAT</code> information to make sure all
- fields are initialized.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+ <code class="Fn">zip_stat_init</code>().
+<p class="Pp">This function should be used by functions provided to
+ <a class="Xr" href="zip_source_function.html">zip_source_function(3)</a>
+ when returning <code class="Dv">ZIP_SOURCE_STAT</code> information to make
+ sure all fields are initialized.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
If <var class="Ar">sb</var> is valid, the function is always successful.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_stat.html">zip_stat(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_stat_init</b>() was added in libzip 0.8.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_stat_init</code>() was added in libzip 0.8.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_stat_init.mdoc -- init zip_stat structure
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_STAT_INIT" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_unchange.mdoc -- undo changes to file in zip archive
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_UNCHANGE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_unchange</b> — <span class="Nd">undo changes to file in
- zip archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_unchange</code> —
+<div class="Nd">undo changes to file in zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_unchange</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
- index</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_unchange</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>, <var class="Fa" style="white-space: nowrap;">zip_uint64_t
+ index</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
Changes to the file at position <var class="Ar">index</var> are reverted.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="ERRORS">ERRORS</h1>
-<b class="Fn">zip_unchange</b>() fails if:
-<dl class="Bl-tag" style="margin-left: 17.00ex;">
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_EXISTS</code>]</dt>
- <dd class="It-tag">Unchanging the name would result in a duplicate name in the
- archive.</dd>
- <dt class="It-tag" style="margin-left: -17.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -17.00ex;">[<code class="Er">ZIP_ER_INVAL</code>]</dt>
- <dd class="It-tag"><var class="Ar">index</var> is not a valid file index in
+</section>
+<section class="Sh">
+<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1>
+<code class="Fn">zip_unchange</code>() fails if:
+<dl class="Bl-tag">
+ <dt>[<a class="permalink" href="#ZIP_ER_EXISTS"><code class="Er" id="ZIP_ER_EXISTS">ZIP_ER_EXISTS</code></a>]</dt>
+ <dd>Unchanging the name would result in a duplicate name in the archive.</dd>
+ <dt>[<a class="permalink" href="#ZIP_ER_INVAL"><code class="Er" id="ZIP_ER_INVAL">ZIP_ER_INVAL</code></a>]</dt>
+ <dd><var class="Ar">index</var> is not a valid file index in
<var class="Ar">zip</var>.</dd>
</dl>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_unchange_all.html">zip_unchange_all(3)</a>,
<a class="Xr" href="zip_unchange_archive.html">zip_unchange_archive(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_unchange</b>() was added in libzip 0.6. In libzip 0.10 the
- type of <var class="Ar">index</var> was changed from <var class="Vt">int</var>
- to <var class="Vt">zip_uint64_t</var>.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_unchange</code>() was added in libzip 0.6. In libzip 0.10
+ the type of <var class="Ar">index</var> was changed from
+ <var class="Vt">int</var> to <var class="Vt">zip_uint64_t</var>.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_unchange.mdoc -- undo changes to file in zip archive
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_UNCHANGE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_unchange_all.mdoc -- undo changes to all files in zip archive
+ Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_UNCHANGE_ALL(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_unchange_all</b> — <span class="Nd">undo all changes in
- a zip archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_unchange_all</code> —
+<div class="Nd">undo all changes in a zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_unchange_all</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_unchange_all</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
All changes to files and global information in <var class="Ar">archive</var> are
reverted.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_unchange.html">zip_unchange(3)</a>,
<a class="Xr" href="zip_unchange_archive.html">zip_unchange_archive(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_unchange_all</b>() was added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_unchange_all</code>() was added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_unchange_all.mdoc -- undo changes to all files in zip archive
+.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_UNCHANGE_ALL" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zip_unchange_archive.mdoc -- undo changes to all files in zip archive
+ Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIP_UNCHANGE_ARCHIVE(3)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zip_unchange_archive</b> — <span class="Nd">undo global
- changes to zip archive</span>
-<h1 class="Sh" id="LIBRARY">LIBRARY</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zip_unchange_archive</code> —
+<div class="Nd">undo global changes to zip archive</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1>
libzip (-lzip)
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
-<b class="In">#include <<a class="In">zip.h</a>></b>
-<div class="Pp"></div>
-<var class="Ft">int</var>
-<br/>
-<b class="Fn">zip_unchange_archive</b>(<var class="Fa" style="white-space: nowrap;">zip_t
- *archive</var>);
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<code class="In">#include <<a class="In">zip.h</a>></code>
+<p class="Pp"><var class="Ft">int</var>
+ <br/>
+ <code class="Fn">zip_unchange_archive</code>(<var class="Fa" style="white-space: nowrap;">zip_t
+ *archive</var>);</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
Revert all global changes to the archive <var class="Ar">archive</var>. This
reverts changes to the archive comment and global flags.
-<h1 class="Sh" id="RETURN_VALUES">RETURN VALUES</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
+ VALUES</a></h1>
Upon successful completion 0 is returned. Otherwise, -1 is returned and the
error code in <var class="Ar">archive</var> is set to indicate the error.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="libzip.html">libzip(3)</a>,
<a class="Xr" href="zip_unchange.html">zip_unchange(3)</a>,
<a class="Xr" href="zip_unchange_all.html">zip_unchange_all(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Fn">zip_unchange_archive</b>() was added in libzip 0.7.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Fn">zip_unchange_archive</code>() was added in libzip 0.7.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zip_unchange_archive.mdoc -- undo changes to all files in zip archive
+.\" Copyright (C) 2006-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIP_UNCHANGE_ARCHIVE" "3" "December 18, 2017" "NiH" "Library Functions Manual"
.nh
.if n .ad l
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zipcmp.mdoc -- compare zip archives
+ Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIPCMP(1)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zipcmp</b> — <span class="Nd">compare contents of zip
- archives</span>
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zipcmp</code> —
+<div class="Nd">compare contents of zip archives</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<table class="Nm">
- <colgroup>
- <col style="width: 6.00ex;"/>
- <col/>
- </colgroup>
<tr>
- <td><b class="Nm">zipcmp</b></td>
- <td>[<span class="Op"><b class="Fl">-hipqtVv</b></span>]
- <var class="Ar">archive1 archive2</var></td>
+ <td><code class="Nm">zipcmp</code></td>
+ <td>[<code class="Fl">-hipqtVv</code>] <var class="Ar">archive1
+ archive2</var></td>
</tr>
</table>
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Nm">zipcmp</b> compares the zip archives or directories
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Nm">zipcmp</code> compares the zip archives or directories
<var class="Ar">archive1</var> and <var class="Ar">archive2</var> and checks
if they contain the same files, comparing their names, uncompressed sizes, and
CRCs. File order and compressed size differences are ignored.
-<div class="Pp"></div>
-Supported options:
-<dl class="Bl-tag" style="margin-left: 3.00ex;">
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-h</b></dt>
- <dd class="It-tag">Display a short help message and exit.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-i</b></dt>
- <dd class="It-tag">Compare names ignoring case distinctions.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-p</b></dt>
- <dd class="It-tag">Enable paranoid checks. Compares extra fields and other
- meta data. (Automatically disabled if one of the archives is a
- directory.)</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-q</b></dt>
- <dd class="It-tag">Quiet mode. Compare <b class="Fl">-v</b>.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-t</b></dt>
- <dd class="It-tag">Test zip files by comparing the contents to their
- checksums.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-V</b></dt>
- <dd class="It-tag">Display version information and exit.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-v</b></dt>
- <dd class="It-tag">Verbose mode. Print details about differences to stdout.
- (This is the default.)</dd>
+<p class="Pp">Supported options:</p>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#h"><code class="Fl" id="h">-h</code></a></dt>
+ <dd>Display a short help message and exit.</dd>
+ <dt><a class="permalink" href="#i"><code class="Fl" id="i">-i</code></a></dt>
+ <dd>Compare names ignoring case distinctions.</dd>
+ <dt><a class="permalink" href="#p"><code class="Fl" id="p">-p</code></a></dt>
+ <dd>Enable paranoid checks. Compares extra fields and other meta data.
+ (Automatically disabled if one of the archives is a directory.)</dd>
+ <dt><a class="permalink" href="#q"><code class="Fl" id="q">-q</code></a></dt>
+ <dd>Quiet mode. Compare <code class="Fl">-v</code>.</dd>
+ <dt><a class="permalink" href="#t"><code class="Fl" id="t">-t</code></a></dt>
+ <dd>Test zip files by comparing the contents to their checksums.</dd>
+ <dt><a class="permalink" href="#V"><code class="Fl" id="V">-V</code></a></dt>
+ <dd>Display version information and exit.</dd>
+ <dt><a class="permalink" href="#v"><code class="Fl" id="v">-v</code></a></dt>
+ <dd>Verbose mode. Print details about differences to stdout. (This is the
+ default.)</dd>
</dl>
-<h1 class="Sh" id="EXIT_STATUS">EXIT STATUS</h1>
-<b class="Nm">zipcmp</b> exits 0 if the two archives contain the same files, 1
- if they differ, and >1 if an error occurred.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
+ STATUS</a></h1>
+<code class="Nm">zipcmp</code> exits 0 if the two archives contain the same
+ files, 1 if they differ, and >1 if an error occurred.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="zipmerge.html">zipmerge(1)</a>,
<a class="Xr" href="ziptool.html">ziptool(1)</a>,
<a class="Xr" href="libzip.html">libzip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Nm">zipcmp</b> was added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Nm">zipcmp</code> was added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zipcmp.mdoc -- compare zip archives
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIPCMP" "1" "December 18, 2017" "NiH" "General Commands Manual"
.nh
.if n .ad l
.\" zipcmp.mdoc -- compare zip archives
-.\" Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.Sh EXIT STATUS
.Nm
exits 0 if the two archives contain the same files, 1 if they differ,
-and \*[Gt]1 if an error occurred.
+and >1 if an error occurred.
.Sh SEE ALSO
.Xr zipmerge 1 ,
.Xr ziptool 1 ,
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ zipmerge.mdoc -- merge zip archives
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIPMERGE(1)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">zipmerge</b> — <span class="Nd">merge zip archives</span>
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">zipmerge</code> —
+<div class="Nd">merge zip archives</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<table class="Nm">
- <colgroup>
- <col style="width: 8.00ex;"/>
- <col/>
- </colgroup>
<tr>
- <td><b class="Nm">zipmerge</b></td>
- <td>[<span class="Op"><b class="Fl">-DhIiSsV</b></span>]
- <var class="Ar">target-zip</var> <var class="Ar">source-zip</var>
- [<span class="Op"><var class="Ar">source-zip ...</var></span>]</td>
+ <td><code class="Nm">zipmerge</code></td>
+ <td>[<code class="Fl">-DhIiSsV</code>] <var class="Ar">target-zip</var>
+ <var class="Ar">source-zip</var> [<var class="Ar">source-zip
+ ...</var>]</td>
</tr>
</table>
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Nm">zipmerge</b> merges the source zip archives
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Nm">zipmerge</code> merges the source zip archives
<var class="Ar">source-zip</var> into the target zip archive
<var class="Ar">target-zip</var>. By default, files in the source zip archives
overwrite existing files of the same name in the target zip archive.
-<div class="Pp"></div>
-Supported options:
-<dl class="Bl-tag" style="margin-left: 3.00ex;">
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-D</b></dt>
- <dd class="It-tag">Ignore directory components in file name comparisons. This
- option is slow for archives with many files.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-h</b></dt>
- <dd class="It-tag">Display a short help message and exit.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-I</b></dt>
- <dd class="It-tag">Ignore case in file name comparisons This option is slow
+<p class="Pp">Supported options:</p>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#D"><code class="Fl" id="D">-D</code></a></dt>
+ <dd>Ignore directory components in file name comparisons. This option is slow
for archives with many files.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-i</b></dt>
- <dd class="It-tag">Ask before overwriting files. See also
- <b class="Fl">-s</b>.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-S</b></dt>
- <dd class="It-tag">Do not overwrite files that have the same size and CRC32 in
- both the source and target archives.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-s</b></dt>
- <dd class="It-tag">When <b class="Fl">-i</b> is given, do not before
- overwriting files that have the same size and CRC32.</dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><b class="Fl">-V</b></dt>
- <dd class="It-tag">Display version information and exit.</dd>
+ <dt><a class="permalink" href="#h"><code class="Fl" id="h">-h</code></a></dt>
+ <dd>Display a short help message and exit.</dd>
+ <dt><a class="permalink" href="#I"><code class="Fl" id="I">-I</code></a></dt>
+ <dd>Ignore case in file name comparisons This option is slow for archives with
+ many files.</dd>
+ <dt><a class="permalink" href="#i"><code class="Fl" id="i">-i</code></a></dt>
+ <dd>Ask before overwriting files. See also <code class="Fl">-s</code>.</dd>
+ <dt><a class="permalink" href="#S"><code class="Fl" id="S">-S</code></a></dt>
+ <dd>Do not overwrite files that have the same size and CRC32 in both the
+ source and target archives.</dd>
+ <dt><a class="permalink" href="#s"><code class="Fl" id="s">-s</code></a></dt>
+ <dd>When <code class="Fl">-i</code> is given, do not before overwriting files
+ that have the same size and CRC32.</dd>
+ <dt><a class="permalink" href="#V"><code class="Fl" id="V">-V</code></a></dt>
+ <dd>Display version information and exit.</dd>
</dl>
-<h1 class="Sh" id="EXIT_STATUS">EXIT STATUS</h1>
-<b class="Nm">zipmerge</b> exits 0 on success and >1 if an error occurred.
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
+ STATUS</a></h1>
+<code class="Nm">zipmerge</code> exits 0 on success and >1 if an error
+ occurred.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="zipcmp.html">zipcmp(1)</a>,
<a class="Xr" href="ziptool.html">ziptool(1)</a>,
<a class="Xr" href="libzip.html">libzip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Nm">zipmerge</b> was added in libzip 0.6.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Nm">zipmerge</code> was added in libzip 0.6.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" zipmerge.mdoc -- merge zip archives
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIPMERGE" "1" "December 18, 2017" "NiH" "General Commands Manual"
.nh
.if n .ad l
.\" zipmerge.mdoc -- merge zip archives
-.\" Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+.\" Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
.\"
.\" This file is part of libzip, a library to manipulate ZIP archives.
.\" The authors can be contacted at <libzip@nih.at>
.El
.Sh EXIT STATUS
.Nm
-exits 0 on success and \*[Gt]1 if an error occurred.
+exits 0 on success and >1 if an error occurred.
.Sh SEE ALSO
.Xr zipcmp 1 ,
.Xr ziptool 1 ,
<!DOCTYPE html>
<html>
+<!-- This is an automatically generated file. Do not edit.
+ ziptool.mdoc -- modify zip archives in multiple ways
+ Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+
+ This file is part of libzip, a library to manipulate ZIP archives.
+ The authors can be contacted at <libzip@nih.at>
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+ 3. The names of the authors may not be used to endorse or promote
+ products derived from this software without specific prior
+ written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+ OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+ IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+ OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+ IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ -->
<head>
<meta charset="utf-8"/>
- <style>
- table.head, table.foot { width: 100%; }
- td.head-rtitle, td.foot-os { text-align: right; }
- td.head-vol { text-align: center; }
- div.Pp { margin: 1ex 0ex; }
- </style>
<link rel="stylesheet" href="../nih-man.css" type="text/css" media="all"/>
<title>ZIPTOOL(1)</title>
</head>
</tr>
</table>
<div class="manual-text">
-<h1 class="Sh" id="NAME">NAME</h1>
-<b class="Nm">ziptool</b> — <span class="Nd">modify zip archives</span>
-<h1 class="Sh" id="SYNOPSIS">SYNOPSIS</h1>
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<code class="Nm">ziptool</code> —
+<div class="Nd">modify zip archives</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<table class="Nm">
- <colgroup>
- <col style="width: 7.00ex;"/>
- <col/>
- </colgroup>
<tr>
- <td><b class="Nm">ziptool</b></td>
- <td>[<span class="Op"><b class="Fl">-ceghnrst</b></span>]
- [<span class="Op"><b class="Fl">-l</b>
- <var class="Ar">length</var></span>]
- [<span class="Op"><b class="Fl">-o</b>
- <var class="Ar">offset</var></span>] <var class="Ar">zip-archive</var>
- <b class="Cm">command</b> [<span class="Op"><var class="Ar">command-args
- ...</var></span>] [<span class="Op"><b class="Cm">command</b>
- [<span class="Op"><var class="Ar">command-args ...</var></span>]
- ...</span>]</td>
+ <td><code class="Nm">ziptool</code></td>
+ <td>[<code class="Fl">-ceghnrst</code>] [<code class="Fl">-l</code>
+ <var class="Ar">length</var>] [<code class="Fl">-o</code>
+ <var class="Ar">offset</var>] <var class="Ar">zip-archive</var>
+ <code class="Cm">command</code> [<var class="Ar">command-args ...</var>]
+ [<code class="Cm">command</code> [<var class="Ar">command-args ...</var>]
+ ...]</td>
</tr>
</table>
-<h1 class="Sh" id="DESCRIPTION">DESCRIPTION</h1>
-<b class="Nm">ziptool</b> modifies the zip archive
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<code class="Nm">ziptool</code> modifies the zip archive
<var class="Ar">zip-archive</var> according to the
<var class="Ar">commands</var> given.
-<div class="Pp"></div>
-Supported options:
-<dl class="Bl-tag" style="margin-left: 11.00ex;">
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-c</b></dt>
- <dd class="It-tag">Check zip archive consistency when opening it.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-e</b></dt>
- <dd class="It-tag">Error if archive already exists (only useful with
- <b class="Fl">-n</b>).</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-g</b></dt>
- <dd class="It-tag">Guess file name encoding (for <b class="Cm">stat</b>
- command).</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-h</b></dt>
- <dd class="It-tag">Display help.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-l</b>
+<p class="Pp">Supported options:</p>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#c"><code class="Fl" id="c">-c</code></a></dt>
+ <dd>Check zip archive consistency when opening it.</dd>
+ <dt><a class="permalink" href="#e"><code class="Fl" id="e">-e</code></a></dt>
+ <dd>Error if archive already exists (only useful with
+ <code class="Fl">-n</code>).</dd>
+ <dt><a class="permalink" href="#g"><code class="Fl" id="g">-g</code></a></dt>
+ <dd>Guess file name encoding (for <code class="Cm">stat</code> command).</dd>
+ <dt><a class="permalink" href="#h"><code class="Fl" id="h">-h</code></a></dt>
+ <dd>Display help.</dd>
+ <dt><a class="permalink" href="#l"><code class="Fl" id="l">-l</code></a>
<var class="Ar">length</var></dt>
- <dd class="It-tag">Only read <var class="Ar">length</var> bytes of archive.
- See also <b class="Fl">-o</b>.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-n</b></dt>
- <dd class="It-tag">Create archive if it doesn't exist. See also
- <b class="Fl">-e</b>.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-o</b>
+ <dd>Only read <var class="Ar">length</var> bytes of archive. See also
+ <code class="Fl">-o</code>.</dd>
+ <dt><a class="permalink" href="#n"><code class="Fl" id="n">-n</code></a></dt>
+ <dd>Create archive if it doesn't exist. See also
+ <code class="Fl">-e</code>.</dd>
+ <dt><a class="permalink" href="#o"><code class="Fl" id="o">-o</code></a>
<var class="Ar">offset</var></dt>
- <dd class="It-tag">Start reading input archive from
- <var class="Ar">offset</var>. See also <b class="Fl">-l</b>.</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-r</b></dt>
- <dd class="It-tag">Print raw file name encoding without translation (for
- <b class="Cm">stat</b> command).</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-s</b></dt>
- <dd class="It-tag">Follow file name convention strictly (for
- <b class="Cm">stat</b> command).</dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -11.00ex;"><b class="Fl">-t</b></dt>
- <dd class="It-tag">Disregard current file contents, if any.
- <i class="Em">Note</i>: use this with care, it deletes all existing file
- contents when you modify the archive.</dd>
+ <dd>Start reading input archive from <var class="Ar">offset</var>. See also
+ <code class="Fl">-l</code>.</dd>
+ <dt><a class="permalink" href="#r"><code class="Fl" id="r">-r</code></a></dt>
+ <dd>Print raw file name encoding without translation (for
+ <code class="Cm">stat</code> command).</dd>
+ <dt><a class="permalink" href="#s"><code class="Fl" id="s">-s</code></a></dt>
+ <dd>Follow file name convention strictly (for <code class="Cm">stat</code>
+ command).</dd>
+ <dt><a class="permalink" href="#t"><code class="Fl" id="t">-t</code></a></dt>
+ <dd>Disregard current file contents, if any. <i class="Em">Note</i>: use this
+ with care, it deletes all existing file contents when you modify the
+ archive.</dd>
</dl>
-<h2 class="Ss" id="Commands">Commands</h2>
+<section class="Ss">
+<h2 class="Ss" id="Commands"><a class="permalink" href="#Commands">Commands</a></h2>
For all commands below, the index is zero-based. In other words, the first entry
in the zip archive has index 0.
-<div class="Pp"></div>
-Supported commands and arguments are:
-<dl class="Bl-tag" style="margin-left: 10.00ex;">
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">add</b>
+<p class="Pp">Supported commands and arguments are:</p>
+<dl class="Bl-tag">
+ <dt><a class="permalink" href="#add"><code class="Cm" id="add">add</code></a>
<var class="Ar">name content</var></dt>
- <dd class="It-tag">Add file called <var class="Ar">name</var> using the string
+ <dd>Add file called <var class="Ar">name</var> using the string
<var class="Ar">content</var> from the command line as data.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">add_dir</b>
+ <dt><a class="permalink" href="#add_dir"><code class="Cm" id="add_dir">add_dir</code></a>
<var class="Ar">name</var></dt>
- <dd class="It-tag">Add directory <var class="Ar">name</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">add_file</b>
+ <dd>Add directory <var class="Ar">name</var>.</dd>
+ <dt><a class="permalink" href="#add_file"><code class="Cm" id="add_file">add_file</code></a>
<var class="Ar">name file_to_add offset len</var></dt>
- <dd class="It-tag">Add file <var class="Ar">name</var> to archive, using
+ <dd>Add file <var class="Ar">name</var> to archive, using
<var class="Ar">len</var> bytes from the file
<var class="Ar">file_to_add</var> as input data, starting at
<var class="Ar">offset</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">add_from_zip</b>
+ <dt><a class="permalink" href="#add_from_zip"><code class="Cm" id="add_from_zip">add_from_zip</code></a>
<var class="Ar">name archivename index offset len</var></dt>
- <dd class="It-tag">Add file called <var class="Ar">name</var> to archive using
- data from another zip archive <var class="Ar">archivename</var> using the
- entry with index <var class="Ar">index</var> and reading
- <var class="Ar">len</var> bytes from <var class="Ar">offset</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">cat</b>
+ <dd>Add file called <var class="Ar">name</var> to archive using data from
+ another zip archive <var class="Ar">archivename</var> using the entry with
+ index <var class="Ar">index</var> and reading <var class="Ar">len</var>
+ bytes from <var class="Ar">offset</var>.</dd>
+ <dt><a class="permalink" href="#cat"><code class="Cm" id="cat">cat</code></a>
<var class="Ar">index</var></dt>
- <dd class="It-tag">Output file contents for entry <var class="Ar">index</var>
- to stdout.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">count_extra</b>
+ <dd>Output file contents for entry <var class="Ar">index</var> to stdout.</dd>
+ <dt><a class="permalink" href="#count_extra"><code class="Cm" id="count_extra">count_extra</code></a>
<var class="Ar">index flags</var></dt>
- <dd class="It-tag">Print the number of extra fields for archive entry
+ <dd>Print the number of extra fields for archive entry
<var class="Ar">index</var> using <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">count_extra_by_id</b>
+ <dt><a class="permalink" href="#count_extra_by_id"><code class="Cm" id="count_extra_by_id">count_extra_by_id</code></a>
<var class="Ar">index extra_id flags</var></dt>
- <dd class="It-tag">Print number of extra fields of type
- <var class="Ar">extra_id</var> for archive entry
- <var class="Ar">index</var> using <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">delete</b>
+ <dd>Print number of extra fields of type <var class="Ar">extra_id</var> for
+ archive entry <var class="Ar">index</var> using
+ <var class="Ar">flags</var>.</dd>
+ <dt><a class="permalink" href="#delete"><code class="Cm" id="delete">delete</code></a>
<var class="Ar">index</var></dt>
- <dd class="It-tag">Remove entry at <var class="Ar">index</var> from zip
- archive.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">delete_extra</b>
+ <dd>Remove entry at <var class="Ar">index</var> from zip archive.</dd>
+ <dt><a class="permalink" href="#delete_extra"><code class="Cm" id="delete_extra">delete_extra</code></a>
<var class="Ar">index extra_idx flags</var></dt>
- <dd class="It-tag">Remove extra field number <var class="Ar">extra_idx</var>
- from archive entry <var class="Ar">index</var> using
- <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">delete_extra_by_id</b>
+ <dd>Remove extra field number <var class="Ar">extra_idx</var> from archive
+ entry <var class="Ar">index</var> using <var class="Ar">flags</var>.</dd>
+ <dt><a class="permalink" href="#delete_extra_by_id"><code class="Cm" id="delete_extra_by_id">delete_extra_by_id</code></a>
<var class="Ar">index extra_id extra_index flags</var></dt>
- <dd class="It-tag">Remove extra field number <var class="Ar">extra_index</var>
- of type <var class="Ar">extra_id</var> from archive entry
+ <dd>Remove extra field number <var class="Ar">extra_index</var> of type
+ <var class="Ar">extra_id</var> from archive entry
<var class="Ar">index</var> using <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">get_archive_comment</b></dt>
- <dd class="It-tag">Print archive comment.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">get_extra</b>
+ <dt><a class="permalink" href="#get_archive_comment"><code class="Cm" id="get_archive_comment">get_archive_comment</code></a></dt>
+ <dd>Print archive comment.</dd>
+ <dt><a class="permalink" href="#get_extra"><code class="Cm" id="get_extra">get_extra</code></a>
<var class="Ar">index extra_index flags</var></dt>
- <dd class="It-tag">Print extra field <var class="Ar">extra_index</var> for
- archive entry <var class="Ar">index</var> using
- <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">get_extra_by_id</b>
+ <dd>Print extra field <var class="Ar">extra_index</var> for archive entry
+ <var class="Ar">index</var> using <var class="Ar">flags</var>.</dd>
+ <dt><a class="permalink" href="#get_extra_by_id"><code class="Cm" id="get_extra_by_id">get_extra_by_id</code></a>
<var class="Ar">index extra_id extra_index flags</var></dt>
- <dd class="It-tag">Print extra field <var class="Ar">extra_index</var> of type
+ <dd>Print extra field <var class="Ar">extra_index</var> of type
<var class="Ar">extra_id</var> for archive entry
<var class="Ar">index</var> using <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">get_file_comment</b>
+ <dt><a class="permalink" href="#get_file_comment"><code class="Cm" id="get_file_comment">get_file_comment</code></a>
<var class="Ar">index</var></dt>
- <dd class="It-tag">Get file comment for archive entry
- <var class="Ar">index</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">get_num_entries</b>
+ <dd>Get file comment for archive entry <var class="Ar">index</var>.</dd>
+ <dt><a class="permalink" href="#get_num_entries"><code class="Cm" id="get_num_entries">get_num_entries</code></a>
<var class="Ar">flags</var></dt>
- <dd class="It-tag">Print number of entries in archive using
- <var class="Ar">flags</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">name_locate</b>
+ <dd>Print number of entries in archive using <var class="Ar">flags</var>.</dd>
+ <dt><a class="permalink" href="#name_locate"><code class="Cm" id="name_locate">name_locate</code></a>
<var class="Ar">name flags</var></dt>
- <dd class="It-tag">Find entry in archive with the filename
- <var class="Ar">name</var> using <var class="Ar">flags</var> and print its
- index.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">rename</b>
+ <dd>Find entry in archive with the filename <var class="Ar">name</var> using
+ <var class="Ar">flags</var> and print its index.</dd>
+ <dt><a class="permalink" href="#rename"><code class="Cm" id="rename">rename</code></a>
<var class="Ar">index name</var></dt>
- <dd class="It-tag">Rename archive entry <var class="Ar">index</var> to
+ <dd>Rename archive entry <var class="Ar">index</var> to
<var class="Ar">name</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">replace_file_contents</b>
+ <dt><a class="permalink" href="#replace_file_contents"><code class="Cm" id="replace_file_contents">replace_file_contents</code></a>
<var class="Ar">index data</var></dt>
- <dd class="It-tag">Replace file contents for archive entry
- <var class="Ar">index</var> with the string
- <var class="Ar">data</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_archive_comment</b>
+ <dd>Replace file contents for archive entry <var class="Ar">index</var> with
+ the string <var class="Ar">data</var>.</dd>
+ <dt><a class="permalink" href="#set_archive_comment"><code class="Cm" id="set_archive_comment">set_archive_comment</code></a>
<var class="Ar">comment</var></dt>
- <dd class="It-tag">Set archive comment to <var class="Ar">comment</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_extra</b>
+ <dd>Set archive comment to <var class="Ar">comment</var>.</dd>
+ <dt><a class="permalink" href="#set_extra"><code class="Cm" id="set_extra">set_extra</code></a>
<var class="Ar">index extra_id extra_index flags value</var></dt>
- <dd class="It-tag">Set extra field number <var class="Ar">extra_index</var> of
- type <var class="Ar">extra_id</var> for archive entry
+ <dd>Set extra field number <var class="Ar">extra_index</var> of type
+ <var class="Ar">extra_id</var> for archive entry
<var class="Ar">index</var> using <var class="Ar">flags</var> to
<var class="Ar">value</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_file_comment</b>
+ <dt><a class="permalink" href="#set_file_comment"><code class="Cm" id="set_file_comment">set_file_comment</code></a>
<var class="Ar">index comment</var></dt>
- <dd class="It-tag">Set file comment for archive entry
- <var class="Ar">index</var> to string <var class="Ar">comment</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_file_compression</b>
+ <dd>Set file comment for archive entry <var class="Ar">index</var> to string
+ <var class="Ar">comment</var>.</dd>
+ <dt><a class="permalink" href="#set_file_compression"><code class="Cm" id="set_file_compression">set_file_compression</code></a>
<var class="Ar">index method compression_flags</var></dt>
- <dd class="It-tag">Set file compression method for archive entry
- <var class="Ar">index</var> to <var class="Ar">method</var> using
+ <dd>Set file compression method for archive entry <var class="Ar">index</var>
+ to <var class="Ar">method</var> using
<var class="Ar">compression_flags</var>. <i class="Em">Note</i>:
Currently, <var class="Ar">compression_flags</var> are ignored.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_file_encryption</b>
+ <dt><a class="permalink" href="#set_file_encryption"><code class="Cm" id="set_file_encryption">set_file_encryption</code></a>
<var class="Ar">index method password</var></dt>
- <dd class="It-tag">Set file encryption method for archive entry
- <var class="Ar">index</var> to <var class="Ar">method</var> with password
+ <dd>Set file encryption method for archive entry <var class="Ar">index</var>
+ to <var class="Ar">method</var> with password
<var class="Ar">password</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_file_mtime</b>
+ <dt><a class="permalink" href="#set_file_mtime"><code class="Cm" id="set_file_mtime">set_file_mtime</code></a>
<var class="Ar">index timestamp</var></dt>
- <dd class="It-tag">Set file modification time for archive entry
- <var class="Ar">index</var> to UNIX mtime
- <var class="Ar">timestamp</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_file_mtime_all</b>
+ <dd>Set file modification time for archive entry <var class="Ar">index</var>
+ to UNIX mtime <var class="Ar">timestamp</var>.</dd>
+ <dt><a class="permalink" href="#set_file_mtime_all"><code class="Cm" id="set_file_mtime_all">set_file_mtime_all</code></a>
<var class="Ar">timestamp</var></dt>
- <dd class="It-tag">Set file modification time for all archive entries to UNIX
- mtime <var class="Ar">timestamp</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">set_password</b>
+ <dd>Set file modification time for all archive entries to UNIX mtime
+ <var class="Ar">timestamp</var>.</dd>
+ <dt><a class="permalink" href="#set_password"><code class="Cm" id="set_password">set_password</code></a>
<var class="Ar">password</var></dt>
- <dd class="It-tag">Set default password for encryption/decryption to
+ <dd>Set default password for encryption/decryption to
<var class="Ar">password</var>.</dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"> </dt>
- <dd class="It-tag"> </dd>
- <dt class="It-tag" style="margin-left: -10.00ex;"><b class="Cm">stat</b>
+ <dt><a class="permalink" href="#stat"><code class="Cm" id="stat">stat</code></a>
<var class="Ar">index</var></dt>
- <dd class="It-tag">Print information about archive entry
- <var class="Ar">index</var>.</dd>
+ <dd>Print information about archive entry <var class="Ar">index</var>.</dd>
</dl>
-<h2 class="Ss" id="Flags">Flags</h2>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="Flags"><a class="permalink" href="#Flags">Flags</a></h2>
Some commands take flag arguments. Supported flags are:
-<div class="Bl-tag" style="margin-left: 6.00ex;">
-<dl class="Bl-tag" style="margin-left: 3.00ex;">
- <dt class="It-tag" style="margin-left: -3.00ex;"><var class="Ar">C</var></dt>
- <dd class="It-tag"><code class="Dv">ZIP_FL_NOCASE</code></dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><var class="Ar">c</var></dt>
- <dd class="It-tag"><code class="Dv">ZIP_FL_CENTRAL</code></dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><var class="Ar">d</var></dt>
- <dd class="It-tag"><code class="Dv">ZIP_FL_NODIR</code></dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><var class="Ar">l</var></dt>
- <dd class="It-tag"><code class="Dv">ZIP_FL_LOCAL</code></dd>
- <dt class="It-tag" style="margin-left: -3.00ex;"><var class="Ar">u</var></dt>
- <dd class="It-tag"><code class="Dv">ZIP_FL_UNCHANGED</code></dd>
+<div class="Bd-indent">
+<dl class="Bl-tag Bl-compact">
+ <dt><var class="Ar">C</var></dt>
+ <dd><a class="permalink" href="#ZIP_FL_NOCASE"><code class="Dv" id="ZIP_FL_NOCASE">ZIP_FL_NOCASE</code></a></dd>
+ <dt><var class="Ar">c</var></dt>
+ <dd><a class="permalink" href="#ZIP_FL_CENTRAL"><code class="Dv" id="ZIP_FL_CENTRAL">ZIP_FL_CENTRAL</code></a></dd>
+ <dt><var class="Ar">d</var></dt>
+ <dd><a class="permalink" href="#ZIP_FL_NODIR"><code class="Dv" id="ZIP_FL_NODIR">ZIP_FL_NODIR</code></a></dd>
+ <dt><var class="Ar">l</var></dt>
+ <dd><a class="permalink" href="#ZIP_FL_LOCAL"><code class="Dv" id="ZIP_FL_LOCAL">ZIP_FL_LOCAL</code></a></dd>
+ <dt><var class="Ar">u</var></dt>
+ <dd><a class="permalink" href="#ZIP_FL_UNCHANGED"><code class="Dv" id="ZIP_FL_UNCHANGED">ZIP_FL_UNCHANGED</code></a></dd>
</dl>
</div>
-<h2 class="Ss" id="Compression_Methods">Compression Methods</h2>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="Compression_Methods"><a class="permalink" href="#Compression_Methods">Compression
+ Methods</a></h2>
Some commands take compression method arguments. Supported methods are:
-<ul class="Bl-bullet" style="margin-left: 6.00ex;">
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">default</code></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">deflate</code></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">store</code></li>
+<ul class="Bl-bullet Bd-indent Bl-compact">
+ <li><a class="permalink" href="#default"><code class="Dv" id="default">default</code></a></li>
+ <li><a class="permalink" href="#deflate"><code class="Dv" id="deflate">deflate</code></a></li>
+ <li><a class="permalink" href="#store"><code class="Dv" id="store">store</code></a></li>
</ul>
-<h2 class="Ss" id="Encryption_Methods">Encryption Methods</h2>
+</section>
+<section class="Ss">
+<h2 class="Ss" id="Encryption_Methods"><a class="permalink" href="#Encryption_Methods">Encryption
+ Methods</a></h2>
Some commands take encryption method arguments. Supported methods are:
-<ul class="Bl-bullet" style="margin-left: 6.00ex;">
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">none</code></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">AES-128</code></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">AES-192</code></li>
- <li class="It-bullet" style="margin-top: 0.00em;"><code class="Dv">AES-256</code></li>
+<ul class="Bl-bullet Bd-indent Bl-compact">
+ <li><a class="permalink" href="#none"><code class="Dv" id="none">none</code></a></li>
+ <li><a class="permalink" href="#AES-128"><code class="Dv" id="AES-128">AES-128</code></a></li>
+ <li><a class="permalink" href="#AES-192"><code class="Dv" id="AES-192">AES-192</code></a></li>
+ <li><a class="permalink" href="#AES-256"><code class="Dv" id="AES-256">AES-256</code></a></li>
</ul>
-<h1 class="Sh" id="EXIT_STATUS">EXIT STATUS</h1>
-The <b class="Nm">ziptool</b> utility exits 0 on success, and >0 if
- an error occurs.
-<h1 class="Sh" id="EXAMPLES">EXAMPLES</h1>
-Add a file called <i class="Pa">teststring.txt</i> to the zip archive
- <i class="Pa">testbuffer.zip</i> with data “This is a test.\n”
- where “\n” is replaced with a newline character:
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
+</section>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
+ STATUS</a></h1>
+The <code class="Nm">ziptool</code> utility exits 0 on success,
+ and >0 if an error occurs.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
+Add a file called <span class="Pa">teststring.txt</span> to the zip archive
+ <span class="Pa">testbuffer.zip</span> with data “This is a
+ test.\n” where “\n” is replaced with a newline character:
+<div class="Bd Pp Bd-indent">
+<pre>
ziptool testbuffer.zip add teststring.txt \"This is a test.\n\"
</pre>
</div>
-<div class="Pp"></div>
-Delete the first file from the zip archive <i class="Pa">testfile.zip</i>:
-<div class="Pp"></div>
-<div class="Bd" style="margin-left: 5.00ex;">
-<pre class="Li">
+<p class="Pp">Delete the first file from the zip archive
+ <span class="Pa">testfile.zip</span>:</p>
+<div class="Bd Pp Bd-indent">
+<pre>
ziptool testfile.zip delete 0
</pre>
</div>
-<h1 class="Sh" id="SEE_ALSO">SEE ALSO</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
<a class="Xr" href="zipcmp.html">zipcmp(1)</a>,
<a class="Xr" href="zipmerge.html">zipmerge(1)</a>,
<a class="Xr" href="libzip.html">libzip(3)</a>
-<h1 class="Sh" id="HISTORY">HISTORY</h1>
-<b class="Nm">ziptool</b> was added in libzip 1.1.
-<h1 class="Sh" id="AUTHORS">AUTHORS</h1>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<code class="Nm">ziptool</code> was added in libzip 1.1.
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<span class="An">Dieter Baron</span>
<<a class="Mt" href="mailto:dillo@nih.at">dillo@nih.at</a>> and
<span class="An">Thomas Klausner</span>
- <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>></div>
+ <<a class="Mt" href="mailto:tk@giga.or.at">tk@giga.or.at</a>>
+</section>
+</div>
<table class="foot">
<tr>
<td class="foot-date">December 18, 2017</td>
- <td class="foot-os">NetBSD 8.99.14</td>
+ <td class="foot-os">NetBSD 8.99.35</td>
</tr>
</table>
</body>
+.\" Automatically generated from an mdoc input file. Do not edit.
+.\" ziptool.mdoc -- modify zip archives in multiple ways
+.\" Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+.\"
+.\" This file is part of libzip, a library to manipulate ZIP archives.
+.\" The authors can be contacted at <libzip@nih.at>
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in
+.\" the documentation and/or other materials provided with the
+.\" distribution.
+.\" 3. The names of the authors may not be used to endorse or promote
+.\" products derived from this software without specific prior
+.\" written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
+.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
+.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
.TH "ZIPTOOL" "1" "December 18, 2017" "NiH" "General Commands Manual"
.nh
.if n .ad l
/*
add_from_filep.c -- test case for adding file to archive
- Copyright (C) 1999-2014 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
can_clone_file.c -- does the current filesystem support cloning
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
fopen_unchanged.c -- test case for adding file and reading from unchanged
- Copyright (C) 2012-2015 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
fread.c -- test cases for reading from zip archives
- Copyright (C) 2004-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
int verbose;
-const char *prg;
+const char *progname;
#define USAGE "usage: %s [-v] archive\n"
int
verbose = 0;
fail = 0;
- prg = argv[0];
+ progname = argv[0];
while ((c = getopt(argc, argv, "v")) != -1) {
switch (c) {
break;
default:
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
return 1;
}
}
if (argc - optind != 1) {
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
return 1;
}
if ((z = zip_open(archive, 0, &ze)) == NULL) {
zip_error_t error;
zip_error_init_with_code(&error, ze);
- fprintf(stderr, "%s: can't open zip archive '%s': %s\n", prg, archive, zip_error_strerror(&error));
+ fprintf(stderr, "%s: can't open zip archive '%s': %s\n", progname, archive, zip_error_strerror(&error));
zip_error_fini(&error);
return 1;
}
zs = zip_source_buffer(z, "asdf", 4, 0);
if ((idx = zip_name_locate(z, "storedok", 0)) < 0) {
- fprintf(stderr, "%s: can't locate 'storedok' in zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't locate 'storedok' in zip archive '%s': %s\n", progname, archive, zip_strerror(z));
fail++;
}
else {
if (zip_replace(z, (zip_uint64_t)idx, zs) < 0) {
- fprintf(stderr, "%s: can't replace 'storedok' in zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't replace 'storedok' in zip archive '%s': %s\n", progname, archive, zip_strerror(z));
fail++;
}
else {
}
}
if ((idx = zip_name_locate(z, "storedok", 0)) < 0) {
- fprintf(stderr, "%s: can't locate 'storedok' in zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't locate 'storedok' in zip archive '%s': %s\n", progname, archive, zip_strerror(z));
fail++;
}
else {
if (zip_delete(z, (zip_uint64_t)idx) < 0) {
- fprintf(stderr, "%s: can't replace 'storedok' in zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't replace 'storedok' in zip archive '%s': %s\n", progname, archive, zip_strerror(z));
fail++;
}
else {
}
zs = zip_source_buffer(z, "asdf", 4, 0);
if (zip_file_add(z, "new_file", zs, 0) < 0) {
- fprintf(stderr, "%s: can't add file to zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't add file to zip archive '%s': %s\n", progname, archive, zip_strerror(z));
fail++;
}
else {
zip_unchange_all(z);
if (zip_close(z) == -1) {
- fprintf(stderr, "%s: can't close zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't close zip archive '%s': %s\n", progname, archive, zip_strerror(z));
return 1;
}
}
if (when_got != when_ex || zip_error_code_zip(&error_got) != zip_error_code_zip(&error_ex) || zip_error_code_system(&error_got) != zip_error_code_system(&error_ex)) {
- printf("%s: %s: got %s error (%s), expected %s error (%s)\n", prg, name, when_name[when_got], zip_error_strerror(&error_got), when_name[when_ex], zip_error_strerror(&error_ex));
+ printf("%s: %s: got %s error (%s), expected %s error (%s)\n", progname, name, when_name[when_got], zip_error_strerror(&error_got), when_name[when_ex], zip_error_strerror(&error_ex));
zip_error_fini(&error_got);
zip_error_fini(&error_ex);
return 1;
}
else if (verbose)
- printf("%s: %s: passed\n", prg, name);
+ printf("%s: %s: passed\n", progname, name);
return 0;
}
/*
fseek.c -- test tool for seeking in zip archives
- Copyright (C) 2016-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2016-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
#include "zip.h"
-const char *prg;
+const char *progname;
#define USAGE "usage: %s archive index offset\n"
int
zip_uint64_t index;
char b[1024];
- prg = argv[0];
+ progname = argv[0];
if (argc != 4) {
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
return 1;
}
if ((z = zip_open(archive, 0, &ze)) == NULL) {
zip_error_t error;
zip_error_init_with_code(&error, ze);
- fprintf(stderr, "%s: can't open zip archive '%s': %s\n", prg, archive, zip_error_strerror(&error));
+ fprintf(stderr, "%s: can't open zip archive '%s': %s\n", progname, archive, zip_error_strerror(&error));
zip_error_fini(&error);
return 1;
}
if ((zf = zip_fopen_index(z, index, 0)) == NULL) {
- fprintf(stderr, "%s: can't open file in archive '%s': %s\n", prg, archive, zip_error_strerror(zip_file_get_error(zf)));
+ fprintf(stderr, "%s: can't open file in archive '%s': %s\n", progname, archive, zip_error_strerror(zip_file_get_error(zf)));
zip_close(z);
return 1;
}
if (zip_fseek(zf, offset, SEEK_SET) < 0) {
- fprintf(stderr, "%s: zip_fseek failed: %s\n", prg, zip_error_strerror(zip_file_get_error(zf)));
+ fprintf(stderr, "%s: zip_fseek failed: %s\n", progname, zip_error_strerror(zip_file_get_error(zf)));
zip_close(z);
return 1;
}
printf("%.*s", (int)n, b);
}
if (n < 0) {
- fprintf(stderr, "%s: zip_fread failed: %s\n", prg, zip_error_strerror(zip_file_get_error(zf)));
+ fprintf(stderr, "%s: zip_fread failed: %s\n", progname, zip_error_strerror(zip_file_get_error(zf)));
zip_close(z);
return 1;
}
if (zip_close(z) == -1) {
- fprintf(stderr, "%s: can't close zip archive '%s': %s\n", prg, archive, zip_strerror(z));
+ fprintf(stderr, "%s: can't close zip archive '%s': %s\n", progname, archive, zip_strerror(z));
return 1;
}
/*
hole.c -- convert huge files with mostly NULs to/from source_hole
- Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
zip_source_t *source_hole_create(const char *, int flags, zip_error_t *);
-const char *prg;
+const char *progname;
static int
zip_int64_t n;
if (zip_source_open(from) < 0) {
- fprintf(stderr, "%s: can't open source for reading: %s\n", prg, zip_error_strerror(zip_source_error(from)));
+ fprintf(stderr, "%s: can't open source for reading: %s\n", progname, zip_error_strerror(zip_source_error(from)));
return -1;
}
if (zip_source_begin_write(to) < 0) {
- fprintf(stderr, "%s: can't open source for writing: %s\n", prg, zip_error_strerror(zip_source_error(to)));
+ fprintf(stderr, "%s: can't open source for writing: %s\n", progname, zip_error_strerror(zip_source_error(to)));
zip_source_close(from);
return -1;
}
while ((n = zip_source_read(from, buf, sizeof(buf))) > 0) {
if (zip_source_write(to, buf, (zip_uint64_t)n) != n) {
- fprintf(stderr, "%s: can't write to source: %s\n", prg, zip_error_strerror(zip_source_error(to)));
+ fprintf(stderr, "%s: can't write to source: %s\n", progname, zip_error_strerror(zip_source_error(to)));
zip_source_close(from);
zip_source_rollback_write(to);
return -1;
}
if (n < 0) {
- fprintf(stderr, "%s: can't read from source: %s\n", prg, zip_error_strerror(zip_source_error(from)));
+ fprintf(stderr, "%s: can't read from source: %s\n", progname, zip_error_strerror(zip_source_error(from)));
zip_source_close(from);
zip_source_rollback_write(to);
return -1;
zip_source_close(from);
if (zip_source_commit_write(to) < 0) {
- fprintf(stderr, "%s: can't commit source: %s\n", prg, zip_error_strerror(zip_source_error(to)));
+ fprintf(stderr, "%s: can't commit source: %s\n", progname, zip_error_strerror(zip_source_error(to)));
zip_source_rollback_write(to);
return -1;
}
zip_error_init(&error);
if ((src = source_hole_create(fname, flags, &error)) == NULL) {
- fprintf(stderr, "%s: can't open compressed file %s: %s\n", prg, fname, zip_error_strerror(&error));
+ fprintf(stderr, "%s: can't open compressed file %s: %s\n", progname, fname, zip_error_strerror(&error));
zip_error_fini(&error);
exit(1);
}
zip_error_init(&error);
if ((src = zip_source_file_create(fname, 0, 0, &error)) == NULL) {
- fprintf(stderr, "%s: can't open file %s: %s\n", prg, fname, zip_error_strerror(&error));
+ fprintf(stderr, "%s: can't open file %s: %s\n", progname, fname, zip_error_strerror(&error));
zip_error_fini(&error);
exit(1);
}
static void
usage(void) {
- fprintf(stderr, "usage: %s [-du] in out\n", prg);
+ fprintf(stderr, "usage: %s [-du] in out\n", progname);
fprintf(stderr, "\nOptions:\n -d decompress in\n -u update in\n");
exit(1);
}
int compress = 1;
int decompress = 0;
- prg = argv[0];
+ progname = argv[0];
while ((c = getopt(argc, argv, "du")) != -1) {
switch (c) {
/*
malloc.c -- override *alloc() to allow testing special cases
- Copyright (C) 2015-2016 Dieter Baron and Thomas Klausner
+ Copyright (C) 2015-2018 Dieter Baron and Thomas Klausner
This file is part of ckmame, a program to check rom sets for MAME.
The authors can be contacted at <ckmame@nih.at>
/*
nonrandomopen.c -- override zip_random
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of ckmame, a program to check rom sets for MAME.
The authors can be contacted at <ckmame@nih.at>
/*
nonrandomopentest.c -- test nonrandomopen.so
- Copyright (C) 2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2017-2018 Dieter Baron and Thomas Klausner
This file is part of ckmame, a program to check rom sets for MAME.
The authors can be contacted at <ckmame@nih.at>
int
main(int argc, const char *argv[]) {
- char buf[1024];
+ zip_uint8_t buf[1024];
int i;
#ifdef HAVE_CRYPTO
/*
source_hole.c -- source for handling huge files that are mostly NULs
- Copyright (C) 2014-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2014-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
tryopen.c -- tool for tests that try opening zip archives
- Copyright (C) 1999-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
getopt.h -- header for getopt() replacement function
- Copyright (C) 1999-2011 Dieter Baron and Thomas Klausner
+ Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
/*
zipcmp.c -- compare zip files
- Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
};
-const char *prg;
+const char *progname;
#define PROGRAM "zipcmp"
Report bugs to <libzip@nih.at>.\n";
char version_string[] = PROGRAM " (" PACKAGE " " VERSION ")\n\
-Copyright (C) 2003-2017 Dieter Baron and Thomas Klausner\n\
+Copyright (C) 2003-2018 Dieter Baron and Thomas Klausner\n\
" PACKAGE " comes with ABSOLUTELY NO WARRANTY, to the extent permitted by law.\n";
#define OPTIONS "hVipqtv"
main(int argc, char *const argv[]) {
int c;
- prg = argv[0];
+ progname = argv[0];
ignore_case = 0;
test_files = 0;
case 'h':
fputs(help_head, stdout);
- printf(USAGE, prg);
+ printf(USAGE, progname);
fputs(help, stdout);
exit(0);
case 'V':
exit(0);
default:
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
exit(2);
}
}
if (argc != optind + 2) {
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
exit(2);
}
if (is_directory(zn[i])) {
#ifndef HAVE_FTS_H
- fprintf(stderr, "%s: reading directories not supported\n", prg);
+ fprintf(stderr, "%s: reading directories not supported\n", progname);
exit(2);
#else
if (list_directory(zn[i], a + i) < 0)
if (paranoid) {
if (comment_compare(a[0].comment, a[0].comment_length, a[1].comment, a[1].comment_length) != 0) {
if (verbose) {
- printf("--- archive comment (%zd)\n", a[0].comment_length);
- printf("+++ archive comment (%zd)\n", a[1].comment_length);
+ printf("--- archive comment (%ld)\n", a[0].comment_length);
+ printf("+++ archive comment (%ld)\n", a[1].comment_length);
}
res = 1;
}
if ((f = fopen(fname, "r")) == NULL) {
- fprintf(stderr, "%s: can't open %s: %s\n", prg, fname, strerror(errno));
+ fprintf(stderr, "%s: can't open %s: %s\n", progname, fname, strerror(errno));
return -1;
}
}
if (ferror(f)) {
- fprintf(stderr, "%s: read error on %s: %s\n", prg, fname, strerror(errno));
+ fprintf(stderr, "%s: read error on %s: %s\n", progname, fname, strerror(errno));
fclose(f);
return -1;
}
if ((fts = fts_open(names, FTS_NOCHDIR | FTS_LOGICAL, NULL)) == NULL) {
- fprintf(stderr, "%s: can't open directory '%s': %s\n", prg, name, strerror(errno));
+ fprintf(stderr, "%s: can't open directory '%s': %s\n", progname, name, strerror(errno));
return -1;
}
prefix_length = strlen(name) + 1;
if (a->nentry >= nalloc) {
nalloc += 16;
if (nalloc > SIZE_MAX / sizeof(a->entry[0])) {
- fprintf(stderr, "%s: malloc failure\n", prg);
+ fprintf(stderr, "%s: malloc failure\n", progname);
exit(1);
}
a->entry = realloc(a->entry, sizeof(a->entry[0]) * nalloc);
if (a->entry == NULL) {
- fprintf(stderr, "%s: malloc failure\n", prg);
+ fprintf(stderr, "%s: malloc failure\n", progname);
exit(1);
}
}
}
if (fts_close(fts)) {
- fprintf(stderr, "%s: error closing directory '%s': %s\n", prg, a->name, strerror(errno));
+ fprintf(stderr, "%s: error closing directory '%s': %s\n", progname, a->name, strerror(errno));
return -1;
}
if ((za = zip_open(name, paranoid ? ZIP_CHECKCONS : 0, &err)) == NULL) {
zip_error_t error;
zip_error_init_with_code(&error, err);
- fprintf(stderr, "%s: cannot open zip archive '%s': %s\n", prg, name, zip_error_strerror(&error));
+ fprintf(stderr, "%s: cannot open zip archive '%s': %s\n", progname, name, zip_error_strerror(&error));
zip_error_fini(&error);
return -1;
}
a->entry = NULL;
else {
if ((a->nentry > SIZE_MAX / sizeof(a->entry[0])) || (a->entry = (struct entry *)malloc(sizeof(a->entry[0]) * a->nentry)) == NULL) {
- fprintf(stderr, "%s: malloc failure\n", prg);
+ fprintf(stderr, "%s: malloc failure\n", progname);
exit(1);
}
zip_uint32_t ncrc;
if ((zf = zip_fopen_index(za, idx, 0)) == NULL) {
- fprintf(stderr, "%s: cannot open file %" PRIu64 " in archive: %s\n", prg, idx, zip_strerror(za));
+ fprintf(stderr, "%s: cannot open file %" PRIu64 " in archive: %s\n", progname, idx, zip_strerror(za));
return -1;
}
}
if (n < 0) {
- fprintf(stderr, "%s: error reading file %" PRIu64 " in archive: %s\n", prg, idx, zip_file_strerror(zf));
+ fprintf(stderr, "%s: error reading file %" PRIu64 " in archive: %s\n", progname, idx, zip_file_strerror(zf));
zip_fclose(zf);
return -1;
}
zip_fclose(zf);
if (nsize != size) {
- fprintf(stderr, "%s: file %" PRIu64 ": unexpected length %" PRId64 " (should be %" PRId64 ")\n", prg, idx, nsize, size);
+ fprintf(stderr, "%s: file %" PRIu64 ": unexpected length %" PRId64 " (should be %" PRId64 ")\n", progname, idx, nsize, size);
return -2;
}
if (ncrc != crc) {
- fprintf(stderr, "%s: file %" PRIu64 ": unexpected length %x (should be %x)\n", prg, idx, ncrc, crc);
+ fprintf(stderr, "%s: file %" PRIu64 ": unexpected length %x (should be %x)\n", progname, idx, ncrc, crc);
return -2;
}
/*
zipmerge.c -- merge zip archives
- Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
#include "compat.h"
#include "zip.h"
-char *prg;
+char *progname;
#define PROGRAM "zipmerge"
Report bugs to <libzip@nih.at>.\n";
char version_string[] = PROGRAM " (" PACKAGE " " VERSION ")\n\
-Copyright (C) 2004-2017 Dieter Baron and Thomas Klausner\n\
+Copyright (C) 2004-2018 Dieter Baron and Thomas Klausner\n\
" PACKAGE " comes with ABSOLUTELY NO WARRANTY, to the extent permitted by law.\n";
#define OPTIONS "hVDiIsS"
unsigned int i, n;
char *tname;
- prg = argv[0];
+ progname = argv[0];
confirm = CONFIRM_ALL_YES;
name_flags = 0;
case 'h':
fputs(help_head, stdout);
- printf(USAGE, prg);
+ printf(USAGE, progname);
fputs(help, stdout);
exit(0);
case 'V':
exit(0);
default:
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
exit(2);
}
}
if (argc < optind + 2) {
- fprintf(stderr, USAGE, prg);
+ fprintf(stderr, USAGE, progname);
exit(2);
}
n = (unsigned int)(argc - optind);
if ((zs = (zip_t **)malloc(sizeof(zs[0]) * n)) == NULL) {
- fprintf(stderr, "%s: out of memory\n", prg);
+ fprintf(stderr, "%s: out of memory\n", progname);
exit(1);
}
if ((za = zip_open(tname, ZIP_CREATE, &err)) == NULL) {
zip_error_t error;
zip_error_init_with_code(&error, err);
- fprintf(stderr, "%s: can't open zip archive '%s': %s\n", prg, tname, zip_error_strerror(&error));
+ fprintf(stderr, "%s: can't open zip archive '%s': %s\n", progname, tname, zip_error_strerror(&error));
zip_error_fini(&error);
exit(1);
}
}
if (zip_close(za) < 0) {
- fprintf(stderr, "%s: cannot write zip archive '%s': %s\n", prg, tname, zip_strerror(za));
+ fprintf(stderr, "%s: cannot write zip archive '%s': %s\n", progname, tname, zip_strerror(za));
exit(1);
}
return 0;
if (zip_stat_index(za, it, ZIP_FL_UNCHANGED, &st) < 0) {
- fprintf(stderr, "%s: cannot stat file %" PRIu64 " in '%s': %s\n", prg, it, tname, zip_strerror(za));
+ fprintf(stderr, "%s: cannot stat file %" PRIu64 " in '%s': %s\n", progname, it, tname, zip_strerror(za));
return -1;
}
if (zip_stat_index(zs, is, 0, &ss) < 0) {
- fprintf(stderr, "%s: cannot stat file %" PRIu64 " in '%s': %s\n", prg, is, sname, zip_strerror(zs));
+ fprintf(stderr, "%s: cannot stat file %" PRIu64 " in '%s': %s\n", progname, is, sname, zip_strerror(zs));
return -1;
}
fflush(stdout);
if (fgets(line, sizeof(line), stdin) == NULL) {
- fprintf(stderr, "%s: read error from stdin: %s\n", prg, strerror(errno));
+ fprintf(stderr, "%s: read error from stdin: %s\n", progname, strerror(errno));
return -1;
}
if ((zs = zip_open(sname, 0, &err)) == NULL) {
zip_error_t error;
zip_error_init_with_code(&error, err);
- fprintf(stderr, "%s: can't open zip archive '%s': %s\n", prg, sname, zip_error_strerror(&error));
+ fprintf(stderr, "%s: can't open zip archive '%s': %s\n", progname, sname, zip_error_strerror(&error));
zip_error_fini(&error);
return NULL;
}
ret = zip_get_num_entries(zs, 0);
if (ret < 0) {
- fprintf(stderr, "%s: cannot get number of entries for '%s': %s\n", prg, sname, zip_strerror(za));
+ fprintf(stderr, "%s: cannot get number of entries for '%s': %s\n", progname, sname, zip_strerror(za));
return NULL;
}
for (i = 0; i < (zip_uint64_t)ret; i++) {
case 1:
if ((source = zip_source_zip(za, zs, i, 0, 0, 0)) == NULL || zip_replace(za, (zip_uint64_t)idx, source) < 0) {
zip_source_free(source);
- fprintf(stderr, "%s: cannot replace '%s' in `%s': %s\n", prg, fname, tname, zip_strerror(za));
+ fprintf(stderr, "%s: cannot replace '%s' in `%s': %s\n", progname, fname, tname, zip_strerror(za));
zip_close(zs);
return NULL;
}
fprintf(stderr,
"%s: internal error: "
"unexpected return code from confirm (%d)\n",
- prg, err);
+ progname, err);
zip_close(zs);
return NULL;
}
else {
if ((source = zip_source_zip(za, zs, i, 0, 0, 0)) == NULL || zip_add(za, fname, source) < 0) {
zip_source_free(source);
- fprintf(stderr, "%s: cannot add '%s' to `%s': %s\n", prg, fname, tname, zip_strerror(za));
+ fprintf(stderr, "%s: cannot add '%s' to `%s': %s\n", progname, fname, tname, zip_strerror(za));
zip_close(zs);
return NULL;
}
/*
ziptool.c -- tool for modifying zip archive in multiple ways
- Copyright (C) 2012-2017 Dieter Baron and Thomas Klausner
+ Copyright (C) 2012-2019 Dieter Baron and Thomas Klausner
This file is part of libzip, a library to manipulate ZIP archives.
The authors can be contacted at <libzip@nih.at>
if (sb.valid & ZIP_STAT_MTIME) {
struct tm *tpm;
tpm = localtime(&sb.mtime);
- strftime(buf, sizeof(buf), "%a %b %d %Y %H:%M:%S", tpm);
- printf("mtime: '%s'\n", buf);
+ if (tpm == NULL) {
+ printf("mtime: <not valid>\n");
+ } else {
+ strftime(buf, sizeof(buf), "%a %b %d %Y %H:%M:%S", tpm);
+ printf("mtime: '%s'\n", buf);
+ }
}
if (sb.valid & ZIP_STAT_CRC)
printf("crc: '%0x'\n", sb.crc);
projects / platform / upstream / libzip.git / commitdiff