globalplatform
zip.h
1 /* zip.h -- IO for compress .zip files using zlib
2  Version 1.01e, February 12th, 2005
3 
4  Copyright (C) 1998-2005 Gilles Vollant
5 
6  This unzip package allow creates .ZIP file, compatible with PKZip 2.04g
7  WinZip, InfoZip tools and compatible.
8  Multi volume ZipFile (span) are not supported.
9  Encryption compatible with pkzip 2.04g only supported
10  Old compressions used by old PKZip 1.x are not supported
11 
12  For uncompress .zip file, look at unzip.h
13 
14 
15  I WAIT FEEDBACK at mail info@winimage.com
16  Visit also http://www.winimage.com/zLibDll/unzip.html for evolution
17 
18  Condition of use and distribution are the same than zlib :
19 
20  This software is provided 'as-is', without any express or implied
21  warranty. In no event will the authors be held liable for any damages
22  arising from the use of this software.
23 
24  Permission is granted to anyone to use this software for any purpose,
25  including commercial applications, and to alter it and redistribute it
26  freely, subject to the following restrictions:
27 
28  1. The origin of this software must not be misrepresented; you must not
29  claim that you wrote the original software. If you use this software
30  in a product, an acknowledgment in the product documentation would be
31  appreciated but is not required.
32  2. Altered source versions must be plainly marked as such, and must not be
33  misrepresented as being the original software.
34  3. This notice may not be removed or altered from any source distribution.
35 
36 
37 */
38 
39 /* for more info about .ZIP format, see
40  http://www.info-zip.org/pub/infozip/doc/appnote-981119-iz.zip
41  http://www.info-zip.org/pub/infozip/doc/
42  PkWare has also a specification at :
43  ftp://ftp.pkware.com/probdesc.zip
44 */
45 
46 #ifndef _zip_H
47 #define _zip_H
48 
49 #ifdef __cplusplus
50 extern "C" {
51 #endif
52 
53 #ifndef _ZLIB_H
54 #include "zlib.h"
55 #endif
56 
57 #ifndef _ZLIBIOAPI_H
58 #include "ioapi.h"
59 #endif
60 
61 #if defined(STRICTZIP) || defined(STRICTZIPUNZIP)
62 /* like the STRICT of WIN32, we define a pointer that cannot be converted
63  from (void*) without cast */
64 typedef struct TagzipFile__ { int unused; } zipFile__;
65 typedef zipFile__ *zipFile;
66 #else
67 typedef voidp zipFile;
68 #endif
69 
70 #define ZIP_OK (0)
71 #define ZIP_EOF (0)
72 #define ZIP_ERRNO (Z_ERRNO)
73 #define ZIP_PARAMERROR (-102)
74 #define ZIP_BADZIPFILE (-103)
75 #define ZIP_INTERNALERROR (-104)
76 
77 #ifndef DEF_MEM_LEVEL
78 # if MAX_MEM_LEVEL >= 8
79 # define DEF_MEM_LEVEL 8
80 # else
81 # define DEF_MEM_LEVEL MAX_MEM_LEVEL
82 # endif
83 #endif
84 /* default memLevel */
85 
86 /* tm_zip contain date/time info */
87 typedef struct tm_zip_s
88 {
89  uInt tm_sec; /* seconds after the minute - [0,59] */
90  uInt tm_min; /* minutes after the hour - [0,59] */
91  uInt tm_hour; /* hours since midnight - [0,23] */
92  uInt tm_mday; /* day of the month - [1,31] */
93  uInt tm_mon; /* months since January - [0,11] */
94  uInt tm_year; /* years - [1980..2044] */
95 } tm_zip;
96 
97 typedef struct
98 {
99  tm_zip tmz_date; /* date in understandable format */
100  uLong dosDate; /* if dos_date == 0, tmu_date is used */
101 /* uLong flag; */ /* general purpose bit flag 2 bytes */
102 
103  uLong internal_fa; /* internal file attributes 2 bytes */
104  uLong external_fa; /* external file attributes 4 bytes */
105 } zip_fileinfo;
106 
107 typedef const char* zipcharpc;
108 
109 
110 #define APPEND_STATUS_CREATE (0)
111 #define APPEND_STATUS_CREATEAFTER (1)
112 #define APPEND_STATUS_ADDINZIP (2)
113 
114 extern zipFile ZEXPORT zipOpen OF((const char *pathname, int append));
115 /*
116  Create a zipfile.
117  pathname contain on Windows XP a filename like "c:\\zlib\\zlib113.zip" or on
118  an Unix computer "zlib/zlib113.zip".
119  if the file pathname exist and append==APPEND_STATUS_CREATEAFTER, the zip
120  will be created at the end of the file.
121  (useful if the file contain a self extractor code)
122  if the file pathname exist and append==APPEND_STATUS_ADDINZIP, we will
123  add files in existing zip (be sure you don't add file that doesn't exist)
124  If the zipfile cannot be opened, the return value is NULL.
125  Else, the return value is a zipFile Handle, usable with other function
126  of this zip package.
127 */
128 
129 /* Note : there is no delete function into a zipfile.
130  If you want delete file into a zipfile, you must open a zipfile, and create another
131  Of couse, you can use RAW reading and writing to copy the file you did not want delte
132 */
133 
134 extern zipFile ZEXPORT zipOpen2 OF((const char *pathname,
135  int append,
136  zipcharpc* globalcomment,
137  zlib_filefunc_def* pzlib_filefunc_def));
138 
139 extern int ZEXPORT zipOpenNewFileInZip OF((zipFile file,
140  const char* filename,
141  const zip_fileinfo* zipfi,
142  const void* extrafield_local,
143  uInt size_extrafield_local,
144  const void* extrafield_global,
145  uInt size_extrafield_global,
146  const char* comment,
147  int method,
148  int level));
149 /*
150  Open a file in the ZIP for writing.
151  filename : the filename in zip (if NULL, '-' without quote will be used
152  *zipfi contain supplemental information
153  if extrafield_local!=NULL and size_extrafield_local>0, extrafield_local
154  contains the extrafield data the the local header
155  if extrafield_global!=NULL and size_extrafield_global>0, extrafield_global
156  contains the extrafield data the the local header
157  if comment != NULL, comment contain the comment string
158  method contain the compression method (0 for store, Z_DEFLATED for deflate)
159  level contain the level of compression (can be Z_DEFAULT_COMPRESSION)
160 */
161 
162 
163 extern int ZEXPORT zipOpenNewFileInZip2 OF((zipFile file,
164  const char* filename,
165  const zip_fileinfo* zipfi,
166  const void* extrafield_local,
167  uInt size_extrafield_local,
168  const void* extrafield_global,
169  uInt size_extrafield_global,
170  const char* comment,
171  int method,
172  int level,
173  int raw));
174 
175 /*
176  Same than zipOpenNewFileInZip, except if raw=1, we write raw file
177  */
178 
179 extern int ZEXPORT zipOpenNewFileInZip3 OF((zipFile file,
180  const char* filename,
181  const zip_fileinfo* zipfi,
182  const void* extrafield_local,
183  uInt size_extrafield_local,
184  const void* extrafield_global,
185  uInt size_extrafield_global,
186  const char* comment,
187  int method,
188  int level,
189  int raw,
190  int windowBits,
191  int memLevel,
192  int strategy,
193  const char* password,
194  uLong crcForCtypting));
195 
196 /*
197  Same than zipOpenNewFileInZip2, except
198  windowBits,memLevel,,strategy : see parameter strategy in deflateInit2
199  password : crypting password (NULL for no crypting)
200  crcForCtypting : crc of file to compress (needed for crypting)
201  */
202 
203 
204 extern int ZEXPORT zipWriteInFileInZip OF((zipFile file,
205  const void* buf,
206  unsigned len));
207 /*
208  Write data in the zipfile
209 */
210 
211 extern int ZEXPORT zipCloseFileInZip OF((zipFile file));
212 /*
213  Close the current file in the zipfile
214 */
215 
216 extern int ZEXPORT zipCloseFileInZipRaw OF((zipFile file,
217  uLong uncompressed_size,
218  uLong crc32));
219 /*
220  Close the current file in the zipfile, for fiel opened with
221  parameter raw=1 in zipOpenNewFileInZip2
222  uncompressed_size and crc32 are value for the uncompressed size
223 */
224 
225 extern int ZEXPORT zipClose OF((zipFile file,
226  const char* global_comment));
227 /*
228  Close the zipfile
229 */
230 
231 #ifdef __cplusplus
232 }
233 #endif
234 
235 #endif /* _zip_H */
zlib_filefunc_def_s
Definition: ioapi.h:46
tm_zip_s
Definition: zip.h:87
zip_fileinfo
Definition: zip.h:97
Generated by   doxygen 1.8.17