xref: /illumos-gate/usr/src/head/pwd.h (revision 581cede61ac9c14d8d4ea452562a567189eead78)
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 _PWD_H
32 #define	_PWD_H
33 
34 #pragma ident	"%Z%%M%	%I%	%E% SMI"	/* SVr4.0 1.3.1.9 */
35 
36 #include <sys/feature_tests.h>
37 
38 #include <sys/types.h>
39 
40 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
41 #include <stdio.h>
42 #endif
43 
44 #ifdef	__cplusplus
45 extern "C" {
46 #endif
47 
48 struct passwd {
49 	char	*pw_name;
50 	char	*pw_passwd;
51 	uid_t	pw_uid;
52 	gid_t	pw_gid;
53 	char	*pw_age;
54 	char	*pw_comment;
55 	char	*pw_gecos;
56 	char	*pw_dir;
57 	char	*pw_shell;
58 };
59 
60 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
61 struct comment {
62 	char	*c_dept;
63 	char	*c_name;
64 	char	*c_acct;
65 	char	*c_bin;
66 };
67 #endif /* !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__) */
68 
69 #if defined(__STDC__)
70 
71 extern struct passwd *getpwuid(uid_t);		/* MT-unsafe */
72 extern struct passwd *getpwnam(const char *);	/* MT-unsafe */
73 
74 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
75 extern struct passwd *getpwent_r(struct passwd *, char *, int);
76 extern struct passwd *fgetpwent_r(FILE *, struct passwd *, char *, int);
77 extern struct passwd *fgetpwent(FILE *);	/* MT-unsafe */
78 extern int putpwent(const struct passwd *, FILE *);
79 #endif /* !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__) */
80 
81 #if !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) || \
82 	defined(__EXTENSIONS__)
83 extern void endpwent(void);
84 extern struct passwd *getpwent(void);		/* MT-unsafe */
85 extern void setpwent(void);
86 #endif /* !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) ... */
87 
88 #else  /* (__STDC__) */
89 
90 extern struct passwd *getpwuid();		/* MT-unsafe */
91 extern struct passwd *getpwnam();		/* MT-unsafe */
92 
93 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
94 extern struct passwd *getpwent_r();
95 extern struct passwd *fgetpwent_r();
96 
97 extern struct passwd *fgetpwent();		/* MT-unsafe */
98 extern int putpwent();
99 #endif /* !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__) */
100 
101 #if !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) || \
102 	defined(__EXTENSIONS__)
103 extern void endpwent();
104 extern struct passwd *getpwent();		/* MT-unsafe */
105 extern void setpwent();
106 #endif /* !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) ... */
107 
108 #endif /* (__STDC__) */
109 
110 /*
111  * getpwuid_r() & getpwnam_r() prototypes are defined here.
112  */
113 
114 /*
115  * Previous releases of Solaris, starting at 2.3, provided definitions of
116  * various functions as specified in POSIX.1c, Draft 6.  For some of these
117  * functions, the final POSIX 1003.1c standard had a different number of
118  * arguments and return values.
119  *
120  * The following segment of this header provides support for the standard
121  * interfaces while supporting applications written under earlier
122  * releases.  The application defines appropriate values of the feature
123  * test macros _POSIX_C_SOURCE and _POSIX_PTHREAD_SEMANTICS to indicate
124  * whether it was written to expect the Draft 6 or standard versions of
125  * these interfaces, before including this header.  This header then
126  * provides a mapping from the source version of the interface to an
127  * appropriate binary interface.  Such mappings permit an application
128  * to be built from libraries and objects which have mixed expectations
129  * of the definitions of these functions.
130  *
131  * For applications using the Draft 6 definitions, the binary symbol is the
132  * same as the source symbol, and no explicit mapping is needed.  For the
133  * standard interface, the function func() is mapped to the binary symbol
134  * _posix_func().  The preferred mechanism for the remapping is a compiler
135  * #pragma.  If the compiler does not provide such a #pragma, the header file
136  * defines a static function func() which calls the _posix_func() version;
137  * this has to be done instead of #define since POSIX specifies that an
138  * application can #undef the symbol and still be bound to the correct
139  * implementation.  Unfortunately, the statics confuse lint so we fallback to
140  * #define in that case.
141  *
142  * NOTE: Support for the Draft 6 definitions is provided for compatibility
143  * only.  New applications/libraries should use the standard definitions.
144  */
145 
146 #if !defined(__XOPEN_OR_POSIX) || (_POSIX_C_SOURCE - 0 >= 199506L) || \
147 	defined(_POSIX_PTHREAD_SEMANTICS) || defined(__EXTENSIONS__)
148 
149 #if defined(__STDC__)
150 
151 #if (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
152 
153 #ifdef __PRAGMA_REDEFINE_EXTNAME
154 #pragma redefine_extname getpwuid_r __posix_getpwuid_r
155 #pragma redefine_extname getpwnam_r __posix_getpwnam_r
156 extern int getpwuid_r(uid_t, struct passwd *, char *, int, struct passwd **);
157 extern int getpwnam_r(const char *, struct passwd *, char *,
158 							int, struct passwd **);
159 #else  /* __PRAGMA_REDEFINE_EXTNAME */
160 
161 extern int __posix_getpwuid_r(uid_t, struct passwd *, char *, size_t,
162     struct passwd **);
163 extern int __posix_getpwnam_r(const char *, struct passwd *, char *,
164     size_t, struct passwd **);
165 
166 #ifdef __lint
167 
168 #define	getpwuid_r __posix_getpwuid_r
169 #define	getpwnam_r __posix_getpwnam_r
170 
171 #else	/* !__lint */
172 
173 static int
174 getpwuid_r(uid_t __uid, struct passwd *__pwd, char *__buf, int __len,
175     struct passwd **__res)
176 {
177 	return (__posix_getpwuid_r(__uid, __pwd, __buf, __len, __res));
178 }
179 static int
180 getpwnam_r(const char *__cb, struct passwd *__pwd, char *__buf, int __len,
181     struct passwd **__res)
182 {
183 	return (__posix_getpwnam_r(__cb, __pwd, __buf, __len, __res));
184 }
185 
186 #endif /* !__lint */
187 #endif /* __PRAGMA_REDEFINE_EXTNAME */
188 
189 #else  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
190 
191 extern struct passwd *getpwuid_r(uid_t, struct passwd *, char *, int);
192 extern struct passwd *getpwnam_r(const char *, struct passwd *, char *, int);
193 
194 #endif  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
195 
196 #else  /* __STDC__ */
197 
198 #if (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
199 
200 #ifdef __PRAGMA_REDEFINE_EXTNAME
201 #pragma redefine_extname getpwuid_r __posix_getpwuid_r
202 #pragma redefine_extname getpwnam_r __posix_getpwnam_r
203 extern int getpwuid_r();
204 extern int getpwnam_r();
205 #else  /* __PRAGMA_REDEFINE_EXTNAME */
206 
207 extern int __posix_getpwuid_r();
208 extern int __posix_getpwnam_r();
209 
210 #ifdef	__lint
211 
212 #define	getpwuid_r __posix_getpwuid_r
213 #define	getpwnam_r __posix_getpwnam_r
214 
215 #else	/* !__lint */
216 
217 static int
218 getpwuid_r(__uid, __pwd, __buf, __len, __res)
219 	uid_t __uid;
220 	struct passwd *__pwd;
221 	char *__buf;
222 	int __len;
223 	struct passwd **__res;
224 {
225 	return (__posix_getpwuid_r(__uid, __pwd, __buf, __len, __res));
226 }
227 static int
228 getpwnam_r(__cb, __pwd, __buf, __len, __res)
229 	char *__cb;
230 	struct passwd *__pwd;
231 	char *__buf;
232 	int __len;
233 	struct passwd **__res;
234 {
235 	return (__posix_getpwnam_r(__cb, __pwd, __buf, __len, __res));
236 }
237 
238 #endif /* !__lint */
239 #endif /* __PRAGMA_REDEFINE_EXTNAME */
240 
241 #else  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
242 
243 extern struct passwd *getpwuid_r();
244 extern struct passwd *getpwnam_r();
245 
246 #endif /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
247 
248 #endif /* __STDC__ */
249 
250 #endif /* !defined(__XOPEN_OR_POSIX) || (_POSIX_C_SOURCE - 0 >= 199506L)... */
251 
252 #ifdef	__cplusplus
253 }
254 #endif
255 
256 #endif /* _PWD_H */
257