Skip to content

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

Merged
lacatoire merged 3 commits into
php:masterfrom
lacatoire:fix/pcntl-rfork-missing-flags
Aug 21, 2026
Merged

lacatoire merged 3 commits into
php:masterfrom
lacatoire:fix/pcntl-rfork-missing-flags

Conversation

@lacatoire

Copy link
Copy Markdown
Member

Fixes #5435

Add missing RFTSIGZMB and RFTHREAD flags to the parameters section and improve the signal parameter description.

Comment thread reference/pcntl/functions/pcntl-rfork.xml Outdated
Comment thread reference/pcntl/functions/pcntl-rfork.xml Outdated
@lacatoire
lacatoire force-pushed the fix/pcntl-rfork-missing-flags branch from 823a607 to a6be999 Compare June 23, 2026 14:12
Also improve the signal parameter description to clarify its
relationship with the RFTSIGZMB flag.
Co-authored-by: Louis-Arnaud <la.catoire@gmail.com>
@lacatoire
lacatoire force-pushed the fix/pcntl-rfork-missing-flags branch from a6be999 to e2d9828 Compare August 21, 2026 08:11
@lacatoire
lacatoire merged commit e43fb30 into php:master Aug 21, 2026
2 checks passed
@lacatoire
lacatoire deleted the fix/pcntl-rfork-missing-flags branch August 21, 2026 08:14
KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Sep 21, 2026
原文の php/doc-en@e43fb30 (php/doc-en#5446) に追従する。

- RFTSIGZMB と RFTHREAD の説明の追加
- signal パラメータが RFTSIGZMB を設定した場合にのみ使われることと、
  0 を指定するとシグナルを送信しなくなること
- RFLINUXTHPN の説明にあった SIGCHILD の誤りを SIGCHLD に修正
KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Sep 22, 2026
原文の php/doc-en@e43fb30 (php/doc-en#5446) に追従する。

- RFTSIGZMB と RFTHREAD の説明の追加
- signal パラメータが RFTSIGZMB を設定した場合にのみ使われることと、
  0 を指定するとシグナルを送信しなくなること
- RFLINUXTHPN の説明にあった SIGCHILD の誤りを SIGCHLD に修正
KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Sep 22, 2026
原文の php/doc-en@e43fb30 (php/doc-en#5446) に追従する。

- RFTSIGZMB と RFTHREAD の説明の追加
- signal パラメータが RFTSIGZMB を設定した場合にのみ使われることと、
  0 を指定するとシグナルを送信しなくなること
- RFLINUXTHPN の説明にあった SIGCHILD の誤りを SIGCHLD に修正
KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Sep 22, 2026
原文の php/doc-en@e43fb30 (php/doc-en#5446) に追従する。

- RFTSIGZMB と RFTHREAD の説明の追加
- signal パラメータが RFTSIGZMB を設定した場合にのみ使われることと、
  0 を指定するとシグナルを送信しなくなること
- RFLINUXTHPN の説明にあった SIGCHILD の誤りを SIGCHLD に修正
KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Sep 22, 2026
原文の php/doc-en@e43fb30 (php/doc-en#5446) に追従する。

- RFTSIGZMB と RFTHREAD の説明の追加
- signal パラメータが RFTSIGZMB を設定した場合にのみ使われることと、
  0 を指定するとシグナルを送信しなくなること
- RFLINUXTHPN の説明にあった SIGCHILD の誤りを SIGCHLD に修正
KentarouTakeda added a commit to php/doc-ja that referenced this pull request Sep 22, 2026
* pcntl_wait / pcntl_waitpid / pcntl_waitid の resource_usage パラメータの説明に追従

原文の php/doc-en@ec891f5 (php/doc-en#4917) に追従する。

- resource_usage に子プロセスのリソース使用状況の統計情報を含む連想配列が
  設定されること
- wait3(2) / wait4(2) / wait6(2) が利用できる場合にのみサポートされ、
  そうでない場合はパラメータが変更されないこと
- 子プロセスを回収できなかった場合に空の配列が設定されること
  (pcntl_wait / pcntl_waitpid)
- pcntl_waitpid の使用例と、seealso への pcntl_wait の追加

* pcntl_signal の restart_syscalls と errors セクションに追従

原文の php/doc-en@3866fba (php/doc-en#5821) に追従する。

- restart_syscalls の既定値 true が SIGALRM には適用されないこと
- signal が 1 未満または NSIG 以上の場合の ValueError と、
  handler が不正な場合の TypeError
- PHP 7.4.0 で restart_syscalls の指定が反映されるようになったこと
- ハンドラのシグネチャで第 1 引数名が signal となっていた誤りを signo に修正

* pcntl_rfork の RFTSIGZMB / RFTHREAD フラグに追従

原文の php/doc-en@e43fb30 (php/doc-en#5446) に追従する。

- RFTSIGZMB と RFTHREAD の説明の追加
- signal パラメータが RFTSIGZMB を設定した場合にのみ使われることと、
  0 を指定するとシグナルを送信しなくなること
- RFLINUXTHPN の説明にあった SIGCHILD の誤りを SIGCHLD に修正

* pcntl のシグナル関連関数の誤りを原文に合わせて修正

原文の php/doc-en@253f4bd (php/doc-en#5767) に追従する。

- pcntl_unshare の戻り値が 0 / -1 ではなく bool であることの修正
- pcntl_sigtimedwait / pcntl_sigwaitinfo が PHP 8.4.0 以降は失敗時に
  false を返すこと (これより前は -1 を返すことがあった)
- pcntl_sigprocmask が mode に SIG_SETMASK を指定した場合は
  空の signals を受け付けること
- pcntl_sigtimedwait の nanoseconds が 0 未満ではなく
  0 と 1e9 の間である必要があることの修正
- 存在しない定数 SI_MSGGQ の削除 (正しくは既出の SI_MESGQ)

* pcntl_exec の戻り値の誤りの修正と PHP 8.5 の ValueError に追従

原文の php/doc-en@253f4bd (php/doc-en#5767) と
php/doc-en@9ac246c (php/doc-en#5838) に追従する。

- 失敗した場合にのみ false を返し、成功した場合は現在のプロセスイメージが
  置き換えられるため関数から戻らないことの修正
- PHP 8.5.0 で args の要素、または env_vars の要素かキーに
  ヌルバイトが含まれる場合に ValueError をスローするようになったこと
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing flag: RFTSIGZMB in pcntl_rfork()

2 participants