]>
Commit | Line | Data |
---|---|---|
b168057a | 1 | /* Copyright (C) 1991-2015 Free Software Foundation, Inc. |
2c6fe0bd | 2 | This file is part of the GNU C Library. |
28f540f4 | 3 | |
2c6fe0bd | 4 | The GNU C Library is free software; you can redistribute it and/or |
41bdb6e2 AJ |
5 | modify it under the terms of the GNU Lesser General Public |
6 | License as published by the Free Software Foundation; either | |
7 | version 2.1 of the License, or (at your option) any later version. | |
28f540f4 | 8 | |
2c6fe0bd UD |
9 | The GNU C Library is distributed in the hope that it will be useful, |
10 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
41bdb6e2 | 12 | Lesser General Public License for more details. |
28f540f4 | 13 | |
41bdb6e2 | 14 | You should have received a copy of the GNU Lesser General Public |
59ba27a6 PE |
15 | License along with the GNU C Library; if not, see |
16 | <http://www.gnu.org/licenses/>. */ | |
28f540f4 RM |
17 | |
18 | /* | |
19 | * POSIX Standard: 9.2.1 Group Database Access <grp.h> | |
20 | */ | |
21 | ||
22 | #ifndef _GRP_H | |
28f540f4 | 23 | #define _GRP_H 1 |
5107cf1d | 24 | |
28f540f4 RM |
25 | #include <features.h> |
26 | ||
27 | __BEGIN_DECLS | |
28 | ||
5107cf1d | 29 | #include <bits/types.h> |
28f540f4 | 30 | |
0f110f41 TBB |
31 | #define __need_size_t |
32 | #include <stddef.h> | |
33 | ||
28f540f4 | 34 | |
9756dfe1 | 35 | /* For the Single Unix specification we must define this type here. */ |
7a80496f | 36 | #if (defined __USE_XOPEN || defined __USE_XOPEN2K) && !defined __gid_t_defined |
9756dfe1 | 37 | typedef __gid_t gid_t; |
7df789e0 | 38 | # define __gid_t_defined |
9756dfe1 UD |
39 | #endif |
40 | ||
28f540f4 RM |
41 | /* The group structure. */ |
42 | struct group | |
43 | { | |
44 | char *gr_name; /* Group name. */ | |
45 | char *gr_passwd; /* Password. */ | |
46 | __gid_t gr_gid; /* Group ID. */ | |
47 | char **gr_mem; /* Member list. */ | |
48 | }; | |
49 | ||
50 | ||
acd7f096 | 51 | #ifdef __USE_MISC |
dfd2257a UD |
52 | # define __need_FILE |
53 | # include <stdio.h> | |
28f540f4 RM |
54 | #endif |
55 | ||
28f540f4 | 56 | |
ed9a38e2 | 57 | #if defined __USE_MISC || defined __USE_XOPEN_EXTENDED |
2c008571 | 58 | /* Rewind the group-file stream. |
28f540f4 | 59 | |
2c008571 UD |
60 | This function is a possible cancellation point and therefore not |
61 | marked with __THROW. */ | |
62 | extern void setgrent (void); | |
28f540f4 | 63 | |
2c008571 UD |
64 | /* Close the group-file stream. |
65 | ||
66 | This function is a possible cancellation point and therefore not | |
67 | marked with __THROW. */ | |
68 | extern void endgrent (void); | |
69 | ||
70 | /* Read an entry from the group-file stream, opening it if necessary. | |
71 | ||
72 | This function is a possible cancellation point and therefore not | |
73 | marked with __THROW. */ | |
74 | extern struct group *getgrent (void); | |
28f540f4 RM |
75 | #endif |
76 | ||
498afc54 | 77 | #ifdef __USE_MISC |
2c008571 UD |
78 | /* Read a group entry from STREAM. |
79 | ||
80 | This function is not part of POSIX and therefore no official | |
81 | cancellation point. But due to similarity with an POSIX interface | |
82 | or due to the implementation it is a cancellation point and | |
83 | therefore not marked with __THROW. */ | |
84 | extern struct group *fgetgrent (FILE *__stream); | |
28f540f4 RM |
85 | #endif |
86 | ||
7ce241a0 | 87 | #ifdef __USE_GNU |
2c008571 UD |
88 | /* Write the given entry onto the given stream. |
89 | ||
90 | This function is not part of POSIX and therefore no official | |
91 | cancellation point. But due to similarity with an POSIX interface | |
92 | or due to the implementation it is a cancellation point and | |
93 | therefore not marked with __THROW. */ | |
a784e502 | 94 | extern int putgrent (const struct group *__restrict __p, |
2c008571 | 95 | FILE *__restrict __f); |
7ce241a0 UD |
96 | #endif |
97 | ||
2c008571 UD |
98 | /* Search for an entry with a matching group ID. |
99 | ||
100 | This function is a possible cancellation point and therefore not | |
101 | marked with __THROW. */ | |
102 | extern struct group *getgrgid (__gid_t __gid); | |
103 | ||
104 | /* Search for an entry with a matching group name. | |
28f540f4 | 105 | |
2c008571 UD |
106 | This function is a possible cancellation point and therefore not |
107 | marked with __THROW. */ | |
a784e502 | 108 | extern struct group *getgrnam (const char *__name); |
28f540f4 | 109 | |
acd7f096 | 110 | #ifdef __USE_POSIX |
19361cb7 | 111 | |
dfd2257a | 112 | # ifdef __USE_MISC |
23396375 UD |
113 | /* Reasonable value for the buffer sized used in the reentrant |
114 | functions below. But better use `sysconf'. */ | |
dfd2257a UD |
115 | # define NSS_BUFLEN_GROUP 1024 |
116 | # endif | |
23396375 UD |
117 | |
118 | /* Reentrant versions of some of the functions above. | |
119 | ||
84384f5b UD |
120 | PLEASE NOTE: the `getgrent_r' function is not (yet) standardized. |
121 | The interface may change in later versions of this library. But | |
122 | the interface is designed following the principals used for the | |
123 | other reentrant functions so the chances are good this is what the | |
2c008571 UD |
124 | POSIX people would choose. |
125 | ||
126 | This function is not part of POSIX and therefore no official | |
127 | cancellation point. But due to similarity with an POSIX interface | |
128 | or due to the implementation it is a cancellation point and | |
129 | therefore not marked with __THROW. */ | |
23396375 | 130 | |
0ed99ce4 | 131 | # ifdef __USE_GNU |
c1422e5b UD |
132 | extern int getgrent_r (struct group *__restrict __resultbuf, |
133 | char *__restrict __buffer, size_t __buflen, | |
2c008571 | 134 | struct group **__restrict __result); |
dfd2257a | 135 | # endif |
23396375 | 136 | |
2c008571 UD |
137 | /* Search for an entry with a matching group ID. |
138 | ||
139 | This function is a possible cancellation point and therefore not | |
140 | marked with __THROW. */ | |
c1422e5b UD |
141 | extern int getgrgid_r (__gid_t __gid, struct group *__restrict __resultbuf, |
142 | char *__restrict __buffer, size_t __buflen, | |
2c008571 UD |
143 | struct group **__restrict __result); |
144 | ||
145 | /* Search for an entry with a matching group name. | |
23396375 | 146 | |
2c008571 UD |
147 | This function is a possible cancellation point and therefore not |
148 | marked with __THROW. */ | |
a784e502 | 149 | extern int getgrnam_r (const char *__restrict __name, |
c1422e5b UD |
150 | struct group *__restrict __resultbuf, |
151 | char *__restrict __buffer, size_t __buflen, | |
2c008571 | 152 | struct group **__restrict __result); |
23396375 | 153 | |
498afc54 | 154 | # ifdef __USE_MISC |
84384f5b | 155 | /* Read a group entry from STREAM. This function is not standardized |
2c008571 UD |
156 | an probably never will. |
157 | ||
158 | This function is not part of POSIX and therefore no official | |
159 | cancellation point. But due to similarity with an POSIX interface | |
160 | or due to the implementation it is a cancellation point and | |
161 | therefore not marked with __THROW. */ | |
c1422e5b UD |
162 | extern int fgetgrent_r (FILE *__restrict __stream, |
163 | struct group *__restrict __resultbuf, | |
164 | char *__restrict __buffer, size_t __buflen, | |
2c008571 | 165 | struct group **__restrict __result); |
dfd2257a | 166 | # endif |
a8922de8 | 167 | |
9d187dd4 | 168 | #endif /* POSIX or reentrant */ |
23396375 | 169 | |
28f540f4 | 170 | |
498afc54 | 171 | #ifdef __USE_MISC |
28f540f4 | 172 | |
dfd2257a UD |
173 | # define __need_size_t |
174 | # include <stddef.h> | |
28f540f4 RM |
175 | |
176 | /* Set the group set for the current user to GROUPS (N of them). */ | |
a784e502 | 177 | extern int setgroups (size_t __n, const __gid_t *__groups) __THROW; |
28f540f4 | 178 | |
8fee1bb0 UD |
179 | /* Store at most *NGROUPS members of the group set for USER into |
180 | *GROUPS. Also include GROUP. The actual number of groups found is | |
2c008571 UD |
181 | returned in *NGROUPS. Return -1 if the if *NGROUPS is too small. |
182 | ||
183 | This function is not part of POSIX and therefore no official | |
184 | cancellation point. But due to similarity with an POSIX interface | |
185 | or due to the implementation it is a cancellation point and | |
186 | therefore not marked with __THROW. */ | |
a784e502 | 187 | extern int getgrouplist (const char *__user, __gid_t __group, |
2c008571 | 188 | __gid_t *__groups, int *__ngroups); |
8fee1bb0 | 189 | |
28f540f4 RM |
190 | /* Initialize the group set for the current user |
191 | by reading the group database and using all groups | |
2c008571 UD |
192 | of which USER is a member. Also include GROUP. |
193 | ||
194 | This function is not part of POSIX and therefore no official | |
195 | cancellation point. But due to similarity with an POSIX interface | |
196 | or due to the implementation it is a cancellation point and | |
197 | therefore not marked with __THROW. */ | |
a784e502 | 198 | extern int initgroups (const char *__user, __gid_t __group); |
28f540f4 | 199 | |
acd7f096 | 200 | #endif /* Use misc. */ |
28f540f4 RM |
201 | |
202 | __END_DECLS | |
203 | ||
204 | #endif /* grp.h */ |