1/*	$NetBSD: zip.h,v 1.1.1.1 2006/01/14 20:11:01 christos Exp $	*/
2
3/* zip.h -- IO for compress .zip files using zlib
4   Version 1.01e, February 12th, 2005
5
6   Copyright (C) 1998-2005 Gilles Vollant
7
8   This unzip package allow creates .ZIP file, compatible with PKZip 2.04g
9     WinZip, InfoZip tools and compatible.
10   Multi volume ZipFile (span) are not supported.
11   Encryption compatible with pkzip 2.04g only supported
12   Old compressions used by old PKZip 1.x are not supported
13
14  For uncompress .zip file, look at unzip.h
15
16
17   I WAIT FEEDBACK at mail info@winimage.com
18   Visit also http://www.winimage.com/zLibDll/unzip.html for evolution
19
20   Condition of use and distribution are the same than zlib :
21
22  This software is provided 'as-is', without any express or implied
23  warranty.  In no event will the authors be held liable for any damages
24  arising from the use of this software.
25
26  Permission is granted to anyone to use this software for any purpose,
27  including commercial applications, and to alter it and redistribute it
28  freely, subject to the following restrictions:
29
30  1. The origin of this software must not be misrepresented; you must not
31     claim that you wrote the original software. If you use this software
32     in a product, an acknowledgment in the product documentation would be
33     appreciated but is not required.
34  2. Altered source versions must be plainly marked as such, and must not be
35     misrepresented as being the original software.
36  3. This notice may not be removed or altered from any source distribution.
37
38
39*/
40
41/* for more info about .ZIP format, see
42      http://www.info-zip.org/pub/infozip/doc/appnote-981119-iz.zip
43      http://www.info-zip.org/pub/infozip/doc/
44   PkWare has also a specification at :
45      ftp://ftp.pkware.com/probdesc.zip
46*/
47
48#ifndef _zip_H
49#define _zip_H
50
51#ifdef __cplusplus
52extern "C" {
53#endif
54
55#ifndef _ZLIB_H
56#include "zlib.h"
57#endif
58
59#ifndef _ZLIBIOAPI_H
60#include "ioapi.h"
61#endif
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));
117/*
118  Create a zipfile.
119     pathname contain on Windows XP a filename like "c:\\zlib\\zlib113.zip" or on
120       an Unix computer "zlib/zlib113.zip".
121     if the file pathname exist and append==APPEND_STATUS_CREATEAFTER, the zip
122       will be created at the end of the file.
123         (useful if the file contain a self extractor code)
124     if the file pathname exist and append==APPEND_STATUS_ADDINZIP, we will
125       add files in existing zip (be sure you don't add file that doesn't exist)
126     If the zipfile cannot be opened, the return value is NULL.
127     Else, the return value is a zipFile Handle, usable with other function
128       of this zip package.
129*/
130
131/* Note : there is no delete function into a zipfile.
132   If you want delete file into a zipfile, you must open a zipfile, and create another
133   Of couse, you can use RAW reading and writing to copy the file you did not want delte
134*/
135
136extern zipFile ZEXPORT zipOpen2 OF((const char *pathname,
137                                   int append,
138                                   zipcharpc* globalcomment,
139                                   zlib_filefunc_def* pzlib_filefunc_def));
140
141extern int ZEXPORT zipOpenNewFileInZip OF((zipFile file,
142                       const char* filename,
143                       const zip_fileinfo* zipfi,
144                       const void* extrafield_local,
145                       uInt size_extrafield_local,
146                       const void* extrafield_global,
147                       uInt size_extrafield_global,
148                       const char* comment,
149                       int method,
150                       int level));
151/*
152  Open a file in the ZIP for writing.
153  filename : the filename in zip (if NULL, '-' without quote will be used
154  *zipfi contain supplemental information
155  if extrafield_local!=NULL and size_extrafield_local>0, extrafield_local
156    contains the extrafield data the the local header
157  if extrafield_global!=NULL and size_extrafield_global>0, extrafield_global
158    contains the extrafield data the the local header
159  if comment != NULL, comment contain the comment string
160  method contain the compression method (0 for store, Z_DEFLATED for deflate)
161  level contain the level of compression (can be Z_DEFAULT_COMPRESSION)
162*/
163
164
165extern int ZEXPORT zipOpenNewFileInZip2 OF((zipFile file,
166                                            const char* filename,
167                                            const zip_fileinfo* zipfi,
168                                            const void* extrafield_local,
169                                            uInt size_extrafield_local,
170                                            const void* extrafield_global,
171                                            uInt size_extrafield_global,
172                                            const char* comment,
173                                            int method,
174                                            int level,
175                                            int raw));
176
177/*
178  Same than zipOpenNewFileInZip, except if raw=1, we write raw file
179 */
180
181extern int ZEXPORT zipOpenNewFileInZip3 OF((zipFile file,
182                                            const char* filename,
183                                            const zip_fileinfo* zipfi,
184                                            const void* extrafield_local,
185                                            uInt size_extrafield_local,
186                                            const void* extrafield_global,
187                                            uInt size_extrafield_global,
188                                            const char* comment,
189                                            int method,
190                                            int level,
191                                            int raw,
192                                            int windowBits,
193                                            int memLevel,
194                                            int strategy,
195                                            const char* password,
196                                            uLong crcForCtypting));
197
198/*
199  Same than zipOpenNewFileInZip2, except
200    windowBits,memLevel,,strategy : see parameter strategy in deflateInit2
201    password : crypting password (NULL for no crypting)
202    crcForCtypting : crc of file to compress (needed for crypting)
203 */
204
205
206extern int ZEXPORT zipWriteInFileInZip OF((zipFile file,
207                       const void* buf,
208                       unsigned len));
209/*
210  Write data in the zipfile
211*/
212
213extern int ZEXPORT zipCloseFileInZip OF((zipFile file));
214/*
215  Close the current file in the zipfile
216*/
217
218extern int ZEXPORT zipCloseFileInZipRaw OF((zipFile file,
219                                            uLong uncompressed_size,
220                                            uLong crc32));
221/*
222  Close the current file in the zipfile, for fiel opened with
223    parameter raw=1 in zipOpenNewFileInZip2
224  uncompressed_size and crc32 are value for the uncompressed size
225*/
226
227extern int ZEXPORT zipClose OF((zipFile file,
228                const char* global_comment));
229/*
230  Close the zipfile
231*/
232
233#ifdef __cplusplus
234}
235#endif
236
237#endif /* _zip_H */
238