ChangeLog.txt

   1 Changes since 2.21\r
   2 ------------------\r
   3   * Existing services can now be managed using the GUI\r
   4     or on the command line.\r
   5 \r
   6   * NSSM can now set the priority class and processor\r
   7     affinity of the managed application.\r
   8 \r
   9   * NSSM can now apply an unconditional delay before\r
  10     restarting the application.\r
  11 \r
  12   * NSSM can now optionally rotate existing files when\r
  13     redirecting I/O.\r
  14 \r
  15   * Unqualified path names are now relative to the\r
  16     application startup directory when redirecting I/O.\r
  17 \r
  18   * NSSM can now set the service display name, description,\r
  19     startup type and log on details.\r
  20 \r
  21   * All services now receive a standard console window,\r
  22     allowing them to read input correctly (if running in\r
  23     interactive mode).\r
  24 \r
  25 Changes since 2.20\r
  26 ------------------\r
  27   * Services installed from the GUI no longer have incorrect\r
  28     AppParameters set in the registry.\r
  29 \r
  30 Changes since 2.19\r
  31 ------------------\r
  32   * Services installed from the commandline without using the\r
  33     GUI no longer have incorrect AppStopMethod* registry\r
  34     entries set.\r
  35 \r
  36 Changes since 2.18\r
  37 ------------------\r
  38   * Support AppEnvironmentExtra to append to the environment\r
  39     instead of replacing it.\r
  40 \r
  41   * The GUI is significantly less sucky.\r
  42 \r
  43 Changes since 2.17\r
  44 ------------------\r
  45   * Timeouts for each shutdown method can be configured in\r
  46     the registry.\r
  47 \r
  48   * The GUI is slightly less sucky.\r
  49 \r
  50 Changes since 2.16\r
  51 ------------------\r
  52   * NSSM can now redirect the service's I/O streams to any path\r
  53     capable of being opened by CreateFile().\r
  54 \r
  55   * Allow building on Visual Studio Express.\r
  56 \r
  57   * Silently ignore INTERROGATE control.\r
  58 \r
  59   * Try to send Control-C events to console applications when\r
  60     shutting them down.\r
  61 \r
  62 Changes since 2.15\r
  63 ------------------\r
  64   * Fixed case where NSSM could kill unrelated processes when\r
  65     shutting down.\r
  66 \r
  67 Changes since 2.14\r
  68 ------------------\r
  69   * NSSM is now translated into Italian.\r
  70 \r
  71   * Fixed GUI not allowing paths longer than 256 characters.\r
  72 \r
  73 Changes since 2.13\r
  74 ------------------\r
  75   * Fixed default GUI language being French not English.\r
  76 \r
  77 Changes since 2.12\r
  78 ------------------\r
  79   * Fixed failure to run on Windows 2000.\r
  80 \r
  81 Changes since 2.11\r
  82 ------------------\r
  83   * NSSM is now translated into French.\r
  84 \r
  85   * Really ensure systems recovery actions can happen.\r
  86 \r
  87     The change supposedly introduced in v2.4 to allow service recovery\r
  88     actions to be activated when the application exits gracefully with\r
  89     a non-zero error code didn't actually work.\r
  90 \r
  91 Changes since 2.10\r
  92 ------------------\r
  93   * Support AppEnvironment for compatibility with srvany.\r
  94 \r
  95 Changes since 2.9\r
  96 -----------------\r
  97   * Fixed failure to compile messages.mc in paths containing spaces.\r
  98 \r
  99   * Fixed edge case with CreateProcess().\r
 100 \r
 101     Correctly handle the case where the application executable is under\r
 102     a path which contains space and an executable sharing the initial\r
 103     part of that path (up to a space) exists.\r
 104 \r
 105 Changes since 2.8\r
 106 -----------------\r
 107   * Fixed failure to run on Windows versions prior to Vista.\r
 108 \r
 109 Changes since 2.7\r
 110 -----------------\r
 111   * Read Application, AppDirectory and AppParameters before each restart so\r
 112     a change to any one doesn't require restarting NSSM itself.\r
 113 \r
 114   * Fixed messages not being sent to the event log correctly in some\r
 115     cases.\r
 116 \r
 117   * Try to handle (strictly incorrect) quotes in AppDirectory.\r
 118 \r
 119     Windows directories aren't allowed to contain quotes so CreateProcess()\r
 120     will fail if the AppDirectory is quoted.  Note that it succeeds even if\r
 121     Application itself is quoted as the application plus parameters are\r
 122     interpreted as a command line.\r
 123 \r
 124   * Fixed failed to write full arguments to AppParameters when\r
 125     installing a service.\r
 126 \r
 127   * Throttle restarts.\r
 128 \r
 129     Back off from restarting the application immediately if it starts\r
 130     successfully but exits too soon.  The default value of "too soon" is\r
 131     1500 milliseconds.  This can be configured by adding a DWORD value\r
 132     AppThrottle to the registry.\r
 133     \r
 134     Handle resume messages from the service console to restart the\r
 135     application immediately even if it is throttled.\r
 136 \r
 137   * Try to kill the process tree gracefully.\r
 138 \r
 139     Before calling TerminateProcess() on all processes assocatiated with\r
 140     the monitored application, enumerate all windows and threads and\r
 141     post appropriate messages to them.  If the application bothers to\r
 142     listen for such messages it has a chance to shut itself down gracefully.\r
 143 \r
 144 Changes since 2.6\r
 145 -----------------\r
 146   * Handle missing registry values.\r
 147 \r
 148     Warn if AppParameters is missing.  Warn if AppDirectory is missing or\r
 149     unset and choose a fallback directory.\r
 150     First try to find the parent directory of the application.  If that\r
 151     fails, eg because the application path is just "notepad" or something,\r
 152     start in the Windows directory.\r
 153 \r
 154   * Kill process tree when stopping service.\r
 155 \r
 156     Ensure that all child processes of the monitored application are\r
 157     killed when the service stops by recursing through all running\r
 158     processes and terminating those whose parent is the application\r
 159     or one of its descendents.\r
 160 \r
 161 Changes since 2.5\r
 162 -----------------\r
 163   * Removed incorrect ExpandEnvironmentStrings() error.\r
 164 \r
 165     A log_event() call was inadvertently left in the code causing an error\r
 166     to be set to the eventlog saying that ExpandEnvironmentStrings() had\r
 167     failed when it had actually succeeded.\r
 168 \r
 169 Changes since 2.4\r
 170 -----------------\r
 171   * Allow use of REG_EXPAND_SZ values in the registry.\r
 172 \r
 173   * Don't suicide on exit status 0 by default.\r
 174 \r
 175     Suiciding when the application exits 0 will cause recovery actions to be\r
 176     taken.  Usually this is inappropriate.  Only suicide if there is an\r
 177     explicit AppExit value for 0 in the registry.\r
 178     \r
 179     Technically such behaviour could be abused to do something like run a\r
 180     script after successful completion of a service but in most cases a\r
 181     suicide is undesirable when no actual failure occurred.\r
 182 \r
 183   * Don't hang if startup parameters couldn't be determined.\r
 184     Instead, signal that the service entered the STOPPED state.\r
 185     Set START_PENDING state prior to actual startup.\r
 186 \r
 187 Changes since 2.3\r
 188 -----------------\r
 189   * Ensure systems recovery actions can happen.\r
 190 \r
 191     In Windows versions earlier than Vista the service manager would only\r
 192     consider a service failed (and hence eligible for recovery action) if\r
 193     the service exited without setting its state to SERVICE_STOPPED, even if\r
 194     it signalled an error exit code.\r
 195     In Vista and later the service manager can be configured to treat a\r
 196     graceful shutdown with error code as a failure but this is not the\r
 197     default behaviour.\r
 198 \r
 199     Try to configure the service manager to use the new behaviour when\r
 200     starting the service so users who set AppExit to Exit can use recovery\r
 201     actions as expected.\r
 202 \r
 203     Also recognise the new AppExit option Suicide for use on pre-Vista\r
 204     systems.  When AppExit is Suicide don't stop the service but exit\r
 205     inelegantly, which should be seen as a failure.\r
 206 \r
 207 Changes since 2.2\r
 208 -----------------\r
 209   * Send properly formatted messages to the event log.\r
 210 \r
 211   * Fixed truncation of very long path lengths in the registry.\r
 212 \r
 213 Changes since 2.1\r
 214 -----------------\r
 215  *  Decide how to handle application exit.\r
 216 \r
 217     When the service exits with exit code n look in\r
 218     HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters\AppExit\<n>,\r
 219     falling back to the unnamed value if no such code is listed.  Parse the\r
 220     (string) value of this entry as follows:\r
 221 \r
 222         Restart: Start the application again (NSSM default).\r
 223         Ignore:  Do nothing (srvany default).\r
 224         Exit:    Stop the service.\r
 225 \r
 226 Changes since 2.0\r
 227 -----------------\r
 228   * Added support for building a 64-bit executable.\r
 229 \r
 230   * Added project files for newer versions of Visual Studio.\r