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 '277723e318'
${ noResults }
nssm/nssm.h

67 lines
1.8 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>
Pass parameters around in a data structure. Instead of static variables and functions taking a dozen arguments we now use a single data structure, nssm_service_t, for the service. The code is easier to read and understand, especially when adding more variables through to functions.
11 years ago
#include "service.h"
NSSM 1.0.
22 years ago
#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 "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
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)
GUI overhaul. We now have a much less sucky GUI with tabs, combo boxes and all sorts of whizzbang stuff. The new GUI allows setting most of the advanced features we support directly from the service installer without having to poke about in the registry.
11 years ago
/* Exit actions. */
#define NSSM_EXIT_RESTART 0
#define NSSM_EXIT_IGNORE 1
#define NSSM_EXIT_REALLY 2
#define NSSM_EXIT_UNCLEAN 3
#define NSSM_NUM_EXIT_ACTIONS 4
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