Alow prefixing log output with a timestamp.

[nssm.git] / README.txt

diff --git a/README.txt b/README.txt
index f8906d3..fc5121e 100644 (file)
--- a/README.txt
+++ b/README.txt
@@ -72,6 +72,8 @@ Since version 2.25, NSSM can list services it manages.
 \r
 Since version 2.25, NSSM can dump the configuration of services it manages.\r
 \r
+Since version 2.25, NSSM can show the processes managed by a service.\r
+\r
 \r
 Usage\r
 -----\r
@@ -369,6 +371,21 @@ error-prone than simply redirecting the I/O streams before launching the
 application.  Therefore online rotation is not enabled by default.\r
 \r
 \r
+Timestamping output\r
+-------------------\r
+When redirecting output, NSSM can prefix each line of output with a\r
+millisecond-precision timestamp, for example:\r
+\r
+    2016-09-06 10:17:09.451 Pipeline main started\r
+\r
+To enable timestamp prefixing, set AppTimestampLog to a non-zero value.\r
+\r
+The prefix applies to both stdout and stderr.  Prefixing requires\r
+intercepting the application's I/O in the same way that online rotation\r
+does.  If log rotation and timestamp prefixing are both enabled, the\r
+rotation will be online.\r
+\r
+\r
 Environment variables\r
 ---------------------\r
 NSSM can replace or append to the managed application's environment.  Two\r
@@ -788,6 +805,7 @@ parameter can be omitted when using them:
   "LocalSystem" aka "System" aka "NT Authority\System"\r
   "LocalService" aka "Local Service" aka "NT Authority\Local Service"\r
   "NetworkService" aka "Network Service" aka "NT Authority\Network Service"\r
+  Virtual service account "NT Service\<servicename>"\r
 \r
 \r
 The Start parameter is used to query or set the startup type of the service.\r
@@ -868,6 +886,21 @@ The following command will print the names of all services managed by NSSM:
 \r
     nssm list\r
 \r
+To see all services on the system, not just NSSM's, use list all:\r
+\r
+    nssm list all\r
+\r
+\r
+Showing processes started by a service\r
+--------------------------------------\r
+The following command will print the process ID and executable path of\r
+processes started by a given service:\r
+\r
+    nssm processes <servicename>\r
+\r
+Note that if 32-bit NSSM is run on a 64-bit system running an older version of\r
+Windows than Vista it will not be able to query the paths of 64-bit processes.\r
+\r
 \r
 Exporting service configuration\r
 -------------------------------\r
@@ -985,6 +1018,10 @@ Thanks to Paul Baxter for help with Visual Studio 2015.
 Thanks to Mathias Breiner for help with Visual Studio and some registry fixes.\r
 Thanks to David Bremner for general tidyups.\r
 Thanks to Nabil Redmann for suggesting redirecting hooks' output.\r
+Thanks to Bader Aldurai for suggesting the process tree.\r
+Thanks to Christian Long for suggesting virtual accounts.\r
+Thanks to Marcin Lewandowski for spotting a bug appending to large files.\r
+Thanks to Nicolas Ducrocq for suggesting timestamping redirected output.\r
 \r
 Licence\r
 -------\r