1 /*****************************************************************************
2 * ntservice.c: Windows NT/2K/XP service interface
3 *****************************************************************************
4 * Copyright (C) 2004 the VideoLAN team
7 * Authors: Gildas Bazin <gbazin@videolan.org>
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 2 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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
31 #include <vlc_common.h>
32 #include <vlc_plugin.h>
33 #include <vlc_interface.h>
35 #define VLCSERVICENAME "VLC media player"
37 /*****************************************************************************
39 *****************************************************************************/
40 static int Activate( vlc_object_t * );
41 static void Close ( vlc_object_t * );
43 #define INSTALL_TEXT N_( "Install Windows Service" )
44 #define INSTALL_LONGTEXT N_( \
45 "Install the Service and exit." )
46 #define UNINSTALL_TEXT N_( "Uninstall Windows Service" )
47 #define UNINSTALL_LONGTEXT N_( \
48 "Uninstall the Service and exit." )
49 #define NAME_TEXT N_( "Display name of the Service" )
50 #define NAME_LONGTEXT N_( \
51 "Change the display name of the Service." )
52 #define OPTIONS_TEXT N_("Configuration options")
53 #define OPTIONS_LONGTEXT N_( \
54 "Configuration options that will be " \
55 "used by the Service (eg. --foo=bar --no-foobar). It should be specified "\
56 "at install time so the Service is properly configured.")
57 #define EXTRAINTF_TEXT N_("Extra interface modules")
58 #define EXTRAINTF_LONGTEXT N_( \
59 "Additional interfaces spawned by the " \
60 "Service. It should be specified at install time so the Service is " \
61 "properly configured. Use a comma separated list of interface modules. " \
62 "(common values are: logger, sap, rc, http)")
65 set_shortname( N_("NT Service"))
66 set_description( N_("Windows Service interface") )
67 set_category( CAT_INTERFACE )
68 set_subcategory( SUBCAT_INTERFACE_CONTROL )
69 add_bool( "ntservice-install", false,
70 INSTALL_TEXT, INSTALL_LONGTEXT, true )
71 add_bool( "ntservice-uninstall", false,
72 UNINSTALL_TEXT, UNINSTALL_LONGTEXT, true )
73 add_string ( "ntservice-name", VLCSERVICENAME,
74 NAME_TEXT, NAME_LONGTEXT, true )
75 add_string ( "ntservice-options", NULL,
76 OPTIONS_TEXT, OPTIONS_LONGTEXT, true )
77 add_string ( "ntservice-extraintf", NULL,
78 EXTRAINTF_TEXT, EXTRAINTF_LONGTEXT, true )
80 set_capability( "interface", 0 )
81 set_callbacks( Activate, Close )
86 SERVICE_STATUS_HANDLE hStatus;
87 SERVICE_STATUS status;
92 /*****************************************************************************
94 *****************************************************************************/
95 static void *Run( void * );
96 static int NTServiceInstall( intf_thread_t *p_intf );
97 static int NTServiceUninstall( intf_thread_t *p_intf );
98 static void WINAPI ServiceDispatch( DWORD numArgs, char **args );
99 static void WINAPI ServiceCtrlHandler( DWORD control );
101 /* We need this global */
102 static intf_thread_t *p_global_intf;
104 /*****************************************************************************
105 * Activate: initialize and create stuff
106 *****************************************************************************/
107 static int Activate( vlc_object_t *p_this )
109 intf_thread_t *p_intf = (intf_thread_t*)p_this;
110 intf_sys_t *p_sys = malloc( sizeof( *p_sys ) );
111 if( unlikely(p_sys == NULL) )
114 p_intf->pf_run = NULL;
115 p_intf->p_sys = p_sys;
117 if( vlc_clone( &p_sys->thread, Run, p_intf, VLC_THREAD_PRIORITY_LOW ) )
123 /*****************************************************************************
124 * Close: destroy interface
125 *****************************************************************************/
126 void Close( vlc_object_t *p_this )
128 intf_thread_t *p_intf = (intf_thread_t*)p_this;
129 intf_sys_t *p_sys = p_intf->p_sys;
131 vlc_join( p_sys->thread, NULL );
135 /*****************************************************************************
136 * Run: interface thread
137 *****************************************************************************/
138 static void *Run( void *data )
140 intf_thread_t *p_intf = data;
141 SERVICE_TABLE_ENTRY dispatchTable[] =
143 { (LPTSTR)VLCSERVICENAME, &ServiceDispatch },
147 p_global_intf = p_intf;
148 p_intf->p_sys->psz_service = var_InheritString( p_intf, "ntservice-name" );
149 p_intf->p_sys->psz_service = p_intf->p_sys->psz_service ?
150 p_intf->p_sys->psz_service : strdup(VLCSERVICENAME);
152 if( var_InheritBool( p_intf, "ntservice-install" ) )
154 NTServiceInstall( p_intf );
158 if( var_InheritBool( p_intf, "ntservice-uninstall" ) )
160 NTServiceUninstall( p_intf );
164 if( StartServiceCtrlDispatcher( dispatchTable ) == 0 )
166 msg_Err( p_intf, "StartServiceCtrlDispatcher failed" ); /* str review */
169 free( p_intf->p_sys->psz_service );
171 /* Make sure we exit (In case other interfaces have been spawned) */
172 libvlc_Quit( p_intf->p_libvlc );
176 /*****************************************************************************
177 * NT Service utility functions
178 *****************************************************************************/
179 static int NTServiceInstall( intf_thread_t *p_intf )
181 intf_sys_t *p_sys = p_intf->p_sys;
182 char psz_path[10*MAX_PATH], psz_pathtmp[MAX_PATH], *psz_extra;
183 SC_HANDLE handle = OpenSCManager( NULL, NULL, SC_MANAGER_ALL_ACCESS );
187 "could not connect to Services Control Manager database" );
191 /* Find out the filename of ourselves so we can install it to the
192 * service control manager */
193 GetModuleFileName( NULL, psz_pathtmp, MAX_PATH );
194 sprintf( psz_path, "\"%s\" -I "MODULE_STRING, psz_pathtmp );
196 psz_extra = var_InheritString( p_intf, "ntservice-extraintf" );
199 strcat( psz_path, " --ntservice-extraintf " );
200 strcat( psz_path, psz_extra );
204 psz_extra = var_InheritString( p_intf, "ntservice-options" );
205 if( psz_extra && *psz_extra )
207 strcat( psz_path, " " );
208 strcat( psz_path, psz_extra );
213 CreateService( handle, p_sys->psz_service, p_sys->psz_service,
214 GENERIC_READ | GENERIC_EXECUTE,
215 SERVICE_WIN32_OWN_PROCESS,
216 SERVICE_AUTO_START, SERVICE_ERROR_IGNORE,
217 psz_path, NULL, NULL, NULL, NULL, NULL );
218 if( service == NULL )
220 if( GetLastError() != ERROR_SERVICE_EXISTS )
222 msg_Err( p_intf, "could not create new service: \"%s\" (%s)",
223 p_sys->psz_service ,psz_path );
224 CloseServiceHandle( handle );
229 msg_Warn( p_intf, "service \"%s\" already exists",
230 p_sys->psz_service );
235 msg_Warn( p_intf, "service successfuly created" );
238 if( service ) CloseServiceHandle( service );
239 CloseServiceHandle( handle );
244 static int NTServiceUninstall( intf_thread_t *p_intf )
246 intf_sys_t *p_sys = p_intf->p_sys;
248 SC_HANDLE handle = OpenSCManager( NULL, NULL, SC_MANAGER_ALL_ACCESS );
252 "could not connect to Services Control Manager database" );
256 /* First, open a handle to the service */
257 SC_HANDLE service = OpenService( handle, p_sys->psz_service, DELETE );
258 if( service == NULL )
260 msg_Err( p_intf, "could not open service" );
261 CloseServiceHandle( handle );
265 /* Remove the service */
266 if( !DeleteService( service ) )
268 msg_Err( p_intf, "could not delete service \"%s\"",
269 p_sys->psz_service );
273 msg_Dbg( p_intf, "service deleted successfuly" );
276 CloseServiceHandle( service );
277 CloseServiceHandle( handle );
282 static void WINAPI ServiceDispatch( DWORD numArgs, char **args )
286 intf_thread_t *p_intf = (intf_thread_t *)p_global_intf;
287 intf_sys_t *p_sys = p_intf->p_sys;
288 char *psz_modules, *psz_parser;
290 /* We have to initialize the service-specific stuff */
291 memset( &p_sys->status, 0, sizeof(SERVICE_STATUS) );
292 p_sys->status.dwServiceType = SERVICE_WIN32;
293 p_sys->status.dwCurrentState = SERVICE_START_PENDING;
294 p_sys->status.dwControlsAccepted = SERVICE_ACCEPT_STOP;
297 RegisterServiceCtrlHandler( p_sys->psz_service, &ServiceCtrlHandler );
298 if( p_sys->hStatus == (SERVICE_STATUS_HANDLE)0 )
300 msg_Err( p_intf, "failed to register service control handler" );
305 * Load background interfaces
307 psz_modules = var_InheritString( p_intf, "ntservice-extraintf" );
308 psz_parser = psz_modules;
309 while( psz_parser && *psz_parser )
311 char *psz_module, *psz_temp;
312 psz_module = psz_parser;
313 psz_parser = strchr( psz_module, ',' );
320 if( asprintf( &psz_temp, "%s,none", psz_module ) != -1 )
322 /* Try to create the interface */
323 if( intf_Create( p_intf, psz_temp ) )
325 msg_Err( p_intf, "interface \"%s\" initialization failed",
335 /* Initialization complete - report running status */
336 p_sys->status.dwCurrentState = SERVICE_RUNNING;
337 p_sys->status.dwCheckPoint = 0;
338 p_sys->status.dwWaitHint = 0;
340 SetServiceStatus( p_sys->hStatus, &p_sys->status );
343 static void WINAPI ServiceCtrlHandler( DWORD control )
345 intf_thread_t *p_intf = (intf_thread_t *)p_global_intf;
346 intf_sys_t *p_sys = p_intf->p_sys;
350 case SERVICE_CONTROL_SHUTDOWN:
351 case SERVICE_CONTROL_STOP:
352 p_sys->status.dwCurrentState = SERVICE_STOPPED;
353 p_sys->status.dwWin32ExitCode = 0;
354 p_sys->status.dwCheckPoint = 0;
355 p_sys->status.dwWaitHint = 0;
357 case SERVICE_CONTROL_INTERROGATE:
358 /* just set the current state to whatever it is... */
362 SetServiceStatus( p_sys->hStatus, &p_sys->status );