db13ce3b42b2673166ed9ceebb35d52779ddfe23
[oweals/busybox.git] / include / grp_.h
1 /* vi: set sw=4 ts=4: */
2 /* Copyright (C) 1991,92,95,96,97,98,99,2000,01 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Lesser General Public
7    License as published by the Free Software Foundation; either
8    version 2.1 of the License, or (at your option) any later version.
9
10    The GNU C Library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Lesser General Public License for more details.
14
15    You should have received a copy of the GNU Lesser General Public
16    License along with the GNU C Library; if not, write to the Free
17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
18    02111-1307 USA.
19  */
20 /*
21  * POSIX Standard: 9.2.1 Group Database Access  <grp.h>
22  */
23 #ifndef BB_GRP_H
24 #define BB_GRP_H 1
25
26 PUSH_AND_SET_FUNCTION_VISIBILITY_TO_HIDDEN
27
28 /* This file is #included after #include <grp.h>
29  * We will use libc-defined structures, but will #define function names
30  * so that function calls are directed to bb_internal_XXX replacements
31  */
32 #undef endgrent
33 #define endgrent     bb_internal_endgrent
34 #define getgrgid     bb_internal_getgrgid
35 #define getgrnam     bb_internal_getgrnam
36 #define getgrouplist bb_internal_getgrouplist
37 #define initgroups   bb_internal_initgroups
38
39 /* All function names below should be remapped by #defines above
40  * in order to not collide with libc names. */
41
42 /* Close the group-file stream.  */
43 void FAST_FUNC endgrent(void);
44
45 /* Search for an entry with a matching group ID.  */
46 struct group* FAST_FUNC getgrgid(gid_t __gid);
47
48 /* Search for an entry with a matching group name.  */
49 struct group* FAST_FUNC getgrnam(const char *__name);
50
51 /* Reentrant versions of some of the functions above. */
52
53 /* Store at most *NGROUPS members of the group set for USER into
54    *GROUPS.  Also include GROUP.  The actual number of groups found is
55    returned in *NGROUPS.  Return -1 if the if *NGROUPS is too small.  */
56 int FAST_FUNC getgrouplist(const char *__user, gid_t __group,
57                 gid_t *__groups, int *__ngroups);
58
59 /* Initialize the group set for the current user
60    by reading the group database and using all groups
61    of which USER is a member.  Also include GROUP.  */
62 int FAST_FUNC initgroups(const char *__user, gid_t __group);
63
64 POP_SAVED_FUNCTION_VISIBILITY
65
66 #endif