s4:selftest Add tests for upgradeprovision
[Samba/cd1.git] / source4 / param / util.c
blobd9d4eb5e2b4009345b0f1a5392cffc5bf7e4710a
1 /*
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/>.
25 #include "includes.h"
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"
32 /**
33 * @file
34 * @brief Misc utility functions
38 bool lp_is_mydomain(struct loadparm_context *lp_ctx,
39 const char *domain)
41 return strequal(lp_workgroup(lp_ctx), domain);
44 bool lp_is_my_domain_or_realm(struct loadparm_context *lp_ctx,
45 const char *domain)
47 return strequal(lp_workgroup(lp_ctx), domain) ||
48 strequal(lp_realm(lp_ctx), domain);
51 /**
52 see if a string matches either our primary or one of our secondary
53 netbios aliases. do a case insensitive match
55 bool lp_is_myname(struct loadparm_context *lp_ctx, const char *name)
57 const char **aliases;
58 int i;
60 if (strcasecmp(name, lp_netbios_name(lp_ctx)) == 0) {
61 return true;
64 aliases = lp_netbios_aliases(lp_ctx);
65 for (i=0; aliases && aliases[i]; i++) {
66 if (strcasecmp(name, aliases[i]) == 0) {
67 return true;
71 return false;
75 /**
76 A useful function for returning a path in the Samba lock directory.
77 **/
78 char *lock_path(TALLOC_CTX* mem_ctx, struct loadparm_context *lp_ctx,
79 const char *name)
81 char *fname, *dname;
82 if (name == NULL) {
83 return NULL;
85 if (name[0] == 0 || name[0] == '/' || strstr(name, ":/")) {
86 return talloc_strdup(mem_ctx, name);
89 dname = talloc_strdup(mem_ctx, lp_lockdir(lp_ctx));
90 trim_string(dname,"","/");
92 if (!directory_exist(dname)) {
93 mkdir(dname,0755);
96 fname = talloc_asprintf(mem_ctx, "%s/%s", dname, name);
98 talloc_free(dname);
100 return fname;
104 * @brief Returns an absolute path to a file in the directory containing the current config file
106 * @param name File to find, relative to the config file directory.
108 * @retval Pointer to a talloc'ed string containing the full path.
111 char *config_path(TALLOC_CTX* mem_ctx, struct loadparm_context *lp_ctx,
112 const char *name)
114 char *fname, *config_dir, *p;
115 config_dir = talloc_strdup(mem_ctx, lp_configfile(lp_ctx));
116 if (config_dir == NULL) {
117 config_dir = talloc_strdup(mem_ctx, lp_default_path());
119 p = strrchr(config_dir, '/');
120 if (p == NULL) {
121 talloc_free(config_dir);
122 config_dir = talloc_strdup(mem_ctx, ".");
123 if (config_dir == NULL) {
124 return NULL;
126 } else {
127 p[0] = '\0';
129 fname = talloc_asprintf(mem_ctx, "%s/%s", config_dir, name);
130 talloc_free(config_dir);
131 return fname;
135 * @brief Returns an absolute path to a file in the Samba private directory.
137 * @param name File to find, relative to PRIVATEDIR.
138 * if name is not relative, then use it as-is
140 * @retval Pointer to a talloc'ed string containing the full path.
142 char *private_path(TALLOC_CTX* mem_ctx,
143 struct loadparm_context *lp_ctx,
144 const char *name)
146 char *fname;
147 if (name == NULL) {
148 return NULL;
150 if (name[0] == 0 || name[0] == '/' || strstr(name, ":/")) {
151 return talloc_strdup(mem_ctx, name);
153 fname = talloc_asprintf(mem_ctx, "%s/%s", lp_private_dir(lp_ctx), name);
154 return fname;
158 return a path in the smbd.tmp directory, where all temporary file
159 for smbd go. If NULL is passed for name then return the directory
160 path itself
162 char *smbd_tmp_path(TALLOC_CTX *mem_ctx,
163 struct loadparm_context *lp_ctx,
164 const char *name)
166 char *fname, *dname;
168 dname = private_path(mem_ctx, lp_ctx, "smbd.tmp");
169 if (!directory_exist(dname)) {
170 mkdir(dname,0755);
173 if (name == NULL) {
174 return dname;
177 fname = talloc_asprintf(mem_ctx, "%s/%s", dname, name);
178 talloc_free(dname);
180 return fname;
184 * Obtain the init function from a shared library file
186 init_module_fn load_module(TALLOC_CTX *mem_ctx, const char *path)
188 void *handle;
189 void *init_fn;
191 handle = dlopen(path, RTLD_NOW);
192 if (handle == NULL) {
193 DEBUG(0, ("Unable to open %s: %s\n", path, dlerror()));
194 return NULL;
197 init_fn = dlsym(handle, SAMBA_INIT_MODULE);
199 if (init_fn == NULL) {
200 DEBUG(0, ("Unable to find %s() in %s: %s\n",
201 SAMBA_INIT_MODULE, path, dlerror()));
202 DEBUG(1, ("Loading module '%s' failed\n", path));
203 dlclose(handle);
204 return NULL;
207 return (init_module_fn)init_fn;
211 * Obtain list of init functions from the modules in the specified
212 * directory
214 init_module_fn *load_modules(TALLOC_CTX *mem_ctx, const char *path)
216 DIR *dir;
217 struct dirent *entry;
218 char *filename;
219 int success = 0;
220 init_module_fn *ret = talloc_array(mem_ctx, init_module_fn, 2);
222 ret[0] = NULL;
224 dir = opendir(path);
225 if (dir == NULL) {
226 talloc_free(ret);
227 return NULL;
230 while((entry = readdir(dir))) {
231 if (ISDOT(entry->d_name) || ISDOTDOT(entry->d_name))
232 continue;
234 filename = talloc_asprintf(mem_ctx, "%s/%s", path, entry->d_name);
236 ret[success] = load_module(mem_ctx, filename);
237 if (ret[success]) {
238 ret = talloc_realloc(mem_ctx, ret, init_module_fn, success+2);
239 success++;
240 ret[success] = NULL;
243 talloc_free(filename);
246 closedir(dir);
248 return ret;
252 * Run the specified init functions.
254 * @return true if all functions ran successfully, false otherwise
256 bool run_init_functions(init_module_fn *fns)
258 int i;
259 bool ret = true;
261 if (fns == NULL)
262 return true;
264 for (i = 0; fns[i]; i++) { ret &= (bool)NT_STATUS_IS_OK(fns[i]()); }
266 return ret;
269 static char *modules_path(TALLOC_CTX* mem_ctx, struct loadparm_context *lp_ctx,
270 const char *name)
272 const char *env_moduledir = getenv("LD_SAMBA_MODULE_PATH");
273 return talloc_asprintf(mem_ctx, "%s/%s",
274 env_moduledir?env_moduledir:lp_modulesdir(lp_ctx),
275 name);
279 * Load the initialization functions from DSO files for a specific subsystem.
281 * Will return an array of function pointers to initialization functions
284 init_module_fn *load_samba_modules(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx, const char *subsystem)
286 char *path = modules_path(mem_ctx, lp_ctx, subsystem);
287 init_module_fn *ret;
289 ret = load_modules(mem_ctx, path);
291 talloc_free(path);
293 return ret;
296 const char *lp_messaging_path(TALLOC_CTX *mem_ctx,
297 struct loadparm_context *lp_ctx)
299 return smbd_tmp_path(mem_ctx, lp_ctx, "messaging");
302 struct smb_iconv_convenience *smb_iconv_convenience_init_lp(TALLOC_CTX *mem_ctx,
303 struct loadparm_context *lp_ctx)
305 return smb_iconv_convenience_init(mem_ctx, lp_dos_charset(lp_ctx),
306 lp_unix_charset(lp_ctx),
307 lp_parm_bool(lp_ctx, NULL, "iconv", "native", true));
311 const char *lp_sam_name(struct loadparm_context *lp_ctx)
313 switch (lp_server_role(lp_ctx)) {
314 case ROLE_DOMAIN_CONTROLLER:
315 return lp_workgroup(lp_ctx);
316 default:
317 return lp_netbios_name(lp_ctx);