minizip-ng/src/mz_zip.h

/* mz_zip.h -- Zip manipulation
   Version 2.0.1, October 16th, 2017
   part of the MiniZip project

   Copyright (C) 2012-2017 Nathan Moinvaziri
     https://github.com/nmoinvaz/minizip
   Copyright (C) 2009-2010 Mathias Svensson
     Modifications for Zip64 support
     http://result42.com
   Copyright (C) 1998-2010 Gilles Vollant
     http://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

#ifndef _ZLIB_H
#  include "zlib.h"
#endif

#include "mz_strm.h"

/***************************************************************************/

typedef struct mz_zip_global_s
{
    uint64_t number_entry;              // total number of entries in the central dir on this disk
    uint32_t number_disk_with_cd;       // number the the disk with central dir, used for spanning ZIP
    uint16_t comment_size;              // size of the global comment of the zip file
    uint8_t  *comment;
} mz_zip_global;

typedef struct mz_zip_file_s
{
    uint16_t version_madeby;            // version made by                 2 bytes 
    uint16_t version_needed;            // version needed to extract       2 bytes
    uint16_t flag;                      // general purpose bit flag        2 bytes
    uint16_t compression_method;        // compression method              2 bytes
    uint32_t dos_date;                  // last mod file date in Dos fmt   4 bytes
    uint32_t crc;                       // crc-32                          4 bytes
    uint64_t compressed_size;           // compressed size                 8 bytes
    uint64_t uncompressed_size;         // uncompressed size               8 bytes
    uint16_t filename_size;             // filename length                 2 bytes
    uint16_t extrafield_size;           // extra field length              2 bytes
    uint16_t comment_size;              // file comment length             2 bytes

    uint32_t disk_num_start;            // disk number start               4 bytes
    uint16_t internal_fa;               // internal file attributes        2 bytes
    uint32_t external_fa;               // external file attributes        4 bytes

    uint64_t disk_offset;               // relative offset of local header 8 bytes

    char     *filename;                 // filename string
    uint8_t  *extrafield;               // extrafield data
    char     *comment;                  // comment string

    uint8_t  zip_64;                    // zip 64 extensions if 1

#ifdef HAVE_AES
    uint16_t aes_version;
    uint8_t  aes_encryption_mode;
#endif
} mz_zip_file;

typedef struct mz_zip_compress_s
{
    uint16_t    method;                 // compression method
    int         level;                  // compression level
    int         window_bits;            // deflate window bits
    int         mem_level;              // deflate memory level
    int         strategy;               // deflate strategy
} mz_zip_compress;

typedef struct mz_zip_crypt_s
{
    const char *password;               // encryption password
#if defined(HAVE_AES)
    uint8_t     aes;                    // winzip aes encryption if 1
#endif
} mz_zip_crypt;

/***************************************************************************/

extern void* ZEXPORT mz_zip_open(void *stream, int32_t mode);
// Create a zip file
//
//   NOTE: There is no delete function into a zip file. If you want delete file in a zip file, 
//   you must open a zip file, and create another. You can use RAW reading and writing to copy
//   the file you did not want delete.

extern int ZEXPORT mz_zip_get_global_info(void *handle, mz_zip_global **global_info);
// Gets the global zip file info

extern int ZEXPORT mz_zip_entry_get_info(void *handle, mz_zip_file **file_info);
// Get info about the current file
//
//   NOTE: The file info is only valid while the current entry is open

extern int ZEXPORT mz_zip_entry_get_local_info(void *handle, mz_zip_file **local_file_info);
// Get local info about the current file
//
//   NOTE: The local file info is only valid while the current entry is being read

extern int ZEXPORT mz_zip_entry_write_open(void *handle, const mz_zip_file *file_info, 
    const mz_zip_compress *compress_info, const mz_zip_crypt *crypt_info);
// Open a file in the zip for writing

extern int ZEXPORT mz_zip_entry_write(void *handle, const void *buf, uint32_t len);
// Write data in the zip file

extern int ZEXPORT mz_zip_entry_read_open(void *handle, int raw, const char *password);
// Open for reading data the current file in the zip file

extern int ZEXPORT mz_zip_entry_read(void *handle, void *buf, uint32_t len);
// Read bytes from the current file

extern int ZEXPORT mz_zip_entry_close(void *handle);
// Close the current file in the zip file

extern int ZEXPORT mz_zip_entry_close_raw(void *handle, uint64_t uncompressed_size, uint32_t crc32);
// Close the current file in the zip file where raw is compressed data

extern int ZEXPORT mz_zip_close(void *handle, const char *global_comment, uint16_t version_madeby);
// Close the zip file
//
//    NOTE: global_comment and version_madeby are only used when the zip file is open for writing

/***************************************************************************/
// Navigate the directory of the zip file

typedef int(*mz_filename_compare_cb)(void *handle, const char *filename1, const char *filename2);

extern int ZEXPORT mz_zip_locate_entry(void *file, const char *filename, mz_filename_compare_cb filename_compare_cb);
// Locate the file with the specified name in the zip file
//
//  if filename_compare_cb == NULL, it uses strcmp
//
//  return MZ_OK if the file is found (it becomes the current file)
//  return MZ_END_OF_LIST if the file is not found 

extern int ZEXPORT mz_zip_goto_first_entry(void *handle);
// Go to the first entry in the zip file 

extern int ZEXPORT 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

/***************************************************************************/

#ifdef __cplusplus
}
#endif

#endif /* _ZIP_H */