xref: /illumos-gate/usr/src/head/grp.h (revision e7cbe64f7a72dae5cb44f100db60ca88f3313c65)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*	Copyright (c) 1988 AT&T	*/
23 /*	  All Rights Reserved  	*/
24 
25 
26 /*
27  * Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
28  * Use is subject to license terms.
29  */
30 
31 #ifndef _GRP_H
32 #define	_GRP_H
33 
34 #pragma ident	"%Z%%M%	%I%	%E% SMI"	/* SVr4.0 1.3.3.1 */
35 
36 #include <sys/feature_tests.h>
37 
38 #include <sys/types.h>
39 
40 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)
41 #include <stdio.h>
42 #endif
43 
44 #ifdef	__cplusplus
45 extern "C" {
46 #endif
47 
48 struct	group {	/* see getgrent(3C) */
49 	char	*gr_name;
50 	char	*gr_passwd;
51 	gid_t	gr_gid;
52 	char	**gr_mem;
53 };
54 
55 #if defined(__STDC__)
56 
57 extern struct group *getgrgid(gid_t);		/* MT-unsafe */
58 extern struct group *getgrnam(const char *);	/* MT-unsafe */
59 
60 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)
61 extern struct group *getgrent_r(struct group *, char *, int);
62 extern struct group *fgetgrent_r(FILE *, struct group *, char *, int);
63 
64 
65 extern struct group *fgetgrent(FILE *);		/* MT-unsafe */
66 extern int initgroups(const char *, gid_t);
67 #endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) */
68 
69 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2)
70 extern void endgrent(void);
71 extern void setgrent(void);
72 extern struct group *getgrent(void);		/* MT-unsafe */
73 #endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)... */
74 
75 #else
76 
77 extern struct group *getgrgid();		/* MT-unsafe */
78 extern struct group *getgrnam();		/* MT-unsafe */
79 
80 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)
81 extern struct group *getgrent_r();
82 extern struct group *fgetgrent_r();
83 
84 extern struct group *fgetgrent();		/* MT-unsafe */
85 extern int initgroups();
86 #endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) */
87 
88 #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2)
89 extern void endgrent();
90 extern void setgrent();
91 extern struct group *getgrent();		/* MT-unsafe */
92 #endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)... */
93 
94 #endif	/* __STDC__ */
95 
96 
97 /*
98  * getgrgid_r() & getgrnam_r() prototypes are defined here.
99  */
100 
101 /*
102  * Previous releases of Solaris, starting at 2.3, provided definitions of
103  * various functions as specified in POSIX.1c, Draft 6.  For some of these
104  * functions, the final POSIX 1003.1c standard had a different number of
105  * arguments and return values.
106  *
107  * The following segment of this header provides support for the standard
108  * interfaces while supporting applications written under earlier
109  * releases.  The application defines appropriate values of the feature
110  * test macros _POSIX_C_SOURCE and _POSIX_PTHREAD_SEMANTICS to indicate
111  * whether it was written to expect the Draft 6 or standard versions of
112  * these interfaces, before including this header.  This header then
113  * provides a mapping from the source version of the interface to an
114  * appropriate binary interface.  Such mappings permit an application
115  * to be built from libraries and objects which have mixed expectations
116  * of the definitions of these functions.
117  *
118  * For applications using the Draft 6 definitions, the binary symbol is the
119  * same as the source symbol, and no explicit mapping is needed.  For the
120  * standard interface, the function func() is mapped to the binary symbol
121  * _posix_func().  The preferred mechanism for the remapping is a compiler
122  * #pragma.  If the compiler does not provide such a #pragma, the header file
123  * defines a static function func() which calls the _posix_func() version;
124  * this has to be done instead of #define since POSIX specifies that an
125  * application can #undef the symbol and still be bound to the correct
126  * implementation.  Unfortunately, the statics confuse lint so we fallback to
127  * #define in that case.
128  *
129  * NOTE: Support for the Draft 6 definitions is provided for compatibility
130  * only.  New applications/libraries should use the standard definitions.
131  */
132 
133 #if	defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || \
134 	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
135 
136 #if	defined(__STDC__)
137 
138 #if	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
139 
140 #ifdef __PRAGMA_REDEFINE_EXTNAME
141 #pragma redefine_extname getgrgid_r __posix_getgrgid_r
142 #pragma redefine_extname getgrnam_r __posix_getgrnam_r
143 extern int getgrgid_r(gid_t, struct group *, char *, int, struct group **);
144 extern int getgrnam_r(const char *, struct group *, char *, int,
145 							struct group **);
146 #else  /* __PRAGMA_REDEFINE_EXTNAME */
147 
148 extern int __posix_getgrgid_r(gid_t, struct group *, char *, size_t,
149     struct group **);
150 extern int __posix_getgrnam_r(const char *, struct group *, char *, size_t,
151     struct group **);
152 
153 #ifdef __lint
154 
155 #define	getgrgid_r __posix_getgrgid_r
156 #define	getgrnam_r __posix_getgrnam_r
157 
158 #else	/* !__lint */
159 
160 static int
161 getgrgid_r(gid_t __gid, struct group *__grp, char *__buf, int __len,
162     struct group **__res)
163 {
164 	return (__posix_getgrgid_r(__gid, __grp, __buf, __len, __res));
165 }
166 static int
167 getgrnam_r(const char *__cb, struct group *__grp, char *__buf, int __len,
168     struct group **__res)
169 {
170 	return (__posix_getgrnam_r(__cb, __grp, __buf, __len, __res));
171 }
172 
173 #endif /* !__lint */
174 #endif /* __PRAGMA_REDEFINE_EXTNAME */
175 
176 #else  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
177 
178 extern struct group *getgrgid_r(gid_t, struct group *, char *, int);
179 extern struct group *getgrnam_r(const char *, struct group *, char *, int);
180 
181 #endif  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
182 
183 #else  /* __STDC__ */
184 
185 #if	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
186 
187 #ifdef __PRAGMA_REDEFINE_EXTNAME
188 #pragma redefine_extname getgrgid_r __posix_getgrgid_r
189 #pragma redefine_extname getgrnam_r __posix_getgrnam_r
190 extern int getgrgid_r();
191 extern int getgrnam_r();
192 #else  /* __PRAGMA_REDEFINE_EXTNAME */
193 
194 extern int __posix_getgrgid_r();
195 extern int __posix_getgrnam_r();
196 
197 #ifdef	__lint
198 
199 #define	getgrgid_r __posix_getgrgid_r
200 #define	getgrnam_r __posix_getgrnam_r
201 
202 #else	/* !__lint */
203 
204 static int
205 getgrgid_r(__gid, __grp, __buf, __len, __res)
206 	gid_t __gid;
207 	struct group *__grp;
208 	char *__buf;
209 	int __len;
210 	struct group **__res;
211 {
212 	return (__posix_getgrgid_r(__gid, __grp, __buf, __len, __res));
213 }
214 static int
215 getgrnam_r(__cb, __grp, __buf, __len, __res)
216 	char *__cb;
217 	struct group *__grp;
218 	char *__buf;
219 	int __len;
220 	struct group **__res;
221 {
222 	return (__posix_getgrnam_r(__cb, __grp, __buf, __len, __res));
223 }
224 
225 #endif /* !__lint */
226 #endif /* __PRAGMA_REDEFINE_EXTNAME */
227 
228 #else  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
229 
230 extern struct group *getgrgid_r();
231 extern struct group *getgrnam_r();
232 
233 #endif /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
234 
235 #endif /* __STDC__ */
236 
237 #endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)... */
238 
239 #ifdef	__cplusplus
240 }
241 #endif
242 
243 #endif	/* _GRP_H */
244