xref: /illumos-gate/usr/src/lib/lib9p/common/rfuncs.h (revision aa693e99)
1 /*
2  * Copyright 2016 Chris Torek <chris.torek@gmail.com>
3  * All rights reserved
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted providing that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
16  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
18  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
22  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
23  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24  * POSSIBILITY OF SUCH DAMAGE.
25  *
26  */
27 
28 #ifndef LIB9P_RFUNCS_H
29 #define LIB9P_RFUNCS_H
30 
31 #if defined(__illumos__) && !defined(_POSIX_PTHREAD_SEMANTICS)
32 #define	_POSIX_PTHREAD_SEMANTICS 1
33 #endif
34 
35 #include <grp.h>
36 #include <pwd.h>
37 #include <string.h>
38 
39 #if defined(WITH_CASPER)
40 #include <libcasper.h>
41 #endif
42 
43 /*
44  * Reentrant, optionally-malloc-ing versions of
45  * basename() and dirname().
46  */
47 char	*r_basename(const char *, char *, size_t);
48 char	*r_dirname(const char *, char *, size_t);
49 
50 /*
51  * Yuck: getpwuid, getgrgid are not thread-safe, and the
52  * POSIX replacements (getpwuid_r, getgrgid_r) are horrible.
53  * This is to allow us to loop over the get.*_r calls with ever
54  * increasing buffers until they succeed or get unreasonable
55  * (same idea as the libc code for the non-reentrant versions,
56  * although prettier).
57  *
58  * The getpwuid/getgrgid functions auto-init one of these,
59  * but the caller must call r_pgfree() when done with the
60  * return values.
61  *
62  * If we need more later, we may have to expose the init function.
63  */
64 struct r_pgdata {
65 	char	*r_pgbuf;
66 	size_t	r_pgbufsize;
67 	union {
68 		struct passwd un_pw;
69 		struct group un_gr;
70 	} r_pgun;
71 };
72 
73 /* void r_pginit(struct r_pgdata *); */
74 void r_pgfree(struct r_pgdata *);
75 struct passwd *r_getpwuid(uid_t, struct r_pgdata *);
76 struct group *r_getgrgid(gid_t, struct r_pgdata *);
77 
78 #if defined(WITH_CASPER)
79 struct passwd *r_cap_getpwuid(cap_channel_t *, uid_t, struct r_pgdata *);
80 struct group *r_cap_getgrgid(cap_channel_t *, gid_t, struct r_pgdata *);
81 #endif
82 
83 #endif	/* LIB9P_RFUNCS_H */
84