PWCACHE(3) BSD Programmer's Manual PWCACHE(3)NAME
pwcache, user_from_uid, group_from_gid - cache password and group entries
SYNOPSIS
#include <sys/types.h>
#include <pwd.h>
char *
user_from_uid(uid_t uid, int nouser);
#include <sys/types.h>
#include <grp.h>
char *
group_from_gid(gid_t gid, int nogroup);
DESCRIPTION
The user_from_uid() function returns the user name associated with the
argument uid. The user name is cached so that multiple calls with the
same uid do not require additional calls to getpwuid(3). If there is no
user associated with the uid, a pointer is returned to a string represen-
tation of the uid, unless the argument nouser is non-zero, in which case
a NULL pointer is returned.
The group_from_gid() function returns the group name associated with the
argument gid. The group name is cached so that multiple calls with the
same gid do not require additional calls to getgrgid(3). If there is no
group associated with the gid, a pointer is returned to a string repre-
sentation of the gid, unless the argument nogroup is non-zero, in which
case a NULL pointer is returned.
SEE ALSOgetgrgid(3), getpwuid(3)HISTORY
The user_from_id() and group_from_id() functions first appeared in
4.4BSD.
BUGS
The user_from_id() and group_from_id() functions may not be safely called
concurrently from multiple threads, e.g., the interfaces described by
pthreads(3).
BSDI BSD/OS June 9, 1993 1