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 2014 Garrett D'Amore <garrett@damore.org>
28 *
29 * Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
30 * Use is subject to license terms.
31 */
32
33#ifndef _GRP_H
34#define	_GRP_H
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
45extern "C" {
46#endif
47
48struct	group {	/* see getgrent(3C) */
49	char	*gr_name;
50	char	*gr_passwd;
51	gid_t	gr_gid;
52	char	**gr_mem;
53};
54
55extern struct group *getgrgid(gid_t);		/* MT-unsafe */
56extern struct group *getgrnam(const char *);	/* MT-unsafe */
57
58#if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)
59extern struct group *getgrent_r(struct group *, char *, int);
60extern struct group *fgetgrent_r(FILE *, struct group *, char *, int);
61
62
63extern struct group *fgetgrent(FILE *);		/* MT-unsafe */
64extern int initgroups(const char *, gid_t);
65#endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) */
66
67#if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2)
68extern void endgrent(void);
69extern void setgrent(void);
70extern struct group *getgrent(void);		/* MT-unsafe */
71#endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)... */
72
73/*
74 * getgrgid_r() & getgrnam_r() prototypes are defined here.
75 */
76
77/*
78 * Previous releases of Solaris, starting at 2.3, provided definitions of
79 * various functions as specified in POSIX.1c, Draft 6.  For some of these
80 * functions, the final POSIX 1003.1c standard had a different number of
81 * arguments and return values.
82 *
83 * The following segment of this header provides support for the standard
84 * interfaces while supporting applications written under earlier
85 * releases.  The application defines appropriate values of the feature
86 * test macros _POSIX_C_SOURCE and _POSIX_PTHREAD_SEMANTICS to indicate
87 * whether it was written to expect the Draft 6 or standard versions of
88 * these interfaces, before including this header.  This header then
89 * provides a mapping from the source version of the interface to an
90 * appropriate binary interface.  Such mappings permit an application
91 * to be built from libraries and objects which have mixed expectations
92 * of the definitions of these functions.
93 *
94 * For applications using the Draft 6 definitions, the binary symbol is the
95 * same as the source symbol, and no explicit mapping is needed.  For the
96 * standard interface, the function func() is mapped to the binary symbol
97 * _posix_func().  The preferred mechanism for the remapping is a compiler
98 * #pragma.  If the compiler does not provide such a #pragma, the header file
99 * defines a static function func() which calls the _posix_func() version;
100 * this has to be done instead of #define since POSIX specifies that an
101 * application can #undef the symbol and still be bound to the correct
102 * implementation.  Unfortunately, the statics confuse lint so we fallback to
103 * #define in that case.
104 *
105 * NOTE: Support for the Draft 6 definitions is provided for compatibility
106 * only.  New applications/libraries should use the standard definitions.
107 */
108
109#if	defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || \
110	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
111
112#if	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
113
114#ifdef __PRAGMA_REDEFINE_EXTNAME
115#pragma redefine_extname getgrgid_r __posix_getgrgid_r
116#pragma redefine_extname getgrnam_r __posix_getgrnam_r
117extern int getgrgid_r(gid_t, struct group *, char *,
118    size_t, struct group **);
119extern int getgrnam_r(const char *, struct group *, char *,
120    size_t, struct group **);
121#else  /* __PRAGMA_REDEFINE_EXTNAME */
122
123extern int __posix_getgrgid_r(gid_t, struct group *, char *, size_t,
124    struct group **);
125extern int __posix_getgrnam_r(const char *, struct group *, char *, size_t,
126    struct group **);
127
128#ifdef __lint
129
130#define	getgrgid_r __posix_getgrgid_r
131#define	getgrnam_r __posix_getgrnam_r
132
133#else	/* !__lint */
134
135static int
136getgrgid_r(gid_t __gid, struct group *__grp, char *__buf, size_t __len,
137    struct group **__res)
138{
139	return (__posix_getgrgid_r(__gid, __grp, __buf, __len, __res));
140}
141static int
142getgrnam_r(const char *__cb, struct group *__grp, char *__buf, size_t __len,
143    struct group **__res)
144{
145	return (__posix_getgrnam_r(__cb, __grp, __buf, __len, __res));
146}
147
148#endif /* !__lint */
149#endif /* __PRAGMA_REDEFINE_EXTNAME */
150
151#else  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
152
153extern struct group *getgrgid_r(gid_t, struct group *, char *, int);
154extern struct group *getgrnam_r(const char *, struct group *, char *, int);
155
156#endif  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
157
158#endif /* defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX)... */
159
160#ifdef	__cplusplus
161}
162#endif
163
164#endif	/* _GRP_H */
165