pulseaudio/src/pulsecore/module.h
Colin Leroy f0dfddead3 cli-command: don't exit on "module already loaded" errors
Some modules may only be loaded once, and trying to load them
twice from default.pa makes PulseAudio startup fail. While that could
be considered a user error, it's nicer to not be so strict. It's not
necessarily easy to figure what went wrong, if for example the user
plays with RAOP and adds module-raop-discover to default.pa, which first
works fine, but suddenly stops working when the user at some point
enables RAOP support in paprefs. Enabling RAOP in paprefs makes
module-gconf load the module too, so the module gets loaded twice.

This patch adds a way to differentiate module load errors, and
make cli-command ignore the error when the module is already
loaded.
2017-09-05 13:46:27 +03:00

95 lines
3 KiB
C

#ifndef foomodulehfoo
#define foomodulehfoo
/***
This file is part of PulseAudio.
Copyright 2004-2006 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 <inttypes.h>
#include <ltdl.h>
typedef struct pa_module pa_module;
#include <pulse/proplist.h>
#include <pulsecore/dynarray.h>
#include <pulsecore/core.h>
struct pa_module {
pa_core *core;
char *name, *argument;
uint32_t index;
lt_dlhandle dl;
int (*init)(pa_module*m);
void (*done)(pa_module*m);
int (*get_n_used)(pa_module *m);
void *userdata;
bool load_once:1;
bool unload_requested:1;
pa_proplist *proplist;
pa_dynarray *hooks;
};
bool pa_module_exists(const char *name);
int pa_module_load(pa_module** m, pa_core *c, const char *name, const char *argument);
void pa_module_unload(pa_module *m, bool force);
void pa_module_unload_by_index(pa_core *c, uint32_t idx, bool force);
void pa_module_unload_request(pa_module *m, bool force);
void pa_module_unload_request_by_index(pa_core *c, uint32_t idx, bool force);
void pa_module_unload_all(pa_core *c);
int pa_module_get_n_used(pa_module*m);
void pa_module_update_proplist(pa_module *m, pa_update_mode_t mode, pa_proplist *p);
void pa_module_hook_connect(pa_module *m, pa_hook *hook, pa_hook_priority_t prio, pa_hook_cb_t cb, void *data);
#define PA_MODULE_AUTHOR(s) \
const char *pa__get_author(void) { return s; } \
struct __stupid_useless_struct_to_allow_trailing_semicolon
#define PA_MODULE_DESCRIPTION(s) \
const char *pa__get_description(void) { return s; } \
struct __stupid_useless_struct_to_allow_trailing_semicolon
#define PA_MODULE_USAGE(s) \
const char *pa__get_usage(void) { return s; } \
struct __stupid_useless_struct_to_allow_trailing_semicolon
#define PA_MODULE_VERSION(s) \
const char * pa__get_version(void) { return s; } \
struct __stupid_useless_struct_to_allow_trailing_semicolon
#define PA_MODULE_DEPRECATED(s) \
const char * pa__get_deprecated(void) { return s; } \
struct __stupid_useless_struct_to_allow_trailing_semicolon
#define PA_MODULE_LOAD_ONCE(b) \
bool pa__load_once(void) { return b; } \
struct __stupid_useless_struct_to_allow_trailing_semicolon
#endif