Annotation of embedaddon/php/ext/phar/pharzip.h, revision 1.1.1.4
1.1 misho 1: /*
2: +----------------------------------------------------------------------+
3: | phar php single-file executable PHP extension |
4: +----------------------------------------------------------------------+
1.1.1.4 ! misho 5: | Copyright (c) 2006-2014 The PHP Group |
1.1 misho 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:
1.1.1.2 misho 20: /* $Id$ */
1.1 misho 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: */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>