getuinfo Subroutine

Purpose

Finds a value associated with a user.

Library

Standard C Library (libc.a)

Syntax

char *getuinfo (Name)
char *Name;

Description

The getuinfo subroutine finds a value associated with a user. This subroutine searches a user information buffer for a string of the form Name=Value and returns a pointer to the Value substring if the Name value is found. A null value is returned if the Name value is not found.

The INuibp global variable points to the user information buffer:

extern char *INuibp;

This variable is initialized to a null value.

If the INuibp global variable is null when the getuinfo subroutine is called, the usrinfo subroutine is called to read user information from the kernel into a local buffer. The INUuibp is set to the address of the local buffer. If the INuibp external variable is not set, the usrinfo subroutine is automatically called the first time the getuinfo subroutine is called.

Parameter

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

List of Security and Auditing Subroutines, Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.