Penguin
Recent Changes
Blame: fgetpwent(3)
EditPageHistoryDiffInfoLikePages
Annotated edit history of fgetpwent(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 FGETPWENT
2 !!!FGETPWENT
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 ERRORS
8 FILES
9 CONFORMING TO
10 SEE ALSO
11 ----
12 !!NAME
13
14
15 fgetpwent - get password file entry
16 !!SYNOPSIS
17
18
19 __#include
20 __''stream''__);
21 __
22 !!DESCRIPTION
23
24
25 The __fgetpwent()__ function returns a pointer to a
26 structure containing the broken out fields of a line in the
27 file ''stream''. The first time it is called it returns
28 the first entry; thereafter, it returns successive entries.
29 The file ''stream'' must have the same format as
30 ''/etc/passwd''.
31
32
33 The ''passwd'' structure is defined in
34 '''' as follows:
35
36
37 struct passwd {
38 char *pw_name; /* user name */
39 char *pw_passwd; /* user password */
40 uid_t pw_uid; /* user id */
41 gid_t pw_gid; /* group id */
42 char *pw_gecos; /* real name */
43 char *pw_dir; /* home directory */
44 char *pw_shell; /* shell program */
45 };
46 !!RETURN VALUE
47
48
49 The __fgetpwent()__ function returns the passwd
50 structure, or NULL if there are no more entries or an error
51 occurs.
52 !!ERRORS
53
54
55 __ENOMEM__
56
57
58 Insufficient memory to allocate passwd
59 structure.
60 !!FILES
61
62
63 ''/etc/passwd''
64
65
66 password database file
67 !!CONFORMING TO
68
69
70 SVID 3
71 !!SEE ALSO
72
73
74 getpwnam(3), getpwuid(3), getpwent(3),
75 setpwent(3), endpwent(3), getpw(3),
76 putpwent(3), passwd(5)
77 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.