getpwnam_r() — Search user database for a name

Standards

Format

#define _XOPEN_SOURCE 500
#include <sys/types.h>
#include <pwd.h>

int getpwnam_r(const char *nam, struct passwd *pwd,
char *buffer, size_t bufsize, struct passwd **result);

General description

The getpwnam_r() function updates the passwd structure pointed to by pwd and stores a pointer to that structure at the location pointed to by result. The structure will contain an entry from the user database with a matching name. Storage referenced by the structure is allocated from the memory provided with the buffer parameter, which is bufsize characters in size. A NULL pointer is returned at the location pointed to by result on error or if the requested entry is not found.

Returned value

If successful, getpwnam_r() returns 0.

Related information

• pwd.h
• sys/types.h
• endpwent() — User database functions
• getlogin() — Get the user login name
• getlogin_r() — Get login name
• getpwnam() — Access the user database by user name
• getpwuid() — Access the user database by user ID
• getpwuid_r() — Search user database for a user ID