std.signals

UNIX-Signalbehandlung (WP-3): Registriert Handler-Funktionen für POSIX-Signale, steuert die Signal-Maske eines Threads und ermöglicht den fd-basierten Signal-Empfang via signalfd (epoll-kompatibel). Alle 31 Standard-Signale sind als Konstanten verfügbar.

→ Standard Library · std.process · std.net.epoll

Signalmasken-Konstanten im Überblick:

Signalmasken-Konstanten im Überblick:

import std.signals;
import std.io;

var gRunning: bool := true;

fn OnTerminate(signo: int64): void {
    PrintLn("SIGTERM empfangen, beende...");
    gRunning := false;
}

fn Main(): void {
    SignalSet(SIGTERM, OnTerminate as int64);
    SignalSet(SIGINT,  OnTerminate as int64);

    while (gRunning) {
        // Hauptschleife...
    }
}

import std.signals;

fn InitServer(): void {
    // Verhindert Prozessabbruch bei Schreiben in geschlossene Verbindung.
    SignalIgnore(SIGPIPE);
}

import std.signals;
import std.net.epoll;
import std.alloc;
import std.io;

fn RunWithSignalFd(): void {
    // Signal blockieren, bevor signalfd erstellt wird!
    SignalMaskBlock(SIGTERM);
    SignalMaskBlock(SIGINT);

    var sfd := SignalFd(SIGTERM);
    // Zweiten signalfd für SIGINT erstellen, oder beide in eine Maske packen
    // (hier vereinfacht: nur SIGTERM)

    var ep := EpollCreate();
    EpollAdd(ep, sfd, EPOLLIN, sfd);

    var evBuf:  int64 := alloc(EPOLL_EVENT_SIZE);
    var sigBuf: int64 := alloc(SIGNALFD_SIGINFO_SIZE);

    var n := EpollWait(ep, evBuf, 1, -1);
    if (n > 0) {
        SignalFdRead(sfd, sigBuf);
        var signo := SignalFdSigno(sigBuf);
        PrintLn("Signal empfangen: " + IntToStr(signo));
    }

    free(evBuf,  EPOLL_EVENT_SIZE);
    free(sigBuf, SIGNALFD_SIGINFO_SIZE);
    close(sfd);
    close(ep);
}

import std.signals;
import std.process;

fn StopChild(childPid: int64): void {
    SignalSend(childPid, SIGTERM);
}

• SIGKILL und SIGSTOP können nicht abgefangen, ignoriert oder blockiert werden.
• Für SignalFd muss das Signal vorher via SignalMaskBlock blockiert werden, sonst kann es vor dem SignalFdRead ausgeliefert werden.
• SignalSet setzt automatisch SA_RESTART für echte Handler — unterbrochene Syscalls werden neu gestartet.
• Der Kernel-vDSO-Restorer wird genutzt — kein eigener Trampolin-Code nötig.
• Ein signalfd-fd lässt sich zusammen mit Netzwerk-fds und inotify-fds in dieselbe epoll-Instanz einhängen.

• std.process — fork, exec, waitpid
• std.process_ext — UID/GID, Sessions, uname
• std.net.epoll — epoll für signalfd-Integration
• std.mqueue — POSIX Message Queues als IPC-Alternative
• std.thread — Threads (Signal-Maske gilt pro Thread)

Letzte Aktualisierung: 2026-06-05