std.iso — ISO 9660-Images lesen und schreiben

std.iso liest und schreibt ISO 9660-Images (Level 1) ohne externe Abhängigkeiten. Der Reader traversiert den vollständigen Verzeichnisbaum per BFS und gibt vollständige Pfade zurück (subdir/DATEI.TXT). Der Writer erzeugt ein gültiges bootfähiges ISO-Image mit flachem Root-Verzeichnis.

→ Standard Library · std.zip · std.tar

Image-Layout (festes Schema):

Sektor  0–15  System Area (leer)
Sektor    16  PVD — Primary Volume Descriptor  (Volume-ID: "LYXISO")
Sektor    17  VDST — Volume Descriptor Set Terminator
Sektor 18–19  Path Table (L-Type + M-Type)
Sektor    20  Root-Verzeichnis
Sektor   21+  Dateidaten

Einschränkungen:

• Sektorgröße: 2048 Bytes (ISO 9660 Standard)
• Max. 4096 Dateieinträge, max. 256 Verzeichnisse (Lesen)
• Writer: nur flaches Root-Verzeichnis — keine Unterverzeichnisse
• Dateinamen (Writer): max. 36 Zeichen, nur A–Z 0–9 _ . — ungültige Zeichen werden zu _, Kleinbuchstaben zu Großbuchstaben
• Kein Joliet, kein Rock Ridge, kein El Torito Boot-Record

Der Reader gibt vollständige Pfade zurück, inklusive Verzeichnisnamen: BOOT/GRUB/GRUB.CFG oder DATA/LOG.TXT. Verzeichniseinträge selbst erscheinen nicht in der Liste — nur reguläre Dateien.

import std.iso;
import std.alloc;
import std.io;

fn IsoInhaltLesen(pfad: pchar): void {
    var img: int64 := IsoOpen(pfad as int64);
    if img == 0 then { PrintLn("Kein gültiges ISO 9660-Image"c); return; }

    var n: int64 := IsoCount(img);
    Print("Dateien: "c); PrintLn(IntToStr(n)c);

    var i: int64 := 0;
    while i < n do {
        Print(IsoName(img, i) as pchar);
        Print("  "c);
        PrintLn(IntToStr(IsoSize(img, i))c);
        i := i + 1;
    }

    // Datei nach Pfad suchen und lesen
    var idx: int64 := IsoFind(img, "BOOT/GRUB/GRUB.CFG"c as int64);
    if idx >= 0 then {
        var sz:  int64 := IsoSize(img, idx);
        var buf: int64 := alloc(sz + 1);
        IsoRead(img, idx, buf, sz);
        poke8(buf + sz, 0);
        PrintLn(buf as pchar);
        free(buf, sz + 1);
    }

    IsoClose(img);
}

IsoWriterAdd normalisiert den Dateinamen automatisch: Kleinbuchstaben → Großbuchstaben, ungültige Zeichen → _. Das Version-Suffix ;1 wird beim Schreiben angehängt und erscheint im Reader als Teil des Namens.

import std.iso;
import std.alloc;

fn IsoErstellen(): void {
    var w: int64 := IsoWriterNew();

    var readme: pchar := "Lyx ISO 9660 Image\n"c;
    IsoWriterAdd(w, "README.TXT"c as int64, readme as int64, 19);

    // Kleinbuchstaben und Sonderzeichen werden normalisiert:
    // "boot-config.txt" → "BOOT_CONFIG.TXT" im Image
    var cfg: pchar := "boot=default\n"c;
    IsoWriterAdd(w, "boot-config.txt"c as int64, cfg as int64, 13);

    var rc: int64 := IsoWriterSave(w, "ausgabe.iso"c as int64);
    if rc == ISO_ERR_NAMETOOLONG then {
        PrintLn("Dateiname zu lang (max. 36 Zeichen)"c);
    } else if rc != ISO_ERR_OK then {
        PrintLn("Fehler beim Speichern"c);
    }

    IsoWriterFree(w);
}

Hinweis zu data-Puffern: IsoWriterAdd kopiert die Daten nicht — es speichert nur den Zeiger. Die Puffer müssen bis zum Aufruf von IsoWriterSave gültig bleiben. IsoWriterFree gibt nur die Name-Strings frei, nicht die data-Zeiger.

ISO 9660 Level 1 erlaubt nur einen eingeschränkten Zeichensatz:

Gültige Zeichen: A–Z, 0–9, _, . — alles andere wird zu _.

Letzte Aktualisierung: 2026-06-13