source/include/zip.h

0001 #ifndef _HAD_ZIP_H
0002 #define _HAD_ZIP_H
0003
0004 /*
0005   zip.h -- exported declarations.
0006   Copyright (C) 1999-2021 Dieter Baron and Thomas Klausner
0007
0008   This file is part of libzip, a library to manipulate ZIP archives.
0009   The authors can be contacted at <info@libzip.org>
0010
0011   Redistribution and use in source and binary forms, with or without
0012   modification, are permitted provided that the following conditions
0013   are met:
0014   1. Redistributions of source code must retain the above copyright
0015      notice, this list of conditions and the following disclaimer.
0016   2. Redistributions in binary form must reproduce the above copyright
0017      notice, this list of conditions and the following disclaimer in
0018      the documentation and/or other materials provided with the
0019      distribution.
0020   3. The names of the authors may not be used to endorse or promote
0021      products derived from this software without specific prior
0022      written permission.
0023
0024   THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
0025   OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
0026   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0027   ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
0028   DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
0029   DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
0030   GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0031   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
0032   IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
0033   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
0034   IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
0035 */
0036
0037
0038 #ifdef __cplusplus
0039 extern "C" {
0040 #if 0
0041 } /* fix autoindent */
0042 #endif
0043 #endif
0044
0045 #include <zipconf.h>
0046
0047 #ifndef ZIP_EXTERN
0048 #ifndef ZIP_STATIC
0049 #ifdef _WIN32
0050 #define ZIP_EXTERN __declspec(dllimport)
0051 #elif defined(__GNUC__) && __GNUC__ >= 4
0052 #define ZIP_EXTERN __attribute__((visibility("default")))
0053 #else
0054 #define ZIP_EXTERN
0055 #endif
0056 #else
0057 #define ZIP_EXTERN
0058 #endif
0059 #endif
0060
0061 #ifndef ZIP_DEPRECATED
0062 #if defined(__GNUC__) || defined(__clang__)
0063 #define ZIP_DEPRECATED(x) __attribute__((deprecated(x)))
0064 #elif defined(_MSC_VER)
0065 #define ZIP_DEPRECATED(x) __declspec(deprecated(x))
0066 #else
0067 #define ZIP_DEPRECATED(x)
0068 #endif
0069 #endif
0070
0071 #include <stdio.h>
0072 #include <sys/types.h>
0073 #include <time.h>
0074
0075 /* flags for zip_open */
0076
0077 #define ZIP_CREATE 1
0078 #define ZIP_EXCL 2
0079 #define ZIP_CHECKCONS 4
0080 #define ZIP_TRUNCATE 8
0081 #define ZIP_RDONLY 16
0082
0083
0084 /* flags for zip_name_locate, zip_fopen, zip_stat, ... */
0085
0086 #define ZIP_FL_NOCASE 1u       /* ignore case on name lookup */
0087 #define ZIP_FL_NODIR 2u        /* ignore directory component */
0088 #define ZIP_FL_COMPRESSED 4u   /* read compressed data */
0089 #define ZIP_FL_UNCHANGED 8u    /* use original data, ignoring changes */
0090 /* 16u was ZIP_FL_RECOMPRESS, which is deprecated */
0091 #define ZIP_FL_ENCRYPTED 32u   /* read encrypted data (implies ZIP_FL_COMPRESSED) */
0092 #define ZIP_FL_ENC_GUESS 0u    /* guess string encoding (is default) */
0093 #define ZIP_FL_ENC_RAW 64u     /* get unmodified string */
0094 #define ZIP_FL_ENC_STRICT 128u /* follow specification strictly */
0095 #define ZIP_FL_LOCAL 256u      /* in local header */
0096 #define ZIP_FL_CENTRAL 512u    /* in central directory */
0097 /*                           1024u    reserved for internal use */
0098 #define ZIP_FL_ENC_UTF_8 2048u /* string is UTF-8 encoded */
0099 #define ZIP_FL_ENC_CP437 4096u /* string is CP437 encoded */
0100 #define ZIP_FL_OVERWRITE 8192u /* zip_file_add: if file with name exists, overwrite (replace) it */
0101
0102 /* archive global flags flags */
0103
0104 #define ZIP_AFL_RDONLY  2u /* read only -- cannot be cleared */
0105 #define ZIP_AFL_IS_TORRENTZIP   4u /* current archive is torrentzipped */
0106 #define ZIP_AFL_WANT_TORRENTZIP 8u /* write archive in torrentzip format */
0107 #define ZIP_AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE 16u /* don't remove file if archive is empty */
0108
0109
0110 /* create a new extra field */
0111
0112 #define ZIP_EXTRA_FIELD_ALL ZIP_UINT16_MAX
0113 #define ZIP_EXTRA_FIELD_NEW ZIP_UINT16_MAX
0114
0115 /* length parameter to various functions */
0116
0117 #define ZIP_LENGTH_TO_END 0
0118 #define ZIP_LENGTH_UNCHECKED (-2) /* only supported by zip_source_file and its variants */
0119
0120 /* libzip error codes */
0121
0122 #define ZIP_ER_OK 0               /* N No error */
0123 #define ZIP_ER_MULTIDISK 1        /* N Multi-disk zip archives not supported */
0124 #define ZIP_ER_RENAME 2           /* S Renaming temporary file failed */
0125 #define ZIP_ER_CLOSE 3            /* S Closing zip archive failed */
0126 #define ZIP_ER_SEEK 4             /* S Seek error */
0127 #define ZIP_ER_READ 5             /* S Read error */
0128 #define ZIP_ER_WRITE 6            /* S Write error */
0129 #define ZIP_ER_CRC 7              /* N CRC error */
0130 #define ZIP_ER_ZIPCLOSED 8        /* N Containing zip archive was closed */
0131 #define ZIP_ER_NOENT 9            /* N No such file */
0132 #define ZIP_ER_EXISTS 10          /* N File already exists */
0133 #define ZIP_ER_OPEN 11            /* S Can't open file */
0134 #define ZIP_ER_TMPOPEN 12         /* S Failure to create temporary file */
0135 #define ZIP_ER_ZLIB 13            /* Z Zlib error */
0136 #define ZIP_ER_MEMORY 14          /* N Malloc failure */
0137 #define ZIP_ER_CHANGED 15         /* N Entry has been changed */
0138 #define ZIP_ER_COMPNOTSUPP 16     /* N Compression method not supported */
0139 #define ZIP_ER_EOF 17             /* N Premature end of file */
0140 #define ZIP_ER_INVAL 18           /* N Invalid argument */
0141 #define ZIP_ER_NOZIP 19           /* N Not a zip archive */
0142 #define ZIP_ER_INTERNAL 20        /* N Internal error */
0143 #define ZIP_ER_INCONS 21          /* L Zip archive inconsistent */
0144 #define ZIP_ER_REMOVE 22          /* S Can't remove file */
0145 #define ZIP_ER_DELETED 23         /* N Entry has been deleted */
0146 #define ZIP_ER_ENCRNOTSUPP 24     /* N Encryption method not supported */
0147 #define ZIP_ER_RDONLY 25          /* N Read-only archive */
0148 #define ZIP_ER_NOPASSWD 26        /* N No password provided */
0149 #define ZIP_ER_WRONGPASSWD 27     /* N Wrong password provided */
0150 #define ZIP_ER_OPNOTSUPP 28       /* N Operation not supported */
0151 #define ZIP_ER_INUSE 29           /* N Resource still in use */
0152 #define ZIP_ER_TELL 30            /* S Tell error */
0153 #define ZIP_ER_COMPRESSED_DATA 31 /* N Compressed data invalid */
0154 #define ZIP_ER_CANCELLED 32       /* N Operation cancelled */
0155 #define ZIP_ER_DATA_LENGTH 33     /* N Unexpected length of data */
0156 #define ZIP_ER_NOT_ALLOWED 34     /* N Not allowed in torrentzip */
0157
0158 /* type of system error value */
0159
0160 #define ZIP_ET_NONE 0   /* sys_err unused */
0161 #define ZIP_ET_SYS 1    /* sys_err is errno */
0162 #define ZIP_ET_ZLIB 2   /* sys_err is zlib error code */
0163 #define ZIP_ET_LIBZIP 3 /* sys_err is libzip error code */
0164
0165 /* compression methods */
0166
0167 #define ZIP_CM_DEFAULT -1 /* better of deflate or store */
0168 #define ZIP_CM_STORE 0    /* stored (uncompressed) */
0169 #define ZIP_CM_SHRINK 1   /* shrunk */
0170 #define ZIP_CM_REDUCE_1 2 /* reduced with factor 1 */
0171 #define ZIP_CM_REDUCE_2 3 /* reduced with factor 2 */
0172 #define ZIP_CM_REDUCE_3 4 /* reduced with factor 3 */
0173 #define ZIP_CM_REDUCE_4 5 /* reduced with factor 4 */
0174 #define ZIP_CM_IMPLODE 6  /* imploded */
0175 /* 7 - Reserved for Tokenizing compression algorithm */
0176 #define ZIP_CM_DEFLATE 8         /* deflated */
0177 #define ZIP_CM_DEFLATE64 9       /* deflate64 */
0178 #define ZIP_CM_PKWARE_IMPLODE 10 /* PKWARE imploding */
0179 /* 11 - Reserved by PKWARE */
0180 #define ZIP_CM_BZIP2 12 /* compressed using BZIP2 algorithm */
0181 /* 13 - Reserved by PKWARE */
0182 #define ZIP_CM_LZMA 14 /* LZMA (EFS) */
0183 /* 15-17 - Reserved by PKWARE */
0184 #define ZIP_CM_TERSE 18 /* compressed using IBM TERSE (new) */
0185 #define ZIP_CM_LZ77 19  /* IBM LZ77 z Architecture (PFS) */
0186 /* 20 - old value for Zstandard */
0187 #define ZIP_CM_LZMA2 33
0188 #define ZIP_CM_ZSTD 93    /* Zstandard compressed data */
0189 #define ZIP_CM_XZ 95      /* XZ compressed data */
0190 #define ZIP_CM_JPEG 96    /* Compressed Jpeg data */
0191 #define ZIP_CM_WAVPACK 97 /* WavPack compressed data */
0192 #define ZIP_CM_PPMD 98    /* PPMd version I, Rev 1 */
0193
0194 /* encryption methods */
0195
0196 #define ZIP_EM_NONE 0         /* not encrypted */
0197 #define ZIP_EM_TRAD_PKWARE 1  /* traditional PKWARE encryption */
0198 #if 0                         /* Strong Encryption Header not parsed yet */
0199 #define ZIP_EM_DES 0x6601     /* strong encryption: DES */
0200 #define ZIP_EM_RC2_OLD 0x6602 /* strong encryption: RC2, version < 5.2 */
0201 #define ZIP_EM_3DES_168 0x6603
0202 #define ZIP_EM_3DES_112 0x6609
0203 #define ZIP_EM_PKZIP_AES_128 0x660e
0204 #define ZIP_EM_PKZIP_AES_192 0x660f
0205 #define ZIP_EM_PKZIP_AES_256 0x6610
0206 #define ZIP_EM_RC2 0x6702 /* strong encryption: RC2, version >= 5.2 */
0207 #define ZIP_EM_RC4 0x6801
0208 #endif
0209 #define ZIP_EM_AES_128 0x0101 /* Winzip AES encryption */
0210 #define ZIP_EM_AES_192 0x0102
0211 #define ZIP_EM_AES_256 0x0103
0212 #define ZIP_EM_UNKNOWN 0xffff /* unknown algorithm */
0213
0214 #define ZIP_OPSYS_DOS 0x00u
0215 #define ZIP_OPSYS_AMIGA 0x01u
0216 #define ZIP_OPSYS_OPENVMS 0x02u
0217 #define ZIP_OPSYS_UNIX 0x03u
0218 #define ZIP_OPSYS_VM_CMS 0x04u
0219 #define ZIP_OPSYS_ATARI_ST 0x05u
0220 #define ZIP_OPSYS_OS_2 0x06u
0221 #define ZIP_OPSYS_MACINTOSH 0x07u
0222 #define ZIP_OPSYS_Z_SYSTEM 0x08u
0223 #define ZIP_OPSYS_CPM 0x09u
0224 #define ZIP_OPSYS_WINDOWS_NTFS 0x0au
0225 #define ZIP_OPSYS_MVS 0x0bu
0226 #define ZIP_OPSYS_VSE 0x0cu
0227 #define ZIP_OPSYS_ACORN_RISC 0x0du
0228 #define ZIP_OPSYS_VFAT 0x0eu
0229 #define ZIP_OPSYS_ALTERNATE_MVS 0x0fu
0230 #define ZIP_OPSYS_BEOS 0x10u
0231 #define ZIP_OPSYS_TANDEM 0x11u
0232 #define ZIP_OPSYS_OS_400 0x12u
0233 #define ZIP_OPSYS_OS_X 0x13u
0234
0235 #define ZIP_OPSYS_DEFAULT ZIP_OPSYS_UNIX
0236
0237
0238 enum zip_source_cmd {
0239     ZIP_SOURCE_OPEN,                /* prepare for reading */
0240     ZIP_SOURCE_READ,                /* read data */
0241     ZIP_SOURCE_CLOSE,               /* reading is done */
0242     ZIP_SOURCE_STAT,                /* get meta information */
0243     ZIP_SOURCE_ERROR,               /* get error information */
0244     ZIP_SOURCE_FREE,                /* cleanup and free resources */
0245     ZIP_SOURCE_SEEK,                /* set position for reading */
0246     ZIP_SOURCE_TELL,                /* get read position */
0247     ZIP_SOURCE_BEGIN_WRITE,         /* prepare for writing */
0248     ZIP_SOURCE_COMMIT_WRITE,        /* writing is done */
0249     ZIP_SOURCE_ROLLBACK_WRITE,      /* discard written changes */
0250     ZIP_SOURCE_WRITE,               /* write data */
0251     ZIP_SOURCE_SEEK_WRITE,          /* set position for writing */
0252     ZIP_SOURCE_TELL_WRITE,          /* get write position */
0253     ZIP_SOURCE_SUPPORTS,            /* check whether source supports command */
0254     ZIP_SOURCE_REMOVE,              /* remove file */
0255     ZIP_SOURCE_RESERVED_1,          /* previously used internally */
0256     ZIP_SOURCE_BEGIN_WRITE_CLONING, /* like ZIP_SOURCE_BEGIN_WRITE, but keep part of original file */
0257     ZIP_SOURCE_ACCEPT_EMPTY,        /* whether empty files are valid archives */
0258     ZIP_SOURCE_GET_FILE_ATTRIBUTES, /* get additional file attributes */
0259     ZIP_SOURCE_SUPPORTS_REOPEN      /* allow reading from changed entry */
0260 };
0261 typedef enum zip_source_cmd zip_source_cmd_t;
0262
0263 #define ZIP_SOURCE_MAKE_COMMAND_BITMASK(cmd) (((zip_int64_t)1) << (cmd))
0264
0265 #define ZIP_SOURCE_CHECK_SUPPORTED(supported, cmd)  (((supported) & ZIP_SOURCE_MAKE_COMMAND_BITMASK(cmd)) != 0)
0266
0267 /* clang-format off */
0268
0269 #define ZIP_SOURCE_SUPPORTS_READABLE    (ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_OPEN) \
0270                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_READ) \
0271                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_CLOSE) \
0272                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_STAT) \
0273                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_ERROR) \
0274                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_FREE))
0275
0276 #define ZIP_SOURCE_SUPPORTS_SEEKABLE    (ZIP_SOURCE_SUPPORTS_READABLE \
0277                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_SEEK) \
0278                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_TELL) \
0279                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_SUPPORTS))
0280
0281 #define ZIP_SOURCE_SUPPORTS_WRITABLE    (ZIP_SOURCE_SUPPORTS_SEEKABLE \
0282                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_BEGIN_WRITE) \
0283                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_COMMIT_WRITE) \
0284                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_ROLLBACK_WRITE) \
0285                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_WRITE) \
0286                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_SEEK_WRITE) \
0287                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_TELL_WRITE) \
0288                                          | ZIP_SOURCE_MAKE_COMMAND_BITMASK(ZIP_SOURCE_REMOVE))
0289
0290 /* clang-format on */
0291
0292 /* for use by sources */
0293 struct zip_source_args_seek {
0294     zip_int64_t offset;
0295     int whence;
0296 };
0297
0298 typedef struct zip_source_args_seek zip_source_args_seek_t;
0299 #define ZIP_SOURCE_GET_ARGS(type, data, len, error) ((len) < sizeof(type) ? zip_error_set((error), ZIP_ER_INVAL, 0), (type *)NULL : (type *)(data))
0300
0301
0302 /* error information */
0303 /* use zip_error_*() to access */
0304 struct zip_error {
0305     int zip_err;         /* libzip error code (ZIP_ER_*) */
0306     int sys_err;         /* copy of errno (E*) or zlib error code */
0307     char *_Nullable str; /* string representation or NULL */
0308 };
0309
0310 #define ZIP_STAT_NAME 0x0001u
0311 #define ZIP_STAT_INDEX 0x0002u
0312 #define ZIP_STAT_SIZE 0x0004u
0313 #define ZIP_STAT_COMP_SIZE 0x0008u
0314 #define ZIP_STAT_MTIME 0x0010u
0315 #define ZIP_STAT_CRC 0x0020u
0316 #define ZIP_STAT_COMP_METHOD 0x0040u
0317 #define ZIP_STAT_ENCRYPTION_METHOD 0x0080u
0318 #define ZIP_STAT_FLAGS 0x0100u
0319
0320 struct zip_stat {
0321     zip_uint64_t valid;             /* which fields have valid values */
0322     const char *_Nullable name;     /* name of the file */
0323     zip_uint64_t index;             /* index within archive */
0324     zip_uint64_t size;              /* size of file (uncompressed) */
0325     zip_uint64_t comp_size;         /* size of file (compressed) */
0326     time_t mtime;                   /* modification time */
0327     zip_uint32_t crc;               /* crc of file data */
0328     zip_uint16_t comp_method;       /* compression method used */
0329     zip_uint16_t encryption_method; /* encryption method used */
0330     zip_uint32_t flags;             /* reserved for future use */
0331 };
0332
0333 struct zip_buffer_fragment {
0334     zip_uint8_t *_Nonnull data;
0335     zip_uint64_t length;
0336 };
0337
0338 struct zip_file_attributes {
0339     zip_uint64_t valid;                     /* which fields have valid values */
0340     zip_uint8_t version;                    /* version of this struct, currently 1 */
0341     zip_uint8_t host_system;                /* host system on which file was created */
0342     zip_uint8_t ascii;                      /* flag whether file is ASCII text */
0343     zip_uint8_t version_needed;             /* minimum version needed to extract file */
0344     zip_uint32_t external_file_attributes;  /* external file attributes (host-system specific) */
0345     zip_uint16_t general_purpose_bit_flags; /* general purpose big flags, only some bits are honored */
0346     zip_uint16_t general_purpose_bit_mask;  /* which bits in general_purpose_bit_flags are valid */
0347 };
0348
0349 #define ZIP_FILE_ATTRIBUTES_HOST_SYSTEM 0x0001u
0350 #define ZIP_FILE_ATTRIBUTES_ASCII 0x0002u
0351 #define ZIP_FILE_ATTRIBUTES_VERSION_NEEDED 0x0004u
0352 #define ZIP_FILE_ATTRIBUTES_EXTERNAL_FILE_ATTRIBUTES 0x0008u
0353 #define ZIP_FILE_ATTRIBUTES_GENERAL_PURPOSE_BIT_FLAGS 0x0010u
0354
0355 struct zip;
0356 struct zip_file;
0357 struct zip_source;
0358
0359 typedef struct zip zip_t;
0360 typedef struct zip_error zip_error_t;
0361 typedef struct zip_file zip_file_t;
0362 typedef struct zip_file_attributes zip_file_attributes_t;
0363 typedef struct zip_source zip_source_t;
0364 typedef struct zip_stat zip_stat_t;
0365 typedef struct zip_buffer_fragment zip_buffer_fragment_t;
0366
0367 typedef zip_uint32_t zip_flags_t;
0368
0369 typedef zip_int64_t (*zip_source_callback)(void *_Nullable, void *_Nullable, zip_uint64_t, zip_source_cmd_t);
0370 typedef zip_int64_t (*zip_source_layered_callback)(zip_source_t *_Nonnull, void *_Nullable, void *_Nullable, zip_uint64_t, enum zip_source_cmd);
0371 typedef void (*zip_progress_callback)(zip_t *_Nonnull, double, void *_Nullable);
0372 typedef int (*zip_cancel_callback)(zip_t *_Nonnull, void *_Nullable);
0373
0374 #ifndef ZIP_DISABLE_DEPRECATED
0375 #define ZIP_FL_RECOMPRESS 16u  /* force recompression of data */
0376
0377 typedef void (*zip_progress_callback_t)(double);
0378 ZIP_DEPRECATED("use 'zip_register_progress_callback_with_state' instead") ZIP_EXTERN void zip_register_progress_callback(zip_t *_Nonnull, zip_progress_callback_t _Nullable);
0379
0380 ZIP_DEPRECATED("use 'zip_file_add' instead") ZIP_EXTERN zip_int64_t zip_add(zip_t *_Nonnull, const char *_Nonnull, zip_source_t *_Nonnull);
0381 ZIP_DEPRECATED("use 'zip_dir_add' instead") ZIP_EXTERN zip_int64_t zip_add_dir(zip_t *_Nonnull, const char *_Nonnull);
0382 ZIP_DEPRECATED("use 'zip_file_get_comment' instead") ZIP_EXTERN const char *_Nullable zip_get_file_comment(zip_t *_Nonnull, zip_uint64_t, int *_Nullable, int);
0383 ZIP_DEPRECATED("use 'zip_get_num_entries' instead") ZIP_EXTERN int zip_get_num_files(zip_t *_Nonnull);
0384 ZIP_DEPRECATED("use 'zip_file_rename' instead") ZIP_EXTERN int zip_rename(zip_t *_Nonnull, zip_uint64_t, const char *_Nonnull);
0385 ZIP_DEPRECATED("use 'zip_file_replace' instead") ZIP_EXTERN int zip_replace(zip_t *_Nonnull, zip_uint64_t, zip_source_t *_Nonnull);
0386 ZIP_DEPRECATED("use 'zip_file_set_comment' instead") ZIP_EXTERN int zip_set_file_comment(zip_t *_Nonnull, zip_uint64_t, const char *_Nullable, int);
0387 ZIP_DEPRECATED("use 'zip_error_init_with_code' and 'zip_error_system_type' instead") ZIP_EXTERN int zip_error_get_sys_type(int);
0388 ZIP_DEPRECATED("use 'zip_get_error' instead") ZIP_EXTERN void zip_error_get(zip_t *_Nonnull, int *_Nullable, int *_Nullable);
0389 ZIP_DEPRECATED("use 'zip_error_strerror' instead") ZIP_EXTERN int zip_error_to_str(char *_Nonnull, zip_uint64_t, int, int);
0390 ZIP_DEPRECATED("use 'zip_file_get_error' instead") ZIP_EXTERN void zip_file_error_get(zip_file_t *_Nonnull, int *_Nullable, int *_Nullable);
0391 ZIP_DEPRECATED("use 'zip_source_zip_file' instead") 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);
0392 ZIP_DEPRECATED("use 'zip_source_zip_file_create' instead") ZIP_EXTERN zip_source_t *_Nullable zip_source_zip_create(zip_t *_Nonnull, zip_uint64_t, zip_flags_t, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0393 #endif
0394
0395 ZIP_EXTERN int zip_close(zip_t *_Nonnull);
0396 ZIP_EXTERN int zip_delete(zip_t *_Nonnull, zip_uint64_t);
0397 ZIP_EXTERN zip_int64_t zip_dir_add(zip_t *_Nonnull, const char *_Nonnull, zip_flags_t);
0398 ZIP_EXTERN void zip_discard(zip_t *_Nonnull);
0399
0400 ZIP_EXTERN zip_error_t *_Nonnull zip_get_error(zip_t *_Nonnull);
0401 ZIP_EXTERN void zip_error_clear(zip_t *_Nonnull);
0402 ZIP_EXTERN int zip_error_code_zip(const zip_error_t *_Nonnull);
0403 ZIP_EXTERN int zip_error_code_system(const zip_error_t *_Nonnull);
0404 ZIP_EXTERN void zip_error_fini(zip_error_t *_Nonnull);
0405 ZIP_EXTERN void zip_error_init(zip_error_t *_Nonnull);
0406 ZIP_EXTERN void zip_error_init_with_code(zip_error_t *_Nonnull, int);
0407 ZIP_EXTERN void zip_error_set(zip_error_t *_Nullable, int, int);
0408 ZIP_EXTERN void zip_error_set_from_source(zip_error_t *_Nonnull, zip_source_t *_Nullable);
0409 ZIP_EXTERN const char *_Nonnull zip_error_strerror(zip_error_t *_Nonnull);
0410 ZIP_EXTERN int zip_error_system_type(const zip_error_t *_Nonnull);
0411 ZIP_EXTERN zip_int64_t zip_error_to_data(const zip_error_t *_Nonnull, void *_Nonnull, zip_uint64_t);
0412
0413 ZIP_EXTERN int zip_fclose(zip_file_t *_Nonnull);
0414 ZIP_EXTERN zip_t *_Nullable zip_fdopen(int, int, int *_Nullable);
0415 ZIP_EXTERN zip_int64_t zip_file_add(zip_t *_Nonnull, const char *_Nonnull, zip_source_t *_Nonnull, zip_flags_t);
0416 ZIP_EXTERN void zip_file_attributes_init(zip_file_attributes_t *_Nonnull);
0417 ZIP_EXTERN void zip_file_error_clear(zip_file_t *_Nonnull);
0418 ZIP_EXTERN int zip_file_extra_field_delete(zip_t *_Nonnull, zip_uint64_t, zip_uint16_t, zip_flags_t);
0419 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);
0420 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);
0421 ZIP_EXTERN zip_int16_t zip_file_extra_fields_count(zip_t *_Nonnull, zip_uint64_t, zip_flags_t);
0422 ZIP_EXTERN zip_int16_t zip_file_extra_fields_count_by_id(zip_t *_Nonnull, zip_uint64_t, zip_uint16_t, zip_flags_t);
0423 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);
0424 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);
0425 ZIP_EXTERN const char *_Nullable zip_file_get_comment(zip_t *_Nonnull, zip_uint64_t, zip_uint32_t *_Nullable, zip_flags_t);
0426 ZIP_EXTERN zip_error_t *_Nonnull zip_file_get_error(zip_file_t *_Nonnull);
0427 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);
0428 ZIP_EXTERN int zip_file_is_seekable(zip_file_t *_Nonnull);
0429 ZIP_EXTERN int zip_file_rename(zip_t *_Nonnull, zip_uint64_t, const char *_Nonnull, zip_flags_t);
0430 ZIP_EXTERN int zip_file_replace(zip_t *_Nonnull, zip_uint64_t, zip_source_t *_Nonnull, zip_flags_t);
0431 ZIP_EXTERN int zip_file_set_comment(zip_t *_Nonnull, zip_uint64_t, const char *_Nullable, zip_uint16_t, zip_flags_t);
0432 ZIP_EXTERN int zip_file_set_dostime(zip_t *_Nonnull, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_flags_t);
0433 ZIP_EXTERN int zip_file_set_encryption(zip_t *_Nonnull, zip_uint64_t, zip_uint16_t, const char *_Nullable);
0434 ZIP_EXTERN int zip_file_set_external_attributes(zip_t *_Nonnull, zip_uint64_t, zip_flags_t, zip_uint8_t, zip_uint32_t);
0435 ZIP_EXTERN int zip_file_set_mtime(zip_t *_Nonnull, zip_uint64_t, time_t, zip_flags_t);
0436 ZIP_EXTERN const char *_Nonnull zip_file_strerror(zip_file_t *_Nonnull);
0437 ZIP_EXTERN zip_file_t *_Nullable zip_fopen(zip_t *_Nonnull, const char *_Nonnull, zip_flags_t);
0438 ZIP_EXTERN zip_file_t *_Nullable zip_fopen_encrypted(zip_t *_Nonnull, const char *_Nonnull, zip_flags_t, const char *_Nullable);
0439 ZIP_EXTERN zip_file_t *_Nullable zip_fopen_index(zip_t *_Nonnull, zip_uint64_t, zip_flags_t);
0440 ZIP_EXTERN zip_file_t *_Nullable zip_fopen_index_encrypted(zip_t *_Nonnull, zip_uint64_t, zip_flags_t, const char *_Nullable);
0441 ZIP_EXTERN zip_int64_t zip_fread(zip_file_t *_Nonnull, void *_Nonnull, zip_uint64_t);
0442 ZIP_EXTERN zip_int8_t zip_fseek(zip_file_t *_Nonnull, zip_int64_t, int);
0443 ZIP_EXTERN zip_int64_t zip_ftell(zip_file_t *_Nonnull);
0444 ZIP_EXTERN const char *_Nullable zip_get_archive_comment(zip_t *_Nonnull, int *_Nullable, zip_flags_t);
0445 ZIP_EXTERN int zip_get_archive_flag(zip_t *_Nonnull, zip_flags_t, zip_flags_t);
0446 ZIP_EXTERN const char *_Nullable zip_get_name(zip_t *_Nonnull, zip_uint64_t, zip_flags_t);
0447 ZIP_EXTERN zip_int64_t zip_get_num_entries(zip_t *_Nonnull, zip_flags_t);
0448 ZIP_EXTERN const char *_Nonnull zip_libzip_version(void);
0449 ZIP_EXTERN zip_int64_t zip_name_locate(zip_t *_Nonnull, const char *_Nonnull, zip_flags_t);
0450 ZIP_EXTERN zip_t *_Nullable zip_open(const char *_Nonnull, int, int *_Nullable);
0451 ZIP_EXTERN zip_t *_Nullable zip_open_from_source(zip_source_t *_Nonnull, int, zip_error_t *_Nullable);
0452 ZIP_EXTERN int zip_register_progress_callback_with_state(zip_t *_Nonnull, double, zip_progress_callback _Nullable, void (*_Nullable)(void *_Nullable), void *_Nullable);
0453 ZIP_EXTERN int zip_register_cancel_callback_with_state(zip_t *_Nonnull, zip_cancel_callback _Nullable, void (*_Nullable)(void *_Nullable), void *_Nullable);
0454 ZIP_EXTERN int zip_set_archive_comment(zip_t *_Nonnull, const char *_Nullable, zip_uint16_t);
0455 ZIP_EXTERN int zip_set_archive_flag(zip_t *_Nonnull, zip_flags_t, int);
0456 ZIP_EXTERN int zip_set_default_password(zip_t *_Nonnull, const char *_Nullable);
0457 ZIP_EXTERN int zip_set_file_compression(zip_t *_Nonnull, zip_uint64_t, zip_int32_t, zip_uint32_t);
0458 ZIP_EXTERN int zip_source_begin_write(zip_source_t *_Nonnull);
0459 ZIP_EXTERN int zip_source_begin_write_cloning(zip_source_t *_Nonnull, zip_uint64_t);
0460 ZIP_EXTERN zip_source_t *_Nullable zip_source_buffer(zip_t *_Nonnull, const void *_Nullable, zip_uint64_t, int);
0461 ZIP_EXTERN zip_source_t *_Nullable zip_source_buffer_create(const void *_Nullable, zip_uint64_t, int, zip_error_t *_Nullable);
0462 ZIP_EXTERN zip_source_t *_Nullable zip_source_buffer_fragment(zip_t *_Nonnull, const zip_buffer_fragment_t *_Nonnull, zip_uint64_t, int);
0463 ZIP_EXTERN zip_source_t *_Nullable zip_source_buffer_fragment_create(const zip_buffer_fragment_t *_Nullable, zip_uint64_t, int, zip_error_t *_Nullable);
0464 ZIP_EXTERN int zip_source_close(zip_source_t *_Nonnull);
0465 ZIP_EXTERN int zip_source_commit_write(zip_source_t *_Nonnull);
0466 ZIP_EXTERN zip_error_t *_Nonnull zip_source_error(zip_source_t *_Nonnull);
0467 ZIP_EXTERN zip_source_t *_Nullable zip_source_file(zip_t *_Nonnull, const char *_Nonnull, zip_uint64_t, zip_int64_t);
0468 ZIP_EXTERN zip_source_t *_Nullable zip_source_file_create(const char *_Nonnull, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0469 ZIP_EXTERN zip_source_t *_Nullable zip_source_filep(zip_t *_Nonnull, FILE *_Nonnull, zip_uint64_t, zip_int64_t);
0470 ZIP_EXTERN zip_source_t *_Nullable zip_source_filep_create(FILE *_Nonnull, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0471 ZIP_EXTERN void zip_source_free(zip_source_t *_Nullable);
0472 ZIP_EXTERN zip_source_t *_Nullable zip_source_function(zip_t *_Nonnull, zip_source_callback _Nonnull, void *_Nullable);
0473 ZIP_EXTERN zip_source_t *_Nullable zip_source_function_create(zip_source_callback _Nonnull, void *_Nullable, zip_error_t *_Nullable);
0474 ZIP_EXTERN int zip_source_get_file_attributes(zip_source_t *_Nonnull, zip_file_attributes_t *_Nonnull);
0475 ZIP_EXTERN int zip_source_is_deleted(zip_source_t *_Nonnull);
0476 ZIP_EXTERN int zip_source_is_seekable(zip_source_t *_Nonnull);
0477 ZIP_EXTERN void zip_source_keep(zip_source_t *_Nonnull);
0478 ZIP_EXTERN zip_source_t *_Nullable zip_source_layered(zip_t *_Nullable, zip_source_t *_Nonnull, zip_source_layered_callback _Nonnull, void *_Nullable);
0479 ZIP_EXTERN zip_source_t *_Nullable zip_source_layered_create(zip_source_t *_Nonnull, zip_source_layered_callback _Nonnull, void *_Nullable, zip_error_t *_Nullable);
0480 ZIP_EXTERN zip_int64_t zip_source_make_command_bitmap(zip_source_cmd_t, ...);
0481 ZIP_EXTERN int zip_source_open(zip_source_t *_Nonnull);
0482 ZIP_EXTERN zip_int64_t zip_source_pass_to_lower_layer(zip_source_t *_Nonnull, void *_Nullable, zip_uint64_t, zip_source_cmd_t);
0483 ZIP_EXTERN zip_int64_t zip_source_read(zip_source_t *_Nonnull, void *_Nonnull, zip_uint64_t);
0484 ZIP_EXTERN void zip_source_rollback_write(zip_source_t *_Nonnull);
0485 ZIP_EXTERN int zip_source_seek(zip_source_t *_Nonnull, zip_int64_t, int);
0486 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);
0487 ZIP_EXTERN int zip_source_seek_write(zip_source_t *_Nonnull, zip_int64_t, int);
0488 ZIP_EXTERN int zip_source_stat(zip_source_t *_Nonnull, zip_stat_t *_Nonnull);
0489 ZIP_EXTERN zip_int64_t zip_source_tell(zip_source_t *_Nonnull);
0490 ZIP_EXTERN zip_int64_t zip_source_tell_write(zip_source_t *_Nonnull);
0491 #ifdef _WIN32
0492 ZIP_EXTERN zip_source_t *_Nullable zip_source_win32a(zip_t *_Nonnull, const char *_Nonnull, zip_uint64_t, zip_int64_t);
0493 ZIP_EXTERN zip_source_t *_Nullable zip_source_win32a_create(const char *_Nonnull, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0494 ZIP_EXTERN zip_source_t *_Nullable zip_source_win32handle(zip_t *_Nonnull, void *_Nonnull, zip_uint64_t, zip_int64_t);
0495 ZIP_EXTERN zip_source_t *_Nullable zip_source_win32handle_create(void *_Nonnull, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0496 ZIP_EXTERN zip_source_t *_Nullable zip_source_win32w(zip_t *_Nonnull, const wchar_t *_Nonnull, zip_uint64_t, zip_int64_t);
0497 ZIP_EXTERN zip_source_t *_Nullable zip_source_win32w_create(const wchar_t *_Nonnull, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0498 #endif
0499 ZIP_EXTERN zip_source_t *_Nullable zip_source_window_create(zip_source_t *_Nonnull, zip_uint64_t, zip_int64_t, zip_error_t *_Nullable);
0500 ZIP_EXTERN zip_int64_t zip_source_write(zip_source_t *_Nonnull, const void *_Nullable, zip_uint64_t);
0501 ZIP_EXTERN zip_source_t *_Nullable zip_source_zip_file(zip_t *_Nonnull, zip_t *_Nonnull, zip_uint64_t, zip_flags_t, zip_uint64_t, zip_int64_t, const char *_Nullable);
0502 ZIP_EXTERN zip_source_t *_Nullable zip_source_zip_file_create(zip_t *_Nonnull, zip_uint64_t, zip_flags_t, zip_uint64_t, zip_int64_t, const char *_Nullable, zip_error_t *_Nullable);
0503 ZIP_EXTERN int zip_stat(zip_t *_Nonnull, const char *_Nonnull, zip_flags_t, zip_stat_t *_Nonnull);
0504 ZIP_EXTERN int zip_stat_index(zip_t *_Nonnull, zip_uint64_t, zip_flags_t, zip_stat_t *_Nonnull);
0505 ZIP_EXTERN void zip_stat_init(zip_stat_t *_Nonnull);
0506 ZIP_EXTERN const char *_Nonnull zip_strerror(zip_t *_Nonnull);
0507 ZIP_EXTERN int zip_unchange(zip_t *_Nonnull, zip_uint64_t);
0508 ZIP_EXTERN int zip_unchange_all(zip_t *_Nonnull);
0509 ZIP_EXTERN int zip_unchange_archive(zip_t *_Nonnull);
0510 ZIP_EXTERN int zip_compression_method_supported(zip_int32_t method, int compress);
0511 ZIP_EXTERN int zip_encryption_method_supported(zip_uint16_t method, int encode);
0512
0513 #ifdef __cplusplus
0514 }
0515 #endif
0516
0517 #endif /* _HAD_ZIP_H */