4 years agoNSSM 2.22. v2.22
Iain Patterson [Fri, 16 May 2014 13:51:04 +0000 (14:51 +0100)]
NSSM 2.22.

4 years agoLatest French translations.
Gildas le Nadan [Fri, 16 May 2014 13:49:53 +0000 (14:49 +0100)]
Latest French translations.

Signed-off-by: Iain Patterson <me@iain.cx>
4 years agoDisable console window's close menu item.
Iain Patterson [Mon, 14 Apr 2014 18:25:38 +0000 (19:25 +0100)]
Disable console window's close menu item.

We can't trap Control-C in a service context but we can grey out the
close window button on the console window.  Doing so goes some way
toward preventing accidental closure.

Thanks Hadrien Kohl.

4 years agoFixed broken environment on restart.
Iain Patterson [Tue, 1 Apr 2014 21:20:21 +0000 (22:20 +0100)]
Fixed broken environment on restart.

We were calling duplicate_environment() to copy the service's initial
environment prior to restarting it.  However the duplicate_environment()
function modified its input by replacing = characters with NULLs.  That
is not allowed; the memory returned by GetEnvironmentStrings() must be
treated as readonly.

After two restarts the application would run with a null environment and
probably crash.

We now copy the initial environment on to the heap and operate on the
copy, ensuring that the corruption does not occur.

Thanks Alessandro Gherardi.

4 years agoAllow editing service dependencies.
Iain Patterson [Sun, 2 Mar 2014 18:29:45 +0000 (18:29 +0000)]
Allow editing service dependencies.

Service dependencies can now be queried or set on the command line via
the DependOnService and DependOnGroup parameters, or via the GUI in the
new Dependencies tab.

Service dependencies can be set using either their key name or display
name.  For example:

    nssm set <servicename> DependOnService RpcSs

which is equivalent to:

    nssm set <servicename> DependOnService "Remote Procedure Call (RPC)"

Group dependencies can be set with or without the group identifier
prefix, which for some reason is not actually described in the
documentation; instead readers are invited to consult the header files
for the value of SC_GROUP_IDENTIFIER, which it turns out is the +
symbol.  For example:

    nssm set <servicename> DependOnGroup +UIGroup

which is equivalent to:

    nssm set <servicename> DependOnGroup UIGroup

The prefix is always printed when query group dependencies.

The GUI presents a editbox into which either service or group
dependencies can be typed.  The group prefix is mandatory when editing
dependencies via the GUI.

4 years agoReally get canonical name in open_service().
Iain Patterson [Sun, 2 Mar 2014 14:22:53 +0000 (14:22 +0000)]
Really get canonical name in open_service().

The open_service() function would return the canonical service name if
passed a display name but would return the requested name as-is when
called with a valid service name.  We now retrieve the display name and
map back to the key name so that the returned string is capitalised
exactly as it appears in the services database.

4 years agoHeapFree() before GetLastError().
Iain Patterson [Sun, 2 Mar 2014 12:28:46 +0000 (12:28 +0000)]
HeapFree() before GetLastError().

Successful HeapFree() will set the last error to 0 so the GetLastError()
call will not be meaningful.

4 years agoCorrect CloseHandle() call.
Iain Patterson [Sun, 2 Mar 2014 11:48:56 +0000 (11:48 +0000)]
Correct CloseHandle() call.

Closing a service handle is done with CloseHandle() not

4 years agoSkip blank lines in format_double_null().
Iain Patterson [Sat, 1 Mar 2014 12:58:55 +0000 (12:58 +0000)]
Skip blank lines in format_double_null().

Ignore blank lines when formatting, so the user doesn't need to worry
about entering environment variables or dependency names in the exactly
correct format.

4 years agoRenamed un/format_environment().
Iain Patterson [Sat, 1 Mar 2014 11:42:21 +0000 (11:42 +0000)]
Renamed un/format_environment().

The format_environment() and unformat_environment() functions could be
used to format any double null-terminated string list, and are not
specificially tied to formatting environment blocks.

4 years agoDon't crash when installing a service.
Iain Patterson [Thu, 13 Feb 2014 18:52:55 +0000 (18:52 +0000)]
Don't crash when installing a service.

install_service() calls edit_service() with a null username, causing
well_known_username() to segfault.

Thanks Czenda Czendov.

4 years agoUAC awareness.
Iain Patterson [Thu, 6 Feb 2014 21:30:06 +0000 (21:30 +0000)]
UAC awareness.

Relaunch NSSM with administrator privileges if an attempt to install,
edit or remove a service fails.

The new process won't inherit the original console so its output won't
be visible.  For that reason we don't attempt to elevate for operations
which need to be able to display messages, such as controlling a service
or editing parameters.

