 
 <TITLE>getpwent</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>
<h3>GETPWENT(3)         Linux Programmer's Manual         GETPWENT(3)
</h3>
<h3>NAME
</h3>       getpwent, setpwent, endpwent - get password file entry
<h3>SYNOPSIS
</h3>       #include <pwd.h>
       #include <sys/types.h>
       struct passwd *getpwent(void);
       void setpwent(void);
       void endpwent(void);
<h3>DESCRIPTION
</h3>       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 */
              };
<h3>RETURN VALUE
</h3>       The  getpwent()  function returns the passwd structure, or
       NULL if there are no more entries or an error occurs.
<h3>ERRORS
</h3>       ENOMEM Insufficient memory to allocate passwd structure.
<h3>FILES
</h3>       /etc/passwdpassword database file
<h3>CONFORMING TO
</h3>       SVID 3, BSD 4.3
</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=fgetpwent.htm>fgetpwent</a>, 
<a href=getpwnam.htm>getpwnam</a>, 
<a href=getpwnam.htm>getpwuid</a>, 
<a href=getpw.htm>getpw</a>, 
<pre>
<h3>GNU                       April 9, 1993                         1
</h3>
</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../index.htm>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/index.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>
This manual page was brought to you by <i>mjl_man V-2.0</i>
| file: /Techref/language/ccpp/cref/MAN/getpwent.htm, 2KB, , updated: 2003/3/20 10:39, local time: 2025/10/31 03:51, 
 
216.73.216.212,10-3-97-86:LOG IN | 
| ©2025 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://massmind.org/techref/language/ccpp/cref/MAN/getpwent.htm"> getpwent</A> | 
| Did you find what you needed? | 
| Welcome to massmind.org! | 
| Welcome to massmind.org! | 
.