summaryrefslogtreecommitdiff
path: root/doc/glibc-functions/getgrouplist.texi
diff options
context:
space:
mode:
authorEric Blake <eblake@redhat.com>2013-05-22 14:21:36 -0600
committerEric Blake <eblake@redhat.com>2013-05-22 14:21:36 -0600
commite28fbd787cb4861a7848ac6e86c838912b8cd2ec (patch)
treef35049980a475917a916d0113f5136b90805c78e /doc/glibc-functions/getgrouplist.texi
parenteaa61c1d42dc605654a0e3073ac693a50bf1d2b8 (diff)
downloadgnulib-e28fbd787cb4861a7848ac6e86c838912b8cd2ec.tar.gz
getgroups: document portability issues
Because I actually managed to hit deadlock in libvirt's child process due to glibc's mutex use in user database lookup, I figured it is worth documenting the issue for others to be aware of when writing a privileged multithreaded parent app that spawns child processes owned by non-privileged ids. * doc/glibc-functions/initgroups.texi (initgroups): Mention multithread safety. * doc/posix-functions/getpwuid.texi (getpwuid): Likewise. * doc/posix-functions/getpwuid_r.texi (getpwuid_r): Likewise. * doc/glibc-functions/getgrouplist.texi (getgrouplist): Mention getugroups. * doc/posix-functions/getgroups.texi (getgroups): Mention multithread safety and mgetgroups. Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'doc/glibc-functions/getgrouplist.texi')
-rw-r--r--doc/glibc-functions/getgrouplist.texi2
1 files changed, 2 insertions, 0 deletions
diff --git a/doc/glibc-functions/getgrouplist.texi b/doc/glibc-functions/getgrouplist.texi
index e0dfa4976e..8a37cb1e9d 100644
--- a/doc/glibc-functions/getgrouplist.texi
+++ b/doc/glibc-functions/getgrouplist.texi
@@ -14,3 +14,5 @@ Portability problems not fixed by Gnulib:
This function is missing on some platforms:
Minix 3.1.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2011-11, Cygwin 1.7.9, mingw, MSVC 9, BeOS.
@end itemize
+
+The Gnulib module @code{getugroups} provides a similar API.