xref: /freebsd/contrib/lib9p/rfuncs.h (revision 134e17798c9af53632b372348ab828e75e65bf46)
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   */
43  char	*r_basename(const char *, char *, size_t);
44  char	*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   */
60  struct 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 *); */
70  void r_pgfree(struct r_pgdata *);
71  struct passwd *r_getpwuid(uid_t, struct r_pgdata *);
72  struct group *r_getgrgid(gid_t, struct r_pgdata *);
73  
74  #if defined(WITH_CASPER)
75  struct passwd *r_cap_getpwuid(cap_channel_t *, uid_t, struct r_pgdata *);
76  struct group *r_cap_getgrgid(cap_channel_t *, gid_t, struct r_pgdata *);
77  #endif
78  
79  #endif	/* LIB9P_RFUNCS_H */
80