From 6f160ed60fc4320516e47215ec5061a21e580a8e Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 8 Jun 2026 14:34:45 +0200 Subject: [PATCH] =?UTF-8?q?Sync=20EN:=20Dokumentation=20f=C3=BCr=206=20neu?= =?UTF-8?q?e=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 - - - - -