PWD.H(7) Miscellaneous Information Manual PWD.H(7)

pwd.h — password structure

#include <pwd.h>

The <pwd.h> header shall provide a definition for struct passwd, which shall include at least the following members:

char    *pw_name   User's login name.
uid_t    pw_uid    Numerical user ID.
gid_t    pw_gid    Numerical group ID.
char    *pw_dir    Initial working directory.
char    *pw_shell  Program to use as shell.

The gid_t and uid_t types shall be defined as described in <sys/types.h>.

The following shall be declared as functions and may also be defined as macros. Function prototypes shall be provided.

struct passwd *getpwnam(const char *);
struct passwd *getpwuid(uid_t);
[TSF]
int            getpwnam_r(const char *, struct passwd *, char *,
                   size_t, struct passwd **);
int            getpwuid_r(uid_t, struct passwd *, char *,
                   size_t, struct passwd **);

[XSI]
void           endpwent(void);
struct passwd *getpwent(void);
void           setpwent(void);

None.

None.

None.

<sys/types.h>, the System Interfaces volume of IEEE Std 1003.1-2001 (“POSIX.1”), endpwent(3), getpwnam(3), getpwuid(3)

First released in Issue 1.

The DESCRIPTION is updated for alignment with the POSIX Threads Extension.

The following new requirements on POSIX implementations derive from alignment with the Single UNIX Specification:

  • The gid_t and uid_t types are mandated.
  • The getpwnam_r(3) and getpwuid_r(3) functions are marked as part of the Thread-Safe Functions option.

footer end

January 1, 2004 posix.fail