summaryrefslogtreecommitdiffstats
path: root/src/pulsecore/memtrap.h
blob: cf3e99ea9d6a93db71164beffea75fbc48e7a1d6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
#ifndef foopulsecorememtraphfoo
#define foopulsecorememtraphfoo

/***
  This file is part of PulseAudio.

  Copyright 2009 Lennart Poettering

  PulseAudio is free software; you can redistribute it and/or modify
  it under the terms of the GNU Lesser General Public License as
  published by the Free Software Foundation; either version 2.1 of the
  License, or (at your option) any later version.

  PulseAudio is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  General Public License for more details.

  You should have received a copy of the GNU Lesser General Public
  License along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
***/

#include <sys/types.h>

#include <pulsecore/macro.h>

/* This subsystem will trap SIGBUS on specific memory regions. The
 * regions will be remapped to anonymous memory (i.e. writable NUL
 * bytes) on SIGBUS, so that execution of the main program can
 * continue though with memory having changed beneath its hands. With
 * pa_memtrap_is_good() it is possible to query if a memory region is
 * still 'good' i.e. no SIGBUS has happened yet for it.
 *
 * Intended usage is to handle memory mapped in which is controlled by
 * other processes that might execute ftruncate() or when mapping inb
 * hardware resources that might get invalidated when unplugged. */

typedef struct pa_memtrap pa_memtrap;

pa_memtrap* pa_memtrap_add(const void *start, size_t size);
pa_memtrap *pa_memtrap_update(pa_memtrap *m, const void *start, size_t size);

void pa_memtrap_remove(pa_memtrap *m);

bool pa_memtrap_is_good(pa_memtrap *m);

void pa_memtrap_install(void);

#endif