GETUINFO(3,L)               AIX Technical Reference               GETUINFO(3,L)



-------------------------------------------------------------------------------
getuinfo



PURPOSE

Finds the value associated with a user information name.

LIBRARY

Standard C Library (libc.a)

SYNTAX

char *getuinfo (name)
char *name;

DESCRIPTION

The getuinfo subroutine searches a user information buffer for a string of the
form name=value and returns a pointer to the value substring if name is found.
NULL is returned if name is not found.

The user information buffer searched is pointed to by the global variable:

      extern char *INuibp;

This variable is initialized to NULL.

If the variable INuibp is NULL when the getuinfo subroutine is called, the
usrinfo system call is executed to read user information from the kernel into a
local buffer.  The address of the buffer is then put into the external variable
INuibp.  The usrinfo system call is automatically called the first time the
getuinfo subroutine is called if the INuibp variable has not been set.

RELATED INFORMATION

In this book:  "usrinfo."
















Processed November 7, 1990       GETUINFO(3,L)                                1