DiskImageUtils.hh

Go to the documentation of this file.

#ifndef DISK_IMAGE_UTILS_HH
#define DISK_IMAGE_UTILS_HH
 
#include "AlignedBuffer.hh"
#include "endian.hh"
#include "ranges.hh"
#include "stl.hh"
 
#include <array>
#include <span>
#include <string>
 
namespace openmsx {
 
class SectorAccessibleDisk;
 
enum class MSXBootSectorType : int {
        DOS1 = 0,
        DOS2 = 1,
        NEXTOR = 2,
};
 
struct MSXBootSector {
        std::array<uint8_t, 3>      jumpCode;      // + 0 0xE5 to boot program
        std::array<uint8_t, 8>      name;          // + 3
        Endian::UA_L16              bpSector;      // +11 bytes per sector (always 512)
        uint8_t                     spCluster;     // +13 sectors per cluster
        Endian::L16                 resvSectors;   // +14 nb of non-data sectors (incl boot sector)
        uint8_t                     nrFats;        // +16 nb of fats
        Endian::UA_L16              dirEntries;    // +17 max nb of files in root directory
        Endian::UA_L16              nrSectors;     // +19 nb of sectors on this disk (< 65536)
        uint8_t                     descriptor;    // +21 media descriptor
        Endian::L16                 sectorsFat;    // +22 sectors per FAT
        Endian::L16                 sectorsTrack;  // +24 sectors per track (0 for LBA volumes)
        Endian::L16                 nrSides;       // +26 number of sides (heads) (0 for LBA volumes)
        union {
                struct {
                        Endian::L16                 hiddenSectors; // +28 not used
                        std::array<uint8_t, 512-30> pad;           // +30
                } dos1;
                struct {
                        Endian::L16                 hiddenSectors; // +28 not used
                        std::array<uint8_t, 9>      pad1;          // +30
                        Endian::UA_L32              vol_id;        // +39
                        std::array<uint8_t, 512-43> pad2;          // +43
                } dos2;
                struct {
                        Endian::L32                 hiddenSectors;          // +28 not used
                        Endian::L32                 nrSectors;              // +32 nb of sectors on this disk (>= 65536)
                        uint8_t                     physicalDriveNum;       // +36
                        uint8_t                     reserved;               // +37
                        uint8_t                     extendedBootSignature;  // +38
                        Endian::UA_L32              vol_id;                 // +39
                        std::array<uint8_t, 11>     volumeLabel;            // +43
                        std::array<uint8_t, 8>      fileSystemType;         // +54
                        std::array<uint8_t, 512-62> padding;                // +62
                } extended;
        } params;
};
static_assert(sizeof(MSXBootSector) == 512);
 
struct MSXDirEntry {
        enum class Attrib : uint8_t {
                REGULAR   = 0x00, // Normal file
                READONLY  = 0x01, // Read-Only file
                HIDDEN    = 0x02, // Hidden file
                SYSTEM    = 0x04, // System file
                VOLUME    = 0x08, // filename is Volume Label
                DIRECTORY = 0x10, // entry is a subdir
                ARCHIVE   = 0x20, // Archive bit
        };
        struct AttribValue {
                uint8_t value;
 
                constexpr AttribValue() = default;
                constexpr /*implicit*/ AttribValue(Attrib v) : value(to_underlying(v)) {}
                constexpr explicit AttribValue(uint8_t v) : value(v) {}
                constexpr explicit operator bool() const { return value != 0; }
                constexpr auto operator<=>(const AttribValue&) const = default;
                friend constexpr AttribValue operator|(AttribValue x, AttribValue y) { return AttribValue(x.value | y.value); }
                friend constexpr AttribValue operator&(AttribValue x, AttribValue y) { return AttribValue(x.value & y.value); }
        };
 
        std::array<char, 8 + 3> filename;     // + 0
        AttribValue             attrib;       // +11
        std::array<uint8_t, 10> reserved;     // +12 unused
        Endian::L16             time;         // +22
        Endian::L16             date;         // +24
        Endian::L16             startCluster; // +26
        Endian::L32             size;         // +28
 
