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#include <grp.h>
32#include <pwd.h>
33#include <string.h>
34
35#if defined(WITH_CASPER)
36#include <libcasper.h>
37#endif
38
39/*
40 * Reentrant, optionally-malloc-ing versions of
41 * basename() and dirname().
42 */
43char	*r_basename(const char *, char *, size_t);
44char	*r_dirname(const char *, char *, size_t);
45
46/*
47 * Yuck: getpwuid, getgrgid are not thread-safe, and the
48 * POSIX replacements (getpwuid_r, getgrgid_r) are horrible.
49 * This is to allow us to loop over the get.*_r calls with ever
50 * increasing buffers until they succeed or get unreasonable
51 * (same idea as the libc code for the non-reentrant versions,
52 * although prettier).
53 *
54 * The getpwuid/getgrgid functions auto-init one of these,
55 * but the caller must call r_pgfree() when done with the
56 * return values.
57 *
58 * If we need more later, we may have to expose the init function.
59 */
60struct r_pgdata {
61	char	*r_pgbuf;
62	size_t	r_pgbufsize;
63	union {
64		struct passwd un_pw;
65		struct group un_gr;
66	} r_pgun;
67};
68
69/* void r_pginit(struct r_pgdata *); */
70void r_pgfree(struct r_pgdata *);
71struct passwd *r_getpwuid(uid_t, struct r_pgdata *);
72struct group *r_getgrgid(gid_t, struct r_pgdata *);
73
74#if defined(WITH_CASPER)
75struct passwd *r_cap_getpwuid(cap_channel_t *, uid_t, struct r_pgdata *);
76struct group *r_cap_getgrgid(cap_channel_t *, gid_t, struct r_pgdata *);
77#endif
78
79#endif	/* LIB9P_RFUNCS_H */
80