2 Unix SMB/CIFS implementation.
3 Samba utility functions
4 Copyright (C) Andrew Tridgell 1992-1998
5 Copyright (C) Jeremy Allison 2001-2002
6 Copyright (C) Simo Sorce 2001
7 Copyright (C) Jim McDonough (jmcd@us.ibm.com) 2003.
8 Copyright (C) James J Myers 2003
9 Copyright (C) Jelmer Vernooij 2005-2007
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 3 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 #include "dynconfig/dynconfig.h"
27 #include "system/network.h"
28 #include "system/filesys.h"
29 #include "system/dir.h"
30 #include "param/param.h"
34 * @brief Misc utility functions
38 bool lpcfg_is_mydomain(struct loadparm_context
*lp_ctx
,
41 return strequal(lpcfg_workgroup(lp_ctx
), domain
);
44 bool lpcfg_is_my_domain_or_realm(struct loadparm_context
*lp_ctx
,
47 return strequal(lpcfg_workgroup(lp_ctx
), domain
) ||
48 strequal(lpcfg_realm(lp_ctx
), domain
);
52 see if a string matches either our primary or one of our secondary
53 netbios aliases. do a case insensitive match
55 bool lpcfg_is_myname(struct loadparm_context
*lp_ctx
, const char *name
)
60 if (strcasecmp(name
, lpcfg_netbios_name(lp_ctx
)) == 0) {
64 aliases
= lpcfg_netbios_aliases(lp_ctx
);
65 for (i
=0; aliases
&& aliases
[i
]; i
++) {
66 if (strcasecmp(name
, aliases
[i
]) == 0) {
76 A useful function for returning a path in the Samba lock directory.
78 char *lpcfg_lock_path(TALLOC_CTX
* mem_ctx
, struct loadparm_context
*lp_ctx
,
85 if (name
[0] == 0 || name
[0] == '/' || strstr(name
, ":/")) {
86 return talloc_strdup(mem_ctx
, name
);
89 dname
= talloc_strdup(mem_ctx
, lpcfg_lockdir(lp_ctx
));
90 trim_string(dname
,"","/");
92 if (!directory_exist(dname
)) {
96 fname
= talloc_asprintf(mem_ctx
, "%s/%s", dname
, name
);
104 A useful function for returning a path in the Samba state directory.
106 char *lpcfg_state_path(TALLOC_CTX
* mem_ctx
, struct loadparm_context
*lp_ctx
,
113 if (name
[0] == 0 || name
[0] == '/' || strstr(name
, ":/")) {
114 return talloc_strdup(mem_ctx
, name
);
117 dname
= talloc_strdup(mem_ctx
, lpcfg_statedir(lp_ctx
));
118 trim_string(dname
,"","/");
120 if (!directory_exist(dname
)) {
124 fname
= talloc_asprintf(mem_ctx
, "%s/%s", dname
, name
);
132 A useful function for returning a path in the Samba cache directory.
134 char *lpcfg_cache_path(TALLOC_CTX
* mem_ctx
, struct loadparm_context
*lp_ctx
,
141 if (name
[0] == 0 || name
[0] == '/' || strstr(name
, ":/")) {
142 return talloc_strdup(mem_ctx
, name
);
145 dname
= talloc_strdup(mem_ctx
, lpcfg_cachedir(lp_ctx
));
146 trim_string(dname
,"","/");
148 if (!directory_exist(dname
)) {
152 fname
= talloc_asprintf(mem_ctx
, "%s/%s", dname
, name
);
160 * @brief Returns an absolute path to a file in the directory containing the current config file
162 * @param name File to find, relative to the config file directory.
164 * @retval Pointer to a talloc'ed string containing the full path.
167 char *lpcfg_config_path(TALLOC_CTX
* mem_ctx
, struct loadparm_context
*lp_ctx
,
170 char *fname
, *config_dir
, *p
;
171 config_dir
= talloc_strdup(mem_ctx
, lpcfg_configfile(lp_ctx
));
172 if (config_dir
== NULL
) {
173 config_dir
= talloc_strdup(mem_ctx
, lp_default_path());
175 p
= strrchr(config_dir
, '/');
177 talloc_free(config_dir
);
178 config_dir
= talloc_strdup(mem_ctx
, ".");
179 if (config_dir
== NULL
) {
185 fname
= talloc_asprintf(mem_ctx
, "%s/%s", config_dir
, name
);
186 talloc_free(config_dir
);
191 * @brief Returns an absolute path to a file in the Samba private directory.
193 * @param name File to find, relative to PRIVATEDIR.
194 * if name is not relative, then use it as-is
196 * @retval Pointer to a talloc'ed string containing the full path.
198 char *lpcfg_private_path(TALLOC_CTX
* mem_ctx
,
199 struct loadparm_context
*lp_ctx
,
206 if (name
[0] == 0 || name
[0] == '/' || strstr(name
, ":/")) {
207 return talloc_strdup(mem_ctx
, name
);
209 fname
= talloc_asprintf(mem_ctx
, "%s/%s", lpcfg_private_dir(lp_ctx
), name
);
214 return a path in the smbd.tmp directory, where all temporary file
215 for smbd go. If NULL is passed for name then return the directory
218 char *smbd_tmp_path(TALLOC_CTX
*mem_ctx
,
219 struct loadparm_context
*lp_ctx
,
224 dname
= lpcfg_private_path(mem_ctx
, lp_ctx
, "smbd.tmp");
225 if (!directory_exist(dname
)) {
233 fname
= talloc_asprintf(mem_ctx
, "%s/%s", dname
, name
);
240 * Obtain the init function from a shared library file
242 init_module_fn
load_module(TALLOC_CTX
*mem_ctx
, const char *path
)
247 handle
= dlopen(path
, RTLD_NOW
);
248 if (handle
== NULL
) {
249 DEBUG(0, ("Unable to open %s: %s\n", path
, dlerror()));
253 init_fn
= dlsym(handle
, SAMBA_INIT_MODULE
);
255 if (init_fn
== NULL
) {
256 DEBUG(0, ("Unable to find %s() in %s: %s\n",
257 SAMBA_INIT_MODULE
, path
, dlerror()));
258 DEBUG(1, ("Loading module '%s' failed\n", path
));
263 return (init_module_fn
)init_fn
;
267 * Obtain list of init functions from the modules in the specified
270 init_module_fn
*load_modules(TALLOC_CTX
*mem_ctx
, const char *path
)
273 struct dirent
*entry
;
276 init_module_fn
*ret
= talloc_array(mem_ctx
, init_module_fn
, 2);
286 while((entry
= readdir(dir
))) {
287 if (ISDOT(entry
->d_name
) || ISDOTDOT(entry
->d_name
))
290 filename
= talloc_asprintf(mem_ctx
, "%s/%s", path
, entry
->d_name
);
292 ret
[success
] = load_module(mem_ctx
, filename
);
294 ret
= talloc_realloc(mem_ctx
, ret
, init_module_fn
, success
+2);
299 talloc_free(filename
);
308 * Run the specified init functions.
310 * @return true if all functions ran successfully, false otherwise
312 bool run_init_functions(init_module_fn
*fns
)
320 for (i
= 0; fns
[i
]; i
++) { ret
&= (bool)NT_STATUS_IS_OK(fns
[i
]()); }
326 * Load the initialization functions from DSO files for a specific subsystem.
328 * Will return an array of function pointers to initialization functions
331 init_module_fn
*load_samba_modules(TALLOC_CTX
*mem_ctx
, const char *subsystem
)
333 char *path
= modules_path(mem_ctx
, subsystem
);
336 ret
= load_modules(mem_ctx
, path
);
343 const char *lpcfg_imessaging_path(TALLOC_CTX
*mem_ctx
,
344 struct loadparm_context
*lp_ctx
)
346 return smbd_tmp_path(mem_ctx
, lp_ctx
, "msg");
349 struct smb_iconv_handle
*smb_iconv_handle_reinit_lp(TALLOC_CTX
*mem_ctx
,
350 struct loadparm_context
*lp_ctx
,
351 struct smb_iconv_handle
*old_ic
)
353 return smb_iconv_handle_reinit(mem_ctx
, lpcfg_dos_charset(lp_ctx
),
354 lpcfg_unix_charset(lp_ctx
),
355 lpcfg_parm_bool(lp_ctx
, NULL
, "iconv", "native", true),
360 const char *lpcfg_sam_name(struct loadparm_context
*lp_ctx
)
362 switch (lpcfg_server_role(lp_ctx
)) {
363 case ROLE_DOMAIN_BDC
:
364 case ROLE_DOMAIN_PDC
:
365 return lpcfg_workgroup(lp_ctx
);
367 return lpcfg_netbios_name(lp_ctx
);