2 * Unix SMB/CIFS implementation.
3 * Service Control API Implementation
5 * Copyright (C) Marcin Krzysztof Porwit 2005.
6 * Largely Rewritten by:
7 * Copyright (C) Gerald (Jerry) Carter 2005.
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, write to the Free Software
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 struct rcinit_file_information {
30 struct service_display_info {
31 const char *servicename;
34 const char *description;
37 struct service_display_info builtin_svcs[] = {
38 { "Spooler", "smbd", "Print Spooler", "Internal service for spooling files to print devices" },
39 { "NETLOGON", "smbd", "Net Logon", "File service providing access to policy and profile data (not remotely manageable)" },
40 { "RemoteRegistry", "smbd", "Remote Registry Service", "Internal service providing remote access to "
41 "the Samba registry" },
42 { "WINS", "nmbd", "Windows Internet Name Service (WINS)", "Internal service providing a "
43 "NetBIOS point-to-point name server (not remotely manageable)" },
44 { NULL, NULL, NULL, NULL }
47 struct service_display_info common_unix_svcs[] = {
48 { "cups", NULL, "Common Unix Printing System","Provides unified printing support for all operating systems" },
49 { "postfix", NULL, "Internet Mail Service", "Provides support for sending and receiving electonic mail" },
50 { "sendmail", NULL, "Internet Mail Service", "Provides support for sending and receiving electonic mail" },
51 { "portmap", NULL, "TCP Port to RPC PortMapper",NULL },
52 { "xinetd", NULL, "Internet Meta-Daemon", NULL },
53 { "inet", NULL, "Internet Meta-Daemon", NULL },
54 { "xntpd", NULL, "Network Time Service", NULL },
55 { "ntpd", NULL, "Network Time Service", NULL },
56 { "lpd", NULL, "BSD Print Spooler", NULL },
57 { "nfsserver", NULL, "Network File Service", NULL },
58 { "cron", NULL, "Scheduling Service", NULL },
59 { "at", NULL, "Scheduling Service", NULL },
60 { "nscd", NULL, "Name Service Cache Daemon", NULL },
61 { "slapd", NULL, "LDAP Directory Service", NULL },
62 { "ldap", NULL, "LDAP DIrectory Service", NULL },
63 { "ypbind", NULL, "NIS Directory Service", NULL },
64 { "courier-imap", NULL, "IMAP4 Mail Service", NULL },
65 { "courier-pop3", NULL, "POP3 Mail Service", NULL },
66 { "named", NULL, "Domain Name Service", NULL },
67 { "bind", NULL, "Domain Name Service", NULL },
68 { "httpd", NULL, "HTTP Server", NULL },
69 { "apache", NULL, "HTTP Server", "Provides s highly scalable and flexible web server "
70 "capable of implementing various protocols incluing "
71 "but not limited to HTTP" },
72 { "autofs", NULL, "Automounter", NULL },
73 { "squid", NULL, "Web Cache Proxy ", NULL },
74 { "perfcountd", NULL, "Performance Monitoring Daemon", NULL },
75 { "pgsql", NULL, "PgSQL Database Server", "Provides service for SQL database from Postgresql.org" },
76 { "arpwatch", NULL, "ARP Tables watcher", "Provides service for monitoring ARP tables for changes" },
77 { "dhcpd", NULL, "DHCP Server", "Provides service for dynamic host configuration and IP assignment" },
78 { "nwserv", NULL, "NetWare Server Emulator", "Provides service for emulating Novell NetWare 3.12 server" },
79 { "proftpd", NULL, "Professional FTP Server", "Provides high configurable service for FTP connection and "
80 "file transferring" },
81 { "ssh2", NULL, "SSH Secure Shell", "Provides service for secure connection for remote administration" },
82 { "sshd", NULL, "SSH Secure Shell", "Provides service for secure connection for remote administration" },
83 { NULL, NULL, NULL, NULL }
87 /********************************************************************
88 ********************************************************************/
90 static SEC_DESC* construct_service_sd( TALLOC_CTX *ctx )
99 /* basic access for Everyone */
101 init_sec_access(&mask, SERVICE_READ_ACCESS );
102 init_sec_ace(&ace[i++], &global_sid_World, SEC_ACE_TYPE_ACCESS_ALLOWED, mask, 0);
104 init_sec_access(&mask,SERVICE_EXECUTE_ACCESS );
105 init_sec_ace(&ace[i++], &global_sid_Builtin_Power_Users, SEC_ACE_TYPE_ACCESS_ALLOWED, mask, 0);
107 init_sec_access(&mask,SERVICE_ALL_ACCESS );
108 init_sec_ace(&ace[i++], &global_sid_Builtin_Server_Operators, SEC_ACE_TYPE_ACCESS_ALLOWED, mask, 0);
109 init_sec_ace(&ace[i++], &global_sid_Builtin_Administrators, SEC_ACE_TYPE_ACCESS_ALLOWED, mask, 0);
111 /* create the security descriptor */
113 if ( !(acl = make_sec_acl(ctx, NT4_ACL_REVISION, i, ace)) )
116 if ( !(sd = make_sec_desc(ctx, SEC_DESC_REVISION, SEC_DESC_SELF_RELATIVE, NULL, NULL, NULL, acl, &sd_size)) )
122 /********************************************************************
123 This is where we do the dirty work of filling in things like the
124 Display name, Description, etc...
125 ********************************************************************/
127 static char *get_common_service_dispname( const char *servicename )
129 static fstring dispname;
132 for ( i=0; common_unix_svcs[i].servicename; i++ ) {
133 if ( strequal( servicename, common_unix_svcs[i].servicename ) ) {
134 fstr_sprintf( dispname, "%s (%s)",
135 common_unix_svcs[i].dispname,
136 common_unix_svcs[i].servicename );
142 fstrcpy( dispname, servicename );
147 /********************************************************************
148 ********************************************************************/
150 static char* cleanup_string( const char *string )
152 static pstring clean;
155 pstrcpy( clean, string );
158 /* trim any beginning whilespace */
160 while ( isspace(*begin) )
163 if ( *begin == '\0' )
166 /* trim any trailing whitespace or carriage returns.
167 Start at the end and move backwards */
169 end = begin + strlen(begin) - 1;
171 while ( isspace(*end) || *end=='\n' || *end=='\r' ) {
179 /********************************************************************
180 ********************************************************************/
182 static BOOL read_init_file( const char *servicename, struct rcinit_file_information **service_info )
184 struct rcinit_file_information *info;
185 pstring filepath, str;
189 if ( !(info = TALLOC_ZERO_P( NULL, struct rcinit_file_information ) ) )
192 /* attempt the file open */
194 pstr_sprintf( filepath, "%s/%s/%s", dyn_LIBDIR, SVCCTL_SCRIPT_DIR, servicename );
195 if ( !(f = x_fopen( filepath, O_RDONLY, 0 )) ) {
196 DEBUG(0,("read_init_file: failed to open [%s]\n", filepath));
201 while ( (x_fgets( str, sizeof(str)-1, f )) != NULL ) {
202 /* ignore everything that is not a full line
203 comment starting with a '#' */
208 /* Look for a line like '^#.*Description:' */
210 if ( (p = strstr( str, "Description:" )) != NULL ) {
213 p += strlen( "Description:" ) + 1;
217 if ( (desc = cleanup_string(p)) != NULL )
218 info->description = talloc_strdup( info, desc );
224 if ( !info->description )
225 info->description = talloc_strdup( info, "External Unix Service" );
227 *service_info = info;
232 /********************************************************************
233 This is where we do the dirty work of filling in things like the
234 Display name, Description, etc...
235 ********************************************************************/
237 static void fill_service_values( const char *name, REGVAL_CTR *values )
239 UNISTR2 data, dname, ipath, description;
244 /* These values are hardcoded in all QueryServiceConfig() replies.
245 I'm just storing them here for cosmetic purposes */
247 dword = SVCCTL_AUTO_START;
248 regval_ctr_addvalue( values, "Start", REG_DWORD, (char*)&dword, sizeof(uint32));
250 dword = SVCCTL_WIN32_OWN_PROC;
251 regval_ctr_addvalue( values, "Type", REG_DWORD, (char*)&dword, sizeof(uint32));
253 dword = SVCCTL_SVC_ERROR_NORMAL;
254 regval_ctr_addvalue( values, "ErrorControl", REG_DWORD, (char*)&dword, sizeof(uint32));
256 /* everything runs as LocalSystem */
258 init_unistr2( &data, "LocalSystem", UNI_STR_TERMINATE );
259 regval_ctr_addvalue( values, "ObjectName", REG_SZ, (char*)data.buffer, data.uni_str_len*2);
261 /* special considerations for internal services and the DisplayName value */
263 for ( i=0; builtin_svcs[i].servicename; i++ ) {
264 if ( strequal( name, builtin_svcs[i].servicename ) ) {
265 pstr_sprintf( pstr, "%s/%s/%s",dyn_LIBDIR, SVCCTL_SCRIPT_DIR, builtin_svcs[i].daemon );
266 init_unistr2( &ipath, pstr, UNI_STR_TERMINATE );
267 init_unistr2( &description, builtin_svcs[i].description, UNI_STR_TERMINATE );
268 init_unistr2( &dname, builtin_svcs[i].dispname, UNI_STR_TERMINATE );
273 /* default to an external service if we haven't found a match */
275 if ( builtin_svcs[i].servicename == NULL ) {
276 struct rcinit_file_information *init_info = NULL;
278 pstr_sprintf( pstr, "%s/%s/%s",dyn_LIBDIR, SVCCTL_SCRIPT_DIR, name );
279 init_unistr2( &ipath, pstr, UNI_STR_TERMINATE );
281 /* lookup common unix display names */
282 init_unistr2( &dname, get_common_service_dispname( name ), UNI_STR_TERMINATE );
284 /* get info from init file itself */
285 if ( read_init_file( name, &init_info ) ) {
286 init_unistr2( &description, init_info->description, UNI_STR_TERMINATE );
287 TALLOC_FREE( init_info );
290 init_unistr2( &description, "External Unix Service", UNI_STR_TERMINATE );
294 /* add the new values */
296 regval_ctr_addvalue( values, "DisplayName", REG_SZ, (char*)dname.buffer, dname.uni_str_len*2);
297 regval_ctr_addvalue( values, "ImagePath", REG_SZ, (char*)ipath.buffer, ipath.uni_str_len*2);
298 regval_ctr_addvalue( values, "Description", REG_SZ, (char*)description.buffer, description.uni_str_len*2);
303 /********************************************************************
304 ********************************************************************/
306 static void add_new_svc_name( REGISTRY_KEY *key_parent, REGSUBKEY_CTR *subkeys,
309 REGISTRY_KEY *key_service, *key_secdesc;
313 REGSUBKEY_CTR *svc_subkeys;
317 /* add to the list and create the subkey path */
319 regsubkey_ctr_addkey( subkeys, name );
320 store_reg_keys( key_parent, subkeys );
322 /* open the new service key */
324 pstr_sprintf( path, "%s\\%s", KEY_SERVICES, name );
325 wresult = regkey_open_internal( NULL, &key_service, path,
326 get_root_nt_token(), REG_KEY_ALL );
327 if ( !W_ERROR_IS_OK(wresult) ) {
328 DEBUG(0,("add_new_svc_name: key lookup failed! [%s] (%s)\n",
329 path, dos_errstr(wresult)));
333 /* add the 'Security' key */
335 if ( !(svc_subkeys = TALLOC_ZERO_P( key_service, REGSUBKEY_CTR )) ) {
336 DEBUG(0,("add_new_svc_name: talloc() failed!\n"));
337 TALLOC_FREE( key_service );
341 fetch_reg_keys( key_service, svc_subkeys );
342 regsubkey_ctr_addkey( svc_subkeys, "Security" );
343 store_reg_keys( key_service, svc_subkeys );
345 /* now for the service values */
347 if ( !(values = TALLOC_ZERO_P( key_service, REGVAL_CTR )) ) {
348 DEBUG(0,("add_new_svc_name: talloc() failed!\n"));
349 TALLOC_FREE( key_service );
353 fill_service_values( name, values );
354 store_reg_values( key_service, values );
356 /* cleanup the service key*/
358 TALLOC_FREE( key_service );
360 /* now add the security descriptor */
362 pstr_sprintf( path, "%s\\%s\\%s", KEY_SERVICES, name, "Security" );
363 wresult = regkey_open_internal( NULL, &key_secdesc, path,
364 get_root_nt_token(), REG_KEY_ALL );
365 if ( !W_ERROR_IS_OK(wresult) ) {
366 DEBUG(0,("add_new_svc_name: key lookup failed! [%s] (%s)\n",
367 path, dos_errstr(wresult)));
368 TALLOC_FREE( key_secdesc );
372 if ( !(values = TALLOC_ZERO_P( key_secdesc, REGVAL_CTR )) ) {
373 DEBUG(0,("add_new_svc_name: talloc() failed!\n"));
374 TALLOC_FREE( key_secdesc );
378 if ( !(sd = construct_service_sd(key_secdesc)) ) {
379 DEBUG(0,("add_new_svc_name: Failed to create default sec_desc!\n"));
380 TALLOC_FREE( key_secdesc );
384 /* stream the printer security descriptor */
386 prs_init( &ps, RPC_MAX_PDU_FRAG_LEN, key_secdesc, MARSHALL);
388 if ( sec_io_desc("sec_desc", &sd, &ps, 0 ) ) {
389 uint32 offset = prs_offset( &ps );
390 regval_ctr_addvalue( values, "Security", REG_BINARY, prs_data_p(&ps), offset );
391 store_reg_values( key_secdesc, values );
394 /* finally cleanup the Security key */
397 TALLOC_FREE( key_secdesc );
402 /********************************************************************
403 ********************************************************************/
405 void svcctl_init_keys( void )
407 const char **service_list = lp_svcctl_list();
409 REGSUBKEY_CTR *subkeys;
410 REGISTRY_KEY *key = NULL;
413 /* bad mojo here if the lookup failed. Should not happen */
415 wresult = regkey_open_internal( NULL, &key, KEY_SERVICES,
416 get_root_nt_token(), REG_KEY_ALL );
418 if ( !W_ERROR_IS_OK(wresult) ) {
419 DEBUG(0,("init_services_keys: key lookup failed! (%s)\n",
420 dos_errstr(wresult)));
424 /* lookup the available subkeys */
426 if ( !(subkeys = TALLOC_ZERO_P( key, REGSUBKEY_CTR )) ) {
427 DEBUG(0,("init_services_keys: talloc() failed!\n"));
432 fetch_reg_keys( key, subkeys );
434 /* the builting services exist */
436 for ( i=0; builtin_svcs[i].servicename; i++ )
437 add_new_svc_name( key, subkeys, builtin_svcs[i].servicename );
439 for ( i=0; service_list && service_list[i]; i++ ) {
441 /* only add new services */
442 if ( regsubkey_ctr_key_exists( subkeys, service_list[i] ) )
445 /* Add the new service key and initialize the appropriate values */
447 add_new_svc_name( key, subkeys, service_list[i] );
452 /* initialize the control hooks */
454 init_service_op_table();
459 /********************************************************************
460 This is where we do the dirty work of filling in things like the
461 Display name, Description, etc...Always return a default secdesc
462 in case of any failure.
463 ********************************************************************/
465 SEC_DESC* svcctl_get_secdesc( TALLOC_CTX *ctx, const char *name, NT_USER_TOKEN *token )
472 SEC_DESC *ret_sd = NULL;
476 /* now add the security descriptor */
478 pstr_sprintf( path, "%s\\%s\\%s", KEY_SERVICES, name, "Security" );
479 wresult = regkey_open_internal( NULL, &key, path, token,
481 if ( !W_ERROR_IS_OK(wresult) ) {
482 DEBUG(0,("svcctl_get_secdesc: key lookup failed! [%s] (%s)\n",
483 path, dos_errstr(wresult)));
487 if ( !(values = TALLOC_ZERO_P( key, REGVAL_CTR )) ) {
488 DEBUG(0,("add_new_svc_name: talloc() failed!\n"));
493 fetch_reg_values( key, values );
495 if ( !(val = regval_ctr_getvalue( values, "Security" )) ) {
496 DEBUG(6,("svcctl_get_secdesc: constructing default secdesc for service [%s]\n",
499 return construct_service_sd( ctx );
503 /* stream the printer security descriptor */
505 prs_init( &ps, 0, key, UNMARSHALL);
506 prs_give_memory( &ps, (char *)regval_data_p(val), regval_size(val), False );
508 if ( !sec_io_desc("sec_desc", &sd, &ps, 0 ) ) {
510 return construct_service_sd( ctx );
513 ret_sd = dup_sec_desc( ctx, sd );
515 /* finally cleanup the Security key */
523 /********************************************************************
524 Wrapper to make storing a Service sd easier
525 ********************************************************************/
527 BOOL svcctl_set_secdesc( TALLOC_CTX *ctx, const char *name, SEC_DESC *sec_desc, NT_USER_TOKEN *token )
536 /* now add the security descriptor */
538 pstr_sprintf( path, "%s\\%s\\%s", KEY_SERVICES, name, "Security" );
539 wresult = regkey_open_internal( NULL, &key, path, token,
541 if ( !W_ERROR_IS_OK(wresult) ) {
542 DEBUG(0,("svcctl_get_secdesc: key lookup failed! [%s] (%s)\n",
543 path, dos_errstr(wresult)));
547 if ( !(values = TALLOC_ZERO_P( key, REGVAL_CTR )) ) {
548 DEBUG(0,("add_new_svc_name: talloc() failed!\n"));
553 /* stream the printer security descriptor */
555 prs_init( &ps, RPC_MAX_PDU_FRAG_LEN, key, MARSHALL);
557 if ( sec_io_desc("sec_desc", &sec_desc, &ps, 0 ) ) {
558 uint32 offset = prs_offset( &ps );
559 regval_ctr_addvalue( values, "Security", REG_BINARY, prs_data_p(&ps), offset );
560 ret = store_reg_values( key, values );
571 /********************************************************************
572 ********************************************************************/
574 char* svcctl_lookup_dispname( const char *name, NT_USER_TOKEN *token )
576 static fstring display_name;
583 /* now add the security descriptor */
585 pstr_sprintf( path, "%s\\%s", KEY_SERVICES, name );
586 wresult = regkey_open_internal( NULL, &key, path, token,
588 if ( !W_ERROR_IS_OK(wresult) ) {
589 DEBUG(0,("svcctl_lookup_dispname: key lookup failed! [%s] (%s)\n",
590 path, dos_errstr(wresult)));
594 if ( !(values = TALLOC_ZERO_P( key, REGVAL_CTR )) ) {
595 DEBUG(0,("svcctl_lookup_dispname: talloc() failed!\n"));
600 fetch_reg_values( key, values );
602 if ( !(val = regval_ctr_getvalue( values, "DisplayName" )) )
605 rpcstr_pull( display_name, regval_data_p(val), sizeof(display_name), regval_size(val), 0 );
612 /* default to returning the service name */
614 fstrcpy( display_name, name );
618 /********************************************************************
619 ********************************************************************/
621 char* svcctl_lookup_description( const char *name, NT_USER_TOKEN *token )
623 static fstring description;
630 /* now add the security descriptor */
632 pstr_sprintf( path, "%s\\%s", KEY_SERVICES, name );
633 wresult = regkey_open_internal( NULL, &key, path, token,
635 if ( !W_ERROR_IS_OK(wresult) ) {
636 DEBUG(0,("svcctl_lookup_dispname: key lookup failed! [%s] (%s)\n",
637 path, dos_errstr(wresult)));
641 if ( !(values = TALLOC_ZERO_P( key, REGVAL_CTR )) ) {
642 DEBUG(0,("svcctl_lookup_dispname: talloc() failed!\n"));
647 fetch_reg_values( key, values );
649 if ( !(val = regval_ctr_getvalue( values, "Description" )) )
650 fstrcpy( description, "Unix Service");
652 rpcstr_pull( description, regval_data_p(val), sizeof(description), regval_size(val), 0 );
660 /********************************************************************
661 ********************************************************************/
663 REGVAL_CTR* svcctl_fetch_regvalues( const char *name, NT_USER_TOKEN *token )
670 /* now add the security descriptor */
672 pstr_sprintf( path, "%s\\%s", KEY_SERVICES, name );
673 wresult = regkey_open_internal( NULL, &key, path, token,
675 if ( !W_ERROR_IS_OK(wresult) ) {
676 DEBUG(0,("svcctl_fetch_regvalues: key lookup failed! [%s] (%s)\n",
677 path, dos_errstr(wresult)));
681 if ( !(values = TALLOC_ZERO_P( NULL, REGVAL_CTR )) ) {
682 DEBUG(0,("svcctl_fetch_regvalues: talloc() failed!\n"));
687 fetch_reg_values( key, values );