summaryrefslogtreecommitdiffstats
path: root/include/iprt/formats/iso9660.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 16:49:04 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 16:49:04 +0000
commit16f504a9dca3fe3b70568f67b7d41241ae485288 (patch)
treec60f36ada0496ba928b7161059ba5ab1ab224f9d /include/iprt/formats/iso9660.h
parentInitial commit. (diff)
downloadvirtualbox-16f504a9dca3fe3b70568f67b7d41241ae485288.tar.xz
virtualbox-16f504a9dca3fe3b70568f67b7d41241ae485288.zip
Adding upstream version 7.0.6-dfsg.upstream/7.0.6-dfsgupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'include/iprt/formats/iso9660.h')
-rw-r--r--include/iprt/formats/iso9660.h1516
1 files changed, 1516 insertions, 0 deletions
diff --git a/include/iprt/formats/iso9660.h b/include/iprt/formats/iso9660.h
new file mode 100644
index 00000000..6b3e7192
--- /dev/null
+++ b/include/iprt/formats/iso9660.h
@@ -0,0 +1,1516 @@
+/* $Id: iso9660.h $ */
+/** @file
+ * IPRT, ISO 9660 File System
+ */
+
+/*
+ * Copyright (C) 2017-2022 Oracle and/or its affiliates.
+ *
+ * This file is part of VirtualBox base platform packages, as
+ * available from https://www.virtualbox.org.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, in version 3 of the
+ * License.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, see <https://www.gnu.org/licenses>.
+ *
+ * The contents of this file may alternatively be used under the terms
+ * of the Common Development and Distribution License Version 1.0
+ * (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
+ * in the VirtualBox distribution, in which case the provisions of the
+ * CDDL are applicable instead of those of the GPL.
+ *
+ * You may elect to license modified versions of this file under the
+ * terms and conditions of either the GPL or the CDDL or both.
+ *
+ * SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
+ */
+
+#ifndef IPRT_INCLUDED_formats_iso9660_h
+#define IPRT_INCLUDED_formats_iso9660_h
+#ifndef RT_WITHOUT_PRAGMA_ONCE
+# pragma once
+#endif
+
+#include <iprt/types.h>
+#include <iprt/assertcompile.h>
+
+
+/** @defgroup grp_rt_formats_iso9660 ISO 9660 structures and definitions
+ * @ingroup grp_rt_formats
+ * @{
+ */
+
+
+/** The (default) logical sectors size of ISO 9660. */
+#define ISO9660_SECTOR_SIZE 2048
+/** The (default) sector offset mask of ISO 9660. */
+#define ISO9660_SECTOR_OFFSET_MASK 2047
+/** Maximum filename length (level 2 & 3). */
+#define ISO9660_MAX_NAME_LEN 30
+
+
+/** Accessor for ISO9660U16 and ISO9660U32 that retrievs the member value for
+ * the host endianess. */
+#ifdef RT_BIG_ENDIAN
+# define ISO9660_GET_ENDIAN(a_pInt) ((a_pInt)->be)
+#else
+# define ISO9660_GET_ENDIAN(a_pInt) ((a_pInt)->le)
+#endif
+
+
+/**
+ * ISO 9660 16-bit unsigned integer type.
+ */
+typedef struct ISO9660U16
+{
+ /** Little endian. */
+ uint16_t le;
+ /** Big endian. */
+ uint16_t be;
+} ISO9660U16;
+/** Pointer to an ISO 9660 16-bit unsigned integer type. */
+typedef ISO9660U16 *PISO9660U16;
+/** Pointer to a const ISO 9660 16-bit unsigned integer type. */
+typedef ISO9660U16 const *PCISO9660U16;
+
+/** ISO 9660 big endian 16-bit unsigned integer. */
+typedef uint16_t ISO9660U16BE;
+
+
+/**
+ * ISO 9660 32-bit unsigned integer type.
+ */
+typedef struct ISO9660U32
+{
+ /** Little endian. */
+ uint32_t le;
+ /** Big endian. */
+ uint32_t be;
+} ISO9660U32;
+/** Pointer to an ISO 9660 32-bit unsigned integer type. */
+typedef ISO9660U32 *PISO9660U32;
+/** Pointer to a const ISO 9660 32-bit unsigned integer type. */
+typedef ISO9660U32 const *PCISO9660U32;
+
+/** ISO 9660 little endian 32-bit unsigned integer. */
+typedef uint32_t ISO9660U32LE;
+/** ISO 9660 big endian 32-bit unsigned integer. */
+typedef uint32_t ISO9660U32BE;
+
+/**
+ * ISO 9660 timestamp (date & time).
+ */
+typedef struct ISO9660TIMESTAMP
+{
+ /** 0x00: For digit year (0001-9999). */
+ char achYear[4];
+ /** 0x04: Month of the year (01-12). */
+ char achMonth[2];
+ /** 0x06: Day of month (01-31). */
+ char achDay[2];
+ /** 0x08: Hour of day (00-23). */
+ char achHour[2];
+ /** 0x0a: Minute of hour (00-59). */
+ char achMinute[2];
+ /** 0x0c: Second of minute (00-59). */
+ char achSecond[2];
+ /** 0x0e: Hundreth of second (00-99). */
+ char achCentisecond[2];
+ /** 0x10: The UTC (GMT) offset in 15 min units. */
+ int8_t offUtc;
+} ISO9660TIMESTAMP;
+AssertCompileSize(ISO9660TIMESTAMP, 17);
+/** Pointer to an ISO 9660 timestamp. */
+typedef ISO9660TIMESTAMP *PISO9660TIMESTAMP;
+/** Pointer to a const ISO 9660 timestamp. */
+typedef ISO9660TIMESTAMP const *PCISO9660TIMESTAMP;
+
+/**
+ * ISO 9660 record timestamp (date & time).
+ */
+typedef struct ISO9660RECTIMESTAMP
+{
+ /** 0: Years since 1900. */
+ uint8_t bYear;
+ /** 1: Month of year (1-12). */
+ uint8_t bMonth;
+ /** 2: Day of month (1-31). */
+ uint8_t bDay;
+ /** 3: Hour of day (0-23). */
+ uint8_t bHour;
+ /** 4: Minute of hour (0-59). */
+ uint8_t bMinute;
+ /** 5: Second of minute (0-59). */
+ uint8_t bSecond;
+ /** 6: The UTC (GMT) offset in 15 min units. */
+ int8_t offUtc;
+} ISO9660RECTIMESTAMP;
+AssertCompileSize(ISO9660RECTIMESTAMP, 7);
+/** Pointer to an ISO 9660 record timestamp. */
+typedef ISO9660RECTIMESTAMP *PISO9660RECTIMESTAMP;
+/** Pointer to a const ISO 9660 record timestamp. */
+typedef ISO9660RECTIMESTAMP const *PCISO9660RECTIMESTAMP;
+
+
+/**
+ * ISO 9660 directory record.
+ */
+#pragma pack(1)
+typedef struct ISO9660DIRREC
+{
+ /** 0x00: Length of this record in bytes. */
+ uint8_t cbDirRec;
+ /** 0x01: Extended attribute record length in logical blocks. */
+ uint8_t cExtAttrBlocks;
+ /** 0x02: Location of extent (logical block number).
+ * @note Misaligned. */
+ ISO9660U32 offExtent;
+ /** 0x0a: Size of the data (file section). Does not include EAs.
+ * @note Misaligned. */
+ ISO9660U32 cbData;
+ /** 0x12: Recording time and date. */
+ ISO9660RECTIMESTAMP RecTime;
+ /** 0x19: File flags (ISO9660_FILE_FLAGS_XXX). */
+ uint8_t fFileFlags;
+ /** 0x1a: File unit size for interlaved mode. */
+ uint8_t bFileUnitSize;
+ /** 0x1b: Interlave gap size. */
+ uint8_t bInterleaveGapSize;
+ /** 0x1c: Volume sequence number where the extent resides. */
+ ISO9660U16 VolumeSeqNo;
+ /** 0x20: Length of file identifier field. */
+ uint8_t bFileIdLength;
+ /** 0x21: File identifier (d-characters or d1-characters). */
+ char achFileId[1];
+ /* There are more fields following:
+ * - one byte optional padding so the following field is at an even boundrary.
+ * - system use field until cbDirRec is reached.
+ */
+} ISO9660DIRREC;
+#pragma pack()
+AssertCompileMemberOffset(ISO9660DIRREC, offExtent, 0x02);
+AssertCompileMemberOffset(ISO9660DIRREC, cbData, 0x0a);
+AssertCompileMemberOffset(ISO9660DIRREC, RecTime, 0x12);
+AssertCompileMemberOffset(ISO9660DIRREC, fFileFlags, 0x19);
+AssertCompileMemberOffset(ISO9660DIRREC, bFileIdLength, 0x20);
+AssertCompileMemberOffset(ISO9660DIRREC, achFileId, 0x21);
+/** Pointer to an ISO 9660 directory record. */
+typedef ISO9660DIRREC *PISO9660DIRREC;
+/** Pointer to a const ISO 9660 directory record. */
+typedef ISO9660DIRREC const *PCISO9660DIRREC;
+
+/** @name ISO9660_FILE_FLAGS_XXX
+ * @{ */
+/** Existence - Hide the file from the user. */
+#define ISO9660_FILE_FLAGS_HIDDEN UINT8_C(0x01)
+/** Directory - Indicates a directory as apposed to a regular file (0). */
+#define ISO9660_FILE_FLAGS_DIRECTORY UINT8_C(0x02)
+/** Assocated File - Indicates that the file is an associated file. */
+#define ISO9660_FILE_FLAGS_ASSOCIATED_FILE UINT8_C(0x04)
+/** Record - Indicates specified file content record format (see EAs). */
+#define ISO9660_FILE_FLAGS_RECORD UINT8_C(0x08)
+/** Protection - Indicates owner/group or permission protection in EAs. */
+#define ISO9660_FILE_FLAGS_PROTECTION UINT8_C(0x10)
+/** Reserved bit, MBZ. */
+#define ISO9660_FILE_FLAGS_RESERVED_5 UINT8_C(0x20)
+/** Reserved bit, MBZ. */
+#define ISO9660_FILE_FLAGS_RESERVED_6 UINT8_C(0x40)
+/** Multi-extend - Indicates that this isn't the final record for the file.
+ * @remarks Use for working around 4 GiB file size limitation. */
+#define ISO9660_FILE_FLAGS_MULTI_EXTENT UINT8_C(0x80)
+/** @} */
+
+
+/**
+ * ISO 9660 path table record.
+ */
+#pragma pack(1)
+typedef struct ISO9660PATHREC
+{
+ /** 0x00: Length of the achDirId field in bytes. */
+ uint8_t cbDirId;
+ /** 0x01: Extended attribute record length in bytes? */
+ uint8_t cbExtAttr;
+ /** 0x02: Location of extent (logical block number).
+ * @note Endianess depends on table.
+ * @note Misaligned. */
+ uint32_t offExtent;
+ /** 0x06: Parent directory number.
+ * @note Endianess depends on table. */
+ uint16_t idParentRec;
+ /** 0x08: Directory identifier (d-characters or d1-characters). */
+ RT_FLEXIBLE_ARRAY_EXTENSION
+ char achDirId[RT_FLEXIBLE_ARRAY];
+ /* There will be a zero padding byte following if the directory identifier length is odd. */
+} ISO9660PATHREC;
+#pragma pack()
+AssertCompileMemberOffset(ISO9660PATHREC, cbExtAttr, 0x01);
+AssertCompileMemberOffset(ISO9660PATHREC, offExtent, 0x02);
+AssertCompileMemberOffset(ISO9660PATHREC, idParentRec, 0x06);
+AssertCompileMemberOffset(ISO9660PATHREC, achDirId, 0x08);
+/** Pointer to an ISO 9660 path table record. */
+typedef ISO9660PATHREC *PISO9660PATHREC;
+/** Pointer to a const ISO 9660 path table record. */
+typedef ISO9660PATHREC const *PCISO9660PATHREC;
+
+
+/**
+ * ISO 9660 extended attribute record.
+ */
+typedef struct ISO9660EXATTRREC
+{
+ /** 0x000: The owner ID. */
+ ISO9660U16 idOwner;
+ /** 0x004: The group ID. */
+ ISO9660U16 idGroup;
+ /** 0x008: File permissions (ISO9660_PERM_XXX). */
+ ISO9660U16BE fPermissions;
+ /** 0x00a: File creation timestamp. */
+ ISO9660TIMESTAMP BirthTimestamp;
+ /** 0x01b: File modification timestamp. */
+ ISO9660TIMESTAMP ModifyTimestamp;
+ /** 0x02c: File expiration timestamp. */
+ ISO9660TIMESTAMP ExpireTimestamp;
+ /** 0x03d: File effective timestamp. */
+ ISO9660TIMESTAMP EffectiveTimestamp;
+ /** 0x04e: Record format. */
+ uint8_t bRecordFormat;
+ /** 0x04f: Record attributes. */
+ uint8_t fRecordAttrib;
+ /** 0x050: Record length. */
+ ISO9660U16 RecordLength;
+ /** 0x054: System identifier (a-characters or a1-characters). */
+ char achSystemId[0x20];
+ /** 0x074: System specific bytes. */
+ uint8_t abSystemUse[64];
+ /** 0x0b4: Extended attribute record version (ISO9660EXATTRREC_VERSION). */
+ uint8_t bExtRecVersion;
+ /** 0x0b5: Length of escape sequences. */
+ uint8_t cbEscapeSequences;
+ /** 0x0b6: Reserved for the future, MBZ. */
+ uint8_t abReserved183[64];
+ /** 0x0f6: Length of the application use field. */
+ ISO9660U16 cbAppUse;
+ /** 0x0fa: Variable sized application use field. */
+ RT_FLEXIBLE_ARRAY_EXTENSION
+ uint8_t abAppUse[RT_FLEXIBLE_ARRAY];
+ /* This is followed by escape sequences with length given by cbEscapeSequnces. */
+} ISO9660EXATTRREC;
+AssertCompileMemberOffset(ISO9660EXATTRREC, EffectiveTimestamp, 0x03d);
+AssertCompileMemberOffset(ISO9660EXATTRREC, cbAppUse, 0x0f6);
+
+/** The ISO9660EXATTRREC::bExtRecVersion value. */
+#define ISO9660EXATTRREC_VERSION UINT8_C(0x01)
+
+/** @name ISO9660_PERM_XXX - ISO9660EXATTRREC::fPermissions
+ * @{ */
+/** @todo figure out this weird permission stuff... */
+/** @} */
+
+
+/**
+ * ISO 9660 volume descriptor header.
+ */
+typedef struct ISO9660VOLDESCHDR
+{
+ /** Descriptor type ISO9660VOLDESC_TYPE_XXX. */
+ uint8_t bDescType;
+ /** Standard identifier 'CD001' */
+ uint8_t achStdId[5];
+ /** The descriptor version. */
+ uint8_t bDescVersion;
+ /* (This is followed by the descriptor specific data). */
+} ISO9660VOLDESCHDR;
+AssertCompileSize(ISO9660VOLDESCHDR, 7);
+/** Pointer to a volume descriptor header. */
+typedef ISO9660VOLDESCHDR *PISO9660VOLDESCHDR;
+/** Pointer to a const volume descriptor header. */
+typedef ISO9660VOLDESCHDR const *PCISO9660VOLDESCHDR;
+
+/** @name ISO9660VOLDESC_TYPE_XXX - volume descriptor types
+ * @{ */
+/** See ISO9660BOOTRECORD. */
+#define ISO9660VOLDESC_TYPE_BOOT_RECORD UINT8_C(0x00)
+/** See ISO9660PRIMARYVOLDESC. */
+#define ISO9660VOLDESC_TYPE_PRIMARY UINT8_C(0x01)
+/** See ISO9660SUPVOLDESC. */
+#define ISO9660VOLDESC_TYPE_SUPPLEMENTARY UINT8_C(0x02)
+/** See ISO9660VOLPARTDESC. */
+#define ISO9660VOLDESC_TYPE_PARTITION UINT8_C(0x03)
+/** Terminates the volume descriptor set. Has no data (zeros), version is 1. */
+#define ISO9660VOLDESC_TYPE_TERMINATOR UINT8_C(0xff)
+/** @} */
+
+/** The value of ISO9660VOLDESCHDR::achStdId */
+#define ISO9660VOLDESC_STD_ID "CD001"
+#define ISO9660VOLDESC_STD_ID_0 'C'
+#define ISO9660VOLDESC_STD_ID_1 'D'
+#define ISO9660VOLDESC_STD_ID_2 '0'
+#define ISO9660VOLDESC_STD_ID_3 '0'
+#define ISO9660VOLDESC_STD_ID_4 '1'
+
+
+
+/**
+ * ISO 9660 boot record (volume descriptor).
+ */
+typedef struct ISO9660BOOTRECORD
+{
+ /** The volume descriptor header.
+ * Type is ISO9660VOLDESC_TYPE_BOOT_RECORD and version
+ * ISO9660BOOTRECORD_VERSION. */
+ ISO9660VOLDESCHDR Hdr;
+ /** Boot system identifier string (a-characters). */
+ char achBootSystemId[32];
+ /** Boot identifier (a-characters). */
+ char achBootId[32];
+ /** Boot system specific content. */
+ uint8_t abBootSystemSpecific[1977];
+} ISO9660BOOTRECORD;
+AssertCompileSize(ISO9660BOOTRECORD, ISO9660_SECTOR_SIZE);
+/** Pointer to an ISO 9660 boot record. */
+typedef ISO9660BOOTRECORD *PISO9660BOOTRECORD;
+/** Pointer to a const ISO 9660 boot record. */
+typedef ISO9660BOOTRECORD const *PCISO9660BOOTRECORD;
+
+/** The value of ISO9660BOOTRECORD::Hdr.uDescVersion. */
+#define ISO9660BOOTRECORD_VERSION UINT8_C(1)
+
+
+/**
+ * ISO 9660 boot record (volume descriptor), El Torito variant.
+ */
+#pragma pack(1)
+typedef struct ISO9660BOOTRECORDELTORITO
+{
+ /** 0x000: The volume descriptor header.
+ * Type is ISO9660VOLDESC_TYPE_BOOT_RECORD and version
+ * ISO9660BOOTRECORD_VERSION. */
+ ISO9660VOLDESCHDR Hdr;
+ /** 0x007: Boot system identifier string,
+ * zero padded ISO9660BOOTRECORDELTORITO_BOOT_SYSTEM_ID. */
+ char achBootSystemId[32];
+ /** 0x027: Boot identifier - all zeros. */
+ char achBootId[32];
+ /** 0x047: Boot catalog location (block offset), always (?) little endian.
+ * @note Misaligned. */
+ uint32_t offBootCatalog;
+ /** 0x04b: Unused - all zeros. */
+ uint8_t abBootSystemSpecific[1973];
+} ISO9660BOOTRECORDELTORITO;
+#pragma pack()
+AssertCompileSize(ISO9660BOOTRECORDELTORITO, ISO9660_SECTOR_SIZE);
+/** Pointer to an ISO 9660 El Torito boot record. */
+typedef ISO9660BOOTRECORDELTORITO *PISO9660BOOTRECORDELTORITO;
+/** Pointer to a const ISO 9660 El Torito boot record. */
+typedef ISO9660BOOTRECORDELTORITO const *PCISO9660BOOTRECORDELTORITO;
+
+/** The value of ISO9660BOOTRECORDELTORITO::achBootSystemId (zero padded). */
+#define ISO9660BOOTRECORDELTORITO_BOOT_SYSTEM_ID "EL TORITO SPECIFICATION"
+
+
+/**
+ * ISO 9660 primary volume descriptor.
+ */
+typedef struct ISO9660PRIMARYVOLDESC
+{
+ /** 0x000: The volume descriptor header.
+ * Type is ISO9660VOLDESC_TYPE_PRIMARY and version
+ * ISO9660PRIMARYVOLDESC_VERSION. */
+ ISO9660VOLDESCHDR Hdr;
+ /** 0x007: Explicit alignment zero padding. */
+ uint8_t bPadding8;
+ /** 0x008: System identifier (a-characters). */
+ char achSystemId[32];
+ /** 0x028: Volume identifier (d-characters). */
+ char achVolumeId[32];
+ /** 0x048: Unused field, zero filled. */
+ ISO9660U32 Unused73;
+ /** 0x050: Volume space size in logical blocks (cbLogicalBlock). */
+ ISO9660U32 VolumeSpaceSize;
+ /** 0x058: Unused field(s), zero filled. */
+ uint8_t abUnused89[32];
+ /** 0x078: The number of volumes in the volume set. */
+ ISO9660U16 cVolumesInSet;
+ /** 0x07c: Volume sequence number. */
+ ISO9660U16 VolumeSeqNo;
+ /** 0x080: Logical block size in bytes. */
+ ISO9660U16 cbLogicalBlock;
+ /** 0x084: Path table size. */
+ ISO9660U32 cbPathTable;
+ /** 0x08c: Type L(ittle endian) path table location (block offset). */
+ ISO9660U32LE offTypeLPathTable;
+ /** 0x090: Optional type L(ittle endian) path table location (block offset). */
+ ISO9660U32LE offOptionalTypeLPathTable;
+ /** 0x094: Type M (big endian) path table location (block offset). */
+ ISO9660U32BE offTypeMPathTable;
+ /** 0x098: Optional type M (big endian) path table location (block offset). */
+ ISO9660U32BE offOptionalTypeMPathTable;
+ /** 0x09c: Directory entry for the root directory (union). */
+ union
+ {
+ uint8_t ab[34];
+ ISO9660DIRREC DirRec;
+ } RootDir;
+ /** 0x0be: Volume set identifier (d-characters). */
+ char achVolumeSetId[128];
+ /** 0x13e: Publisher identifier (a-characters). Alternatively, it may refere to
+ * a file in the root dir if it starts with 0x5f and restricts itself to 8
+ * d-characters. */
+ char achPublisherId[128];
+ /** 0x1be: Data preparer identifier (a-characters).
+ * Same file reference alternative as previous field. */
+ char achDataPreparerId[128];
+ /** 0x23e: Application identifier (a-characters).
+ * Same file reference alternative as previous field. */
+ char achApplicationId[128];
+ /** 0x2be: Copyright (root) file identifier (d-characters).
+ * All spaces if none. */
+ char achCopyrightFileId[37];
+ /** 0x2e3: Abstract (root) file identifier (d-characters).
+ * All spaces if none. */
+ char achAbstractFileId[37];
+ /** 0x308: Bibliographic file identifier (d-characters).
+ * All spaces if none. */
+ char achBibliographicFileId[37];
+ /** 0x32d: Volume creation date and time. */
+ ISO9660TIMESTAMP BirthTime;
+ /** 0x33e: Volume modification date and time. */
+ ISO9660TIMESTAMP ModifyTime;
+ /** 0x34f: Volume (data) expiration date and time.
+ * If not specified, don't regard data as obsolete. */
+ ISO9660TIMESTAMP ExpireTime;
+ /** 0x360: Volume (data) effective date and time.
+ * If not specified, info can be used immediately. */
+ ISO9660TIMESTAMP EffectiveTime;
+ /** 0x371: File structure version (ISO9660_FILE_STRUCTURE_VERSION). */
+ uint8_t bFileStructureVersion;
+ /** 0x372: Reserve for future, MBZ. */
+ uint8_t bReserved883;
+ /** 0x373: Reserve for future.
+ * mkisofs & genisoimage & libisofs seems to space pad this most of the time.
+ * Microsoft image (2.56) zero pads it. isomd5sum uses it to store checksum
+ * info for the iso and space pads it. */
+ uint8_t abAppUse[512];
+ /** 0x573: Reserved for future standardization, MBZ. */
+ uint8_t abReserved1396[653];
+} ISO9660PRIMARYVOLDESC;
+AssertCompileSize(ISO9660PRIMARYVOLDESC, ISO9660_SECTOR_SIZE);
+/** Pointer to a ISO 9660 primary volume descriptor. */
+typedef ISO9660PRIMARYVOLDESC *PISO9660PRIMARYVOLDESC;
+/** Pointer to a const ISO 9660 primary volume descriptor. */
+typedef ISO9660PRIMARYVOLDESC const *PCISO9660PRIMARYVOLDESC;
+
+/** The value of ISO9660PRIMARYVOLDESC::Hdr.uDescVersion. */
+#define ISO9660PRIMARYVOLDESC_VERSION UINT8_C(1)
+/** The value of ISO9660PRIMARYVOLDESC::bFileStructureVersion and
+ * ISO9660SUPVOLDESC::bFileStructureVersion. */
+#define ISO9660_FILE_STRUCTURE_VERSION UINT8_C(1)
+
+
+
+/**
+ * ISO 9660 supplementary volume descriptor.
+ *
+ * This is in the large parts identicial to the primary descriptor, except it
+ * have a few more fields where the primary one has reserved spaces.
+ */
+typedef struct ISO9660SUPVOLDESC
+{
+ /** 0x000: The volume descriptor header.
+ * Type is ISO9660VOLDESC_TYPE_SUPPLEMENTARY and version
+ * ISO9660SUPVOLDESC_VERSION. */
+ ISO9660VOLDESCHDR Hdr;
+ /** 0x007: Volume flags (ISO9660SUPVOLDESC_VOL_F_XXX).
+ * @note This is reserved in the primary volume descriptor. */
+ uint8_t fVolumeFlags;
+ /** 0x008: System identifier (a1-characters) of system that can act upon
+ * sectors 0 thru 15.
+ * @note Purpose differs from primary description. */
+ char achSystemId[32];
+ /** 0x028: Volume identifier (d1-characters).
+ * @note Character set differs from primary description. */
+ char achVolumeId[32];
+ /** 0x048: Unused field, zero filled. */
+ ISO9660U32 Unused73;
+ /** 0x050: Volume space size in logical blocks (cbLogicalBlock). */
+ ISO9660U32 VolumeSpaceSize;
+ /** 0x058: Escape sequences.
+ * Complicated stuff, see ISO 2022 and ECMA-35.
+ * @note This is reserved in the primary volume descriptor. */
+ uint8_t abEscapeSequences[32];
+ /** 0x078: The number of volumes in the volume set. */
+ ISO9660U16 cVolumesInSet;
+ /** 0x07c: Volume sequence number. */
+ ISO9660U16 VolumeSeqNo;
+ /** 0x080: Logical block size in bytes. */
+ ISO9660U16 cbLogicalBlock;
+ /** 0x084: Path table size. */
+ ISO9660U32 cbPathTable;
+ /** 0x08c: Type L(ittle endian) path table location (block offset). */
+ ISO9660U32LE offTypeLPathTable;
+ /** 0x090: Optional type L(ittle endian) path table location (block offset). */
+ ISO9660U32LE offOptionalTypeLPathTable;
+ /** 0x094: Type M (big endian) path table location (block offset). */
+ ISO9660U32BE offTypeMPathTable;
+ /** 0x098: Optional type M (big endian) path table location (block offset). */
+ ISO9660U32BE offOptionalTypeMPathTable;
+ /** 0x09c: Directory entry for the root directory (union). */
+ union
+ {
+ uint8_t ab[34];
+ ISO9660DIRREC DirRec;
+ } RootDir;
+ /** 0x0be: Volume set identifier (d1-characters).
+ * @note Character set differs from primary description. */
+ char achVolumeSetId[128];
+ /** 0x13e: Publisher identifier (a1-characters). Alternatively, it may refere
+ * to a file in the root dir if it starts with 0x5f and restricts itself to 8
+ * d1-characters.
+ * @note Character set differs from primary description. */
+ char achPublisherId[128];
+ /** 0x1be: Data preparer identifier (a1-characters).
+ * Same file reference alternative as previous field.
+ * @note Character set differs from primary description. */
+ char achDataPreparerId[128];
+ /** 0x23e: Application identifier (a1-characters).
+ * Same file reference alternative as previous field.
+ * @note Character set differs from primary description. */
+ char achApplicationId[128];
+ /** 0x2be: Copyright (root) file identifier (d1-characters).
+ * All spaces if none.
+ * @note Character set differs from primary description. */
+ char achCopyrightFileId[37];
+ /** 0x2e3: Abstract (root) file identifier (d1-characters).
+ * All spaces if none.
+ * @note Character set differs from primary description. */
+ char achAbstractFileId[37];
+ /** 0x308: Bibliographic file identifier (d1-characters).
+ * All spaces if none.
+ * @note Character set differs from primary description. */
+ char achBibliographicFileId[37];
+ /** 0x32d: Volume creation date and time. */
+ ISO9660TIMESTAMP BirthTime;
+ /** 0x33e: Volume modification date and time. */
+ ISO9660TIMESTAMP ModifyTime;
+ /** 0x34f: Volume (data) expiration date and time.
+ * If not specified, don't regard data as obsolete. */
+ ISO9660TIMESTAMP ExpireTime;
+ /** 0x360: Volume (data) effective date and time.
+ * If not specified, info can be used immediately. */
+ ISO9660TIMESTAMP EffectiveTime;
+ /** 0x371: File structure version (ISO9660_FILE_STRUCTURE_VERSION). */
+ uint8_t bFileStructureVersion;
+ /** 0x372: Reserve for future, MBZ. */
+ uint8_t bReserved883;
+ /** 0x373: Reserve for future, MBZ. */
+ uint8_t abAppUse[512];
+ /** 0x573: Reserved for future standardization, MBZ. */
+ uint8_t abReserved1396[653];
+} ISO9660SUPVOLDESC;
+AssertCompileSize(ISO9660SUPVOLDESC, ISO9660_SECTOR_SIZE);
+/** Pointer to a ISO 9660 supplementary volume descriptor. */
+typedef ISO9660SUPVOLDESC *PISO9660SUPVOLDESC;
+/** Pointer to a const ISO 9660 supplementary volume descriptor. */
+typedef ISO9660SUPVOLDESC const *PCISO9660SUPVOLDESC;
+/** The value of ISO9660SUPVOLDESC::Hdr.uDescVersion. */
+#define ISO9660SUPVOLDESC_VERSION UINT8_C(1)
+
+/** @name ISO9660SUPVOLDESC_VOL_F_XXX - ISO9660SUPVOLDESC::fVolumeFlags
+ * @{ */
+#define ISO9660SUPVOLDESC_VOL_F_ESC_ONLY_REG UINT8_C(0x00)
+#define ISO9660SUPVOLDESC_VOL_F_ESC_NOT_REG UINT8_C(0x01)
+/** @} */
+
+
+
+/**
+ * ISO 9660 volume partition descriptor.
+ */
+typedef struct ISO9660VOLPARTDESC
+{
+ /** 0x000: The volume descriptor header.
+ * Type is ISO9660VOLDESC_TYPE_PARTITION and version
+ * ISO9660VOLPARTDESC_VERSION. */
+ ISO9660VOLDESCHDR Hdr;
+ /** 0x007: Alignment padding. */
+ uint8_t bPadding8;
+ /** 0x008: System identifier (a-characters). */
+ char achSystemId[32];
+ /** 0x028: Volume partition identifier (d-characters). */
+ char achVolumePartitionId[32];
+ /** 0x048: The location of the partition (logical block number). */
+ ISO9660U32 offVolumePartition;
+ /** 0x050: The partition size in logical blocks (cbLogicalBlock). */
+ ISO9660U32 VolumePartitionSize;
+ /** 0x058: System specific data. */
+ uint8_t achSystemUse[1960];
+} ISO9660VOLPARTDESC;
+AssertCompileSize(ISO9660VOLPARTDESC, ISO9660_SECTOR_SIZE);
+/** Pointer to an ISO 9660 volume partition description. */
+typedef ISO9660VOLPARTDESC *PISO9660VOLPARTDESC;
+/** Pointer to a const ISO 9660 volume partition description. */
+typedef ISO9660VOLPARTDESC const *PCISO9660VOLPARTDESC;
+/** The value of ISO9660VOLPARTDESC::Hdr.uDescVersion. */
+#define ISO9660VOLPARTDESC_VERSION UINT8_C(1)
+
+
+
+/** @name Joliet escape sequence identifiers.
+ *
+ * These bytes appears in the supplementary volume descriptor field
+ * abEscapeSequences. The ISO9660SUPVOLDESC_VOL_F_ESC_NOT_REG flags will not
+ * be set.
+ *
+ * @{ */
+#define ISO9660_JOLIET_ESC_SEQ_0 UINT8_C(0x25) /**< First escape sequence byte.*/
+#define ISO9660_JOLIET_ESC_SEQ_1 UINT8_C(0x2f) /**< Second escape sequence byte.*/
+#define ISO9660_JOLIET_ESC_SEQ_2_LEVEL_1 UINT8_C(0x40) /**< Third escape sequence byte: level 1 */
+#define ISO9660_JOLIET_ESC_SEQ_2_LEVEL_2 UINT8_C(0x43) /**< Third escape sequence byte: level 2 */
+#define ISO9660_JOLIET_ESC_SEQ_2_LEVEL_3 UINT8_C(0x45) /**< Third escape sequence byte: level 3 */
+/** @} */
+
+
+/** The size of an El Torito boot catalog entry. */
+#define ISO9660_ELTORITO_ENTRY_SIZE UINT32_C(0x20)
+
+/**
+ * El Torito boot catalog: Validation entry.
+ *
+ * This is the first entry in the boot catalog. It is followed by a
+ * ISO9660ELTORITODEFAULTENTRY, which in turn is followed by a
+ * ISO9660ELTORITOSECTIONHEADER.
+ */
+typedef struct ISO9660ELTORITOVALIDATIONENTRY
+{
+ /** 0x00: The header ID (ISO9660_ELTORITO_HEADER_ID_VALIDATION_ENTRY). */
+ uint8_t bHeaderId;
+ /** 0x01: The platform ID (ISO9660_ELTORITO_PLATFORM_ID_XXX). */
+ uint8_t bPlatformId;
+ /** 0x02: Reserved, MBZ. */
+ uint16_t u16Reserved;
+ /** 0x04: String ID of the developer of the CD/DVD-ROM. */
+ char achId[24];
+ /** 0x1c: The checksum. */
+ uint16_t u16Checksum;
+ /** 0x1e: Key byte 1 (ISO9660_ELTORITO_KEY_BYTE_1). */
+ uint8_t bKey1;
+ /** 0x1f: Key byte 2 (ISO9660_ELTORITO_KEY_BYTE_2). */
+ uint8_t bKey2;
+} ISO9660ELTORITOVALIDATIONENTRY;
+AssertCompileSize(ISO9660ELTORITOVALIDATIONENTRY, ISO9660_ELTORITO_ENTRY_SIZE);
+/** Pointer to an El Torito validation entry. */
+typedef ISO9660ELTORITOVALIDATIONENTRY *PISO9660ELTORITOVALIDATIONENTRY;
+/** Pointer to a const El Torito validation entry. */
+typedef ISO9660ELTORITOVALIDATIONENTRY const *PCISO9660ELTORITOVALIDATIONENTRY;
+
+/** ISO9660ELTORITOVALIDATIONENTRY::bKey1 value. */
+#define ISO9660_ELTORITO_KEY_BYTE_1 UINT8_C(0x55)
+/** ISO9660ELTORITOVALIDATIONENTRY::bKey2 value. */
+#define ISO9660_ELTORITO_KEY_BYTE_2 UINT8_C(0xaa)
+
+
+/** @name ISO9660_ELTORITO_HEADER_ID_XXX - header IDs.
+ * @{ */
+/** Header ID for a ISO9660ELTORITOVALIDATIONENTRY. */
+#define ISO9660_ELTORITO_HEADER_ID_VALIDATION_ENTRY UINT8_C(0x01)
+/** Header ID for a ISO9660ELTORITOSECTIONHEADER. */
+#define ISO9660_ELTORITO_HEADER_ID_SECTION_HEADER UINT8_C(0x90)
+/** Header ID for the final ISO9660ELTORITOSECTIONHEADER. */
+#define ISO9660_ELTORITO_HEADER_ID_FINAL_SECTION_HEADER UINT8_C(0x91)
+/** @} */
+
+
+/** @name ISO9660_ELTORITO_PLATFORM_ID_XXX - El Torito Platform IDs
+ * @{ */
+#define ISO9660_ELTORITO_PLATFORM_ID_X86 UINT8_C(0x00) /**< 80x86 */
+#define ISO9660_ELTORITO_PLATFORM_ID_PPC UINT8_C(0x01) /**< PowerPC */
+#define ISO9660_ELTORITO_PLATFORM_ID_MAC UINT8_C(0x02) /**< Mac */
+#define ISO9660_ELTORITO_PLATFORM_ID_EFI UINT8_C(0xef) /**< UEFI */
+/** @} */
+
+
+/**
+ * El Torito boot catalog: Section header entry.
+ *
+ * A non-final section header entry is followed by
+ * ISO9660ELTORITOSECTIONHEADER::cEntries ISO9660ELTORITOSECTIONTENTRY instances.
+ */
+typedef struct ISO9660ELTORITOSECTIONHEADER
+{
+ /** 0x00: Header ID - ISO9660_ELTORITO_HEADER_ID_SECTION_HEADER or
+ * ISO9660_ELTORITO_HEADER_ID_FINAL_SECTION_HEADER (if final). */
+ uint8_t bHeaderId;
+ /** 0x01: The platform ID (ISO9660_ELTORITO_PLATFORM_ID_XXX). */
+ uint8_t bPlatformId;
+ /** 0x02: Number of entries in this section (i.e. following this header). */
+ uint16_t cEntries;
+ /** 0x04: String ID for the section. */
+ char achSectionId[28];
+} ISO9660ELTORITOSECTIONHEADER;
+AssertCompileSize(ISO9660ELTORITOSECTIONHEADER, ISO9660_ELTORITO_ENTRY_SIZE);
+/** Pointer to an El Torito section header entry. */
+typedef ISO9660ELTORITOSECTIONHEADER *PISO9660ELTORITOSECTIONHEADER;
+/** Pointer to a const El Torito section header entry. */
+typedef ISO9660ELTORITOSECTIONHEADER const *PCISO9660ELTORITOSECTIONHEADER;
+
+
+/**
+ * El Torito boot catalog: Default (initial) entry.
+ *
+ * Followed by ISO9660ELTORITOSECTIONHEADER.
+ *
+ * Differs from ISO9660ELTORITOSECTIONENTRY in that it doesn't have a
+ * selection criteria and no media flags (only type).
+ */
+typedef struct ISO9660ELTORITODEFAULTENTRY
+{
+ /** 0x00: Boot indicator (ISO9660_ELTORITO_BOOT_INDICATOR_XXX). */
+ uint8_t bBootIndicator;
+ /** 0x01: Boot media type. The first four bits are defined by
+ * ISO9660_ELTORITO_BOOT_MEDIA_TYPE_XXX, whereas the top four bits MBZ. */
+ uint8_t bBootMediaType;
+ /** 0x02: Load segment - load address divided by 0x10. */
+ uint16_t uLoadSeg;
+ /** 0x04: System type from image partition table. */
+ uint8_t bSystemType;
+ /** 0x05: Unused, MBZ. */
+ uint8_t bUnused;
+ /** 0x06: Number of emulated 512 byte sectors to load. */
+ uint16_t cEmulatedSectorsToLoad;
+ /** 0x08: Image location in the ISO (block offset), always (?) little endian. */
+ uint32_t offBootImage;
+ /** 0x0c: Reserved, MBZ */
+ uint8_t abReserved[20];
+} ISO9660ELTORITODEFAULTENTRY;
+AssertCompileSize(ISO9660ELTORITODEFAULTENTRY, ISO9660_ELTORITO_ENTRY_SIZE);
+/** Pointer to an El Torito default (initial) entry. */
+typedef ISO9660ELTORITODEFAULTENTRY *PISO9660ELTORITODEFAULTENTRY;
+/** Pointer to a const El Torito default (initial) entry. */
+typedef ISO9660ELTORITODEFAULTENTRY const *PCISO9660ELTORITODEFAULTENTRY;
+
+
+/**
+ * El Torito boot catalg: Section entry.
+ */
+typedef struct ISO9660ELTORITOSECTIONENTRY
+{
+ /** 0x00: Boot indicator (ISO9660_ELTORITO_BOOT_INDICATOR_XXX). */
+ uint8_t bBootIndicator;
+ /** 0x01: Boot media type and flags. The first four bits are defined by
+ * ISO9660_ELTORITO_BOOT_MEDIA_TYPE_XXX and the top four bits by
+ * ISO9660_ELTORITO_BOOT_MEDIA_F_XXX. */
+ uint8_t bBootMediaType;
+ /** 0x02: Load segment - load address divided by 0x10. */
+ uint16_t uLoadSeg;
+ /** 0x04: System type from image partition table. */
+ uint8_t bSystemType;
+ /** 0x05: Unused, MBZ. */
+ uint8_t bUnused;
+ /** 0x06: Number of emulated 512 byte sectors to load. */
+ uint16_t cEmulatedSectorsToLoad;
+ /** 0x08: Image location in the ISO (block offset), always (?) little endian. */
+ uint32_t offBootImage;
+ /** 0x0c: Selection criteria type (ISO9660_ELTORITO_SEL_CRIT_TYPE_XXX). */
+ uint8_t bSelectionCriteriaType;
+ /** 0x0c: Selection criteria specific data. */
+ uint8_t abSelectionCriteria[19];
+} ISO9660ELTORITOSECTIONENTRY;
+AssertCompileSize(ISO9660ELTORITOSECTIONENTRY, ISO9660_ELTORITO_ENTRY_SIZE);
+/** Pointer to an El Torito default (initial) entry. */
+typedef ISO9660ELTORITOSECTIONENTRY *PISO9660ELTORITOSECTIONENTRY;
+/** Pointer to a const El Torito default (initial) entry. */
+typedef ISO9660ELTORITOSECTIONENTRY const *PCISO9660ELTORITOSECTIONENTRY;
+
+
+/** @name ISO9660_ELTORITO_BOOT_INDICATOR_XXX - Boot indicators.
+ * @{ */
+#define ISO9660_ELTORITO_BOOT_INDICATOR_BOOTABLE UINT8_C(0x88)
+#define ISO9660_ELTORITO_BOOT_INDICATOR_NOT_BOOTABLE UINT8_C(0x00)
+/** @} */
+
+/** @name ISO9660_ELTORITO_BOOT_MEDIA_TYPE_XXX - Boot media types.
+ * @{ */
+#define ISO9660_ELTORITO_BOOT_MEDIA_TYPE_NO_EMULATION UINT8_C(0x0)
+#define ISO9660_ELTORITO_BOOT_MEDIA_TYPE_FLOPPY_1_2_MB UINT8_C(0x1)
+#define ISO9660_ELTORITO_BOOT_MEDIA_TYPE_FLOPPY_1_44_MB UINT8_C(0x2)
+#define ISO9660_ELTORITO_BOOT_MEDIA_TYPE_FLOPPY_2_88_MB UINT8_C(0x3)
+#define ISO9660_ELTORITO_BOOT_MEDIA_TYPE_HARD_DISK UINT8_C(0x4)
+#define ISO9660_ELTORITO_BOOT_MEDIA_TYPE_MASK UINT8_C(0xf) /**< The media type mask. */
+/** @} */
+
+/** @name ISO9660_ELTORITO_BOOT_MEDIA_F_XXX - Boot media flags.
+ * These only applies to the section entry, not to the default (initial) entry.
+ * @{ */
+#define ISO9660_ELTORITO_BOOT_MEDIA_F_RESERVED UINT8_C(0x10) /**< Reserved bit, MBZ. */
+#define ISO9660_ELTORITO_BOOT_MEDIA_F_CONTINUATION UINT8_C(0x20) /**< Contiunation entry follows. */
+#define ISO9660_ELTORITO_BOOT_MEDIA_F_ATAPI_DRIVER UINT8_C(0x40) /**< Image contains an ATAPI driver. */
+#define ISO9660_ELTORITO_BOOT_MEDIA_F_SCSI_DRIVERS UINT8_C(0x80) /**< Image contains SCSI drivers. */
+#define ISO9660_ELTORITO_BOOT_MEDIA_F_MASK UINT8_C(0xf0) /**< The media/entry flag mask. */
+/** @} */
+
+/** @name ISO9660_ELTORITO_SEL_CRIT_TYPE_XXX - Selection criteria type.
+ * @{ */
+#define ISO9660_ELTORITO_SEL_CRIT_TYPE_NONE UINT8_C(0x00) /**< No selection criteria */
+#define ISO9660_ELTORITO_SEL_CRIT_TYPE_LANG_AND_VERSION UINT8_C(0x01) /**< Language and version (IBM). */
+/** @} */
+
+
+/**
+ * El Torito boot catalog: Section entry extension.
+ *
+ * This is used for carrying additional selection criteria data. It follows
+ * a ISO9660ELTORITOSECTIONENTRY.
+ */
+typedef struct ISO9660ELTORITOSECTIONENTRYEXT
+{
+ /** 0x00: Extension indicator (ISO9660_ELTORITO_SECTION_ENTRY_EXT_ID). */
+ uint8_t bExtensionId;
+ /** 0x01: Selection criteria extension flags (ISO9660_ELTORITO_SECTION_ENTRY_EXT_F_XXX). */
+ uint8_t fFlags;
+ /** 0x02: Selection critiera data. */
+ uint8_t abSelectionCriteria[30];
+} ISO9660ELTORITOSECTIONENTRYEXT;
+AssertCompileSize(ISO9660ELTORITOSECTIONENTRYEXT, ISO9660_ELTORITO_ENTRY_SIZE);
+/** Pointer to an El Torito default (initial) entry. */
+typedef ISO9660ELTORITOSECTIONENTRYEXT *PISO9660ELTORITOSECTIONENTRYEXT;
+/** Pointer to a const El Torito default (initial) entry. */
+typedef ISO9660ELTORITOSECTIONENTRYEXT const *PCISO9660ELTORITOSECTIONENTRYEXT;
+
+/** Value of ISO9660ELTORITOSECTIONENTRYEXT::bExtensionId. */
+#define ISO9660_ELTORITO_SECTION_ENTRY_EXT_ID UINT8_C(0x44)
+
+/** @name ISO9660_ELTORITO_SECTION_ENTRY_EXT_F_XXX - ISO9660ELTORITOSECTIONENTRYEXT::fFlags
+ * @{ */
+#define ISO9660_ELTORITO_SECTION_ENTRY_EXT_F_MORE UINT8_C(0x20) /**< Further extension entries follows. */
+#define ISO9660_ELTORITO_SECTION_ENTRY_EXT_F_UNUSED_MASK UINT8_C(0xef) /**< Mask of all unused bits. */
+/** @} */
+
+
+/**
+ * Boot information table used by isolinux and GRUB2 El Torito boot files.
+ */
+typedef struct ISO9660SYSLINUXINFOTABLE
+{
+ /** 0x00/0x08: Offset of the primary volume descriptor (block offset). */
+ uint32_t offPrimaryVolDesc;
+ /** 0x04/0x0c: Offset of the boot file (block offset). */
+ uint32_t offBootFile;
+ /** 0x08/0x10: Size of the boot file in bytes. */
+ uint32_t cbBootFile;
+ /** 0x0c/0x14: Boot file checksum.
+ * This is the sum of all the 32-bit words in the image, start at the end of
+ * this structure (i.e. offset 64). */
+ uint32_t uChecksum;
+ /** 0x10/0x18: Reserved for future fun. */
+ uint32_t auReserved[10];
+} ISO9660SYSLINUXINFOTABLE;
+AssertCompileSize(ISO9660SYSLINUXINFOTABLE, 56);
+/** Pointer to a syslinux boot information table. */
+typedef ISO9660SYSLINUXINFOTABLE *PISO9660SYSLINUXINFOTABLE;
+/** Pointer to a const syslinux boot information table. */
+typedef ISO9660SYSLINUXINFOTABLE const *PCISO9660SYSLINUXINFOTABLE;
+
+/** The file offset of the isolinux boot info table. */
+#define ISO9660SYSLINUXINFOTABLE_OFFSET 8
+
+
+
+/**
+ * System Use Sharing Protocol Protocol (SUSP) header.
+ */
+typedef struct ISO9660SUSPHDR
+{
+ /** Signature byte 1. */
+ uint8_t bSig1;
+ /** Signature byte 2. */
+ uint8_t bSig2;
+ /** Length of the entry (including the header). */
+ uint8_t cbEntry;
+ /** Entry version number. */
+ uint8_t bVersion;
+} ISO9660SUSPHDR;
+AssertCompileSize(ISO9660SUSPHDR, 4);
+/** Pointer to a SUSP header. */
+typedef ISO9660SUSPHDR *PISO9660SUSPHDR;
+/** Pointer to a const SUSP header. */
+typedef ISO9660SUSPHDR const *PCISO9660SUSPHDR;
+
+
+/**
+ * SUSP continuation entry (CE).
+ */
+typedef struct ISO9660SUSPCE
+{
+ /** Header (ISO9660SUSPCE_SIG1, ISO9660SUSPCE_SIG2, ISO9660SUSPCE_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The offset of the continutation data block (block offset). */
+ ISO9660U32 offBlock;
+ /** The byte offset in the block of the contiuation data. */
+ ISO9660U32 offData;
+ /** The size of the continuation data. */
+ ISO9660U32 cbData;
+} ISO9660SUSPCE;
+/** Pointer to a SUSP continuation entry. */
+typedef ISO9660SUSPCE *PISO9660SUSPCE;
+/** Pointer to a const SUSP continuation entry. */
+typedef ISO9660SUSPCE const *PCISO9660SUSPCE;
+#define ISO9660SUSPCE_SIG1 'C' /**< SUSP continutation entry signature byte 1. */
+#define ISO9660SUSPCE_SIG2 'E' /**< SUSP continutation entry signature byte 2. */
+#define ISO9660SUSPCE_LEN 28 /**< SUSP continutation entry length. */
+#define ISO9660SUSPCE_VER 1 /**< SUSP continutation entry version number. */
+AssertCompileSize(ISO9660SUSPCE, ISO9660SUSPCE_LEN);
+
+
+/**
+ * SUSP padding entry (PD).
+ */
+typedef struct ISO9660SUSPPD
+{
+ /** Header (ISO9660SUSPPD_SIG1, ISO9660SUSPPD_SIG2, ISO9660SUSPPD_VER). */
+ ISO9660SUSPHDR Hdr;
+ /* Padding follows. */
+} ISO9660SUSPPD;
+AssertCompileSize(ISO9660SUSPPD, 4);
+/** Pointer to a SUSP padding entry. */
+typedef ISO9660SUSPPD *PISO9660SUSPPD;
+/** Pointer to a const SUSP padding entry. */
+typedef ISO9660SUSPPD const *PCISO9660SUSPPD;
+#define ISO9660SUSPPD_SIG1 'P' /**< SUSP padding entry signature byte 1. */
+#define ISO9660SUSPPD_SIG2 'D' /**< SUSP padding entry signature byte 2. */
+#define ISO9660SUSPPD_VER 1 /**< SUSP padding entry version number. */
+
+
+/**
+ * SUSP system use protocol entry (SP)
+ *
+ * This is only used in the '.' record of the root directory.
+ */
+typedef struct ISO9660SUSPSP
+{
+ /** Header (ISO9660SUSPSP_SIG1, ISO9660SUSPSP_SIG2,
+ * ISO9660SUSPSP_LEN, ISO9660SUSPSP_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** Check byte 1 (ISO9660SUSPSP_CHECK1). */
+ uint8_t bCheck1;
+ /** Check byte 2 (ISO9660SUSPSP_CHECK2). */
+ uint8_t bCheck2;
+ /** Number of bytes to skip within the system use field of each directory
+ * entry (except the '.' entry of the root, since that's where this is). */
+ uint8_t cbSkip;
+} ISO9660SUSPSP;
+/** Pointer to a SUSP entry. */
+typedef ISO9660SUSPSP *PISO9660SUSPSP;
+/** Pointer to a const SUSP entry. */
+typedef ISO9660SUSPSP const *PCISO9660SUSPSP;
+#define ISO9660SUSPSP_SIG1 'S' /**< SUSP system use protocol entry signature byte 1. */
+#define ISO9660SUSPSP_SIG2 'P' /**< SUSP system use protocol entry signature byte 2. */
+#define ISO9660SUSPSP_VER 1 /**< SUSP system use protocol entry version number. */
+#define ISO9660SUSPSP_LEN 7 /**< SUSP system use protocol entry length (fixed). */
+#define ISO9660SUSPSP_CHECK1 UINT8_C(0xbe) /**< SUSP system use protocol entry check byte 1. */
+#define ISO9660SUSPSP_CHECK2 UINT8_C(0xef) /**< SUSP system use protocol entry check byte 2. */
+AssertCompileSize(ISO9660SUSPSP, ISO9660SUSPSP_LEN);
+
+
+/**
+ * SUSP terminator entry (ST)
+ *
+ * Used to terminate system use entries.
+ */
+typedef struct ISO9660SUSPST
+{
+ /** Header (ISO9660SUSPST_SIG1, ISO9660SUSPST_SIG2,
+ * ISO9660SUSPST_LEN, ISO9660SUSPST_VER). */
+ ISO9660SUSPHDR Hdr;
+} ISO9660SUSPST;
+/** Pointer to a SUSP padding entry. */
+typedef ISO9660SUSPST *PISO9660SUSPST;
+/** Pointer to a const SUSP padding entry. */
+typedef ISO9660SUSPST const *PCISO9660SUSPST;
+#define ISO9660SUSPST_SIG1 'S' /**< SUSP system use protocol entry signature byte 1. */
+#define ISO9660SUSPST_SIG2 'T' /**< SUSP system use protocol entry signature byte 2. */
+#define ISO9660SUSPST_VER 1 /**< SUSP system use protocol entry version number. */
+#define ISO9660SUSPST_LEN 4 /**< SUSP system use protocol entry length (fixed). */
+AssertCompileSize(ISO9660SUSPST, ISO9660SUSPST_LEN);
+
+
+/**
+ * SUSP extension record entry (ER)
+ *
+ * This is only used in the '.' record of the root directory. There can be multiple of these.
+ */
+typedef struct ISO9660SUSPER
+{
+ /** Header (ISO9660SUSPER_SIG1, ISO9660SUSPER_SIG2, ISO9660SUSPER_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The length of the identifier component. */
+ uint8_t cchIdentifier;
+ /** The length of the description component. */
+ uint8_t cchDescription;
+ /** The length of the source component. */
+ uint8_t cchSource;
+ /** The extension version number. */
+ uint8_t bVersion;
+ /** The payload: first @a cchIdentifier chars of identifier string, second
+ * @a cchDescription chars of description string, thrid @a cchSource chars
+ * of source string. Variable length. */
+ char achPayload[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
+} ISO9660SUSPER;
+/** Pointer to a SUSP padding entry. */
+typedef ISO9660SUSPER *PISO9660SUSPER;
+/** Pointer to a const SUSP padding entry. */
+typedef ISO9660SUSPER const *PCISO9660SUSPER;
+#define ISO9660SUSPER_SIG1 'E' /**< SUSP extension record entry signature byte 1. */
+#define ISO9660SUSPER_SIG2 'R' /**< SUSP extension record entry signature byte 2. */
+#define ISO9660SUSPER_VER 1 /**< SUSP extension record entry version number. */
+#define ISO9660SUSPER_OFF_PAYLOAD 8 /**< SUSP extension record entry payload member offset. */
+AssertCompileMemberOffset(ISO9660SUSPER, achPayload, ISO9660SUSPER_OFF_PAYLOAD);
+
+/**
+ * SUSP extension sequence entry (ES)
+ *
+ * This is only used in the '.' record of the root directory.
+ */
+typedef struct ISO9660SUSPES
+{
+ /** Header (ISO9660SUSPES_SIG1, ISO9660SUSPES_SIG2, ISO9660SUSPES_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The ER entry sequence number of the extension comming first. */
+ uint8_t iFirstExtension;
+} ISO9660SUSPES;
+/** Pointer to a SUSP padding entry. */
+typedef ISO9660SUSPES *PISO9660SUSPES;
+/** Pointer to a const SUSP padding entry. */
+typedef ISO9660SUSPES const *PCISO9660SUSPES;
+#define ISO9660SUSPES_SIG1 'E' /**< SUSP extension sequence entry signature byte 1. */
+#define ISO9660SUSPES_SIG2 'S' /**< SUSP extension sequence entry signature byte 2. */
+#define ISO9660SUSPES_VER 1 /**< SUSP extension sequence entry version number. */
+#define ISO9660SUSPES_LEN 5 /**< SUSP extension sequence entry length (fixed). */
+AssertCompileSize(ISO9660SUSPES, ISO9660SUSPES_LEN);
+
+
+/** RRIP ER identifier string from Rock Ridge Interchange Protocol v1.10 specs. */
+#define ISO9660_RRIP_ID "RRIP_1991A"
+/** RRIP ER recommended description string (from RRIP v1.10 specs). */
+#define ISO9660_RRIP_DESC "THE ROCK RIDGE INTERCHANGE PROTOCOL PROVIDES SUPPORT FOR POSIX FILE SYSTEM SEMANTICS"
+/** RRIP ER recommended source string (from RRIP v1.10 specs). */
+#define ISO9660_RRIP_SRC "PLEASE CONTACT DISC PUBLISHER FOR SPECIFICATION SOURCE. SEE PUBLISHER IDENTIFIER IN PRIMARY VOLUME DESCRIPTOR FOR CONTACT INFORMATION."
+/** RRIP ER version field value from the Rock Ridge Interchange Protocol v1.10 specs. */
+#define ISO9660_RRIP_VER 1
+/** The length of a RRIP v1.10 ER record.
+ * The record must be constructed using ISO9660_RRIP_ID, ISO9660_RRIP_DESC
+ * and ISO9660_RRIP_SRC. */
+#define ISO9660_RRIP_ER_LEN ((uint8_t)( ISO9660SUSPER_OFF_PAYLOAD \
+ + sizeof(ISO9660_RRIP_ID) - 1 \
+ + sizeof(ISO9660_RRIP_DESC) - 1 \
+ + sizeof(ISO9660_RRIP_SRC) - 1 ))
+
+/** RRIP ER identifier string from RRIP IEEE P1282 v1.12 draft. */
+#define ISO9660_RRIP_1_12_ID "IEEE_P1282"
+/** RRIP ER recommended description string (RRIP IEEE P1282 v1.12 draft). */
+#define ISO9660_RRIP_1_12_DESC "THE IEEE P1282 PROTOCOL PROVIDES SUPPORT FOR POSIX FILE SYSTEM SEMANTICS."
+/** RRIP ER recommended source string (RRIP IEEE P1282 v1.12 draft). */
+#define ISO9660_RRIP_1_12_SRC "PLEASE CONTACT THE IEEE STANDARDS DEPARTMENT, PISCATAWAY, NJ, USA FOR THE P1282 SPECIFICATION."
+/** RRIP ER version field value from the Rock Ridge Interchange Protocol v1.12 specs. */
+#define ISO9660_RRIP_1_12_VER 1
+/** The length of a RRIP v1.12 ER record.
+ * The record must be constructed using ISO9660_RRIP_1_12_ID,
+ * ISO9660_RRIP_1_12_DESC and ISO9660_RRIP_1_12_SRC. */
+#define ISO9660_RRIP_1_12_ER_LEN ((uint8_t)( ISO9660SUSPER_OFF_PAYLOAD \
+ + sizeof(ISO9660_RRIP_1_12_ID) - 1 \
+ + sizeof(ISO9660_RRIP_1_12_DESC) - 1 \
+ + sizeof(ISO9660_RRIP_1_12_SRC) - 1 ))
+
+
+/**
+ * Rock ridge interchange protocol - RR.
+ */
+typedef struct ISO9660RRIPRR
+{
+ /** Header (ISO9660RRIPRR_SIG1, ISO9660RRIPRR_SIG2,
+ * ISO9660RRIPRR_LEN, ISO9660RRIPRR_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** Flags indicating which RRIP entries are present (). */
+ uint8_t fFlags;
+} ISO9660RRIPRR;
+/** Pointer to a RRIP RR entry. */
+typedef ISO9660RRIPRR *PISO9660RRIPRR;
+/** Pointer to a const RRIP RR entry. */
+typedef ISO9660RRIPRR const *PCISO9660RRIPRR;
+#define ISO9660RRIPRR_SIG1 'R' /**< RRIP RR entry signature byte 1. */
+#define ISO9660RRIPRR_SIG2 'R' /**< RRIP RR entry signature byte 2. */
+#define ISO9660RRIPRR_VER 1 /**< RRIP RR entry version number. */
+#define ISO9660RRIPRR_LEN 5 /**< RRIP RR entry length (fixed). */
+AssertCompileSize(ISO9660RRIPRR, ISO9660RRIPRR_LEN);
+
+/** @name ISO9660RRIP_RR_F_XXX - Indicates which RRIP entries are present.
+ * @{ */
+#define ISO9660RRIP_RR_F_PX UINT8_C(0x01)
+#define ISO9660RRIP_RR_F_PN UINT8_C(0x02)
+#define ISO9660RRIP_RR_F_SL UINT8_C(0x04)
+#define ISO9660RRIP_RR_F_NM UINT8_C(0x08)
+#define ISO9660RRIP_RR_F_CL UINT8_C(0x10)
+#define ISO9660RRIP_RR_F_PL UINT8_C(0x20)
+#define ISO9660RRIP_RR_F_RE UINT8_C(0x40)
+#define ISO9660RRIP_RR_F_TF UINT8_C(0x80)
+/** @} */
+
+/**
+ * Rock ridge interchange protocol - posix attribute entry (PX).
+ */
+typedef struct ISO9660RRIPPX
+{
+ /** Header (ISO9660RRIPPX_SIG1, ISO9660RRIPPX_SIG2,
+ * ISO9660RRIPPX_LEN, ISO9660RRIPPX_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The file mode (RTFS_UNIX_XXX, RTFS_TYPE_XXX). */
+ ISO9660U32 fMode;
+ /** Number of hardlinks. */
+ ISO9660U32 cHardlinks;
+ /** User ID. */
+ ISO9660U32 uid;
+ /** Group ID. */
+ ISO9660U32 gid;
+ /** Inode number. */
+ ISO9660U32 INode;
+} ISO9660RRIPPX;
+/** Pointer to a RRIP posix attribute entry. */
+typedef ISO9660RRIPPX *PISO9660RRIPPX;
+/** Pointer to a const RRIP posix attribute entry. */
+typedef ISO9660RRIPPX const *PCISO9660RRIPPX;
+#define ISO9660RRIPPX_SIG1 'P' /**< RRIP posix attribute entry signature byte 1. */
+#define ISO9660RRIPPX_SIG2 'X' /**< RRIP posix attribute entry signature byte 2. */
+#define ISO9660RRIPPX_VER 1 /**< RRIP posix attribute entry version number. */
+#define ISO9660RRIPPX_LEN 44 /**< RRIP posix attribute entry length (fixed). */
+AssertCompileSize(ISO9660RRIPPX, ISO9660RRIPPX_LEN);
+#define ISO9660RRIPPX_LEN_NO_INODE 36 /**< RRIP posix attribute entry length without inode (fixed). */
+
+
+/**
+ * Rock ridge interchange protocol - timestamp entry (TF).
+ */
+typedef struct ISO9660RRIPTF
+{
+ /** Header (ISO9660RRIPTF_SIG1, ISO9660RRIPTF_SIG2, ISO9660RRIPTF_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** Flags, ISO9660RRIPTF_F_XXX. */
+ uint8_t fFlags;
+ /** Timestamp payload bytes (variable size and format). */
+ uint8_t abPayload[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
+} ISO9660RRIPTF;
+AssertCompileMemberOffset(ISO9660RRIPTF, abPayload, 5);
+/** Pointer to a RRIP timestamp entry. */
+typedef ISO9660RRIPTF *PISO9660RRIPTF;
+/** Pointer to a const RRIP timestamp entry. */
+typedef ISO9660RRIPTF const *PCISO9660RRIPTF;
+#define ISO9660RRIPTF_SIG1 'T' /**< RRIP child link entry signature byte 1. */
+#define ISO9660RRIPTF_SIG2 'F' /**< RRIP child link entry signature byte 2. */
+#define ISO9660RRIPTF_VER 1 /**< RRIP child link entry version number. */
+
+/** @name ISO9660RRIPTF_F_XXX - Timestmap flags.
+ * @{ */
+#define ISO9660RRIPTF_F_BIRTH UINT8_C(0x01) /**< Birth (creation) timestamp is recorded. */
+#define ISO9660RRIPTF_F_MODIFY UINT8_C(0x02) /**< Modification timestamp is recorded. */
+#define ISO9660RRIPTF_F_ACCESS UINT8_C(0x04) /**< Accessed timestamp is recorded. */
+#define ISO9660RRIPTF_F_CHANGE UINT8_C(0x08) /**< Attribute change timestamp is recorded. */
+#define ISO9660RRIPTF_F_BACKUP UINT8_C(0x10) /**< Backup timestamp is recorded. */
+#define ISO9660RRIPTF_F_EXPIRATION UINT8_C(0x20) /**< Expiration timestamp is recorded. */
+#define ISO9660RRIPTF_F_EFFECTIVE UINT8_C(0x40) /**< Effective timestamp is recorded. */
+#define ISO9660RRIPTF_F_LONG_FORM UINT8_C(0x80) /**< If set ISO9660TIMESTAMP is used, otherwise ISO9660RECTIMESTAMP. */
+/** @} */
+
+/**
+ * Calculates the length of a 'TF' entry given the flags.
+ *
+ * @returns Length in bytes.
+ * @param fFlags The flags (ISO9660RRIPTF_F_XXX).
+ */
+DECLINLINE(uint8_t) Iso9660RripTfCalcLength(uint8_t fFlags)
+{
+ unsigned cTimestamps = ((fFlags & ISO9660RRIPTF_F_BIRTH) != 0)
+ + ((fFlags & ISO9660RRIPTF_F_MODIFY) != 0)
+ + ((fFlags & ISO9660RRIPTF_F_ACCESS) != 0)
+ + ((fFlags & ISO9660RRIPTF_F_CHANGE) != 0)
+ + ((fFlags & ISO9660RRIPTF_F_BACKUP) != 0)
+ + ((fFlags & ISO9660RRIPTF_F_EXPIRATION) != 0)
+ + ((fFlags & ISO9660RRIPTF_F_EFFECTIVE) != 0);
+ return (uint8_t)( cTimestamps * (fFlags & ISO9660RRIPTF_F_LONG_FORM ? sizeof(ISO9660TIMESTAMP) : sizeof(ISO9660RECTIMESTAMP))
+ + RT_OFFSETOF(ISO9660RRIPTF, abPayload));
+}
+
+
+/**
+ * Rock ridge interchange protocol - posix device number entry (PN).
+ *
+ * Mandatory for block or character devices.
+ */
+typedef struct ISO9660RRIPPN
+{
+ /** Header (ISO9660RRIPPN_SIG1, ISO9660RRIPPN_SIG2,
+ * ISO9660RRIPPN_LEN, ISO9660RRIPPN_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The major device number. */
+ ISO9660U32 Major;
+ /** The minor device number. */
+ ISO9660U32 Minor;
+} ISO9660RRIPPN;
+/** Pointer to a RRIP posix attribute entry. */
+typedef ISO9660RRIPPN *PISO9660RRIPPN;
+/** Pointer to a const RRIP posix attribute entry. */
+typedef ISO9660RRIPPN const *PCISO9660RRIPPN;
+#define ISO9660RRIPPN_SIG1 'P' /**< RRIP posix device number entry signature byte 1. */
+#define ISO9660RRIPPN_SIG2 'N' /**< RRIP posix device number entry signature byte 2. */
+#define ISO9660RRIPPN_VER 1 /**< RRIP posix device number entry version number. */
+#define ISO9660RRIPPN_LEN 20 /**< RRIP posix device number entry length (fixed). */
+AssertCompileSize(ISO9660RRIPPN, ISO9660RRIPPN_LEN);
+
+/**
+ * Rock ridge interchange protocol - symlink entry (SL).
+ *
+ * Mandatory for symbolic links.
+ */
+typedef struct ISO9660RRIPSL
+{
+ /** Header (ISO9660RRIPSL_SIG1, ISO9660RRIPSL_SIG2, ISO9660RRIPSL_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** Flags (0 or ISO9660RRIP_SL_F_CONTINUE). */
+ uint8_t fFlags;
+ /** Variable length of components. First byte in each component is a
+ * combination of ISO9660RRIP_SL_C_XXX flag values. The second byte the
+ * length of character data following it. */
+ uint8_t abComponents[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
+} ISO9660RRIPSL;
+AssertCompileMemberOffset(ISO9660RRIPSL, abComponents, 5);
+/** Pointer to a RRIP symbolic link entry. */
+typedef ISO9660RRIPSL *PISO9660RRIPSL;
+/** Pointer to a const RRIP symbolic link entry. */
+typedef ISO9660RRIPSL const *PCISO9660RRIPSL;
+#define ISO9660RRIPSL_SIG1 'S' /**< RRIP symbolic link entry signature byte 1. */
+#define ISO9660RRIPSL_SIG2 'L' /**< RRIP symbolic link entry signature byte 2. */
+#define ISO9660RRIPSL_VER 1 /**< RRIP symbolic link entry version number. */
+/** ISO9660RRIPSL.fFlags - When set another symlink entry follows this one. */
+#define ISO9660RRIP_SL_F_CONTINUE UINT8_C(0x01)
+/** @name ISO9660RRIP_SL_C_XXX - Symlink component flags.
+ * @note These matches ISO9660RRIP_NM_F_XXX.
+ * @{ */
+/** Indicates that the component continues in the next entry. */
+#define ISO9660RRIP_SL_C_CONTINUE UINT8_C(0x01)
+/** Refer to '.' (the current dir). */
+#define ISO9660RRIP_SL_C_CURRENT UINT8_C(0x02)
+/** Refer to '..' (the parent dir). */
+#define ISO9660RRIP_SL_C_PARENT UINT8_C(0x04)
+/** Refer to '/' (the root dir). */
+#define ISO9660RRIP_SL_C_ROOT UINT8_C(0x08)
+/** Reserved / historically was mount point reference. */
+#define ISO9660RRIP_SL_C_MOUNT_POINT UINT8_C(0x10)
+/** Reserved / historically was uname network node name. */
+#define ISO9660RRIP_SL_C_UNAME UINT8_C(0x20)
+/** Reserved mask (considers historically bits reserved). */
+#define ISO9660RRIP_SL_C_RESERVED_MASK UINT8_C(0xf0)
+/** @} */
+
+
+/**
+ * Rock ridge interchange protocol - name entry (NM).
+ */
+typedef struct ISO9660RRIPNM
+{
+ /** Header (ISO9660RRIPNM_SIG1, ISO9660RRIPNM_SIG2, ISO9660RRIPNM_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** Flags (ISO9660RRIP_NM_F_XXX). */
+ uint8_t fFlags;
+ /** The name part (if any). */
+ char achName[RT_FLEXIBLE_ARRAY_IN_NESTED_UNION];
+} ISO9660RRIPNM;
+AssertCompileMemberOffset(ISO9660RRIPNM, achName, 5);
+/** Pointer to a RRIP name entry. */
+typedef ISO9660RRIPNM *PISO9660RRIPNM;
+/** Pointer to a const RRIP name entry. */
+typedef ISO9660RRIPNM const *PCISO9660RRIPNM;
+#define ISO9660RRIPNM_SIG1 'N' /**< RRIP name entry signature byte 1. */
+#define ISO9660RRIPNM_SIG2 'M' /**< RRIP name entry signature byte 2. */
+#define ISO9660RRIPNM_VER 1 /**< RRIP name entry version number. */
+/** @name ISO9660RRIP_NM_F_XXX - Name flags.
+ * @note These matches ISO9660RRIP_SL_C_XXX.
+ * @{ */
+/** Indicates there are more 'NM' entries. */
+#define ISO9660RRIP_NM_F_CONTINUE UINT8_C(0x01)
+/** Refer to '.' (the current dir). */
+#define ISO9660RRIP_NM_F_CURRENT UINT8_C(0x02)
+/** Refer to '..' (the parent dir). */
+#define ISO9660RRIP_NM_F_PARENT UINT8_C(0x04)
+/** Reserved / historically was uname network node name. */
+#define ISO9660RRIP_NM_F_UNAME UINT8_C(0x20)
+/** Reserved mask (considers historical bits reserved). */
+#define ISO9660RRIP_NM_F_RESERVED_MASK UINT8_C(0xf8)
+/** @} */
+
+/** Maximum name length in one 'NM' entry. */
+#define ISO9660RRIPNM_MAX_NAME_LEN 250
+
+
+/**
+ * Rock ridge interchange protocol - child link entry (CL).
+ *
+ * This is used for relocated directories. Relocated directries are employed
+ * to bypass the ISO 9660 maximum tree depth of 8.
+ *
+ * The size of the directory and everything else is found in the '.' entry in
+ * the specified location. Only the name (NM or dir rec) and this link record
+ * should be used.
+ */
+typedef struct ISO9660RRIPCL
+{
+ /** Header (ISO9660RRIPCL_SIG1, ISO9660RRIPCL_SIG2,
+ * ISO9660RRIPCL_LEN, ISO9660RRIPCL_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The offset of the directory data (block offset). */
+ ISO9660U32 offExtend;
+} ISO9660RRIPCL;
+/** Pointer to a RRIP child link entry. */
+typedef ISO9660RRIPCL *PISO9660RRIPCL;
+/** Pointer to a const RRIP child link entry. */
+typedef ISO9660RRIPCL const *PCISO9660RRIPCL;
+#define ISO9660RRIPCL_SIG1 'C' /**< RRIP child link entry signature byte 1. */
+#define ISO9660RRIPCL_SIG2 'L' /**< RRIP child link entry signature byte 2. */
+#define ISO9660RRIPCL_VER 1 /**< RRIP child link entry version number. */
+#define ISO9660RRIPCL_LEN 12 /**< RRIP child link entry length. */
+AssertCompileSize(ISO9660RRIPCL, ISO9660RRIPCL_LEN);
+
+
+/**
+ * Rock ridge interchange protocol - parent link entry (PL).
+ *
+ * This is used in relocated directories. Relocated directries are employed
+ * to bypass the ISO 9660 maximum tree depth of 8.
+ *
+ * The size of the directory and everything else is found in the '.' entry in
+ * the specified location. Only the name (NM or dir rec) and this link record
+ * should be used.
+ */
+typedef struct ISO9660RRIPPL
+{
+ /** Header (ISO9660RRIPPL_SIG1, ISO9660RRIPPL_SIG2,
+ * ISO9660RRIPPL_LEN, ISO9660RRIPPL_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The offset of the directory data (block offset). */
+ ISO9660U32 offExtend;
+} ISO9660RRIPPL;
+/** Pointer to a RRIP parent link entry. */
+typedef ISO9660RRIPPL *PISO9660RRIPPL;
+/** Pointer to a const RRIP parent link entry. */
+typedef ISO9660RRIPPL const *PCISO9660RRIPPL;
+#define ISO9660RRIPPL_SIG1 'P' /**< RRIP parent link entry signature byte 1. */
+#define ISO9660RRIPPL_SIG2 'L' /**< RRIP parent link entry signature byte 2. */
+#define ISO9660RRIPPL_VER 1 /**< RRIP parent link entry version number. */
+#define ISO9660RRIPPL_LEN 12 /**< RRIP parent link entry length. */
+AssertCompileSize(ISO9660RRIPPL, ISO9660RRIPPL_LEN);
+
+
+/**
+ * Rock ridge interchange protocol - relocated entry (RE).
+ *
+ * This is used in the directory record for a relocated directory in the
+ * holding place high up in the directory hierarchy. The system may choose to
+ * ignore/hide entries with this entry present.
+ */
+typedef struct ISO9660RRIPRE
+{
+ /** Header (ISO9660RRIPRE_SIG1, ISO9660RRIPRE_SIG2,
+ * ISO9660RRIPRE_LEN, ISO9660RRIPRE_VER). */
+ ISO9660SUSPHDR Hdr;
+} ISO9660RRIPRE;
+/** Pointer to a RRIP parent link entry. */
+typedef ISO9660RRIPRE *PISO9660RRIPRE;
+/** Pointer to a const RRIP parent link entry. */
+typedef ISO9660RRIPRE const *PCISO9660RRIPRE;
+#define ISO9660RRIPRE_SIG1 'R' /**< RRIP relocated entry signature byte 1. */
+#define ISO9660RRIPRE_SIG2 'E' /**< RRIP relocated entry signature byte 2. */
+#define ISO9660RRIPRE_VER 1 /**< RRIP relocated entry version number. */
+#define ISO9660RRIPRE_LEN 4 /**< RRIP relocated entry length. */
+AssertCompileSize(ISO9660RRIPRE, ISO9660RRIPRE_LEN);
+
+
+/**
+ * Rock ridge interchange protocol - sparse file entry (SF).
+ */
+#pragma pack(1)
+typedef struct ISO9660RRIPSF
+{
+ /** Header (ISO9660RRIPSF_SIG1, ISO9660RRIPSF_SIG2,
+ * ISO9660RRIPSF_LEN, ISO9660RRIPSF_VER). */
+ ISO9660SUSPHDR Hdr;
+ /** The high 32-bits of the 64-bit sparse file size. */
+ ISO9660U32 cbSparseHi;
+ /** The low 32-bits of the 64-bit sparse file size. */
+ ISO9660U32 cbSparseLo;
+ /** The table depth. */
+ uint8_t cDepth;
+} ISO9660RRIPSF;
+#pragma pack()
+/** Pointer to a RRIP symbolic link entry. */
+typedef ISO9660RRIPSF *PISO9660RRIPSF;
+/** Pointer to a const RRIP symbolic link entry. */
+typedef ISO9660RRIPSF const *PCISO9660RRIPSF;
+#define ISO9660RRIPSF_SIG1 'S' /**< RRIP spare file entry signature byte 1. */
+#define ISO9660RRIPSF_SIG2 'F' /**< RRIP spare file entry signature byte 2. */
+#define ISO9660RRIPSF_VER 1 /**< RRIP spare file entry version number. */
+#define ISO9660RRIPSF_LEN 21 /**< RRIP spare file entry length. */
+AssertCompileSize(ISO9660RRIPSF, ISO9660RRIPSF_LEN);
+
+/** @name ISO9660RRIP_SF_TAB_F_XXX - Sparse table format.
+ * @{ */
+/** The 24-bit logical block number mask.
+ * This is somewhat complicated, see docs. MBZ for EMPTY. */
+#define ISO9660RRIP_SF_TAB_F_BLOCK_MASK UINT32_C(0x00ffffff)
+/** Reserved bits, MBZ. */
+#define ISO9660RRIP_SF_TAB_F_RESERVED RT_BIT_32()
+/** References a sub-table with 256 entries (ISO9660U32). */
+#define ISO9660RRIP_SF_TAB_F_TABLE RT_BIT_32(30)
+/** Zero data region. */
+#define ISO9660RRIP_SF_TAB_F_EMPTY RT_BIT_32(31)
+/** @} */
+
+
+/**
+ * SUSP and RRIP union.
+ */
+typedef union ISO9660SUSPUNION
+{
+ ISO9660SUSPHDR Hdr; /**< SUSP header . */
+ ISO9660SUSPCE CE; /**< SUSP continuation entry. */
+ ISO9660SUSPPD PD; /**< SUSP padding entry. */
+ ISO9660SUSPSP SP; /**< SUSP system use protocol entry. */
+ ISO9660SUSPST ST; /**< SUSP terminator entry. */
+ ISO9660SUSPER ER; /**< SUSP extension record entry. */
+ ISO9660SUSPES ES; /**< SUSP extension sequence entry. */
+ ISO9660RRIPRR RR; /**< RRIP optimization entry. */
+ ISO9660RRIPPX PX; /**< RRIP posix attribute entry. */
+ ISO9660RRIPTF TF; /**< RRIP timestamp entry. */
+ ISO9660RRIPPN PN; /**< RRIP posix device number entry. */
+ ISO9660RRIPSF SF; /**< RRIP sparse file entry. */
+ ISO9660RRIPSL SL; /**< RRIP symbolic link entry. */
+ ISO9660RRIPNM NM; /**< RRIP name entry. */
+ ISO9660RRIPCL CL; /**< RRIP child link entry. */
+ ISO9660RRIPPL PL; /**< RRIP parent link entry. */
+ ISO9660RRIPRE RE; /**< RRIP relocated entry. */
+} ISO9660SUSPUNION;
+/** Pointer to a SUSP and RRIP union. */
+typedef ISO9660SUSPUNION *PISO9660SUSPUNION;
+/** Pointer to a const SUSP and RRIP union. */
+typedef ISO9660SUSPUNION *PCISO9660SUSPUNION;
+
+
+/** @} */
+
+#endif /* !IPRT_INCLUDED_formats_iso9660_h */
+