Skip to contentSkip to conversation

clone.2, fork.2: Document ERESTARTNOINTR error code

PATCH In review Nikola Forró 2 participants 2 messages May 4, 2016 – May 9, 2016 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 clone.2, fork.2: Document ERESTARTNOINTR error code

Since Linux 2.6.17, clone and fork syscalls return ERESTARTNOINTR when interrupted by a signal before newly created process is added to its process group.
This error code can only be seen by ptrace at syscall exit tracing.

The information was obtained from kernel source code:
http://bit.ly/24xdofn

---
 man2/clone.2 | 4 ++++
 man2/fork.2  | 4 ++++
 2 files changed, 8 insertions(+)
man2/clone.2 +4 -0
index 8373700..ab1e58d 100644
@@ -1013,6 +1013,10 @@ and the call would cause the limit on the number of
 nested user namespaces to be exceeded.
 See
 .BR user_namespaces (7).
+.TP
+.BR ERESTARTNOINTR " (since Linux 2.6.17)"
+System call was interrupted by a signal and will be restarted.
+(This can be seen only during a trace.)
 .SH VERSIONS
 There is no entry for
 .BR clone ()
man2/fork.2 +4 -0
index 559a47f..3accc8c 100644
@@ -242,6 +242,10 @@ failed to allocate the necessary kernel structures because memory is tight.
 is not supported on this platform (for example,
 .\" e.g., arm (optionally), blackfin, c6x, frv, h8300, microblaze, xtensa
 hardware without a Memory-Management Unit).
+.TP
+.BR ERESTARTNOINTR " (since Linux 2.6.17)"
+System call was interrupted by a signal and will be restarted.
+(This can be seen only during a trace.)
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
 .SH NOTES
Signature · 7 lines
2.4.11


--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw
Quoted 7 lines · Nikola Forró

Since Linux 2.6.17, clone and fork syscalls return ERESTARTNOINTR when interrupted by a signal before newly created process is added to its process group.
This error code can only be seen by ptrace at syscall exit tracing.

The information was obtained from kernel source code:
http://bit.ly/24xdofn

Thanks Nikola. I see this relates to kernel commit 4a2c7a7837da. Patch applied.

Cheers,

Michael

Quoted 37 lines
---
 man2/clone.2 | 4 ++++
 man2/fork.2  | 4 ++++
 2 files changed, 8 insertions(+)
man2/clone.2 +4 -0
index 8373700..ab1e58d 100644
@@ -1013,6 +1013,10 @@ and the call would cause the limit on the number of
 nested user namespaces to be exceeded.
 See
 .BR user_namespaces (7).
+.TP
+.BR ERESTARTNOINTR " (since Linux 2.6.17)"
+System call was interrupted by a signal and will be restarted.
+(This can be seen only during a trace.)
 .SH VERSIONS
 There is no entry for
 .BR clone ()
man2/fork.2 +4 -0
index 559a47f..3accc8c 100644
@@ -242,6 +242,10 @@ failed to allocate the necessary kernel structures because memory is tight.
 is not supported on this platform (for example,
 .\" e.g., arm (optionally), blackfin, c6x, frv, h8300, microblaze, xtensa
 hardware without a Memory-Management Unit).
+.TP
+.BR ERESTARTNOINTR " (since Linux 2.6.17)"
+System call was interrupted by a signal and will be restarted.
+(This can be seen only during a trace.)
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
 .SH NOTES
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html