Thanks to various people for requesting the feature but mainly to Marco
Certelli for advice on the implementation.

4 years agoOpen services with minimal privileges.
Iain Patterson [Tue, 4 Feb 2014 21:42:45 +0000 (21:42 +0000)]
Open services with minimal privileges.

Ask for the minimal access rights required to manage a service, so
users don't need to be administrators to perform operations permitted by
the service (manager) ACL.

4 years agoArgument consistency.
Iain Patterson [Tue, 4 Feb 2014 08:01:20 +0000 (08:01 +0000)]
Argument consistency.

Use "<args> ..." in the usage message to indicate that the arguments are
not the literal string "args" and that there can be an arbitrary number
of them.

The Italian message was already like this but the English and French
were not.

4 years agoLatest Italian translations.
Marco Cartelli [Tue, 4 Feb 2014 08:00:23 +0000 (08:00 +0000)]
Latest Italian translations.

Signed-off-by: Iain Patterson <me@iain.cx>
4 years agoTidy up Edit Service buttons.
Iain Patterson [Tue, 4 Feb 2014 07:53:26 +0000 (07:53 +0000)]
Tidy up Edit Service buttons.

The French and Italian versions of Edit Service didn't fit as well as
the English version.

4 years agoDon't complain if the service has no ObjectName.
Iain Patterson [Mon, 3 Feb 2014 18:40:27 +0000 (18:40 +0000)]
Don't complain if the service has no ObjectName.

Not all service types run under an account.

4 years agoFormat the exit action dropdown.
Iain Patterson [Mon, 3 Feb 2014 18:30:25 +0000 (18:30 +0000)]
Format the exit action dropdown.

The longer messages didn't fully fit in the exit actions dropdown.  Make
it wide enough to accommodate them.

4 years agoCredit for latest Italian translations.
Iain Patterson [Sun, 2 Feb 2014 23:21:44 +0000 (23:21 +0000)]
Credit for latest Italian translations.

4 years agoRemoved redundant NSSM_EVENT_STDIN_CREATEPIPE_FAILED.
Iain Patterson [Sun, 2 Feb 2014 23:19:05 +0000 (23:19 +0000)]

We aren't faking stdin with a pipe any longer so the message isn't

4 years agoCommand arguments no longer called options.
Iain Patterson [Sun, 2 Feb 2014 23:16:28 +0000 (23:16 +0000)]
Command arguments no longer called options.

The things appended to a program path in order to make a command line
are more appropriately called Arguments than Options.

Thanks Marco Certelli.

4 years agoLatest Italian translations.
Marco Cartelli [Sun, 2 Feb 2014 23:15:52 +0000 (23:15 +0000)]
Latest Italian translations.

Signed-off-by: Iain Patterson <me@iain.cx>
4 years agoUse well-known account aliases.
Iain Patterson [Thu, 30 Jan 2014 20:49:43 +0000 (20:49 +0000)]
Use well-known account aliases.

Jump through a few hoops to make the Windows service control panel to
localise service ObjectNames if they are set to LocalSystem,
LocalService or NetworkService.

Those aren't the canonical names of the accounts as returned by
LsaLookupSids() so attempting to call ChangeServiceConfig() with a
username of, eg, NetworkService will fail, even though writing
NetworkService directly to the registry would work.  Calling
ChangeServiceConfig() with a username of "NT Authority\Network Service"
will work, since that's the canonical name returned by LsaLookupSids()
but it won't be localised in the control panel.

The solution is to write "NT Authority\NetworkService" to the registry
and it will appear correctly.

At this point I'm not sure whether to label it a bug or a feature that
"nssm get <service> ObjectName" will return the actual value in the
registry and not the localised name.

Thanks Marco Certelli.

4 years agoHandle well-known account names.
Iain Patterson [Wed, 29 Jan 2014 20:30:55 +0000 (20:30 +0000)]
Handle well-known account names.

Certain well-known accounts can be used to start a service without
entering a password.

"LocalSystem" is the default value of ObjectName in the registry.  It is
not a real account but is an alias for the "NT Authority\System"

"NT Authority\Local Service" has minimal local and no network

"NT Authority\Network Service" has minimal local and network privileges.

NSSM now recognises these well-known accounts and will accept them as
ObjectName parameters without complaining that no password was enter.
With the exception of LocalSystem, each can be specified without the "NT
Authority" pseudo-domain prefix.

4 years agoAdded CreateWellKnownSid and IsWellKnownSid imports.
Iain Patterson [Tue, 28 Jan 2014 22:56:02 +0000 (22:56 +0000)]
Added CreateWellKnownSid and IsWellKnownSid imports.

Visual Studio 2008 doesn't recognise the functions so we need to load
them to the imports table.

