• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 #ifndef foopulsecorememtraphfoo
2 #define foopulsecorememtraphfoo
3 
4 /***
5   This file is part of PulseAudio.
6 
7   Copyright 2009 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   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 #include <pulsecore/macro.h>
26 
27 /* This subsystem will trap SIGBUS on specific memory regions. The
28  * regions will be remapped to anonymous memory (i.e. writable NUL
29  * bytes) on SIGBUS, so that execution of the main program can
30  * continue though with memory having changed beneath its hands. With
31  * pa_memtrap_is_good() it is possible to query if a memory region is
32  * still 'good' i.e. no SIGBUS has happened yet for it.
33  *
34  * Intended usage is to handle memory mapped in which is controlled by
35  * other processes that might execute ftruncate() or when mapping inb
36  * hardware resources that might get invalidated when unplugged. */
37 
38 typedef struct pa_memtrap pa_memtrap;
39 
40 pa_memtrap* pa_memtrap_add(const void *start, size_t size);
41 pa_memtrap *pa_memtrap_update(pa_memtrap *m, const void *start, size_t size);
42 
43 void pa_memtrap_remove(pa_memtrap *m);
44 
45 bool pa_memtrap_is_good(pa_memtrap *m);
46 
47 void pa_memtrap_install(void);
48 
49 #endif
50