git: afe686823aa6 - stable/15 - pdfork.2: add EFAULT as possible error, explain some consequences of it

The branch stable/15 has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=afe686823aa6311ac9a74f35c6a1100511b521d8

commit afe686823aa6311ac9a74f35c6a1100511b521d8
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-02-16 10:18:07 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-02-21 09:48:58 +0000

    pdfork.2: add EFAULT as possible error, explain some consequences of it
    
    (cherry picked from commit db80ea9b88628168d2bb7f17a60b73568a8ea102)
---
 lib/libsys/pdfork.2 | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/lib/libsys/pdfork.2 b/lib/libsys/pdfork.2
index 9cbeb65bc4fc..49226cf069de 100644
--- a/lib/libsys/pdfork.2
+++ b/lib/libsys/pdfork.2
@@ -205,6 +205,24 @@ may return the same error numbers as
 .Xr fork 2 ) ,
 with the following additions:
 .Bl -tag -width Er
+.It Bq Er EFAULT
+The copyout of the resulting file descriptor value to the memory pointed
+to by
+.Fa fdp
+failed.
+.Pp
+Note that the child process was already created when this condition
+is detected,
+and the child continues execution, same as the parent.
+If this error must be handled, it is advisable to memoize the
+.Fn getpid
+result before the call to
+.Fn pdfork
+or
+.Fn pdrfork ,
+and compare it to the value returned by
+.Fn getpid
+after, to see if code is executing in parent or child.
 .It Bq Er EINVAL
 The signal number given to
 .Fn pdkill