From 7e0f021a9aec35fd8e6725e87e3313b101d26f5e Mon Sep 17 00:00:00 2001 From: Tobias Klauser Date: Sun, 27 Jan 2008 11:37:44 +0100 Subject: Initial import (2.0.2-6) --- reference/C/MAN/getpwent.htm | 99 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 reference/C/MAN/getpwent.htm (limited to 'reference/C/MAN/getpwent.htm') 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 @@ +getpwent + +
+
+
+
+
+
GETPWENT(3)         Linux Programmer's Manual         GETPWENT(3)
+

+
+
NAME
+
       getpwent, setpwent, endpwent - get password file entry
+
+
SYNOPSIS
+
       #include <pwd.h>
+       #include <sys/types.h>
+
+       struct passwd *getpwent(void);
+
+       void setpwent(void);
+
+       void endpwent(void);
+
+
DESCRIPTION
+
       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 */
+              };
+
+
RETURN VALUE
+
       The  getpwent()  function returns the passwd structure, or
+       NULL if there are no more entries or an error occurs.
+
+
ERRORS
+
       ENOMEM Insufficient memory to allocate passwd structure.
+
+
FILES
+
       /etc/passwdpassword database file
+
+
CONFORMING TO
+
       SVID 3, BSD 4.3
+
+
+
+

SEE ALSO +

+fgetpwent, +getpwnam, +getpwuid, +getpw, +

+
+
+
+
+
+
GNU                       April 9, 1993                         1
+

+
+
+

+

+

+

+ + + + +
+Top + +Master Index + +Keywords + +Functions +
+
+

+

+ +This manual page was brought to you by mjl_man V-2.0 -- cgit v1.2.3-54-g00ecf