        [[nodiscard]] auto base() const { return subspan<8>(filename, 0); }
        [[nodiscard]] auto ext () const { return subspan<3>(filename, 8); }
 
        bool operator==(const MSXDirEntry& other) const = default;
};
static_assert(sizeof(MSXDirEntry) == 32);
 
// Note: can't use Endian::L32 for 'start' and 'size' because the Partition
//       struct itself is not 4-bytes aligned.
struct Partition {
        uint8_t        boot_ind;   // + 0 0x80 - active
        uint8_t        head;       // + 1 starting head
        uint8_t        sector;     // + 2 starting sector
        uint8_t        cyl;        // + 3 starting cylinder
        uint8_t        sys_ind;    // + 4 what partition type
        uint8_t        end_head;   // + 5 end head
        uint8_t        end_sector; // + 6 end sector
        uint8_t        end_cyl;    // + 7 end cylinder
        Endian::UA_L32 start;      // + 8 starting sector counting from 0
        Endian::UA_L32 size;       // +12 nr of sectors in partition
};
static_assert(sizeof(Partition) == 16);
static_assert(alignof(Partition) == 1, "must not have alignment requirements");
 
struct PartitionTableSunrise {
        std::array<char, 11>      header; // +  0
        std::array<char,  3>      pad;    // +  3
        std::array<Partition, 31> part;   // + 14,+30,..,+494    Not 4-byte aligned!!
        Endian::L16               end;    // +510
};
static_assert(sizeof(PartitionTableSunrise) == 512);
 
struct PartitionTableNextor {
        std::array<char,  11>     header; // +  0
        std::array<char, 435>     pad;    // +  3
        std::array<Partition, 4>  part;   // +446,+462,+478,+494 Not 4-byte aligned!!
        Endian::L16               end;    // +510
};
static_assert(sizeof(PartitionTableNextor) == 512);
 
 
// Buffer that can hold a (512-byte) disk sector.
// The main advantages of this type over something like 'byte buf[512]' are:
//  - No need for reinterpret_cast<> when interpreting the data in a
//    specific way (this could in theory cause alignment problems).
//  - This type has a stricter alignment, so memcpy() and memset() can work
//    faster compared to using a raw byte array.
union SectorBuffer {
        std::array<uint8_t, 512>    raw;        // raw byte data
        MSXBootSector               bootSector; // interpreted as bootSector
        std::array<MSXDirEntry, 16> dirEntry;   // interpreted as 16 dir entries
        PartitionTableSunrise       ptSunrise;  // interpreted as Sunrise-IDE partition table
        PartitionTableNextor        ptNextor;   // interpreted as Nextor partition table
        AlignedBuffer               aligned;    // force big alignment (for faster memcpy)
};
static_assert(sizeof(SectorBuffer) == 512);
 
 
namespace DiskImageUtils {
 
        Partition& getPartition(const SectorAccessibleDisk& disk, unsigned partition, SectorBuffer& buf);
 
        void checkSupportedPartition(const SectorAccessibleDisk& disk, unsigned partition);
 
        [[nodiscard]] bool hasPartitionTable(const SectorAccessibleDisk& disk);
 
        void format(SectorAccessibleDisk& disk, MSXBootSectorType bootType);
        void format(SectorAccessibleDisk& disk, MSXBootSectorType bootType, size_t nbSectors);
 
        unsigned partition(SectorAccessibleDisk& disk,
                       std::span<const unsigned> sizes, MSXBootSectorType bootType);
 
        struct FatTimeDate {
                uint16_t time, date;
        };
        FatTimeDate toTimeDate(time_t totalSeconds);
        time_t fromTimeDate(FatTimeDate timeDate);
 
        [[nodiscard]] std::string formatAttrib(MSXDirEntry::AttribValue attrib);
};
 
} // namespace openmsx
 
#endif