Man Fgetpwent en anglais
FGETPWENT(3)               Linux Programmer's Manual              FGETPWENT(3)



 

NAME


       fgetpwent - get password file entry

 

SYNOPSIS


       #include 
       #include 
       #include 

       struct passwd *fgetpwent(FILE *stream);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       fgetpwent(): _SVID_SOURCE

 

DESCRIPTION






       The  fgetpwent()  function  returns a pointer to a structure containing
       the broken out fields of a line in the file stream.  The first time  it
       is called it returns the first entry; thereafter, it returns successive
       entries.  The file referred to by stream must have the same  format  as
       /etc/passwd (see passwd(5)).

       The passwd structure is defined in  as follows:

           struct passwd {
               char   *pw_name;       /* username */
               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  fgetpwent()  function  returns a pointer to a 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


       SVr4.

 

SEE ALSO


       endpwent(3), fgetpwent_r(3), fopen(3),  getpw(3),  getpwent(3),  getpw-
       nam(3), getpwuid(3), putpwent(3), setpwent(3), passwd(5)

 

COLOPHON


       This  page  is  part of release 3.05 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.



GNU                               2008-07-10                      FGETPWENT(3)