4 years agoFixed argument parsing for setting ObjectName.
Iain Patterson [Tue, 28 Jan 2014 22:42:37 +0000 (22:42 +0000)]
Fixed argument parsing for setting ObjectName.

Setting ObjectName needs a username and password, except when it
doesn't.  We can't make the extra argument mandatory because it isn't.

4 years agoCorrect label on file rotation GUI.
Iain Patterson [Mon, 27 Jan 2014 22:28:55 +0000 (22:28 +0000)]
Correct label on file rotation GUI.

AppRotateBytes is, as the name implies, a measure of bytes.  The GUI
incorrectly said kB.

Thanks Marco Certelli.

4 years agoKill process tree from the top down.
Iain Patterson [Mon, 27 Jan 2014 22:21:15 +0000 (22:21 +0000)]
Kill process tree from the top down.

On Windows 8.1 (and maybe other versions), attempting to kill
conhost.exe before its parent cmd.exe will cause the attempt to kill the
latter to fail and the console window to remain active after the service

We now kill the members of the process tree in reverse order, so the
problem doesn't occur.

Thanks Czenda Czendov.

4 years agoEnsure we have a valid service exit time.
Iain Patterson [Mon, 27 Jan 2014 22:17:45 +0000 (22:17 +0000)]
Ensure we have a valid service exit time.

Sometimes GetProcessTimes() will succeed but return 0 for the process
exit time, leading check_parent() to conclude that the service had
exited before a child process had started, and thus that the child
process was not part of the service's tree.

We now use initialise the service exit time to the current time before
attempting to get the real exit time, and only override the value if
it's valid.

Thanks Czenda Czendov.

4 years agoSend Control-C to the right window.
Iain Patterson [Mon, 27 Jan 2014 21:13:31 +0000 (21:13 +0000)]
Send Control-C to the right window.

We were always trying to send Control-C to the console of the parent
process rather than any subprocesses found in kill_process_tree().

4 years agoEnough with the small buffers already.
Iain Patterson [Mon, 27 Jan 2014 19:05:46 +0000 (19:05 +0000)]
Enough with the small buffers already.

Sledgehammer, meet nut.

4 years agoFixed service context detection when built with VS2013.
Iain Patterson [Mon, 27 Jan 2014 18:46:32 +0000 (18:46 +0000)]
Fixed service context detection when built with VS2013.

Visual Studio 2013 includes a C runtime which assigns stdin, stdout and
stderr the file descriptors 0, 1 and 2 - just like UNIX does - even if
there are no streams available.  Thus we can no longer use "_fileno(stdin)
< 0" as a check for running in a service context.

Instead we check for "GetStdHandle(STD_INPUT_HANDLE) == 0" which works
when compiled with older or newer versions of Visual Studio.

Thanks Czenda Czendov.

4 years agoDon't expand parameters when editing a service.
Iain Patterson [Sun, 26 Jan 2014 16:22:26 +0000 (16:22 +0000)]
Don't expand parameters when editing a service.

Environment variables were still being expanded when retrieving strings
to display in the GUI.

4 years agoReally fix warning when file disposition isn't set.
Iain Patterson [Sun, 26 Jan 2014 16:12:11 +0000 (16:12 +0000)]
Really fix warning when file disposition isn't set.

If AppStdoutDisposition and AppStderrDisposition are both missing from
the registry, the service editing GUI would still incorrectly complain
that the current configuration couldn't be represented in the interface
even though a previous commit claimed to fix that.

4 years agoSplit get_output_handles() into get_io_parameters().
Iain Patterson [Sun, 26 Jan 2014 14:11:57 +0000 (14:11 +0000)]
Split get_output_handles() into get_io_parameters().

Separate retrieving parameters from the registry and opening output

Restart throttling happens after calling get_output_handles(), so if the
service was throttled we'd end up with a useless console window
appearing during the pause.

4 years agoMoved console functions to a new file.
Iain Patterson [Sun, 26 Jan 2014 14:21:41 +0000 (14:21 +0000)]
Moved console functions to a new file.

Functions for allocating and setting up a console are moved to

4 years agoAllocate new console by default.
Iain Patterson [Sat, 25 Jan 2014 21:45:56 +0000 (21:45 +0000)]
Allocate new console by default.

Since the whole purpose of NSSM is to be able to make services out of
applications which expect to have a standard desktop environment, let's
simply allocate a new console for each one rather than do so only when
we try to redirect I/O.

A funky ASCII art banner identifies the console as belonging to the
service.  NSSM itself will detach from the console as soon as possible,
so if the service runs a graphical application the console may never be

The console can be suppressed by setting the REG_DWORD value
AppNoConsole to 1.

Note that services running console applications on Windows 2000 may
fail if the console is disabled.

