Context Navigation

← Previous Revision
Next Revision →
Blame
Revision Log

udf.h

Last change on this file was 101586, checked in by vboxsync, 7 months ago
IPRT/formats/udf.h: Docs fixes. bugref:10517
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 84.5 KB

Line
1	/* $Id: udf.h 101586 2023-10-25 11:08:19Z vboxsync $ */
2	/** @file
3	* IPRT, Universal Disk Format (UDF).
4	*/
5
6	/*
7	* Copyright (C) 2017-2023 Oracle and/or its affiliates.
8	*
9	* This file is part of VirtualBox base platform packages, as
10	* available from https://www.virtualbox.org.
11	*
12	* This program is free software; you can redistribute it and/or
13	* modify it under the terms of the GNU General Public License
14	* as published by the Free Software Foundation, in version 3 of the
15	* License.
16	*
17	* This program is distributed in the hope that it will be useful, but
18	* WITHOUT ANY WARRANTY; without even the implied warranty of
19	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20	* General Public License for more details.
21	*
22	* You should have received a copy of the GNU General Public License
23	* along with this program; if not, see <https://www.gnu.org/licenses>.
24	*
25	* The contents of this file may alternatively be used under the terms
26	* of the Common Development and Distribution License Version 1.0
27	* (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
28	* in the VirtualBox distribution, in which case the provisions of the
29	* CDDL are applicable instead of those of the GPL.
30	*
31	* You may elect to license modified versions of this file under the
32	* terms and conditions of either the GPL or the CDDL or both.
33	*
34	* SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
35	*/
36
37	#ifndef IPRT_INCLUDED_formats_udf_h
38	#define IPRT_INCLUDED_formats_udf_h
39	#ifndef RT_WITHOUT_PRAGMA_ONCE
40	# pragma once
41	#endif
42
43	#include <iprt/types.h>
44	#include <iprt/assertcompile.h>
45	#include <iprt/formats/iso9660.h>
46
47
48	/** @defgroup grp_rt_formats_udf Universal Disk Format (UDF) structures and definitions
49	* @ingroup grp_rt_formats
50	*
51	* References:
52	* - https://www.ecma-international.org/publications/files/ECMA-ST/Ecma-167.pdf
53	* - http://www.osta.org/specs/pdf/udf260.pdf
54	* - http://wiki.osdev.org/UDF
55	* - https://sites.google.com/site/udfintro/
56	*
57	* @{
58	*/
59
60	/**
61	* UDF d-character string (@ecma167{1,7.2.12,25}).
62	*
63	* This is mainly to mark what's d-strings and what's not.
64	*/
65	typedef char UDFDSTRING;
66	/** Pointer to an UDF dstring. */
67	typedef UDFDSTRING *PUDFDSTRING;
68	/** Pointer to a const UDF dstring. */
69	typedef UDFDSTRING const *PCUDFDSTRING;
70
71	/**
72	* UDF extent allocation descriptor (AD) (@ecma167{3,7.1,42}).
73	*/
74	typedef struct UDFEXTENTAD
75	{
76	/** Extent length in bytes. */
77	uint32_t cb;
78	/** Extent offset (logical sector number).
79	* If @a cb is zero, this is also zero. */
80	uint32_t off;
81	} UDFEXTENTAD;
82	AssertCompileSize(UDFEXTENTAD, 8);
83	/** Pointer to an UDF extent descriptor. */
84	typedef UDFEXTENTAD *PUDFEXTENTAD;
85	/** Pointer to a const UDF extent descriptor. */
86	typedef UDFEXTENTAD const *PCUDFEXTENTAD;
87
88
89	/**
90	* UDF logical block address (@ecma167{4,7.1,73}).
91	*/
92	#pragma pack(2)
93	typedef struct UDFLBADDR
94	{
95	/** Logical block number, relative to the start of the given partition. */
96	uint32_t off;
97	/** Partition reference number. */
98	uint16_t uPartitionNo;
99	} UDFLBADDR;
100	#pragma pack()
101	AssertCompileSize(UDFLBADDR, 6);
102	/** Pointer to an UDF logical block address. */
103	typedef UDFLBADDR *PUDFLBADDR;
104	/** Pointer to a const UDF logical block address. */
105	typedef UDFLBADDR const *PCUDFLBADDR;
106
107
108	/** @name UDF_AD_TYPE_XXX - Allocation descriptor types.
109	*
110	* Used by UDFSHORTAD::uType, UDFLONGAD::uType and UDFEXTAD::uType.
111	*
112	* See @ecma167{4,14.14.1.1,116}.
113	*
114	* @{ */
115	/** Recorded and allocated.
116	* Also used for zero length descriptors. */
117	#define UDF_AD_TYPE_RECORDED_AND_ALLOCATED 0
118	/** Allocated but not recorded. */
119	#define UDF_AD_TYPE_ONLY_ALLOCATED 1
120	/** Not recorded nor allocated. */
121	#define UDF_AD_TYPE_FREE 2
122	/** Go figure. */
123	#define UDF_AD_TYPE_NEXT 3
124	/** @} */
125
126	/**
127	* UDF short allocation descriptor (@ecma167{4,14.14.1,116}).
128	*/
129	typedef struct UDFSHORTAD
130	{
131	#ifdef RT_BIG_ENDIAN
132	/** Extent type (UDF_AD_TYPE_XXX). */
133	uint32_t uType : 2;
134	/** Extent length in bytes, top 2 bits . */
135	uint32_t cb : 30;
136	#else
137	/** Extent length in bytes. */
138	uint32_t cb : 30;
139	/** Extent type (UDF_AD_TYPE_XXX). */
140	uint32_t uType : 2;
141	#endif
142	/** Extent offset (logical sector number). */
143	uint32_t off;
144	} UDFSHORTAD;
145	AssertCompileSize(UDFSHORTAD, 8);
146	/** Pointer to an UDF short allocation descriptor. */
147	typedef UDFSHORTAD *PUDFSHORTAD;
148	/** Pointer to a const UDF short allocation descriptor. */
149	typedef UDFSHORTAD const *PCUDFSHORTAD;
150
151	/**
152	* UDF long allocation descriptor (@ecma167{4,14.14.2,116}).
153	*/
154	#pragma pack(2)
155	typedef struct UDFLONGAD
156	{
157	#ifdef RT_BIG_ENDIAN
158	/** Extent type (UDF_AD_TYPE_XXX). */
159	uint32_t uType : 2;
160	/** Extent length in bytes, top 2 bits . */
161	uint32_t cb : 30;
162	#else
163	/** Extent length in bytes. */
164	uint32_t cb : 30;
165	/** Extent type (UDF_AD_TYPE_XXX). */
166	uint32_t uType : 2;
167	#endif
168	/** Extent location. */
169	UDFLBADDR Location;
170	/** Implementation use area. */
171	union
172	{
173	/** Generic view. */
174	uint8_t ab[6];
175	/** Used in FIDs.
176	* See @udf260{2.3.10.1,66}, @udf260{2.3.4.3,58}.
177	*/
178	struct
179	{
180	/** Flags (UDF_AD_IMP_USE_FLAGS_XXX). */
181	uint16_t fFlags;
182	/** Unique ID. */
183	uint32_t idUnique;
184	} Fid;
185	} ImplementationUse;
186	} UDFLONGAD;
187	#pragma pack()
188	AssertCompileSize(UDFLONGAD, 16);
189	/** Pointer to an UDF long allocation descriptor. */
190	typedef UDFLONGAD *PUDFLONGAD;
191	/** Pointer to a const UDF long allocation descriptor. */
192	typedef UDFLONGAD const *PCUDFLONGAD;
193
194	/** @name UDF_AD_IMP_USE_FLAGS_XXX - UDFLONGAD::ImplementationUse::Fid::fFlags values
195	* See @udf260{2.3.10.1,66}.
196	* @{ */
197	/** Set if erased and the extend is of the type UDF_AD_TYPE_ONLY_ALLOCATED. */
198	#define UDF_AD_IMP_USE_FLAGS_ERASED UINT16_C(0x0001)
199	/** Valid mask. */
200	#define UDF_AD_IMP_USE_FLAGS_VALID_MASK UINT16_C(0x0001)
201	/** @} */
202
203	/**
204	* UDF extended allocation descriptor (@ecma167{4,14.14.3,117}).
205	*/
206	typedef struct UDFEXTAD
207	{
208	#ifdef RT_BIG_ENDIAN
209	/** 0x00: Extent type (UDF_AD_TYPE_XXX). */
210	uint32_t uType : 2;
211	/** 0x00: Extent length in bytes, top 2 bits . */
212	uint32_t cb : 30;
213	/** 0x04: Reserved, MBZ. */
214	uint32_t uReserved : 2;
215	/** 0x04: Number of bytes recorded. */
216	uint32_t cbRecorded : 30;
217	#else
218	/** 0x00: Extent length in bytes. */
219	uint32_t cb : 30;
220	/** 0x00: Extent type (UDF_AD_TYPE_XXX). */
221	uint32_t uType : 2;
222	/** 0x04: Number of bytes recorded. */
223	uint32_t cbRecorded : 30;
224	/** 0x04: Reserved, MBZ. */
225	uint32_t uReserved : 2;
226	#endif
227	/** 0x08: Number of bytes of information (from first byte). */
228	uint32_t cbInformation;
229	/** 0x0c: Extent location. */
230	UDFLBADDR Location;
231	/** 0x12: Implementation use area. */
232	uint8_t abImplementationUse[2];
233	} UDFEXTAD;
234	AssertCompileSize(UDFEXTAD, 20);
235	/** Pointer to an UDF extended allocation descriptor. */
236	typedef UDFEXTAD *PUDFEXTAD;
237	/** Pointer to a const UDF extended allocation descriptor. */
238	typedef UDFEXTAD const *PCUDFEXTAD;
239
240
241	/**
242	* UDF timestamp (@ecma167{1,7.3,25}, @udf260{2.1.4,19}).
243	*/
244	typedef struct UDFTIMESTAMP
245	{
246	#ifdef RT_BIG_ENDIAN
247	/** 0x00: Type (UDFTIMESTAMP_T_XXX). */
248	RT_GCC_EXTENSION uint16_t fType : 4;
249	/** 0x00: Time zone offset in minutes.
250	* For EST this will be -300, whereas for CET it will be 60. */
251	RT_GCC_EXTENSION int16_t offUtcInMin : 12;
252	#else
253	/** 0x00: Time zone offset in minutes.
254	* For EST this will be -300, whereas for CET it will be 60. */
255	RT_GCC_EXTENSION int16_t offUtcInMin : 12;
256	/** 0x00: Type (UDFTIMESTAMP_T_XXX). */
257	RT_GCC_EXTENSION uint16_t fType : 4;
258	#endif
259	/** 0x02: The year. */
260	int16_t iYear;
261	/** 0x04: Month of year (1-12). */
262	uint8_t uMonth;
263	/** 0x05: Day of month (1-31). */
264	uint8_t uDay;
265	/** 0x06: Hour of day (0-23). */
266	uint8_t uHour;
267	/** 0x07: Minute of hour (0-59). */
268	uint8_t uMinute;
269	/** 0x08: Second of minute (0-60 if type 2, otherwise 0-59). */
270	uint8_t uSecond;
271	/** 0x09: Number of Centiseconds (0-99). */
272	uint8_t cCentiseconds;
273	/** 0x0a: Number of hundreds of microseconds (0-99). Unit is 100us. */
274	uint8_t cHundredsOfMicroseconds;
275	/** 0x0b: Number of microseconds (0-99). */
276	uint8_t cMicroseconds;
277	} UDFTIMESTAMP;
278	AssertCompileSize(UDFTIMESTAMP, 12);
279	/** Pointer to an UDF timestamp. */
280	typedef UDFTIMESTAMP *PUDFTIMESTAMP;
281	/** Pointer to a const UDF timestamp. */
282	typedef UDFTIMESTAMP const *PCUDFTIMESTAMP;
283
284	/** @name UDFTIMESTAMP_T_XXX
285	* @{ */
286	/** Local time. */
287	#define UDFTIMESTAMP_T_LOCAL 1
288	/** @} */
289
290	/** No time zone specified. */
291	#define UDFTIMESTAMP_NO_TIME_ZONE (-2047)
292
293
294	/**
295	* UDF character set specficiation (@ecma167{1,7.2.1,21}, @udf260{2.1.2,18}).
296	*/
297	typedef struct UDFCHARSPEC
298	{
299	/** The character set type (UDF_CHAR_SET_TYPE_XXX) */
300	uint8_t uType;
301	/** Character set information. */
302	uint8_t abInfo[63];
303	} UDFCHARSPEC;
304	AssertCompileSize(UDFCHARSPEC, 64);
305	/** Pointer to UDF character set specification. */
306	typedef UDFCHARSPEC *PUDFCHARSPEC;
307	/** Pointer to const UDF character set specification. */
308	typedef UDFCHARSPEC const *PCUDFCHARSPEC;
309
310	/** @name UDF_CHAR_SET_TYPE_XXX - Character set types.
311	* @{ */
312	/** CS0: By agreement between the medium producer and consumer.
313	* See UDF_CHAR_SET_OSTA_COMPRESSED_UNICODE. */
314	#define UDF_CHAR_SET_TYPE_BY_AGREEMENT UINT8_C(0x00)
315	/** CS1: ASCII (ECMA-6) with all or part of the specified graphic characters. */
316	#define UDF_CHAR_SET_TYPE_ASCII UINT8_C(0x01)
317	/** CS5: Latin-1 (ECMA-94) with all graphical characters. */
318	#define UDF_CHAR_SET_TYPE_LATIN_1 UINT8_C(0x05)
319	/* there are more defined here, but they are mostly useless, since UDF only uses CS0. */
320
321	/** The CS0 definition used by the UDF specification. */
322	#define UDF_CHAR_SET_OSTA_COMPRESSED_UNICODE UDF_CHAR_SET_TYPE_BY_AGREEMENT
323	/** String to put in the UDFCHARSEPC::abInfo field for UDF CS0. */
324	#define UDF_CHAR_SET_OSTA_COMPRESSED_UNICODE_INFO "OSTA Compressed Unicode"
325	/** @} */
326
327
328	/**
329	* UDF entity identifier (@ecma167{1,7.4,26}, @udf260{2.1.5,20}).
330	*/
331	typedef struct UDFENTITYID
332	{
333	/** 0x00: Flags (UDFENTITYID_FLAGS_XXX). */
334	uint8_t fFlags;
335	/** 0x01: Identifier string (see UDF_ENTITY_ID_XXX). */
336	char achIdentifier[23];
337	/** 0x18: Identifier suffix. */
338	union
339	{
340	/** Domain ID suffix. */
341	struct
342	{
343	uint16_t uUdfRevision;
344	uint8_t fDomain;
345	uint8_t abReserved[5];
346	} Domain;
347
348	/** UDF ID suffix. */
349	struct
350	{
351	uint16_t uUdfRevision;
352	uint8_t bOsClass;
353	uint8_t idOS;
354	uint8_t abReserved[4];
355	} Udf;
356
357
358	/** Implementation ID suffix. */
359	struct
360	{
361	uint8_t bOsClass;
362	uint8_t idOS;
363	uint8_t achImplUse[6];
364	} Implementation;
365
366	/** Application ID suffix / generic. */
367	uint8_t abApplication[8];
368	} Suffix;
369	} UDFENTITYID;
370	AssertCompileSize(UDFENTITYID, 32);
371	/** Pointer to UDF entity identifier. */
372	typedef UDFENTITYID *PUDFENTITYID;
373	/** Pointer to const UDF entity identifier. */
374	typedef UDFENTITYID const *PCUDFENTITYID;
375
376	/** @name UDF_ENTITY_ID_XXX - UDF identifier strings
377	*
378	* See @udf260{2.1.5.2,21}.
379	*
380	* @{ */
381	/** Implementation use volume descriptor, implementation ID field.
382	* UDF ID suffix. */
383	#define UDF_ENTITY_ID_IUVD_IMPLEMENTATION "*UDF LV Info"
384
385	/** Partition descriptor, partition contents field, set to indicate UDF
386	* (ECMA-167 3rd edition). Application ID suffix. */
387	#define UDF_ENTITY_ID_PD_PARTITION_CONTENTS_UDF "+NSR03"
388	/** Partition descriptor, partition contents field, set to indicate ISO-9660
389	* (ECMA-119). Application ID suffix. */
390	#define UDF_ENTITY_ID_PD_PARTITION_CONTENTS_ISO9660 "+CD001"
391	/** Partition descriptor, partition contents field, set to indicate ECMA-168.
392	* Application ID suffix. */
393	#define UDF_ENTITY_ID_PD_PARTITION_CONTENTS_CDW "+CDW02"
394	/** Partition descriptor, partition contents field, set to indicate FAT
395	* (ECMA-107). Application ID suffix. */
396	#define UDF_ENTITY_ID_PD_PARTITION_CONTENTS_FAT "+FDC01"
397
398	/** Logical volume descriptor, domain ID field.
399	* Domain ID suffix. */
400	#define UDF_ENTITY_ID_LVD_DOMAIN "*OSTA UDF Compliant"
401
402	/** File set descriptor, domain ID field.
403	* Domain ID suffix. */
404	#define UDF_ENTITY_FSD_LVD_DOMAIN "*OSTA UDF Compliant"
405
406	/** UDF implementation use extended attribute, implementation ID field, set
407	* to free EA space. UDF ID suffix. */
408	#define UDF_ENTITY_ID_IUEA_FREE_EA_SPACE "*UDF FreeEASpace"
409	/** UDF implementation use extended attribute, implementation ID field, set
410	* to DVD copyright management information. UDF ID suffix. */
411	#define UDF_ENTITY_ID_IUEA_DVD_CGMS_INFO "*UDF DVD CGMS Info"
412	/** UDF implementation use extended attribute, implementation ID field, set
413	* to OS/2 extended attribute length. UDF ID suffix. */
414	#define UDF_ENTITY_ID_IUEA_OS2_EA_LENGTH "*UDF OS/2 EALength"
415	/** UDF implementation use extended attribute, implementation ID field, set
416	* to Machintosh OS volume information. UDF ID suffix. */
417	#define UDF_ENTITY_ID_IUEA_MAC_VOLUME_INFO "*UDF Mac VolumeInfo"
418	/** UDF implementation use extended attribute, implementation ID field, set
419	* to Machintosh Finder Info. UDF ID suffix. */
420	#define UDF_ENTITY_ID_IUEA_MAC_FINDER_INFO "*UDF Mac FinderInfo"
421	/** UDF implementation use extended attribute, implementation ID field, set
422	* to OS/400 extended directory information. UDF ID suffix. */
423	#define UDF_ENTITY_ID_IUEA_OS400_DIR_INFO "*UDF OS/400 DirInfo"
424
425	/** UDF application use extended attribute, application ID field, set
426	* to free application use EA space. UDF ID suffix. */
427	#define UDF_ENTITY_ID_AUEA_FREE_EA_SPACE "*UDF FreeAppEASpace"
428
429	/** Virtual partition map, partition type field.
430	* UDF ID suffix. */
431	#define UDF_ENTITY_ID_VPM_PARTITION_TYPE "*UDF Virtual Partition"
432
433	/** Sparable partition map, partition type field.
434	* UDF ID suffix. */
435	#define UDF_ENTITY_ID_SPM_PARTITION_TYPE "*UDF Sparable Partition"
436
437	/** Metadata partition map, partition type field.
438	* UDF ID suffix. */
439	#define UDF_ENTITY_ID_MPM_PARTITION_TYPE "*UDF Metadata Partition"
440
441	/** Sparing table, sparing identifier field.
442	* UDF ID suffix. */
443	#define UDF_ENTITY_ID_ST_SPARING "*UDF Sparting Table"
444
445	/** @} */
446
447
448	/**
449	* UDF descriptor tag (@ecma167{3,7.2,42}, @udf260{2.2.1,26}).
450	*/
451	typedef struct UDFTAG
452	{
453	/** Tag identifier (UDF_TAG_ID_XXX). */
454	uint16_t idTag;
455	/** Descriptor version. */
456	uint16_t uVersion;
457	/** Tag checksum.
458	* Sum of each byte in the structure with this field as zero. */
459	uint8_t uChecksum;
460	/** Reserved, MBZ. */
461	uint8_t bReserved;
462	/** Tag serial number. */
463	uint16_t uTagSerialNo;
464	/** Descriptor CRC. */
465	uint16_t uDescriptorCrc;
466	/** Descriptor CRC length. */
467	uint16_t cbDescriptorCrc;
468	/** The tag location (logical sector number). */
469	uint32_t offTag;
470	} UDFTAG;
471	AssertCompileSize(UDFTAG, 16);
472	/** Pointer to an UDF descriptor tag. */
473	typedef UDFTAG *PUDFTAG;
474	/** Pointer to a const UDF descriptor tag. */
475	typedef UDFTAG const *PCUDFTAG;
476
477	/** @name UDF_TAG_ID_XXX - UDF descriptor tag IDs.
478	* @{ */
479	#define UDF_TAG_ID_PRIMARY_VOL_DESC UINT16_C(0x0001) /*< See UDFPRIMARYVOLUMEDESC /
480	#define UDF_TAG_ID_ANCHOR_VOLUME_DESC_PTR UINT16_C(0x0002) /*< See UDFANCHORVOLUMEDESCPTR /
481	#define UDF_TAG_ID_VOLUME_DESC_PTR UINT16_C(0x0003) /*< See UDFVOLUMEDESCPTR /
482	#define UDF_TAG_ID_IMPLEMENTATION_USE_VOLUME_DESC UINT16_C(0x0004) /*< See UDFIMPLEMENTATIONUSEVOLUMEDESC /
483	#define UDF_TAG_ID_PARTITION_DESC UINT16_C(0x0005) /*< See UDFPARTITIONDESC /
484	#define UDF_TAG_ID_LOGICAL_VOLUME_DESC UINT16_C(0x0006) /*< See UDFLOGICALVOLUMEDESC /
485	#define UDF_TAG_ID_UNALLOCATED_SPACE_DESC UINT16_C(0x0007) /*< See UDFUNALLOCATEDSPACEDESC /
486	#define UDF_TAG_ID_TERMINATING_DESC UINT16_C(0x0008) /*< See UDFTERMINATINGDESC /
487	#define UDF_TAG_ID_LOGICAL_VOLUME_INTEGRITY_DESC UINT16_C(0x0009) /*< See UDFLOGICALVOLINTEGRITYDESC /
488	#define UDF_TAG_ID_FILE_SET_DESC UINT16_C(0x0100) /*< See UDFFILESETDESC /
489	#define UDF_TAG_ID_FILE_ID_DESC UINT16_C(0x0101) /*< See UDFFILEIDDESC /
490	#define UDF_TAG_ID_ALLOCATION_EXTENT_DESC UINT16_C(0x0102) /*< See UDFALLOCATIONEXTENTDESC /
491	#define UDF_TAG_ID_INDIRECT_ENTRY UINT16_C(0x0103) /*< See UDFINDIRECTENTRY /
492	#define UDF_TAG_ID_TERMINAL_ENTRY UINT16_C(0x0104) /*< See UDFTERMINALENTRY /
493	#define UDF_TAG_ID_FILE_ENTRY UINT16_C(0x0105) /*< See UDFFILEENTRY /
494	#define UDF_TAG_ID_EXTENDED_ATTRIB_HDR_DESC UINT16_C(0x0106) /*< See UDFEXTATTRIBHDRDESC /
495	#define UDF_TAG_ID_UNALLOCATED_SPACE_ENTRY UINT16_C(0x0107) /*< See UDFUNALLOCATEDSPACEENTRY /
496	#define UDF_TAG_ID_SPACE_BITMAP_DESC UINT16_C(0x0108) /*< See UDFSPACEBITMAPDESC /
497	#define UDF_TAG_ID_PARTITION_INTEGERITY_DESC UINT16_C(0x0109) /*< See UDFPARTITIONINTEGRITYDESC /
498	#define UDF_TAG_ID_EXTENDED_FILE_ENTRY UINT16_C(0x010a) /*< See UDFEXFILEENTRY /
499	/** @} */
500
501
502	/**
503	* UDF primary volume descriptor (PVD) (@ecma167{3,10.1,50},
504	* @udf260{2.2.2,27}).
505	*/
506	typedef struct UDFPRIMARYVOLUMEDESC
507	{
508	/** 0x000: The descriptor tag (UDF_TAG_ID_PRIMARY_VOL_DESC). */
509	UDFTAG Tag;
510	/** 0x010: Volume descriptor sequence number. */
511	uint32_t uVolumeDescSeqNo;
512	/** 0x014: Primary volume descriptor number. */
513	uint32_t uPrimaryVolumeDescNo;
514	/** 0x018: Volume identifier (dstring). */
515	UDFDSTRING achVolumeID[32];
516	/** 0x038: Volume sequence number. */
517	uint16_t uVolumeSeqNo;
518	/** 0x03a: Maximum volume sequence number. */
519	uint16_t uMaxVolumeSeqNo;
520	/** 0x03c: Interchange level. */
521	uint16_t uInterchangeLevel;
522	/** 0x03e: Maximum interchange level. */
523	uint16_t uMaxInterchangeLevel;
524	/** 0x040: Character set bitmask (aka list). Each bit correspond to a
525	* character set number. */
526	uint32_t fCharacterSets;
527	/** 0x044: Maximum character set bitmask (aka list). */
528	uint32_t fMaxCharacterSets;
529	/** 0x048: Volume set identifier (dstring). This starts with 16 unique
530	* characters, the first 8 being the hex representation of a time value. */
531	UDFDSTRING achVolumeSetID[128];
532	/** 0x0c8: Descriptor character set.
533	* For achVolumeSetID and achVolumeID. */
534	UDFCHARSPEC DescCharSet;
535	/** 0x108: Explanatory character set.
536	* For VolumeAbstract and VolumeCopyrightNotice data. */
537	UDFCHARSPEC ExplanatoryCharSet;
538	/** 0x148: Volume abstract. */
539	UDFEXTENTAD VolumeAbstract;
540	/** 0x150: Volume copyright notice. */
541	UDFEXTENTAD VolumeCopyrightNotice;
542	/** 0x158: Application identifier ("Application ID"). /
543	UDFENTITYID idApplication;
544	/** 0x178: Recording date and time. */
545	UDFTIMESTAMP RecordingTimestamp;
546	/** 0x184: Implementation identifier ("Developer ID"). /
547	UDFENTITYID idImplementation;
548	/** 0x1a4: Implementation use. */
549	uint8_t abImplementationUse[64];
550	/** 0x1e4: Predecessor volume descriptor sequence location. */
551	uint32_t offPredecessorVolDescSeq;
552	/** 0x1e8: Flags (UDF_PVD_FLAGS_XXX). */
553	uint16_t fFlags;
554	/** 0x1ea: Reserved. */
555	uint8_t abReserved[22];
556	} UDFPRIMARYVOLUMEDESC;
557	AssertCompileSize(UDFPRIMARYVOLUMEDESC, 512);
558	/** Pointer to a UDF primary volume descriptor. */
559	typedef UDFPRIMARYVOLUMEDESC *PUDFPRIMARYVOLUMEDESC;
560	/** Pointer to a const UDF primary volume descriptor. */
561	typedef UDFPRIMARYVOLUMEDESC const *PCUDFPRIMARYVOLUMEDESC;
562
563	/** @name UDF_PVD_FLAGS_XXX - Flags for UDFPRIMARYVOLUMEDESC::fFlags.
564	* @{ */
565	/** Indicates that the volume set ID is common to all members of the set. */
566	#define UDF_PVD_FLAGS_COMMON_VOLUME_SET_ID UINT16_C(0x0001)
567	/** @} */
568
569
570	/**
571	* UDF anchor volume descriptor pointer (AVDP) (@ecma167{3,10.2,53},
572	* @udf260{2.2.3,29}).
573	*
574	* This is stored at least two of these locations:
575	* - logical sector 256
576	* - logical sector N - 256.
577	* - logical sector N.
578	*/
579	typedef struct UDFANCHORVOLUMEDESCPTR
580	{
581	/** 0x00: The descriptor tag (UDF_TAG_ID_ANCHOR_VOLUME_DESC_PTR). */
582	UDFTAG Tag;
583	/** 0x10: The extent describing the main volume descriptor sequence. */
584	UDFEXTENTAD MainVolumeDescSeq;
585	/** 0x18: Location of the backup descriptor sequence. */
586	UDFEXTENTAD ReserveVolumeDescSeq;
587	/** 0x20: Reserved, probably must be zeros. */
588	uint8_t abReserved[0x1e0];
589	} UDFANCHORVOLUMEDESCPTR;
590	AssertCompileSize(UDFANCHORVOLUMEDESCPTR, 512);
591	/** Pointer to UDF anchor volume descriptor pointer. */
592	typedef UDFANCHORVOLUMEDESCPTR *PUDFANCHORVOLUMEDESCPTR;
593	/** Pointer to const UDF anchor volume descriptor pointer. */
594	typedef UDFANCHORVOLUMEDESCPTR const *PCUDFANCHORVOLUMEDESCPTR;
595
596
597	/**
598	* UDF volume descriptor pointer (VDP) (@ecma167{3,10.3,53}).
599	*/
600	typedef struct UDFVOLUMEDESCPTR
601	{
602	/** 0x00: The descriptor tag (UDF_TAG_ID_VOLUME_DESC_PTR). */
603	UDFTAG Tag;
604	/** 0x10: Volume descriptor sequence number. */
605	uint32_t uVolumeDescSeqNo;
606	/** 0x14: Location of the next volume descriptor sequence. */
607	UDFEXTENTAD NextVolumeDescSeq;
608	/** 0x1c: Reserved, probably must be zeros. */
609	uint8_t abReserved[484];
610	} UDFVOLUMEDESCPTR;
611	AssertCompileSize(UDFVOLUMEDESCPTR, 512);
612	/** Pointer to UDF volume descriptor pointer. */
613	typedef UDFVOLUMEDESCPTR *PUDFVOLUMEDESCPTR;
614	/** Pointer to const UDF volume descriptor pointer. */
615	typedef UDFVOLUMEDESCPTR const *PCUDFVOLUMEDESCPTR;
616
617
618	/**
619	* UDF implementation use volume descriptor (IUVD) (@ecma167{3,10.4,55},
620	* @udf260{2.2.7,35}).
621	*/
622	typedef struct UDFIMPLEMENTATIONUSEVOLUMEDESC
623	{
624	/** 0x00: The descriptor tag (UDF_TAG_ID_IMPLEMENTATION_USE_VOLUME_DESC). */
625	UDFTAG Tag;
626	/** 0x10: Volume descriptor sequence number. */
627	uint32_t uVolumeDescSeqNo;
628	/** 0x14: The implementation identifier (UDF_ENTITY_ID_IUVD_IMPLEMENTATION). */
629	UDFENTITYID idImplementation;
630	/** 0x34: The implementation use area. */
631	union
632	{
633	/** Generic view. */
634	uint8_t ab[460];
635	/** Logical volume information (@udf260{2.2.7.2,35}). */
636	struct
637	{
638	/** 0x034: The character set used in this sub-structure. */
639	UDFCHARSPEC Charset;
640	/** 0x074: Logical volume identifier. */
641	UDFDSTRING achVolumeID[128];
642	/** 0x0f4: Info string \#1. */
643	UDFDSTRING achInfo1[36];
644	/** 0x118: Info string \#2. */
645	UDFDSTRING achInfo2[36];
646	/** 0x13c: Info string \#3. */
647	UDFDSTRING achInfo3[36];
648	/** 0x160: The implementation identifier ("Developer ID"). /
649	UDFENTITYID idImplementation;
650	/** 0x180: Additional use bytes. */
651	uint8_t abUse[128];
652	} Lvi;
653	} ImplementationUse;
654	} UDFIMPLEMENTATIONUSEVOLUMEDESC;
655	AssertCompileSize(UDFIMPLEMENTATIONUSEVOLUMEDESC, 512);
656	AssertCompileMemberOffset(UDFIMPLEMENTATIONUSEVOLUMEDESC, ImplementationUse.Lvi.Charset, 0x034);
657	AssertCompileMemberOffset(UDFIMPLEMENTATIONUSEVOLUMEDESC, ImplementationUse.Lvi.achVolumeID, 0x074);
658	AssertCompileMemberOffset(UDFIMPLEMENTATIONUSEVOLUMEDESC, ImplementationUse.Lvi.achInfo1, 0x0f4);
659	AssertCompileMemberOffset(UDFIMPLEMENTATIONUSEVOLUMEDESC, ImplementationUse.Lvi.achInfo2, 0x118);
660	AssertCompileMemberOffset(UDFIMPLEMENTATIONUSEVOLUMEDESC, ImplementationUse.Lvi.achInfo3, 0x13c);
661	AssertCompileMemberOffset(UDFIMPLEMENTATIONUSEVOLUMEDESC, ImplementationUse.Lvi.idImplementation, 0x160);
662	/** Pointer to an UDF implementation use volume descriptor. */
663	typedef UDFIMPLEMENTATIONUSEVOLUMEDESC *PUDFIMPLEMENTATIONUSEVOLUMEDESC;
664	/** Pointer to a const UDF implementation use volume descriptor. */
665	typedef UDFIMPLEMENTATIONUSEVOLUMEDESC const *PCUDFIMPLEMENTATIONUSEVOLUMEDESC;
666
667
668	/**
669	* UDF partition header descriptor (@ecma167{4,14.3,90}, @udf260{2.3.3,56}).
670	*
671	* This is found in UDFPARTITIONDESC::ContentsUse.
672	*/
673	typedef struct UDFPARTITIONHDRDESC
674	{
675	/** 0x00: Unallocated space table location. Zero length means no table. */
676	UDFSHORTAD UnallocatedSpaceTable;
677	/** 0x08: Unallocated space bitmap location. Zero length means no bitmap. */
678	UDFSHORTAD UnallocatedSpaceBitmap;
679	/** 0x10: Partition integrity table location. Zero length means no table. */
680	UDFSHORTAD PartitionIntegrityTable;
681	/** 0x18: Freed space table location. Zero length means no table. */
682	UDFSHORTAD FreedSpaceTable;
683	/** 0x20: Freed space bitmap location. Zero length means no bitmap. */
684	UDFSHORTAD FreedSpaceBitmap;
685	/** 0x28: Reserved, MBZ. */
686	uint8_t abReserved[88];
687	} UDFPARTITIONHDRDESC;
688	AssertCompileSize(UDFPARTITIONHDRDESC, 128);
689	AssertCompileMemberOffset(UDFPARTITIONHDRDESC, PartitionIntegrityTable, 0x10);
690	AssertCompileMemberOffset(UDFPARTITIONHDRDESC, abReserved, 0x28);
691	/** Pointer to an UDF partition header descriptor. */
692	typedef UDFPARTITIONHDRDESC *PUDFPARTITIONHDRDESC;
693	/** Pointer to a const UDF partition header descriptor. */
694	typedef UDFPARTITIONHDRDESC const *PCUDFPARTITIONHDRDESC;
695
696
697	/**
698	* UDF partition descriptor (PD) (@ecma167{3,10.5,55}, @udf260{2.2.14,51}).
699	*/
700	typedef struct UDFPARTITIONDESC
701	{
702	/** 0x000: The descriptor tag (UDF_TAG_ID_PARTITION_DESC). */
703	UDFTAG Tag;
704	/** 0x010: Volume descriptor sequence number. */
705	uint32_t uVolumeDescSeqNo;
706	/** 0x014: The partition flags (UDF_PARTITION_FLAGS_XXX). */
707	uint16_t fFlags;
708	/** 0x016: The partition number. */
709	uint16_t uPartitionNo;
710	/** 0x018: Partition contents (UDF_ENTITY_ID_PD_PARTITION_CONTENTS_XXX). */
711	UDFENTITYID PartitionContents;
712	/** 0x038: partition contents use (depends on the PartitionContents field). */
713	union
714	{
715	/** Generic view. */
716	uint8_t ab[128];
717	/** UDF partition header descriptor (UDF_ENTITY_ID_PD_PARTITION_CONTENTS_UDF). */
718	UDFPARTITIONHDRDESC Hdr;
719	} ContentsUse;
720	/** 0x0b8: Access type (UDF_PART_ACCESS_TYPE_XXX). */
721	uint32_t uAccessType;
722	/** 0x0bc: Partition starting location (logical sector number). */
723	uint32_t offLocation;
724	/** 0x0c0: Partition length in sectors. */
725	uint32_t cSectors;
726	/** 0x0c4: Implementation identifier ("Developer ID"). /
727	UDFENTITYID idImplementation;
728	/** 0x0e4: Implementation use bytes. */
729	union
730	{
731	/** Generic view. */
732	uint8_t ab[128];
733	} ImplementationUse;
734	/** 0x164: Reserved. */
735	uint8_t abReserved[156];
736	} UDFPARTITIONDESC;
737	AssertCompileSize(UDFPARTITIONDESC, 512);
738	/** Pointer to an UDF partitions descriptor. */
739	typedef UDFPARTITIONDESC *PUDFPARTITIONDESC;
740	/** Pointer to a const UDF partitions descriptor. */
741	typedef const UDFPARTITIONDESC *PCUDFPARTITIONDESC;
742
743	/** @name UDF_PART_ACCESS_TYPE_XXX - UDF partition access types
744	*
745	* See @ecma167{3,10.5.7,57}, @udf260{2.2.14.2,51}.
746	*
747	* @{ */
748	/** Access not specified by this field. */
749	#define UDF_PART_ACCESS_TYPE_NOT_SPECIFIED UINT32_C(0x00000000)
750	/** Read only: No writes. */
751	#define UDF_PART_ACCESS_TYPE_READ_ONLY UINT32_C(0x00000001)
752	/** Write once: Sectors can only be written once. */
753	#define UDF_PART_ACCESS_TYPE_WRITE_ONCE UINT32_C(0x00000002)
754	/** Rewritable: Logical sectors may require preprocessing before writing. */
755	#define UDF_PART_ACCESS_TYPE_REWRITABLE UINT32_C(0x00000003)
756	/** Overwritable: No restrictions on writing. */
757	#define UDF_PART_ACCESS_TYPE_OVERWRITABLE UINT32_C(0x00000004)
758	/** @} */
759
760
761	/**
762	* Logical volume descriptor (LVD) (@ecma167{3,10.6,58}, @udf260{2.2.4,30}).
763	*
764	* @note Variable length.
765	*/
766	typedef struct UDFLOGICALVOLUMEDESC
767	{
768	/** 0x000: The descriptor tag (UDF_TAG_ID_LOGICAL_VOLUME_DESC). */
769	UDFTAG Tag;
770	/** 0x010: Volume descriptor sequence number. */
771	uint32_t uVolumeDescSeqNo;
772	/** 0x014: Character set used in the achLogicalVolumeID field. */
773	UDFCHARSPEC DescCharSet;
774	/** 0x054: The logical volume ID (label). */
775	UDFDSTRING achLogicalVolumeID[128];
776	/** 0x0d4: Logical block size (in bytes). */
777	uint32_t cbLogicalBlock;
778	/** 0x0d8: Domain identifier (UDF_ENTITY_ID_LVD_DOMAIN). */
779	UDFENTITYID idDomain;
780	/** 0x0f8: Logical volume contents use. */
781	union
782	{
783	/** Byte view. */
784	uint8_t ab[16];
785	/** The extent containing the file set descriptor. */
786	UDFLONGAD FileSetDescriptor;
787	} ContentsUse;
788	/** 0x108: Map table length (in bytes). */
789	uint32_t cbMapTable;
790	/** 0x10c: Number of partition maps. */
791	uint32_t cPartitionMaps;
792	/** 0x110: Implementation identifier ("Developer ID"). /
793	UDFENTITYID idImplementation;
794	/** 0x130: Implementation use. */
795	union
796	{
797	/** Byte view. */
798	uint8_t ab[128];
799	} ImplementationUse;
800	/** 0x1b0: Integrity sequence extent. Can be zero if cPartitionMaps is zero. */
801	UDFEXTENTAD IntegritySeqExtent;
802	/** 0x1b8: Partition maps (length given by @a cbMapTable), data format is
803	* defined by UDFPARTMAPHDR, UDFPARTMAPTYPE1 and UDFPARTMAPTYPE2. */
804	RT_FLEXIBLE_ARRAY_EXTENSION
805	uint8_t abPartitionMaps[RT_FLEXIBLE_ARRAY];
806	} UDFLOGICALVOLUMEDESC;
807	AssertCompileMemberOffset(UDFLOGICALVOLUMEDESC, abPartitionMaps, 0x1b8);
808	/** Pointer to an UDF logical volume descriptor. */
809	typedef UDFLOGICALVOLUMEDESC *PUDFLOGICALVOLUMEDESC;
810	/** Pointer to a const UDF logical volume descriptor. */
811	typedef UDFLOGICALVOLUMEDESC const *PCUDFLOGICALVOLUMEDESC;
812
813	/**
814	* Partition map header (UDFLOGICALVOLUMEDESC::abPartitionMaps).
815	*/
816	typedef struct UDFPARTMAPHDR
817	{
818	/** 0x00: The partition map type. */
819	uint8_t bType;
820	/** 0x01: The partition map length (header included). */
821	uint8_t cb;
822	} UDFPARTMAPHDR;
823	AssertCompileSize(UDFPARTMAPHDR, 2);
824	/** Pointer to a partition map header. */
825	typedef UDFPARTMAPHDR *PUDFPARTMAPHDR;
826	/** Pointer to a const partition map header. */
827	typedef UDFPARTMAPHDR const *PCUDFPARTMAPHDR;
828
829	/**
830	* Partition map type 1 (UDFLOGICALVOLUMEDESC::abPartitionMaps).
831	*/
832	typedef struct UDFPARTMAPTYPE1
833	{
834	/** 0x00: Header (uType=1, cb=6). */
835	UDFPARTMAPHDR Hdr;
836	/** 0x02: Volume sequence number. */
837	uint16_t uVolumeSeqNo;
838	/** 0x04: Partition number. */
839	uint16_t uPartitionNo;
840	} UDFPARTMAPTYPE1;
841	AssertCompileSize(UDFPARTMAPTYPE1, 6);
842	/** Pointer to a type 1 partition map. */
843	typedef UDFPARTMAPTYPE1 *PUDFPARTMAPTYPE1;
844	/** Pointer to a const type 1 partition map. */
845	typedef UDFPARTMAPTYPE1 const *PCUDFPARTMAPTYPE1;
846
847	/**
848	* Partition map type 2 (UDFLOGICALVOLUMEDESC::abPartitionMaps).
849	*/
850	typedef struct UDFPARTMAPTYPE2
851	{
852	/** 0x00: Header (uType=2, cb=64). */
853	UDFPARTMAPHDR Hdr;
854	/** 0x02: Reserved \#1. */
855	uint16_t uReserved1;
856	/** 0x04: Partition ID type (UDF_ENTITY_ID_VPM_PARTITION_TYPE,
857	* UDF_ENTITY_ID_SPM_PARTITION_TYPE, or UDF_ENTITY_ID_MPM_PARTITION_TYPE). */
858	UDFENTITYID idPartitionType;
859	/** 0x24: Volume sequence number. */
860	uint16_t uVolumeSeqNo;
861	/** 0x26: Partition number. */
862	uint16_t uPartitionNo;
863	/** 0x28: Data specific to the partition ID type. */
864	union
865	{
866	/** 0x28: Generic view. */
867	uint8_t ab[24];
868
869	/** UDF_ENTITY_ID_VPM_PARTITION_TYPE. */
870	struct
871	{
872	/** 0x28: Reserved. */
873	uint8_t abReserved2[24];
874	} Vpm;
875
876	/** UDF_ENTITY_ID_SPM_PARTITION_TYPE. */
877	struct
878	{
879	/** 0x28: Packet length in blocks. */
880	uint16_t cBlocksPerPacket;
881	/** 0x2a: Number of sparing tables. */
882	uint8_t cSparingTables;
883	/** 0x2b: Reserved padding byte. */
884	uint8_t bReserved2;
885	/** 0x2c: The size of each sparing table. */
886	uint32_t cbSparingTable;
887	/** 0x30: The sparing table locations (logical block). */
888	uint32_t aoffSparingTables[4];
889	} Spm;
890
891	/** UDF_ENTITY_ID_MPM_PARTITION_TYPE. */
892	struct
893	{
894	/** 0x28: Metadata file entry location (logical block). */
895	uint32_t offMetadataFile;
896	/** 0x2c: Metadata mirror file entry location (logical block). */
897	uint32_t offMetadataMirrorFile;
898	/** 0x30: Metadata bitmap file entry location (logical block). */
899	uint32_t offMetadataBitmapFile;
900	/** 0x34: The metadata allocation unit (logical blocks) */
901	uint32_t cBlocksAllocationUnit;
902	/** 0x38: The metadata allocation unit alignment (logical blocks). */
903	uint16_t cBlocksAlignmentUnit;
904	/** 0x3a: Flags, UDFPARTMAPMETADATA_F_XXX. */
905	uint8_t fFlags;
906	/** 0x3b: Reserved. */
907	uint8_t abReserved2[5];
908	} Mpm;
909	} u;
910	} UDFPARTMAPTYPE2;
911	AssertCompileSize(UDFPARTMAPTYPE2, 64);
912	/** Pointer to a type 2 partition map. */
913	typedef UDFPARTMAPTYPE2 *PUDFPARTMAPTYPE2;
914	/** Pointer to a const type 2 partition map. */
915	typedef UDFPARTMAPTYPE2 const *PCUDFPARTMAPTYPE2;
916
917	/** @name UDFPARTMAPMETADATA_F_XXX
918	* @{ */
919	/** Indicates that the metadata is mirrored too, not just the file entry. */
920	#define UDFPARTMAPMETADATA_F_DATA_MIRRORED UINT8_C(1)
921	/** @} */
922
923
924	/**
925	* UDF unallocated space descriptor (USD) (@ecma167{3,10.8,61}, @udf260{2.2.5,32}).
926	*
927	* @note Variable length.
928	*/
929	typedef struct UDFUNALLOCATEDSPACEDESC
930	{
931	/** 0x00: The descriptor tag (UDF_TAG_ID_UNALLOCATED_SPACE_DESC). */
932	UDFTAG Tag;
933	/** 0x10: Volume descriptor sequence number. */
934	uint32_t uVolumeDescSeqNo;
935	/** 0x14: Number of allocation descriptors in the array below. */
936	uint32_t cAllocationDescriptors;
937	/** 0x18: Allocation descriptors (variable length). */
938	RT_FLEXIBLE_ARRAY_EXTENSION
939	UDFEXTENTAD aAllocationDescriptors[RT_FLEXIBLE_ARRAY];
940	} UDFUNALLOCATEDSPACEDESC;
941	AssertCompileMemberOffset(UDFUNALLOCATEDSPACEDESC, aAllocationDescriptors, 0x18);
942	/** Pointer to an UDF unallocated space descriptor. */
943	typedef UDFUNALLOCATEDSPACEDESC *PUDFUNALLOCATEDSPACEDESC;
944	/** Pointer to a const UDF unallocated space descriptor. */
945	typedef UDFUNALLOCATEDSPACEDESC const *PCUDFUNALLOCATEDSPACEDESC;
946
947
948	/**
949	* UDF terminating descriptor (@ecma167{3,10.9,62}, @ecma167{4,14.2,62}).
950	*/
951	typedef struct UDFTERMINATINGDESC
952	{
953	/** 0x00: The descriptor tag (UDF_TAG_ID_TERMINATING_DESC). */
954	UDFTAG Tag;
955	/** 0x10: Reserved, MBZ. */
956	uint8_t abReserved[496];
957	} UDFTERMINATINGDESC;
958	/** Pointer to an UDF terminating descriptor. */
959	typedef UDFTERMINATINGDESC *PUDFTERMINATINGDESC;
960	/** Pointer to a const UDF terminating descriptor. */
961	typedef UDFTERMINATINGDESC const *PCUDFTERMINATINGDESC;
962
963
964	/**
965	* UDF logical volume integrity descriptor (LVID) (@ecma167{3,10.10,62},
966	* @udf260{2.2.6,32}).
967	*/
968	typedef struct UDFLOGICALVOLINTEGRITYDESC
969	{
970	/** 0x00: The descriptor tag (UDF_TAG_ID_LOGICAL_VOLUME_INTEGRITY_DESC). */
971	UDFTAG Tag;
972	/** 0x10: Recording timestamp. */
973	UDFTIMESTAMP RecordingTimestamp;
974	/** 0x1c: Integrity type (UDF_LVID_TYPE_XXX). */
975	uint32_t uIntegrityType;
976	/** 0x20: The next integrity extent. */
977	UDFEXTENTAD NextIntegrityExtent;
978	/** 0x28: Number of partitions. */
979	uint32_t cPartitions;
980	/** 0x2c: Length of implementation use. */
981	uint32_t cbImplementationUse;
982	/**
983	* There are two tables each @a cPartitions in size. The first is the free
984	* space table. The second the size table.
985	*
986	* Following these tables there are @a cbImplementationUse bytes of space for
987	* the implementation to use.
988	*/
989	RT_FLEXIBLE_ARRAY_EXTENSION
990	uint32_t aTables[RT_FLEXIBLE_ARRAY];
991	} UDFLOGICALVOLINTEGRITYDESC;
992	AssertCompileMemberOffset(UDFLOGICALVOLINTEGRITYDESC, cbImplementationUse, 0x2c);
993	AssertCompileMemberOffset(UDFLOGICALVOLINTEGRITYDESC, aTables, 0x30);
994	/** Pointer to an UDF logical volume integrity descriptor. */
995	typedef UDFLOGICALVOLINTEGRITYDESC *PUDFLOGICALVOLINTEGRITYDESC;
996	/** Pointer to a const UDF logical volume integrity descriptor. */
997	typedef UDFLOGICALVOLINTEGRITYDESC const *PCUDFLOGICALVOLINTEGRITYDESC;
998
999	/** @name UDF_LVID_TYPE_XXX - Integirty types.
1000	* @{ */
1001	#define UDF_LVID_TYPE_OPEN UINT32_C(0x00000000)
1002	#define UDF_LVID_TYPE_CLOSE UINT32_C(0x00000001)
1003	/** @} */
1004
1005	/**
1006	* UDF file set descriptor (FSD) (@ecma167{4,14.1,86}, @udf260{2.3.2,54}).
1007	*/
1008	typedef struct UDFFILESETDESC
1009	{
1010	/** 0x000: The descriptor tag (UDF_TAG_ID_FILE_SET_DESC). */
1011	UDFTAG Tag;
1012	/** 0x010: Recording timestamp. */
1013	UDFTIMESTAMP RecordingTimestamp;
1014	/** 0x01c: Interchange level. */
1015	uint16_t uInterchangeLevel;
1016	/** 0x01e: Maximum interchange level. */
1017	uint16_t uMaxInterchangeLevel;
1018	/** 0x020: Character set bitmask (aka list). Each bit correspond to a
1019	* character set number. */
1020	uint32_t fCharacterSets;
1021	/** 0x024: Maximum character set bitmask (aka list). */
1022	uint32_t fMaxCharacterSets;
1023	/** 0x028: File set number. */
1024	uint32_t uFileSetNo;
1025	/** 0x02c: File set descriptor number. */
1026	uint32_t uFileSetDescNo;
1027	/** 0x030: Logical volume identifier character set. */
1028	UDFCHARSPEC LogicalVolumeIDCharSet;
1029	/** 0x070: Logical volume identifier string. */
1030	UDFDSTRING achLogicalVolumeID[128];
1031	/** 0x0e0: File set character set. */
1032	UDFCHARSPEC FileSetCharSet;
1033	/** 0x130: Identifier string for this file set. */
1034	UDFDSTRING achFileSetID[32];
1035	/** 0x150: Names a root file containing copyright info. Optional. */
1036	UDFDSTRING achCopyrightFile[32];
1037	/** 0x170: Names a root file containing an abstract for the file set. Optional. */
1038	UDFDSTRING achAbstractFile[32];
1039	/** 0x190: Root directory information control block location (ICB).
1040	* An ICB is a sequence made up of UDF_TAG_ID_FILE_ENTRY,
1041	* UDF_TAG_ID_INDIRECT_ENTRY, and UDF_TAG_ID_TERMINAL_ENTRY descriptors. */
1042	UDFLONGAD RootDirIcb;
1043	/** 0x1a0: Domain identifier (UDF_ENTITY_FSD_LVD_DOMAIN). Optional. */
1044	UDFENTITYID idDomain;
1045	/** 0x1c0: Next location with file set descriptors location, 0 if none. */
1046	UDFLONGAD NextExtent;
1047	/** 0x1d0: Location of the system stream directory associated with the
1048	* file set. Optional. */
1049	UDFLONGAD SystemStreamDirIcb;
1050	/** 0x1e0: Reserved, MBZ. */
1051	uint8_t abReserved[32];
1052	} UDFFILESETDESC;
1053	AssertCompileSize(UDFFILESETDESC, 512);
1054	/** Pointer to an UDF file set descriptor. */
1055	typedef UDFFILESETDESC *PUDFFILESETDESC;
1056	/** Pointer to a const UDF file set descriptor. */
1057	typedef UDFFILESETDESC const *PCUDFFILESETDESC;
1058
1059
1060	/**
1061	* UDF file identifier descriptor (FID) (@ecma167{4,14.4,91}, @udf260{2.3.4,57}).
1062	*/
1063	typedef struct UDFFILEIDDESC
1064	{
1065	/** 0x00: The descriptor tag (UDF_TAG_ID_FILE_ID_DESC). */
1066	UDFTAG Tag;
1067	/** 0x10: File version number (1..32767). Always set to 1. */
1068	uint16_t uVersion;
1069	/** 0x12: File characteristics (UDF_FILE_FLAGS_XXX). */
1070	uint8_t fFlags;
1071	/** 0x13: File identifier (name) length. */
1072	uint8_t cbName;
1073	/** 0x14: Location of an information control block describing the file.
1074	* Can be null if marked deleted. The implementation defined part of
1075	* this contains additional flags and a unique ID. */
1076	UDFLONGAD Icb;
1077	/** 0x24: Length of implementation use field (in bytes). This can be zero.
1078	*
1079	* It can be used to prevent the following FID from spanning a block
1080	* boundrary, in which case it will be 32 bytes or more, and the it will
1081	* start with an UDFENTITYID identifying who last wrote it.
1082	*
1083	* The latter padding fun is a requirement from write-once media. */
1084	uint16_t cbImplementationUse;
1085	/** 0x26: Two variable sized fields followed by padding to make the
1086	* actual structure size 4 byte aligned. The first field in an
1087	* implementation use field with length given by @a cbImplementationUse.
1088	* After that is a d-string field with the name of the file, length
1089	* specified by @a cbName. */
1090	RT_FLEXIBLE_ARRAY_EXTENSION
1091	uint8_t abImplementationUse[RT_FLEXIBLE_ARRAY];
1092	} UDFFILEIDDESC;
1093	AssertCompileMemberOffset(UDFFILEIDDESC, fFlags, 0x12);
1094	AssertCompileMemberOffset(UDFFILEIDDESC, cbName, 0x13);
1095	AssertCompileMemberOffset(UDFFILEIDDESC, Icb, 0x14);
1096	AssertCompileMemberOffset(UDFFILEIDDESC, abImplementationUse, 0x26);
1097	/** Pointer to an UDF file set descriptor */
1098	typedef UDFFILEIDDESC *PUDFFILEIDDESC;
1099	/** Pointer to a const UDF file set descriptor */
1100	typedef UDFFILEIDDESC const *PCUDFFILEIDDESC;
1101
1102	/** Get the pointer to the name field. */
1103	#define UDFFILEIDDESC_2_NAME(a_pFid) ((uint8_t const *)(&(a_pFid)->abImplementationUse[(a_pFid)->cbImplementationUse]))
1104	/** Calculates the total size the size of a record. */
1105	#define UDFFILEIDDESC_CALC_SIZE_EX(cbImplementationUse, cbName) \
1106	RT_ALIGN_32((uint32_t)RT_UOFFSETOF(UDFFILEIDDESC, abImplementationUse) + cbImplementationUse + cbName, 4)
1107	/** Gets the actual size of a record. */
1108	#define UDFFILEIDDESC_GET_SIZE(a_pFid) UDFFILEIDDESC_CALC_SIZE_EX((a_pFid)->cbImplementationUse, (a_pFid)->cbName)
1109
1110	/** @name UDF_FILE_FLAGS_XXX
1111	* @{ */
1112	/** Existence - Hide the file from the user. */
1113	#define UDF_FILE_FLAGS_HIDDEN UINT8_C(0x01)
1114	/** Directory - Indicates a directory as apposed to some kind of file or symlink or something (0). */
1115	#define UDF_FILE_FLAGS_DIRECTORY UINT8_C(0x02)
1116	/** Deleted - Indicate that the file has been deleted. Assoicated descriptors may still be valid, though. */
1117	#define UDF_FILE_FLAGS_DELETED UINT8_C(0x04)
1118	/** Parent - Indicate the ICB field refers to the parent directory (or maybe
1119	* a file in case of streaming directory). */
1120	#define UDF_FILE_FLAGS_PARENT UINT8_C(0x08)
1121	/** Metadata - Zero means user data, one means implementation specific metadata.
1122	* Only allowed used in stream directory. */
1123	#define UDF_FILE_FLAGS_METADATA UINT8_C(0x10)
1124	/** Reserved bits that should be zer. */
1125	#define UDF_FILE_FLAGS_RESERVED_MASK UINT8_C(0xe0)
1126	/** @} */
1127
1128
1129	/**
1130	* UDF allocation extent descriptor (@ecma167{4,14.5,93}, @udf260{2.3.11,67}).
1131	*/
1132	typedef struct UDFALLOCATIONEXTENTDESC
1133	{
1134	/** 0x00: The descriptor tag (UDF_TAG_ID_ALLOCATION_EXTENT_DESC). */
1135	UDFTAG Tag;
1136	/** 0x10: Previous allocation extent location (logical block in current
1137	* partition). */
1138	uint32_t offPrevExtent;
1139	/** 0x14: Size of the following allocation descriptors (in bytes). */
1140	uint32_t cbAllocDescs;
1141	/** 0x18: Allocation descriptors. */
1142	union
1143	{
1144	UDFSHORTAD aShortADs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1145	UDFLONGAD aLongADs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1146	UDFEXTAD aExtADs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1147	} u;
1148	} UDFALLOCATIONEXTENTDESC;
1149	AssertCompileMemberOffset(UDFALLOCATIONEXTENTDESC, u, 0x18);
1150	/** Pointer to an UDF allocation extent descriptor. */
1151	typedef UDFALLOCATIONEXTENTDESC *PUDFALLOCATIONEXTENTDESC;
1152	/** Pointer to a const UDF allocation extent descriptor. */
1153	typedef UDFALLOCATIONEXTENTDESC const *PCUDFALLOCATIONEXTENTDESC;
1154
1155	/**
1156	* UDF information control block tag (@ecma167{4,14.6,93}, @udf260{2.3.5,60}).
1157	*/
1158	typedef struct UDFICBTAG
1159	{
1160	/** 0x00: Number of direct entries in this ICB prior to this one. */
1161	uint32_t cEntiresBeforeThis;
1162	/** 0x04: ICB hierarchy building strategy type (UDF_ICB_STRATEGY_TYPE_XXX). */
1163	uint16_t uStrategyType;
1164	/** 0x06: Type specific parameters. */
1165	uint8_t abStrategyParams[2];
1166	/** 0x08: Max number of direct and indirect entries that MAY be recorded in this ICB. */
1167	uint16_t cMaxEntries;
1168	/** 0x0a: Reserved, MBZ. */
1169	uint8_t bReserved;
1170	/** 0x0b: File type (UDF_FILE_TYPE_XXX). */
1171	uint8_t bFileType;
1172	/** 0x0c: Parent ICB location. */
1173	UDFLBADDR ParentIcb;
1174	/** 0x12: Parent ICB location (UDF_ICB_FLAGS_XXX). */
1175	uint16_t fFlags;
1176	} UDFICBTAG;
1177	AssertCompileSize(UDFICBTAG, 20);
1178	typedef UDFICBTAG *PUDFICBTAG;
1179	typedef UDFICBTAG const *PCUDFICBTAG;
1180
1181	/** @name UDF_ICB_STRATEGY_TYPE_XXX - ICB hierarchy building strategies
1182	*
1183	* See @ecma167{4,14.6.2,94}, @udf260{6.6,121}
1184	*
1185	* @{ */
1186	/** Strategy not specified. */
1187	#define UDF_ICB_STRATEGY_TYPE_NOT_SPECIFIED UINT16_C(0x0000)
1188	/** See @ecma167{4,A.2,129}. */
1189	#define UDF_ICB_STRATEGY_TYPE_1 UINT16_C(0x0001)
1190	/** See @ecma167{4,A.3,131}. */
1191	#define UDF_ICB_STRATEGY_TYPE_2 UINT16_C(0x0002)
1192	/** See @ecma167{4,A.4,131}. */
1193	#define UDF_ICB_STRATEGY_TYPE_3 UINT16_C(0x0003)
1194	/** See @ecma167{4,A.5,131}. */
1195	#define UDF_ICB_STRATEGY_TYPE_4 UINT16_C(0x0004)
1196	/** Defined by the UDF spec, see @udf260{6.6,121}. */
1197	#define UDF_ICB_STRATEGY_TYPE_4096 UINT16_C(0x1000)
1198	/** @} */
1199
1200	/** @name UDF_ICB_FLAGS_XXX - ICB flags
1201	*
1202	* See @ecma167{4,14.6.8,95}, @udf260{2.3.5.4,61}
1203	*
1204	* @{ */
1205	/** Using UDFSHORTAD. */
1206	#define UDF_ICB_FLAGS_AD_TYPE_SHORT UINT16_C(0x0000)
1207	/** Using UDFLONGAD. */
1208	#define UDF_ICB_FLAGS_AD_TYPE_LONG UINT16_C(0x0001)
1209	/** Using UDFEXTAD. */
1210	#define UDF_ICB_FLAGS_AD_TYPE_EXTENDED UINT16_C(0x0002)
1211	/** File content is embedded in the allocation descriptor area. */
1212	#define UDF_ICB_FLAGS_AD_TYPE_EMBEDDED UINT16_C(0x0003)
1213	/** Allocation type mask. */
1214	#define UDF_ICB_FLAGS_AD_TYPE_MASK UINT16_C(0x0007)
1215	/** Set on directories that are sorted (according to @ecma167{4,8.6.1,78}).
1216	* @note Directories are never sorted in UDF. */
1217	#define UDF_ICB_FLAGS_SORTED_DIRECTORY UINT16_C(0x0008)
1218	/** Not relocatable. */
1219	#define UDF_ICB_FLAGS_NON_RELOCATABLE UINT16_C(0x0010)
1220	/** Indicate that the file needs backing up (DOS attribute). */
1221	#define UDF_ICB_FLAGS_ARCHIVE UINT16_C(0x0020)
1222	/** Set UID bit (UNIX). */
1223	#define UDF_ICB_FLAGS_SET_UID UINT16_C(0x0040)
1224	/** Set GID bit (UNIX). */
1225	#define UDF_ICB_FLAGS_SET_GID UINT16_C(0x0080)
1226	/** Set sticky bit (UNIX). */
1227	#define UDF_ICB_FLAGS_STICKY UINT16_C(0x0100)
1228	/** Extents are contiguous. */
1229	#define UDF_ICB_FLAGS_CONTIGUOUS UINT16_C(0x0200)
1230	/** System bit, reserved for implementation use. */
1231	#define UDF_ICB_FLAGS_SYSTEM UINT16_C(0x0400)
1232	/** Data has been transformed in some way.
1233	* @note UDF shall not set this bit. */
1234	#define UDF_ICB_FLAGS_TRANSFORMED UINT16_C(0x0800)
1235	/** Directory may contain multi-versioned files.
1236	* @note UDF shall not set this bit. */
1237	#define UDF_ICB_FLAGS_MULTI_VERSIONS UINT16_C(0x1000)
1238	/** Is a stream in a stream directory. */
1239	#define UDF_ICB_FLAGS_STREAM UINT16_C(0x2000)
1240	/** Reserved mask. */
1241	#define UDF_ICB_FLAGS_RESERVED_MASK UINT16_C(0xc000)
1242	/** @} */
1243
1244	/** @name UDF_FILE_TYPE_XXX - File types
1245	*
1246	* See @ecma167{4,14.6.6,94}, @udf260{2.3.5.2,60}
1247	*
1248	* @{ */
1249	#define UDF_FILE_TYPE_NOT_SPECIFIED UINT8_C(0x00) /*< Not specified by this field. /
1250	#define UDF_FILE_TYPE_UNALLOCATED_SPACE_ENTRY UINT8_C(0x01)
1251	#define UDF_FILE_TYPE_PARTITION_INTEGRITY_ENTRY UINT8_C(0x02)
1252	#define UDF_FILE_TYPE_INDIRECT_ENTRY UINT8_C(0x03)
1253	#define UDF_FILE_TYPE_DIRECTORY UINT8_C(0x04)
1254	#define UDF_FILE_TYPE_REGULAR_FILE UINT8_C(0x05)
1255	#define UDF_FILE_TYPE_BLOCK_DEVICE UINT8_C(0x06)
1256	#define UDF_FILE_TYPE_CHARACTER_DEVICE UINT8_C(0x07)
1257	#define UDF_FILE_TYPE_EXTENDED_ATTRIBUTES UINT8_C(0x08)
1258	#define UDF_FILE_TYPE_FIFO UINT8_C(0x09)
1259	#define UDF_FILE_TYPE_SOCKET UINT8_C(0x0a)
1260	#define UDF_FILE_TYPE_TERMINAL_ENTRY UINT8_C(0x0b)
1261	#define UDF_FILE_TYPE_SYMBOLIC_LINK UINT8_C(0x0c)
1262	#define UDF_FILE_TYPE_STREAM_DIRECTORY UINT8_C(0x0d)
1263	#define UDF_FILE_TYPE_VAT UINT8_C(0xf8)
1264	#define UDF_FILE_TYPE_REAL_TIME_FILE UINT8_C(0xf9)
1265	#define UDF_FILE_TYPE_METADATA_FILE UINT8_C(0xfa)
1266	#define UDF_FILE_TYPE_METADATA_MIRROR_FILE UINT8_C(0xfb)
1267	#define UDF_FILE_TYPE_METADATA_BITMAP_FILE UINT8_C(0xfc)
1268	/** @} */
1269
1270
1271	/**
1272	* UDF ICB header (derived structure).
1273	*/
1274	typedef struct UDFICBHDR
1275	{
1276	/** 0x00: The descriptor tag (UDF_TAG_ID_INDIRECT_ENTRY). */
1277	UDFTAG Tag;
1278	/** 0x10: ICB Tag. */
1279	UDFICBTAG IcbTag;
1280	} UDFICBHDR;
1281	AssertCompileSize(UDFICBHDR, 36);
1282	/** Pointer to an UDF ICB header. */
1283	typedef UDFICBHDR *PUDFICBHDR;
1284	/** Pointer to a const UDF ICB header. */
1285	typedef UDFICBHDR const *PCUDFICBHDR;
1286
1287
1288	/**
1289	* UDF indirect entry (@ecma167{4,14.7,96}).
1290	*/
1291	typedef struct UDFINDIRECTENTRY
1292	{
1293	/** 0x00: The descriptor tag (UDF_TAG_ID_INDIRECT_ENTRY). */
1294	UDFTAG Tag;
1295	/** 0x10: ICB Tag. */
1296	UDFICBTAG IcbTag;
1297	/** 0x24: Indirect ICB location. */
1298	UDFLONGAD IndirectIcb;
1299	} UDFINDIRECTENTRY;
1300	AssertCompileSize(UDFINDIRECTENTRY, 52);
1301	/** Pointer to an UDF indirect entry. */
1302	typedef UDFINDIRECTENTRY *PUDFINDIRECTENTRY;
1303	/** Pointer to a const UDF indirect entry. */
1304	typedef UDFINDIRECTENTRY const *PCUDFINDIRECTENTRY;
1305
1306
1307	/**
1308	* UDF terminal entry (@ecma167{4,14.8,97}).
1309	*/
1310	typedef struct UDFTERMINALENTRY
1311	{
1312	/** 0x00: The descriptor tag (UDF_TAG_ID_TERMINAL_ENTRY). */
1313	UDFTAG Tag;
1314	/** 0x10: ICB Tag (UDF_FILE_TYPE_TERMINAL_ENTRY). */
1315	UDFICBTAG IcbTag;
1316	} UDFTERMINALENTRY;
1317	AssertCompileSize(UDFTERMINALENTRY, 36);
1318	/** Pointer to an UDF terminal entry. */
1319	typedef UDFTERMINALENTRY *PUDFTERMINALENTRY;
1320	/** Pointer to a const UDF terminal entry. */
1321	typedef UDFTERMINALENTRY const *PCUDFTERMINALENTRY;
1322
1323
1324	/**
1325	* UDF file entry (FE) (@ecma167{4,14.8,97}, @udf260{2.3.6,62}).
1326	*
1327	* @note Total length shall not exceed one logical block.
1328	*/
1329	typedef struct UDFFILEENTRY
1330	{
1331	/** 0x00: The descriptor tag (UDF_TAG_ID_FILE_ENTRY). */
1332	UDFTAG Tag;
1333	/** 0x10: ICB Tag. */
1334	UDFICBTAG IcbTag;
1335	/** 0x24: User ID (UNIX). */
1336	uint32_t uid;
1337	/** 0x28: Group ID (UNIX). */
1338	uint32_t gid;
1339	/** 0x2c: Permission (UDF_PERM_XXX). */
1340	uint32_t fPermissions;
1341	/** 0x30: Number hard links. */
1342	uint16_t cHardlinks;
1343	/** 0x32: Record format (UDF_REC_FMT_XXX). */
1344	uint8_t uRecordFormat;
1345	/** 0x33: Record format (UDF_REC_ATTR_XXX). */
1346	uint8_t fRecordDisplayAttribs;
1347	/** 0x34: Record length (in bytes).
1348	* @note Must be zero according to the UDF specification. */
1349	uint32_t cbRecord;
1350	/** 0x38: Information length in bytes (file size). */
1351	uint64_t cbData;
1352	/** 0x40: Number of logical blocks allocated (for file data). */
1353	uint64_t cLogicalBlocks;
1354	/** 0x48: Time of last access (prior to recording the file entry). */
1355	UDFTIMESTAMP AccessTime;
1356	/** 0x54: Time of last data modification. */
1357	UDFTIMESTAMP ModificationTime;
1358	/** 0x60: Time of last attribute/status modification. */
1359	UDFTIMESTAMP ChangeTime;
1360	/** 0x6c: Checkpoint number (defaults to 1). */
1361	uint32_t uCheckpoint;
1362	/** 0x70: Extended attribute information control block location. */
1363	UDFLONGAD ExtAttribIcb;
1364	/** 0x80: Implementation identifier ("Developer ID"). /
1365	UDFENTITYID idImplementation;
1366	/** 0xa0: Unique ID. */
1367	uint64_t INodeId;
1368	/** 0xa8: Length of extended attributes in bytes, multiple of four. */
1369	uint32_t cbExtAttribs;
1370	/** 0xac: Length of allocation descriptors in bytes, multiple of four. */
1371	uint32_t cbAllocDescs;
1372	/** 0xb0: Two variable sized fields. First @a cbExtAttribs bytes of extended
1373	* attributes, then @a cbAllocDescs bytes of allocation descriptors. */
1374	RT_FLEXIBLE_ARRAY_EXTENSION
1375	uint8_t abExtAttribs[RT_FLEXIBLE_ARRAY];
1376	} UDFFILEENTRY;
1377	AssertCompileMemberOffset(UDFFILEENTRY, abExtAttribs, 0xb0);
1378	/** Pointer to an UDF file entry. */
1379	typedef UDFFILEENTRY *PUDFFILEENTRY;
1380	/** Pointer to a const UDF file entry. */
1381	typedef UDFFILEENTRY const *PCUDFFILEENTRY;
1382
1383	/** @name UDF_PERM_XXX - UDFFILEENTRY::fPermissions
1384	* See @ecma167{4,14.9.5,99}.
1385	* @{ */
1386	#define UDF_PERM_OTH_EXEC UINT32_C(0x00000001)
1387	#define UDF_PERM_OTH_WRITE UINT32_C(0x00000002)
1388	#define UDF_PERM_OTH_READ UINT32_C(0x00000004)
1389	#define UDF_PERM_OTH_ATTRIB UINT32_C(0x00000008)
1390	#define UDF_PERM_OTH_DELETE UINT32_C(0x00000010)
1391	#define UDF_PERM_OTH_MASK UINT32_C(0x0000001f)
1392
1393	#define UDF_PERM_GRP_EXEC UINT32_C(0x00000020)
1394	#define UDF_PERM_GRP_WRITE UINT32_C(0x00000040)
1395	#define UDF_PERM_GRP_READ UINT32_C(0x00000080)
1396	#define UDF_PERM_GRP_ATTRIB UINT32_C(0x00000100)
1397	#define UDF_PERM_GRP_DELETE UINT32_C(0x00000200)
1398	#define UDF_PERM_GRP_MASK UINT32_C(0x000003e0)
1399
1400	#define UDF_PERM_USR_EXEC UINT32_C(0x00000400)
1401	#define UDF_PERM_USR_WRITE UINT32_C(0x00000800)
1402	#define UDF_PERM_USR_READ UINT32_C(0x00001000)
1403	#define UDF_PERM_USR_ATTRIB UINT32_C(0x00002000)
1404	#define UDF_PERM_USR_DELETE UINT32_C(0x00004000)
1405	#define UDF_PERM_USR_MASK UINT32_C(0x00007c00)
1406
1407	#define UDF_PERM_USR_RESERVED_MASK UINT32_C(0xffff8000)
1408	/** @} */
1409
1410	/** @name UDF_REC_FMT_XXX - Record format.
1411	* See @ecma167{4,14.9.7,100}.
1412	* @{ */
1413	/** Not record format specified.
1414	* @note The only allowed value according to the UDF specification. */
1415	#define UDF_REC_FMT_NOT_SPECIFIED UINT8_C(0x00)
1416	/** @} */
1417
1418	/** @name UDF_REC_ATTR_XXX - Record display attributes.
1419	* See @ecma167{4,14.9.8,100}.
1420	* @{ */
1421	/** Manner of record display not specified.
1422	* @note The only allowed value according to the UDF specification. */
1423	#define UDF_REC_ATTR_NOT_SPECIFIED UINT8_C(0x00)
1424	/** @} */
1425
1426
1427	/**
1428	* UDF extended attribute header descriptor (@ecma167{4,14.10.1,102},
1429	* @udf260{3.3.4,79}).
1430	*/
1431	typedef struct UDFEXTATTRIBHDRDESC
1432	{
1433	/** 0x00: The descriptor tag (UDF_TAG_ID_EXTENDED_ATTRIB_HDR_DESC). */
1434	UDFTAG Tag;
1435	/** 0x10: Implementation attributes location (byte offset) into the EA space.
1436	* This typically set to UINT32_MAX if not present, though any value larger
1437	* than the EA space will do. */
1438	uint32_t offImplementationAttribs;
1439	/** 0x14: Application attributes location (byte offset) into the EA space.
1440	* This typically set to UINT32_MAX if not present, though any value larger
1441	* than the EA space will do. */
1442	uint32_t offApplicationAttribs;
1443	} UDFEXTATTRIBHDRDESC;
1444	AssertCompileSize(UDFEXTATTRIBHDRDESC, 24);
1445	/** Pointer to an UDF extended attribute header descriptor. */
1446	typedef UDFEXTATTRIBHDRDESC *PUDFEXTATTRIBHDRDESC;
1447	/** Pointer to a const UDF extended attribute header descriptor. */
1448	typedef UDFEXTATTRIBHDRDESC const *PCUDFEXTATTRIBHDRDESC;
1449
1450	/**
1451	* UDF character set info EA data (@ecma167{4,14.10.3,104}).
1452	*
1453	* Not needed by UDF.
1454	*/
1455	typedef struct UDFEADATACHARSETINFO
1456	{
1457	/** 0x00/0x0c: The length of the escape sequences (in bytes). */
1458	uint32_t cbEscSeqs;
1459	/** 0x04/0x10: The character set type (UDF_CHAR_SET_TYPE_XXX). */
1460	uint8_t bType;
1461	/** 0x05/0x11: Escape sequences. */
1462	uint8_t abEscSeqs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1463	} UDFEADATACHARSETINFO;
1464	/** Pointer to UDF character set info EA data. */
1465	typedef UDFEADATACHARSETINFO *PUDFEADATACHARSETINFO;
1466	/** Pointer to const UDF character set info EA data. */
1467	typedef UDFEADATACHARSETINFO const *PCUDFEADATACHARSETINFO;
1468	/** UDFGEA::uAttribType value for UDFEADATACHARSETINFO.*/
1469	#define UDFEADATACHARSETINFO_ATTRIB_TYPE UINT32_C(0x00000001)
1470	/** UDFGEA::uAttribSubtype value for UDFEADATACHARSETINFO. */
1471	#define UDFEADATACHARSETINFO_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1472
1473	/**
1474	* UDF alternate permissions EA data (@ecma167{4,14.10.4,105}, @udf260{3.3.4.2,80}).
1475	* @note Not recorded according to the UDF specification.
1476	*/
1477	typedef struct UDFEADATAALTPERM
1478	{
1479	/** 0x00/0x0c: Alternative owner ID. */
1480	uint16_t idOwner;
1481	/** 0x02/0x0e: Alternative group ID. */
1482	uint16_t idGroup;
1483	/** 0x04/0x10: Alternative permissions. */
1484	uint16_t fPermission;
1485	} UDFEADATAALTPERM;
1486	/** Pointer to UDF alternative permissions EA data. */
1487	typedef UDFEADATAALTPERM *PUDFEADATAALTPERM;
1488	/** Pointer to const UDF alternative permissions EA data. */
1489	typedef UDFEADATAALTPERM const *PCUDFEADATAALTPERM;
1490	/** UDFGEA::uAttribType value for UDFEADATAALTPERM. */
1491	#define UDFEADATAALTPERM_ATTRIB_TYPE UINT32_C(0x00000003)
1492	/** UDFGEA::uAttribSubtype value for UDFEADATAALTPERM. */
1493	#define UDFEADATAALTPERM_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1494
1495	/**
1496	* UDF file times EA data (@ecma167{4,14.10.5,108}, @udf260{3.3.4.3,80}).
1497	* (This is a bit reminiscent of ISO9660RRIPTF.)
1498	*/
1499	typedef struct UDFEADATAFILETIMES
1500	{
1501	/** 0x00/0x0c: Timestamp length. */
1502	uint32_t cbTimestamps;
1503	/** 0x04/0x10: Indicates which timestamps are present
1504	* (UDF_FILE_TIMES_EA_F_XXX). */
1505	uint32_t fFlags;
1506	/** 0x08/0x14: Timestamps. */
1507	UDFTIMESTAMP aTimestamps[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1508	} UDFEADATAFILETIMES;
1509	/** Pointer to UDF file times EA data. */
1510	typedef UDFEADATAFILETIMES *PUDFEADATAFILETIMES;
1511	/** Pointer to const UDF file times EA data. */
1512	typedef UDFEADATAFILETIMES const *PCUDFEADATAFILETIMES;
1513	/** UDFGEA::uAttribType value for UDFEADATAFILETIMES. */
1514	#define UDFEADATAFILETIMES_ATTRIB_TYPE UINT32_C(0x00000005)
1515	/** UDFGEA::uAttribSubtype value for UDFEADATAFILETIMES. */
1516	#define UDFEADATAFILETIMES_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1517
1518	/** @name UDF_FILE_TIMES_EA_F_XXX - File times existence flags.
1519	* See @ecma167{4,14.10.5.6,109}
1520	* @{ */
1521	#define UDF_FILE_TIMES_EA_F_BIRTH UINT8_C(0x01) /*< Birth (creation) timestamp is recorded. /
1522	#define UDF_FILE_TIMES_EA_F_DELETE UINT8_C(0x04) /*< Deletion timestamp is recorded. /
1523	#define UDF_FILE_TIMES_EA_F_EFFECTIVE UINT8_C(0x08) /*< Effective timestamp is recorded. /
1524	#define UDF_FILE_TIMES_EA_F_BACKUP UINT8_C(0x20) /*< Backup timestamp is recorded. /
1525	#define UDF_FILE_TIMES_EA_F_RESERVED_MASK UINT8_C(0xd2)
1526	/** @} */
1527
1528	/**
1529	* UDF information times EA data (@ecma167{4,14.10.6,109}).
1530	*/
1531	typedef struct UDFEADATAINFOTIMES
1532	{
1533	/** 0x00/0x0c: Timestamp length. */
1534	uint32_t cbTimestamps;
1535	/** 0x04/0x10: Indicates which timestamps are present
1536	* (UDF_INFO_TIMES_EA_F_XXX). */
1537	uint32_t fFlags;
1538	/** 0x08/0x14: Timestamps. */
1539	UDFTIMESTAMP aTimestamps[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1540	} UDFEADATAINFOTIMES;
1541	/** Pointer to UDF information times EA data. */
1542	typedef UDFEADATAINFOTIMES *PUDFEADATAINFOTIMES;
1543	/** Pointer to const UDF information times EA data. */
1544	typedef UDFEADATAINFOTIMES const *PCUDFEADATAINFOTIMES;
1545	/** UDFGEA::uAttribType value for UDFEADATAINFOTIMES. */
1546	#define UDFEADATAINFOTIMES_ATTRIB_TYPE UINT32_C(0x00000006)
1547	/** UDFGEA::uAttribSubtype value for UDFEADATAINFOTIMES. */
1548	#define UDFEADATAINFOTIMES_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1549
1550	/** @name UDF_INFO_TIMES_EA_F_XXX - Information times existence flags.
1551	* See @ecma167{4,14.10.6.6,110}
1552	* @{ */
1553	#define UDF_INFO_TIMES_EA_F_BIRTH UINT8_C(0x01) /*< Birth (creation) timestamp is recorded. /
1554	#define UDF_INFO_TIMES_EA_F_MODIFIED UINT8_C(0x02) /*< Last (data) modified timestamp is recorded. /
1555	#define UDF_INFO_TIMES_EA_F_EXPIRE UINT8_C(0x04) /*< Expiration (deletion) timestamp is recorded. /
1556	#define UDF_INFO_TIMES_EA_F_EFFECTIVE UINT8_C(0x08) /*< Effective timestamp is recorded. /
1557	#define UDF_INFO_TIMES_EA_F_RESERVED_MASK UINT8_C(0xf0)
1558	/** @} */
1559
1560	/**
1561	* UDF device specification EA data (@ecma167{4,14.10.7,110}, @udf260{3.3.4.4,81}).
1562	*/
1563	typedef struct UDFEADATADEVICESPEC
1564	{
1565	/** 0x00/0x0c: Length of implementation use field. */
1566	uint32_t cbImplementationUse;
1567	/** 0x04/0x10: Major device number. */
1568	uint32_t uMajorDeviceNo;
1569	/** 0x08/0x14: Minor device number. */
1570	uint32_t uMinorDeviceNo;
1571	/** 0x0c/0x18: Implementation use field (variable length).
1572	* UDF specficiation expects UDFENTITYID with a "*Developer ID" as first part
1573	* here. */
1574	uint8_t abImplementationUse[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1575	} UDFEADATADEVICESPEC;
1576	/** Pointer to UDF device specification EA data. */
1577	typedef UDFEADATADEVICESPEC *PUDFEADATADEVICESPEC;
1578	/** Pointer to const UDF device specification EA data. */
1579	typedef UDFEADATADEVICESPEC const *PCUDFEADATADEVICESPEC;
1580	/** UDFGEA::uAttribType value for UDFEADATADEVICESPEC. */
1581	#define UDFEADATADEVICESPEC_ATTRIB_TYPE UINT32_C(0x0000000c)
1582	/** UDFGEA::uAttribSubtype value for UDFEADATADEVICESPEC. */
1583	#define UDFEADATADEVICESPEC_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1584
1585	/**
1586	* UDF free EA space payload for implementation and application use EAs
1587	* (@udf260{3.3.4.5.1.1,82}, @udf260{3.3.4.6.1.1,88}).
1588	*
1589	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_FREE_EA_SPACE.
1590	* UDFEADATAAPPUSE::idImplementation is UDF_ENTITY_ID_AUEA_FREE_EA_SPACE.
1591	*/
1592	typedef struct UDFFREEEASPACE
1593	{
1594	/** 0x00/0x30: Header checksum.
1595	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1596	uint16_t uChecksum;
1597	/** 0x02/0x32: Free space. */
1598	uint8_t abFree[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1599	} UDFFREEEASPACE;
1600	/** Pointer to UDF free EA space impl/app use payload. */
1601	typedef UDFFREEEASPACE *PUDFFREEEASPACE;
1602	/** Pointer to const UDF free EA space impl/app use payload. */
1603	typedef UDFFREEEASPACE const *PCUDFFREEEASPACE;
1604
1605	/**
1606	* UDF DVD copyright management information implementation use EA payload
1607	* (@udf260{3.3.4.5.1.2,83}).
1608	*
1609	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_DVD_CGMS_INFO.
1610	*/
1611	typedef struct UDFIUEADVDCGMSINFO
1612	{
1613	/** 0x00/0x30: Header checksum.
1614	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1615	uint16_t uChecksum;
1616	/** 0x02/0x32: The CGMS information (whatever that is). */
1617	uint8_t bInfo;
1618	/** 0x03/0x33: Data structure type (whatever that is). */
1619	uint8_t bType;
1620	/** 0x04/0x34: Production system information, probably dependend on the
1621	* values of previous fields. */
1622	uint8_t abProtSysInfo[4];
1623	} UDFIUEADVDCGMSINFO;
1624	/** Pointer to UDF DVD copyright management information implementation use EA payload. */
1625	typedef UDFIUEADVDCGMSINFO *PUDFIUEADVDCGMSINFO;
1626	/** Pointer to const UDF DVD copyright management information implementation use EA payload. */
1627	typedef UDFIUEADVDCGMSINFO const *PCUDFIUEADVDCGMSINFO;
1628
1629	/**
1630	* UDF OS/2 EA length implementation use EA payload (@udf260{3.3.4.5.3.1,84}).
1631	*
1632	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_OS2_EA_LENGTH.
1633	*/
1634	#pragma pack(2)
1635	typedef struct UDFIUEAOS2EALENGTH
1636	{
1637	/** 0x00/0x30: Header checksum.
1638	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1639	uint16_t uChecksum;
1640	/** 0x02/0x32: The CGMS information (whatever that is). */
1641	uint32_t cbEAs;
1642	} UDFIUEAOS2EALENGTH;
1643	#pragma pack()
1644	AssertCompileMemberOffset(UDFIUEAOS2EALENGTH, cbEAs, 2);
1645	/** Pointer to UDF OS/2 EA length implementation use EA payload. */
1646	typedef UDFIUEAOS2EALENGTH *PUDFIUEAOS2EALENGTH;
1647	/** Pointer to const UDF OS/2 EA length implementation use EA payload. */
1648	typedef UDFIUEAOS2EALENGTH const *PCUDFIUEAOS2EALENGTH;
1649
1650	/**
1651	* UDF Mac volume info implementation use EA payload (@udf260{3.3.4.5.4.1,84}).
1652	*
1653	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_MAC_VOLUME_INFO.
1654	*/
1655	#pragma pack(2)
1656	typedef struct UDFIUEAMACVOLINFO
1657	{
1658	/** 0x00/0x30: Header checksum.
1659	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1660	uint16_t uChecksum;
1661	/** 0x02/0x32: Last modification time. */
1662	UDFTIMESTAMP LastModificationTime;
1663	/** 0x0e/0x3e: Last backup time. */
1664	UDFTIMESTAMP LastBackupTime;
1665	/** 0x1a/0x4e: Volume finder information. */
1666	uint32_t au32FinderInfo[8];
1667	} UDFIUEAMACVOLINFO;
1668	#pragma pack()
1669	AssertCompileMemberOffset(UDFIUEAMACVOLINFO, au32FinderInfo, 0x1a);
1670	/** Pointer to UDF Mac volume info implementation use EA payload. */
1671	typedef UDFIUEAMACVOLINFO *PUDFIUEAMACVOLINFO;
1672	/** Pointer to const UDF Mac volume info implementation use EA payload. */
1673	typedef UDFIUEAMACVOLINFO const *PCUDFIUEAMACVOLINFO;
1674
1675	/**
1676	* UDF point for use in Mac EAs (@udf260{3.3.4.5.4.2,86}).
1677	*/
1678	typedef struct UDFMACPOINT
1679	{
1680	/** X coordinate. */
1681	int16_t x;
1682	/** Y coordinate. */
1683	int16_t y;
1684	} UDFMACPOINT;
1685
1686	/**
1687	* UDF rectangle for using Mac EAs (@udf260{3.3.4.5.4.2,86}).
1688	*/
1689	typedef struct UDFMACRECT
1690	{
1691	/** top Y coordinate. */
1692	int16_t yTop;
1693	/** left X coordinate. */
1694	int16_t xLeft;
1695	/** bottom Y coordinate. (exclusive?) */
1696	int16_t yBottom;
1697	/** right X coordinate. (exclusive?) */
1698	int16_t xRight;
1699	} UDFMACRECT;
1700
1701	/**
1702	* UDF finder directory info for Mac EAs (@udf260{3.3.4.5.4.2,86}).
1703	*/
1704	typedef struct UDFMACFDINFO
1705	{
1706	UDFMACRECT FrRect;
1707	int16_t FrFlags;
1708	UDFMACPOINT FrLocation;
1709	int16_t FrView;
1710	} UDFMACFDINFO;
1711	AssertCompileSize(UDFMACFDINFO, 16);
1712
1713	/**
1714	* UDF finder directory extended info for Mac EAs (@udf260{3.3.4.5.4.2,86}).
1715	*/
1716	typedef struct UDFMACFDXINFO
1717	{
1718	UDFMACPOINT FrScroll;
1719	int32_t FrOpenChain;
1720	uint8_t FrScript;
1721	uint8_t FrXFlags;
1722	uint16_t FrComment;
1723	uint32_t FrPutAway;
1724	} UDFMACFDXINFO;
1725	AssertCompileSize(UDFMACFDXINFO, 16);
1726
1727	/**
1728	* UDF Mac finder info implementation use EA payload (@udf260{3.3.4.5.4.1,84}),
1729	* directory edition.
1730	*
1731	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_MAC_FINDER_INFO.
1732	*/
1733	typedef struct UDFIUEAMACFINDERINFODIR
1734	{
1735	/** 0x00/0x30: Header checksum.
1736	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1737	uint16_t uChecksum;
1738	/** 0x02/0x32: Explicit alignment padding, MBZ. */
1739	uint16_t uPadding;
1740	/** 0x04/0x34: Parent directory ID. */
1741	uint32_t idParentDir;
1742	/** 0x08/0x38: Dir information. */
1743	UDFMACFDINFO DirInfo;
1744	/** 0x18/0x48: Dir extended information. */
1745	UDFMACFDXINFO DirExInfo;
1746	} UDFIUEAMACFINDERINFODIR;
1747	AssertCompileMemberOffset(UDFIUEAMACFINDERINFODIR, DirInfo, 0x08);
1748	AssertCompileMemberOffset(UDFIUEAMACFINDERINFODIR, DirExInfo, 0x18);
1749	AssertCompileSize(UDFIUEAMACFINDERINFODIR, 0x28);
1750	/** Pointer to UDF Mac finder info for dir implementation use EA payload. */
1751	typedef UDFIUEAMACFINDERINFODIR *PUDFIUEAMACFINDERINFODIR;
1752	/** Pointer to const UDF Mac finder info for dir implementation use EA payload. */
1753	typedef UDFIUEAMACFINDERINFODIR const *PCUDFIUEAMACFINDERINFODIR;
1754
1755	/**
1756	* UDF finder file info for Mac EAs (@udf260{3.3.4.5.4.2,86}).
1757	*/
1758	typedef struct UDFMACFFINFO
1759	{
1760	uint32_t FrType;
1761	uint32_t FrCreator;
1762	uint16_t FrFlags;
1763	UDFMACPOINT FrLocation;
1764	int16_t FrFldr;
1765	} UDFMACFFINFO;
1766	AssertCompileSize(UDFMACFFINFO, 16);
1767
1768	/**
1769	* UDF finder file extended info for Mac EAs (@udf260{3.3.4.5.4.2,86}).
1770	*/
1771	typedef struct UDFMACFFXINFO
1772	{
1773	int16_t FrIconID;
1774	uint8_t FdUnused[6];
1775	uint8_t FrScript;
1776	uint8_t FrXFlags;
1777	uint16_t FrComment;
1778	uint32_t FrPutAway;
1779	} UDFMACFFXINFO;
1780	AssertCompileSize(UDFMACFFXINFO, 16);
1781
1782	/**
1783	* UDF Mac finder info implementation use EA payload (@udf260{3.3.4.5.4.1,84}),
1784	* file edition.
1785	*
1786	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_MAC_FINDER_INFO.
1787	*/
1788	typedef struct UDFIUEAMACFINDERINFOFILE
1789	{
1790	/** 0x00/0x30: Header checksum.
1791	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1792	uint16_t uChecksum;
1793	/** 0x02/0x32: Explicit alignment padding, MBZ. */
1794	uint16_t uPadding;
1795	/** 0x04/0x34: Parent directory ID. */
1796	uint32_t idParentDir;
1797	/** 0x08/0x38: File information. */
1798	UDFMACFFINFO FileInfo;
1799	/** 0x18/0x48: File extended information. */
1800	UDFMACFFXINFO FileExInfo;
1801	/** 0x28/0x58: The size of the fork data (in bytes). */
1802	uint32_t cbForkData;
1803	/** 0x2c/0x5c: The size of the fork allocation (in bytes). */
1804	uint32_t cbForkAlloc;
1805	} UDFIUEAMACFINDERINFOFILE;
1806	AssertCompileMemberOffset(UDFIUEAMACFINDERINFOFILE, FileInfo, 0x08);
1807	AssertCompileMemberOffset(UDFIUEAMACFINDERINFOFILE, FileExInfo, 0x18);
1808	AssertCompileMemberOffset(UDFIUEAMACFINDERINFOFILE, cbForkData, 0x28);
1809	AssertCompileSize(UDFIUEAMACFINDERINFOFILE, 0x30);
1810	/** Pointer to UDF Mac finder info for file implementation use EA payload. */
1811	typedef UDFIUEAMACFINDERINFOFILE *PUDFIUEAMACFINDERINFOFILE;
1812	/** Pointer to const UDF Mac finder info for file implementation use EA payload. */
1813	typedef UDFIUEAMACFINDERINFOFILE const *PCUDFIUEAMACFINDERINFOFILE;
1814
1815	/**
1816	* UDF OS/400 directory info implementation use EA payload (@udf260{3.3.4.5.6.1,87})
1817	*
1818	* UDFEADATAIMPLUSE::idImplementation is UDF_ENTITY_ID_IUEA_OS400_DIR_INFO.
1819	*/
1820	typedef struct UDFIUEAOS400DIRINFO
1821	{
1822	/** 0x00/0x30: Header checksum.
1823	* @note 16-bit checksum of UDFGEA up thru u.ImplUse.idImplementation. */
1824	uint16_t uChecksum;
1825	/** 0x02/0x32: Explicit alignment padding, MBZ. */
1826	uint16_t uPadding;
1827	/** 0x04/0x34: The directory info, format documented elsewhere. */
1828	uint8_t abDirInfo[44];
1829	} UDFIUEAOS400DIRINFO;
1830	AssertCompileSize(UDFIUEAOS400DIRINFO, 0x30);
1831	/** Pointer to UDF Mac finder info for file implementation use EA payload. */
1832	typedef UDFIUEAOS400DIRINFO *PUDFIUEAOS400DIRINFO;
1833	/** Pointer to const UDF Mac finder info for file implementation use EA payload. */
1834	typedef UDFIUEAOS400DIRINFO const *PCUDFIUEAOS400DIRINFO;
1835
1836
1837	/**
1838	* UDF implementation use EA data (@ecma167{4,14.10.8,111}, @udf260{3.3.4.5,82}).
1839	*/
1840	typedef struct UDFEADATAIMPLUSE
1841	{
1842	/** 0x00/0x0c: Length uData in bytes. */
1843	uint32_t cbData;
1844	/** 0x04/0x10: Implementation identifier (UDF_ENTITY_ID_IUEA_XXX). */
1845	UDFENTITYID idImplementation;
1846	/** 0x24/0x30: Implementation use field (variable length). */
1847	union
1848	{
1849	/** Generic byte view. */
1850	uint8_t abData[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1851	/** Free EA space (UDF_ENTITY_ID_IUEA_FREE_EA_SPACE). */
1852	UDFFREEEASPACE FreeEaSpace;
1853	/** DVD copyright management information (UDF_ENTITY_ID_IUEA_DVD_CGMS_INFO). */
1854	UDFIUEADVDCGMSINFO DvdCgmsInfo;
1855	/** OS/2 EA length (UDF_ENTITY_ID_IUEA_OS2_EA_LENGTH). */
1856	UDFIUEAOS2EALENGTH Os2EaLength;
1857	/** Mac volume info (UDF_ENTITY_ID_IUEA_MAC_VOLUME_INFO). */
1858	UDFIUEAMACVOLINFO MacVolInfo;
1859	/** Mac finder info, directory edition (UDF_ENTITY_ID_IUEA_MAC_FINDER_INFO). */
1860	UDFIUEAMACFINDERINFODIR MacFinderInfoDir;
1861	/** Mac finder info, file edition (UDF_ENTITY_ID_IUEA_MAC_FINDER_INFO). */
1862	UDFIUEAMACFINDERINFOFILE MacFinderInfoFile;
1863	/** OS/400 directory info (UDF_ENTITY_ID_IUEA_OS400_DIR_INFO). */
1864	UDFIUEAOS400DIRINFO Os400DirInfo;
1865	} u;
1866	} UDFEADATAIMPLUSE;
1867	/** Pointer to UDF implementation use EA data. */
1868	typedef UDFEADATAIMPLUSE *PUDFEADATAIMPLUSE;
1869	/** Pointer to const UDF implementation use EA data. */
1870	typedef UDFEADATAIMPLUSE const *PCUDFEADATAIMPLUSE;
1871	/** UDFGEA::uAttribType value for UDFEADATAIMPLUSE. */
1872	#define UDFEADATAIMPLUSE_ATTRIB_TYPE UINT32_C(0x00000800)
1873	/** UDFGEA::uAttribSubtype value for UDFEADATAIMPLUSE. */
1874	#define UDFEADATAIMPLUSE_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1875
1876	/**
1877	* UDF application use EA data (@ecma167{4,14.10.9,112}, @udf260{3.3.4.6,88}).
1878	*/
1879	typedef struct UDFEADATAAPPUSE
1880	{
1881	/** 0x0c: Length uData in bytes. */
1882	uint32_t cbData;
1883	/** 0x10: Application identifier (UDF_ENTITY_ID_AUEA_FREE_EA_SPACE). */
1884	UDFENTITYID idApplication;
1885	/** 0x30: Application use field (variable length). */
1886	union
1887	{
1888	/** Generic byte view. */
1889	uint8_t ab[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1890	/** Free EA space (UDF_ENTITY_ID_AUEA_FREE_EA_SPACE). */
1891	UDFFREEEASPACE FreeEaSpace;
1892	} uData;
1893	} UDFEADATAAPPUSE;
1894	/** Pointer to UDF application use EA data. */
1895	typedef UDFEADATAAPPUSE *PUDFEADATAAPPUSE;
1896	/** Pointer to const UDF application use EA data. */
1897	typedef UDFEADATAAPPUSE const *PCUDFEADATAAPPUSE;
1898	/** UDFGEA::uAttribType value for UDFEADATAAPPUSE. */
1899	#define UDFEADATAAPPUSE_ATTRIB_TYPE UINT32_C(0x00010000)
1900	/** UDFGEA::uAttribSubtype value for UDFEADATAAPPUSE. */
1901	#define UDFEADATAAPPUSE_ATTRIB_SUBTYPE UINT32_C(0x00000001)
1902
1903	/**
1904	* UDF generic extended attribute (@ecma167{4,14.10.2,103}).
1905	*/
1906	typedef struct UDFGEA
1907	{
1908	/** 0x00: Attribute type (UDFXXX_ATTRIB_TYPE). */
1909	uint32_t uAttribType;
1910	/** 0x04: Attribute subtype (UDFXXX_ATTRIB_SUBTYPE). */
1911	uint8_t uAttribSubtype;
1912	/** 0x05: Reserved padding bytes, MBZ. */
1913	uint8_t abReserved[3];
1914	/** 0x08: Size of the whole extended attribute.
1915	* Multiple of four is recommended. */
1916	uint32_t cbAttrib;
1917	/** 0x0c: Attribute data union. */
1918	union
1919	{
1920	/** Generic byte view (variable size). */
1921	uint8_t abData[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1922	/** Character set information (@ecma167{4,14.10.3,104}). */
1923	UDFEADATACHARSETINFO CharSetInfo;
1924	/** Alternate permissions (@ecma167{4,14.10.4,105}, @udf260{3.3.4.2,80}).
1925	* @note Not recorded according to the UDF specification. */
1926	UDFEADATAALTPERM AltPerm;
1927	/** File times (@ecma167{4,14.10.5,108}, @udf260{3.3.4.3,80}).
1928	* (This is a bit reminiscent of ISO9660RRIPTF.) */
1929	UDFEADATAFILETIMES FileTimes;
1930	/** Information times (@ecma167{4,14.10.6,109}). */
1931	UDFEADATAINFOTIMES InfoTimes;
1932	/** Device specification (@ecma167{4,14.10.7,110}, @udf260{3.3.4.4,81}). */
1933	UDFEADATADEVICESPEC DeviceSpec;
1934	/** Implementation use (@ecma167{4,14.10.8,111}, @udf260{3.3.4.5,82}). */
1935	UDFEADATAIMPLUSE ImplUse;
1936	/** Application use (@ecma167{4,14.10.9,112}, @udf260{3.3.4.6,88}). */
1937	UDFEADATAAPPUSE AppUse;
1938	} u;
1939	} UDFGEA;
1940	AssertCompileMemberOffset(UDFGEA, u, 0x0c);
1941	/** Pointer to a UDF extended attribute. */
1942	typedef UDFGEA *PUDFGEA;
1943	/** Pointer to a const UDF extended attribute. */
1944	typedef UDFGEA const *PCUDFGEA;
1945
1946
1947	/**
1948	* UDF unallocated space entry (@ecma167{4,14.11,113}, @udf260{2.3.7,64}).
1949	*
1950	* @note Total length shall not exceed one logical block.
1951	*/
1952	typedef struct UDFUNALLOCATEDSPACEENTRY
1953	{
1954	/** 0x00: The descriptor tag (UDF_TAG_ID_UNALLOCATED_SPACE_ENTRY). */
1955	UDFTAG Tag;
1956	/** 0x10: ICB Tag. */
1957	UDFICBTAG IcbTag;
1958	/** 0x24: Size of the allocation desciptors in bytes. */
1959	uint32_t cbAllocDescs;
1960	/** 0x28: Allocation desciptors, type given by IcbTag::fFlags. */
1961	union
1962	{
1963	UDFSHORTAD aShortADs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1964	UDFLONGAD aLongADs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1965	UDFEXTAD aExtADs[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
1966	UDFEXTENTAD SingleAD;
1967	} u;
1968	} UDFUNALLOCATEDSPACEENTRY;
1969	AssertCompileMemberOffset(UDFUNALLOCATEDSPACEENTRY, u, 0x28);
1970	/** Pointer to an UDF unallocated space entry. */
1971	typedef UDFUNALLOCATEDSPACEENTRY *PUDFUNALLOCATEDSPACEENTRY;
1972	/** Pointer to a const UDF unallocated space entry. */
1973	typedef UDFUNALLOCATEDSPACEENTRY const *PCUDFUNALLOCATEDSPACEENTRY;
1974
1975
1976	/**
1977	* UDF space bitmap descriptor (SBD) (@ecma167{4,14.12,114}, @udf260{2.3.8,65}).
1978	*/
1979	typedef struct UDFSPACEBITMAPDESC
1980	{
1981	/** 0x00: The descriptor tag (UDF_TAG_ID_SPACE_BITMAP_DESC). */
1982	UDFTAG Tag;
1983	/** 0x10: Number of bits in the bitmap. */
1984	uint32_t cBits;
1985	/** 0x14: The bitmap size in bytes. */
1986	uint32_t cbBitmap;
1987	/** 0x18: The bitmap. */
1988	RT_FLEXIBLE_ARRAY_EXTENSION
1989	uint8_t abBitmap[RT_FLEXIBLE_ARRAY];
1990	} UDFSPACEBITMAPDESC;
1991	AssertCompileMemberOffset(UDFSPACEBITMAPDESC, abBitmap, 0x18);
1992	/** Pointer to an UDF space bitmap descriptor. */
1993	typedef UDFSPACEBITMAPDESC *PUDFSPACEBITMAPDESC;
1994	/** Pointer to a const UDF space bitmap descriptor. */
1995	typedef UDFSPACEBITMAPDESC const *PCUDFSPACEBITMAPDESC;
1996
1997
1998	/**
1999	* UDF partition integrity descriptor (@ecma167{4,14.3,115}, @udf260{2.3.9,65}).
2000	*
2001	* @note Not needed by UDF.
2002	*/
2003	typedef struct UDFPARTITIONINTEGRITYDESC
2004	{
2005	/** 0x000: The descriptor tag (UDF_TAG_ID_PARTITION_INTEGERITY_DESC). */
2006	UDFTAG Tag;
2007	/** 0x010: ICB Tag. */
2008	UDFICBTAG IcbTag;
2009	/** 0x024: Recording timestamp. */
2010	UDFTIMESTAMP RecordingTimestamp;
2011	/** 0x030: Interity type (UDF_PARTITION_INTEGRITY_TYPE_XXX). */
2012	uint8_t bType;
2013	/** 0x031: Reserved. */
2014	uint8_t abReserved[175];
2015	/** 0x0e0: Implementation identifier. */
2016	UDFENTITYID idImplementation;
2017	/** 0x100: Implementation use data. */
2018	RT_FLEXIBLE_ARRAY_EXTENSION
2019	uint8_t abImplementationUse[RT_FLEXIBLE_ARRAY];
2020	} UDFPARTITIONINTEGRITYDESC;
2021	AssertCompileMemberOffset(UDFPARTITIONINTEGRITYDESC, abImplementationUse, 0x100);
2022	/** Pointer to an UDF partition integrity descriptor. */
2023	typedef UDFPARTITIONINTEGRITYDESC *PUDFPARTITIONINTEGRITYDESC;
2024	/** Pointer to a const UDF partition integrity descriptor. */
2025	typedef UDFPARTITIONINTEGRITYDESC const *PCUDFPARTITIONINTEGRITYDESC;
2026
2027
2028	/**
2029	* UDF extended file entry (EFE) (@ecma167{4,14.17,120}, @udf260{3.3.5,83}).
2030	*
2031	* @note Total length shall not exceed one logical block.
2032	*/
2033	typedef struct UDFEXFILEENTRY
2034	{
2035	/** 0x00: The descriptor tag (UDF_TAG_ID_EXTENDED_FILE_ENTRY). */
2036	UDFTAG Tag;
2037	/** 0x10: ICB Tag. */
2038	UDFICBTAG IcbTag;
2039	/** 0x24: User ID (UNIX). */
2040	uint32_t uid;
2041	/** 0x28: Group ID (UNIX). */
2042	uint32_t gid;
2043	/** 0x2c: Permission (UDF_PERM_XXX). */
2044	uint32_t fPermissions;
2045	/** 0x30: Number hard links. */
2046	uint16_t cHardlinks;
2047	/** 0x32: Record format (UDF_REC_FMT_XXX). */
2048	uint8_t uRecordFormat;
2049	/** 0x33: Record format (UDF_REC_FMT_XXX). */
2050	uint8_t fRecordDisplayAttribs;
2051	/** 0x34: Record length (in bytes).
2052	* @note Must be zero according to the UDF specification. */
2053	uint32_t cbRecord;
2054	/** 0x38: Information length in bytes (file size). */
2055	uint64_t cbData;
2056	/** 0x40: The size of all streams. Same as cbData if no additional streams. */
2057	uint64_t cbObject;
2058	/** 0x48: Number of logical blocks allocated (for file data). */
2059	uint64_t cLogicalBlocks;
2060	/** 0x50: Time of last access (prior to recording the file entry). */
2061	UDFTIMESTAMP AccessTime;
2062	/** 0x5c: Time of last data modification. */
2063	UDFTIMESTAMP ModificationTime;
2064	/** 0x68: Birth (creation) time. */
2065	UDFTIMESTAMP BirthTime;
2066	/** 0x74: Time of last attribute/status modification. */
2067	UDFTIMESTAMP ChangeTime;
2068	/** 0x80: Checkpoint number (defaults to 1). */
2069	uint32_t uCheckpoint;
2070	/** 0x84: Reserved, MBZ. */
2071	uint32_t uReserved;
2072	/** 0x88: Extended attribute information control block location. */
2073	UDFLONGAD ExtAttribIcb;
2074	/** 0x98: Stream directory information control block location. */
2075	UDFLONGAD StreamDirIcb;
2076	/** 0xa8: Implementation identifier (UDF_ENTITY_ID_FE_IMPLEMENTATION). */
2077	UDFENTITYID idImplementation;
2078	/** 0xc8: Unique ID. */
2079	uint64_t INodeId;
2080	/** 0xd0: Length of extended attributes in bytes, multiple of four. */
2081	uint32_t cbExtAttribs;
2082	/** 0xd4: Length of allocation descriptors in bytes, multiple of four. */
2083	uint32_t cbAllocDescs;
2084	/** 0xd8: Two variable sized fields. First @a cbExtAttribs bytes of extended
2085	* attributes, then @a cbAllocDescs bytes of allocation descriptors. */
2086	RT_FLEXIBLE_ARRAY_EXTENSION
2087	uint8_t abExtAttribs[RT_FLEXIBLE_ARRAY];
2088	} UDFEXFILEENTRY;
2089	AssertCompileMemberOffset(UDFEXFILEENTRY, abExtAttribs, 0xd8);
2090	/** Pointer to an UDF extended file entry. */
2091	typedef UDFEXFILEENTRY *PUDFEXFILEENTRY;
2092	/** Pointer to a const UDF extended file entry. */
2093	typedef UDFEXFILEENTRY const *PCUDFEXFILEENTRY;
2094
2095
2096
2097	/** @name UDF Volume Recognition Sequence (VRS)
2098	*
2099	* The recognition sequence usually follows the CD001 descriptor sequence at
2100	* sector 16 and is there to indicate that the medium (also) contains a UDF file
2101	* system and which standards are involved.
2102	*
2103	* See @ecma167{2,8,31}, @ecma167{2,9,32}, @udf260{2.1.7,25}.
2104	*
2105	* @{ */
2106
2107	/** The type value used for all the extended UDF volume descriptors
2108	* (ISO9660VOLDESCHDR::bDescType). */
2109	#define UDF_EXT_VOL_DESC_TYPE 0
2110	/** The version value used for all the extended UDF volume descriptors
2111	* (ISO9660VOLDESCHDR::bDescVersion). */
2112	#define UDF_EXT_VOL_DESC_VERSION 1
2113
2114	/** Standard ID for UDFEXTVOLDESCBEGIN. */
2115	#define UDF_EXT_VOL_DESC_STD_ID_BEGIN "BEA01"
2116	/** Standard ID for UDFEXTVOLDESCTERM. */
2117	#define UDF_EXT_VOL_DESC_STD_ID_TERM "TEA01"
2118	/** Standard ID for UDFEXTVOLDESCNSR following ECMA-167 2nd edition. */
2119	#define UDF_EXT_VOL_DESC_STD_ID_NSR_02 "NSR02"
2120	/** Standard ID for UDFEXTVOLDESCNSR following ECMA-167 3rd edition. */
2121	#define UDF_EXT_VOL_DESC_STD_ID_NSR_03 "NSR03"
2122	/** Standard ID for UDFEXTVOLDESCBOOT. */
2123	#define UDF_EXT_VOL_DESC_STD_ID_BOOT "BOOT2"
2124
2125
2126	/**
2127	* Begin UDF extended volume descriptor area (@ecma167{2,9.2,33}).
2128	*/
2129	typedef struct UDFEXTVOLDESCBEGIN
2130	{
2131	/** The volume descriptor header.
2132	* The standard identifier is UDF_EXT_VOL_DESC_STD_ID_BEGIN. */
2133	ISO9660VOLDESCHDR Hdr;
2134	/** Zero payload. */
2135	uint8_t abZero[2041];
2136	} UDFEXTVOLDESCBEGIN;
2137	AssertCompileSize(UDFEXTVOLDESCBEGIN, 2048);
2138	/** Pointer to an UDF extended volume descriptor indicating the start of the
2139	* extended descriptor area. */
2140	typedef UDFEXTVOLDESCBEGIN *PUDFEXTVOLDESCBEGIN;
2141	/** Pointer to a const UDF extended volume descriptor indicating the start of
2142	* the extended descriptor area. */
2143	typedef UDFEXTVOLDESCBEGIN const *PCUDFEXTVOLDESCBEGIN;
2144
2145
2146	/**
2147	* Terminate UDF extended volume descriptor area (@ecma167{2,9.3,33}).
2148	*/
2149	typedef struct UDFEXTVOLDESCTERM
2150	{
2151	/** The volume descriptor header.
2152	* The standard identifier is UDF_EXT_VOL_DESC_STD_ID_TERM. */
2153	ISO9660VOLDESCHDR Hdr;
2154	/** Zero payload. */
2155	uint8_t abZero[2041];
2156	} UDFEXTVOLDESCTERM;
2157	AssertCompileSize(UDFEXTVOLDESCTERM, 2048);
2158	/** Pointer to an UDF extended volume descriptor indicating the end of the
2159	* extended descriptor area. */
2160	typedef UDFEXTVOLDESCTERM *PUDFEXTVOLDESCTERM;
2161	/** Pointer to a const UDF extended volume descriptor indicating the end of
2162	* the extended descriptor area. */
2163	typedef UDFEXTVOLDESCTERM const *PCUDFEXTVOLDESCTERM;
2164
2165
2166	/**
2167	* UDF NSR extended volume descriptor (@ecma167{3,9.1,50}).
2168	*
2169	* This gives the ECMA standard version.
2170	*/
2171	typedef struct UDFEXTVOLDESCNSR
2172	{
2173	/** The volume descriptor header.
2174	* The standard identifier is UDF_EXT_VOL_DESC_STD_ID_NSR_02, or
2175	* UDF_EXT_VOL_DESC_STD_ID_NSR_03. */
2176	ISO9660VOLDESCHDR Hdr;
2177	/** Zero payload. */
2178	uint8_t abZero[2041];
2179	} UDFEXTVOLDESCNSR;
2180	AssertCompileSize(UDFEXTVOLDESCNSR, 2048);
2181	/** Pointer to an extended volume descriptor giving the UDF standard version. */
2182	typedef UDFEXTVOLDESCNSR *PUDFEXTVOLDESCNSR;
2183	/** Pointer to a const extended volume descriptor giving the UDF standard version. */
2184	typedef UDFEXTVOLDESCNSR const *PCUDFEXTVOLDESCNSR;
2185
2186
2187	/**
2188	* UDF boot extended volume descriptor (@ecma167{2,9.4,34}).
2189	*
2190	* @note Probably entirely unused.
2191	*/
2192	typedef struct UDFEXTVOLDESCBOOT
2193	{
2194	/** 0x00: The volume descriptor header.
2195	* The standard identifier is UDF_EXT_VOL_DESC_STD_ID_BOOT. */
2196	ISO9660VOLDESCHDR Hdr;
2197	/** 0x07: Reserved/alignment, MBZ. */
2198	uint8_t bReserved1;
2199	/** 0x08: The architecture type. */
2200	UDFENTITYID ArchType;
2201	/** 0x28: The boot identifier. */
2202	UDFENTITYID idBoot;
2203	/** 0x48: Logical sector number of load the boot loader from. */
2204	uint32_t offBootExtent;
2205	/** 0x4c: Number of bytes to load. */
2206	uint32_t cbBootExtent;
2207	/** 0x50: The load address (in memory). */
2208	uint64_t uLoadAddress;
2209	/** 0x58: The start address (in memory). */
2210	uint64_t uStartAddress;
2211	/** 0x60: The descriptor creation timestamp. */
2212	UDFTIMESTAMP CreationTimestamp;
2213	/** 0x6c: Flags. */
2214	uint16_t fFlags;
2215	/** 0x6e: Reserved, MBZ. */
2216	uint8_t abReserved2[32];
2217	/** 0x8e: Implementation use. */
2218	uint8_t abBootUse[1906];
2219	} UDFEXTVOLDESCBOOT;
2220	AssertCompileSize(UDFEXTVOLDESCBOOT, 2048);
2221	/** Pointer to a boot extended volume descriptor. */
2222	typedef UDFEXTVOLDESCBOOT *PUDFEXTVOLDESCBOOT;
2223	/** Pointer to a const boot extended volume descriptor. */
2224	typedef UDFEXTVOLDESCBOOT const *PCUDFEXTVOLDESCBOOT;
2225
2226	/** @} */
2227
2228
2229	/** @} */
2230
2231	#endif /* !IPRT_INCLUDED_formats_udf_h */
2232

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: vbox/trunk/include/iprt/formats/udf.h

Download in other formats: