contrib/lib9p/rfuncs.h

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