summaryrefslogtreecommitdiff
path: root/reference/C/MAN/getpwent.htm
diff options
context:
space:
mode:
Diffstat (limited to 'reference/C/MAN/getpwent.htm')
-rw-r--r--reference/C/MAN/getpwent.htm99
1 files changed, 99 insertions, 0 deletions
diff --git a/reference/C/MAN/getpwent.htm b/reference/C/MAN/getpwent.htm
new file mode 100644
index 0000000..ac99174
--- /dev/null
+++ b/reference/C/MAN/getpwent.htm
@@ -0,0 +1,99 @@
+<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 &lt;pwd.h&gt;
+ #include &lt;sys/types.h&gt;
+
+ 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 &lt;pwd.h&gt; 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=../cref.html>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/funcref.htm>Functions</a>
+</td>
+</tr>
+</table>
+</center>
+<p>
+<hr>
+
+This manual page was brought to you by <i>mjl_man V-2.0</i>