2 Unix SMB/CIFS implementation.
3 Parameter loading functions
4 Copyright (C) Karl Auer 1993-1998
6 Largely re-written by Andrew Tridgell, September 1994
8 Copyright (C) Simo Sorce 2001
9 Copyright (C) Alexander Bokovoy 2002
10 Copyright (C) Stefan (metze) Metzmacher 2002
11 Copyright (C) Jim McDonough (jmcd@us.ibm.com) 2003.
12 Copyright (C) James Myers 2003 <myersjj@samba.org>
13 Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007
15 This program is free software; you can redistribute it and/or modify
16 it under the terms of the GNU General Public License as published by
17 the Free Software Foundation; either version 3 of the License, or
18 (at your option) any later version.
20 This program is distributed in the hope that it will be useful,
21 but WITHOUT ANY WARRANTY; without even the implied warranty of
22 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 GNU General Public License for more details.
25 You should have received a copy of the GNU General Public License
26 along with this program. If not, see <http://www.gnu.org/licenses/>.
32 * This module provides suitable callback functions for the params
33 * module. It builds the internal table of service details which is
34 * then used by the rest of the server.
38 * 1) add it to the global or service structure definition
39 * 2) add it to the parm_table
40 * 3) add it to the list of available functions (eg: using FN_GLOBAL_STRING())
41 * 4) If it's a global then initialise it in init_globals. If a local
42 * (ie. service) parameter then initialise it in the sDefault structure
46 * The configuration file is processed sequentially for speed. It is NOT
47 * accessed randomly as happens in 'real' Windows. For this reason, there
48 * is a fair bit of sequence-dependent code here - ie., code which assumes
49 * that certain things happen before others. In particular, the code which
50 * happens at the boundary between sections is delicately poised, so be
57 #include "dynconfig/dynconfig.h"
58 #include "system/time.h"
59 #include "system/locale.h"
60 #include "system/network.h" /* needed for TCP_NODELAY */
61 #include "smb_server/smb_server.h"
62 #include "libcli/raw/signing.h"
63 #include "../lib/util/dlinklist.h"
64 #include "../lib/util/parmlist.h"
65 #include "param/param.h"
66 #include "param/loadparm.h"
67 #include "libcli/raw/libcliraw.h"
68 #include "rpc_server/common/common.h"
69 #include "lib/socket/socket.h"
70 #include "auth/gensec/gensec.h"
73 #define standard_sub_basic talloc_strdup
75 static bool do_parameter(const char *, const char *, void *);
76 static bool defaults_saved = false;
78 #define LOADPARM_EXTRA_GLOBALS \
79 struct parmlist_entry *param_opt; \
90 #define LOADPARM_EXTRA_LOCALS \
91 struct parmlist_entry *param_opt; \
95 char *szPrintername; \
100 char dummy[3]; /* for alignment */
102 #include "param_global.h"
103 #include "param_local.h"
105 #define NUMPARAMETERS (sizeof(parm_table) / sizeof(struct parm_struct))
108 /* prototypes for the special type handlers */
109 static bool handle_include(struct loadparm_context *lp_ctx, int unused,
110 const char *pszParmValue, char **ptr);
111 static bool handle_realm(struct loadparm_context *lp_ctx, int unused,
112 const char *pszParmValue, char **ptr);
113 static bool handle_copy(struct loadparm_context *lp_ctx, int unused,
114 const char *pszParmValue, char **ptr);
115 static bool handle_debuglevel(struct loadparm_context *lp_ctx, int unused,
116 const char *pszParmValue, char **ptr);
117 static bool handle_logfile(struct loadparm_context *lp_ctx, int unused,
118 const char *pszParmValue, char **ptr);
120 static const struct enum_list enum_protocol[] = {
121 {PROTOCOL_SMB2, "SMB2"},
122 {PROTOCOL_NT1, "NT1"},
123 {PROTOCOL_LANMAN2, "LANMAN2"},
124 {PROTOCOL_LANMAN1, "LANMAN1"},
125 {PROTOCOL_CORE, "CORE"},
126 {PROTOCOL_COREPLUS, "COREPLUS"},
127 {PROTOCOL_COREPLUS, "CORE+"},
131 static const struct enum_list enum_security[] = {
132 {SEC_SHARE, "SHARE"},
138 static const struct enum_list enum_bool_auto[] = {
149 /* Client-side offline caching policy types */
152 CSC_POLICY_DOCUMENTS=1,
153 CSC_POLICY_PROGRAMS=2,
157 static const struct enum_list enum_csc_policy[] = {
158 {CSC_POLICY_MANUAL, "manual"},
159 {CSC_POLICY_DOCUMENTS, "documents"},
160 {CSC_POLICY_PROGRAMS, "programs"},
161 {CSC_POLICY_DISABLE, "disable"},
165 /* SMB signing types. */
166 static const struct enum_list enum_smb_signing_vals[] = {
167 {SMB_SIGNING_OFF, "No"},
168 {SMB_SIGNING_OFF, "False"},
169 {SMB_SIGNING_OFF, "0"},
170 {SMB_SIGNING_OFF, "Off"},
171 {SMB_SIGNING_OFF, "disabled"},
172 {SMB_SIGNING_SUPPORTED, "Yes"},
173 {SMB_SIGNING_SUPPORTED, "True"},
174 {SMB_SIGNING_SUPPORTED, "1"},
175 {SMB_SIGNING_SUPPORTED, "On"},
176 {SMB_SIGNING_SUPPORTED, "enabled"},
177 {SMB_SIGNING_REQUIRED, "required"},
178 {SMB_SIGNING_REQUIRED, "mandatory"},
179 {SMB_SIGNING_REQUIRED, "force"},
180 {SMB_SIGNING_REQUIRED, "forced"},
181 {SMB_SIGNING_REQUIRED, "enforced"},
182 {SMB_SIGNING_AUTO, "auto"},
186 static const struct enum_list enum_server_role[] = {
187 {ROLE_STANDALONE, "standalone"},
188 {ROLE_DOMAIN_MEMBER, "member server"},
189 {ROLE_DOMAIN_MEMBER, "member"},
190 {ROLE_DOMAIN_CONTROLLER, "domain controller"},
191 {ROLE_DOMAIN_CONTROLLER, "dc"},
195 #define GLOBAL_VAR(name) offsetof(struct loadparm_global, name)
196 #define LOCAL_VAR(name) offsetof(struct loadparm_service, name)
198 static struct parm_struct parm_table[] = {
200 .label = "server role",
203 .offset = GLOBAL_VAR(server_role),
205 .enum_list = enum_server_role
208 .label = "dos charset",
211 .offset = GLOBAL_VAR(dos_charset),
216 .label = "unix charset",
219 .offset = GLOBAL_VAR(unix_charset),
224 .label = "ncalrpc dir",
227 .offset = GLOBAL_VAR(ncalrpc_dir),
235 .offset = LOCAL_VAR(comment),
243 .offset = LOCAL_VAR(szPath),
248 .label = "directory",
251 .offset = LOCAL_VAR(szPath),
256 .label = "workgroup",
259 .offset = GLOBAL_VAR(szWorkgroup),
267 .offset = GLOBAL_VAR(szRealm),
268 .special = handle_realm,
272 .label = "netbios name",
275 .offset = GLOBAL_VAR(szNetbiosName),
280 .label = "netbios aliases",
283 .offset = GLOBAL_VAR(szNetbiosAliases),
288 .label = "netbios scope",
291 .offset = GLOBAL_VAR(szNetbiosScope),
296 .label = "server string",
299 .offset = GLOBAL_VAR(szServerString),
304 .label = "interfaces",
307 .offset = GLOBAL_VAR(szInterfaces),
312 .label = "bind interfaces only",
315 .offset = GLOBAL_VAR(bBindInterfacesOnly),
320 .label = "ntvfs handler",
323 .offset = LOCAL_VAR(ntvfs_handler),
328 .label = "ntptr providor",
331 .offset = GLOBAL_VAR(ntptr_providor),
336 .label = "dcerpc endpoint servers",
339 .offset = GLOBAL_VAR(dcerpc_ep_servers),
344 .label = "server services",
347 .offset = GLOBAL_VAR(server_services),
356 .offset = GLOBAL_VAR(security),
358 .enum_list = enum_security
361 .label = "encrypt passwords",
364 .offset = GLOBAL_VAR(bEncryptPasswords),
369 .label = "null passwords",
372 .offset = GLOBAL_VAR(bNullPasswords),
377 .label = "obey pam restrictions",
380 .offset = GLOBAL_VAR(bObeyPamRestrictions),
385 .label = "password server",
388 .offset = GLOBAL_VAR(szPasswordServers),
393 .label = "spoolss database",
396 .offset = GLOBAL_VAR(szSPOOLSS_URL),
401 .label = "wins config database",
404 .offset = GLOBAL_VAR(szWINS_CONFIG_URL),
409 .label = "wins database",
412 .offset = GLOBAL_VAR(szWINS_URL),
417 .label = "private dir",
420 .offset = GLOBAL_VAR(szPrivateDir),
425 .label = "passwd chat",
428 .offset = GLOBAL_VAR(szPasswdChat),
433 .label = "password level",
436 .offset = GLOBAL_VAR(pwordlevel),
441 .label = "lanman auth",
444 .offset = GLOBAL_VAR(bLanmanAuth),
449 .label = "ntlm auth",
452 .offset = GLOBAL_VAR(bNTLMAuth),
457 .label = "client NTLMv2 auth",
460 .offset = GLOBAL_VAR(bClientNTLMv2Auth),
465 .label = "client lanman auth",
468 .offset = GLOBAL_VAR(bClientLanManAuth),
473 .label = "client plaintext auth",
476 .offset = GLOBAL_VAR(bClientPlaintextAuth),
481 .label = "client use spnego principal",
484 .offset = GLOBAL_VAR(client_use_spnego_principal),
490 .label = "read only",
493 .offset = LOCAL_VAR(bRead_only),
499 .label = "create mask",
502 .offset = LOCAL_VAR(iCreate_mask),
507 .label = "force create mode",
510 .offset = LOCAL_VAR(iCreate_force_mode),
515 .label = "directory mask",
518 .offset = LOCAL_VAR(iDir_mask),
523 .label = "force directory mode",
526 .offset = LOCAL_VAR(iDir_force_mode),
532 .label = "hosts allow",
535 .offset = LOCAL_VAR(szHostsallow),
540 .label = "hosts deny",
543 .offset = LOCAL_VAR(szHostsdeny),
549 .label = "log level",
552 .offset = GLOBAL_VAR(loglevel),
553 .special = handle_debuglevel,
557 .label = "debuglevel",
560 .offset = GLOBAL_VAR(loglevel),
561 .special = handle_debuglevel,
568 .offset = GLOBAL_VAR(logfile),
569 .special = handle_logfile,
574 .label = "smb ports",
577 .offset = GLOBAL_VAR(smb_ports),
585 .offset = GLOBAL_VAR(nbt_port),
590 .label = "dgram port",
593 .offset = GLOBAL_VAR(dgram_port),
598 .label = "cldap port",
601 .offset = GLOBAL_VAR(cldap_port),
606 .label = "krb5 port",
609 .offset = GLOBAL_VAR(krb5_port),
614 .label = "kpasswd port",
617 .offset = GLOBAL_VAR(kpasswd_port),
625 .offset = GLOBAL_VAR(web_port),
630 .label = "tls enabled",
633 .offset = GLOBAL_VAR(tls_enabled),
638 .label = "tls keyfile",
641 .offset = GLOBAL_VAR(tls_keyfile),
646 .label = "tls certfile",
649 .offset = GLOBAL_VAR(tls_certfile),
654 .label = "tls cafile",
657 .offset = GLOBAL_VAR(tls_cafile),
662 .label = "tls crlfile",
665 .offset = GLOBAL_VAR(tls_crlfile),
670 .label = "tls dh params file",
673 .offset = GLOBAL_VAR(tls_dhpfile),
678 .label = "large readwrite",
681 .offset = GLOBAL_VAR(bLargeReadwrite),
686 .label = "server max protocol",
689 .offset = GLOBAL_VAR(srv_maxprotocol),
691 .enum_list = enum_protocol
694 .label = "server min protocol",
697 .offset = GLOBAL_VAR(srv_minprotocol),
699 .enum_list = enum_protocol
702 .label = "client max protocol",
705 .offset = GLOBAL_VAR(cli_maxprotocol),
707 .enum_list = enum_protocol
710 .label = "client min protocol",
713 .offset = GLOBAL_VAR(cli_minprotocol),
715 .enum_list = enum_protocol
721 .offset = GLOBAL_VAR(bUnicode),
729 .offset = GLOBAL_VAR(bReadRaw),
734 .label = "write raw",
737 .offset = GLOBAL_VAR(bWriteRaw),
742 .label = "disable netbios",
745 .offset = GLOBAL_VAR(bDisableNetbios),
751 .label = "nt status support",
754 .offset = GLOBAL_VAR(bNTStatusSupport),
763 .offset = GLOBAL_VAR(max_mux),
771 .offset = GLOBAL_VAR(max_xmit),
777 .label = "name resolve order",
780 .offset = GLOBAL_VAR(szNameResolveOrder),
785 .label = "max wins ttl",
788 .offset = GLOBAL_VAR(max_wins_ttl),
793 .label = "min wins ttl",
796 .offset = GLOBAL_VAR(min_wins_ttl),
801 .label = "time server",
804 .offset = GLOBAL_VAR(bTimeServer),
809 .label = "unix extensions",
812 .offset = GLOBAL_VAR(bUnixExtensions),
817 .label = "use spnego",
820 .offset = GLOBAL_VAR(bUseSpnego),
825 .label = "server signing",
828 .offset = GLOBAL_VAR(server_signing),
830 .enum_list = enum_smb_signing_vals
833 .label = "client signing",
836 .offset = GLOBAL_VAR(client_signing),
838 .enum_list = enum_smb_signing_vals
841 .label = "rpc big endian",
844 .offset = GLOBAL_VAR(bRpcBigEndian),
850 .label = "max connections",
853 .offset = LOCAL_VAR(iMaxConnections),
858 .label = "paranoid server security",
861 .offset = GLOBAL_VAR(paranoid_server_security),
866 .label = "socket options",
869 .offset = GLOBAL_VAR(socket_options),
875 .label = "strict sync",
878 .offset = LOCAL_VAR(bStrictSync),
883 .label = "case insensitive filesystem",
886 .offset = LOCAL_VAR(bCIFileSystem),
892 .label = "max print jobs",
895 .offset = LOCAL_VAR(iMaxPrintJobs),
900 .label = "printable",
903 .offset = LOCAL_VAR(bPrint_ok),
911 .offset = LOCAL_VAR(bPrint_ok),
917 .label = "printer name",
920 .offset = LOCAL_VAR(szPrintername),
928 .offset = LOCAL_VAR(szPrintername),
934 .label = "map system",
937 .offset = LOCAL_VAR(bMap_system),
942 .label = "map hidden",
945 .offset = LOCAL_VAR(bMap_hidden),
950 .label = "map archive",
953 .offset = LOCAL_VAR(bMap_archive),
959 .label = "preferred master",
962 .offset = GLOBAL_VAR(bPreferredMaster),
964 .enum_list = enum_bool_auto
967 .label = "prefered master",
970 .offset = GLOBAL_VAR(bPreferredMaster),
972 .enum_list = enum_bool_auto
975 .label = "local master",
978 .offset = GLOBAL_VAR(bLocalMaster),
983 .label = "browseable",
986 .offset = LOCAL_VAR(bBrowseable),
991 .label = "browsable",
994 .offset = LOCAL_VAR(bBrowseable),
1000 .label = "wins server",
1002 .p_class = P_GLOBAL,
1003 .offset = GLOBAL_VAR(szWINSservers),
1008 .label = "wins support",
1010 .p_class = P_GLOBAL,
1011 .offset = GLOBAL_VAR(bWINSsupport),
1016 .label = "dns proxy",
1018 .p_class = P_GLOBAL,
1019 .offset = GLOBAL_VAR(bWINSdnsProxy),
1024 .label = "wins hook",
1026 .p_class = P_GLOBAL,
1027 .offset = GLOBAL_VAR(szWINSHook),
1033 .label = "csc policy",
1036 .offset = LOCAL_VAR(iCSCPolicy),
1038 .enum_list = enum_csc_policy
1042 .label = "strict locking",
1045 .offset = LOCAL_VAR(bStrictLocking),
1053 .offset = LOCAL_VAR(bOplocks),
1059 .label = "share backend",
1061 .p_class = P_GLOBAL,
1062 .offset = GLOBAL_VAR(szShareBackend),
1069 .p_class = P_GLOBAL,
1070 .offset = GLOBAL_VAR(szAutoServices),
1075 .label = "auto services",
1077 .p_class = P_GLOBAL,
1078 .offset = GLOBAL_VAR(szAutoServices),
1083 .label = "lock dir",
1085 .p_class = P_GLOBAL,
1086 .offset = GLOBAL_VAR(szLockDir),
1091 .label = "lock directory",
1093 .p_class = P_GLOBAL,
1094 .offset = GLOBAL_VAR(szLockDir),
1099 .label = "pid directory",
1101 .p_class = P_GLOBAL,
1102 .offset = GLOBAL_VAR(szPidDir),
1108 .label = "socket address",
1110 .p_class = P_GLOBAL,
1111 .offset = GLOBAL_VAR(szSocketAddress),
1119 .offset = LOCAL_VAR(szCopy),
1120 .special = handle_copy,
1127 .offset = LOCAL_VAR(szInclude),
1128 .special = handle_include,
1133 .label = "available",
1136 .offset = LOCAL_VAR(bAvailable),
1144 .offset = LOCAL_VAR(volume),
1152 .offset = LOCAL_VAR(fstype),
1158 .label = "panic action",
1160 .p_class = P_GLOBAL,
1161 .offset = GLOBAL_VAR(panic_action),
1167 .label = "msdfs root",
1170 .offset = LOCAL_VAR(bMSDfsRoot),
1175 .label = "host msdfs",
1177 .p_class = P_GLOBAL,
1178 .offset = GLOBAL_VAR(bHostMSDfs),
1183 .label = "winbind separator",
1185 .p_class = P_GLOBAL,
1186 .offset = GLOBAL_VAR(szWinbindSeparator),
1191 .label = "winbindd socket directory",
1193 .p_class = P_GLOBAL,
1194 .offset = GLOBAL_VAR(szWinbinddSocketDirectory),
1199 .label = "winbindd privileged socket directory",
1201 .p_class = P_GLOBAL,
1202 .offset = GLOBAL_VAR(szWinbinddPrivilegedSocketDirectory),
1207 .label = "winbind sealed pipes",
1209 .p_class = P_GLOBAL,
1210 .offset = GLOBAL_VAR(bWinbindSealedPipes),
1215 .label = "template shell",
1217 .p_class = P_GLOBAL,
1218 .offset = GLOBAL_VAR(szTemplateShell),
1223 .label = "template homedir",
1225 .p_class = P_GLOBAL,
1226 .offset = GLOBAL_VAR(szTemplateHomedir),
1231 .label = "idmap trusted only",
1233 .p_class = P_GLOBAL,
1234 .offset = GLOBAL_VAR(bIdmapTrustedOnly),
1240 .label = "ntp signd socket directory",
1242 .p_class = P_GLOBAL,
1243 .offset = GLOBAL_VAR(szNTPSignDSocketDirectory),
1248 .label = "rndc command",
1250 .p_class = P_GLOBAL,
1251 .offset = GLOBAL_VAR(szRNDCCommand),
1256 .label = "dns update command",
1258 .p_class = P_GLOBAL,
1259 .offset = GLOBAL_VAR(szDNSUpdateCommand),
1264 .label = "spn update command",
1266 .p_class = P_GLOBAL,
1267 .offset = GLOBAL_VAR(szSPNUpdateCommand),
1272 .label = "nsupdate command",
1274 .p_class = P_GLOBAL,
1275 .offset = GLOBAL_VAR(szNSUpdateCommand),
1280 {NULL, P_BOOL, P_NONE, 0, NULL, NULL, 0}
1284 /* local variables */
1285 struct loadparm_context {
1286 const char *szConfigFile;
1287 struct loadparm_global *globals;
1288 struct loadparm_service **services;
1289 struct loadparm_service *sDefault;
1290 struct smb_iconv_handle *iconv_handle;
1292 struct loadparm_service *currentService;
1293 bool bInGlobalSection;
1295 struct file_lists *next;
1300 unsigned int flags[NUMPARAMETERS];
1303 bool global; /* Is this the global context, which may set
1304 * global variables such as debug level etc? */
1305 const struct loadparm_s3_context *s3_fns;
1309 struct loadparm_service *lpcfg_default_service(struct loadparm_context *lp_ctx)
1311 return lp_ctx->sDefault;
1315 * Convenience routine to grab string parameters into temporary memory
1316 * and run standard_sub_basic on them.
1318 * The buffers can be written to by
1319 * callers without affecting the source string.
1322 static const char *lp_string(const char *s)
1324 #if 0 /* until REWRITE done to make thread-safe */
1325 size_t len = s ? strlen(s) : 0;
1329 /* The follow debug is useful for tracking down memory problems
1330 especially if you have an inner loop that is calling a lp_*()
1331 function that returns a string. Perhaps this debug should be
1332 present all the time? */
1335 DEBUG(10, ("lp_string(%s)\n", s));
1338 #if 0 /* until REWRITE done to make thread-safe */
1340 lp_talloc = talloc_init("lp_talloc");
1342 ret = talloc_array(lp_talloc, char, len + 100); /* leave room for substitution */
1350 strlcpy(ret, s, len);
1352 if (trim_string(ret, "\"", "\"")) {
1353 if (strchr(ret,'"') != NULL)
1354 strlcpy(ret, s, len);
1357 standard_sub_basic(ret,len+100);
1364 In this section all the functions that are used to access the
1365 parameters from the rest of the program are defined
1369 * the creation of separate lpcfg_*() and lp_*() functions is to allow
1370 * for code compatibility between existing Samba4 and Samba3 code.
1373 /* this global context supports the lp_*() function varients */
1374 static struct loadparm_context *global_loadparm_context;
1376 #define lpcfg_default_service global_loadparm_context->sDefault
1377 #define lpcfg_global_service(i) global_loadparm_context->services[i]
1379 #define FN_GLOBAL_STRING(fn_name,var_name) \
1380 _PUBLIC_ const char *lpcfg_ ## fn_name(struct loadparm_context *lp_ctx) { \
1381 if (lp_ctx == NULL) return NULL; \
1382 if (lp_ctx->s3_fns) { \
1383 SMB_ASSERT(lp_ctx->s3_fns->fn_name); \
1384 return lp_ctx->s3_fns->fn_name(); \
1386 return lp_ctx->globals->var_name ? lp_string(lp_ctx->globals->var_name) : ""; \
1389 #define FN_GLOBAL_CONST_STRING(fn_name,var_name) \
1390 _PUBLIC_ const char *lpcfg_ ## fn_name(struct loadparm_context *lp_ctx) {\
1391 if (lp_ctx == NULL) return NULL; \
1392 if (lp_ctx->s3_fns) { \
1393 SMB_ASSERT(lp_ctx->s3_fns->fn_name); \
1394 return lp_ctx->s3_fns->fn_name(); \
1396 return lp_ctx->globals->var_name ? lp_string(lp_ctx->globals->var_name) : ""; \
1399 #define FN_GLOBAL_LIST(fn_name,var_name) \
1400 _PUBLIC_ const char **lpcfg_ ## fn_name(struct loadparm_context *lp_ctx) { \
1401 if (lp_ctx == NULL) return NULL; \
1402 if (lp_ctx->s3_fns) { \
1403 SMB_ASSERT(lp_ctx->s3_fns->fn_name); \
1404 return lp_ctx->s3_fns->fn_name(); \
1406 return lp_ctx->globals->var_name; \
1409 #define FN_GLOBAL_BOOL(fn_name,var_name) \
1410 _PUBLIC_ bool lpcfg_ ## fn_name(struct loadparm_context *lp_ctx) {\
1411 if (lp_ctx == NULL) return false; \
1412 if (lp_ctx->s3_fns) { \
1413 SMB_ASSERT(lp_ctx->s3_fns->fn_name); \
1414 return lp_ctx->s3_fns->fn_name(); \
1416 return lp_ctx->globals->var_name; \
1419 #define FN_GLOBAL_INTEGER(fn_name,var_name) \
1420 _PUBLIC_ int lpcfg_ ## fn_name(struct loadparm_context *lp_ctx) { \
1421 if (lp_ctx->s3_fns) { \
1422 SMB_ASSERT(lp_ctx->s3_fns->fn_name); \
1423 return lp_ctx->s3_fns->fn_name(); \
1425 return lp_ctx->globals->var_name; \
1428 #define FN_LOCAL_STRING(fn_name,val) \
1429 _PUBLIC_ const char *lpcfg_ ## fn_name(struct loadparm_service *service, \
1430 struct loadparm_service *sDefault) { \
1431 return(lp_string((const char *)((service != NULL && service->val != NULL) ? service->val : sDefault->val))); \
1434 #define FN_LOCAL_LIST(fn_name,val) \
1435 _PUBLIC_ const char **lpcfg_ ## fn_name(struct loadparm_service *service, \
1436 struct loadparm_service *sDefault) {\
1437 return(const char **)(service != NULL && service->val != NULL? service->val : sDefault->val); \
1440 #define FN_LOCAL_BOOL(fn_name,val) \
1441 _PUBLIC_ bool lpcfg_ ## fn_name(struct loadparm_service *service, \
1442 struct loadparm_service *sDefault) { \
1443 return((service != NULL)? service->val : sDefault->val); \
1446 #define FN_LOCAL_INTEGER(fn_name,val) \
1447 _PUBLIC_ int lpcfg_ ## fn_name(struct loadparm_service *service, \
1448 struct loadparm_service *sDefault) { \
1449 return((service != NULL)? service->val : sDefault->val); \
1452 FN_GLOBAL_INTEGER(server_role, server_role)
1453 FN_GLOBAL_LIST(smb_ports, smb_ports)
1454 FN_GLOBAL_INTEGER(nbt_port, nbt_port)
1455 FN_GLOBAL_INTEGER(dgram_port, dgram_port)
1456 FN_GLOBAL_INTEGER(cldap_port, cldap_port)
1457 FN_GLOBAL_INTEGER(krb5_port, krb5_port)
1458 FN_GLOBAL_INTEGER(kpasswd_port, kpasswd_port)
1459 FN_GLOBAL_INTEGER(web_port, web_port)
1460 FN_GLOBAL_BOOL(tls_enabled, tls_enabled)
1461 FN_GLOBAL_STRING(logfile, logfile)
1462 FN_GLOBAL_STRING(share_backend, szShareBackend)
1463 FN_GLOBAL_STRING(spoolss_url, szSPOOLSS_URL)
1464 FN_GLOBAL_STRING(wins_config_url, szWINS_CONFIG_URL)
1465 FN_GLOBAL_STRING(wins_url, szWINS_URL)
1466 FN_GLOBAL_CONST_STRING(winbind_separator, szWinbindSeparator)
1467 FN_GLOBAL_CONST_STRING(winbindd_socket_directory, szWinbinddSocketDirectory)
1468 FN_GLOBAL_CONST_STRING(winbindd_privileged_socket_directory, szWinbinddPrivilegedSocketDirectory)
1469 FN_GLOBAL_CONST_STRING(template_shell, szTemplateShell)
1470 FN_GLOBAL_CONST_STRING(template_homedir, szTemplateHomedir)
1471 FN_GLOBAL_BOOL(winbind_sealed_pipes, bWinbindSealedPipes)
1472 FN_GLOBAL_BOOL(idmap_trusted_only, bIdmapTrustedOnly)
1473 FN_GLOBAL_STRING(private_dir, szPrivateDir)
1474 FN_GLOBAL_STRING(serverstring, szServerString)
1475 FN_GLOBAL_STRING(lockdir, szLockDir)
1476 FN_GLOBAL_STRING(ncalrpc_dir, ncalrpc_dir)
1477 FN_GLOBAL_STRING(dos_charset, dos_charset)
1478 FN_GLOBAL_STRING(unix_charset, unix_charset)
1479 FN_GLOBAL_STRING(piddir, szPidDir)
1480 FN_GLOBAL_LIST(rndc_command, szRNDCCommand)
1481 FN_GLOBAL_LIST(dns_update_command, szDNSUpdateCommand)
1482 FN_GLOBAL_LIST(spn_update_command, szSPNUpdateCommand)
1483 FN_GLOBAL_LIST(nsupdate_command, szNSUpdateCommand)
1484 FN_GLOBAL_LIST(dcerpc_endpoint_servers, dcerpc_ep_servers)
1485 FN_GLOBAL_LIST(server_services, server_services)
1486 FN_GLOBAL_STRING(ntptr_providor, ntptr_providor)
1487 FN_GLOBAL_STRING(auto_services, szAutoServices)
1488 FN_GLOBAL_STRING(passwd_chat, szPasswdChat)
1489 FN_GLOBAL_LIST(passwordserver, szPasswordServers)
1490 FN_GLOBAL_LIST(name_resolve_order, szNameResolveOrder)
1491 FN_GLOBAL_STRING(realm, szRealm_upper)
1492 FN_GLOBAL_STRING(dnsdomain, szRealm_lower)
1493 FN_GLOBAL_STRING(socket_options, socket_options)
1494 FN_GLOBAL_STRING(workgroup, szWorkgroup)
1495 FN_GLOBAL_STRING(netbios_name, szNetbiosName)
1496 FN_GLOBAL_STRING(netbios_scope, szNetbiosScope)
1497 FN_GLOBAL_LIST(wins_server_list, szWINSservers)
1498 FN_GLOBAL_LIST(interfaces, szInterfaces)
1499 FN_GLOBAL_STRING(socket_address, szSocketAddress)
1500 FN_GLOBAL_LIST(netbios_aliases, szNetbiosAliases)
1501 FN_GLOBAL_BOOL(disable_netbios, bDisableNetbios)
1502 FN_GLOBAL_BOOL(we_are_a_wins_server, bWINSsupport)
1503 FN_GLOBAL_BOOL(wins_dns_proxy, bWINSdnsProxy)
1504 FN_GLOBAL_STRING(wins_hook, szWINSHook)
1505 FN_GLOBAL_BOOL(local_master, bLocalMaster)
1506 FN_GLOBAL_BOOL(readraw, bReadRaw)
1507 FN_GLOBAL_BOOL(large_readwrite, bLargeReadwrite)
1508 FN_GLOBAL_BOOL(writeraw, bWriteRaw)
1509 FN_GLOBAL_BOOL(null_passwords, bNullPasswords)
1510 FN_GLOBAL_BOOL(obey_pam_restrictions, bObeyPamRestrictions)
1511 FN_GLOBAL_BOOL(encrypted_passwords, bEncryptPasswords)
1512 FN_GLOBAL_BOOL(time_server, bTimeServer)
1513 FN_GLOBAL_BOOL(bind_interfaces_only, bBindInterfacesOnly)
1514 FN_GLOBAL_BOOL(unicode, bUnicode)
1515 FN_GLOBAL_BOOL(nt_status_support, bNTStatusSupport)
1516 FN_GLOBAL_BOOL(lanman_auth, bLanmanAuth)
1517 FN_GLOBAL_BOOL(ntlm_auth, bNTLMAuth)
1518 FN_GLOBAL_BOOL(client_plaintext_auth, bClientPlaintextAuth)
1519 FN_GLOBAL_BOOL(client_lanman_auth, bClientLanManAuth)
1520 FN_GLOBAL_BOOL(client_ntlmv2_auth, bClientNTLMv2Auth)
1521 FN_GLOBAL_BOOL(client_use_spnego_principal, client_use_spnego_principal)
1522 FN_GLOBAL_BOOL(host_msdfs, bHostMSDfs)
1523 FN_GLOBAL_BOOL(unix_extensions, bUnixExtensions)
1524 FN_GLOBAL_BOOL(use_spnego, bUseSpnego)
1525 FN_GLOBAL_BOOL(rpc_big_endian, bRpcBigEndian)
1526 FN_GLOBAL_INTEGER(max_wins_ttl, max_wins_ttl)
1527 FN_GLOBAL_INTEGER(min_wins_ttl, min_wins_ttl)
1528 FN_GLOBAL_INTEGER(maxmux, max_mux)
1529 FN_GLOBAL_INTEGER(max_xmit, max_xmit)
1530 FN_GLOBAL_INTEGER(passwordlevel, pwordlevel)
1531 FN_GLOBAL_INTEGER(srv_maxprotocol, srv_maxprotocol)
1532 FN_GLOBAL_INTEGER(srv_minprotocol, srv_minprotocol)
1533 FN_GLOBAL_INTEGER(cli_maxprotocol, cli_maxprotocol)
1534 FN_GLOBAL_INTEGER(cli_minprotocol, cli_minprotocol)
1535 FN_GLOBAL_INTEGER(security, security)
1536 FN_GLOBAL_BOOL(paranoid_server_security, paranoid_server_security)
1538 FN_LOCAL_STRING(pathname, szPath)
1539 FN_LOCAL_LIST(hostsallow, szHostsallow)
1540 FN_LOCAL_LIST(hostsdeny, szHostsdeny)
1541 FN_LOCAL_STRING(comment, comment)
1542 FN_LOCAL_STRING(fstype, fstype)
1543 FN_LOCAL_LIST(ntvfs_handler, ntvfs_handler)
1544 FN_LOCAL_BOOL(msdfs_root, bMSDfsRoot)
1545 FN_LOCAL_BOOL(browseable, bBrowseable)
1546 FN_LOCAL_BOOL(readonly, bRead_only)
1547 FN_LOCAL_BOOL(print_ok, bPrint_ok)
1548 FN_LOCAL_BOOL(map_hidden, bMap_hidden)
1549 FN_LOCAL_BOOL(map_archive, bMap_archive)
1550 FN_LOCAL_BOOL(strict_locking, bStrictLocking)
1551 FN_LOCAL_BOOL(oplocks, bOplocks)
1552 FN_LOCAL_BOOL(strict_sync, bStrictSync)
1553 FN_LOCAL_BOOL(ci_filesystem, bCIFileSystem)
1554 FN_LOCAL_BOOL(map_system, bMap_system)
1555 FN_LOCAL_INTEGER(max_connections, iMaxConnections)
1556 FN_LOCAL_INTEGER(csc_policy, iCSCPolicy)
1557 FN_LOCAL_INTEGER(create_mask, iCreate_mask)
1558 FN_LOCAL_INTEGER(force_create_mode, iCreate_force_mode)
1559 FN_LOCAL_INTEGER(dir_mask, iDir_mask)
1560 FN_LOCAL_INTEGER(force_dir_mode, iDir_force_mode)
1561 FN_GLOBAL_INTEGER(server_signing, server_signing)
1562 FN_GLOBAL_INTEGER(client_signing, client_signing)
1564 FN_GLOBAL_CONST_STRING(ntp_signd_socket_directory, szNTPSignDSocketDirectory)
1566 /* local prototypes */
1567 static int map_parameter(const char *pszParmName);
1568 static struct loadparm_service *getservicebyname(struct loadparm_context *lp_ctx,
1569 const char *pszServiceName);
1570 static void copy_service(struct loadparm_service *pserviceDest,
1571 struct loadparm_service *pserviceSource,
1573 static bool service_ok(struct loadparm_service *service);
1574 static bool do_section(const char *pszSectionName, void *);
1575 static void init_copymap(struct loadparm_service *pservice);
1577 /* This is a helper function for parametrical options support. */
1578 /* It returns a pointer to parametrical option value if it exists or NULL otherwise */
1579 /* Actual parametrical functions are quite simple */
1580 const char *lpcfg_get_parametric(struct loadparm_context *lp_ctx,
1581 struct loadparm_service *service,
1582 const char *type, const char *option)
1584 char *vfskey_tmp = NULL;
1585 char *vfskey = NULL;
1586 struct parmlist_entry *data;
1591 if (lp_ctx->s3_fns) {
1592 return lp_ctx->s3_fns->get_parametric(service, type, option);
1595 data = (service == NULL ? lp_ctx->globals->param_opt : service->param_opt);
1597 vfskey_tmp = talloc_asprintf(NULL, "%s:%s", type, option);
1598 if (vfskey_tmp == NULL) return NULL;
1599 vfskey = strlower_talloc(NULL, vfskey_tmp);
1600 talloc_free(vfskey_tmp);
1603 if (strcmp(data->key, vfskey) == 0) {
1604 talloc_free(vfskey);
1610 if (service != NULL) {
1611 /* Try to fetch the same option but from globals */
1612 /* but only if we are not already working with globals */
1613 for (data = lp_ctx->globals->param_opt; data;
1614 data = data->next) {
1615 if (strcmp(data->key, vfskey) == 0) {
1616 talloc_free(vfskey);
1622 talloc_free(vfskey);
1629 * convenience routine to return int parameters.
1631 static int lp_int(const char *s)
1635 DEBUG(0,("lp_int(%s): is called with NULL!\n",s));
1639 return strtol(s, NULL, 0);
1643 * convenience routine to return unsigned long parameters.
1645 static int lp_ulong(const char *s)
1649 DEBUG(0,("lp_int(%s): is called with NULL!\n",s));
1653 return strtoul(s, NULL, 0);
1657 * convenience routine to return unsigned long parameters.
1659 static double lp_double(const char *s)
1663 DEBUG(0,("lp_double(%s): is called with NULL!\n",s));
1667 return strtod(s, NULL);
1671 * convenience routine to return boolean parameters.
1673 static bool lp_bool(const char *s)
1678 DEBUG(0,("lp_bool(%s): is called with NULL!\n",s));
1682 if (!set_boolean(s, &ret)) {
1683 DEBUG(0,("lp_bool(%s): value is not boolean!\n",s));
1692 * Return parametric option from a given service. Type is a part of option before ':'
1693 * Parametric option has following syntax: 'Type: option = value'
1694 * Returned value is allocated in 'lp_talloc' context
1697 const char *lpcfg_parm_string(struct loadparm_context *lp_ctx,
1698 struct loadparm_service *service, const char *type,
1701 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1704 return lp_string(value);
1710 * Return parametric option from a given service. Type is a part of option before ':'
1711 * Parametric option has following syntax: 'Type: option = value'
1712 * Returned value is allocated in 'lp_talloc' context
1715 const char **lpcfg_parm_string_list(TALLOC_CTX *mem_ctx,
1716 struct loadparm_context *lp_ctx,
1717 struct loadparm_service *service,
1719 const char *option, const char *separator)
1721 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1724 return (const char **)str_list_make(mem_ctx, value, separator);
1730 * Return parametric option from a given service. Type is a part of option before ':'
1731 * Parametric option has following syntax: 'Type: option = value'
1734 int lpcfg_parm_int(struct loadparm_context *lp_ctx,
1735 struct loadparm_service *service, const char *type,
1736 const char *option, int default_v)
1738 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1741 return lp_int(value);
1747 * Return parametric option from a given service. Type is a part of
1748 * option before ':'.
1749 * Parametric option has following syntax: 'Type: option = value'.
1752 int lpcfg_parm_bytes(struct loadparm_context *lp_ctx,
1753 struct loadparm_service *service, const char *type,
1754 const char *option, int default_v)
1758 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1760 if (value && conv_str_size_error(value, &bval)) {
1761 if (bval <= INT_MAX) {
1770 * Return parametric option from a given service.
1771 * Type is a part of option before ':'
1772 * Parametric option has following syntax: 'Type: option = value'
1774 unsigned long lpcfg_parm_ulong(struct loadparm_context *lp_ctx,
1775 struct loadparm_service *service, const char *type,
1776 const char *option, unsigned long default_v)
1778 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1781 return lp_ulong(value);
1787 double lpcfg_parm_double(struct loadparm_context *lp_ctx,
1788 struct loadparm_service *service, const char *type,
1789 const char *option, double default_v)
1791 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1794 return lp_double(value);
1800 * Return parametric option from a given service. Type is a part of option before ':'
1801 * Parametric option has following syntax: 'Type: option = value'
1804 bool lpcfg_parm_bool(struct loadparm_context *lp_ctx,
1805 struct loadparm_service *service, const char *type,
1806 const char *option, bool default_v)
1808 const char *value = lpcfg_get_parametric(lp_ctx, service, type, option);
1811 return lp_bool(value);
1818 * Initialise a service to the defaults.
1821 static struct loadparm_service *init_service(TALLOC_CTX *mem_ctx, struct loadparm_service *sDefault)
1823 struct loadparm_service *pservice =
1824 talloc_zero(mem_ctx, struct loadparm_service);
1825 copy_service(pservice, sDefault, NULL);
1830 * Set a string value, deallocating any existing space, and allocing the space
1833 static bool string_set(TALLOC_CTX *mem_ctx, char **dest, const char *src)
1840 *dest = talloc_strdup(mem_ctx, src);
1841 if ((*dest) == NULL) {
1842 DEBUG(0,("Out of memory in string_set\n"));
1850 * Set a string value, deallocating any existing space, and allocing the space
1853 static bool string_set_upper(TALLOC_CTX *mem_ctx, char **dest, const char *src)
1860 *dest = strupper_talloc(mem_ctx, src);
1861 if ((*dest) == NULL) {
1862 DEBUG(0,("Out of memory in string_set_upper\n"));
1872 * Add a new service to the services array initialising it with the given
1876 struct loadparm_service *lpcfg_add_service(struct loadparm_context *lp_ctx,
1877 const struct loadparm_service *pservice,
1881 struct loadparm_service tservice;
1882 int num_to_alloc = lp_ctx->iNumServices + 1;
1883 struct parmlist_entry *data, *pdata;
1885 if (pservice == NULL) {
1886 pservice = lp_ctx->sDefault;
1889 tservice = *pservice;
1891 /* it might already exist */
1893 struct loadparm_service *service = getservicebyname(lp_ctx,
1895 if (service != NULL) {
1896 /* Clean all parametric options for service */
1897 /* They will be added during parsing again */
1898 data = service->param_opt;
1904 service->param_opt = NULL;
1909 /* find an invalid one */
1910 for (i = 0; i < lp_ctx->iNumServices; i++)
1911 if (lp_ctx->services[i] == NULL)
1914 /* if not, then create one */
1915 if (i == lp_ctx->iNumServices) {
1916 struct loadparm_service **tsp;
1918 tsp = talloc_realloc(lp_ctx, lp_ctx->services, struct loadparm_service *, num_to_alloc);
1921 DEBUG(0,("lpcfg_add_service: failed to enlarge services!\n"));
1924 lp_ctx->services = tsp;
1925 lp_ctx->services[lp_ctx->iNumServices] = NULL;
1928 lp_ctx->iNumServices++;
1931 lp_ctx->services[i] = init_service(lp_ctx->services, lp_ctx->sDefault);
1932 if (lp_ctx->services[i] == NULL) {
1933 DEBUG(0,("lpcfg_add_service: out of memory!\n"));
1936 copy_service(lp_ctx->services[i], &tservice, NULL);
1938 string_set(lp_ctx->services[i], &lp_ctx->services[i]->szService, name);
1939 return lp_ctx->services[i];
1943 * Add a new home service, with the specified home directory, defaults coming
1944 * from service ifrom.
1947 bool lpcfg_add_home(struct loadparm_context *lp_ctx,
1948 const char *pszHomename,
1949 struct loadparm_service *default_service,
1950 const char *user, const char *pszHomedir)
1952 struct loadparm_service *service;
1954 service = lpcfg_add_service(lp_ctx, default_service, pszHomename);
1956 if (service == NULL)
1959 if (!(*(default_service->szPath))
1960 || strequal(default_service->szPath, lp_ctx->sDefault->szPath)) {
1961 service->szPath = talloc_strdup(service, pszHomedir);
1963 service->szPath = string_sub_talloc(service, lpcfg_pathname(default_service, lp_ctx->sDefault), "%H", pszHomedir);
1966 if (!(*(service->comment))) {
1967 service->comment = talloc_asprintf(service, "Home directory of %s", user);
1969 service->bAvailable = default_service->bAvailable;
1970 service->bBrowseable = default_service->bBrowseable;
1972 DEBUG(3, ("adding home's share [%s] for user '%s' at '%s'\n",
1973 pszHomename, user, service->szPath));
1979 * Add a new printer service, with defaults coming from service iFrom.
1982 bool lpcfg_add_printer(struct loadparm_context *lp_ctx,
1983 const char *pszPrintername,
1984 struct loadparm_service *default_service)
1986 const char *comment = "From Printcap";
1987 struct loadparm_service *service;
1988 service = lpcfg_add_service(lp_ctx, default_service, pszPrintername);
1990 if (service == NULL)
1993 /* note that we do NOT default the availability flag to True - */
1994 /* we take it from the default service passed. This allows all */
1995 /* dynamic printers to be disabled by disabling the [printers] */
1996 /* entry (if/when the 'available' keyword is implemented!). */
1998 /* the printer name is set to the service name. */
1999 string_set(service, &service->szPrintername, pszPrintername);
2000 string_set(service, &service->comment, comment);
2001 service->bBrowseable = default_service->bBrowseable;
2002 /* Printers cannot be read_only. */
2003 service->bRead_only = false;
2004 /* Printer services must be printable. */
2005 service->bPrint_ok = true;
2007 DEBUG(3, ("adding printer service %s\n", pszPrintername));
2013 * Map a parameter's string representation to something we can use.
2014 * Returns False if the parameter string is not recognised, else TRUE.
2017 static int map_parameter(const char *pszParmName)
2021 if (*pszParmName == '-')
2024 for (iIndex = 0; parm_table[iIndex].label; iIndex++)
2025 if (strwicmp(parm_table[iIndex].label, pszParmName) == 0)
2028 /* Warn only if it isn't parametric option */
2029 if (strchr(pszParmName, ':') == NULL)
2030 DEBUG(0, ("Unknown parameter encountered: \"%s\"\n", pszParmName));
2031 /* We do return 'fail' for parametric options as well because they are
2032 stored in different storage
2039 return the parameter structure for a parameter
2041 struct parm_struct *lpcfg_parm_struct(struct loadparm_context *lp_ctx, const char *name)
2045 if (lp_ctx->s3_fns) {
2046 return lp_ctx->s3_fns->get_parm_struct(name);
2049 parmnum = map_parameter(name);
2050 if (parmnum == -1) return NULL;
2051 return &parm_table[parmnum];
2055 return the parameter pointer for a parameter
2057 void *lpcfg_parm_ptr(struct loadparm_context *lp_ctx,
2058 struct loadparm_service *service, struct parm_struct *parm)
2060 if (lp_ctx->s3_fns) {
2061 return lp_ctx->s3_fns->get_parm_ptr(service, parm);
2064 if (service == NULL) {
2065 if (parm->p_class == P_LOCAL)
2066 return ((char *)lp_ctx->sDefault)+parm->offset;
2067 else if (parm->p_class == P_GLOBAL)
2068 return ((char *)lp_ctx->globals)+parm->offset;
2071 return ((char *)service) + parm->offset;
2076 * Find a service by name. Otherwise works like get_service.
2079 static struct loadparm_service *getservicebyname(struct loadparm_context *lp_ctx,
2080 const char *pszServiceName)
2084 for (iService = lp_ctx->iNumServices - 1; iService >= 0; iService--)
2085 if (lp_ctx->services[iService] != NULL &&
2086 strwicmp(lp_ctx->services[iService]->szService, pszServiceName) == 0) {
2087 return lp_ctx->services[iService];
2094 * Copy a service structure to another.
2095 * If pcopymapDest is NULL then copy all fields
2098 static void copy_service(struct loadparm_service *pserviceDest,
2099 struct loadparm_service *pserviceSource,
2103 bool bcopyall = (pcopymapDest == NULL);
2104 struct parmlist_entry *data, *pdata, *paramo;
2107 for (i = 0; parm_table[i].label; i++)
2108 if (parm_table[i].offset != -1 && parm_table[i].p_class == P_LOCAL &&
2109 (bcopyall || pcopymapDest[i])) {
2111 ((char *)pserviceSource) + parm_table[i].offset;
2113 ((char *)pserviceDest) + parm_table[i].offset;
2115 switch (parm_table[i].type) {
2117 *(int *)dest_ptr = *(int *)src_ptr;
2123 *(int *)dest_ptr = *(int *)src_ptr;
2127 string_set(pserviceDest,
2133 string_set_upper(pserviceDest,
2138 *(const char ***)dest_ptr = (const char **)str_list_copy(pserviceDest,
2139 *(const char ***)src_ptr);
2147 init_copymap(pserviceDest);
2148 if (pserviceSource->copymap)
2149 memcpy((void *)pserviceDest->copymap,
2150 (void *)pserviceSource->copymap,
2151 sizeof(int) * NUMPARAMETERS);
2154 data = pserviceSource->param_opt;
2157 pdata = pserviceDest->param_opt;
2158 /* Traverse destination */
2160 /* If we already have same option, override it */
2161 if (strcmp(pdata->key, data->key) == 0) {
2162 talloc_free(pdata->value);
2163 pdata->value = talloc_reference(pdata,
2168 pdata = pdata->next;
2171 paramo = talloc_zero(pserviceDest, struct parmlist_entry);
2174 paramo->key = talloc_reference(paramo, data->key);
2175 paramo->value = talloc_reference(paramo, data->value);
2176 DLIST_ADD(pserviceDest->param_opt, paramo);
2183 * Check a service for consistency. Return False if the service is in any way
2184 * incomplete or faulty, else True.
2186 static bool service_ok(struct loadparm_service *service)
2191 if (service->szService[0] == '\0') {
2192 DEBUG(0, ("The following message indicates an internal error:\n"));
2193 DEBUG(0, ("No service name in service entry.\n"));
2197 /* The [printers] entry MUST be printable. I'm all for flexibility, but */
2198 /* I can't see why you'd want a non-printable printer service... */
2199 if (strwicmp(service->szService, PRINTERS_NAME) == 0) {
2200 if (!service->bPrint_ok) {
2201 DEBUG(0, ("WARNING: [%s] service MUST be printable!\n",
2202 service->szService));
2203 service->bPrint_ok = true;
2205 /* [printers] service must also be non-browsable. */
2206 if (service->bBrowseable)
2207 service->bBrowseable = false;
2210 /* If a service is flagged unavailable, log the fact at level 0. */
2211 if (!service->bAvailable)
2212 DEBUG(1, ("NOTE: Service %s is flagged unavailable.\n",
2213 service->szService));
2219 /*******************************************************************
2220 Keep a linked list of all config files so we know when one has changed
2221 it's date and needs to be reloaded.
2222 ********************************************************************/
2224 static void add_to_file_list(struct loadparm_context *lp_ctx,
2225 const char *fname, const char *subfname)
2227 struct file_lists *f = lp_ctx->file_lists;
2230 if (f->name && !strcmp(f->name, fname))
2236 f = talloc(lp_ctx, struct file_lists);
2239 f->next = lp_ctx->file_lists;
2240 f->name = talloc_strdup(f, fname);
2245 f->subfname = talloc_strdup(f, subfname);
2250 lp_ctx->file_lists = f;
2251 f->modtime = file_modtime(subfname);
2253 time_t t = file_modtime(subfname);
2259 /*******************************************************************
2260 Check if a config file has changed date.
2261 ********************************************************************/
2262 bool lpcfg_file_list_changed(struct loadparm_context *lp_ctx)
2264 struct file_lists *f;
2265 DEBUG(6, ("lp_file_list_changed()\n"));
2267 for (f = lp_ctx->file_lists; f != NULL; f = f->next) {
2271 n2 = standard_sub_basic(lp_ctx, f->name);
2273 DEBUGADD(6, ("file %s -> %s last mod_time: %s\n",
2274 f->name, n2, ctime(&f->modtime)));
2276 mod_time = file_modtime(n2);
2278 if (mod_time && ((f->modtime != mod_time) || (f->subfname == NULL) || (strcmp(n2, f->subfname) != 0))) {
2279 DEBUGADD(6, ("file %s modified: %s\n", n2,
2281 f->modtime = mod_time;
2282 talloc_free(f->subfname);
2283 f->subfname = talloc_strdup(f, n2);
2290 /***************************************************************************
2291 Handle the "realm" parameter
2292 ***************************************************************************/
2294 static bool handle_realm(struct loadparm_context *lp_ctx, int unused,
2295 const char *pszParmValue, char **ptr)
2297 string_set(lp_ctx, ptr, pszParmValue);
2299 talloc_free(lp_ctx->globals->szRealm_upper);
2300 talloc_free(lp_ctx->globals->szRealm_lower);
2302 lp_ctx->globals->szRealm_upper = strupper_talloc(lp_ctx, pszParmValue);
2303 lp_ctx->globals->szRealm_lower = strlower_talloc(lp_ctx, pszParmValue);
2308 /***************************************************************************
2309 Handle the include operation.
2310 ***************************************************************************/
2312 static bool handle_include(struct loadparm_context *lp_ctx, int unused,
2313 const char *pszParmValue, char **ptr)
2315 char *fname = standard_sub_basic(lp_ctx, pszParmValue);
2317 add_to_file_list(lp_ctx, pszParmValue, fname);
2319 string_set(lp_ctx, ptr, fname);
2321 if (file_exist(fname))
2322 return pm_process(fname, do_section, do_parameter, lp_ctx);
2324 DEBUG(2, ("Can't find include file %s\n", fname));
2329 /***************************************************************************
2330 Handle the interpretation of the copy parameter.
2331 ***************************************************************************/
2333 static bool handle_copy(struct loadparm_context *lp_ctx, int unused,
2334 const char *pszParmValue, char **ptr)
2337 struct loadparm_service *serviceTemp;
2339 string_set(lp_ctx, ptr, pszParmValue);
2343 DEBUG(3, ("Copying service from service %s\n", pszParmValue));
2345 if ((serviceTemp = getservicebyname(lp_ctx, pszParmValue)) != NULL) {
2346 if (serviceTemp == lp_ctx->currentService) {
2347 DEBUG(0, ("Can't copy service %s - unable to copy self!\n", pszParmValue));
2349 copy_service(lp_ctx->currentService,
2351 lp_ctx->currentService->copymap);
2355 DEBUG(0, ("Unable to copy service - source not found: %s\n",
2363 static bool handle_debuglevel(struct loadparm_context *lp_ctx, int unused,
2364 const char *pszParmValue, char **ptr)
2367 string_set(lp_ctx, ptr, pszParmValue);
2368 if (lp_ctx->global) {
2369 return debug_parse_levels(pszParmValue);
2374 static bool handle_logfile(struct loadparm_context *lp_ctx, int unused,
2375 const char *pszParmValue, char **ptr)
2377 debug_set_logfile(pszParmValue);
2378 if (lp_ctx->global) {
2379 string_set(lp_ctx, ptr, pszParmValue);
2384 /***************************************************************************
2385 Initialise a copymap.
2386 ***************************************************************************/
2388 static void init_copymap(struct loadparm_service *pservice)
2391 talloc_free(pservice->copymap);
2392 pservice->copymap = talloc_array(pservice, int, NUMPARAMETERS);
2393 if (pservice->copymap == NULL) {
2395 ("Couldn't allocate copymap!! (size %d)\n",
2396 (int)NUMPARAMETERS));
2399 for (i = 0; i < NUMPARAMETERS; i++)
2400 pservice->copymap[i] = true;
2404 * Process a parametric option
2406 static bool lp_do_parameter_parametric(struct loadparm_context *lp_ctx,
2407 struct loadparm_service *service,
2408 const char *pszParmName,
2409 const char *pszParmValue, int flags)
2411 struct parmlist_entry *paramo, *data;
2413 TALLOC_CTX *mem_ctx;
2415 while (isspace((unsigned char)*pszParmName)) {
2419 name = strlower_talloc(lp_ctx, pszParmName);
2420 if (!name) return false;
2422 if (service == NULL) {
2423 data = lp_ctx->globals->param_opt;
2424 mem_ctx = lp_ctx->globals;
2426 data = service->param_opt;
2430 /* Traverse destination */
2431 for (paramo=data; paramo; paramo=paramo->next) {
2432 /* If we already have the option set, override it unless
2433 it was a command line option and the new one isn't */
2434 if (strcmp(paramo->key, name) == 0) {
2435 if ((paramo->priority & FLAG_CMDLINE) &&
2436 !(flags & FLAG_CMDLINE)) {
2441 talloc_free(paramo->value);
2442 paramo->value = talloc_strdup(paramo, pszParmValue);
2443 paramo->priority = flags;
2449 paramo = talloc_zero(mem_ctx, struct parmlist_entry);
2452 paramo->key = talloc_strdup(paramo, name);
2453 paramo->value = talloc_strdup(paramo, pszParmValue);
2454 paramo->priority = flags;
2455 if (service == NULL) {
2456 DLIST_ADD(lp_ctx->globals->param_opt, paramo);
2458 DLIST_ADD(service->param_opt, paramo);
2466 static bool set_variable(TALLOC_CTX *mem_ctx, int parmnum, void *parm_ptr,
2467 const char *pszParmName, const char *pszParmValue,
2468 struct loadparm_context *lp_ctx, bool on_globals)
2471 /* if it is a special case then go ahead */
2472 if (parm_table[parmnum].special) {
2474 ret = parm_table[parmnum].special(lp_ctx, -1, pszParmValue,
2479 goto mark_non_default;
2482 /* now switch on the type of variable it is */
2483 switch (parm_table[parmnum].type)
2487 if (!set_boolean(pszParmValue, &b)) {
2488 DEBUG(0,("lp_do_parameter(%s): value is not boolean!\n", pszParmValue));
2491 *(int *)parm_ptr = b;
2497 if (!set_boolean(pszParmValue, &b)) {
2498 DEBUG(0,("lp_do_parameter(%s): value is not boolean!\n", pszParmValue));
2501 *(int *)parm_ptr = !b;
2506 *(int *)parm_ptr = atoi(pszParmValue);
2510 *(int *)parm_ptr = strtol(pszParmValue, NULL, 8);
2516 if (conv_str_size_error(pszParmValue, &val)) {
2517 if (val <= INT_MAX) {
2518 *(int *)parm_ptr = (int)val;
2523 DEBUG(0,("lp_do_parameter(%s): value is not "
2524 "a valid size specifier!\n", pszParmValue));
2529 *(const char ***)parm_ptr = (const char **)str_list_make(mem_ctx,
2530 pszParmValue, NULL);
2534 char **new_list = str_list_make(mem_ctx,
2535 pszParmValue, NULL);
2536 for (i=0; new_list[i]; i++) {
2537 if (new_list[i][0] == '+' && new_list[i][1] &&
2538 (!str_list_check(*(const char ***)parm_ptr,
2539 &new_list[i][1]))) {
2540 *(const char ***)parm_ptr = str_list_add(*(const char ***)parm_ptr,
2542 } else if (new_list[i][0] == '-' && new_list[i][1]) {
2543 #if 0 /* This is commented out because we sometimes parse the list
2544 * twice, and so we can't assert on this */
2545 if (!str_list_check(*(const char ***)parm_ptr,
2547 DEBUG(0, ("Unsupported value for: %s = %s, %s is not in the original list [%s]\n",
2548 pszParmName, pszParmValue, new_list[i],
2549 str_list_join_shell(mem_ctx, *(const char ***)parm_ptr, ' ')));
2554 str_list_remove(*(const char ***)parm_ptr,
2558 DEBUG(0, ("Unsupported list syntax for: %s = %s\n",
2559 pszParmName, pszParmValue));
2562 *(const char ***)parm_ptr = (const char **) new_list;
2569 string_set(mem_ctx, (char **)parm_ptr, pszParmValue);
2573 string_set_upper(mem_ctx, (char **)parm_ptr, pszParmValue);
2577 for (i = 0; parm_table[parmnum].enum_list[i].name; i++) {
2580 parm_table[parmnum].enum_list[i].name)) {
2582 parm_table[parmnum].
2587 if (!parm_table[parmnum].enum_list[i].name) {
2588 DEBUG(0,("Unknown enumerated value '%s' for '%s'\n",
2589 pszParmValue, pszParmName));
2596 if (on_globals && (lp_ctx->flags[parmnum] & FLAG_DEFAULT)) {
2597 lp_ctx->flags[parmnum] &= ~FLAG_DEFAULT;
2598 /* we have to also unset FLAG_DEFAULT on aliases */
2599 for (i=parmnum-1;i>=0 && parm_table[i].offset == parm_table[parmnum].offset;i--) {
2600 lp_ctx->flags[i] &= ~FLAG_DEFAULT;
2602 for (i=parmnum+1;i<NUMPARAMETERS && parm_table[i].offset == parm_table[parmnum].offset;i++) {
2603 lp_ctx->flags[i] &= ~FLAG_DEFAULT;
2610 bool lpcfg_do_global_parameter(struct loadparm_context *lp_ctx,
2611 const char *pszParmName, const char *pszParmValue)
2613 int parmnum = map_parameter(pszParmName);
2617 if (strchr(pszParmName, ':')) {
2618 return lp_do_parameter_parametric(lp_ctx, NULL, pszParmName, pszParmValue, 0);
2620 DEBUG(0, ("Ignoring unknown parameter \"%s\"\n", pszParmName));
2624 /* if the flag has been set on the command line, then don't allow override,
2625 but don't report an error */
2626 if (lp_ctx->flags[parmnum] & FLAG_CMDLINE) {
2630 parm_ptr = lpcfg_parm_ptr(lp_ctx, NULL, &parm_table[parmnum]);
2632 return set_variable(lp_ctx->globals, parmnum, parm_ptr,
2633 pszParmName, pszParmValue, lp_ctx, true);
2636 bool lpcfg_do_service_parameter(struct loadparm_context *lp_ctx,
2637 struct loadparm_service *service,
2638 const char *pszParmName, const char *pszParmValue)
2642 int parmnum = map_parameter(pszParmName);
2645 if (strchr(pszParmName, ':')) {
2646 return lp_do_parameter_parametric(lp_ctx, service, pszParmName, pszParmValue, 0);
2648 DEBUG(0, ("Ignoring unknown parameter \"%s\"\n", pszParmName));
2652 /* if the flag has been set on the command line, then don't allow override,
2653 but don't report an error */
2654 if (lp_ctx->flags[parmnum] & FLAG_CMDLINE) {
2658 if (parm_table[parmnum].p_class == P_GLOBAL) {
2660 ("Global parameter %s found in service section!\n",
2664 parm_ptr = ((char *)service) + parm_table[parmnum].offset;
2666 if (!service->copymap)
2667 init_copymap(service);
2669 /* this handles the aliases - set the copymap for other
2670 * entries with the same data pointer */
2671 for (i = 0; parm_table[i].label; i++)
2672 if (parm_table[i].offset == parm_table[parmnum].offset &&
2673 parm_table[i].p_class == parm_table[parmnum].p_class)
2674 service->copymap[i] = false;
2676 return set_variable(service, parmnum, parm_ptr, pszParmName,
2677 pszParmValue, lp_ctx, false);
2681 * Process a parameter.
2684 static bool do_parameter(const char *pszParmName, const char *pszParmValue,
2687 struct loadparm_context *lp_ctx = (struct loadparm_context *)userdata;
2689 if (lp_ctx->bInGlobalSection)
2690 return lpcfg_do_global_parameter(lp_ctx, pszParmName,
2693 return lpcfg_do_service_parameter(lp_ctx, lp_ctx->currentService,
2694 pszParmName, pszParmValue);
2698 variable argument do parameter
2700 bool lpcfg_do_global_parameter_var(struct loadparm_context *lp_ctx, const char *pszParmName, const char *fmt, ...) PRINTF_ATTRIBUTE(3, 4);
2701 bool lpcfg_do_global_parameter_var(struct loadparm_context *lp_ctx,
2702 const char *pszParmName, const char *fmt, ...)
2709 s = talloc_vasprintf(NULL, fmt, ap);
2711 ret = lpcfg_do_global_parameter(lp_ctx, pszParmName, s);
2718 set a parameter from the commandline - this is called from command line parameter
2719 parsing code. It sets the parameter then marks the parameter as unable to be modified
2720 by smb.conf processing
2722 bool lpcfg_set_cmdline(struct loadparm_context *lp_ctx, const char *pszParmName,
2723 const char *pszParmValue)
2725 int parmnum = map_parameter(pszParmName);
2728 while (isspace((unsigned char)*pszParmValue)) pszParmValue++;
2731 if (parmnum < 0 && strchr(pszParmName, ':')) {
2732 /* set a parametric option */
2733 return lp_do_parameter_parametric(lp_ctx, NULL, pszParmName,
2734 pszParmValue, FLAG_CMDLINE);
2738 DEBUG(0,("Unknown option '%s'\n", pszParmName));
2742 /* reset the CMDLINE flag in case this has been called before */
2743 lp_ctx->flags[parmnum] &= ~FLAG_CMDLINE;
2745 if (!lpcfg_do_global_parameter(lp_ctx, pszParmName, pszParmValue)) {
2749 lp_ctx->flags[parmnum] |= FLAG_CMDLINE;
2751 /* we have to also set FLAG_CMDLINE on aliases */
2752 for (i=parmnum-1;i>=0 && parm_table[i].offset == parm_table[parmnum].offset;i--) {
2753 lp_ctx->flags[i] |= FLAG_CMDLINE;
2755 for (i=parmnum+1;i<NUMPARAMETERS && parm_table[i].offset == parm_table[parmnum].offset;i++) {
2756 lp_ctx->flags[i] |= FLAG_CMDLINE;
2763 set a option from the commandline in 'a=b' format. Use to support --option
2765 bool lpcfg_set_option(struct loadparm_context *lp_ctx, const char *option)
2783 ret = lpcfg_set_cmdline(lp_ctx, s, p+1);
2789 #define BOOLSTR(b) ((b) ? "Yes" : "No")
2792 * Print a parameter of the specified type.
2795 static void print_parameter(struct parm_struct *p, void *ptr, FILE * f)
2798 const char *list_sep = ", "; /* For the seperation of lists values that we print below */
2802 for (i = 0; p->enum_list[i].name; i++) {
2803 if (*(int *)ptr == p->enum_list[i].value) {
2805 p->enum_list[i].name);
2812 fprintf(f, "%s", BOOLSTR((bool)*(int *)ptr));
2816 fprintf(f, "%s", BOOLSTR(!(bool)*(int *)ptr));
2821 fprintf(f, "%d", *(int *)ptr);
2825 fprintf(f, "0%o", *(int *)ptr);
2832 if ((char ***)ptr && *(char ***)ptr) {
2833 char **list = *(char ***)ptr;
2835 for (; *list; list++) {
2836 if (*(list+1) == NULL) {
2837 /* last item, print no extra seperator after */
2840 fprintf(f, "%s%s", *list, list_sep);
2847 if (*(char **)ptr) {
2848 fprintf(f, "%s", *(char **)ptr);
2855 * Check if two parameters are equal.
2858 static bool equal_parameter(parm_type type, void *ptr1, void *ptr2)
2863 return (*((int *)ptr1) == *((int *)ptr2));
2869 return (*((int *)ptr1) == *((int *)ptr2));
2873 return str_list_equal((const char **)(*(char ***)ptr1),
2874 (const char **)(*(char ***)ptr2));
2879 char *p1 = *(char **)ptr1, *p2 = *(char **)ptr2;
2884 return (p1 == p2 || strequal(p1, p2));
2891 * Process a new section (service).
2893 * At this stage all sections are services.
2894 * Later we'll have special sections that permit server parameters to be set.
2895 * Returns True on success, False on failure.
2898 static bool do_section(const char *pszSectionName, void *userdata)
2900 struct loadparm_context *lp_ctx = (struct loadparm_context *)userdata;
2902 bool isglobal = ((strwicmp(pszSectionName, GLOBAL_NAME) == 0) ||
2903 (strwicmp(pszSectionName, GLOBAL_NAME2) == 0));
2906 /* if we've just struck a global section, note the fact. */
2907 lp_ctx->bInGlobalSection = isglobal;
2909 /* check for multiple global sections */
2910 if (lp_ctx->bInGlobalSection) {
2911 DEBUG(4, ("Processing section \"[%s]\"\n", pszSectionName));
2915 /* if we have a current service, tidy it up before moving on */
2918 if (lp_ctx->currentService != NULL)
2919 bRetval = service_ok(lp_ctx->currentService);
2921 /* if all is still well, move to the next record in the services array */
2923 /* We put this here to avoid an odd message order if messages are */
2924 /* issued by the post-processing of a previous section. */
2925 DEBUG(4, ("Processing section \"[%s]\"\n", pszSectionName));
2927 if ((lp_ctx->currentService = lpcfg_add_service(lp_ctx, lp_ctx->sDefault,
2930 DEBUG(0, ("Failed to add a new service\n"));
2940 * Determine if a particular base parameter is currently set to the default value.
2943 static bool is_default(struct loadparm_service *sDefault, int i)
2945 void *def_ptr = ((char *)sDefault) + parm_table[i].offset;
2946 if (!defaults_saved)
2948 switch (parm_table[i].type) {
2951 return str_list_equal((const char **)parm_table[i].def.lvalue,
2952 (const char **)def_ptr);
2955 return strequal(parm_table[i].def.svalue,
2959 return parm_table[i].def.bvalue ==
2965 return parm_table[i].def.ivalue ==
2972 *Display the contents of the global structure.
2975 static void dump_globals(struct loadparm_context *lp_ctx, FILE *f,
2979 struct parmlist_entry *data;
2981 fprintf(f, "# Global parameters\n[global]\n");
2983 for (i = 0; parm_table[i].label; i++)
2984 if (parm_table[i].p_class == P_GLOBAL &&
2985 parm_table[i].offset != -1 &&
2986 (i == 0 || (parm_table[i].offset != parm_table[i - 1].offset))) {
2987 if (!show_defaults && (lp_ctx->flags[i] & FLAG_DEFAULT))
2989 fprintf(f, "\t%s = ", parm_table[i].label);
2990 print_parameter(&parm_table[i], lpcfg_parm_ptr(lp_ctx, NULL, &parm_table[i]), f);
2993 if (lp_ctx->globals->param_opt != NULL) {
2994 for (data = lp_ctx->globals->param_opt; data;
2995 data = data->next) {
2996 if (!show_defaults && (data->priority & FLAG_DEFAULT)) {
2999 fprintf(f, "\t%s = %s\n", data->key, data->value);
3006 * Display the contents of a single services record.
3009 static void dump_a_service(struct loadparm_service * pService, struct loadparm_service *sDefault, FILE * f,
3010 unsigned int *flags)
3013 struct parmlist_entry *data;
3015 if (pService != sDefault)
3016 fprintf(f, "\n[%s]\n", pService->szService);
3018 for (i = 0; parm_table[i].label; i++) {
3019 if (parm_table[i].p_class == P_LOCAL &&
3020 parm_table[i].offset != -1 &&
3021 (*parm_table[i].label != '-') &&
3022 (i == 0 || (parm_table[i].offset != parm_table[i - 1].offset)))
3024 if (pService == sDefault) {
3025 if (flags && (flags[i] & FLAG_DEFAULT)) {
3028 if (defaults_saved) {
3029 if (is_default(sDefault, i)) {
3034 if (equal_parameter(parm_table[i].type,
3035 ((char *)pService) +
3036 parm_table[i].offset,
3037 ((char *)sDefault) +
3038 parm_table[i].offset))
3042 fprintf(f, "\t%s = ", parm_table[i].label);
3043 print_parameter(&parm_table[i],
3044 ((char *)pService) + parm_table[i].offset, f);
3048 if (pService->param_opt != NULL) {
3049 for (data = pService->param_opt; data; data = data->next) {
3050 fprintf(f, "\t%s = %s\n", data->key, data->value);
3055 bool lpcfg_dump_a_parameter(struct loadparm_context *lp_ctx,
3056 struct loadparm_service *service,
3057 const char *parm_name, FILE * f)
3059 struct parm_struct *parm;
3062 parm = lpcfg_parm_struct(lp_ctx, parm_name);
3067 ptr = lpcfg_parm_ptr(lp_ctx, service,parm);
3069 print_parameter(parm, ptr, f);
3075 * Return info about the next parameter in a service.
3076 * snum==-1 gives the globals.
3077 * Return NULL when out of parameters.
3081 struct parm_struct *lpcfg_next_parameter(struct loadparm_context *lp_ctx, int snum, int *i,
3085 /* do the globals */
3086 for (; parm_table[*i].label; (*i)++) {
3087 if (parm_table[*i].offset == -1
3088 || (*parm_table[*i].label == '-'))
3092 && (parm_table[*i].offset ==
3093 parm_table[(*i) - 1].offset)
3094 && (parm_table[*i].p_class ==
3095 parm_table[(*i) - 1].p_class))
3098 return &parm_table[(*i)++];
3101 struct loadparm_service *pService = lp_ctx->services[snum];
3103 for (; parm_table[*i].label; (*i)++) {
3104 if (parm_table[*i].p_class == P_LOCAL &&
3105 parm_table[*i].offset != -1 &&
3106 (*parm_table[*i].label != '-') &&
3108 (parm_table[*i].offset !=
3109 parm_table[(*i) - 1].offset)))
3111 if (allparameters ||
3112 !equal_parameter(parm_table[*i].type,
3113 ((char *)pService) +
3114 parm_table[*i].offset,
3115 ((char *)lp_ctx->sDefault) +
3116 parm_table[*i].offset))
3118 return &parm_table[(*i)++];
3129 * Auto-load some home services.
3131 static void lpcfg_add_auto_services(struct loadparm_context *lp_ctx,
3139 * Unload unused services.
3142 void lpcfg_killunused(struct loadparm_context *lp_ctx,
3143 struct smbsrv_connection *smb,
3144 bool (*snumused) (struct smbsrv_connection *, int))
3147 for (i = 0; i < lp_ctx->iNumServices; i++) {
3148 if (lp_ctx->services[i] == NULL)
3151 if (!snumused || !snumused(smb, i)) {
3152 talloc_free(lp_ctx->services[i]);
3153 lp_ctx->services[i] = NULL;
3159 static int lpcfg_destructor(struct loadparm_context *lp_ctx)
3161 struct parmlist_entry *data;
3163 if (lp_ctx->refuse_free) {
3164 /* someone is trying to free the
3165 global_loadparm_context.
3166 We can't allow that. */
3170 if (lp_ctx->globals->param_opt != NULL) {
3171 struct parmlist_entry *next;
3172 for (data = lp_ctx->globals->param_opt; data; data=next) {
3174 if (data->priority & FLAG_CMDLINE) continue;
3175 DLIST_REMOVE(lp_ctx->globals->param_opt, data);
3184 * Initialise the global parameter structure.
3186 * Note that most callers should use loadparm_init_global() instead
3188 struct loadparm_context *loadparm_init(TALLOC_CTX *mem_ctx)
3192 struct loadparm_context *lp_ctx;
3193 struct parmlist_entry *parm;
3196 lp_ctx = talloc_zero(mem_ctx, struct loadparm_context);
3200 talloc_set_destructor(lp_ctx, lpcfg_destructor);
3201 lp_ctx->bInGlobalSection = true;
3202 lp_ctx->globals = talloc_zero(lp_ctx, struct loadparm_global);
3203 lp_ctx->sDefault = talloc_zero(lp_ctx, struct loadparm_service);
3205 lp_ctx->sDefault->iMaxPrintJobs = 1000;
3206 lp_ctx->sDefault->bAvailable = true;
3207 lp_ctx->sDefault->bBrowseable = true;
3208 lp_ctx->sDefault->bRead_only = true;
3209 lp_ctx->sDefault->bMap_archive = true;
3210 lp_ctx->sDefault->bStrictLocking = true;
3211 lp_ctx->sDefault->bOplocks = true;
3212 lp_ctx->sDefault->iCreate_mask = 0744;
3213 lp_ctx->sDefault->iCreate_force_mode = 0000;
3214 lp_ctx->sDefault->iDir_mask = 0755;
3215 lp_ctx->sDefault->iDir_force_mode = 0000;
3217 DEBUG(3, ("Initialising global parameters\n"));
3219 for (i = 0; parm_table[i].label; i++) {
3220 if ((parm_table[i].type == P_STRING ||
3221 parm_table[i].type == P_USTRING) &&
3222 parm_table[i].offset != -1 &&
3223 !(lp_ctx->flags[i] & FLAG_CMDLINE)) {
3225 if (parm_table[i].p_class == P_LOCAL) {
3226 r = (char **)(((char *)lp_ctx->sDefault) + parm_table[i].offset);
3228 r = (char **)(((char *)lp_ctx->globals) + parm_table[i].offset);
3230 *r = talloc_strdup(lp_ctx, "");
3234 logfile = talloc_asprintf(lp_ctx, "%s/log.samba", dyn_LOGFILEBASE);
3235 lpcfg_do_global_parameter(lp_ctx, "log file", logfile);
3236 talloc_free(logfile);
3238 lpcfg_do_global_parameter(lp_ctx, "log level", "0");
3240 lpcfg_do_global_parameter(lp_ctx, "share backend", "classic");
3242 lpcfg_do_global_parameter(lp_ctx, "share backend", "classic");
3244 lpcfg_do_global_parameter(lp_ctx, "server role", "standalone");
3246 /* options that can be set on the command line must be initialised via
3247 the slower lpcfg_do_global_parameter() to ensure that FLAG_CMDLINE is obeyed */
3249 lpcfg_do_global_parameter(lp_ctx, "socket options", "TCP_NODELAY");
3251 lpcfg_do_global_parameter(lp_ctx, "workgroup", DEFAULT_WORKGROUP);
3252 myname = get_myname(lp_ctx);
3253 lpcfg_do_global_parameter(lp_ctx, "netbios name", myname);
3254 talloc_free(myname);
3255 lpcfg_do_global_parameter(lp_ctx, "name resolve order", "wins host bcast");
3257 lpcfg_do_global_parameter(lp_ctx, "fstype", "NTFS");
3259 lpcfg_do_global_parameter(lp_ctx, "ntvfs handler", "unixuid default");
3260 lpcfg_do_global_parameter(lp_ctx, "max connections", "-1");
3262 lpcfg_do_global_parameter(lp_ctx, "dcerpc endpoint servers", "epmapper srvsvc wkssvc rpcecho samr netlogon lsarpc spoolss drsuapi winreg dssetup unixinfo browser eventlog6 backupkey");
3263 lpcfg_do_global_parameter(lp_ctx, "server services", "smb rpc nbt wrepl ldap cldap kdc drepl winbind ntp_signd kcc dnsupdate web");
3264 lpcfg_do_global_parameter(lp_ctx, "ntptr providor", "simple_ldb");
3265 /* the winbind method for domain controllers is for both RODC
3266 auth forwarding and for trusted domains */
3267 lpcfg_do_global_parameter(lp_ctx, "private dir", dyn_PRIVATE_DIR);
3268 lpcfg_do_global_parameter(lp_ctx, "spoolss database", "spoolss.ldb");
3269 lpcfg_do_global_parameter(lp_ctx, "wins config database", "wins_config.ldb");
3270 lpcfg_do_global_parameter(lp_ctx, "wins database", "wins.ldb");
3271 lpcfg_do_global_parameter(lp_ctx, "registry:HKEY_LOCAL_MACHINE", "hklm.ldb");
3273 /* This hive should be dynamically generated by Samba using
3274 data from the sam, but for the moment leave it in a tdb to
3275 keep regedt32 from popping up an annoying dialog. */
3276 lpcfg_do_global_parameter(lp_ctx, "registry:HKEY_USERS", "hku.ldb");
3278 /* using UTF8 by default allows us to support all chars */
3279 lpcfg_do_global_parameter(lp_ctx, "unix charset", "UTF8");
3281 /* Use codepage 850 as a default for the dos character set */
3282 lpcfg_do_global_parameter(lp_ctx, "dos charset", "CP850");
3285 * Allow the default PASSWD_CHAT to be overridden in local.h.
3287 lpcfg_do_global_parameter(lp_ctx, "passwd chat", DEFAULT_PASSWD_CHAT);
3289 lpcfg_do_global_parameter(lp_ctx, "pid directory", dyn_PIDDIR);
3290 lpcfg_do_global_parameter(lp_ctx, "lock dir", dyn_LOCKDIR);
3291 lpcfg_do_global_parameter(lp_ctx, "ncalrpc dir", dyn_NCALRPCDIR);
3293 lpcfg_do_global_parameter(lp_ctx, "socket address", "");
3294 lpcfg_do_global_parameter_var(lp_ctx, "server string",
3295 "Samba %s", SAMBA_VERSION_STRING);
3297 lpcfg_do_global_parameter(lp_ctx, "password server", "*");
3299 lpcfg_do_global_parameter(lp_ctx, "max mux", "50");
3300 lpcfg_do_global_parameter(lp_ctx, "max xmit", "12288");
3301 lpcfg_do_global_parameter(lp_ctx, "password level", "0");
3302 lpcfg_do_global_parameter(lp_ctx, "LargeReadwrite", "True");
3303 lpcfg_do_global_parameter(lp_ctx, "server min protocol", "CORE");
3304 lpcfg_do_global_parameter(lp_ctx, "server max protocol", "NT1");
3305 lpcfg_do_global_parameter(lp_ctx, "client min protocol", "CORE");
3306 lpcfg_do_global_parameter(lp_ctx, "client max protocol", "NT1");
3307 lpcfg_do_global_parameter(lp_ctx, "security", "USER");
3308 lpcfg_do_global_parameter(lp_ctx, "paranoid server security", "True");
3309 lpcfg_do_global_parameter(lp_ctx, "EncryptPasswords", "True");
3310 lpcfg_do_global_parameter(lp_ctx, "ReadRaw", "True");
3311 lpcfg_do_global_parameter(lp_ctx, "WriteRaw", "True");
3312 lpcfg_do_global_parameter(lp_ctx, "NullPasswords", "False");
3313 lpcfg_do_global_parameter(lp_ctx, "ObeyPamRestrictions", "False");
3315 lpcfg_do_global_parameter(lp_ctx, "TimeServer", "False");
3316 lpcfg_do_global_parameter(lp_ctx, "BindInterfacesOnly", "False");
3317 lpcfg_do_global_parameter(lp_ctx, "Unicode", "True");
3318 lpcfg_do_global_parameter(lp_ctx, "ClientLanManAuth", "False");
3319 lpcfg_do_global_parameter(lp_ctx, "ClientNTLMv2Auth", "True");
3320 lpcfg_do_global_parameter(lp_ctx, "LanmanAuth", "False");
3321 lpcfg_do_global_parameter(lp_ctx, "NTLMAuth", "True");
3322 lpcfg_do_global_parameter(lp_ctx, "client use spnego principal", "False");
3324 lpcfg_do_global_parameter(lp_ctx, "UnixExtensions", "False");
3326 lpcfg_do_global_parameter(lp_ctx, "PreferredMaster", "Auto");
3327 lpcfg_do_global_parameter(lp_ctx, "LocalMaster", "True");
3329 lpcfg_do_global_parameter(lp_ctx, "wins support", "False");
3330 lpcfg_do_global_parameter(lp_ctx, "dns proxy", "True");
3332 lpcfg_do_global_parameter(lp_ctx, "winbind separator", "\\");
3333 lpcfg_do_global_parameter(lp_ctx, "winbind sealed pipes", "True");
3334 lpcfg_do_global_parameter(lp_ctx, "winbindd socket directory", dyn_WINBINDD_SOCKET_DIR);
3335 lpcfg_do_global_parameter(lp_ctx, "winbindd privileged socket directory", dyn_WINBINDD_PRIVILEGED_SOCKET_DIR);
3336 lpcfg_do_global_parameter(lp_ctx, "template shell", "/bin/false");
3337 lpcfg_do_global_parameter(lp_ctx, "template homedir", "/home/%WORKGROUP%/%ACCOUNTNAME%");
3338 lpcfg_do_global_parameter(lp_ctx, "idmap trusted only", "False");
3340 lpcfg_do_global_parameter(lp_ctx, "client signing", "Yes");
3341 lpcfg_do_global_parameter(lp_ctx, "server signing", "auto");
3343 lpcfg_do_global_parameter(lp_ctx, "use spnego", "True");
3345 lpcfg_do_global_parameter(lp_ctx, "smb ports", "445 139");
3346 lpcfg_do_global_parameter(lp_ctx, "nbt port", "137");
3347 lpcfg_do_global_parameter(lp_ctx, "dgram port", "138");
3348 lpcfg_do_global_parameter(lp_ctx, "cldap port", "389");
3349 lpcfg_do_global_parameter(lp_ctx, "krb5 port", "88");
3350 lpcfg_do_global_parameter(lp_ctx, "kpasswd port", "464");
3351 lpcfg_do_global_parameter(lp_ctx, "web port", "901");
3353 lpcfg_do_global_parameter(lp_ctx, "nt status support", "True");
3355 lpcfg_do_global_parameter(lp_ctx, "max wins ttl", "518400"); /* 6 days */
3356 lpcfg_do_global_parameter(lp_ctx, "min wins ttl", "10");
3358 lpcfg_do_global_parameter(lp_ctx, "tls enabled", "True");
3359 lpcfg_do_global_parameter(lp_ctx, "tls keyfile", "tls/key.pem");
3360 lpcfg_do_global_parameter(lp_ctx, "tls certfile", "tls/cert.pem");
3361 lpcfg_do_global_parameter(lp_ctx, "tls cafile", "tls/ca.pem");
3362 lpcfg_do_global_parameter(lp_ctx, "prefork children:smb", "4");
3364 lpcfg_do_global_parameter(lp_ctx, "ntp signd socket directory", dyn_NTP_SIGND_SOCKET_DIR);
3365 lpcfg_do_global_parameter(lp_ctx, "rndc command", "/usr/sbin/rndc");
3366 lpcfg_do_global_parameter_var(lp_ctx, "dns update command", "%s/samba_dnsupdate", dyn_SCRIPTSBINDIR);
3367 lpcfg_do_global_parameter_var(lp_ctx, "spn update command", "%s/samba_spnupdate", dyn_SCRIPTSBINDIR);
3368 lpcfg_do_global_parameter(lp_ctx, "nsupdate command", "/usr/bin/nsupdate -g");
3370 for (i = 0; parm_table[i].label; i++) {
3371 if (!(lp_ctx->flags[i] & FLAG_CMDLINE)) {
3372 lp_ctx->flags[i] |= FLAG_DEFAULT;
3376 for (parm=lp_ctx->globals->param_opt; parm; parm=parm->next) {
3377 if (!(parm->priority & FLAG_CMDLINE)) {
3378 parm->priority |= FLAG_DEFAULT;
3386 * Initialise the global parameter structure.
3388 struct loadparm_context *loadparm_init_global(bool load_default)
3390 if (global_loadparm_context == NULL) {
3391 global_loadparm_context = loadparm_init(NULL);
3393 if (global_loadparm_context == NULL) {
3396 global_loadparm_context->global = true;
3397 if (load_default && !global_loadparm_context->loaded) {
3398 lpcfg_load_default(global_loadparm_context);
3400 global_loadparm_context->refuse_free = true;
3401 return global_loadparm_context;
3405 * Initialise the global parameter structure.
3407 struct loadparm_context *loadparm_init_s3(TALLOC_CTX *mem_ctx,
3408 const struct loadparm_s3_context *s3_fns)
3410 struct loadparm_context *loadparm_context = loadparm_init(mem_ctx);
3411 if (!loadparm_context) {
3414 loadparm_context->s3_fns = s3_fns;
3415 return loadparm_context;
3418 const char *lpcfg_configfile(struct loadparm_context *lp_ctx)
3420 return lp_ctx->szConfigFile;
3423 const char *lp_default_path(void)
3425 if (getenv("SMB_CONF_PATH"))
3426 return getenv("SMB_CONF_PATH");
3428 return dyn_CONFIGFILE;
3432 * Update the internal state of a loadparm context after settings
3435 static bool lpcfg_update(struct loadparm_context *lp_ctx)
3437 struct debug_settings settings;
3438 lpcfg_add_auto_services(lp_ctx, lpcfg_auto_services(lp_ctx));
3440 if (!lp_ctx->globals->szWINSservers && lp_ctx->globals->bWINSsupport) {
3441 lpcfg_do_global_parameter(lp_ctx, "wins server", "127.0.0.1");
3444 if (!lp_ctx->global) {
3448 panic_action = lp_ctx->globals->panic_action;
3450 reload_charcnv(lp_ctx);
3452 ZERO_STRUCT(settings);
3453 /* Add any more debug-related smb.conf parameters created in
3455 settings.timestamp_logs = true;
3456 debug_set_settings(&settings);
3458 /* FIXME: This is a bit of a hack, but we can't use a global, since
3459 * not everything that uses lp also uses the socket library */
3460 if (lpcfg_parm_bool(lp_ctx, NULL, "socket", "testnonblock", false)) {
3461 setenv("SOCKET_TESTNONBLOCK", "1", 1);
3463 unsetenv("SOCKET_TESTNONBLOCK");
3469 bool lpcfg_load_default(struct loadparm_context *lp_ctx)
3473 path = lp_default_path();
3475 if (!file_exist(path)) {
3476 /* We allow the default smb.conf file to not exist,
3477 * basically the equivalent of an empty file. */
3478 return lpcfg_update(lp_ctx);
3481 return lpcfg_load(lp_ctx, path);
3485 * Load the services array from the services file.
3487 * Return True on success, False on failure.
3489 bool lpcfg_load(struct loadparm_context *lp_ctx, const char *filename)
3494 filename = talloc_strdup(lp_ctx, filename);
3496 lp_ctx->szConfigFile = filename;
3498 lp_ctx->bInGlobalSection = true;
3499 n2 = standard_sub_basic(lp_ctx, lp_ctx->szConfigFile);
3500 DEBUG(2, ("lpcfg_load: refreshing parameters from %s\n", n2));
3502 add_to_file_list(lp_ctx, lp_ctx->szConfigFile, n2);
3504 /* We get sections first, so have to start 'behind' to make up */
3505 lp_ctx->currentService = NULL;
3506 bRetval = pm_process(n2, do_section, do_parameter, lp_ctx);
3508 /* finish up the last section */
3509 DEBUG(4, ("pm_process() returned %s\n", BOOLSTR(bRetval)));
3511 if (lp_ctx->currentService != NULL)
3512 bRetval = service_ok(lp_ctx->currentService);
3514 bRetval = bRetval && lpcfg_update(lp_ctx);
3516 /* we do this unconditionally, so that it happens even
3517 for a missing smb.conf */
3518 reload_charcnv(lp_ctx);
3520 if (bRetval == true) {
3521 /* set this up so that any child python tasks will
3522 find the right smb.conf */
3523 setenv("SMB_CONF_PATH", filename, 1);
3525 /* set the context used by the lp_*() function
3527 global_loadparm_context = lp_ctx;
3528 lp_ctx->loaded = true;
3535 * Return the max number of services.
3538 int lpcfg_numservices(struct loadparm_context *lp_ctx)
3540 return lp_ctx->iNumServices;
3544 * Display the contents of the services array in human-readable form.
3547 void lpcfg_dump(struct loadparm_context *lp_ctx, FILE *f, bool show_defaults,
3552 defaults_saved = !show_defaults;
3554 dump_globals(lp_ctx, f, show_defaults);
3556 dump_a_service(lp_ctx->sDefault, lp_ctx->sDefault, f, lp_ctx->flags);
3558 for (iService = 0; iService < maxtoprint; iService++)
3559 lpcfg_dump_one(f, show_defaults, lp_ctx->services[iService], lp_ctx->sDefault);
3563 * Display the contents of one service in human-readable form.
3565 void lpcfg_dump_one(FILE *f, bool show_defaults, struct loadparm_service *service, struct loadparm_service *sDefault)
3567 if (service != NULL) {
3568 if (service->szService[0] == '\0')
3570 dump_a_service(service, sDefault, f, NULL);
3574 struct loadparm_service *lpcfg_servicebynum(struct loadparm_context *lp_ctx,
3577 return lp_ctx->services[snum];
3580 struct loadparm_service *lpcfg_service(struct loadparm_context *lp_ctx,
3581 const char *service_name)
3586 if (lp_ctx->s3_fns) {
3587 return lp_ctx->s3_fns->get_service(service_name);
3590 for (iService = lp_ctx->iNumServices - 1; iService >= 0; iService--) {
3591 if (lp_ctx->services[iService] &&
3592 lp_ctx->services[iService]->szService) {
3594 * The substitution here is used to support %U is
3597 serviceName = standard_sub_basic(
3598 lp_ctx->services[iService],
3599 lp_ctx->services[iService]->szService);
3600 if (strequal(serviceName, service_name)) {
3601 talloc_free(serviceName);
3602 return lp_ctx->services[iService];
3604 talloc_free(serviceName);
3608 DEBUG(7,("lpcfg_servicenumber: couldn't find %s\n", service_name));
3612 const char *lpcfg_servicename(const struct loadparm_service *service)
3614 return lp_string((const char *)service->szService);
3618 * A useful volume label function.
3620 const char *lpcfg_volume_label(struct loadparm_service *service, struct loadparm_service *sDefault)
3623 ret = lp_string((const char *)((service != NULL && service->volume != NULL) ?
3624 service->volume : sDefault->volume));
3626 return lpcfg_servicename(service);
3631 * If we are PDC then prefer us as DMB
3633 const char *lpcfg_printername(struct loadparm_service *service, struct loadparm_service *sDefault)
3636 ret = lp_string((const char *)((service != NULL && service->szPrintername != NULL) ?
3637 service->szPrintername : sDefault->szPrintername));
3638 if (ret == NULL || (ret != NULL && *ret == '\0'))
3639 ret = lpcfg_servicename(service);
3646 * Return the max print jobs per queue.
3648 int lpcfg_maxprintjobs(struct loadparm_service *service, struct loadparm_service *sDefault)
3650 int maxjobs = (service != NULL) ? service->iMaxPrintJobs : sDefault->iMaxPrintJobs;
3651 if (maxjobs <= 0 || maxjobs >= PRINT_MAX_JOBID)
3652 maxjobs = PRINT_MAX_JOBID - 1;
3657 struct smb_iconv_handle *lpcfg_iconv_handle(struct loadparm_context *lp_ctx)
3659 if (lp_ctx == NULL) {
3660 return get_iconv_handle();
3662 return lp_ctx->iconv_handle;
3665 _PUBLIC_ void reload_charcnv(struct loadparm_context *lp_ctx)
3667 struct smb_iconv_handle *old_ic = lp_ctx->iconv_handle;
3668 if (!lp_ctx->global) {
3672 if (old_ic == NULL) {
3673 old_ic = global_iconv_handle;
3675 lp_ctx->iconv_handle = smb_iconv_handle_reinit_lp(lp_ctx, lp_ctx, old_ic);
3676 global_iconv_handle = lp_ctx->iconv_handle;
3679 void lpcfg_smbcli_options(struct loadparm_context *lp_ctx,
3680 struct smbcli_options *options)
3682 options->max_xmit = lpcfg_max_xmit(lp_ctx);
3683 options->max_mux = lpcfg_maxmux(lp_ctx);
3684 options->use_spnego = lpcfg_nt_status_support(lp_ctx) && lpcfg_use_spnego(lp_ctx);
3685 options->signing = lpcfg_client_signing(lp_ctx);
3686 options->request_timeout = SMB_REQUEST_TIMEOUT;
3687 options->ntstatus_support = lpcfg_nt_status_support(lp_ctx);
3688 options->max_protocol = lpcfg_cli_maxprotocol(lp_ctx);
3689 options->unicode = lpcfg_unicode(lp_ctx);
3690 options->use_oplocks = true;
3691 options->use_level2_oplocks = true;
3694 void lpcfg_smbcli_session_options(struct loadparm_context *lp_ctx,
3695 struct smbcli_session_options *options)
3697 options->lanman_auth = lpcfg_client_lanman_auth(lp_ctx);
3698 options->ntlmv2_auth = lpcfg_client_ntlmv2_auth(lp_ctx);
3699 options->plaintext_auth = lpcfg_client_plaintext_auth(lp_ctx);
3702 _PUBLIC_ char *lpcfg_tls_keyfile(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3704 return lpcfg_private_path(mem_ctx, lp_ctx, lp_ctx->globals->tls_keyfile);
3707 _PUBLIC_ char *lpcfg_tls_certfile(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3709 return lpcfg_private_path(mem_ctx, lp_ctx, lp_ctx->globals->tls_certfile);
3712 _PUBLIC_ char *lpcfg_tls_cafile(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3714 return lpcfg_private_path(mem_ctx, lp_ctx, lp_ctx->globals->tls_cafile);
3717 _PUBLIC_ char *lpcfg_tls_crlfile(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3719 return lpcfg_private_path(mem_ctx, lp_ctx, lp_ctx->globals->tls_crlfile);
3722 _PUBLIC_ char *lpcfg_tls_dhpfile(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3724 return lpcfg_private_path(mem_ctx, lp_ctx, lp_ctx->globals->tls_dhpfile);
3727 _PUBLIC_ struct dcerpc_server_info *lpcfg_dcerpc_server_info(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3729 struct dcerpc_server_info *ret = talloc_zero(mem_ctx, struct dcerpc_server_info);
3731 ret->domain_name = talloc_reference(mem_ctx, lpcfg_workgroup(lp_ctx));
3732 ret->version_major = lpcfg_parm_int(lp_ctx, NULL, "server_info", "version_major", 5);
3733 ret->version_minor = lpcfg_parm_int(lp_ctx, NULL, "server_info", "version_minor", 2);
3734 ret->version_build = lpcfg_parm_int(lp_ctx, NULL, "server_info", "version_build", 3790);
3739 struct gensec_settings *lpcfg_gensec_settings(TALLOC_CTX *mem_ctx, struct loadparm_context *lp_ctx)
3741 struct gensec_settings *settings = talloc(mem_ctx, struct gensec_settings);
3742 if (settings == NULL)
3744 SMB_ASSERT(lp_ctx != NULL);
3745 settings->lp_ctx = talloc_reference(settings, lp_ctx);
3746 settings->target_hostname = lpcfg_parm_string(lp_ctx, NULL, "gensec", "target_hostname");