usr/src/head/pwd.h

   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 */