GETPWENT(3C)            COMMAND REFERENCE            GETPWENT(3C)



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

SYNOPSIS
     #include <pwd.h>

     struct passwd *getpwent()

     struct passwd *getpwuid(uid)
     int uid;

     struct passwd *getpwnam(name)
     char *name;

     int setpwent()

     int endpwent()

DESCRIPTION
     Getpwent, getpwuid, and getpwnam each return a pointer to an
     object with the following structure containing the broken-
     out fields of a line in the password file.



          /*
           * pwd.h
           *
           * Modifications from 4.2bsd
           * Copyright (c) 1984, Tektronix Inc.
           * All Rights Reserved
           */
          struct    passwd { /* see getpwent(3) */
               char *pw_name;
               char *pw_passwd;
               int  pw_uid;
               int  pw_gid;
               int  pw_quota;
               char *pw_comment;
               char *pw_gecos;
               char *pw_dir;
               char *pw_shell;
          };

          struct passwd *getpwent(), *getpwuid(), *getpwnam();



     The fields pwquota and pwcomment are  unused;  the  others
     have meanings described in passwd(5).




Printed 10/17/86                                                1

GETPWENT(3C)            COMMAND REFERENCE            GETPWENT(3C)



     Getpwent  reads  the  next  line  (opening   the   file   if
     necessary); setpwent rewinds the file; endpwent closes it.

     Getpwuid and getpwnam search  from  the  beginning  until  a
     matching uid or name is found (or until EOF is encountered).

FILES
     /etc/passwd

DIAGNOSTICS
     Null pointer (0) returned on EOF or error.

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

SEE ALSO
     getlogin(3c), getgrent(3c), passwd(5).





































Printed 10/17/86                                                2

%%index%%
na:72,115;
sy:187,1060;
de:1247,1217;2608,518;
fi:3126,72;
di:3198,127;
ca:3325,151;
se:3476,183;
%%index%%000000000131