1516 lines
63 KiB
C
1516 lines
63 KiB
C
/* $Id: iso9660.h $ */
|
|
/** @file
|
|
* IPRT, ISO 9660 File System
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2017-2023 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 */
|
|
|