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
34typedef struct pa_creds pa_creds;
35typedef 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
41struct 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. */
48struct 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
58void pa_cmsg_ancil_data_close_fds(struct pa_cmsg_ancil_data *ancil);
59
60#else
61#undef HAVE_CREDS
62#endif
63
64#endif
65