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/nssm.h

73 lines
2.1 KiB
C
Raw Normal View History Unescape Escape

NSSM 1.0.
22 years ago
#ifndef NSSM_H
#define NSSM_H
#define _WIN32_WINNT 0x0500
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
#include <shlwapi.h>
NSSM 1.0.
22 years ago
#include <stdarg.h>
#include <stdio.h>
#include <windows.h>
#include "event.h"
AttachConsole() isn't available in Windows 2000. Instead of calling AttachConsole() directory use a function pointer in the new global imports struct. It's safe to skip any attempt to attach to the console when the function isn't available.
11 years ago
#include "imports.h"
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
#include "messages.h"
Kill process tree when stopping service. Ensure that all child processes of the monitored application are killed when the service stops by recursing through all running processes and terminating those whose parent is the application or one of its descendents.
14 years ago
#include "process.h"
NSSM 1.0.
22 years ago
#include "registry.h"
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
#include "io.h"
NSSM 1.0.
22 years ago
#include "service.h"
#include "gui.h"
NSSM 2.0.
19 years ago
int str_equiv(const char *, const char *);
NSSM 1.0.
22 years ago
#define NSSM "nssm"
NSSM 2.18.
11 years ago
#define NSSM_VERSION "2.18"
#define NSSM_VERSIONINFO 2,18,0,0
#define NSSM_DATE "2013-11-15"
NSSM 1.0.
22 years ago
Fix path lengths. Some buffers were being limited to MAX_PATH characters when higher limits were more appropriate. For example the maximum length of a command line is documented as 32768 characters with the application name part limited to MAX_PATH. Long applications paths and arguments could be truncated when written to the registry. Thanks Joel Reingold.
15 years ago
/*
MSDN says the commandline in CreateProcess() is limited to 32768 characters
and the application name to MAX_PATH.
A registry key is limited to 255 characters.
A registry value is limited to 16383 characters.
Therefore we limit the service name to accommodate the path under HKLM.
*/
#define EXE_LENGTH MAX_PATH
#define CMD_LENGTH 32768
#define KEY_LENGTH 255
#define VALUE_LENGTH 16383
#define SERVICE_NAME_LENGTH KEY_LENGTH - 55
Throttle restarts. Back off from restarting the application immediately if it starts successfully but exits too soon. Handle resume messages from the service console to restart the application immediately even if it is throttled. Use service status wait hints to tell the operating system how long start, stop and resume actions are likely to take.
14 years ago
/*
Throttle the restart of the service if it stops before this many
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
milliseconds have elapsed since startup. Override in registry.
Throttle restarts. Back off from restarting the application immediately if it starts successfully but exits too soon. Handle resume messages from the service console to restart the application immediately even if it is throttled. Use service status wait hints to tell the operating system how long start, stop and resume actions are likely to take.
14 years ago
*/
#define NSSM_RESET_THROTTLE_RESTART 1500
Try to send Control-C event to application console. Try to attach to the application's console and send a Control-C event when shutting down. If a console exists, is successfully attached and successfully sent the event, allow a grace period for the application to exit before sending window messages or eventually calling TerminateProcess(). Now console applications which register shutdown handlers, such as java launched from a batch file, have a chance to clean up and shut down gracefully. Thanks Eric Cheldelin.
12 years ago
/*
How many milliseconds to wait for the application to die after sending
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
a Control-C event to its console. Override in registry.
Try to send Control-C event to application console. Try to attach to the application's console and send a Control-C event when shutting down. If a console exists, is successfully attached and successfully sent the event, allow a grace period for the application to exit before sending window messages or eventually calling TerminateProcess(). Now console applications which register shutdown handlers, such as java launched from a batch file, have a chance to clean up and shut down gracefully. Thanks Eric Cheldelin.
12 years ago
*/
#define NSSM_KILL_CONSOLE_GRACE_PERIOD 1500
Try to kill the process tree gracefully. Before calling TerminateProcess() on all processes assocatiated with the monitored application, enumerate all windows and threads and post appropriate messages to them. If the application bothers to listen for such messages it has a chance to shut itself down gracefully. If the application ignores this chance to do the right thing it's fair game for termination.
14 years ago
/*
How many milliseconds to wait for the application to die after posting to
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
its windows' message queues. Override in registry.
Try to kill the process tree gracefully. Before calling TerminateProcess() on all processes assocatiated with the monitored application, enumerate all windows and threads and post appropriate messages to them. If the application bothers to listen for such messages it has a chance to shut itself down gracefully. If the application ignores this chance to do the right thing it's fair game for termination.
14 years ago
*/
#define NSSM_KILL_WINDOW_GRACE_PERIOD 1500
/*
How many milliseconds to wait for the application to die after posting to
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
its threads' message queues. Override in registry.
Try to kill the process tree gracefully. Before calling TerminateProcess() on all processes assocatiated with the monitored application, enumerate all windows and threads and post appropriate messages to them. If the application bothers to listen for such messages it has a chance to shut itself down gracefully. If the application ignores this chance to do the right thing it's fair game for termination.
14 years ago
*/
#define NSSM_KILL_THREADS_GRACE_PERIOD 1500
Throttle restarts. Back off from restarting the application immediately if it starts successfully but exits too soon. Handle resume messages from the service console to restart the application immediately even if it is throttled. Use service status wait hints to tell the operating system how long start, stop and resume actions are likely to take.
14 years ago
/* Margin of error for service status wait hints in milliseconds. */
#define NSSM_WAITHINT_MARGIN 2000
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
/* Methods used to try to stop the application. */
#define NSSM_STOP_METHOD_CONSOLE (1 << 0)
#define NSSM_STOP_METHOD_WINDOW (1 << 1)
#define NSSM_STOP_METHOD_THREADS (1 << 2)
#define NSSM_STOP_METHOD_TERMINATE (1 << 3)
Added await_shutdown() function. The system expects service STOP requests to be honoured promptly. If service shutdown will take longer than 30 seconds we must update the service status checkpoint variable before then. We also need to ensure that the service status wait hint time is strictly increasing every time we update the checkpoint, otherwise the service will be considered to be hung after 60 seconds.
11 years ago
/* How many milliseconds to wait before updating service status. */
Enforce maximum report delay when starting service. We were not changing the service's state to running until the restart throttling threshold had passed. However best practice is to change the status to running or stopped as quickly as possible. Therefore we we now report the status after no more than 20000 milliseconds regardless of the throttle setting.
11 years ago
#define NSSM_SERVICE_STATUS_DEADLINE 20000
Added await_shutdown() function. The system expects service STOP requests to be honoured promptly. If service shutdown will take longer than 30 seconds we must update the service status checkpoint variable before then. We also need to ensure that the service status wait hint time is strictly increasing every time we update the checkpoint, otherwise the service will be considered to be hung after 60 seconds.
11 years ago
NSSM 1.0.
22 years ago
#endif