323 lines
15 KiB
C
323 lines
15 KiB
C
#ifndef _HAD_ZIP_H
|
||
#define _HAD_ZIP_H
|
||
|
||
/*
|
||
zip.h -- exported declarations.
|
||
Copyright (C) 1999-2012 Dieter Baron 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 ZIP_EXTERN
|
||
#ifdef _WIN32
|
||
#define ZIP_EXTERN
|
||
//__declspec(dllimport)
|
||
#elif defined(__GNUC__) && __GNUC__ >= 4
|
||
#define ZIP_EXTERN __attribute__ ((visibility ("default")))
|
||
#else
|
||
#define ZIP_EXTERN
|
||
#endif
|
||
#endif
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include "zipconf.h"
|
||
|
||
#include <sys/types.h>
|
||
#include <stdio.h>
|
||
#include <time.h>
|
||
|
||
/* flags for zip_open */
|
||
|
||
#define ZIP_CREATE 1
|
||
#define ZIP_EXCL 2
|
||
#define ZIP_CHECKCONS 4
|
||
#define ZIP_TRUNCATE 8
|
||
|
||
|
||
/* flags for zip_name_locate, zip_fopen, zip_stat, ... */
|
||
|
||
#define ZIP_FL_NOCASE 1u /* ignore case on name lookup */
|
||
#define ZIP_FL_NODIR 2u /* ignore directory component */
|
||
#define ZIP_FL_COMPRESSED 4u /* read compressed data */
|
||
#define ZIP_FL_UNCHANGED 8u /* use original data, ignoring changes */
|
||
#define ZIP_FL_RECOMPRESS 16u /* force recompression of data */
|
||
#define ZIP_FL_ENCRYPTED 32u /* read encrypted data (implies ZIP_FL_COMPRESSED) */
|
||
#define ZIP_FL_ENC_GUESS 0u /* guess string encoding (is default) */
|
||
#define ZIP_FL_ENC_RAW 64u /* get unmodified string */
|
||
#define ZIP_FL_ENC_STRICT 128u /* follow specification strictly */
|
||
#define ZIP_FL_LOCAL 256u /* in local header */
|
||
#define ZIP_FL_CENTRAL 512u /* in central directory */
|
||
/* 1024u reserved for internal use */
|
||
#define ZIP_FL_ENC_UTF_8 2048u /* string is UTF-8 encoded */
|
||
#define ZIP_FL_ENC_CP437 4096u /* string is CP437 encoded */
|
||
#define ZIP_FL_OVERWRITE 8192u /* zip_file_add: if file with name exists, overwrite (replace) it */
|
||
|
||
/* archive global flags flags */
|
||
|
||
#define ZIP_AFL_TORRENT 1u /* torrent zipped */
|
||
#define ZIP_AFL_RDONLY 2u /* read only -- cannot be cleared */
|
||
|
||
|
||
/* create a new extra field */
|
||
|
||
#define ZIP_EXTRA_FIELD_ALL ZIP_UINT16_MAX
|
||
#define ZIP_EXTRA_FIELD_NEW ZIP_UINT16_MAX
|
||
|
||
/* flags for compression and encryption sources */
|
||
|
||
#define ZIP_CODEC_DECODE 0 /* decompress/decrypt (encode flag not set) */
|
||
#define ZIP_CODEC_ENCODE 1 /* compress/encrypt */
|
||
|
||
|
||
/* libzip error codes */
|
||
|
||
#define ZIP_ER_OK 0 /* N No error */
|
||
#define ZIP_ER_MULTIDISK 1 /* N Multi-disk zip archives not supported */
|
||
#define ZIP_ER_RENAME 2 /* S Renaming temporary file failed */
|
||
#define ZIP_ER_CLOSE 3 /* S Closing zip archive failed */
|
||
#define ZIP_ER_SEEK 4 /* S Seek error */
|
||
#define ZIP_ER_READ 5 /* S Read error */
|
||
#define ZIP_ER_WRITE 6 /* S Write error */
|
||
#define ZIP_ER_CRC 7 /* N CRC error */
|
||
#define ZIP_ER_ZIPCLOSED 8 /* N Containing zip archive was closed */
|
||
#define ZIP_ER_NOENT 9 /* N No such file */
|
||
#define ZIP_ER_EXISTS 10 /* N File already exists */
|
||
#define ZIP_ER_OPEN 11 /* S Can't open file */
|
||
#define ZIP_ER_TMPOPEN 12 /* S Failure to create temporary file */
|
||
#define ZIP_ER_ZLIB 13 /* Z Zlib error */
|
||
#define ZIP_ER_MEMORY 14 /* N Malloc failure */
|
||
#define ZIP_ER_CHANGED 15 /* N Entry has been changed */
|
||
#define ZIP_ER_COMPNOTSUPP 16 /* N Compression method not supported */
|
||
#define ZIP_ER_EOF 17 /* N Premature EOF */
|
||
#define ZIP_ER_INVAL 18 /* N Invalid argument */
|
||
#define ZIP_ER_NOZIP 19 /* N Not a zip archive */
|
||
#define ZIP_ER_INTERNAL 20 /* N Internal error */
|
||
#define ZIP_ER_INCONS 21 /* N Zip archive inconsistent */
|
||
#define ZIP_ER_REMOVE 22 /* S Can't remove file */
|
||
#define ZIP_ER_DELETED 23 /* N Entry has been deleted */
|
||
#define ZIP_ER_ENCRNOTSUPP 24 /* N Encryption method not supported */
|
||
#define ZIP_ER_RDONLY 25 /* N Read-only archive */
|
||
#define ZIP_ER_NOPASSWD 26 /* N No password provided */
|
||
#define ZIP_ER_WRONGPASSWD 27 /* N Wrong password provided */
|
||
|
||
/* type of system error value */
|
||
|
||
#define ZIP_ET_NONE 0 /* sys_err unused */
|
||
#define ZIP_ET_SYS 1 /* sys_err is errno */
|
||
#define ZIP_ET_ZLIB 2 /* sys_err is zlib error code */
|
||
|
||
/* compression methods */
|
||
|
||
#define ZIP_CM_DEFAULT -1 /* better of deflate or store */
|
||
#define ZIP_CM_STORE 0 /* stored (uncompressed) */
|
||
#define ZIP_CM_SHRINK 1 /* shrunk */
|
||
#define ZIP_CM_REDUCE_1 2 /* reduced with factor 1 */
|
||
#define ZIP_CM_REDUCE_2 3 /* reduced with factor 2 */
|
||
#define ZIP_CM_REDUCE_3 4 /* reduced with factor 3 */
|
||
#define ZIP_CM_REDUCE_4 5 /* reduced with factor 4 */
|
||
#define ZIP_CM_IMPLODE 6 /* imploded */
|
||
/* 7 - Reserved for Tokenizing compression algorithm */
|
||
#define ZIP_CM_DEFLATE 8 /* deflated */
|
||
#define ZIP_CM_DEFLATE64 9 /* deflate64 */
|
||
#define ZIP_CM_PKWARE_IMPLODE 10 /* PKWARE imploding */
|
||
/* 11 - Reserved by PKWARE */
|
||
#define ZIP_CM_BZIP2 12 /* compressed using BZIP2 algorithm */
|
||
/* 13 - Reserved by PKWARE */
|
||
#define ZIP_CM_LZMA 14 /* LZMA (EFS) */
|
||
/* 15-17 - Reserved by PKWARE */
|
||
#define ZIP_CM_TERSE 18 /* compressed using IBM TERSE (new) */
|
||
#define ZIP_CM_LZ77 19 /* IBM LZ77 z Architecture (PFS) */
|
||
#define ZIP_CM_WAVPACK 97 /* WavPack compressed data */
|
||
#define ZIP_CM_PPMD 98 /* PPMd version I, Rev 1 */
|
||
|
||
/* encryption methods */
|
||
|
||
#define ZIP_EM_NONE 0 /* not encrypted */
|
||
#define ZIP_EM_TRAD_PKWARE 1 /* traditional PKWARE encryption */
|
||
#if 0 /* Strong Encryption Header not parsed yet */
|
||
#define ZIP_EM_DES 0x6601 /* strong encryption: DES */
|
||
#define ZIP_EM_RC2_OLD 0x6602 /* strong encryption: RC2, version < 5.2 */
|
||
#define ZIP_EM_3DES_168 0x6603
|
||
#define ZIP_EM_3DES_112 0x6609
|
||
#define ZIP_EM_AES_128 0x660e
|
||
#define ZIP_EM_AES_192 0x660f
|
||
#define ZIP_EM_AES_256 0x6610
|
||
#define ZIP_EM_RC2 0x6702 /* strong encryption: RC2, version >= 5.2 */
|
||
#define ZIP_EM_RC4 0x6801
|
||
#endif
|
||
#define ZIP_EM_UNKNOWN 0xffff /* unknown algorithm */
|
||
|
||
#define ZIP_OPSYS_DOS 0x00u
|
||
#define ZIP_OPSYS_AMIGA 0x01u
|
||
#define ZIP_OPSYS_OPENVMS 0x02u
|
||
#define ZIP_OPSYS_UNIX 0x03u
|
||
#define ZIP_OPSYS_VM_CMS 0x04u
|
||
#define ZIP_OPSYS_ATARI_ST 0x05u
|
||
#define ZIP_OPSYS_OS_2 0x06u
|
||
#define ZIP_OPSYS_MACINTOSH 0x07u
|
||
#define ZIP_OPSYS_Z_SYSTEM 0x08u
|
||
#define ZIP_OPSYS_CPM 0x09u
|
||
#define ZIP_OPSYS_WINDOWS_NTFS 0x0au
|
||
#define ZIP_OPSYS_MVS 0x0bu
|
||
#define ZIP_OPSYS_VSE 0x0cu
|
||
#define ZIP_OPSYS_ACORN_RISC 0x0du
|
||
#define ZIP_OPSYS_VFAT 0x0eu
|
||
#define ZIP_OPSYS_ALTERNATE_MVS 0x0fu
|
||
#define ZIP_OPSYS_BEOS 0x10u
|
||
#define ZIP_OPSYS_TANDEM 0x11u
|
||
#define ZIP_OPSYS_OS_400 0x12u
|
||
#define ZIP_OPSYS_OS_X 0x13u
|
||
|
||
#define ZIP_OPSYS_DEFAULT ZIP_OPSYS_UNIX
|
||
|
||
|
||
|
||
enum zip_source_cmd {
|
||
ZIP_SOURCE_OPEN, /* prepare for reading */
|
||
ZIP_SOURCE_READ, /* read data */
|
||
ZIP_SOURCE_CLOSE, /* reading is done */
|
||
ZIP_SOURCE_STAT, /* get meta information */
|
||
ZIP_SOURCE_ERROR, /* get error information */
|
||
ZIP_SOURCE_FREE /* cleanup and free resources */
|
||
};
|
||
|
||
#define ZIP_SOURCE_ERR_LOWER -2
|
||
|
||
#define ZIP_STAT_NAME 0x0001u
|
||
#define ZIP_STAT_INDEX 0x0002u
|
||
#define ZIP_STAT_SIZE 0x0004u
|
||
#define ZIP_STAT_COMP_SIZE 0x0008u
|
||
#define ZIP_STAT_MTIME 0x0010u
|
||
#define ZIP_STAT_CRC 0x0020u
|
||
#define ZIP_STAT_COMP_METHOD 0x0040u
|
||
#define ZIP_STAT_ENCRYPTION_METHOD 0x0080u
|
||
#define ZIP_STAT_FLAGS 0x0100u
|
||
|
||
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 */
|
||
};
|
||
|
||
struct zip;
|
||
struct zip_file;
|
||
struct zip_source;
|
||
|
||
typedef zip_uint32_t zip_flags_t;
|
||
|
||
typedef zip_int64_t (*zip_source_callback)(void *, void *, zip_uint64_t,
|
||
enum zip_source_cmd);
|
||
|
||
|
||
|
||
#ifndef ZIP_DISABLE_DEPRECATED
|
||
ZIP_EXTERN zip_int64_t zip_add(struct zip *, const char *, struct zip_source *); /* use zip_file_add */
|
||
ZIP_EXTERN zip_int64_t zip_add_dir(struct zip *, const char *); /* use zip_dir_add */
|
||
ZIP_EXTERN const char *zip_get_file_comment(struct zip *, zip_uint64_t, int *, int); /* use zip_file_get_comment */
|
||
ZIP_EXTERN int zip_get_num_files(struct zip *); /* use zip_get_num_entries instead */
|
||
ZIP_EXTERN int zip_rename(struct zip *, zip_uint64_t, const char *); /* use zip_file_rename */
|
||
ZIP_EXTERN int zip_replace(struct zip *, zip_uint64_t, struct zip_source *); /* use zip_file_replace */
|
||
ZIP_EXTERN int zip_set_file_comment(struct zip *, zip_uint64_t, const char *, int); /* use zip_file_set_comment */
|
||
#endif
|
||
|
||
ZIP_EXTERN int zip_archive_set_tempdir(struct zip *, const char *);
|
||
ZIP_EXTERN int zip_close(struct zip *);
|
||
ZIP_EXTERN int zip_delete(struct zip *, zip_uint64_t);
|
||
ZIP_EXTERN zip_int64_t zip_dir_add(struct zip *, const char *, zip_flags_t);
|
||
ZIP_EXTERN void zip_discard(struct zip *);
|
||
ZIP_EXTERN void zip_error_clear(struct zip *);
|
||
ZIP_EXTERN void zip_error_get(struct zip *, int *, int *);
|
||
ZIP_EXTERN int zip_error_get_sys_type(int);
|
||
ZIP_EXTERN int zip_error_to_str(char *, zip_uint64_t, int, int);
|
||
ZIP_EXTERN int zip_fclose(struct zip_file *);
|
||
ZIP_EXTERN struct zip *zip_fdopen(int, int, int *);
|
||
ZIP_EXTERN zip_int64_t zip_file_add(struct zip *, const char *, struct zip_source *, zip_flags_t);
|
||
ZIP_EXTERN void zip_file_error_clear(struct zip_file *);
|
||
ZIP_EXTERN void zip_file_error_get(struct zip_file *, int *, int *);
|
||
ZIP_EXTERN int zip_file_extra_field_delete(struct zip *, zip_uint64_t, zip_uint16_t, zip_flags_t);
|
||
ZIP_EXTERN int zip_file_extra_field_delete_by_id(struct zip *, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_flags_t);
|
||
ZIP_EXTERN int zip_file_extra_field_set(struct zip *, 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(struct zip *, zip_uint64_t, zip_flags_t);
|
||
ZIP_EXTERN zip_int16_t zip_file_extra_fields_count_by_id(struct zip *, zip_uint64_t, zip_uint16_t, zip_flags_t);
|
||
ZIP_EXTERN const zip_uint8_t *zip_file_extra_field_get(struct zip *, 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(struct zip *, zip_uint64_t, zip_uint16_t, zip_uint16_t, zip_uint16_t *, zip_flags_t);
|
||
ZIP_EXTERN const char *zip_file_get_comment(struct zip *, zip_uint64_t, zip_uint32_t *, zip_flags_t);
|
||
ZIP_EXTERN int zip_file_get_external_attributes(struct zip *, zip_uint64_t, zip_flags_t, zip_uint8_t *, zip_uint32_t *);
|
||
ZIP_EXTERN int zip_file_rename(struct zip *, zip_uint64_t, const char *, zip_flags_t);
|
||
ZIP_EXTERN int zip_file_replace(struct zip *, zip_uint64_t, struct zip_source *, zip_flags_t);
|
||
ZIP_EXTERN int zip_file_set_comment(struct zip *, zip_uint64_t, const char *, zip_uint16_t, zip_flags_t);
|
||
ZIP_EXTERN int zip_file_set_external_attributes(struct zip *, zip_uint64_t, zip_flags_t, zip_uint8_t, zip_uint32_t);
|
||
ZIP_EXTERN const char *zip_file_strerror(struct zip_file *);
|
||
ZIP_EXTERN struct zip_file *zip_fopen(struct zip *, const char *, zip_flags_t);
|
||
ZIP_EXTERN struct zip_file *zip_fopen_encrypted(struct zip *, const char *, zip_flags_t, const char *);
|
||
ZIP_EXTERN struct zip_file *zip_fopen_index(struct zip *, zip_uint64_t, zip_flags_t);
|
||
ZIP_EXTERN struct zip_file *zip_fopen_index_encrypted(struct zip *, zip_uint64_t, zip_flags_t, const char *);
|
||
ZIP_EXTERN zip_int64_t zip_fread(struct zip_file *, void *, zip_uint64_t);
|
||
ZIP_EXTERN const char *zip_get_archive_comment(struct zip *, int *, zip_flags_t);
|
||
ZIP_EXTERN int zip_get_archive_flag(struct zip *, zip_flags_t, zip_flags_t);
|
||
ZIP_EXTERN const char *zip_get_name(struct zip *, zip_uint64_t, zip_flags_t);
|
||
ZIP_EXTERN zip_int64_t zip_get_num_entries(struct zip *, zip_flags_t);
|
||
ZIP_EXTERN zip_int64_t zip_name_locate(struct zip *, const char *, zip_flags_t);
|
||
ZIP_EXTERN struct zip *zip_open(const char *, int, int *);
|
||
ZIP_EXTERN int zip_set_archive_comment(struct zip *, const char *, zip_uint16_t);
|
||
ZIP_EXTERN int zip_set_archive_flag(struct zip *, zip_flags_t, int);
|
||
ZIP_EXTERN int zip_set_default_password(struct zip *, const char *);
|
||
ZIP_EXTERN int zip_set_file_compression(struct zip *, zip_uint64_t, zip_int32_t, zip_uint32_t);
|
||
ZIP_EXTERN struct zip_source *zip_source_buffer(struct zip *, const void *, zip_uint64_t, int);
|
||
ZIP_EXTERN struct zip_source *zip_source_file(struct zip *, const char *, zip_uint64_t, zip_int64_t);
|
||
ZIP_EXTERN struct zip_source *zip_source_filep(struct zip *, FILE *, zip_uint64_t, zip_int64_t);
|
||
ZIP_EXTERN void zip_source_free(struct zip_source *);
|
||
ZIP_EXTERN struct zip_source *zip_source_function(struct zip *, zip_source_callback, void *);
|
||
ZIP_EXTERN struct zip_source *zip_source_zip(struct zip *, struct zip *, zip_uint64_t, zip_flags_t, zip_uint64_t, zip_int64_t);
|
||
ZIP_EXTERN int zip_stat(struct zip *, const char *, zip_flags_t, struct zip_stat *);
|
||
ZIP_EXTERN int zip_stat_index(struct zip *, zip_uint64_t, zip_flags_t, struct zip_stat *);
|
||
ZIP_EXTERN void zip_stat_init(struct zip_stat *);
|
||
ZIP_EXTERN const char *zip_strerror(struct zip *);
|
||
ZIP_EXTERN int zip_unchange(struct zip *, zip_uint64_t);
|
||
ZIP_EXTERN int zip_unchange_all(struct zip *);
|
||
ZIP_EXTERN int zip_unchange_archive(struct zip *);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* _HAD_ZIP_H */
|