NSSM 2.15.
[nssm.git] / README.txt
index 88a7290..3a31833 100644 (file)
@@ -1,5 +1,5 @@
 NSSM: The Non-Sucking Service Manager\r
-Version 2.7, 2011-01-25\r
+Version 2.15, 2012-07-19\r
 \r
 NSSM is a service helper program similar to srvany and cygrunsrv.  It can \r
 start any application as an NT service and will restart the service if it \r
@@ -9,7 +9,7 @@ NSSM also has a graphical service installer and remover.
 \r
 Full documentation can be found online at\r
 \r
-                           http://iain.cx/src/nssm/\r
+                              http://nssm.cc/\r
 \r
 Since version 2.0, the GUI can be bypassed by entering all appropriate \r
 options on the command line.\r
@@ -24,6 +24,17 @@ Since version 2.3, NSSM logs to the Windows event log more elegantly.
 \r
 Since version 2.5, NSSM respects environment variables in its parameters.\r
 \r
+Since version 2.8, NSSM tries harder to shut down the managed application\r
+gracefully and throttles restart attempts if the application doesn't run\r
+for a minimum amount of time.\r
+\r
+Since version 2.11, NSSM respects srvany's AppEnvironment parameter.\r
+\r
+Since version 2.13, NSSM is translated into French.\r
+Thanks François-Régis Tardy.\r
+\r
+Since version 2.15, NSSM is translated into Italian.\r
+Thanks Riccardo Gusmeroli.\r
 \r
 Usage\r
 -----\r
@@ -72,11 +83,17 @@ keep trying, pausing between each attempt, until the service is successfully
 started or you send it a stop signal.\r
 \r
 NSSM will pause an increasingly longer time between subsequent restart attempts\r
-if the service fails to start in a timely manner, up to a maximum of 60 seconds.\r
-This is so it does not consume an excessive amount of CPU time trying to start\r
-a failed application over and over again.  If you identify the cause of the\r
-failure and don't want to wait you can use the Windows service console to\r
-send a continue signal to NSSM and it will retry within a few seconds.\r
+if the service fails to start in a timely manner, up to a maximum of four\r
+minutes.  This is so it does not consume an excessive amount of CPU time trying\r
+to start a failed application over and over again.  If you identify the cause\r
+of the failure and don't want to wait you can use the Windows service console\r
+(where the service will be shown in Paused state) to send a continue signal to\r
+NSSM and it will retry within a few seconds.\r
+\r
+By default, NSSM defines "a timely manner" to be within 1500 milliseconds.\r
+You can change the threshold for the service by setting the number of\r
+milliseconds as a REG_DWORD value in the registry at\r
+HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters\AppThrottle.\r
 \r
 NSSM will look in the registry under\r
 HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters\AppExit for\r
@@ -159,6 +176,9 @@ Building NSSM from source
 NSSM is known to compile with Visual Studio 6, Visual Studio 2005 and Visual\r
 Studio 2008.\r
 \r
+NSSM will also compile with Visual Studio 2010 but the resulting executable\r
+will not run on versions of Windows older than XP SP2.\r
+\r
 \r
 Credits\r
 -------\r
@@ -168,7 +188,16 @@ Thanks to Joel Reingold for spotting a command line truncation bug.
 Thanks to Arve Knudsen for spotting that child processes of the monitored\r
 application could be left running on service shutdown, and that a missing\r
 registry value for AppDirectory confused NSSM.\r
-Thanks to Peter Wagemans and Laszlo Kereszt for suggesting throttling restarts.\r
+Thanks to Peter Wagemans and Laszlo Keresztfalvi for suggesting throttling restarts.\r
+Thanks to Eugene Lifshitz for finding an edge case in CreateProcess() and for\r
+advising how to build messages.mc correctly in paths containing spaces.\r
+Thanks to Rob Sharp for pointing out that NSSM did not respect the\r
+AppEnvironment registry value used by srvany.\r
+Thanks to Szymon Nowak for help with Windows 2000 compatibility.\r
+Thanks to François-Régis Tardy for French translation.\r
+Thanks to Emilio Frini for spotting that French was inadvertently set as\r
+the default language when the user's display language was not translated.\r
+Thanks to Riccardo Gusmeroli for Italian translation.\r
 \r
 Licence\r
 -------\r