Penguin
Recent Changes
Annotated edit history of endgrent(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 GETGRENT
2 !!!GETGRENT
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 getgrent, setgrent, endgrent - get group file entry
16 !!SYNOPSIS
17
18
19 __#include
20 __
21 !!DESCRIPTION
22
23
24 The __getgrent()__ function returns a pointer to a
25 structure containing the group information from
26 ''/etc/group''. The first time it is called it returns
27 the first entry; thereafter, it returns successive
28 entries.
29
30
31 The __setgrent()__ function rewinds the file pointer to
32 the beginning of the ''/etc/group'' file.
33
34
35 The __endgrent()__ function closes the ''/etc/group''
36 file.
37
38
39 The ''group'' structure is defined in
40 '''' as follows:
41
42
43 struct group {
44 char *gr_name; /* group name */
45 char *gr_passwd; /* group password */
46 gid_t gr_gid; /* group id */
47 char **gr_mem; /* group members */
48 };
49 !!RETURN VALUE
50
51
52 The __getgrent()__ function returns the group information
53 structure, or NULL if there are no more entries or an error
54 occurs.
55 !!ERRORS
56
57
58 __ENOMEM__
59
60
61 Insufficient memory to allocate group information
62 structure.
63 !!FILES
64
65
66 ''/etc/group''
67
68
69 group database file
70 !!CONFORMING TO
71
72
73 SVID 3, BSD 4.3
74 !!SEE ALSO
75
76
77 fgetgrent(3), getgrnam(3),
78 getgrgid(3)
79 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.