ApplePartitionMapReader 1.0.0

ApplePartitionMapReader

ApplePartitionMapReader is a lightweight .NET library for reading Apple Partition Maps from classic Macintosh disk images. It provides a simple API to detect partition maps, enumerate partitions, and access partition metadata.

Features

• Detect Apple Partition Maps in disk images
• Enumerate all partitions with detailed metadata
• Access partition properties: name, type, start block, block count, status flags
• Strongly-typed status flags with ApplePartitionMapStatus enum
• High-performance parsing using stack-allocated buffers

Installation

Install from NuGet:

dotnet add package ApplePartitionMapReader

Or reference the project directly:

dotnet add reference ../src/ApplePartitionMapReader.csproj

Quick Start Example

using ApplePartitionMapReader;

// Open a disk image containing an Apple Partition Map
using var stream = File.OpenRead("disk.iso");

// Check if the stream contains an Apple Partition Map
if (ApplePartitionMap.IsApplePartitionMap(stream, 0))
{
    var map = new ApplePartitionMap(stream, 0);
    
    // Enumerate all partitions
    foreach (var partition in map.Entries)
    {
        Console.WriteLine($"Name: {partition.Name}");
        Console.WriteLine($"Type: {partition.Type}");
        Console.WriteLine($"Start: {partition.PartitionStartBlock}");
        Console.WriteLine($"Size: {partition.PartitionBlockCount} blocks");
        Console.WriteLine($"Status: {partition.StatusFlags}");
        Console.WriteLine();
    }
    
    // Or access by index
    var firstPartition = map[0];
    Console.WriteLine($"First partition: {firstPartition.Name}");
}

API Overview

ApplePartitionMap

• ApplePartitionMap(Stream stream, int volumeStartOffset): Constructs a partition map reader from a seekable, readable stream at the specified offset.
• static bool IsApplePartitionMap(Stream stream, int volumeStartOffset): Checks if the stream contains a valid Apple Partition Map at the given offset.
• IEnumerable<ApplePartitionMapEntry> Entries: Enumerates all partition entries in the map.
• ApplePartitionMapEntry this[int index]: Gets the partition entry at the specified index.

ApplePartitionMapEntry

Represents a single partition in the map with the following properties:

ApplePartitionMapStatus

Flags enum representing partition status:

Common Partition Types

License

MIT License - see LICENSE for details.

Related Projects

• AppleDiskImageReader - Reader for Apple II universal disk (.2mg) images
• AppleIIDiskReader - Reader for Apple II DOS 3.3 disk (.dsk) images
• ProDosVolumeReader - Reader for ProDOS (.po) volumes
• WozDiskImageReader - Reader for WOZ (.woz) disk images
• DiskCopyReader - Reader for Disk Copy 4.2 (.dc42) images
• MfsReader - Reader for MFS (Macintosh File System) volumes
• HfsReader - Reader for HFS (Hierarchical File System) volumes
• ResourceForkReader - Reader for Macintosh resource forks
• BinaryIIReader - Reader for Binary II (.bny, .bxy) archives
• StuffItReader - Reader for StuffIt (.sit) archives
• ShrinkItReader - Reader for ShrinkIt (.shk, .sdk) archives