WHATSNEW: Update release notes.
[Samba.git] / source3 / utils / testparm.c
blobe8458fda1b6c7b74d3d51593f00c72552a6b9850
1 /*
2 Unix SMB/CIFS implementation.
3 Test validity of smb.conf
4 Copyright (C) Karl Auer 1993, 1994-1998
6 Extensively modified by Andrew Tridgell, 1995
7 Converted to popt by Jelmer Vernooij (jelmer@nl.linux.org), 2002
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * Testbed for loadparm.c/params.c
26 * This module simply loads a specified configuration file and
27 * if successful, dumps it's contents to stdout. Note that the
28 * operation is performed with DEBUGLEVEL at 3.
30 * Useful for a quick 'syntax check' of a configuration file.
34 #include "includes.h"
36 extern bool AllowDebugChange;
38 /***********************************************
39 Here we do a set of 'hard coded' checks for bad
40 configuration settings.
41 ************************************************/
43 static int do_global_checks(void)
45 int ret = 0;
46 SMB_STRUCT_STAT st;
48 if (lp_security() >= SEC_DOMAIN && !lp_encrypted_passwords()) {
49 fprintf(stderr, "ERROR: in 'security=domain' mode the 'encrypt passwords' parameter must always be set to 'true'.\n");
50 ret = 1;
53 if (lp_wins_support() && lp_wins_server_list()) {
54 fprintf(stderr, "ERROR: both 'wins support = true' and 'wins server = <server list>' \
55 cannot be set in the smb.conf file. nmbd will abort with this setting.\n");
56 ret = 1;
59 if (!directory_exist_stat(lp_lockdir(), &st)) {
60 fprintf(stderr, "ERROR: lock directory %s does not exist\n",
61 lp_lockdir());
62 ret = 1;
63 } else if ((st.st_mode & 0777) != 0755) {
64 fprintf(stderr, "WARNING: lock directory %s should have permissions 0755 for browsing to work\n",
65 lp_lockdir());
66 ret = 1;
69 if (!directory_exist_stat(lp_statedir(), &st)) {
70 fprintf(stderr, "ERROR: state directory %s does not exist\n",
71 lp_statedir());
72 ret = 1;
73 } else if ((st.st_mode & 0777) != 0755) {
74 fprintf(stderr, "WARNING: state directory %s should have permissions 0755 for browsing to work\n",
75 lp_statedir());
76 ret = 1;
79 if (!directory_exist_stat(lp_cachedir(), &st)) {
80 fprintf(stderr, "ERROR: cache directory %s does not exist\n",
81 lp_cachedir());
82 ret = 1;
83 } else if ((st.st_mode & 0777) != 0755) {
84 fprintf(stderr, "WARNING: cache directory %s should have permissions 0755 for browsing to work\n",
85 lp_cachedir());
86 ret = 1;
89 if (!directory_exist_stat(lp_piddir(), &st)) {
90 fprintf(stderr, "ERROR: pid directory %s does not exist\n",
91 lp_piddir());
92 ret = 1;
95 if (lp_passdb_expand_explicit()) {
96 fprintf(stderr, "WARNING: passdb expand explicit = yes is "
97 "deprecated\n");
101 * Password server sanity checks.
104 if((lp_security() == SEC_SERVER || lp_security() >= SEC_DOMAIN) && !lp_passwordserver()) {
105 const char *sec_setting;
106 if(lp_security() == SEC_SERVER)
107 sec_setting = "server";
108 else if(lp_security() == SEC_DOMAIN)
109 sec_setting = "domain";
110 else
111 sec_setting = "";
113 fprintf(stderr, "ERROR: The setting 'security=%s' requires the 'password server' parameter be set \
114 to a valid password server.\n", sec_setting );
115 ret = 1;
119 * Password chat sanity checks.
122 if(lp_security() == SEC_USER && lp_unix_password_sync()) {
125 * Check that we have a valid lp_passwd_program() if not using pam.
128 #ifdef WITH_PAM
129 if (!lp_pam_password_change()) {
130 #endif
132 if((lp_passwd_program() == NULL) ||
133 (strlen(lp_passwd_program()) == 0))
135 fprintf( stderr, "ERROR: the 'unix password sync' parameter is set and there is no valid 'passwd program' \
136 parameter.\n" );
137 ret = 1;
138 } else {
139 const char *passwd_prog;
140 char *truncated_prog = NULL;
141 const char *p;
143 passwd_prog = lp_passwd_program();
144 p = passwd_prog;
145 next_token_talloc(talloc_tos(),
147 &truncated_prog, NULL);
148 if (truncated_prog && access(truncated_prog, F_OK) == -1) {
149 fprintf(stderr, "ERROR: the 'unix password sync' parameter is set and the 'passwd program' (%s) \
150 cannot be executed (error was %s).\n", truncated_prog, strerror(errno) );
151 ret = 1;
155 #ifdef WITH_PAM
157 #endif
159 if(lp_passwd_chat() == NULL) {
160 fprintf(stderr, "ERROR: the 'unix password sync' parameter is set and there is no valid 'passwd chat' \
161 parameter.\n");
162 ret = 1;
165 if ((lp_passwd_program() != NULL) &&
166 (strlen(lp_passwd_program()) > 0))
168 /* check if there's a %u parameter present */
169 if(strstr_m(lp_passwd_program(), "%u") == NULL) {
170 fprintf(stderr, "ERROR: the 'passwd program' (%s) requires a '%%u' parameter.\n", lp_passwd_program());
171 ret = 1;
176 * Check that we have a valid script and that it hasn't
177 * been written to expect the old password.
180 if(lp_encrypted_passwords()) {
181 if(strstr_m( lp_passwd_chat(), "%o")!=NULL) {
182 fprintf(stderr, "ERROR: the 'passwd chat' script [%s] expects to use the old plaintext password \
183 via the %%o substitution. With encrypted passwords this is not possible.\n", lp_passwd_chat() );
184 ret = 1;
189 if (strlen(lp_winbind_separator()) != 1) {
190 fprintf(stderr,"ERROR: the 'winbind separator' parameter must be a single character.\n");
191 ret = 1;
194 if (*lp_winbind_separator() == '+') {
195 fprintf(stderr,"'winbind separator = +' might cause problems with group membership.\n");
198 if (lp_algorithmic_rid_base() < BASE_RID) {
199 /* Try to prevent admin foot-shooting, we can't put algorithmic
200 rids below 1000, that's the 'well known RIDs' on NT */
201 fprintf(stderr,"'algorithmic rid base' must be equal to or above %lu\n", BASE_RID);
204 if (lp_algorithmic_rid_base() & 1) {
205 fprintf(stderr,"'algorithmic rid base' must be even.\n");
208 #ifndef HAVE_DLOPEN
209 if (lp_preload_modules()) {
210 fprintf(stderr,"WARNING: 'preload modules = ' set while loading plugins not supported.\n");
212 #endif
214 if (!lp_passdb_backend()) {
215 fprintf(stderr,"ERROR: passdb backend must have a value or be left out\n");
218 if (lp_os_level() > 255) {
219 fprintf(stderr,"WARNING: Maximum value for 'os level' is 255!\n");
222 return ret;
226 * per-share logic tests
228 static void do_per_share_checks(int s)
230 const char **deny_list = lp_hostsdeny(s);
231 const char **allow_list = lp_hostsallow(s);
232 int i;
234 if(deny_list) {
235 for (i=0; deny_list[i]; i++) {
236 char *hasstar = strchr_m(deny_list[i], '*');
237 char *hasquery = strchr_m(deny_list[i], '?');
238 if(hasstar || hasquery) {
239 fprintf(stderr,"Invalid character %c in hosts deny list (%s) for service %s.\n",
240 hasstar ? *hasstar : *hasquery, deny_list[i], lp_servicename(s) );
245 if(allow_list) {
246 for (i=0; allow_list[i]; i++) {
247 char *hasstar = strchr_m(allow_list[i], '*');
248 char *hasquery = strchr_m(allow_list[i], '?');
249 if(hasstar || hasquery) {
250 fprintf(stderr,"Invalid character %c in hosts allow list (%s) for service %s.\n",
251 hasstar ? *hasstar : *hasquery, allow_list[i], lp_servicename(s) );
256 if(lp_level2_oplocks(s) && !lp_oplocks(s)) {
257 fprintf(stderr,"Invalid combination of parameters for service %s. \
258 Level II oplocks can only be set if oplocks are also set.\n",
259 lp_servicename(s) );
262 if (lp_map_hidden(s) && !(lp_create_mask(s) & S_IXOTH)) {
263 fprintf(stderr,"Invalid combination of parameters for service %s. \
264 Map hidden can only work if create mask includes octal 01 (S_IXOTH).\n",
265 lp_servicename(s) );
267 if (lp_map_hidden(s) && (lp_force_create_mode(s) & S_IXOTH)) {
268 fprintf(stderr,"Invalid combination of parameters for service %s. \
269 Map hidden can only work if force create mode excludes octal 01 (S_IXOTH).\n",
270 lp_servicename(s) );
272 if (lp_map_system(s) && !(lp_create_mask(s) & S_IXGRP)) {
273 fprintf(stderr,"Invalid combination of parameters for service %s. \
274 Map system can only work if create mask includes octal 010 (S_IXGRP).\n",
275 lp_servicename(s) );
277 if (lp_map_system(s) && (lp_force_create_mode(s) & S_IXGRP)) {
278 fprintf(stderr,"Invalid combination of parameters for service %s. \
279 Map system can only work if force create mode excludes octal 010 (S_IXGRP).\n",
280 lp_servicename(s) );
282 #ifdef HAVE_CUPS
283 if (lp_printing(s) == PRINT_CUPS && *(lp_printcommand(s)) != '\0') {
284 fprintf(stderr,"Warning: Service %s defines a print command, but \
285 rameter is ignored when using CUPS libraries.\n",
286 lp_servicename(s) );
288 #endif
291 int main(int argc, const char *argv[])
293 const char *config_file = get_dyn_CONFIGFILE();
294 int s;
295 static int silent_mode = False;
296 static int show_all_parameters = False;
297 int ret = 0;
298 poptContext pc;
299 static const char *term_code = "";
300 static char *parameter_name = NULL;
301 static const char *section_name = NULL;
302 static char *new_local_machine = NULL;
303 const char *cname;
304 const char *caddr;
305 static int show_defaults;
306 static int skip_logic_checks = 0;
308 struct poptOption long_options[] = {
309 POPT_AUTOHELP
310 {"suppress-prompt", 's', POPT_ARG_VAL, &silent_mode, 1, "Suppress prompt for enter"},
311 {"verbose", 'v', POPT_ARG_NONE, &show_defaults, 1, "Show default options too"},
312 {"server", 'L',POPT_ARG_STRING, &new_local_machine, 0, "Set %%L macro to servername\n"},
313 {"encoding", 't', POPT_ARG_STRING, &term_code, 0, "Print parameters with encoding"},
314 {"skip-logic-checks", 'l', POPT_ARG_NONE, &skip_logic_checks, 1, "Skip the global checks"},
315 {"show-all-parameters", '\0', POPT_ARG_VAL, &show_all_parameters, True, "Show the parameters, type, possible values" },
316 {"parameter-name", '\0', POPT_ARG_STRING, &parameter_name, 0, "Limit testparm to a named parameter" },
317 {"section-name", '\0', POPT_ARG_STRING, &section_name, 0, "Limit testparm to a named section" },
318 POPT_COMMON_VERSION
319 POPT_COMMON_DEBUGLEVEL
320 POPT_TABLEEND
323 TALLOC_CTX *frame = talloc_stackframe();
325 load_case_tables();
327 * Set the default debug level to 2.
328 * Allow it to be overridden by the command line,
329 * not by smb.conf.
331 DEBUGLEVEL_CLASS[DBGC_ALL] = 2;
333 pc = poptGetContext(NULL, argc, argv, long_options,
334 POPT_CONTEXT_KEEP_FIRST);
335 poptSetOtherOptionHelp(pc, "[OPTION...] <config-file> [host-name] [host-ip]");
337 while(poptGetNextOpt(pc) != -1);
339 if (show_all_parameters) {
340 show_parameter_list();
341 exit(0);
344 setup_logging(poptGetArg(pc), True);
346 if (poptPeekArg(pc))
347 config_file = poptGetArg(pc);
349 cname = poptGetArg(pc);
350 caddr = poptGetArg(pc);
352 poptFreeContext(pc);
354 if ( cname && ! caddr ) {
355 printf ( "ERROR: You must specify both a machine name and an IP address.\n" );
356 ret = 1;
357 goto done;
360 if (new_local_machine) {
361 set_local_machine_name(new_local_machine, True);
364 dbf = x_stderr;
365 /* Don't let the debuglevel be changed by smb.conf. */
366 AllowDebugChange = False;
368 fprintf(stderr,"Load smb config files from %s\n",config_file);
370 if (!lp_load_with_registry_shares(config_file,False,True,False,True)) {
371 fprintf(stderr,"Error loading services.\n");
372 ret = 1;
373 goto done;
376 fprintf(stderr,"Loaded services file OK.\n");
378 if (skip_logic_checks == 0) {
379 ret = do_global_checks();
382 for (s=0;s<1000;s++) {
383 if (VALID_SNUM(s))
384 if (strlen(lp_servicename(s)) > 12) {
385 fprintf(stderr, "WARNING: You have some share names that are longer than 12 characters.\n" );
386 fprintf(stderr, "These may not be accessible to some older clients.\n" );
387 fprintf(stderr, "(Eg. Windows9x, WindowsMe, and smbclient prior to Samba 3.0.)\n" );
388 break;
392 for (s=0;s<1000;s++) {
393 if (VALID_SNUM(s) && (skip_logic_checks == 0)) {
394 do_per_share_checks(s);
399 if (!section_name && !parameter_name) {
400 fprintf(stderr,"Server role: %s\n", server_role_str(lp_server_role()));
403 if (!cname) {
404 if (!silent_mode) {
405 fprintf(stderr,"Press enter to see a dump of your service definitions\n");
406 fflush(stdout);
407 getc(stdin);
409 if (parameter_name || section_name) {
410 bool isGlobal = False;
411 s = GLOBAL_SECTION_SNUM;
413 if (!section_name) {
414 section_name = GLOBAL_NAME;
415 isGlobal = True;
416 } else if ((isGlobal=!strwicmp(section_name, GLOBAL_NAME)) == 0 &&
417 (s=lp_servicenumber(section_name)) == -1) {
418 fprintf(stderr,"Unknown section %s\n",
419 section_name);
420 ret = 1;
421 goto done;
423 if (parameter_name) {
424 if (!dump_a_parameter( s, parameter_name, stdout, isGlobal)) {
425 fprintf(stderr,"Parameter %s unknown for section %s\n",
426 parameter_name, section_name);
427 ret = 1;
428 goto done;
430 } else {
431 if (isGlobal == True)
432 lp_dump(stdout, show_defaults, 0);
433 else
434 lp_dump_one(stdout, show_defaults, s);
436 goto done;
439 lp_dump(stdout, show_defaults, lp_numservices());
442 if(cname && caddr){
443 /* this is totally ugly, a real `quick' hack */
444 for (s=0;s<1000;s++) {
445 if (VALID_SNUM(s)) {
446 if (allow_access(lp_hostsdeny(-1), lp_hostsallow(-1), cname, caddr)
447 && allow_access(lp_hostsdeny(s), lp_hostsallow(s), cname, caddr)) {
448 fprintf(stderr,"Allow connection from %s (%s) to %s\n",
449 cname,caddr,lp_servicename(s));
450 } else {
451 fprintf(stderr,"Deny connection from %s (%s) to %s\n",
452 cname,caddr,lp_servicename(s));
458 done:
459 gfree_loadparm();
460 TALLOC_FREE(frame);
461 return ret;