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

- resolves #1330663
This commit is contained in:
Nikola Forró 2016-05-10 11:54:02 +02:00
parent 984120f479
commit df7c078442
2 changed files with 64 additions and 1 deletions

View File

@ -0,0 +1,55 @@
From 10e46057dd8de9042ae216c50f531c5fc94054f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nikola=20Forr=C3=B3?= <nforro@redhat.com>
Date: Wed, 4 May 2016 10:55:56 +0200
Subject: [PATCH] clone.2, fork.2: Document ERESTARTNOINTR error code
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
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
Signed-off-by: Nikola Forró <nforro@redhat.com>
---
man2/clone.2 | 4 ++++
man2/fork.2 | 4 ++++
2 files changed, 8 insertions(+)
diff --git a/man2/clone.2 b/man2/clone.2
index 8373700..ab1e58d 100644
--- a/man2/clone.2
+++ b/man2/clone.2
@@ -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 ()
diff --git a/man2/fork.2 b/man2/fork.2
index 559a47f..3accc8c 100644
--- a/man2/fork.2
+++ b/man2/fork.2
@@ -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
--
2.7.4

View File

@ -7,7 +7,7 @@
Summary: Linux kernel and C library user-space interface documentation
Name: man-pages
Version: 4.05
Release: 1%{?dist}
Release: 2%{?dist}
License: GPL+ and GPLv2+ and BSD and MIT and Copyright only and IEEE
Group: Documentation
URL: http://www.kernel.org/doc/man-pages/
@ -33,6 +33,9 @@ BuildArch: noarch
# https://bugzilla.kernel.org/show_bug.cgi?id=53781
Patch21: man-pages-3.42-close.patch
# Resolves: #1330663
Patch22: clone.2-fork.2-document-erestartnointr.patch
%description
A large collection of manual pages from the Linux Documentation Project (LDP).
@ -40,6 +43,7 @@ A large collection of manual pages from the Linux Documentation Project (LDP).
%setup -q -a 1 -a 2
%patch21 -p1
%patch22 -p1
# rename posix README so we don't have conflict
%{__mv} %{posix_name}/README %{posix_name}/%{posix_name}.README
@ -76,6 +80,10 @@ popd
%{_mandir}/man*/*
%changelog
* Tue May 10 2016 Nikola Forró <nforro@redhat.com> - 4.05-2
- clone.2, fork.2: document ERESTARTNOINTR error code
resolves #1330663
* Wed Mar 16 2016 Nikola Forró <nforro@redhat.com> - 4.05-1
- update to 4.05
resolves #1317877