getgroups: document portability issues
authorEric Blake <eblake@redhat.com>
Wed, 22 May 2013 20:21:36 +0000 (14:21 -0600)
committerEric Blake <eblake@redhat.com>
Wed, 22 May 2013 20:21:36 +0000 (14:21 -0600)
commite28fbd787cb4861a7848ac6e86c838912b8cd2ec
treef35049980a475917a916d0113f5136b90805c78e
parenteaa61c1d42dc605654a0e3073ac693a50bf1d2b8
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>
ChangeLog
doc/glibc-functions/getgrouplist.texi
doc/glibc-functions/initgroups.texi
doc/posix-functions/getgroups.texi
doc/posix-functions/getpwuid.texi
doc/posix-functions/getpwuid_r.texi