PWCACHE(3)                  BSD Programmer's Manual                 PWCACHE(3)

NAME
     pwcache - cache password and group entries

SYNOPSIS
     userfromuid(uidt uid, int nouser)

     groupfromgid(gidt 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 userfromuid() 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 represen-
     tation of the uid, unless the argument nouser is non-zero, in which case
     a NULL pointer is returned.

     The groupfromgid() 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 repre-
     sentation of the gid, unless the argument nogroup is non-zero, in which
     case a NULL pointer is returned.

SEE ALSO
     getgrgid(3),  getpwuid(3)

HISTORY
     The userfromid() and groupfromid() functions are currently under de-
     velopment.

BSDI BSD/386                    March 26, 1993                               1