4 years agoAllocate a new console for stdin.
Iain Patterson [Sat, 25 Jan 2014 21:59:57 +0000 (21:59 +0000)]
Allocate a new console for stdin.

Allocate a new console for processes which require stdin instead of
using the pipe hack.

4 years agoFixed CreateFile() flags when opening log files.
Iain Patterson [Sat, 25 Jan 2014 11:22:11 +0000 (11:22 +0000)]
Fixed CreateFile() flags when opening log files.

Opening a file with FILE_APPEND_DATA access is not appropriate when not
truncating existing files or opening new files.  Redirected I/O would be
buffered and output would not be immediately visible to readers.

4 years agoRevamped environment variables again.
Iain Patterson [Thu, 23 Jan 2014 21:19:32 +0000 (21:19 +0000)]
Revamped environment variables again.

A previous commit changed how environment variables were managed.
Initially we were calling SetEnvironmentVariable() on each variable
defined in AppEnvironmentExtra prior to starting the service.  That
behaviour was changed because it was technically incorrect, potentially
resulting in NSSM's own environment being harmed.

Unfortunately the changed method, creating a new environment block by
calling GetEnvironmentStrings() (or using the block from AppEnvironment
if that and AppEnvironmentExtra were both defined), failed if users did
something like set AppEnvironmentExtra to PATH=C:\bin;%PATH%.  That
would result in the process being started with a block which included
TWO occurrences of the PATH variable; the system-defined one and the
appended one.  The latter would be ignored, possibly causing the
application to fail to start.

For this third attempt we now call GetEnvironmentStrings() once at
startup, storing the block in a new variable which is only freed at
exit.  Immediately prior to calling CreateProcess() to start the service
we use the new environment functions duplicate_environment() (on
AppEnvironment) and set_environment_block() (on AppEnvironmentExtra) to
set the variables.  Then immediately after calling CreateProcess() we
call duplicate_environment() again to restore the original block.

Because they are passed to expand_environment_string(), the environment
blocks are subject to expansion.  That means that setting PATH as
described in the example above would work.  Trying to append items to
the PATH by setting AppEnvironment in a similar way will probably not

Thanks Bryan Senseman.

4 years agoAdded more environment functions.
Iain Patterson [Thu, 23 Jan 2014 21:12:43 +0000 (21:12 +0000)]
Added more environment functions.

useful_environment() skips the uninteresting variables at the start of
an environment block, returning a pointer to the first useful variable.

expand_environment_string() expands a string with
ExpandEnvironmentStrings() and returns a pointer to the expanded string,
which must be freed after use.

set_environment_block() iterates through all the variables in an
environment block, expands each one with expand_environment_string() and
calls SetEnvironmentVariable() with the expanded value.

clear_environment() removes all variables from the current environment.

duplicate_environment() duplicates an environment block by first calling
clear_environment() then set_environment_block() with the source block.
Thus it ensures that the variables in the block - and only those - are
set in the current environment.

4 years agoRenamed set_environment().
Iain Patterson [Thu, 23 Jan 2014 20:06:54 +0000 (20:06 +0000)]
Renamed set_environment().

The set_environment() function was poorly named.  It gets the
environment settings from the registry but doesn't actually set any
variables.  It is more appropriately named get_environment().

4 years agoMoved environment functions to a new file.
Iain Patterson [Thu, 23 Jan 2014 20:05:25 +0000 (20:05 +0000)]
Moved environment functions to a new file.

Moved format_environment(), unformat_environment() and
test_environment() to env.cpp.

4 years agoFixed warning when file disposition isn't set.
Iain Patterson [Wed, 22 Jan 2014 22:21:09 +0000 (22:21 +0000)]
Fixed warning when file disposition isn't set.

If AppStdoutDisposition and AppStderrDisposition are both missing from
the registry, the service editing GUI would incorrectly complain that
the current configuration couldn't be represented in the interface.

4 years agoMinor vcproj tidying.
Iain Patterson [Sun, 19 Jan 2014 22:35:54 +0000 (22:35 +0000)]
Minor vcproj tidying.

Consistent file naming via the RelativePath attribute.

4 years agoFake stdin for applications which exit on EOF.
Iain Patterson [Sun, 19 Jan 2014 18:01:36 +0000 (18:01 +0000)]
Fake stdin for applications which exit on EOF.

Some applications, like MonetDB server, expect to read commands on
stdin.  If they read a keyword, usually "exit" or "quit" or if stdin is
closed, they will exit.

Such applications will typically work when run in a service context via
NSSM, as Windows will allocate a console window for them.  However, when
the service is configured to redirect stdout and/or stderr but not
stdin, the application will exit immediately because it will see no
input and think that the user closed stdin.

