NAME

       uidinfo, uihashinit, uifind, uihold, uifree — functions for managing UID information

SYNOPSIS

       #include <sys/param.h>
       #include <sys/proc.h>
       #include <sys/resourcevar.h>

       void
       uihashinit(void);

       struct uidinfo *
       uifind(uid_t uid);

       void
       uihold(struct uidinfo *uip);

       void
       uifree(struct uidinfo *uip);

DESCRIPTION

       The  uidinfo  family of functions is used to manage uidinfo structures.  Each uidinfo structure maintains
       per uid resource consumption counts, including the process count and socket buffer space usage.

       The uihashinit() function initializes the uidinfo hash table and its mutex.  This function should only be
       called during system initialization.

       The uifind() function looks up and returns the uidinfo structure for uid.  If no uidinfo structure exists
       for uid, a new structure will be allocated and initialized.  The  uidinfo  hash  mutex  is  acquired  and
       released.

       The uihold() function increases the reference count on uip.  uip's lock is acquired and released.

       The  uifree()  function  decreases  the  reference count on uip, and if the count reaches 0 uip is freed.
       uip's lock is acquired and release and the uidinfo hash mutex may be acquired and released.

RETURN VALUES

       uifind() returns a pointer to an initialized uidinfo structure, and should not fail.

AUTHORS

       This manual page was written by Chad David <davidc@acns.ab.ca>.

Debian                                            July 10, 2001                                       UIDINFO(9)