xref: /PHP-5.6/ext/phar/pharzip.h (revision 49493a2d)
1 /*
2   +----------------------------------------------------------------------+
3   | phar php single-file executable PHP extension                        |
4   +----------------------------------------------------------------------+
5   | Copyright (c) 2006-2016 The PHP Group                                |
6   +----------------------------------------------------------------------+
7   | This source file is subject to version 3.01 of the PHP license,      |
8   | that is bundled with this package in the file LICENSE, and is        |
9   | available through the world-wide-web at the following url:           |
10   | http://www.php.net/license/3_01.txt.                                 |
11   | If you did not receive a copy of the PHP license and are unable to   |
12   | obtain it through the world-wide-web, please send a note to          |
13   | license@php.net so we can mail you a copy immediately.               |
14   +----------------------------------------------------------------------+
15   | Authors: Gregory Beaver <cellog@php.net>                             |
16   |          Marcus Boerger <helly@php.net>                              |
17   +----------------------------------------------------------------------+
18 */
19 
20 /* $Id$ */
21 
22 typedef struct _phar_zip_file_header {
23 	char signature[4];       /* local file header signature     4 bytes  (0x04034b50) */
24 	char zipversion[2];      /* version needed to extract       2 bytes */
25 	char flags[2];        /* general purpose bit flag        2 bytes */
26 	char compressed[2];   /* compression method              2 bytes */
27 	char timestamp[2];    /* last mod file time              2 bytes */
28 	char datestamp[2];    /* last mod file date              2 bytes */
29 	char crc32[4];        /* crc-32                          4 bytes */
30 	char compsize[4];     /* compressed size                 4 bytes */
31 	char uncompsize[4];   /* uncompressed size               4 bytes */
32 	char filename_len[2]; /* file name length                2 bytes */
33 	char extra_len[2];    /* extra field length              2 bytes */
34 /* file name (variable size) */
35 /* extra field (variable size) */
36 } phar_zip_file_header;
37 
38 /* unused in this release */
39 typedef struct _phar_zip_file_datadesc {
40 	char signature[4];  /* signature (optional)            4 bytes */
41 	char crc32[4];      /* crc-32                          4 bytes */
42 	char compsize[4];   /* compressed size                 4 bytes */
43 	char uncompsize[4]; /* uncompressed size               4 bytes */
44 } phar_zip_data_desc;
45 
46 /* unused in this release */
47 typedef struct _phar_zip_file_datadesc_zip64 {
48 	char crc32[4];       /* crc-32                          4 bytes */
49 	char compsize[4];    /* compressed size                 8 bytes */
50 	char compsize2[4];
51 	char uncompsize[4];  /* uncompressed size               8 bytes */
52 	char uncompsize2[4];
53 } phar_zip_data_desc_zip64;
54 
55 typedef struct _phar_zip_archive_extra_data_record {
56 	char signature[4];   /* archive extra data signature    4 bytes  (0x08064b50) */
57 	char len[4];      /* extra field length              4 bytes */
58 /* extra field data                (variable size) */
59 } phar_zip_archive_extra_data_record;
60 
61 /* madeby/extractneeded value if bzip2 compression is used */
62 #define PHAR_ZIP_BZIP2 "46"
63 /* madeby/extractneeded value for other cases */
64 #define PHAR_ZIP_NORM  "20"
65 
66 #define PHAR_ZIP_FLAG_ENCRYPTED 0x0001
67 /* data descriptor present for this file */
68 #define PHAR_ZIP_FLAG_DATADESC  0x0008
69 #define PHAR_ZIP_FLAG_UTF8      0x0400
70 
71 /*
72 0 - The file is stored (no compression)
73 1 - The file is Shrunk
74 2 - The file is Reduced with compression factor 1
75 3 - The file is Reduced with compression factor 2
76 4 - The file is Reduced with compression factor 3
77 5 - The file is Reduced with compression factor 4
78 6 - The file is Imploded
79 7 - Reserved for Tokenizing compression algorithm
80 8 - The file is Deflated
81 9 - Enhanced Deflating using Deflate64(tm)
82 10 - PKWARE Data Compression Library Imploding (old IBM TERSE)
83 11 - Reserved by PKWARE
84 12 - File is compressed using BZIP2 algorithm
85 13 - Reserved by PKWARE
86 14 - LZMA (EFS)
87 15 - Reserved by PKWARE
88 16 - Reserved by PKWARE
89 17 - Reserved by PKWARE
90 18 - File is compressed using IBM TERSE (new)
91 19 - IBM LZ77 z Architecture (PFS)
92 97 - WavPack compressed data
93 98 - PPMd version I, Rev 1
94 */
95 #define PHAR_ZIP_COMP_NONE    0
96 #define PHAR_ZIP_COMP_DEFLATE 8
97 #define PHAR_ZIP_COMP_BZIP2   12
98 
99 /*
100          -ASi Unix Extra Field:
101           ====================
102 
103           The following is the layout of the ASi extra block for Unix.  The
104           local-header and central-header versions are identical.
105           (Last Revision 19960916)
106 
107           Value         Size        Description
108           -----         ----        -----------
109   (Unix3) 0x756e        Short       tag for this extra block type ("nu")
110           TSize         Short       total data size for this block
111           CRC           Long        CRC-32 of the remaining data
112           Mode          Short       file permissions
113           SizDev        Long        symlink'd size OR major/minor dev num
114           UID           Short       user ID
115           GID           Short       group ID
116           (var.)        variable    symbolic link filename
117 
118           Mode is the standard Unix st_mode field from struct stat, containing
119           user/group/other permissions, setuid/setgid and symlink info, etc.
120 
121           If Mode indicates that this file is a symbolic link, SizDev is the
122           size of the file to which the link points.  Otherwise, if the file
123           is a device, SizDev contains the standard Unix st_rdev field from
124           struct stat (includes the major and minor numbers of the device).
125           SizDev is undefined in other cases.
126 
127           If Mode indicates that the file is a symbolic link, the final field
128           will be the name of the file to which the link points.  The file-
129           name length can be inferred from TSize.
130 
131           [Note that TSize may incorrectly refer to the data size not counting
132            the CRC; i.e., it may be four bytes too small.]
133 */
134 
135 typedef struct _phar_zip_extra_field_header {
136 	char tag[2];
137 	char size[2];
138 } phar_zip_extra_field_header;
139 
140 typedef struct _phar_zip_unix3 {
141 	char tag[2];            /* 0x756e        Short       tag for this extra block type ("nu") */
142 	char size[2];        /* TSize         Short       total data size for this block */
143 	char crc32[4];       /* CRC           Long        CRC-32 of the remaining data */
144 	char perms[2];       /* Mode          Short       file permissions */
145 	char symlinksize[4]; /* SizDev        Long        symlink'd size OR major/minor dev num */
146 	char uid[2];         /* UID           Short       user ID */
147 	char gid[2];         /* GID           Short       group ID */
148 /* (var.)        variable    symbolic link filename */
149 } phar_zip_unix3;
150 
151 typedef struct _phar_zip_central_dir_file {
152 	char signature[4];            /* central file header signature   4 bytes  (0x02014b50) */
153 	char madeby[2];               /* version made by                 2 bytes */
154 	char zipversion[2];           /* version needed to extract       2 bytes */
155 	char flags[2];             /* general purpose bit flag        2 bytes */
156 	char compressed[2];        /* compression method              2 bytes */
157 	char timestamp[2];         /* last mod file time              2 bytes */
158 	char datestamp[2];         /* last mod file date              2 bytes */
159 	char crc32[4];             /* crc-32                          4 bytes */
160 	char compsize[4];          /* compressed size                 4 bytes */
161 	char uncompsize[4];        /* uncompressed size               4 bytes */
162 	char filename_len[2];      /* file name length                2 bytes */
163 	char extra_len[2];         /* extra field length              2 bytes */
164 	char comment_len[2];       /* file comment length             2 bytes */
165 	char disknumber[2];        /* disk number start               2 bytes */
166 	char internal_atts[2];     /* internal file attributes        2 bytes */
167 	char external_atts[4];     /* external file attributes        4 bytes */
168 	char offset[4];            /* relative offset of local header 4 bytes */
169 
170 /* file name (variable size) */
171 /* extra field (variable size) */
172 /* file comment (variable size) */
173 } phar_zip_central_dir_file;
174 
175 typedef struct _phar_zip_dir_signature {
176 	char signature[4];  /* header signature                4 bytes  (0x05054b50) */
177 	char size[2];    /* size of data                    2 bytes */
178 } phar_zip_dir_signature;
179 
180 /* unused in this release */
181 typedef struct _phar_zip64_dir_end {
182 	char signature[4];        /* zip64 end of central dir
183                                  signature                       4 bytes  (0x06064b50) */
184 	char size1[4];         /* size of zip64 end of central
185                                  directory record                8 bytes */
186 	char size2[4];
187 	char madeby[2];           /* version made by                 2 bytes */
188 	char extractneeded[2]; /* version needed to extract       2 bytes */
189 	char disknum[4];       /* number of this disk             4 bytes */
190 	char cdir_num[4];      /* number of the disk with the
191                                  start of the central directory  4 bytes */
192 	char entries1[4];      /* total number of entries in the
193                                  central directory on this disk  8 bytes */
194 	char entries2[4];
195 	char entriestotal1[4]; /* total number of entries in the
196                                  central directory               8 bytes */
197 	char entriestotal2[4];
198 	char cdirsize1[4];     /* size of the central directory   8 bytes */
199 	char cdirsize2[4];
200 	char offset1[4];       /* offset of start of central
201                                  directory with respect to
202                                  the starting disk number        8 bytes */
203 	char offset2[4];
204 /* zip64 extensible data sector    (variable size) */
205 } phar_zip64_dir_end;
206 
207 /* unused in this release */
208 typedef struct _phar_zip64_dir_locator {
209 	char signature[4];     /* zip64 end of central dir locator
210                               signature                       4 bytes  (0x07064b50) */
211 	char disknum[4];    /* number of the disk with the
212                               start of the zip64 end of
213                               central directory               4 bytes */
214 	char diroffset1[4]; /* relative offset of the zip64
215                               end of central directory record 8 bytes */
216 	char diroffset2[4];
217 	char totaldisks[4]; /* total number of disks           4 bytes */
218 } phar_zip64_dir_locator;
219 
220 typedef struct _phar_zip_dir_end {
221 	char signature[4];           /* end of central dir signature    4 bytes  (0x06054b50) */
222 	char disknumber[2];       /* number of this disk             2 bytes */
223 	char centraldisk[2];      /* number of the disk with the
224                                     start of the central directory  2 bytes */
225 	char counthere[2];        /* total number of entries in the
226                                     central directory on this disk  2 bytes */
227 	char count[2];            /* total number of entries in
228                                     the central directory           2 bytes */
229 	char cdir_size[4];        /* size of the central directory   4 bytes */
230 	char cdir_offset[4];      /* offset of start of central
231                                     directory with respect to
232                                     the starting disk number        4 bytes */
233 	char comment_len[2];      /* .ZIP file comment length        2 bytes */
234 /* .ZIP file comment       (variable size) */
235 } phar_zip_dir_end;
236 /*
237  * Local variables:
238  * tab-width: 4
239  * c-basic-offset: 4
240  * End:
241  * vim600: noet sw=4 ts=4 fdm=marker
242  * vim<600: noet sw=4 ts=4
243  */
244