Expand description
qsu is a set of tools for integrating a server application against a service subsystem (such as Windows Services, systemd, or launchd).
It offers a thin runtime wrapper layer with the purpose of abstracting away differences between service subsystems (and also provides the same interface when running the server application as a foreground process). More information about the wrapper runtime can be found in the rt module documentation.
In addition qsu offers helper functions to register/deregister an executable with the system’s service subsystem. These are documented installer module.
And finally it offers an argument parser to offer basic service registration/deregistration and running using a consistent command line interface. These are documented in the argp module.
§Features
| Feature | Function |
|---|---|
clap | Enable clap (argument parser) integration. |
installer | Tools for registering/deregistering services. |
rt | Service wrapper (enabled by default). |
systemd | systemd integration support. |
tokio | Tokio server application type support. |
rocket | Rocket server application type support. |
In addition there’s a special wait-for-debugger feature that is only used
on Windows. It will make the service runtime halt and wait for a debugger
to attach just before starting the Windows Service runtime. Once a
debugger has attached, it will voluntarily trigger a breakpoint.
Re-exports§
Modules§
- argp
clapHelpers for integrating clap into an application using qsu. - installer
installerHelpers for installing/uninstalling services. - rt
rtServer application wrapper runtime.
Structs§
- An error type used to pass an application-specific error through a library runtime.
- Logging and tracing initialization.
Enums§
- Errors that qsu will return to application.
Functions§
- Attempt to derive a default service name based on the executable’s name.