To deal with this situation we interpret an AppStdin value of "|" (a
single pipe character) as requesting a hack mode whereby we open a pipe
and pass the reading end to the application as the stdin handle.  We
never actually write anything to the writing end of pipe but simply keep
it around until the application exits or the service receives a stop
control.  Closing the pipe on receipt of a stop request may even be
sufficient to close the application gracefully without resorting to any
of the other stop methods.

As an aside, MonetDB server can be run in batch mode, wherein it does
not attempt to read from stdin at all.  The hack is not necessary for it
or other applications with similar functionality.

Thanks Bryan Senseman.

4 years agoDon't fail to restart if the service is stopped.
Iain Patterson [Sun, 19 Jan 2014 17:27:28 +0000 (17:27 +0000)]
Don't fail to restart if the service is stopped.

Treat a restart control on a stopped service as a start control.

Iain Patterson [Sun, 19 Jan 2014 17:12:52 +0000 (17:12 +0000)]

We were supposed to add a parameter explaining which handle couldn't be

4 years agoFixed regression in file browser.
Iain Patterson [Sat, 18 Jan 2014 13:43:06 +0000 (13:43 +0000)]
Fixed regression in file browser.

The GUI file browser was the only place in the code we were using new
and delete[] instead of HeapAlloc() and HeapFree().
The previous commit overlooked that fact and introduced a compiler error
by assuming that lpstrFile was a buffer of a known size instead of being
allocated with new.
Fix the regression and use HeapAlloc()/HeapFree() for consistency.

4 years agoAdjust buffer sizes.
Iain Patterson [Wed, 15 Jan 2014 21:27:32 +0000 (21:27 +0000)]
Adjust buffer sizes.

Unicode applications can under certain circumstances access paths longer
than MAX_PATH characters.  Service names are limited to 256 characters.

Adjust our buffers to suit.

4 years agoFrench CPUs are UCs.
Iain Patterson [Wed, 15 Jan 2014 21:24:24 +0000 (21:24 +0000)]
French CPUs are UCs.

Unité Centrale.

4 years agoFixed drawing of rotation GUI labels.
Iain Patterson [Tue, 14 Jan 2014 23:07:38 +0000 (23:07 +0000)]
Fixed drawing of rotation GUI labels.

The "Restrict rotation" labels were slightly too large, resulting in
them bleeding into the associated editboxes if the window were redrawn.

4 years agoDon't expand parameters when querying a service.
Iain Patterson [Tue, 14 Jan 2014 23:05:58 +0000 (23:05 +0000)]
Don't expand parameters when querying a service.

Calling, eg "nssm get <service> Application" should print the unexpanded
string from the registry.

4 years agoAdded get_string() and set_string().
Iain Patterson [Tue, 14 Jan 2014 23:04:55 +0000 (23:04 +0000)]
Added get_string() and set_string().

Abstract expand_parameter() and set_expand_string() to allow working
with registry values of type REG_SZ as well a REG_EXPAND_SZ.

4 years agoFixed regression with offline rotation.
Iain Patterson [Mon, 13 Jan 2014 23:53:33 +0000 (23:53 +0000)]
Fixed regression with offline rotation.

We weren't falling through to direct I/O when online rotation was
completely disabled, only when it was attempted but failed.
We weren't closing pipe handles after a failed attempt to enable online
We were incorrectly complaining about I/O errors in the event log when the
application was exiting.

4 years agoFormatting.
Iain Patterson [Mon, 13 Jan 2014 23:13:30 +0000 (23:13 +0000)]

4 years agoTidy up online rotation.
Iain Patterson [Mon, 13 Jan 2014 23:11:45 +0000 (23:11 +0000)]
Tidy up online rotation.

Move the messy copy/paste of the logging thread setup into a separate function.
No longer incorrectly tread longs as bools.
Fixed some typos and incorrect logic.

4 years agos/stdout/stderr/
Iain Patterson [Mon, 13 Jan 2014 15:56:14 +0000 (15:56 +0000)]


4 years agoAllow restarting a service.
Iain Patterson [Mon, 13 Jan 2014 12:11:07 +0000 (12:11 +0000)]
Allow restarting a service.

Running "nssm restart <service>" will try to send a stop control
followed by a start control.  It will fail if the service was stopped at
the outset or if it didn't respond to the stop control in a timely

4 years agoDon't get stuck in SERVICE_CONTINUE_PENDING.
Iain Patterson [Mon, 13 Jan 2014 12:08:17 +0000 (12:08 +0000)]

If we received SERVICE_CONTROL_CONTINUE and the service wasn't paused we
would incorrectly set SERVICE_CONTINUE_PENDING status.

The Windows services console won't allow a user to attempt to send a
continue control to a running service but other applications, like say
NSSM itself, might happily try, then get confused when the status wasn't

