GETPWENT(3C)         INTERACTIVE UNIX System         GETPWENT(3C)



          NAME
               getpwent, getpwuid, getpwnam, setpwent, endpwent, fgetpwent
               - get password file entry

          SYNOPSIS
               #include <pwd.h>

               struct passwd *getpwent ( )

               struct passwd *getpwuid (uid)
               int uid;

               struct passwd *getpwnam (name)
               char *name;

               void setpwent ( )

               void endpwent ( )

               struct passwd *fgetpwent (f)
               FILE *f;

          DESCRIPTION
               The getpwent, getpwuid, and getpwnam functions each returns
               a pointer to an object with the following structure contain-
               ing the broken-out fields of a line in the /etc/passwd file.
               Each line in the file contains a ``passwd'' structure,
               declared in the <pwd.h> header file:

                    struct passwd {
                         char *pw_name;
                         char *pw_passwd;
                         int  pw_uid;
                         int  pw_gid;
                         char *pw_age;
                         char *pw_comment;
                         char *pw_gecos;
                         char *pw_dir;
                         char *pw_shell;
                    };

               This structure is declared in <pwd.h> so it is not necessary
               to redeclare it.

               The fields have meanings described in passwd(4).

               The getpwent function when first called, returns a pointer
               to the first passwd structure in the file; thereafter, it
               returns a pointer to the next passwd structure in the file;
               so successive calls can be used to search the entire file.
               Getpwuid searches from the beginning of the file until a
               numerical user ID matching uid is found and returns a
               pointer to the particular structure in which it was found.


          Rev. C Software Development Set                            Page 1

          GETPWENT(3C)         INTERACTIVE UNIX System         GETPWENT(3C)



               Getpwnam searches from the beginning of the file until a
               login name matching name is found, and returns a pointer to
               the particular structure in which it was found.  If an end-
               of-file or an error is encountered on reading, these func-
               tions return a NULL pointer.

               A call to setpwent has the effect of rewinding the password
               file to allow repeated searches.  Endpwent may be called to
               close the password file when processing is complete.

               Fgetpwent returns a pointer to the next passwd structure in
               the stream f, which matches the format of /etc/passwd.

          FILES
               /etc/passwd

          SEE ALSO
               getlogin(3C), getgrent(3C), passwd(4).

          DIAGNOSTICS
               A NULL pointer is returned on EOF or error.

          WARNING
               The above routines use <stdio.h>, which causes them to
               increase the size of programs, not otherwise using standard
               I/O, more than might be expected.

          CAVEAT
               All information is contained in a static area, so it must be
               copied if it is to be saved.

























          Rev. C Software Development Set                            Page 2