getpwent - phpMan

GETPWENT(3)                Linux Programmer’s Manual               GETPWENT(3)



NAME
       getpwent, setpwent, endpwent - get password file entry

SYNOPSIS
       #include <sys/types.h>
       #include <pwd.h>

       struct passwd *getpwent(void);

       void setpwent(void);

       void endpwent(void);

DESCRIPTION
       The  getpwent() function returns a pointer to a structure containing the broken out
       fields of a line from /etc/passwd.  The first time it  is  called  it  returns  the
       first entry; thereafter, it returns successive entries.

       The  setpwent()  function  rewinds  the  file  pointer  to  the  beginning  of  the
       /etc/passwd file.

       The endpwent() function closes the /etc/passwd file.

       The passwd structure is defined in <pwd.h> as follows:

              struct passwd {
                    char    *pw_name;      /* user name */
                    char    *pw_passwd;    /* user password */
                    uid_t   pw_uid;        /* user id */
                    gid_t   pw_gid;        /* group id */
                    char    *pw_gecos;     /* real name */
                    char    *pw_dir;       /* home directory */
                    char    *pw_shell;     /* shell program */
              };

RETURN VALUE
       The getpwent() function returns the passwd structure, or NULL if there are no  more
       entries or an error occurs.

ERRORS
       ENOMEM Insufficient memory to allocate passwd structure.

FILES
       /etc/passwd
              password database file

CONFORMING TO
       SVID 3, BSD 4.3

SEE ALSO
       fgetpwent(3),   getpwent_r(3),  getpwnam(3),  getpwuid(3),  getpw(3),  putpwent(3),
       passwd(5)



GNU                               1996-05-27                       GETPWENT(3)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-09 07:45 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)