tail head cat sleep
QR code linking to this page

Manual Pages  — UIDINFO

NAME

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

CONTENTS

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, Ns, '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, Ns, '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 <Mt davidc@acns.ab.ca>.

UIDINFO (9) July 10, 2001

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

This philosophy, in the hands of amateurs, leads to inexplicably mind-numbing botches like the existence of two programs, “head” and “tail,” which print the first part or the last part of a file, depending. Even though their operations are duals of one another, “head” and “tail” are different programs, written by different authors, and take different options!
— The Unix Haters' handbook