Mirrors
/
nssm
mirror of http://git.nssm.cc/nssm/nssm.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '0f64692bef'
${ noResults }
nssm/registry.h

38 lines
1.7 KiB
C
Raw Normal View History Unescape Escape

NSSM 1.0.
22 years ago
#ifndef REGISTRY_H
#define REGISTRY_H
#define NSSM_REGISTRY "SYSTEM\\CurrentControlSet\\Services\\%s\\Parameters"
#define NSSM_REG_EXE "Application"
#define NSSM_REG_FLAGS "AppParameters"
#define NSSM_REG_DIR "AppDirectory"
Support srvany's AppEnvironment registry value. Allow setting one or more environment variables for the application by creating the AppEnvironment value of type REG_MULTI_SZ. Each string should be of the form KEY=VALUE. VALUE may be omitted to set an empty environment variable but the equals sign must be present. This support is for compatibility with srvany. In accordance with the documented behaviour of srvany, only environment variables specified in AppEnvironment will be passed to the service. Any other variables, even system variables such as %PATH%, will be ignored if they are not explicitly listed. Note that Windows supports adding environment variables to the service's existing environment by creating the Environment value (also of type REG_MULTI_SZ) under HKLM\SYSTEM\CurrentControlSet\Services\<service> instead. It is recommended that new services use this standard functionality rather than AppEnvironment. Thanks Rob Sharp.
13 years ago
#define NSSM_REG_ENV "AppEnvironment"
Decide how to handle application exit. When the service exits with exit code n look in HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters\AppExit\<n>, falling back to the unnamed value if no such code is listed. Parse the (string) value of this entry as follows: Restart: Start the application again (NSSM default). Ignore: Do nothing (srvany default). Exit: Stop the service.
15 years ago
#define NSSM_REG_EXIT "AppExit"
Allow configuring throttling threshold. Tweak minimum time for which a service must run by setting the threshold number of milliseconds in AppThrottle (REG_DWORD).
14 years ago
#define NSSM_REG_THROTTLE "AppThrottle"
Skip some or all methods of stopping the application. Use the AppStopMethodSkip bit field to specify any method(s) which should not be employed when stopping the application.
11 years ago
#define NSSM_REG_STOP_METHOD_SKIP "AppStopMethodSkip"
Allow overriding time to wait when trying to kill the application. Three new registry entries can be used to specify a wait time in milliseconds after attempting a stop method. AppStopMethodConsole AppStopMethodWindow AppStopMethodThreads The default for each remains the same, 1500ms. Thanks Russ Holmann.
11 years ago
#define NSSM_REG_KILL_CONSOLE_GRACE_PERIOD "AppStopMethodConsole"
#define NSSM_REG_KILL_WINDOW_GRACE_PERIOD "AppStopMethodWindow"
#define NSSM_REG_KILL_THREADS_GRACE_PERIOD "AppStopMethodThreads"
Allow specifying output streams. Allow starting the monitor application with one or more of stdin, stdout and stderr redirected to a file or anything which can be opened with CreateFile(). New registry values corresponding to CreateFile() arguments for stdin (and analogously for stdout and stderr): AppStdin: Path to open. AppStdinShareMode: Sharing mode. AppStdinCreationDisposition: Creation disposition. AppStdinFlagsAndAtrributes: Flags and attributes. All are optional. If no path is given for a particular stream it will not be redirected. If a path is given but any of the other values are omitted they will receive sensible defaults.
12 years ago
#define NSSM_REG_STDIN "AppStdin"
#define NSSM_REG_STDOUT "AppStdout"
#define NSSM_REG_STDERR "AppStderr"
#define NSSM_REG_STDIO_SHARING "ShareMode"
#define NSSM_REG_STDIO_DISPOSITION "CreationDisposition"
#define NSSM_REG_STDIO_FLAGS "FlagsAndAttributes"
#define NSSM_STDIO_LENGTH 29
NSSM 1.0.
22 years ago
Compile messages. Don't spam the event log with warnings about not finding application messages. Every message currently uses the default event ID 1.
15 years ago
int create_messages();
NSSM 1.0.
22 years ago
int create_parameters(char *, char *, char *, char *);
Decide how to handle application exit. When the service exits with exit code n look in HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters\AppExit\<n>, falling back to the unnamed value if no such code is listed. Parse the (string) value of this entry as follows: Restart: Start the application again (NSSM default). Ignore: Do nothing (srvany default). Exit: Stop the service.
15 years ago
int create_exit_action(char *, const char *);
Support srvany's AppEnvironment registry value. Allow setting one or more environment variables for the application by creating the AppEnvironment value of type REG_MULTI_SZ. Each string should be of the form KEY=VALUE. VALUE may be omitted to set an empty environment variable but the equals sign must be present. This support is for compatibility with srvany. In accordance with the documented behaviour of srvany, only environment variables specified in AppEnvironment will be passed to the service. Any other variables, even system variables such as %PATH%, will be ignored if they are not explicitly listed. Note that Windows supports adding environment variables to the service's existing environment by creating the Environment value (also of type REG_MULTI_SZ) under HKLM\SYSTEM\CurrentControlSet\Services\<service> instead. It is recommended that new services use this standard functionality rather than AppEnvironment. Thanks Rob Sharp.
13 years ago
int set_environment(char *, HKEY, char **);
Overload expand_parameter() like get_number(). Allow expand_parameter() to accept the optional must_exist flag.
12 years ago
int expand_parameter(HKEY, char *, char *, unsigned long, bool, bool);
Strip quotes from directory name. Windows directories aren't allowed to contain quotes so CreateProcess() will fail if the AppDirectory is quoted. Note that it succeeds even if Application itself is quoted as the application plus parameters are interpreted as a command line.
14 years ago
int expand_parameter(HKEY, char *, char *, unsigned long, bool);
Added set_expand_string() and set_number(). Helper functions to set REG_EXPAND_SZ and REG_DWORD values in the registry.
11 years ago
int set_expand_string(HKEY, char *, char *);
int set_number(HKEY, char *, unsigned long);
Added get_number() helper. Retrieve a number (specifically an unsigned long) from the registry. Allow the value to be optional by setting the must_exist parameter. Overload the function definition such that must_exist can be omitted.
12 years ago
int get_number(HKEY, char *, unsigned long *, bool);
int get_number(HKEY, char *, unsigned long *);
Added override_milliseconds() helper. Helper function to retrieve a REG_DWORD value from the registry and assign it to a variable, substituting a default value if the registry entry is invalid or missing. The function is specifically tailored toward setting a value in milliseconds, hence the name.
11 years ago
void override_milliseconds(char *, HKEY, char *, unsigned long *, unsigned long, unsigned long);
Allow overriding time to wait when trying to kill the application. Three new registry entries can be used to specify a wait time in milliseconds after attempting a stop method. AppStopMethodConsole AppStopMethodWindow AppStopMethodThreads The default for each remains the same, 1500ms. Thanks Russ Holmann.
11 years ago
int get_parameters(char *, char *, unsigned long, char *, unsigned long, char *, unsigned long, char **, unsigned long *, unsigned long *, unsigned long *, unsigned long *, unsigned long *, STARTUPINFO *);
Don't suicide on exit status 0. Suiciding when the application exits 0 will cause recovery actions to be taken. Usually this is inappropriate. Only suicide if there is an explicit AppExit value for 0 in the registry. Technically such behaviour could be abused to do something like run a script after successful completion of a service but in most cases a suicide is undesirable when no actual failure occurred.
15 years ago
int get_exit_action(char *, unsigned long *, unsigned char *, bool *);
NSSM 1.0.
22 years ago
#endif