Service: harden for unattended running (auto-restart, findable logs, resume)

Local checkpoint - NOT for public release. A "what else does a service need" pass.

- AUTO-RESTART ON CRASH: DoInstall now sets sc failure actions (restart 5s/10s/then 60s,
  reset daily). Without this a crashed service stays dead until reboot - fatal for an
  always-on streamer.
- FINDABLE LOGS: --run-service redirects the service's data dir to the machine-wide
  ProgramData\RemSound\service location, so its log sits next to its profile instead of
  buried in the SYSTEM account's AppData.
- POWER RESUME: the service handles OnPowerEvent and re-opens capture on wake (audio
  devices re-initialise after sleep; the device-change watcher usually catches it, but a
  resume doesn't always fire an endpoint change, so we re-open explicitly).
- Start/stop already auto-log to the Windows Event Log via ServiceBase.

Test: "Service registration args" now also checks the audio-service dependency and the
auto-restart failure args. Gate 27/27.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Ednunp
2026-07-13 08:43:33 +01:00
co-authored by Claude Opus 4.8
parent 4f5265d8b0
commit 92ed477ddf
5 changed files with 49 additions and 2 deletions
+9 -1
View File
@@ -66,7 +66,15 @@ internal static class Program
// a status code. --run-service blocks in the SCM dispatcher until Windows stops the service.
if (args.Length > 0)
{
if (HasArg(args, ServiceControl.RunVerb)) { RemSoundService.RunAsService(); return; }
if (HasArg(args, ServiceControl.RunVerb))
{
// Point the service's data (its log) at the machine-wide ProgramData location, next to its
// profile — otherwise a headless SYSTEM service logs into the SYSTEM account's AppData,
// which is near-impossible to find. (The profile itself always comes from ServiceStore.)
AppConfig.SetUserDataDirectoryOverride(ServiceStore.Directory);
RemSoundService.RunAsService();
return;
}
if (HasArg(args, ServiceControl.InstallVerb)) { Environment.ExitCode = ServiceControl.DoInstall(); return; }
if (HasArg(args, ServiceControl.UninstallVerb)) { Environment.ExitCode = ServiceControl.DoUninstall(); return; }
if (HasArg(args, ServiceControl.StartVerb)) { Environment.ExitCode = ServiceControl.DoStart(); return; }
+11
View File
@@ -22,6 +22,17 @@ public sealed class RemSoundService : ServiceBase
CanStop = true;
CanShutdown = true;
CanPauseAndContinue = false;
CanHandlePowerEvent = true; // so we can re-open capture after the machine wakes from sleep
}
protected override bool OnPowerEvent(PowerBroadcastStatus powerStatus)
{
if (powerStatus is PowerBroadcastStatus.ResumeSuspend or PowerBroadcastStatus.ResumeAutomatic or PowerBroadcastStatus.ResumeCritical)
{
log?.Event("service: power resume — re-opening capture");
try { host?.ReopenAfterResume(); } catch (Exception ex) { log?.Event($"service: resume re-open failed {ex.GetType().Name}: {ex.Message}"); }
}
return true;
}
protected override void OnStart(string[] args)
+7 -1
View File
@@ -676,7 +676,13 @@ internal static class SelfTest
Check(args.Contains("\\\"" + exe + "\\\" " + ServiceControl.RunVerb),
$"exe path must be escaped-quoted with the run verb (got: {args})");
Check(args.Contains($"DisplayName= \"{ServiceControl.DisplayName}\""), "must set the display name");
return "sc create args quoted correctly for a spaced path";
Check(args.Contains("depend= Audiosrv"), "must depend on the audio service so it starts after audio is up");
// Auto-restart-on-crash failure actions.
var fail = ServiceControl.BuildFailureArgs();
Check(fail.StartsWith($"failure {ServiceControl.ServiceName} ") && fail.Contains("actions= restart/"),
$"failure args must configure auto-restart (got: {fail})");
return "sc create + failure args are well-formed";
}
/// <summary>The service profile is fully isolated from the normal profile machinery: it lives in a
+8
View File
@@ -98,9 +98,17 @@ public static class ServiceControl
if (rc != 0) return rc;
// Best-effort description; failure here doesn't fail the install.
RunSc($"description {ServiceName} \"{Description}\"");
// Auto-restart on crash: without this a crashed service stays dead until reboot, which defeats
// an always-on streamer. Restart 5s / 10s / then every 60s; reset the failure counter daily.
RunSc(BuildFailureArgs());
return 0;
}
/// <summary>The sc.exe "failure" args that make the service auto-restart on a crash. Pure, so a
/// self-test can verify the format.</summary>
internal static string BuildFailureArgs() =>
$"failure {ServiceName} reset= 86400 actions= restart/5000/restart/10000/restart/60000";
/// <summary>Stops (if running) and deletes the service. Must be run elevated. Returns 0 on success or
/// if it wasn't installed.</summary>
public static int DoUninstall()
+14
View File
@@ -166,6 +166,20 @@ public sealed class ServiceSendHost : IDisposable
Suspend();
}
/// <summary>Force a re-open of capture if we intend to send — called after a power resume, when the
/// audio devices have re-initialised and the current capture may be dead. The device-change watcher
/// usually catches this too, but a resume doesn't always fire an endpoint change, so we re-open
/// explicitly to be safe.</summary>
public void ReopenAfterResume()
{
if (!wantSending || disposed) return;
var profile = loadProfile();
if (profile is null) return;
log?.Invoke("service: re-opening capture after power resume");
Suspend();
ApplyProfile(profile);
}
/// <summary>Device-set change callback (COM thread). While we intend to send, (re)open capture — this
/// is the event that fires when the audio stack finishes coming up at boot, a device is plugged or
/// unplugged, or the audio service restarts. Debounced: a single hot-plug fires several notifications.</summary>