4 years agoMore robust options for controlling a service.
Iain Patterson [Mon, 13 Jan 2014 11:56:53 +0000 (11:56 +0000)]
More robust options for controlling a service.

Wait for the service status to change, eg from START_PENDING to RUNNING
before deciding whether a service control operation was successful.

4 years agoAdded service_status_text().
Iain Patterson [Mon, 13 Jan 2014 11:09:54 +0000 (11:09 +0000)]
Added service_status_text().

Function to get a string representation of a service status, eg

4 years agoAdded fake NSSM_SERVICE_CONTROL_START constant.
Iain Patterson [Mon, 13 Jan 2014 09:33:30 +0000 (09:33 +0000)]

There's no SERVICE_CONTROL_START constant so we were explicitly checking
for a fake control code of 0 when handling service start.  Now that we
have defined a custom control code (NSSM_SERVICE_CONTROL_ROTATE) we can
add NSSM_SERVICE_CONTROL_START for readability and consistency.

4 years agoAdded error message for missing subparameter.
Iain Patterson [Mon, 13 Jan 2014 09:30:52 +0000 (09:30 +0000)]
Added error message for missing subparameter.

Clarify the output when editing a service on the command line and a
mandatory subparameter was not supplied.

Thanks Chris Blaszczynski.

4 years agoEnable on-demand rotation.
Iain Patterson [Sun, 12 Jan 2014 23:56:10 +0000 (23:56 +0000)]
Enable on-demand rotation.

Running "nssm rotate <service>" will send user-defined service control
128 to the service, triggering a rotation of output files after the next
call to ReadFile(), regardless of the value of AppRotateBytes*.

Note that since ReadFile() is synchronous, we have no way to interrupt
it, hence there may be a significant delay before the rotation happens.

4 years agoFixed copy/paste bug with I/O.
Iain Patterson [Sun, 12 Jan 2014 23:02:23 +0000 (23:02 +0000)]
Fixed copy/paste bug with I/O.

The stderr file was incorrectly being created with stdout paramters.

4 years agoMore robust online rotation.
Iain Patterson [Sun, 12 Jan 2014 22:59:37 +0000 (22:59 +0000)]
More robust online rotation.

Try to differentiate between fatal and non-fatal I/O errors.  Give up on
logging only as a last resort.  Clean up logger data properly.  Report
when a file was rotated.

4 years agoBigger I/O buffer.
Iain Patterson [Sun, 12 Jan 2014 19:27:02 +0000 (19:27 +0000)]
Bigger I/O buffer.

We set a small logging buffer size when testing.  The buffer should be
bigger for a final release.

4 years agoRotate files while the service is running.
Iain Patterson [Sat, 11 Jan 2014 11:46:42 +0000 (11:46 +0000)]
Rotate files while the service is running.

If AppRotateOnline is set, set up a pipe between the application's
stdout/stderr and a new thread which reads all input and writes to the
configured output file(s).

If a file breaches the configured AppRotateBytes threshold while the
service is running, close and rotate the file then resume logging to
a new file.

This behaviour is not the default due to the potential for things to go
wrong.  We have to juggle file handles and might hit a read or write
error which causes logging to fail thus losing all output until the
service is restarted, etc etc.

Thanks Doug Watson.

4 years agoWrite canonical AppExit string.
Iain Patterson [Fri, 10 Jan 2014 23:27:54 +0000 (23:27 +0000)]
Write canonical AppExit string.

If the user ran "nssm set <servicename> AppExit Default exit" the
default value of AppExit would be set verbatim to "exit" which is in
contrast the documented value "Exit" with normal capitalisation.

There's no harm to that fact, as AppExit is retrieved case-insensitively
but it was nonetheless not working as intended.

4 years agoCopy environment block rather than setting extra variables.
Iain Patterson [Thu, 9 Jan 2014 18:27:00 +0000 (18:27 +0000)]
Copy environment block rather than setting extra variables.

If AppEnvironmentExtra is configured we were calling
SetEnvironmentVariable() to append each one to the existing environment.
That's arguably wrong as it could mess up NSSM's own environment.

Instead we now call GetEnvironmentStrings() and take a copy of the
current environment ebfore appending the extra environment as we were
doing before.

4 years agoForce UTF-16 output.
Iain Patterson [Thu, 9 Jan 2014 09:56:24 +0000 (09:56 +0000)]
Force UTF-16 output.

If we were compiled as a Unicode application, set stdout and stderr
output mode to UTF-16 text.  Doing so allows French and Italian accented
characters to show up correctly on the console.

We currently have no analogous method for fixing the output of NSSM when
compiled as an ANSI application.

4 years agoMore compiler food.
Iain Patterson [Thu, 9 Jan 2014 08:56:22 +0000 (08:56 +0000)]
More compiler food.

