From 6f160ed60fc4320516e47215ec5061a21e580a8e Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 8 Jun 2026 14:34:45 +0200 Subject: [PATCH 1/2] =?UTF-8?q?Sync=20EN:=20Dokumentation=20f=C3=BCr=206?= =?UTF-8?q?=20neue=20pcntl-Funktionen=20(PHP=208.4)=20=C3=BCbersetzen?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/pcntl/functions/pcntl-forkx.xml | 80 ++++++++++ reference/pcntl/functions/pcntl-getcpu.xml | 62 ++++++++ ...etqos_class.xml => pcntl-getqos-class.xml} | 25 +-- reference/pcntl/functions/pcntl-setns.xml | 86 +++++++++++ .../pcntl/functions/pcntl-setqos-class.xml | 79 ++++++++++ .../pcntl/functions/pcntl-wifcontinued.xml | 75 +++++++++ .../pcntl/functions/pcntl_setqos_class.xml | 143 ------------------ 7 files changed, 390 insertions(+), 160 deletions(-) create mode 100644 reference/pcntl/functions/pcntl-forkx.xml create mode 100644 reference/pcntl/functions/pcntl-getcpu.xml rename reference/pcntl/functions/{pcntl_getqos_class.xml => pcntl-getqos-class.xml} (66%) create mode 100644 reference/pcntl/functions/pcntl-setns.xml create mode 100644 reference/pcntl/functions/pcntl-setqos-class.xml create mode 100644 reference/pcntl/functions/pcntl-wifcontinued.xml delete mode 100644 reference/pcntl/functions/pcntl_setqos_class.xml diff --git a/reference/pcntl/functions/pcntl-forkx.xml b/reference/pcntl/functions/pcntl-forkx.xml new file mode 100644 index 000000000..943ccc094 --- /dev/null +++ b/reference/pcntl/functions/pcntl-forkx.xml @@ -0,0 +1,80 @@ + + + + + pcntl_forkx + Erzeugt einen Kindprozess mittels forkx(2) + + + + &reftitle.description; + + intpcntl_forkx + intflags + + + Die Funktion pcntl_forkx erzeugt einen Kindprozess + mittels des Systemaufrufs forkx(2), der auf illumos- + und Solaris-Systemen verfügbar ist. + + + + + &reftitle.parameters; + + + flags + + + Der Parameter flags steuert das Verhalten des + Forks. 0 für das Standardverhalten übergeben oder + FORK_NOSIGCHLD, um zu verhindern, dass das Signal + SIGCHLD an den Elternprozess gesendet wird, wenn + der Kindprozess endet. + + + + + + + + &reftitle.returnvalues; + + Bei Erfolg wird die PID des Kindprozesses an den Ausführungsstrang des + Elternprozess und eine 0 an den Ausführungsstrang des + Kindes zurückgegeben. Bei einem Fehlschlag wird -1 im + Kontext des Elternprozess zurückgegeben, kein Kindprozess erzeugt und ein + PHP-Fehler ausgelöst. + + + + + &reftitle.seealso; + + pcntl_fork + pcntl_rfork + pcntl_waitpid + + + + + diff --git a/reference/pcntl/functions/pcntl-getcpu.xml b/reference/pcntl/functions/pcntl-getcpu.xml new file mode 100644 index 000000000..141bd9dab --- /dev/null +++ b/reference/pcntl/functions/pcntl-getcpu.xml @@ -0,0 +1,62 @@ + + + + + pcntl_getcpu + Ermittelt die Nummer der CPU, auf der der aufrufende Prozess zuletzt ausgeführt wurde + + + + &reftitle.description; + + intpcntl_getcpu + + + + pcntl_getcpu gibt die Nummer der CPU zurück, auf der + der aufrufende Prozess zuletzt ausgeführt wurde. Diese Funktion verwendet + den unter Linux verfügbaren Systemaufruf sched_getcpu(3). + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt die CPU-Nummer als &integer; zurück. + + + + + &reftitle.seealso; + + pcntl_getcpuaffinity + pcntl_setcpuaffinity + + + + + diff --git a/reference/pcntl/functions/pcntl_getqos_class.xml b/reference/pcntl/functions/pcntl-getqos-class.xml similarity index 66% rename from reference/pcntl/functions/pcntl_getqos_class.xml rename to reference/pcntl/functions/pcntl-getqos-class.xml index 14c869e01..6e453f54a 100644 --- a/reference/pcntl/functions/pcntl_getqos_class.xml +++ b/reference/pcntl/functions/pcntl-getqos-class.xml @@ -1,10 +1,9 @@ - - + pcntl_getqos_class - Gibt die QoS-Klasse des aktuellen Threads zurück + Ermittelt die aktuelle Quality-of-Service-Klasse des Prozesses @@ -14,11 +13,11 @@ - Ermittelt die QoS-Klasse. + Gibt die aktuelle Quality-of-Service-Klasse (QoS) des + aufrufenden Prozesses zurück. Diese Funktion ist nur unter macOS + verfügbar, das QoS-Klassen zur Steuerung von + Energieeffizienz und Leistung verwendet. - - Diese Funktion ist nur auf Apple-Plattformen verfügbar. - @@ -29,15 +28,8 @@ &reftitle.returnvalues; - Gibt die Pcntl\QosClass zurück. - - - - - &reftitle.errors; - - Wirft einen Error, wenn der zugrunde liegende Aufruf von - pthread_get_qos_class_np() fehlschlägt. + Gibt einen Enum-Wert Pcntl\QosClass zurück, der die + aktuelle QoS-Klasse repräsentiert. @@ -45,7 +37,6 @@ &reftitle.seealso; pcntl_setqos_class - Pcntl\QosClass diff --git a/reference/pcntl/functions/pcntl-setns.xml b/reference/pcntl/functions/pcntl-setns.xml new file mode 100644 index 000000000..d728f6149 --- /dev/null +++ b/reference/pcntl/functions/pcntl-setns.xml @@ -0,0 +1,86 @@ + + + + + pcntl_setns + Verknüpft den aufrufenden Prozess mit einem Namespace eines anderen Prozesses neu + + + + &reftitle.description; + + boolpcntl_setns + intnullprocess_id&null; + intnstypeCLONE_NEWNET + + + Verknüpft den aufrufenden Prozess mit einem Linux-Namespace des durch + process_id angegebenen Prozesses neu; dabei werden + ein per pidfd_open(2) ermittelter pidfd und + setns(2) verwendet. + + + + + &reftitle.parameters; + + + process_id + + + Die Prozess-ID des Zielprozesses, dessen Namespace beigetreten werden + soll. Bei &null; wird die eigene PID des aufrufenden Prozesses + verwendet. + + + + + nstype + + + Der Namespace-Typ, mit dem neu verknüpft werden soll. Standard ist + CLONE_NEWNET (Netzwerk-Namespace). Mögliche Werte + sind unter anderem CLONE_NEWNET, + CLONE_NEWIPC, + CLONE_NEWUTS und weitere. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.seealso; + + pcntl_unshare + + + + + diff --git a/reference/pcntl/functions/pcntl-setqos-class.xml b/reference/pcntl/functions/pcntl-setqos-class.xml new file mode 100644 index 000000000..4ef8d4931 --- /dev/null +++ b/reference/pcntl/functions/pcntl-setqos-class.xml @@ -0,0 +1,79 @@ + + + + + pcntl_setqos_class + Setzt die Quality-of-Service-Klasse des Prozesses + + + + &reftitle.description; + + voidpcntl_setqos_class + Pcntl\QosClassqos_classPcntl\QosClass::Default + + + Setzt die Quality-of-Service-Klasse (QoS) des + aufrufenden Prozesses. Diese Funktion ist nur unter macOS verfügbar, das + QoS-Klassen zur Steuerung von Energieeffizienz und + Leistung verwendet. + + + + + &reftitle.parameters; + + + qos_class + + + Die zu setzende QoS-Klasse. Muss einer der + Enum-Werte von Pcntl\QosClass sein: + + + Pcntl\QosClass::UserInteractive + Pcntl\QosClass::UserInitiated + Pcntl\QosClass::Default + Pcntl\QosClass::Utility + Pcntl\QosClass::Background + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.seealso; + + pcntl_getqos_class + + + + + diff --git a/reference/pcntl/functions/pcntl-wifcontinued.xml b/reference/pcntl/functions/pcntl-wifcontinued.xml new file mode 100644 index 000000000..f01d0d8dd --- /dev/null +++ b/reference/pcntl/functions/pcntl-wifcontinued.xml @@ -0,0 +1,75 @@ + + + + + pcntl_wifcontinued + Prüft, ob der Kindprozess nach einem Job-Control-Stopp fortgesetzt wurde + + + + &reftitle.description; + + boolpcntl_wifcontinued + intstatus + + + Prüft, ob der Kindprozess, der die Rückkehr von + pcntl_waitpid verursachte, nach einem + Job-Control-Stopp fortgesetzt wurde. Diese Funktion ist nur nützlich, wenn + der Aufruf von pcntl_waitpid mit der Option + WCONTINUED erfolgte. + + + + + &reftitle.parameters; + + + status + + &pcntl.parameter.status; + + + + + + + &reftitle.returnvalues; + + Gibt &true; zurück, wenn der Kindprozess, der die Rückkehr von + pcntl_waitpid verursachte, nach einem + Job-Control-Stopp fortgesetzt wurde, andernfalls &false;. + + + + + &reftitle.seealso; + + pcntl_waitpid + pcntl_wifstopped + pcntl_wifexited + pcntl_wifsignaled + + + + + diff --git a/reference/pcntl/functions/pcntl_setqos_class.xml b/reference/pcntl/functions/pcntl_setqos_class.xml deleted file mode 100644 index 08ff88be1..000000000 --- a/reference/pcntl/functions/pcntl_setqos_class.xml +++ /dev/null @@ -1,143 +0,0 @@ - - - - - - pcntl_setqos_class - Setzt die QoS-Klasse des aktuellen Threads - - - - &reftitle.description; - - voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default - - - Legt die QoS-Klasse fest. - - - - - &reftitle.parameters; - - - qos_class - - - Die Quality-of-Service-Klasse, die dem aktuellen Thread zugewiesen - werden soll. Das Betriebssystem nutzt sie als Hinweis für die - Planung von CPU-Zeit, E/A-Priorität und Energieverbrauch; höhere - Klassen verdrängen niedrigere. Die verfügbaren Werte sind unter - Pcntl\QosClass aufgeführt. - - - - - Pcntl\QosClass::UserInteractive - - - Höchste Priorität. Vorgesehen für Arbeiten, die unmittelbar - eine Benutzeroberfläche steuern und nahezu sofort abgeschlossen - sein müssen, um spürbare Verzögerungen zu vermeiden, etwa - Ereignisverarbeitung oder Zeichnen. - - - - - Pcntl\QosClass::UserInitiated - - - Hohe Priorität, knapp unterhalb von - UserInteractive. Vorgesehen für Arbeiten, - die der Benutzer explizit angestoßen hat und auf deren Ergebnis - er aktiv wartet; Abschluss innerhalb weniger Sekunden zu erwarten. - - - - - Pcntl\QosClass::Default - - - Standardpriorität, wenn keine spezifischere Klasse passt. Wird - nach höher priorisierten Arbeiten ausgeführt, aber vor - Utility und Background. - - - - - Pcntl\QosClass::Utility - - - Niedrigere Priorität, vorgesehen für länger laufende Arbeiten, - die dem Benutzer bewusst sind, auf die er aber nicht aktiv - wartet, etwa Downloads, Importe oder umfangreiche Berechnungen. - Energieeffizient eingeplant. - - - - - Pcntl\QosClass::Background - - - Niedrigste Priorität, vorgesehen für Arbeiten, die dem Benutzer - nicht bewusst sind, etwa Prefetching, Indexierung oder Wartung. - Stark auf Energieeffizienz optimiert; kann bei Systemlast - aufgeschoben werden. - - - - - - - - - - Diese Funktion ist nur auf Apple-Plattformen verfügbar. - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - Wirft einen Error, wenn der zugrunde liegende Aufruf von - pthread_set_qos_class_self_np() fehlschlägt. - - - - - &reftitle.seealso; - - pcntl_getqos_class - Pcntl\QosClass - - - - - From afa11638042723c97fc59a4f8ce38a51fffae1ae Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 15 Jun 2026 11:30:01 +0200 Subject: [PATCH 2/2] [Sync EN] Add documentation for 6 new pcntl functions (PHP 8.4) --- reference/pcntl/functions/pcntl-forkx.xml | 4 +- .../pcntl/functions/pcntl-getqos-class.xml | 29 ++++-- .../pcntl/functions/pcntl-setqos-class.xml | 97 +++++++++++++++---- 3 files changed, 102 insertions(+), 28 deletions(-) diff --git a/reference/pcntl/functions/pcntl-forkx.xml b/reference/pcntl/functions/pcntl-forkx.xml index 943ccc094..7fd3ee041 100644 --- a/reference/pcntl/functions/pcntl-forkx.xml +++ b/reference/pcntl/functions/pcntl-forkx.xml @@ -41,9 +41,9 @@ &reftitle.returnvalues; Bei Erfolg wird die PID des Kindprozesses an den Ausführungsstrang des - Elternprozess und eine 0 an den Ausführungsstrang des + Elternprozesses und eine 0 an den Ausführungsstrang des Kindes zurückgegeben. Bei einem Fehlschlag wird -1 im - Kontext des Elternprozess zurückgegeben, kein Kindprozess erzeugt und ein + Kontext des Elternprozesses zurückgegeben, kein Kindprozess erzeugt und ein PHP-Fehler ausgelöst. diff --git a/reference/pcntl/functions/pcntl-getqos-class.xml b/reference/pcntl/functions/pcntl-getqos-class.xml index 6e453f54a..38478baf4 100644 --- a/reference/pcntl/functions/pcntl-getqos-class.xml +++ b/reference/pcntl/functions/pcntl-getqos-class.xml @@ -1,9 +1,9 @@ - + pcntl_getqos_class - Ermittelt die aktuelle Quality-of-Service-Klasse des Prozesses + Gibt die QoS-Klasse des aktuellen Threads zurück @@ -13,11 +13,12 @@ - Gibt die aktuelle Quality-of-Service-Klasse (QoS) des - aufrufenden Prozesses zurück. Diese Funktion ist nur unter macOS - verfügbar, das QoS-Klassen zur Steuerung von - Energieeffizienz und Leistung verwendet. + Ermittelt die Quality-of-Service-Klasse (QoS) des + aktuellen Threads. + + Diese Funktion ist nur auf Apple-Plattformen verfügbar. + @@ -28,8 +29,17 @@ &reftitle.returnvalues; - Gibt einen Enum-Wert Pcntl\QosClass zurück, der die - aktuelle QoS-Klasse repräsentiert. + Gibt die aktuelle QoS-Klasse als + Pcntl\QosClass zurück. + + + + + &reftitle.errors; + + Wirft einen Error, wenn der zugrunde + liegende Aufruf von pthread_get_qos_class_np() + fehlschlägt. @@ -37,6 +47,7 @@ &reftitle.seealso; pcntl_setqos_class + Pcntl\QosClass @@ -60,4 +71,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file diff --git a/reference/pcntl/functions/pcntl-setqos-class.xml b/reference/pcntl/functions/pcntl-setqos-class.xml index 4ef8d4931..7efb49565 100644 --- a/reference/pcntl/functions/pcntl-setqos-class.xml +++ b/reference/pcntl/functions/pcntl-setqos-class.xml @@ -1,22 +1,20 @@ - + pcntl_setqos_class - Setzt die Quality-of-Service-Klasse des Prozesses + Setzt die QoS-Klasse des aktuellen Threads &reftitle.description; voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default + Pcntl\QosClassqos_classPcntl\QosClass::Default - Setzt die Quality-of-Service-Klasse (QoS) des - aufrufenden Prozesses. Diese Funktion ist nur unter macOS verfügbar, das - QoS-Klassen zur Steuerung von Energieeffizienz und - Leistung verwendet. + Legt die Quality-of-Service-Klasse (QoS) des aktuellen + Threads fest. @@ -27,19 +25,74 @@ qos_class - Die zu setzende QoS-Klasse. Muss einer der - Enum-Werte von Pcntl\QosClass sein: + Die Quality-of-Service-Klasse, die dem aktuellen Thread zugewiesen + werden soll. Das Betriebssystem nutzt sie als Hinweis für die Planung + von CPU-Zeit, E/A-Priorität und Energieverbrauch; höhere Klassen + verdrängen niedrigere. Die verfügbaren Werte sind unter + Pcntl\QosClass aufgeführt. - - Pcntl\QosClass::UserInteractive - Pcntl\QosClass::UserInitiated - Pcntl\QosClass::Default - Pcntl\QosClass::Utility - Pcntl\QosClass::Background - + + + Pcntl\QosClass::UserInteractive + + + Höchste Priorität. Vorgesehen für Arbeiten, die unmittelbar eine + Benutzeroberfläche steuern und nahezu sofort abgeschlossen sein + müssen, um spürbare Verzögerungen zu vermeiden, etwa + Ereignisverarbeitung oder Zeichnen. + + + + + Pcntl\QosClass::UserInitiated + + + Hohe Priorität, knapp unterhalb von + UserInteractive. Vorgesehen für Arbeiten, die + der Benutzer explizit angestoßen hat und auf deren Ergebnis er + aktiv wartet; Abschluss innerhalb weniger Sekunden zu erwarten. + + + + + Pcntl\QosClass::Default + + + Standardpriorität, wenn keine spezifischere Klasse passt. Wird nach + höher priorisierten Arbeiten ausgeführt, aber vor + Utility und Background. + + + + + Pcntl\QosClass::Utility + + + Niedrigere Priorität, vorgesehen für länger laufende Arbeiten, die + dem Benutzer bewusst sind, auf die er aber nicht aktiv wartet, etwa + Downloads, Importe oder umfangreiche Berechnungen. Energieeffizient + eingeplant. + + + + + Pcntl\QosClass::Background + + + Niedrigste Priorität, vorgesehen für Arbeiten, die dem Benutzer + nicht bewusst sind, etwa Prefetching, Indexierung oder Wartung. + Stark auf Energieeffizienz optimiert; kann bei Systemlast + aufgeschoben werden. + + + + + + Diese Funktion ist nur auf Apple-Plattformen verfügbar. + @@ -49,10 +102,20 @@ + + &reftitle.errors; + + Wirft einen Error, wenn der zugrunde + liegende Aufruf von pthread_set_qos_class_self_np() + fehlschlägt. + + + &reftitle.seealso; pcntl_getqos_class + Pcntl\QosClass @@ -76,4 +139,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file