diff options
Diffstat (limited to 'reference/C/MAN/getpwent.htm')
| -rw-r--r-- | reference/C/MAN/getpwent.htm | 99 |
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 <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=../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> |