Changeset 8741d2c in rtems-docs

Timestamp:

09/06/22 22:31:18 (15 months ago)

Author:

Joel Sherrill <joel@…>

Branches:

master

Children:

c33cca3

Parents:

4f9e9e5

Message:

posix-users/process_creation_and_execution.rst: Update pthread_atfork()

Updates #4713.

File:

• posix-users/process_creation_and_execution.rst (modified) (2 diffs)

posix-users/process_creation_and_execution.rst

@@ -314 +314 @@
  :class: rtems-table
 
- * - ``ENOSYS``
-   - This routine is not supported by RTEMS.
-
-**DESCRIPTION:**
-
-This routine is not supported by RTEMS.
-
-**NOTES:**
-
-NONE
+ * - ``0``
+   - This routine is a non-functional stub.
+
+**DESCRIPTION:**
+
+This routine is non-functional stub.
+
+**NOTES:**
+
+The POSIX specification for ``pthread_atfork()`` does not address the behavior
+when in a single process environment. Originally, the RTEMS implementation
+returned -1 and set errno to ``ENOSYS``. This was an arbitrary decision
+part with no basis from the wider POSIX community. The FACE Technical
+Standard includes profiles without multiple process support and defined
+the behavior in a single process environment to return 0. Logically, the
+application can register atfork handlers but they will never be invoked.
 
 .. _wait:
@@ -345 +351 @@
 
 .. list-table::
- :class: rtems-table
+ 
 
  * - ``ENOSYS``