| /* mz_zip_rw.h -- Zip reader/writer |
| Version 2.7.5, November 13, 2018 |
| part of the MiniZip project |
| |
| Copyright (C) 2010-2018 Nathan Moinvaziri |
| https://github.com/nmoinvaz/minizip |
| |
| 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_RW_H |
| #define MZ_ZIP_RW_H |
| |
| #include <stdint.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| #include "mz_zip.h" |
| |
| /***************************************************************************/ |
| |
| typedef int32_t (*mz_zip_reader_overwrite_cb)(void *handle, void *userdata, mz_zip_file *file_info, const char *path); |
| typedef int32_t (*mz_zip_reader_password_cb)(void *handle, void *userdata, mz_zip_file *file_info, char *password, int32_t max_password); |
| typedef int32_t (*mz_zip_reader_progress_cb)(void *handle, void *userdata, mz_zip_file *file_info, int64_t position); |
| typedef int32_t (*mz_zip_reader_entry_cb)(void *handle, void *userdata, mz_zip_file *file_info, const char *path); |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_reader_is_open(void *handle); |
| // Checks to see if the zip file is open |
| |
| int32_t mz_zip_reader_open(void *handle, void *stream); |
| // Opens zip file from stream |
| |
| int32_t mz_zip_reader_open_file(void *handle, const char *path); |
| // Opens zip file from a file path |
| |
| int32_t mz_zip_reader_open_file_in_memory(void *handle, const char *path); |
| // Opens zip file from a file path into memory for faster access |
| |
| int32_t mz_zip_reader_open_buffer(void *handle, uint8_t *buf, int32_t len, uint8_t copy); |
| // Opens zip file from memory buffer |
| |
| int32_t mz_zip_reader_close(void *handle); |
| // Closes the zip file |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_reader_unzip_cd(void *handle); |
| // Unzip the central directory |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_reader_goto_first_entry(void *handle); |
| // Goto the first entry in the zip file that matches the pattern |
| |
| int32_t mz_zip_reader_goto_next_entry(void *handle); |
| // Goto the next entry in the zip file that matches the pattern |
| |
| int32_t mz_zip_reader_locate_entry(void *handle, const char *filename, uint8_t ignore_case); |
| // Locates an entry by filename |
| |
| int32_t mz_zip_reader_entry_open(void *handle); |
| // Opens an entry for reading |
| |
| int32_t mz_zip_reader_entry_close(void *handle); |
| // Closes an entry |
| |
| int32_t mz_zip_reader_entry_read(void *handle, void *buf, int32_t len); |
| // Reads and entry after being opened |
| |
| int32_t mz_zip_reader_entry_has_sign(void *handle); |
| // Checks to see if the entry has a signature |
| |
| int32_t mz_zip_reader_entry_sign_verify(void *handle); |
| // Verifies a signature stored with the entry |
| |
| int32_t mz_zip_reader_entry_get_hash(void *handle, uint16_t algorithm, uint8_t *digest, int32_t digest_size); |
| // Gets a hash algorithm from the entry's extra field |
| |
| int32_t mz_zip_reader_entry_get_first_hash(void *handle, uint16_t *algorithm, uint16_t *digest_size); |
| // Gets the most secure hash algorithm from the entry's extra field |
| |
| int32_t mz_zip_reader_entry_get_info(void *handle, mz_zip_file **file_info); |
| // Gets the current entry file info |
| |
| int32_t mz_zip_reader_entry_is_dir(void *handle); |
| // Gets the current entry is a directory |
| |
| int32_t mz_zip_reader_entry_save(void *handle, void *stream, mz_stream_write_cb write_cb); |
| // Save the current entry to a steam |
| |
| int32_t mz_zip_reader_entry_save_process(void *handle, void *stream, mz_stream_write_cb write_cb); |
| // Saves a portion of the current entry to a stream callback |
| |
| int32_t mz_zip_reader_entry_save_file(void *handle, const char *path); |
| // Save the current entry to a file |
| |
| int32_t mz_zip_reader_entry_save_buffer(void *handle, void *buf, int32_t len); |
| // Save the current entry to a memory buffer |
| |
| int32_t mz_zip_reader_entry_save_buffer_length(void *handle); |
| // Gets the length of the buffer required to save |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_reader_save_all(void *handle, const char *destination_dir); |
| // Save all files into a directory |
| |
| /***************************************************************************/ |
| |
| void mz_zip_reader_set_pattern(void *handle, const char *pattern, uint8_t ignore_case); |
| // Sets the match pattern for entries in the zip file, if null all entries are matched |
| |
| void mz_zip_reader_set_password(void *handle, const char *password); |
| // Sets the password required for extraction |
| |
| void mz_zip_reader_set_raw(void *handle, uint8_t raw); |
| // Sets whether or not it should save the entry raw |
| |
| int32_t mz_zip_reader_get_raw(void *handle, uint8_t *raw); |
| // Gets whether or not it should save the entry raw |
| |
| int32_t mz_zip_reader_get_comment(void *handle, const char **comment); |
| // Gets the comment for the central directory |
| |
| void mz_zip_reader_set_encoding(void *handle, int32_t encoding); |
| // Sets whether or not it should support cp437 in zip file names |
| |
| void mz_zip_reader_set_sign_required(void *handle, uint8_t sign_required); |
| // Sets whether or not it a signature is required |
| |
| void mz_zip_reader_set_overwrite_cb(void *handle, void *userdata, mz_zip_reader_overwrite_cb cb); |
| // Callback for what to do when a file is being overwritten |
| |
| void mz_zip_reader_set_password_cb(void *handle, void *userdata, mz_zip_reader_password_cb cb); |
| // Callback for when a password is required and hasn't been set |
| |
| void mz_zip_reader_set_progress_cb(void *handle, void *userdata, mz_zip_reader_progress_cb cb); |
| // Callback for extraction progress |
| |
| void mz_zip_reader_set_progress_interval(void *handle, uint32_t milliseconds); |
| // Let at least milliseconds pass between calls to progress callback |
| |
| void mz_zip_reader_set_entry_cb(void *handle, void *userdata, mz_zip_reader_entry_cb cb); |
| // Callback for zip file entries |
| |
| int32_t mz_zip_reader_get_zip_handle(void *handle, void **zip_handle); |
| // Gets the underlying zip instance handle |
| |
| void* mz_zip_reader_create(void **handle); |
| // Create new instance of zip reader |
| |
| void mz_zip_reader_delete(void **handle); |
| // Delete instance of zip reader |
| |
| /***************************************************************************/ |
| |
| typedef int32_t (*mz_zip_writer_overwrite_cb)(void *handle, void *userdata, const char *path); |
| typedef int32_t (*mz_zip_writer_password_cb)(void *handle, void *userdata, mz_zip_file *file_info, char *password, int32_t max_password); |
| typedef int32_t (*mz_zip_writer_progress_cb)(void *handle, void *userdata, mz_zip_file *file_info, int64_t position); |
| typedef int32_t (*mz_zip_writer_entry_cb)(void *handle, void *userdata, mz_zip_file *file_info); |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_writer_is_open(void *handle); |
| // Checks to see if the zip file is open |
| |
| int32_t mz_zip_writer_open(void *handle, void *stream); |
| // Opens zip file from stream |
| |
| int32_t mz_zip_writer_open_file(void *handle, const char *path, int64_t disk_size, uint8_t append); |
| // Opens zip file from a file path |
| |
| int32_t mz_zip_writer_open_file_in_memory(void *handle, const char *path); |
| // Opens zip file from a file path into memory for faster access |
| |
| int32_t mz_zip_writer_close(void *handle); |
| // Closes the zip file |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_writer_zip_cd(void *handle); |
| // Zip the central directory |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_writer_entry_open(void *handle, mz_zip_file *file_info); |
| // Opens an entry in the zip file for writing |
| |
| int32_t mz_zip_writer_entry_close(void *handle); |
| // Closes entry in zip file |
| |
| int32_t mz_zip_writer_entry_write(void *handle, const void *buf, int32_t len); |
| // Writes data into entry for zip |
| |
| int32_t mz_zip_writer_entry_sign(void *handle, uint8_t *message, int32_t message_size, |
| uint8_t *cert_data, int32_t cert_data_size, const char *cert_pwd); |
| // Signs uncompressed content of entry, call before closing |
| |
| /***************************************************************************/ |
| |
| int32_t mz_zip_writer_add(void *handle, void *stream, mz_stream_read_cb read_cb); |
| // Writes all data to the currently open entry in the zip |
| |
| int32_t mz_zip_writer_add_process(void *handle, void *stream, mz_stream_read_cb read_cb); |
| // Writes a portion of data to the currently open entry in the zip |
| |
| int32_t mz_zip_writer_add_info(void *handle, void *stream, mz_stream_read_cb read_cb, mz_zip_file *file_info); |
| // Adds an entry to the zip based on the info |
| |
| int32_t mz_zip_writer_add_buffer(void *handle, void *buf, int32_t len, mz_zip_file *file_info); |
| // Adds an entry to the zip with a memory buffer |
| |
| int32_t mz_zip_writer_add_file(void *handle, const char *path, const char *filename_in_zip); |
| // Adds an entry to the zip from a file |
| |
| int32_t mz_zip_writer_add_path(void *handle, const char *path, const char *root_path, uint8_t include_path, |
| uint8_t recursive); |
| // Enumerates a directory or pattern and adds entries to the zip |
| |
| int32_t mz_zip_writer_copy_from_reader(void *handle, void *reader); |
| // Adds an entry from a zip reader instance |
| |
| /***************************************************************************/ |
| |
| void mz_zip_writer_set_password(void *handle, const char *password); |
| // Password to use for encrypting files in the zip |
| |
| void mz_zip_writer_set_comment(void *handle, const char *comment); |
| // Comment to use for the archive |
| |
| void mz_zip_writer_set_raw(void *handle, uint8_t raw); |
| // Sets whether or not we should write the entry raw |
| |
| int32_t mz_zip_writer_get_raw(void *handle, uint8_t *raw); |
| // Gets whether or not we should write the entry raw |
| |
| void mz_zip_writer_set_aes(void *handle, uint8_t aes); |
| // Use aes encryption when adding files in zip |
| |
| void mz_zip_writer_set_compress_method(void *handle, uint16_t compress_method); |
| // Sets the compression method when adding files in zip |
| |
| void mz_zip_writer_set_compress_level(void *handle, int16_t compress_level); |
| // Sets the compression level when adding files in zip |
| |
| void mz_zip_writer_set_zip_cd(void *handle, uint8_t flags); |
| // Sets additional flags to be set when adding files in zip |
| |
| int32_t mz_zip_writer_set_certificate(void *handle, const char *cert_path, const char *cert_pwd); |
| // Sets the certificate and timestamp url to use for signing when adding files in zip |
| |
| void mz_zip_writer_set_overwrite_cb(void *handle, void *userdata, mz_zip_writer_overwrite_cb cb); |
| // Callback for what to do when zip file already exists |
| |
| void mz_zip_writer_set_password_cb(void *handle, void *userdata, mz_zip_writer_password_cb cb); |
| // Callback for ask if a password is required for adding |
| |
| void mz_zip_writer_set_progress_cb(void *handle, void *userdata, mz_zip_writer_progress_cb cb); |
| // Callback for compression progress |
| |
| void mz_zip_writer_set_progress_interval(void *handle, uint32_t milliseconds); |
| // Let at least milliseconds pass between calls to progress callback |
| |
| void mz_zip_writer_set_entry_cb(void *handle, void *userdata, mz_zip_writer_entry_cb cb); |
| // Callback for zip file entries |
| |
| int32_t mz_zip_writer_get_zip_handle(void *handle, void **zip_handle); |
| // Gets the underlying zip handle |
| |
| void* mz_zip_writer_create(void **handle); |
| // Create new instance of zip writer |
| |
| void mz_zip_writer_delete(void **handle); |
| // Delete instance of zip writer |
| |
| /***************************************************************************/ |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif |