summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBruno Haible <bruno@clisp.org>2020-06-28 22:10:32 +0200
committerBruno Haible <bruno@clisp.org>2020-06-28 22:12:49 +0200
commit3f70affe3ee2c5378965c8bf9d235af54837ec15 (patch)
treec2d6ee902683e31e99c868aba301cdcf982c0efc /doc
parent70872213ef6614cf52d5978a5fdf8b9e628fc786 (diff)
downloadgnulib-3f70affe3ee2c5378965c8bf9d235af54837ec15.tar.gz
doc: Add a note about sigprocmask vs. pthread_sigmask.
* doc/posix-functions/sigprocmask.texi: Add note.
Diffstat (limited to 'doc')
-rw-r--r--doc/posix-functions/sigprocmask.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/posix-functions/sigprocmask.texi b/doc/posix-functions/sigprocmask.texi
index 20b5405e00..1a1379a21d 100644
--- a/doc/posix-functions/sigprocmask.texi
+++ b/doc/posix-functions/sigprocmask.texi
@@ -16,3 +16,10 @@ mingw, MSVC 14.
Portability problems not fixed by Gnulib:
@itemize
@end itemize
+
+Note: Although @code{sigprocmask} officially has undefined behaviour in
+multi-threaded programs, in practice it is essentially equivalent to
+@code{pthread_sigmask}, with only a difference regarding the error
+return convention. It's simpler to use @code{sigprocmask}, since it does
+not require linking with @code{-lpthread} on some platforms:
+glibc, NetBSD, OpenBSD, AIX, IRIX.