Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (g - h) getpwuid_r(3)
User Structure
The user passwd structure returned by the getpwuid_r( ) function is defined in the pwd.h header
file. The structure contains the following fields:
pw_name The user login name.
pw_passwd The current user password (not returned).
pw_uid The user ID of the user.
pw_gid The group ID of the primary group of the user.
pw_age The password aging string (not returned).
pw_comment Comment string (not returned).
pw_gecos Personal information about the user (not returned).
pw_dir The home directory of the user.
pw_shell The initial program for the user.
The pw_passwd, pw_age, pw_comment, and pw_gecos fields are provided for compatibility
with some versions of UNIX, but these fields always contain null strings.
Database Structure and Access
Traditional UNIX implementations access user and group information by sequentially reading
unstructured files. In contrast, an HP NonStop server stores user and group information in struc-
tured, key-sequenced, Enscribe files. User information is accessed using a primary or alternate
key. You can specifiy a username or user ID as a key.
Sequential access to user information is supported by storing the most recently used key in static
storage. The setpwent( ) function resets this key. The endpwent( ) function satisfies references
when linking user applications.
OSS user authentication database functions do not leave the database open between calls.
Authentication records for user aliases follow regular user-authentication records in the database.
NOTES
On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use
either the POSIX User Thread Model Library or the Standard POSIX Threads Library for
threaded applications.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, if you are |
NOT using the Standard POSIX Threads Library (this is not a threaded application or you are |
using the POSIX User Thread Model Library) you can use this function with 32-bit or 64-bit OSS |
applications.
If you are NOT using the Standard POSIX Threads Library (this is not a threaded application or
you are using the POSIX User Thread Model Library), you must:
• Include the pwd.h header file
• Link your application to:
/G/system/zdllnnn/zsecdll (32-bit applications)
or
/G/system/zdllnnn/ysecdll (64-bit applications) |
To use the Standard POSIX Threads library, you must:
527187-017 Hewlett-Packard Company 3−131