The Open Group Base Specifications Issue 6
IEEE Std 1003.1, 2004 Edition
Copyright © 2001-2004 The IEEE and The Open Group, All Rights reserved.

#### NAME

> pwd.h - password structure

#### SYNOPSIS

> `#include <pwd.h>`

#### DESCRIPTION

> 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);

The following sections are informative.

#### APPLICATION USAGE

> None.

#### RATIONALE

> None.

#### FUTURE DIRECTIONS

> None.

#### SEE ALSO

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

#### CHANGE HISTORY

> First released in Issue 1.

#### Issue 5

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

#### Issue 6

> 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() and getpwuid_r() functions are marked as part of the Thread-Safe Functions option.

End of informative text.

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
[ Main Index | XBD | XCU | XSH | XRAT ]