xref: /freebsd/contrib/file/src/cdf.h (revision 40a8ac8f62b535d30349faf28cf47106b7041b83)
1 /*-
2  * Copyright (c) 2008 Christos Zoulas
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
15  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
16  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
18  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24  * POSSIBILITY OF SUCH DAMAGE.
25  */
26 /*
27  * Parse Composite Document Files, the format used in Microsoft Office
28  * document files before they switched to zipped XML.
29  * Info from: http://sc.openoffice.org/compdocfileformat.pdf
30  *
31  * N.B. This is the "Composite Document File" format, and not the
32  * "Compound Document Format", nor the "Channel Definition Format".
33  */
34 
35 #ifndef _H_CDF_
36 #define _H_CDF_
37 
38 #ifdef WIN32
39 #include <winsock2.h>
40 #define timespec timeval
41 #define tv_nsec tv_usec
42 #endif
43 #ifdef __DJGPP__
44 #define timespec timeval
45 #define tv_nsec tv_usec
46 #endif
47 
48 typedef int32_t cdf_secid_t;
49 
50 #define CDF_LOOP_LIMIT					10000
51 
52 #define CDF_SECID_NULL					0
53 #define CDF_SECID_FREE					-1
54 #define CDF_SECID_END_OF_CHAIN				-2
55 #define CDF_SECID_SECTOR_ALLOCATION_TABLE		-3
56 #define CDF_SECID_MASTER_SECTOR_ALLOCATION_TABLE	-4
57 
58 typedef struct {
59 	uint64_t	h_magic;
60 #define CDF_MAGIC	0xE11AB1A1E011CFD0LL
61 	uint64_t	h_uuid[2];
62 	uint16_t	h_revision;
63 	uint16_t	h_version;
64 	uint16_t	h_byte_order;
65 	uint16_t	h_sec_size_p2;
66 	uint16_t	h_short_sec_size_p2;
67 	uint8_t		h_unused0[10];
68 	uint32_t	h_num_sectors_in_sat;
69 	uint32_t	h_secid_first_directory;
70 	uint8_t		h_unused1[4];
71 	uint32_t	h_min_size_standard_stream;
72 	cdf_secid_t	h_secid_first_sector_in_short_sat;
73 	uint32_t	h_num_sectors_in_short_sat;
74 	cdf_secid_t	h_secid_first_sector_in_master_sat;
75 	uint32_t	h_num_sectors_in_master_sat;
76 	cdf_secid_t	h_master_sat[436/4];
77 } cdf_header_t;
78 
79 #define CDF_SEC_SIZE(h) ((size_t)(1 << (h)->h_sec_size_p2))
80 #define CDF_SEC_POS(h, secid) (CDF_SEC_SIZE(h) + (secid) * CDF_SEC_SIZE(h))
81 #define CDF_SHORT_SEC_SIZE(h)	((size_t)(1 << (h)->h_short_sec_size_p2))
82 #define CDF_SHORT_SEC_POS(h, secid) ((secid) * CDF_SHORT_SEC_SIZE(h))
83 
84 typedef int32_t cdf_dirid_t;
85 #define CDF_DIRID_NULL	-1
86 
87 typedef int64_t cdf_timestamp_t;
88 #define CDF_BASE_YEAR	1601
89 #define CDF_TIME_PREC	10000000
90 
91 typedef struct {
92 	uint16_t	d_name[32];
93 	uint16_t	d_namelen;
94 	uint8_t		d_type;
95 #define CDF_DIR_TYPE_EMPTY		0
96 #define CDF_DIR_TYPE_USER_STORAGE	1
97 #define CDF_DIR_TYPE_USER_STREAM	2
98 #define CDF_DIR_TYPE_LOCKBYTES		3
99 #define CDF_DIR_TYPE_PROPERTY		4
100 #define CDF_DIR_TYPE_ROOT_STORAGE	5
101 	uint8_t		d_color;
102 #define CDF_DIR_COLOR_READ	0
103 #define CDF_DIR_COLOR_BLACK	1
104 	cdf_dirid_t	d_left_child;
105 	cdf_dirid_t	d_right_child;
106 	cdf_dirid_t	d_storage;
107 	uint64_t	d_storage_uuid[2];
108 	uint32_t	d_flags;
109 	cdf_timestamp_t d_created;
110 	cdf_timestamp_t d_modified;
111 	cdf_secid_t	d_stream_first_sector;
112 	uint32_t	d_size;
113 	uint32_t	d_unused0;
114 } cdf_directory_t;
115 
116 #define CDF_DIRECTORY_SIZE	128
117 
118 typedef struct {
119 	cdf_secid_t *sat_tab;
120 	size_t sat_len;
121 } cdf_sat_t;
122 
123 typedef struct {
124 	cdf_directory_t *dir_tab;
125 	size_t dir_len;
126 } cdf_dir_t;
127 
128 typedef struct {
129 	void *sst_tab;
130 	size_t sst_len;
131 	size_t sst_dirlen;
132 } cdf_stream_t;
133 
134 typedef struct {
135 	uint32_t	cl_dword;
136 	uint16_t	cl_word[2];
137 	uint8_t		cl_two[2];
138 	uint8_t		cl_six[6];
139 } cdf_classid_t;
140 
141 typedef struct {
142 	uint16_t	si_byte_order;
143 	uint16_t	si_zero;
144 	uint16_t	si_os_version;
145 	uint16_t	si_os;
146 	cdf_classid_t	si_class;
147 	uint32_t	si_count;
148 } cdf_summary_info_header_t;
149 
150 #define CDF_SECTION_DECLARATION_OFFSET 0x1c
151 
152 typedef struct {
153 	cdf_classid_t	sd_class;
154 	uint32_t	sd_offset;
155 } cdf_section_declaration_t;
156 
157 typedef struct {
158 	uint32_t	sh_len;
159 	uint32_t	sh_properties;
160 } cdf_section_header_t;
161 
162 typedef struct {
163 	uint32_t	pi_id;
164 	uint32_t	pi_type;
165 	union {
166 		uint16_t	_pi_u16;
167 		int16_t		_pi_s16;
168 		uint32_t	_pi_u32;
169 		int32_t		_pi_s32;
170 		uint64_t	_pi_u64;
171 		int64_t		_pi_s64;
172 		cdf_timestamp_t _pi_tp;
173 		float		_pi_f;
174 		double		_pi_d;
175 		struct {
176 			uint32_t s_len;
177 			const char *s_buf;
178 		} _pi_str;
179 	} pi_val;
180 #define pi_u64	pi_val._pi_u64
181 #define pi_s64	pi_val._pi_s64
182 #define pi_u32	pi_val._pi_u32
183 #define pi_s32	pi_val._pi_s32
184 #define pi_u16	pi_val._pi_u16
185 #define pi_s16	pi_val._pi_s16
186 #define pi_f	pi_val._pi_f
187 #define pi_d	pi_val._pi_d
188 #define pi_tp	pi_val._pi_tp
189 #define pi_str	pi_val._pi_str
190 } cdf_property_info_t;
191 
192 #define CDF_ROUND(val, by)     (((val) + (by) - 1) & ~((by) - 1))
193 
194 /* Variant type definitions */
195 #define CDF_EMPTY		0x00000000
196 #define CDF_NULL		0x00000001
197 #define CDF_SIGNED16		0x00000002
198 #define CDF_SIGNED32		0x00000003
199 #define CDF_FLOAT		0x00000004
200 #define CDF_DOUBLE		0x00000005
201 #define CDF_CY			0x00000006
202 #define CDF_DATE		0x00000007
203 #define CDF_BSTR		0x00000008
204 #define CDF_DISPATCH		0x00000009
205 #define CDF_ERROR		0x0000000a
206 #define CDF_BOOL		0x0000000b
207 #define CDF_VARIANT		0x0000000c
208 #define CDF_UNKNOWN		0x0000000d
209 #define CDF_DECIMAL		0x0000000e
210 #define CDF_SIGNED8		0x00000010
211 #define CDF_UNSIGNED8		0x00000011
212 #define CDF_UNSIGNED16		0x00000012
213 #define CDF_UNSIGNED32		0x00000013
214 #define CDF_SIGNED64		0x00000014
215 #define CDF_UNSIGNED64		0x00000015
216 #define CDF_INT			0x00000016
217 #define CDF_UINT		0x00000017
218 #define CDF_VOID		0x00000018
219 #define CDF_HRESULT		0x00000019
220 #define CDF_PTR			0x0000001a
221 #define CDF_SAFEARRAY		0x0000001b
222 #define CDF_CARRAY		0x0000001c
223 #define CDF_USERDEFINED		0x0000001d
224 #define CDF_LENGTH32_STRING	0x0000001e
225 #define CDF_LENGTH32_WSTRING	0x0000001f
226 #define CDF_FILETIME		0x00000040
227 #define CDF_BLOB		0x00000041
228 #define CDF_STREAM		0x00000042
229 #define CDF_STORAGE		0x00000043
230 #define CDF_STREAMED_OBJECT	0x00000044
231 #define CDF_STORED_OBJECT	0x00000045
232 #define CDF_BLOB_OBJECT		0x00000046
233 #define CDF_CLIPBOARD		0x00000047
234 #define CDF_CLSID		0x00000048
235 #define CDF_VECTOR		0x00001000
236 #define CDF_ARRAY		0x00002000
237 #define CDF_BYREF		0x00004000
238 #define CDF_RESERVED		0x00008000
239 #define CDF_ILLEGAL		0x0000ffff
240 #define CDF_ILLEGALMASKED	0x00000fff
241 #define CDF_TYPEMASK		0x00000fff
242 
243 #define CDF_PROPERTY_CODE_PAGE			0x00000001
244 #define CDF_PROPERTY_TITLE			0x00000002
245 #define CDF_PROPERTY_SUBJECT			0x00000003
246 #define CDF_PROPERTY_AUTHOR			0x00000004
247 #define CDF_PROPERTY_KEYWORDS			0x00000005
248 #define CDF_PROPERTY_COMMENTS			0x00000006
249 #define CDF_PROPERTY_TEMPLATE			0x00000007
250 #define CDF_PROPERTY_LAST_SAVED_BY		0x00000008
251 #define CDF_PROPERTY_REVISION_NUMBER		0x00000009
252 #define CDF_PROPERTY_TOTAL_EDITING_TIME		0x0000000a
253 #define CDF_PROPERTY_LAST_PRINTED		0X0000000b
254 #define CDF_PROPERTY_CREATE_TIME		0x0000000c
255 #define CDF_PROPERTY_LAST_SAVED_TIME		0x0000000d
256 #define CDF_PROPERTY_NUMBER_OF_PAGES		0x0000000e
257 #define CDF_PROPERTY_NUMBER_OF_WORDS		0x0000000f
258 #define CDF_PROPERTY_NUMBER_OF_CHARACTERS	0x00000010
259 #define CDF_PROPERTY_THUMBNAIL			0x00000011
260 #define CDF_PROPERTY_NAME_OF_APPLICATION	0x00000012
261 #define CDF_PROPERTY_SECURITY			0x00000013
262 #define CDF_PROPERTY_LOCALE_ID			0x80000000
263 
264 typedef struct {
265 	int i_fd;
266 	const unsigned char *i_buf;
267 	size_t i_len;
268 } cdf_info_t;
269 
270 struct timespec;
271 int cdf_timestamp_to_timespec(struct timespec *, cdf_timestamp_t);
272 int cdf_timespec_to_timestamp(cdf_timestamp_t *, const struct timespec *);
273 int cdf_read_header(const cdf_info_t *, cdf_header_t *);
274 void cdf_swap_header(cdf_header_t *);
275 void cdf_unpack_header(cdf_header_t *, char *);
276 void cdf_swap_dir(cdf_directory_t *);
277 void cdf_unpack_dir(cdf_directory_t *, char *);
278 void cdf_swap_class(cdf_classid_t *);
279 ssize_t cdf_read_sector(const cdf_info_t *, void *, size_t, size_t,
280     const cdf_header_t *, cdf_secid_t);
281 ssize_t cdf_read_short_sector(const cdf_stream_t *, void *, size_t, size_t,
282     const cdf_header_t *, cdf_secid_t);
283 int cdf_read_sat(const cdf_info_t *, cdf_header_t *, cdf_sat_t *);
284 size_t cdf_count_chain(const cdf_sat_t *, cdf_secid_t, size_t);
285 int cdf_read_long_sector_chain(const cdf_info_t *, const cdf_header_t *,
286     const cdf_sat_t *, cdf_secid_t, size_t, cdf_stream_t *);
287 int cdf_read_short_sector_chain(const cdf_header_t *, const cdf_sat_t *,
288     const cdf_stream_t *, cdf_secid_t, size_t, cdf_stream_t *);
289 int cdf_read_sector_chain(const cdf_info_t *, const cdf_header_t *,
290     const cdf_sat_t *, const cdf_sat_t *, const cdf_stream_t *, cdf_secid_t,
291     size_t, cdf_stream_t *);
292 int cdf_read_dir(const cdf_info_t *, const cdf_header_t *, const cdf_sat_t *,
293     cdf_dir_t *);
294 int cdf_read_ssat(const cdf_info_t *, const cdf_header_t *, const cdf_sat_t *,
295     cdf_sat_t *);
296 int cdf_read_short_stream(const cdf_info_t *, const cdf_header_t *,
297     const cdf_sat_t *, const cdf_dir_t *, cdf_stream_t *,
298     const cdf_directory_t **);
299 int cdf_read_property_info(const cdf_stream_t *, const cdf_header_t *, uint32_t,
300     cdf_property_info_t **, size_t *, size_t *);
301 int cdf_read_user_stream(const cdf_info_t *, const cdf_header_t *,
302     const cdf_sat_t *, const cdf_sat_t *, const cdf_stream_t *,
303     const cdf_dir_t *, const char *, cdf_stream_t *);
304 int cdf_read_summary_info(const cdf_info_t *, const cdf_header_t *,
305     const cdf_sat_t *, const cdf_sat_t *, const cdf_stream_t *,
306     const cdf_dir_t *, cdf_stream_t *);
307 int cdf_unpack_summary_info(const cdf_stream_t *, const cdf_header_t *,
308     cdf_summary_info_header_t *, cdf_property_info_t **, size_t *);
309 int cdf_print_classid(char *, size_t, const cdf_classid_t *);
310 int cdf_print_property_name(char *, size_t, uint32_t);
311 int cdf_print_elapsed_time(char *, size_t, cdf_timestamp_t);
312 uint16_t cdf_tole2(uint16_t);
313 uint32_t cdf_tole4(uint32_t);
314 uint64_t cdf_tole8(uint64_t);
315 char *cdf_ctime(const time_t *, char *);
316 
317 #ifdef CDF_DEBUG
318 void cdf_dump_header(const cdf_header_t *);
319 void cdf_dump_sat(const char *, const cdf_sat_t *, size_t);
320 void cdf_dump(void *, size_t);
321 void cdf_dump_stream(const cdf_header_t *, const cdf_stream_t *);
322 void cdf_dump_dir(const cdf_info_t *, const cdf_header_t *, const cdf_sat_t *,
323     const cdf_sat_t *, const cdf_stream_t *, const cdf_dir_t *);
324 void cdf_dump_property_info(const cdf_property_info_t *, size_t);
325 void cdf_dump_summary_info(const cdf_header_t *, const cdf_stream_t *);
326 #endif
327 
328 
329 #endif /* _H_CDF_ */
330