260 lines
11 KiB
C
260 lines
11 KiB
C
/* mz_zip.h -- Zip manipulation
|
|
part of the minizip-ng project
|
|
|
|
Copyright (C) 2010-2021 Nathan Moinvaziri
|
|
https://github.com/zlib-ng/minizip-ng
|
|
Copyright (C) 2009-2010 Mathias Svensson
|
|
Modifications for Zip64 support
|
|
http://result42.com
|
|
Copyright (C) 1998-2010 Gilles Vollant
|
|
https://www.winimage.com/zLibDll/minizip.html
|
|
|
|
This program is distributed under the terms of the same license as zlib.
|
|
See the accompanying LICENSE file for the full text of the license.
|
|
*/
|
|
|
|
#ifndef MZ_ZIP_H
|
|
#define MZ_ZIP_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/***************************************************************************/
|
|
|
|
typedef struct mz_zip_file_s {
|
|
uint16_t version_madeby; /* version made by */
|
|
uint16_t version_needed; /* version needed to extract */
|
|
uint16_t flag; /* general purpose bit flag */
|
|
uint16_t compression_method; /* compression method */
|
|
time_t modified_date; /* last modified date in unix time */
|
|
time_t accessed_date; /* last accessed date in unix time */
|
|
time_t creation_date; /* creation date in unix time */
|
|
uint32_t crc; /* crc-32 */
|
|
int64_t compressed_size; /* compressed size */
|
|
int64_t uncompressed_size; /* uncompressed size */
|
|
uint16_t filename_size; /* filename length */
|
|
uint16_t extrafield_size; /* extra field length */
|
|
uint16_t comment_size; /* file comment length */
|
|
uint32_t disk_number; /* disk number start */
|
|
int64_t disk_offset; /* relative offset of local header */
|
|
uint16_t internal_fa; /* internal file attributes */
|
|
uint32_t external_fa; /* external file attributes */
|
|
|
|
const char *filename; /* filename utf8 null-terminated string */
|
|
const uint8_t *extrafield; /* extrafield data */
|
|
const char *comment; /* comment utf8 null-terminated string */
|
|
const char *linkname; /* sym-link filename utf8 null-terminated string */
|
|
|
|
uint16_t zip64; /* zip64 extension mode */
|
|
uint16_t aes_version; /* winzip aes extension if not 0 */
|
|
uint8_t aes_encryption_mode; /* winzip aes encryption mode */
|
|
uint16_t pk_verify; /* pkware encryption verifier */
|
|
|
|
} mz_zip_file, mz_zip_entry;
|
|
|
|
/***************************************************************************/
|
|
|
|
typedef int32_t (*mz_zip_locate_entry_cb)(void *handle, void *userdata, mz_zip_file *file_info);
|
|
|
|
/***************************************************************************/
|
|
|
|
void * mz_zip_create(void **handle);
|
|
/* Create zip instance for opening */
|
|
|
|
void mz_zip_delete(void **handle);
|
|
/* Delete zip object */
|
|
|
|
int32_t mz_zip_open(void *handle, void *stream, int32_t mode);
|
|
/* Create a zip file, no delete file in zip functionality */
|
|
|
|
int32_t mz_zip_close(void *handle);
|
|
/* Close the zip file */
|
|
|
|
int32_t mz_zip_get_comment(void *handle, const char **comment);
|
|
/* Get a pointer to the global comment */
|
|
|
|
int32_t mz_zip_set_comment(void *handle, const char *comment);
|
|
/* Sets the global comment used for writing zip file */
|
|
|
|
int32_t mz_zip_get_version_madeby(void *handle, uint16_t *version_madeby);
|
|
/* Get the version made by */
|
|
|
|
int32_t mz_zip_set_version_madeby(void *handle, uint16_t version_madeby);
|
|
/* Sets the version made by used for writing zip file */
|
|
|
|
int32_t mz_zip_set_recover(void *handle, uint8_t recover);
|
|
/* Sets the ability to recover the central dir by reading local file headers */
|
|
|
|
int32_t mz_zip_set_data_descriptor(void *handle, uint8_t data_descriptor);
|
|
/* Sets the use of data descriptor flag when writing zip entries */
|
|
|
|
int32_t mz_zip_get_stream(void *handle, void **stream);
|
|
/* Get a pointer to the stream used to open */
|
|
|
|
int32_t mz_zip_set_cd_stream(void *handle, int64_t cd_start_pos, void *cd_stream);
|
|
/* Sets the stream to use for reading the central dir */
|
|
|
|
int32_t mz_zip_get_cd_mem_stream(void *handle, void **cd_mem_stream);
|
|
/* Get a pointer to the stream used to store the central dir in memory */
|
|
|
|
int32_t mz_zip_set_number_entry(void *handle, uint64_t number_entry);
|
|
/* Sets the total number of entries */
|
|
|
|
int32_t mz_zip_get_number_entry(void *handle, uint64_t *number_entry);
|
|
/* Get the total number of entries */
|
|
|
|
int32_t mz_zip_set_disk_number_with_cd(void *handle, uint32_t disk_number_with_cd);
|
|
/* Sets the disk number containing the central directory record */
|
|
|
|
int32_t mz_zip_get_disk_number_with_cd(void *handle, uint32_t *disk_number_with_cd);
|
|
/* Get the disk number containing the central directory record */
|
|
|
|
/***************************************************************************/
|
|
|
|
int32_t mz_zip_entry_is_open(void *handle);
|
|
/* Check to see if entry is open for read/write */
|
|
|
|
int32_t mz_zip_entry_read_open(void *handle, uint8_t raw, const char *password);
|
|
/* Open for reading the current file in the zip file */
|
|
|
|
int32_t mz_zip_entry_read(void *handle, void *buf, int32_t len);
|
|
/* Read bytes from the current file in the zip file */
|
|
|
|
int32_t mz_zip_entry_read_close(void *handle, uint32_t *crc32, int64_t *compressed_size,
|
|
int64_t *uncompressed_size);
|
|
/* Close the current file for reading and get data descriptor values */
|
|
|
|
int32_t mz_zip_entry_write_open(void *handle, const mz_zip_file *file_info,
|
|
int16_t compress_level, uint8_t raw, const char *password);
|
|
/* Open for writing the current file in the zip file */
|
|
|
|
int32_t mz_zip_entry_write(void *handle, const void *buf, int32_t len);
|
|
/* Write bytes from the current file in the zip file */
|
|
|
|
int32_t mz_zip_entry_write_close(void *handle, uint32_t crc32, int64_t compressed_size,
|
|
int64_t uncompressed_size);
|
|
/* Close the current file for writing and set data descriptor values */
|
|
|
|
int32_t mz_zip_entry_seek_local_header(void *handle);
|
|
/* Seeks to the local header for the entry */
|
|
|
|
int32_t mz_zip_entry_close_raw(void *handle, int64_t uncompressed_size, uint32_t crc32);
|
|
/* Close the current file in the zip file where raw is compressed data */
|
|
|
|
int32_t mz_zip_entry_close(void *handle);
|
|
/* Close the current file in the zip file */
|
|
|
|
/***************************************************************************/
|
|
|
|
int32_t mz_zip_entry_is_dir(void *handle);
|
|
/* Checks to see if the entry is a directory */
|
|
|
|
int32_t mz_zip_entry_is_symlink(void *handle);
|
|
/* Checks to see if the entry is a symbolic link */
|
|
|
|
int32_t mz_zip_entry_get_info(void *handle, mz_zip_file **file_info);
|
|
/* Get info about the current file, only valid while current entry is open */
|
|
|
|
int32_t mz_zip_entry_get_local_info(void *handle, mz_zip_file **local_file_info);
|
|
/* Get local info about the current file, only valid while current entry is being read */
|
|
|
|
int32_t mz_zip_entry_set_extrafield(void *handle, const uint8_t *extrafield, uint16_t extrafield_size);
|
|
/* Sets or updates the extra field for the entry to be used before writing cd */
|
|
|
|
int64_t mz_zip_get_entry(void *handle);
|
|
/* Return offset of the current entry in the zip file */
|
|
|
|
int32_t mz_zip_goto_entry(void *handle, int64_t cd_pos);
|
|
/* Go to specified entry in the zip file */
|
|
|
|
int32_t mz_zip_goto_first_entry(void *handle);
|
|
/* Go to the first entry in the zip file */
|
|
|
|
int32_t mz_zip_goto_next_entry(void *handle);
|
|
/* Go to the next entry in the zip file or MZ_END_OF_LIST if reaching the end */
|
|
|
|
int32_t mz_zip_locate_entry(void *handle, const char *filename, uint8_t ignore_case);
|
|
/* Locate the file with the specified name in the zip file or MZ_END_LIST if not found */
|
|
|
|
int32_t mz_zip_locate_first_entry(void *handle, void *userdata, mz_zip_locate_entry_cb cb);
|
|
/* Locate the first matching entry based on a match callback */
|
|
|
|
int32_t mz_zip_locate_next_entry(void *handle, void *userdata, mz_zip_locate_entry_cb cb);
|
|
/* Locate the next matching entry based on a match callback */
|
|
|
|
/***************************************************************************/
|
|
|
|
int32_t mz_zip_attrib_is_dir(uint32_t attrib, int32_t version_madeby);
|
|
/* Checks to see if the attribute is a directory based on platform */
|
|
|
|
int32_t mz_zip_attrib_is_symlink(uint32_t attrib, int32_t version_madeby);
|
|
/* Checks to see if the attribute is a symbolic link based on platform */
|
|
|
|
int32_t mz_zip_attrib_convert(uint8_t src_sys, uint32_t src_attrib, uint8_t target_sys,
|
|
uint32_t *target_attrib);
|
|
/* Converts file attributes from one host system to another */
|
|
|
|
int32_t mz_zip_attrib_posix_to_win32(uint32_t posix_attrib, uint32_t *win32_attrib);
|
|
/* Converts posix file attributes to win32 file attributes */
|
|
|
|
int32_t mz_zip_attrib_win32_to_posix(uint32_t win32_attrib, uint32_t *posix_attrib);
|
|
/* Converts win32 file attributes to posix file attributes */
|
|
|
|
/***************************************************************************/
|
|
|
|
int32_t mz_zip_extrafield_find(void *stream, uint16_t type, int32_t max_seek, uint16_t *length);
|
|
/* Seeks to extra field by its type and returns its length */
|
|
|
|
int32_t mz_zip_extrafield_contains(const uint8_t *extrafield, int32_t extrafield_size,
|
|
uint16_t type, uint16_t *length);
|
|
/* Gets whether an extrafield exists and its size */
|
|
|
|
int32_t mz_zip_extrafield_read(void *stream, uint16_t *type, uint16_t *length);
|
|
/* Reads an extrafield header from a stream */
|
|
|
|
int32_t mz_zip_extrafield_write(void *stream, uint16_t type, uint16_t length);
|
|
/* Writes an extrafield header to a stream */
|
|
|
|
/***************************************************************************/
|
|
|
|
int32_t mz_zip_dosdate_to_tm(uint64_t dos_date, struct tm *ptm);
|
|
/* Convert dos date/time format to struct tm */
|
|
|
|
time_t mz_zip_dosdate_to_time_t(uint64_t dos_date);
|
|
/* Convert dos date/time format to time_t */
|
|
|
|
int32_t mz_zip_time_t_to_tm(time_t unix_time, struct tm *ptm);
|
|
/* Convert time_t to time struct */
|
|
|
|
uint32_t mz_zip_time_t_to_dos_date(time_t unix_time);
|
|
/* Convert time_t to dos date/time format */
|
|
|
|
uint32_t mz_zip_tm_to_dosdate(const struct tm *ptm);
|
|
/* Convert struct tm to dos date/time format */
|
|
|
|
int32_t mz_zip_ntfs_to_unix_time(uint64_t ntfs_time, time_t *unix_time);
|
|
/* Convert ntfs time to unix time */
|
|
|
|
int32_t mz_zip_unix_to_ntfs_time(time_t unix_time, uint64_t *ntfs_time);
|
|
/* Convert unix time to ntfs time */
|
|
|
|
/***************************************************************************/
|
|
|
|
int32_t mz_zip_path_compare(const char *path1, const char *path2, uint8_t ignore_case);
|
|
/* Compare two paths without regard to slashes */
|
|
|
|
/***************************************************************************/
|
|
|
|
const
|
|
char* mz_zip_get_compression_method_string(int32_t compression_method);
|
|
/* Gets a string representing the compression method */
|
|
|
|
/***************************************************************************/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _ZIP_H */
|