std.fs_ext

Erweitertes Datei-I/O (WP-1): Ergänzt std.fs um positioniertes Lesen/Schreiben (PRead/PWrite), Scatter-Gather-I/O (ReadV/WriteV), Datei-Metadaten (Fstat), Zugriffsprüfung (FileExists), Synchronisierung (Fsync), Größenänderung (Truncate), Verzeichniswechsel und kernelseitigen Dateitransfer (Sendfile).

→ Standard Library · std.fs · std.inotify

import std.fs_ext;
import std.fs;
import std.alloc;
import std.io;

fn PrintFileMeta(path: pchar): void {
    var fd := open(path, 0, 0);   // O_RDONLY
    if (fd < 0) { return; }

    var stat: int64 := alloc(STAT_SIZE);
    Fstat(fd, stat);

    PrintLn("Größe: " + IntToStr(StatFileSize(stat)) + " Bytes");

    Print("Ist Verzeichnis: ");
    if (StatIsDir(stat)) { Print("ja\n"); } else { Print("nein\n"); }

    free(stat, STAT_SIZE);
    close(fd);
}

import std.fs_ext;
import std.alloc;

// Verschiedene Threads können denselben fd lesen ohne lseek-Konflikte.
fn ReadChunk(fd: int64, offset: int64, size: int64): int64 {
    var buf: int64 := alloc(size);
    var n := PRead(fd, buf, size, offset);
    // Puffer verarbeiten...
    free(buf, size);
    return n;
}

import std.fs_ext;
import std.alloc;

fn SendHeaderAndBody(fd: int64, header: int64, hLen: int64,
                                body: int64,   bLen: int64): void {
    var iov: int64 := alloc(IOVEC_SIZE * 2);
    IovecSet(iov, 0, header, hLen);
    IovecSet(iov, 1, body,   bLen);
    WriteV(fd, iov, 2);
    free(iov, IOVEC_SIZE * 2);
}

import std.fs_ext;
import std.fs;
import std.alloc;

fn ServeFile(socketFd: int64, path: pchar): void {
    var fd  := open(path, 0, 0);
    if (fd < 0) { return; }

    var stat: int64 := alloc(STAT_SIZE);
    Fstat(fd, stat);
    var size := StatFileSize(stat);
    free(stat, STAT_SIZE);

    // Kernel überträgt direkt ohne Userspace-Kopie
    Sendfile(socketFd, fd, 0, size);
    close(fd);
}

• PRead/PWrite sind thread-sicher: Mehrere Threads können denselben fd mit unterschiedlichen Offsets benutzen.
• Sendfile funktioniert nur wenn outFd ein Socket oder regulärer fd ist — nicht für Pipes.
• Truncate kann eine Datei auch vergrößern; der neue Bereich wird mit Null-Bytes gefüllt.
• StatMtime liefert einen timespec-Wert in Nanosekunden — für Sekunden durch 1000000000 teilen.
• FileAccess prüft den effektiven Benutzer (EUID), nicht den realen (UID).

• std.fs — Basis-Datei-I/O (open, read, write, close, mkdir …)
• std.inotify — Dateisystemereignisse überwachen
• std.net.epoll — I/O-Multiplexing
• std.mmap_ext — Memory-Mapped Files

Letzte Aktualisierung: 2026-06-05