diff options
author | kib <kib@FreeBSD.org> | 2016-05-05 10:22:19 +0000 |
---|---|---|
committer | kib <kib@FreeBSD.org> | 2016-05-05 10:22:19 +0000 |
commit | aaff081bf201593832ad7b1a11fbd4a55d31f1e9 (patch) | |
tree | 52db4272f7e42ddd20657fc01507c766beaa103b /share/man/man3 | |
parent | 070c6cd670a6d4e5d1898e456dd8fa2d2220c14c (diff) | |
download | FreeBSD-src-aaff081bf201593832ad7b1a11fbd4a55d31f1e9.zip FreeBSD-src-aaff081bf201593832ad7b1a11fbd4a55d31f1e9.tar.gz |
Warn about consequences of suspending threads in arbitrary state of
execution.
While there, fix minor nits in markup.
Sponsored by: The FreeBSD Foundation
MFC after: 1 week
Diffstat (limited to 'share/man/man3')
-rw-r--r-- | share/man/man3/pthread_resume_np.3 | 2 | ||||
-rw-r--r-- | share/man/man3/pthread_suspend_all_np.3 | 9 | ||||
-rw-r--r-- | share/man/man3/pthread_suspend_np.3 | 11 |
3 files changed, 18 insertions, 4 deletions
diff --git a/share/man/man3/pthread_resume_np.3 b/share/man/man3/pthread_resume_np.3 index c8444d2..eba7568 100644 --- a/share/man/man3/pthread_resume_np.3 +++ b/share/man/man3/pthread_resume_np.3 @@ -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. diff --git a/share/man/man3/pthread_suspend_all_np.3 b/share/man/man3/pthread_suspend_all_np.3 index 9daedbf..ecedca3 100644 --- a/share/man/man3/pthread_suspend_all_np.3 +++ b/share/man/man3/pthread_suspend_all_np.3 @@ -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 , diff --git a/share/man/man3/pthread_suspend_np.3 b/share/man/man3/pthread_suspend_np.3 index 32138a1..e68b317 100644 --- a/share/man/man3/pthread_suspend_np.3 +++ b/share/man/man3/pthread_suspend_np.3 @@ -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 current thread. 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. |