getpwnam

User database access.

Syntax

 

   #include <sys/types.h>

   #include <pwd.h>

   struct passwd *getpwnam(const char *name);

Parameters

name: A character string value corresponding to the user name.

Return Values

Returns a pointer to an object of type struct passwd on success. The return values may point to static data that is overwritten by each cell.

A null pointer is returned on error or if the requested entry is not found.

Description

The getpwnam() function is used to obtain entry from the user database with a matching name. This structure, which is defined in <pwd.h>, includes the members shown below:

pw_name: User name
pw_uid: User ID number
pw_gid: Group ID number
pw_dir: Initial working directory
pw_shell: Initial User Program

Implementation Considerations

None.

Errors

If an error occurs, errno is set to one of the following values:

`EFAULT`	CAUSE	The system detected a NULL or bad address when attempting to allocate or access a struct passwd buffer.
	ACTION	Report circumstances to HP
`EINVAL`	CAUSE	The name parameter is invalid. No matching entry was found in the group database.
	ACTION	Specify a valid name.
`ESYSERR`	CAUSE	The system detected an unexpected error.
	ACTION	Report circumstances to HP.

getpwnam

Technical documentation

» Table of Contents

» Index