programs/services/services.h

   1 /*
   2  * Services.exe - include file
   3  *
   4  * Copyright 2007 Google (Mikolaj Zalewski)
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #ifndef WINE_PROGRAMS_UTILS_H_
  22 #define WINE_PROGRAMS_UTILS_H_
  23
  24 #include "wine/list.h"
  25
  26 struct scmdatabase
  27 {
  28     HKEY root_key;
  29     LONG service_start_lock;
  30     struct list services;
  31     CRITICAL_SECTION cs;
  32 };
  33
  34 struct service_entry
  35 {
  36     struct list entry;
  37     struct scmdatabase *db;
  38     LONG ref_count;                    /* number of references - if goes to zero and the service is deleted the structure will be freed */
  39     LPWSTR name;
  40     SERVICE_STATUS_PROCESS status;
  41     QUERY_SERVICE_CONFIGW config;
  42     DWORD preshutdown_timeout;
  43     LPWSTR description;
  44     LPWSTR dependOnServices;
  45     LPWSTR dependOnGroups;
  46     HANDLE process;
  47     HANDLE control_mutex;
  48     HANDLE control_pipe;
  49     HANDLE overlapped_event;
  50     HANDLE status_changed_event;
  51 };
  52
  53 extern struct scmdatabase *active_database;
  54
  55 /* SCM database functions */
  56
  57 struct service_entry *scmdatabase_find_service(struct scmdatabase *db, LPCWSTR name);
  58 struct service_entry *scmdatabase_find_service_by_displayname(struct scmdatabase *db, LPCWSTR name);
  59 DWORD scmdatabase_add_service(struct scmdatabase *db, struct service_entry *entry);
  60 DWORD scmdatabase_remove_service(struct scmdatabase *db, struct service_entry *entry);
  61
  62 DWORD scmdatabase_lock_startup(struct scmdatabase *db);
  63 void scmdatabase_unlock_startup(struct scmdatabase *db);
  64
  65 void scmdatabase_lock_shared(struct scmdatabase *db);
  66 void scmdatabase_lock_exclusive(struct scmdatabase *db);
  67 void scmdatabase_unlock(struct scmdatabase *db);
  68
  69 /* Service functions */
  70
  71 DWORD service_create(LPCWSTR name, struct service_entry **entry);
  72 BOOL validate_service_name(LPCWSTR name);
  73 BOOL validate_service_config(struct service_entry *entry);
  74 DWORD save_service_config(struct service_entry *entry);
  75 void free_service_entry(struct service_entry *entry);
  76 void release_service(struct service_entry *service);
  77 void service_lock_shared(struct service_entry *service);
  78 void service_lock_exclusive(struct service_entry *service);
  79 void service_unlock(struct service_entry *service);
  80 DWORD service_start(struct service_entry *service, DWORD service_argc, LPCWSTR *service_argv);
  81 void service_terminate(struct service_entry *service);
  82 BOOL service_send_command( struct service_entry *service, HANDLE pipe,
  83                            const void *data, DWORD size, DWORD *result );
  84
  85 extern HANDLE g_hStartedEvent;
  86
  87 extern DWORD service_pipe_timeout;
  88 extern DWORD service_kill_timeout;
  89
  90 DWORD RPC_Init(void);
  91 DWORD RPC_MainLoop(void);
  92
  93 /* from utils.c */
  94 LPWSTR strdupW(LPCWSTR str);
  95
  96 BOOL check_multisz(LPCWSTR lpMultiSz, DWORD cbSize);
  97
  98 DWORD load_reg_string(HKEY hKey, LPCWSTR szValue, BOOL bExpand, LPWSTR *output);
  99 DWORD load_reg_multisz(HKEY hKey, LPCWSTR szValue, BOOL bAllowSingle, LPWSTR *output);
 100 DWORD load_reg_dword(HKEY hKey, LPCWSTR szValue, DWORD *output);
 101
 102 static inline LPCWSTR get_display_name(struct service_entry *service)
 103 {
 104     return service->config.lpDisplayName ? service->config.lpDisplayName : service->name;
 105 }
 106
 107 static inline BOOL is_marked_for_delete(struct service_entry *service)
 108 {
 109     return service->entry.next == NULL;
 110 }
 111
 112 #endif /*WINE_PROGRAMS_UTILS_H_*/