[DOC-CVS] [doc-en] master: Document missing RFTSIGZMB and RFTHREAD flags in pcntl_rfork() (#5446)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-08-21T10:14:29+02:00

Commit: https://github.com/php/doc-en/commit/e43fb30acb61e76ef50174ec84c2aa33674a3828
Raw diff: https://github.com/php/doc-en/commit/e43fb30acb61e76ef50174ec84c2aa33674a3828.diff

Document missing RFTSIGZMB and RFTHREAD flags in pcntl_rfork() (#5446)

* Document missing RFTSIGZMB and RFTHREAD flags in pcntl_rfork()

Also improve the signal parameter description to clarify its
relationship with the RFTSIGZMB flag.

* Apply suggestions from code review

Co-authored-by: Louis-Arnaud <[email protected]>

* Fix SIGCHILD typo in RFLINUXTHPN description

Changed paths:
  M  reference/pcntl/functions/pcntl-rfork.xml


Diff:

diff --git a/reference/pcntl/functions/pcntl-rfork.xml b/reference/pcntl/functions/pcntl-rfork.xml
index 720b43ef533a..e2442f57531c 100644
--- a/reference/pcntl/functions/pcntl-rfork.xml
+++ b/reference/pcntl/functions/pcntl-rfork.xml
@@ -48,9 +48,20 @@
          Is mutually exclusive with <constant>RFFDG</constant>.
         </member>
         <member>
-         <constant>RFLINUXTHPN</constant>: If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread exit for the child.
+         <constant>RFLINUXTHPN</constant>: If set, the kernel will return SIGUSR1 instead of SIGCHLD upon thread exit for the child.
          This is intended to do Linux clone exit parent notification.
         </member>
+        <member>
+         <constant>RFTSIGZMB</constant>: If set, the kernel will deliver the signal specified
+         by the <parameter>signal</parameter> parameter to the parent upon the child exit,
+         instead of the default SIGCHLD. Specifying signal number 0 disables signal
+         delivery upon the child exit.
+        </member>
+        <member>
+         <constant>RFTHREAD</constant>: If set, the new process shares file descriptor
+         to process leaders table with its parent. Only applies when neither
+         <constant>RFFDG</constant> nor <constant>RFCFDG</constant> are set.
+        </member>
        </simplelist>
       </para>
      </listitem>
@@ -58,9 +69,11 @@
     <varlistentry>
      <term><parameter>signal</parameter></term>
      <listitem>
-      <para>
-       The signal number.
-      </para>
+      <simpara>
+       The signal number to deliver to the parent when the child exits.
+       This is only used when the <constant>RFTSIGZMB</constant> flag is set.
+       Specifying <literal>0</literal> disables signal delivery upon the child exit.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>