pcntl_sigprocmask

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

pcntl_sigprocmask — Setzt und ermittelt blockierte Signale

Beschreibung

function pcntl_sigprocmask(int $mode, array $signals, array &$old_signals = null): bool

Die Funktion pcntl_sigprocmask() fügt blockierte Signale hinzu, entfernt sie oder setzt sie, abhängig vom Parameter mode.

Parameter-Liste

mode

Legt das Verhalten von pcntl_sigprocmask() fest. Mögliche Werte:

  • SIG_BLOCK: Die Signale zu den aktuell blockierten Signalen hinzufügen.
  • SIG_UNBLOCK: Die Signale aus den aktuell blockierten Signalen entfernen.
  • SIG_SETMASK: Die aktuell blockierten Signale durch die angegebene Liste von Signalen ersetzen.

signals

Liste von Signalen.

old_signals

Der Parameter old_signals wird auf ein Array gesetzt, das die Liste der zuvor blockierten Signale enthält.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.4.0 Es wird ein ValueError geworfen, wenn signal leer ist.
8.4.0 Es wird ein TypeError geworfen, wenn der Wert von signal kein int ist.
8.4.0 Es wird ein ValueError geworfen, wenn der Wert von signal ungültig ist.
8.4.0 Es wird ein ValueError geworfen, wenn der Wert von mode nicht SIG_BLOCK, SIG_UNBLOCK oder SIG_SETMASK ist.

Beispiele

Beispiel #1 pcntl_sigprocmask()-Beispiel

<?php
pcntl_sigprocmask(SIG_BLOCK, array(SIGHUP));
$oldset = array();
pcntl_sigprocmask(SIG_UNBLOCK, array(SIGHUP), $oldset);
?>

Siehe auch