xref: /original-bsd/lib/libc/gen/pwcache.3 (revision faf3fd95)
Copyright (c) 1989 The Regents of the University of California.
All rights reserved.

%sccs.include.redist.man%

@(#)pwcache.3 5.3 (Berkeley) 06/23/90

PWCACHE 3 ""
C 7
NAME
pwcache - cache password and group entries
SYNOPSIS
user_from_uid(uid, nouser)
uid_t uid;
int nouser;

group_from_gid(gid, nogroup)
gid_t gid;
int nogroup;
DESCRIPTION
This interface is not part of the C library. It has been placed in the Berkeley utility library, libutil, as it is used by several standard utilities.

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 an ASCII representation 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 an ASCII representation of the gid, unless the argument nogroup is non-zero, in which case a NULL pointer is returned.

SEE ALSO
getgrgid(3), getpwuid(3)