src/pulsecore/creds.h

   1 #ifndef foocredshfoo
   2 #define foocredshfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2006 Lennart Poettering
   8
   9   PulseAudio is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU Lesser General Public License as
  11   published by the Free Software Foundation; either version 2.1 of the
  12   License, or (at your option) any later version.
  13
  14   PulseAudio is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   Lesser General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public
  20   License along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
  21 ***/
  22
  23 #include <sys/types.h>
  24
  25 #ifndef PACKAGE
  26 #error "Please include config.h before including this file!"
  27 #endif
  28
  29 #include <pulsecore/socket.h>
  30 #include <stdbool.h>
  31
  32 #define MAX_ANCIL_DATA_FDS 2
  33
  34 typedef struct pa_creds pa_creds;
  35 typedef struct pa_cmsg_ancil_data pa_cmsg_ancil_data;
  36
  37 #if defined(SCM_CREDENTIALS) || defined(SCM_CREDS)
  38
  39 #define HAVE_CREDS 1
  40
  41 struct pa_creds {
  42     gid_t gid;
  43     uid_t uid;
  44 };
  45
  46 /* Struct for handling ancillary data, i e, extra data that can be sent together with a message
  47  * over unix pipes. Supports sending and receiving credentials and file descriptors. */
  48 struct pa_cmsg_ancil_data {
  49     pa_creds creds;
  50     bool creds_valid;
  51     int nfd;
  52
  53     /* Don't close these fds by your own. Check pa_cmsg_ancil_data_close_fds() */
  54     int fds[MAX_ANCIL_DATA_FDS];
  55     bool close_fds_on_cleanup;
  56 };
  57
  58 void pa_cmsg_ancil_data_close_fds(struct pa_cmsg_ancil_data *ancil);
  59
  60 #else
  61 #undef HAVE_CREDS
  62 #endif
  63
  64 #endif