1/* zip.h -- IO on .zip files using zlib
2   Version 1.1, February 14h, 2010
3   part of the MiniZip project - ( http://www.winimage.com/zLibDll/minizip.html )
4
5         Copyright (C) 1998-2010 Gilles Vollant (minizip) ( http://www.winimage.com/zLibDll/minizip.html )
6
7         Modifications for Zip64 support
8         Copyright (C) 2009-2010 Mathias Svensson ( http://result42.com )
9
10         For more info read MiniZip_info.txt
11
12         ---------------------------------------------------------------------------
13
14   Condition of use and distribution are the same than zlib :
15
16  This software is provided 'as-is', without any express or implied
17  warranty.  In no event will the authors be held liable for any damages
18  arising from the use of this software.
19
20  Permission is granted to anyone to use this software for any purpose,
21  including commercial applications, and to alter it and redistribute it
22  freely, subject to the following restrictions:
23
24  1. The origin of this software must not be misrepresented; you must not
25     claim that you wrote the original software. If you use this software
26     in a product, an acknowledgment in the product documentation would be
27     appreciated but is not required.
28  2. Altered source versions must be plainly marked as such, and must not be
29     misrepresented as being the original software.
30  3. This notice may not be removed or altered from any source distribution.
31
32        ---------------------------------------------------------------------------
33
34        Changes
35
36        See header of zip.h
37
38*/
39
40#ifndef _zip12_H
41#define _zip12_H
42
43#ifdef __cplusplus
44extern "C" {
45#endif
46
47//#define HAVE_BZIP2
48
49#ifndef _ZLIB_H
50#include "zlib.h"
51#endif
52
53#ifndef _ZLIBIOAPI_H
54#include "ioapi.h"
55#endif
56
57#ifdef HAVE_BZIP2
58#include "bzlib.h"
59#endif
60
61#define Z_BZIP2ED 12
62
63#if defined(STRICTZIP) || defined(STRICTZIPUNZIP)
64/* like the STRICT of WIN32, we define a pointer that cannot be converted
65    from (void*) without cast */
66typedef struct TagzipFile__ { int unused; } zipFile__;
67typedef zipFile__ *zipFile;
68#else
69typedef voidp zipFile;
70#endif
71
72#define ZIP_OK                          (0)
73#define ZIP_EOF                         (0)
74#define ZIP_ERRNO                       (Z_ERRNO)
75#define ZIP_PARAMERROR                  (-102)
76#define ZIP_BADZIPFILE                  (-103)
77#define ZIP_INTERNALERROR               (-104)
78
79#ifndef DEF_MEM_LEVEL
80#  if MAX_MEM_LEVEL >= 8
81#    define DEF_MEM_LEVEL 8
82#  else
83#    define DEF_MEM_LEVEL  MAX_MEM_LEVEL
84#  endif
85#endif
86/* default memLevel */
87
88/* tm_zip contain date/time info */
89typedef struct tm_zip_s
90{
91    uInt tm_sec;            /* seconds after the minute - [0,59] */
92    uInt tm_min;            /* minutes after the hour - [0,59] */
93    uInt tm_hour;           /* hours since midnight - [0,23] */
94    uInt tm_mday;           /* day of the month - [1,31] */
95    uInt tm_mon;            /* months since January - [0,11] */
96    uInt tm_year;           /* years - [1980..2044] */
97} tm_zip;
98
99typedef struct
100{
101    tm_zip      tmz_date;       /* date in understandable format           */
102    uLong       dosDate;       /* if dos_date == 0, tmu_date is used      */
103/*    uLong       flag;        */   /* general purpose bit flag        2 bytes */
104
105    uLong       internal_fa;    /* internal file attributes        2 bytes */
106    uLong       external_fa;    /* external file attributes        4 bytes */
107} zip_fileinfo;
108
109typedef const char* zipcharpc;
110
111
112#define APPEND_STATUS_CREATE        (0)
113#define APPEND_STATUS_CREATEAFTER   (1)
114#define APPEND_STATUS_ADDINZIP      (2)
115
116extern zipFile ZEXPORT zipOpen OF((const char *pathname, int append));
117extern zipFile ZEXPORT zipOpen64 OF((const void *pathname, int append));
118/*
119  Create a zipfile.
120     pathname contain on Windows XP a filename like "c:\\zlib\\zlib113.zip" or on
121       an Unix computer "zlib/zlib113.zip".
122     if the file pathname exist and append==APPEND_STATUS_CREATEAFTER, the zip
123       will be created at the end of the file.
124         (useful if the file contain a self extractor code)
125     if the file pathname exist and append==APPEND_STATUS_ADDINZIP, we will
126       add files in existing zip (be sure you don't add file that doesn't exist)
127     If the zipfile cannot be opened, the return value is NULL.
128     Else, the return value is a zipFile Handle, usable with other function
129       of this zip package.
130*/
131
132/* Note : there is no delete function into a zipfile.
133   If you want delete file into a zipfile, you must open a zipfile, and create another
134   Of couse, you can use RAW reading and writing to copy the file you did not want delte
135*/
136
137extern zipFile ZEXPORT zipOpen2 OF((const char *pathname,
138                                   int append,
139                                   zipcharpc* globalcomment,
140                                   zlib_filefunc_def* pzlib_filefunc_def));
141
142extern zipFile ZEXPORT zipOpen2_64 OF((const void *pathname,
143                                   int append,
144                                   zipcharpc* globalcomment,
145                                   zlib_filefunc64_def* pzlib_filefunc_def));
146
147extern int ZEXPORT zipOpenNewFileInZip OF((zipFile file,
148                       const char* filename,
149                       const zip_fileinfo* zipfi,
150                       const void* extrafield_local,
151                       uInt size_extrafield_local,
152                       const void* extrafield_global,
153                       uInt size_extrafield_global,
154                       const char* comment,
155                       int method,
156                       int level));
157
158extern int ZEXPORT zipOpenNewFileInZip64 OF((zipFile file,
159                       const char* filename,
160                       const zip_fileinfo* zipfi,
161                       const void* extrafield_local,
162                       uInt size_extrafield_local,
163                       const void* extrafield_global,
164                       uInt size_extrafield_global,
165                       const char* comment,
166                       int method,
167                       int level,
168                       int zip64));
169
170/*
171  Open a file in the ZIP for writing.
172  filename : the filename in zip (if NULL, '-' without quote will be used
173  *zipfi contain supplemental information
174  if extrafield_local!=NULL and size_extrafield_local>0, extrafield_local
175    contains the extrafield data the the local header
176  if extrafield_global!=NULL and size_extrafield_global>0, extrafield_global
177    contains the extrafield data the the local header
178  if comment != NULL, comment contain the comment string
179  method contain the compression method (0 for store, Z_DEFLATED for deflate)
180  level contain the level of compression (can be Z_DEFAULT_COMPRESSION)
181  zip64 is set to 1 if a zip64 extended information block should be added to the local file header.
182                    this MUST be '1' if the uncompressed size is >= 0xffffffff.
183
184*/
185
186
187extern int ZEXPORT zipOpenNewFileInZip2 OF((zipFile file,
188                                            const char* filename,
189                                            const zip_fileinfo* zipfi,
190                                            const void* extrafield_local,
191                                            uInt size_extrafield_local,
192                                            const void* extrafield_global,
193                                            uInt size_extrafield_global,
194                                            const char* comment,
195                                            int method,
196                                            int level,
197                                            int raw));
198
199
200extern int ZEXPORT zipOpenNewFileInZip2_64 OF((zipFile file,
201                                            const char* filename,
202                                            const zip_fileinfo* zipfi,
203                                            const void* extrafield_local,
204                                            uInt size_extrafield_local,
205                                            const void* extrafield_global,
206                                            uInt size_extrafield_global,
207                                            const char* comment,
208                                            int method,
209                                            int level,
210                                            int raw,
211                                            int zip64));
212/*
213  Same than zipOpenNewFileInZip, except if raw=1, we write raw file
214 */
215
216extern int ZEXPORT zipOpenNewFileInZip3 OF((zipFile file,
217                                            const char* filename,
218                                            const zip_fileinfo* zipfi,
219                                            const void* extrafield_local,
220                                            uInt size_extrafield_local,
221                                            const void* extrafield_global,
222                                            uInt size_extrafield_global,
223                                            const char* comment,
224                                            int method,
225                                            int level,
226                                            int raw,
227                                            int windowBits,
228                                            int memLevel,
229                                            int strategy,
230                                            const char* password,
231                                            uLong crcForCrypting));
232
233extern int ZEXPORT zipOpenNewFileInZip3_64 OF((zipFile file,
234                                            const char* filename,
235                                            const zip_fileinfo* zipfi,
236                                            const void* extrafield_local,
237                                            uInt size_extrafield_local,
238                                            const void* extrafield_global,
239                                            uInt size_extrafield_global,
240                                            const char* comment,
241                                            int method,
242                                            int level,
243                                            int raw,
244                                            int windowBits,
245                                            int memLevel,
246                                            int strategy,
247                                            const char* password,
248                                            uLong crcForCrypting,
249                                            int zip64
250                                            ));
251
252/*
253  Same than zipOpenNewFileInZip2, except
254    windowBits,memLevel,,strategy : see parameter strategy in deflateInit2
255    password : crypting password (NULL for no crypting)
256    crcForCrypting : crc of file to compress (needed for crypting)
257 */
258
259extern int ZEXPORT zipOpenNewFileInZip4 OF((zipFile file,
260                                            const char* filename,
261                                            const zip_fileinfo* zipfi,
262                                            const void* extrafield_local,
263                                            uInt size_extrafield_local,
264                                            const void* extrafield_global,
265                                            uInt size_extrafield_global,
266                                            const char* comment,
267                                            int method,
268                                            int level,
269                                            int raw,
270                                            int windowBits,
271                                            int memLevel,
272                                            int strategy,
273                                            const char* password,
274                                            uLong crcForCrypting,
275                                            uLong versionMadeBy,
276                                            uLong flagBase
277                                            ));
278
279
280extern int ZEXPORT zipOpenNewFileInZip4_64 OF((zipFile file,
281                                            const char* filename,
282                                            const zip_fileinfo* zipfi,
283                                            const void* extrafield_local,
284                                            uInt size_extrafield_local,
285                                            const void* extrafield_global,
286                                            uInt size_extrafield_global,
287                                            const char* comment,
288                                            int method,
289                                            int level,
290                                            int raw,
291                                            int windowBits,
292                                            int memLevel,
293                                            int strategy,
294                                            const char* password,
295                                            uLong crcForCrypting,
296                                            uLong versionMadeBy,
297                                            uLong flagBase,
298                                            int zip64
299                                            ));
300/*
301  Same than zipOpenNewFileInZip4, except
302    versionMadeBy : value for Version made by field
303    flag : value for flag field (compression level info will be added)
304 */
305
306
307extern int ZEXPORT zipWriteInFileInZip OF((zipFile file,
308                       const void* buf,
309                       unsigned len));
310/*
311  Write data in the zipfile
312*/
313
314extern int ZEXPORT zipCloseFileInZip OF((zipFile file));
315/*
316  Close the current file in the zipfile
317*/
318
319extern int ZEXPORT zipCloseFileInZipRaw OF((zipFile file,
320                                            uLong uncompressed_size,
321                                            uLong crc32));
322
323extern int ZEXPORT zipCloseFileInZipRaw64 OF((zipFile file,
324                                            ZPOS64_T uncompressed_size,
325                                            uLong crc32));
326
327/*
328  Close the current file in the zipfile, for file opened with
329    parameter raw=1 in zipOpenNewFileInZip2
330  uncompressed_size and crc32 are value for the uncompressed size
331*/
332
333extern int ZEXPORT zipClose OF((zipFile file,
334                const char* global_comment));
335/*
336  Close the zipfile
337*/
338
339
340extern int ZEXPORT zipRemoveExtraInfoBlock OF((char* pData, int* dataLen, short sHeader));
341/*
342  zipRemoveExtraInfoBlock -  Added by Mathias Svensson
343
344  Remove extra information block from a extra information data for the local file header or central directory header
345
346  It is needed to remove ZIP64 extra information blocks when before data is written if using RAW mode.
347
348  0x0001 is the signature header for the ZIP64 extra information blocks
349
350  usage.
351                        Remove ZIP64 Extra information from a central director extra field data
352              zipRemoveExtraInfoBlock(pCenDirExtraFieldData, &nCenDirExtraFieldDataLen, 0x0001);
353
354                        Remove ZIP64 Extra information from a Local File Header extra field data
355        zipRemoveExtraInfoBlock(pLocalHeaderExtraFieldData, &nLocalHeaderExtraFieldDataLen, 0x0001);
356*/
357
358#ifdef __cplusplus
359}
360#endif
361
362#endif /* _zip64_H */
363