From d82733a8aa3c0c66109d922ad896ff4a9e800a27 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Fri, 29 May 2026 08:22:12 +0200 Subject: [PATCH 1/4] Translate pcntl signal-family functions Translates the following pcntl functions, picking up where #230 left off: - pcntl_strerror - pcntl_signal_dispatch - pcntl_signal_get_handler - pcntl_sigprocmask - pcntl_sigwaitinfo All five files use the impersonal style and only translate prose + code comments; PHP code, string literals and screen output stay in English to match what would actually print. --- .../pcntl/functions/pcntl-signal-dispatch.xml | 106 ++++++++++ .../functions/pcntl-signal-get-handler.xml | 121 ++++++++++++ .../pcntl/functions/pcntl-sigprocmask.xml | 168 ++++++++++++++++ .../pcntl/functions/pcntl-sigwaitinfo.xml | 186 ++++++++++++++++++ reference/pcntl/functions/pcntl-strerror.xml | 105 ++++++++++ 5 files changed, 686 insertions(+) create mode 100644 reference/pcntl/functions/pcntl-signal-dispatch.xml create mode 100644 reference/pcntl/functions/pcntl-signal-get-handler.xml create mode 100644 reference/pcntl/functions/pcntl-sigprocmask.xml create mode 100644 reference/pcntl/functions/pcntl-sigwaitinfo.xml create mode 100644 reference/pcntl/functions/pcntl-strerror.xml diff --git a/reference/pcntl/functions/pcntl-signal-dispatch.xml b/reference/pcntl/functions/pcntl-signal-dispatch.xml new file mode 100644 index 000000000..c7d2fa818 --- /dev/null +++ b/reference/pcntl/functions/pcntl-signal-dispatch.xml @@ -0,0 +1,106 @@ + + + + + + pcntl_signal_dispatch + Ruft die Signal-Handler für ausstehende Signale auf + + + + &reftitle.description; + + boolpcntl_signal_dispatch + + + + Die Funktion pcntl_signal_dispatch ruft für jedes + ausstehende Signal die mit pcntl_signal installierten + Signal-Handler auf. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + + <function>pcntl_signal_dispatch</function>-Beispiel + + +]]> + + &example.outputs.similar; + + + + + + + + + &reftitle.seealso; + + + pcntl_signal + pcntl_sigprocmask + pcntl_sigwaitinfo + pcntl_sigtimedwait + + + + + + + diff --git a/reference/pcntl/functions/pcntl-signal-get-handler.xml b/reference/pcntl/functions/pcntl-signal-get-handler.xml new file mode 100644 index 000000000..aedbe30c1 --- /dev/null +++ b/reference/pcntl/functions/pcntl-signal-get-handler.xml @@ -0,0 +1,121 @@ + + + + + + pcntl_signal_get_handler + Gibt den aktuellen Handler für das angegebene Signal zurück + + + + &reftitle.description; + + callableintpcntl_signal_get_handler + intsignal + + + Die Funktion pcntl_signal_get_handler ermittelt den + aktuellen Handler für das angegebene signal. + + + + + &reftitle.parameters; + + + signal + + + Die Signalnummer. + + + + + + + + &reftitle.returnvalues; + + Diese Funktion kann einen Integer-Wert zurückgeben, der sich auf + SIG_DFL oder SIG_IGN bezieht. + Wurde ein eigener Handler gesetzt, wird dieser callable + zurückgegeben. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 7.1.0 + + pcntl_signal_get_handler wurde hinzugefügt. + + + + + + + + + &reftitle.examples; + + + <function>pcntl_signal_get_handler</function>-Beispiel + + +]]> + + + + + + + &reftitle.seealso; + + pcntl_signal + + + + + diff --git a/reference/pcntl/functions/pcntl-sigprocmask.xml b/reference/pcntl/functions/pcntl-sigprocmask.xml new file mode 100644 index 000000000..5cca4c073 --- /dev/null +++ b/reference/pcntl/functions/pcntl-sigprocmask.xml @@ -0,0 +1,168 @@ + + + + + + pcntl_sigprocmask + Setzt und ermittelt blockierte Signale + + + + &reftitle.description; + + boolpcntl_sigprocmask + intmode + arraysignals + arrayold_signals&null; + + + Die Funktion pcntl_sigprocmask fügt blockierte Signale + hinzu, entfernt sie oder setzt sie, abhängig vom Parameter + mode. + + + + + &reftitle.parameters; + + + + 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. + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 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. + + + + + + + + + &reftitle.examples; + + + <function>pcntl_sigprocmask</function>-Beispiel + + +]]> + + + + + + + &reftitle.seealso; + + + pcntl_sigwaitinfo + pcntl_sigtimedwait + + + + + + diff --git a/reference/pcntl/functions/pcntl-sigwaitinfo.xml b/reference/pcntl/functions/pcntl-sigwaitinfo.xml new file mode 100644 index 000000000..8d80aaba8 --- /dev/null +++ b/reference/pcntl/functions/pcntl-sigwaitinfo.xml @@ -0,0 +1,186 @@ + + + + + + pcntl_sigwaitinfo + Wartet auf Signale + + + + &reftitle.description; + + intfalsepcntl_sigwaitinfo + arraysignals + arrayinfo[] + + + Die Funktion pcntl_sigwaitinfo unterbricht die + Ausführung des aufrufenden Skripts, bis eines der in + signals angegebenen Signale zugestellt wird. Ist + eines der Signale bereits ausstehend (z. B. durch + pcntl_sigprocmask blockiert), kehrt + pcntl_sigwaitinfo sofort zurück. + + + + + &reftitle.parameters; + + + + signals + + + Array von Signalen, auf die gewartet werden soll. + + + + + info + + + Der Parameter info wird auf ein Array gesetzt, + das Informationen über das Signal enthält. + + + Die folgenden Elemente werden für alle Signale gesetzt: + + signo: Signalnummer + errno: Eine Fehlernummer + code: Signalcode + + + + Die folgenden Elemente können für das Signal + SIGCHLD gesetzt sein: + + status: Exit-Wert oder Signal + utime: Verbrauchte Benutzerzeit + stime: Verbrauchte Systemzeit + pid: Prozess-ID des sendenden Prozesses + uid: Reale Benutzer-ID des sendenden Prozesses + + + + Die folgenden Elemente können für die Signale + SIGILL, SIGFPE, + SIGSEGV und SIGBUS gesetzt + sein: + + addr: Speicheradresse, die den Fehler verursacht hat + + + + Die folgenden Elemente können für das Signal + SIGPOLL gesetzt sein: + + band: Band-Ereignis + fd: Nummer des Dateideskriptors + + + + + + + + + + &reftitle.returnvalues; + + Gibt bei Erfolg eine Signalnummer zurück,&return.falseforfailure;. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 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. + + + + + + + + + &reftitle.examples; + + + <function>pcntl_sigwaitinfo</function>-Beispiel + + +]]> + + + + + + + &reftitle.seealso; + + + pcntl_sigprocmask + pcntl_sigtimedwait + + + + + + diff --git a/reference/pcntl/functions/pcntl-strerror.xml b/reference/pcntl/functions/pcntl-strerror.xml new file mode 100644 index 000000000..c2ca7b0f3 --- /dev/null +++ b/reference/pcntl/functions/pcntl-strerror.xml @@ -0,0 +1,105 @@ + + + + + + pcntl_strerror + Gibt die zur angegebenen errno gehörende Systemfehlermeldung zurück + + + + &reftitle.description; + + stringpcntl_strerror + interror_code + + + Gibt die Systemfehlermeldung zurück, die zum angegebenen + error_code (errno) der zuletzt + fehlgeschlagenen pcntl-Funktion gehört. Der Parameter + error_code kann durch Aufruf von + pcntl_get_last_error ermittelt werden. + + + + + + &reftitle.parameters; + + + error_code + + + Eine Fehlernummer (errno), + die von pcntl_get_last_error zurückgegeben wird. + + + + + + + + &reftitle.returnvalues; + + Gibt die Fehlermeldung als String zurück. + + + + + &reftitle.examples; + + <function>pcntl_strerror</function>-Beispiel + + Dieses Beispiel versucht, auf Kindprozesse zu warten, obwohl kein + Kindprozess existiert, und gibt anschließend die zugehörige Fehlermeldung + aus. + + + + + &example.outputs.similar; + + + + + + + + &reftitle.seealso; + + pcntl_get_last_error + + + + + From 6e7f655f2549df4457ef27cdb44dd70180b02a3a Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Fri, 29 May 2026 20:00:17 +0200 Subject: [PATCH 2/4] Update reference/pcntl/functions/pcntl-sigwaitinfo.xml Co-authored-by: Martin Samesch --- reference/pcntl/functions/pcntl-sigwaitinfo.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/pcntl/functions/pcntl-sigwaitinfo.xml b/reference/pcntl/functions/pcntl-sigwaitinfo.xml index 8d80aaba8..fb419b8af 100644 --- a/reference/pcntl/functions/pcntl-sigwaitinfo.xml +++ b/reference/pcntl/functions/pcntl-sigwaitinfo.xml @@ -18,7 +18,7 @@ Die Funktion pcntl_sigwaitinfo unterbricht die Ausführung des aufrufenden Skripts, bis eines der in signals angegebenen Signale zugestellt wird. Ist - eines der Signale bereits ausstehend (z. B. durch + eines der Signale bereits ausstehend (&zb; durch pcntl_sigprocmask blockiert), kehrt pcntl_sigwaitinfo sofort zurück. From 8df963f451d9322dfce967cce0b7fa13de99c193 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Fri, 29 May 2026 20:00:24 +0200 Subject: [PATCH 3/4] Update reference/pcntl/functions/pcntl-sigwaitinfo.xml Co-authored-by: Martin Samesch --- reference/pcntl/functions/pcntl-sigwaitinfo.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/pcntl/functions/pcntl-sigwaitinfo.xml b/reference/pcntl/functions/pcntl-sigwaitinfo.xml index fb419b8af..d790f9f58 100644 --- a/reference/pcntl/functions/pcntl-sigwaitinfo.xml +++ b/reference/pcntl/functions/pcntl-sigwaitinfo.xml @@ -88,7 +88,7 @@ &reftitle.returnvalues; - Gibt bei Erfolg eine Signalnummer zurück,&return.falseforfailure;. + Gibt bei Erfolg eine Signalnummer zurück. &return.falseforfailure; From cec883b687851af0640e4642f6e21c38b88f64f3 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Fri, 29 May 2026 20:00:33 +0200 Subject: [PATCH 4/4] Update reference/pcntl/functions/pcntl-signal-get-handler.xml Co-authored-by: Martin Samesch --- reference/pcntl/functions/pcntl-signal-get-handler.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/pcntl/functions/pcntl-signal-get-handler.xml b/reference/pcntl/functions/pcntl-signal-get-handler.xml index aedbe30c1..e46a9413e 100644 --- a/reference/pcntl/functions/pcntl-signal-get-handler.xml +++ b/reference/pcntl/functions/pcntl-signal-get-handler.xml @@ -38,7 +38,7 @@ Diese Funktion kann einen Integer-Wert zurückgeben, der sich auf SIG_DFL oder SIG_IGN bezieht. - Wurde ein eigener Handler gesetzt, wird dieser callable + Wurde ein eigener Handler gesetzt, wird dieses callable zurückgegeben.