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 subrou-
     tine 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 subrou-
     tine is called if the INuibp variable has not been set.

Related Information

     In this book:  "usrinfo."