Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 1 Oct 2011 12:35:10 +0000 (UTC)
From:      Konstantin Belousov <kib@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org
Subject:   svn commit: r225898 - stable/8/lib/libc/sys
Message-ID:  <201110011235.p91CZAoQ017272@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: kib
Date: Sat Oct  1 12:35:09 2011
New Revision: 225898
URL: http://svn.freebsd.org/changeset/base/225898

Log:
  MFC r225172:
  Clarify the behaviour of sigwait() on signal interruption, and note
  the difference between sigwait() and sigtimedwait()/sigwaitinfo().

Modified:
  stable/8/lib/libc/sys/sigwait.2
  stable/8/lib/libc/sys/sigwaitinfo.2
Directory Properties:
  stable/8/lib/libc/   (props changed)
  stable/8/lib/libc/stdtime/   (props changed)

Modified: stable/8/lib/libc/sys/sigwait.2
==============================================================================
--- stable/8/lib/libc/sys/sigwait.2	Sat Oct  1 12:19:48 2011	(r225897)
+++ stable/8/lib/libc/sys/sigwait.2	Sat Oct  1 12:35:09 2011	(r225898)
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 11, 2005
+.Dd August 24, 2011
 .Dt SIGWAIT 2
 .Os
 .Sh NAME
@@ -82,6 +82,14 @@ selected, it will be the lowest numbered
 The selection order between realtime
 and non-realtime signals, or between multiple pending non-realtime signals,
 is unspecified.
+.Sh IMPLEMENTATION NOTES
+The
+.Fn sigwait
+function is implemented as a wrapper around the
+.Fn __sys_sigwait
+system call, which retries the call on
+.Er EINTR
+error.
 .Sh RETURN VALUES
 If successful,
 .Fn sigwait

Modified: stable/8/lib/libc/sys/sigwaitinfo.2
==============================================================================
--- stable/8/lib/libc/sys/sigwaitinfo.2	Sat Oct  1 12:19:48 2011	(r225897)
+++ stable/8/lib/libc/sys/sigwaitinfo.2	Sat Oct  1 12:35:09 2011	(r225898)
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 11, 2005
+.Dd August 24, 2011
 .Dt SIGTIMEDWAIT 2
 .Os
 .Sh NAME
@@ -116,6 +116,16 @@ except that the selected signal number s
 member, and the cause of the signal shall be stored in the
 .Va si_code
 member.
+Besides this, the
+.Fn sigwaitinfo
+and
+.Fn sigtimedwait
+system calls may return
+.Er EINTR
+if interrupted by signal, which is not allowed for the
+.Fn sigwait
+function.
+.Pp
 If any value is queued to the selected signal, the first such queued
 value is dequeued and, if the info argument is
 .Pf non- Dv NULL ,



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201110011235.p91CZAoQ017272>