3 * Fixed edge case with CreateProcess().
5 Correctly handle the case where the application executable is under
6 a path which contains space and an executable sharing the initial
7 part of that path (up to a space) exists.
11 * Fixed failure to run on Windows versions prior to Vista.
15 * Read Application, AppDirectory and AppParameters before each restart so
16 a change to any one doesn't require restarting NSSM itself.
18 * Fixed messages not being sent to the event log correctly in some
21 * Try to handle (strictly incorrect) quotes in AppDirectory.
23 Windows directories aren't allowed to contain quotes so CreateProcess()
24 will fail if the AppDirectory is quoted. Note that it succeeds even if
25 Application itself is quoted as the application plus parameters are
26 interpreted as a command line.
28 * Fixed failed to write full arguments to AppParameters when
33 Back off from restarting the application immediately if it starts
34 successfully but exits too soon. The default value of "too soon" is
35 1500 milliseconds. This can be configured by adding a DWORD value
36 AppThrottle to the registry.
38 Handle resume messages from the service console to restart the
39 application immediately even if it is throttled.
41 * Try to kill the process tree gracefully.
43 Before calling TerminateProcess() on all processes assocatiated with
44 the monitored application, enumerate all windows and threads and
45 post appropriate messages to them. If the application bothers to
46 listen for such messages it has a chance to shut itself down gracefully.
50 * Handle missing registry values.
52 Warn if AppParameters is missing. Warn if AppDirectory is missing or
53 unset and choose a fallback directory.
54 First try to find the parent directory of the application. If that
55 fails, eg because the application path is just "notepad" or something,
56 start in the Windows directory.
58 * Kill process tree when stopping service.
60 Ensure that all child processes of the monitored application are
61 killed when the service stops by recursing through all running
62 processes and terminating those whose parent is the application
63 or one of its descendents.
67 * Removed incorrect ExpandEnvironmentStrings() error.
69 A log_event() call was inadvertently left in the code causing an error
70 to be set to the eventlog saying that ExpandEnvironmentStrings() had
71 failed when it had actually succeeded.
75 * Allow use of REG_EXPAND_SZ values in the registry.
77 * Don't suicide on exit status 0 by default.
79 Suiciding when the application exits 0 will cause recovery actions to be
80 taken. Usually this is inappropriate. Only suicide if there is an
81 explicit AppExit value for 0 in the registry.
83 Technically such behaviour could be abused to do something like run a
84 script after successful completion of a service but in most cases a
85 suicide is undesirable when no actual failure occurred.
87 * Don't hang if startup parameters couldn't be determined.
88 Instead, signal that the service entered the STOPPED state.
89 Set START_PENDING state prior to actual startup.
93 * Ensure systems recovery actions can happen.
95 In Windows versions earlier than Vista the service manager would only
96 consider a service failed (and hence eligible for recovery action) if
97 the service exited without setting its state to SERVICE_STOPPED, even if
98 it signalled an error exit code.
99 In Vista and later the service manager can be configured to treat a
100 graceful shutdown with error code as a failure but this is not the
103 Try to configure the service manager to use the new behaviour when
104 starting the service so users who set AppExit to Exit can use recovery
107 Also recognise the new AppExit option Suicide for use on pre-Vista
108 systems. When AppExit is Suicide don't stop the service but exit
109 inelegantly, which should be seen as a failure.
113 * Send properly formatted messages to the event log.
115 * Fixed truncation of very long path lengths in the registry.
119 * Decide how to handle application exit.
121 When the service exits with exit code n look in
122 HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters\AppExit\<n>,
123 falling back to the unnamed value if no such code is listed. Parse the
124 (string) value of this entry as follows:
126 Restart: Start the application again (NSSM default).
127 Ignore: Do nothing (srvany default).
128 Exit: Stop the service.
132 * Added support for building a 64-bit executable.
134 * Added project files for newer versions of Visual Studio.