pwd.h

<pwd.h>(P)							   <pwd.h>(P)



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

	      int	     getpwnam_r(const char *, struct passwd *, char *,
				 size_t, struct passwd **);
	      int	     getpwuid_r(uid_t, struct passwd *, char *,
				 size_t, struct passwd **);


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

COPYRIGHT
       Portions	 of this text are reprinted and reproduced in electronic form
       from IEEE Std 1003.1, 2003 Edition, Standard for Information  Technol-
       ogy  --	Portable  Operating  System Interface (POSIX), The Open Group
       Base Specifications Issue 6, Copyright (C) 2001-2003 by the  Institute
       of  Electrical  and  Electronics Engineers, Inc and The Open Group. In
       the event of any discrepancy between this  version  and	the  original
       IEEE and The Open Group Standard, the original IEEE and The Open Group
       Standard is  the	 referee  document.  The  original  Standard  can  be
       obtained online at http://www.opengroup.org/unix/online.html .



POSIX				     2003			   <pwd.h>(P)