xref: /illumos-gate/usr/src/head/pwd.h (revision 2b987d42b0ad07d74e39b18a2498709e5195d7e3)
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 _PWD_H
34 #define	_PWD_H
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 extern struct passwd *getpwuid(uid_t);		/* MT-unsafe */
70 extern struct passwd *getpwnam(const char *);	/* MT-unsafe */
71 
72 #if !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__)
73 extern struct passwd *getpwent_r(struct passwd *, char *, int);
74 extern struct passwd *fgetpwent_r(FILE *, struct passwd *, char *, int);
75 extern struct passwd *fgetpwent(FILE *);	/* MT-unsafe */
76 extern int putpwent(const struct passwd *, FILE *);
77 #endif /* !defined(__XOPEN_OR_POSIX) || defined(__EXTENSIONS__) */
78 
79 #if !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) || \
80 	defined(__EXTENSIONS__)
81 extern void endpwent(void);
82 extern struct passwd *getpwent(void);		/* MT-unsafe */
83 extern void setpwent(void);
84 #endif /* !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) ... */
85 
86 /*
87  * getpwuid_r() & getpwnam_r() prototypes are defined here.
88  */
89 
90 /*
91  * Previous releases of Solaris, starting at 2.3, provided definitions of
92  * various functions as specified in POSIX.1c, Draft 6.  For some of these
93  * functions, the final POSIX 1003.1c standard had a different number of
94  * arguments and return values.
95  *
96  * The following segment of this header provides support for the standard
97  * interfaces while supporting applications written under earlier
98  * releases.  The application defines appropriate values of the feature
99  * test macros _POSIX_C_SOURCE and _POSIX_PTHREAD_SEMANTICS to indicate
100  * whether it was written to expect the Draft 6 or standard versions of
101  * these interfaces, before including this header.  This header then
102  * provides a mapping from the source version of the interface to an
103  * appropriate binary interface.  Such mappings permit an application
104  * to be built from libraries and objects which have mixed expectations
105  * of the definitions of these functions.
106  *
107  * For applications using the Draft 6 definitions, the binary symbol is the
108  * same as the source symbol, and no explicit mapping is needed.  For the
109  * standard interface, the function func() is mapped to the binary symbol
110  * _posix_func().  The preferred mechanism for the remapping is a compiler
111  * #pragma.  If the compiler does not provide such a #pragma, the header file
112  * defines a static function func() which calls the _posix_func() version;
113  * this has to be done instead of #define since POSIX specifies that an
114  * application can #undef the symbol and still be bound to the correct
115  * implementation.  Unfortunately, the statics confuse lint so we fallback to
116  * #define in that case.
117  *
118  * NOTE: Support for the Draft 6 definitions is provided for compatibility
119  * only.  New applications/libraries should use the standard definitions.
120  */
121 
122 #if !defined(__XOPEN_OR_POSIX) || (_POSIX_C_SOURCE - 0 >= 199506L) || \
123 	defined(_POSIX_PTHREAD_SEMANTICS) || defined(__EXTENSIONS__)
124 
125 #if (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
126 
127 #ifdef __PRAGMA_REDEFINE_EXTNAME
128 #pragma redefine_extname getpwuid_r __posix_getpwuid_r
129 #pragma redefine_extname getpwnam_r __posix_getpwnam_r
130 extern int getpwuid_r(uid_t, struct passwd *, char *,
131     size_t, struct passwd **);
132 extern int getpwnam_r(const char *, struct passwd *, char *,
133     size_t, struct passwd **);
134 #else  /* __PRAGMA_REDEFINE_EXTNAME */
135 
136 extern int __posix_getpwuid_r(uid_t, struct passwd *, char *, size_t,
137     struct passwd **);
138 extern int __posix_getpwnam_r(const char *, struct passwd *, char *,
139     size_t, struct passwd **);
140 
141 #ifdef __lint
142 
143 #define	getpwuid_r __posix_getpwuid_r
144 #define	getpwnam_r __posix_getpwnam_r
145 
146 #else	/* !__lint */
147 
148 static int
149 getpwuid_r(uid_t __uid, struct passwd *__pwd, char *__buf, size_t __len,
150     struct passwd **__res)
151 {
152 	return (__posix_getpwuid_r(__uid, __pwd, __buf, __len, __res));
153 }
154 static int
155 getpwnam_r(const char *__cb, struct passwd *__pwd, char *__buf, size_t __len,
156     struct passwd **__res)
157 {
158 	return (__posix_getpwnam_r(__cb, __pwd, __buf, __len, __res));
159 }
160 
161 #endif /* !__lint */
162 #endif /* __PRAGMA_REDEFINE_EXTNAME */
163 
164 #else  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
165 
166 extern struct passwd *getpwuid_r(uid_t, struct passwd *, char *, int);
167 extern struct passwd *getpwnam_r(const char *, struct passwd *, char *, int);
168 
169 #endif  /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
170 
171 #endif /* !defined(__XOPEN_OR_POSIX) || (_POSIX_C_SOURCE - 0 >= 199506L)... */
172 
173 #ifdef	__cplusplus
174 }
175 #endif
176 
177 #endif /* _PWD_H */
178