svn commit: r299522 - stable/10/share/man/man3

[Konstantin Belousov]

Author: kib
Date: Thu May 12 06:55:42 2016
New Revision: 299522
URL: https://svnweb.freebsd.org/changeset/base/299522

Log:
  MFC r299115:
  Warn about consequences of suspending threads in arbitrary state of
  execution

Modified:
  stable/10/share/man/man3/pthread_resume_np.3
  stable/10/share/man/man3/pthread_suspend_all_np.3
  stable/10/share/man/man3/pthread_suspend_np.3
Directory Properties:
  stable/10/   (props changed)

Modified: stable/10/share/man/man3/pthread_resume_np.3
==============================================================================
--- stable/10/share/man/man3/pthread_resume_np.3	Thu May 12 06:53:22 2016	(r299521)
+++ stable/10/share/man/man3/pthread_resume_np.3	Thu May 12 06:55:42 2016	(r299522)
@@ -57,7 +57,7 @@ function will fail if:
 The value specified by the
 .Fa tid
 argument is invalid.
-.It Bq ESRC
+.It Bq Er ESRC
 No thread could be found corresponding to the thread ID specified by the
 .Fa tid
 argument.

Modified: stable/10/share/man/man3/pthread_suspend_all_np.3
==============================================================================
--- stable/10/share/man/man3/pthread_suspend_all_np.3	Thu May 12 06:53:22 2016	(r299521)
+++ stable/10/share/man/man3/pthread_suspend_all_np.3	Thu May 12 06:55:42 2016	(r299522)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 13, 2003
+.Dd May 5, 2016
 .Dt PTHREAD_SUSPEND_ALL_NP 3
 .Os
 .Sh NAME
@@ -44,6 +44,13 @@ The only exception is the current thread
 the thread that called the
 .Fn pthread_suspend_all_np
 function.
+.Pp
+It is not safe for the caller of the
+.Fn pthread_suspend_all_np
+function to use any non-async signal safe functions, besides
+.Xr pthread_resume_all_np 3 ,
+until threads are resumed, unless measures are taken to ensure
+that all threads are suspended at safe points.
 .Sh SEE ALSO
 .Xr pthread_resume_all_np 3 ,
 .Xr pthread_resume_np 3 ,

Modified: stable/10/share/man/man3/pthread_suspend_np.3
==============================================================================
--- stable/10/share/man/man3/pthread_suspend_np.3	Thu May 12 06:53:22 2016	(r299521)
+++ stable/10/share/man/man3/pthread_suspend_np.3	Thu May 12 06:55:42 2016	(r299522)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 13, 2003
+.Dd May 5, 2016
 .Dt PTHREAD_SUSPEND_NP 3
 .Os
 .Sh NAME
@@ -40,6 +40,13 @@
 The
 .Fn pthread_suspend_np
 function, called on an active thread, causes it to suspend.
+.Pp
+It is not safe for the caller of the
+.Fn pthread_suspend_np
+function to use any non-async signal safe functions, except
+.Xr pthread_resume_np 3 ,
+until suspended thread is resumed, unless measures are taken to ensure
+that the thread is suspended at a safe point.
 .Sh RETURN VALUES
 If successful,
 .Fn pthread_suspend_np
@@ -56,7 +63,7 @@ An attempt was made to suspend the curre
 The value specified by the
 .Fa tid
 argument is invalid.
-.It Bq ESRC
+.It Bq Er ESRC
 No thread could be found corresponding to the thread ID specified by the
 .Fa tid
 argument.