Om nom nom.

4 years agoAdded mandatory restart delay.
Iain Patterson [Thu, 9 Jan 2014 08:53:32 +0000 (08:53 +0000)]
Added mandatory restart delay.

The REG_DWORD AppRestartDelay entry specifies a minimum number of
milliseconds by which we will delay the restart (not the initial start)
of the managed application.  If the application exited soon enough to
trigger throttling, the actual delay will be whichever is longer of
AppRestartDelay and the calculated throttle time.

Thanks Andrew RedzMax.

4 years agoAllow setting processor affinity.
Iain Patterson [Wed, 8 Jan 2014 14:55:59 +0000 (14:55 +0000)]
Allow setting processor affinity.

The REG_SZ AppPriority entry specifies a list of processors which will
be converted to a mask and passed to SetProcessAffinityMask().

Processors are numbered from 0, must not exceed 63, and are separated
with commas or dashes, to specify a range.

Thanks Robert Middleton.

4 years agoAppPriority is an optional parameter.
Iain Patterson [Tue, 7 Jan 2014 10:09:20 +0000 (10:09 +0000)]
AppPriority is an optional parameter.

We were incorrectly requiring its presence and logging an error when it
wasn't found.  The parameter was not intended to be mandatory and no
error should be logged unless the parameter is present but invalid.

4 years agoOverload str_number().
Iain Patterson [Tue, 7 Jan 2014 19:02:36 +0000 (19:02 +0000)]
Overload str_number().

Allow passing the bogus pointer to str_number() in case we want to
inspect it later.

4 years agoCorrected priority documentation.
Iain Patterson [Mon, 6 Jan 2014 18:22:07 +0000 (18:22 +0000)]
Corrected priority documentation.

The correct function name is SetPriorityClass() not

4 years agoFixed year marker in build information.
Iain Patterson [Mon, 6 Jan 2014 18:17:07 +0000 (18:17 +0000)]
Fixed year marker in build information.

The year wasn't being set reliably by version.cmd.

4 years agoAllow setting application priority.
Iain Patterson [Mon, 6 Jan 2014 17:28:24 +0000 (17:28 +0000)]
Allow setting application priority.

The REG_DWORD AppPriority entry corresponds to a priority class as
accepted by SetProcessPriorityClass().  If a valid value is set, it will
be passed to CreateProcess() and the application will start with the
requested priority.

4 years agoFixed message when RegSetValueEx() fails.
Iain Patterson [Mon, 6 Jan 2014 16:52:16 +0000 (16:52 +0000)]
Fixed message when RegSetValueEx() fails.

We were incorrectly displaying the error message associated with

4 years agoBasic system translations.
Iain Patterson [Mon, 6 Jan 2014 11:17:35 +0000 (11:17 +0000)]
Basic system translations.

Copy translations for the Details and Log on tabs from native Windows

4 years agoGive up on older Visual Studio versions.
Iain Patterson [Sat, 4 Jan 2014 16:17:07 +0000 (16:17 +0000)]
Give up on older Visual Studio versions.

Tests show that Visual Studio 6 and 2005 won't build NSSM presumably
because there is no suitable platform SDK corresponding to those versions.
Carting around a legacy DSP and DSW file is therefore somewhat
pointless, especially as newer Visual Studio releases have freely
available Express versions and will compile the project.

4 years agoAdded messages to Visual Studio 6 workspace.
Iain Patterson [Sat, 4 Jan 2014 11:23:52 +0000 (11:23 +0000)]
Added messages to Visual Studio 6 workspace.

Added the messages.mc file was added to the workspace.
It's of limited usefulness given that the project won't build...

4 years agoMore appropriate LegalCopyright field.
Iain Patterson [Sat, 4 Jan 2014 10:48:22 +0000 (10:48 +0000)]
More appropriate LegalCopyright field.

It doesn't make a lot of sense to have a Copyright notice on a Public
Domain work.  The intention of including the LegalCopyright version
string was solely to assert authorship.  The new string should make that

4 years agoANSI compiler food.
Iain Patterson [Wed, 1 Jan 2014 23:23:48 +0000 (23:23 +0000)]
ANSI compiler food.

4 years agoExtra product description tags.
Iain Patterson [Wed, 1 Jan 2014 22:07:11 +0000 (22:07 +0000)]
Extra product description tags.

Call ourselves NSSM not nssm.  Add 32/64-bit and release/debug specifiers.
Since we are adding them to the resource files as well we need to add the
_WIN64 preprocessor definition to the resources definition list explicitly.
To ensure that messages sent to the event log remain consistent we
define the event source separately and set it to the old lowercase name.

