X-Git-Url: http://git.iain.cx/?a=blobdiff_plain;f=README.txt;h=904468ae4da1418a95f22184757d7d5b84629c30;hb=0b386fc1984ab74ee59b7bed14b7e8f57212c22b;hp=0d8026f6416647d62f44e390fdd2d066c93dee3a;hpb=5e7f7c21e254ba722d5d0d08c154792b82cf3f1d;p=nssm.git

diff --git a/README.txt b/README.txt
index 0d8026f..904468a 100644
--- a/README.txt
+++ b/README.txt
@@ -1,5 +1,5 @@
 NSSM: The Non-Sucking Service Manager
-Version 2.14, 2012-05-24
+Version 2.16, 2012-12-01
 
 NSSM is a service helper program similar to srvany and cygrunsrv.  It can 
 start any application as an NT service and will restart the service if it 
@@ -33,6 +33,17 @@ Since version 2.11, NSSM respects srvany's AppEnvironment parameter.
 Since version 2.13, NSSM is translated into French.
 Thanks François-Régis Tardy.
 
+Since version 2.15, NSSM is translated into Italian.
+Thanks Riccardo Gusmeroli.
+
+Since version 2.17, NSSM can try to shut down console applications by
+simulating a Control-C keypress.  If they have installed a handler routine
+they can clean up and shut down gracefully on receipt of the event.
+
+Since version 2.17, NSSM can redirect the managed application's I/O streams
+to an arbitrary path.
+
+
 Usage
 -----
 In the usage notes below, arguments to the program may be written in angle 
@@ -66,6 +77,9 @@ with the given options (if you specified any).
 
 Don't forget to enclose paths in "quotes" if they contain spaces!
 
+If you want to include quotes in the options you will need to """quote""" the
+quotes.
+
 
 Managing the service
 --------------------
@@ -126,6 +140,33 @@ request to suicide if you explicitly configure a registry key for exit code 0.
 If only the default action is set to Suicide NSSM will instead exit gracefully.
 
 
+I/O redirection
+---------------
+NSSM can redirect the managed application's I/O to any path capable of being
+opened by CreateFile().  This enables, for example, capturing the log output
+of an application which would otherwise only write to the console or accepting
+input from a serial port.
+
+NSSM will look in the registry under
+HKLM\SYSTEM\CurrentControlSet\Services\<service>\Parameters for the keys
+corresponding to arguments to CreateFile().  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 be receive sensible defaults.
+
+  AppStdin: Path to receive input.
+  AppStdout: Path to receive output.
+  AppStderr: Path to receive error output.
+
+Parameters for CreateFile() are providing with the "AppStdinShareMode",
+"AppStdinCreationDisposition" and "AppStdinFlagsAndAttributes" values (and
+analogously for stdout and stderr).
+
+In general, if you want the service to log its output, set AppStdout and
+AppStderr to the same path, eg C:\Users\Public\service.log, and it should
+work.  Remember, however, that the path must be accessible to the user
+running the service.
+
+
 Removing services using the GUI
 -------------------------------
 NSSM can also remove services.  Run
@@ -194,6 +235,10 @@ Thanks to Szymon Nowak for help with Windows 2000 compatibility.
 Thanks to François-Régis Tardy for French translation.
 Thanks to Emilio Frini for spotting that French was inadvertently set as
 the default language when the user's display language was not translated.
+Thanks to Riccardo Gusmeroli for Italian translation.
+Thanks to Eric Cheldelin for the inspiration to generate a Control-C event
+on shutdown.
+Thanks to Brian Baxter for suggesting how to escape quotes from the command prompt.
 
 Licence
 -------