blob: fa38da58dd72ba54ee11620f3fd37a98f1f6ea88 (plain
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, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
/* 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);
pa_bool_t pa_memtrap_is_good(pa_memtrap *m);