View Source: endpwent(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

GETPWENT
!!!GETPWENT
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
FILES
CONFORMING TO
SEE ALSO
----
!!NAME


getpwent, setpwent, endpwent - get password file entry
!!SYNOPSIS


__#include
__
!!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
'''' 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/passwd''


password database file
!!CONFORMING TO


SVID 3, BSD 4.3
!!SEE ALSO


fgetpwent(3), getpwnam(3), getpwuid(3),
getpw(3), putpwent(3),
passwd(5)
----

6 pages link to endpwent(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:16 am by "perry"

Edit PageHistory Diff Info LikePages