svn commit: r225898 - stable/8/lib/libc/sys

[Konstantin Belousov]

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 ,