std.fs.squashfs — SquashFS 4.0 lesen

import std.fs.squashfs;

Liest SquashFS-Abbilder: Superblock auswerten, Inodes und Verzeichnisse aus komprimierten Metadatenblöcken holen, Dateien entpacken. Das erste Dateisystem der Sammlung, das mit Kompression umgeht — und damit grundlegend anders aufgebaut als FAT, exFAT, ext4 und NTFS.

→ Die Dateisystem-Sammlung · std.decomp · Guide: Fremde Dateisysteme lesen

• Keine Cluster, keine Zuordnungstabelle. Alles liegt in Metadatenblöcken zu höchstens 8 KiB (SQFS_META_SIZE), jeder für sich komprimiert.
• Eine Inode-Referenz ist keine Nummer, sondern ein Paar: obere 32 Bit = Adresse des Metadatenblocks, untere 16 Bit = Versatz im entpackten Block. Dafür gibt es SquashRefBlock und SquashRefOffset.
• Blockgrößen in der Liste sind die Größe auf der Platte, nicht die entpackte. Wer sie als entpackte Länge liest, bekommt zu wenig Daten.
• Kleine Dateireste liegen nicht in eigenen Blöcken, sondern zusammen mit anderen in einem Fragment. Eine Datei kann also aus ganzen Blöcken plus einem Fragmentstück bestehen.

pub type SquashVolume = struct {
  fd:          int64;
  partOffset:  int64;   // Byte-Versatz des Abbilds im Deskriptor
  inodeCount:  int64;
  blockSize:   int64;
  fragCount:   int64;
  compression: int64;   // SQFS_COMP_*
  flags:       int64;
  idCount:     int64;
  rootRef:     int64;   // Inode-Referenz der Wurzel
  bytesUsed:   int64;
  idTable:     int64;
  inodeTable:  int64;
  dirTable:    int64;
  fragTable:   int64;
  gueltig:     bool;
}

pub type SquashEntry = struct {
  art:         int64;   // SQFS_INODE_*
  mode:        int64;
  uid:         int64;
  gid:         int64;
  inodeNr:     int64;
  groesse:     int64;   // Datei: Bytes; Verzeichnis: Bytes der Eintragsliste
  istDir:      bool;
  istDatei:    bool;
  istSymlink:  bool;
  dirStart:    int64;   // Verzeichnis: Versatz des Metadatenblocks
  dirOffset:   int64;   // Verzeichnis: Versatz im entpackten Block
  blocksStart: int64;   // Datei: Beginn der Datenblöcke im Abbild
  fragIndex:   int64;   // Datei: Fragmentnummer, 0xFFFFFFFF = keins
  fragOffset:  int64;   // Datei: Versatz im entpackten Fragment
  blockListe:  int64;   // Datei: Adresse der Blockgrößenliste
  blockAnzahl: int64;
  symlinkRef:  int64;   // Symlink: Adresse des Ziels
  symlinkLen:  int64;
}

pub type SquashDirEntry = struct {
  kindRef: int64;   // Inode-Referenz des Kindes
  art:     int64;
  inodeNr: int64;
}

SquashDirEntry gibt es, weil die Rückgabe mehrerer Werte in Lyx über ein Struct läuft: ref wirkt nur bei Struct-Parametern, skalare Ausgabeparameter kennt die Sprache nicht.

unit main;
import std.fs.squashfs;
import std.alloc;
import std.io;
import std.string;

fn main(): int64 {
    var fd: int64 := open("/tmp/abbild.squashfs"c, 0, 0);
    if (fd < 0) { return 1; }

    var vol: SquashVolume;
    if (!SquashMount(fd, 0, vol)) { PrintLn("kein SquashFS"); close(fd); return 1; }

    PrintLn(StrConcat("Kompression: ", SquashCompressionName(vol)));
    if (!SquashCompressionUnterstuetzt(vol)) {
        PrintLn("Verfahren wird nicht unterstuetzt");
        close(fd);
        return 1;
    }

    var wurzel: SquashEntry;
    SquashInode(vol, SquashRootRef(vol), wurzel);

    var d: SquashDir;
    var de: SquashDirEntry;
    var name: int64 := alloc(300);

    if (SquashDirOpen(vol, wurzel, d)) {
        while (SquashDirNext(d, de, name)) {
            PrintLn(name as pchar);
        }
        SquashDirClose(d);
    }

    free(name, 300);
    SquashEntryFreigeben(wurzel);
    close(fd);
    return 0;
}

• Nicht enthalten: erweiterte Attribute (xattr), Gerätedateien, Sockets.
• Nur lesen — und das ist hier keine Einschränkung der Unit, sondern des Formats: SquashFS ist ein Nur-Lese-Dateisystem. Ein Abbild zu ändern hieße, es neu zu bauen; dafür gibt es mksquashfs.

Prüfstand: tests/squashfs_test.sh — 37 Prüfungen gegen ein erzeugtes Abbild.

Letzte Aktualisierung: 2026-09-05 — Seite neu angelegt; erhoben aus std/fs/squashfs.lyx.

Prüflauf 2026-09-05 mit doku-pruefer.py (Repo-Compiler lyxc 1.2.2A): 7 Vollprogramme der Sammlung, 7 übersetzen, 0 echte Fehler; 53 Aufrufe gegen die pub fn-Signaturen gehalten, 0 Abweichungen.