User database access based on UID.
Syntax |
 |
#include <sys/types.h>
#include <pwd.h>
struct passwd *getpwuid(uid_t uid);
|
Parameters |
|
- uid
A value of a user ID.
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 getpwuid() function returns a pointer to an object of type struct passwd containing an entry from the group database with a matching uid or name. This structure, which is defined in <pwd.h>, includes the members shown in the following:
- 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 UID parameter is invalid. No matching entry was found in the passwd buffer. |
| | ACTION
| Specify a valid UID.
|
| ESYSERR | CAUSE
| The system detected an unexpected error. |
| | ACTION
| Report circumstances to HP.
|
See Also |
|
getlogin(), getpwnam() POSIX.1