4 years agoFixed bugs when creating a service.
Iain Patterson [Wed, 1 Jan 2014 21:44:48 +0000 (21:44 +0000)]
Fixed bugs when creating a service.

A null argument to grant_logon_as_service() would cause a crash.
We were calling CreateService() with the wrong access mask.
We weren't printing any error message when CreateService() failed.

4 years agoLegacy quick'n'dirtiness.
Iain Patterson [Wed, 1 Jan 2014 18:49:06 +0000 (18:49 +0000)]
Legacy quick'n'dirtiness.

On Windows 2000, StartService() and ControlService() return
ERROR_IO_PENDING immediately.  Later versions of Windows have a
builtin timeout before they will return that error.

As far as we're concerned, ERROR_IO_PENDING indicates that the service
control was sent successfully so we simply override the error and
return success.

If NSSM's service management functionality is ever expanded we can take
the time to handle service controls in a more robust way.

4 years agoAllow querying a service's name.
Iain Patterson [Wed, 1 Jan 2014 16:05:52 +0000 (16:05 +0000)]
Allow querying a service's name.

Since we can now open a service by its display name it may be
interesting to know what its canonical name is.

Find out with:

    nssm get <displayname> Name

4 years agoAdded open_service().
Iain Patterson [Wed, 1 Jan 2014 16:00:17 +0000 (16:00 +0000)]
Added open_service().

New function to open a service either by name or display name.  Since no
service's display name may conflict with any other service's display
name or key name, we can safely use a display name as a key when opening
a service.

OpenService() expects a service name so if it fails with status
ERROR_SERVICE_DOES_NOT_EXIST we can enumerate all services and look for
one whose display name matches the argument passed to open_service(),
and open it.  As a side effect we can optionally store the canonical
name in a separate (or not) buffer.

4 years agoAllow controlling services.
Iain Patterson [Wed, 1 Jan 2014 15:14:51 +0000 (15:14 +0000)]
Allow controlling services.

Send start/stop/query messages to services is easy so adding the ability
to do so is a quick win.

4 years agoAllow service editing on the command line.
Iain Patterson [Wed, 1 Jan 2014 12:41:02 +0000 (12:41 +0000)]
Allow service editing on the command line.

Individual service parameters can now be queried or edited on the
command line.  The syntax is designed to be intuitive and is
described in some detail in the README.  Some examples follow:

    nssm get Selenium Application

    nssm get "My Batch Job" AppExit 0

    nssm get Jenkins AppEnvironmentExtra CLASSPATH

    nssm get Netlogon ImagePath

    nssm set UT2004 Application C:\Games\UT2004\System\UCC.exe

    nssm set UT2004 AppParameters server

    nssm set UT2004 AppExit Default Exit

    nssm set Jenkins ObjectName DOMAIN\ci correct horse battery staple

    nssm set "My Batch Job" AppExit 0 Exit

    nssm set WowzaMediaServer362 Start SERVICE_DELAYED_START


    nssm reset UT2004 AppEnvironment

    nssm reset UT2004 ObjectName

4 years agoAdded str_number().
Iain Patterson [Wed, 1 Jan 2014 12:39:20 +0000 (12:39 +0000)]
Added str_number().

Wrapper function around _tcstoul().

4 years agoBe more Windowsy.
Iain Patterson [Wed, 1 Jan 2014 12:37:07 +0000 (12:37 +0000)]
Be more Windowsy.

Now that the GUI is more functional, it should behave more like a real
Windows application.  That means having an icon and modal messageboxes.

4 years agoFixed srvany-compatible environment checkbox.
Iain Patterson [Wed, 1 Jan 2014 12:02:06 +0000 (12:02 +0000)]
Fixed srvany-compatible environment checkbox.

The checkbox was inverted.  If we were replacing the environment, like
srvany does, it was unchecked, suggesting that the environment would be

4 years agoAdded format_environment() and unformat_environment().
Iain Patterson [Wed, 1 Jan 2014 12:00:33 +0000 (12:00 +0000)]
Added format_environment() and unformat_environment().

Added new functions to convert an environment block, with each KEY=value
pair separated by NULL NULL, to and from a string, with the pairs
separated by CRLF.

4 years agoAdded get_service_description().
Iain Patterson [Tue, 31 Dec 2013 16:11:08 +0000 (16:11 +0000)]
Added get_service_description().

New function to set or unset a service's description.

4 years agoAdded open_registry() function.
Iain Patterson [Tue, 31 Dec 2013 14:04:00 +0000 (14:04 +0000)]
Added open_registry() function.

Moved RegOpenKeyEx() and RegCreateKeyEx() to a separate function

4 years agoAdded get_service_username().
Iain Patterson [Mon, 30 Dec 2013 13:55:18 +0000 (13:55 +0000)]
Added get_service_username().

New function to get the service username.