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
Theuidinfo 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>.