lib:util: Rename smb_load_modules()
[samba.git] / lib / util / samba_modules.h
1 /*
2    Unix SMB/CIFS implementation.
3    Handling of idle/exit events
4    Copyright (C) Stefan (metze) Metzmacher      2003
5    Copyright (C) Andrew Bartlett 2011
6
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.
19 */
20
21 #ifndef _SAMBA_MODULES_H
22 #define _SAMBA_MODULES_H
23
24 /* Module support */
25 typedef NTSTATUS (*init_module_fn) (TALLOC_CTX *ctx);
26
27 NTSTATUS samba_init_module(TALLOC_CTX *ctx);
28
29 /* this needs to be a string which is not in the C library. We
30    previously used "init_module", but that meant that modules which
31    did not define this function ended up calling the C library
32    function init_module() which makes a system call */
33 #define SAMBA_INIT_MODULE "samba_init_module"
34
35 /**
36  * Obtain the init function from a shared library file.  
37  *
38  * The handle to dlclose() in case of error is returns in *handle if handle is not NULL
39  */
40 init_module_fn load_module(const char *path, bool is_probe, void **handle);
41
42 /**
43  * Run the specified init functions.
44  *
45  * @return true if all functions ran successfully, false otherwise
46  */
47 bool run_init_functions(TALLOC_CTX *ctx, init_module_fn *fns);
48
49 /**
50  * Load the initialization functions from DSO files for a specific subsystem.
51  *
52  * Will return an array of function pointers to initialization functions
53  */
54 init_module_fn *load_samba_modules(TALLOC_CTX *mem_ctx, const char *subsystem);
55
56 int smb_load_all_modules_absoute_path(const char **modules);
57 NTSTATUS smb_probe_module(const char *subsystem, const char *module);
58 NTSTATUS smb_load_module(const char *subsystem, const char *module);
59
60 #endif /* _SAMBA_MODULES_H */