Crate qsu

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

• pub use tokio;
• pub use rocket;
• pub use log;
• pub use tracing;
• pub use clap;
  clap

Modules

• argpclap
  Helpers for integrating clap into an application using qsu.
• installerinstaller
  Helpers for installing/uninstalling services.
• rtrt
  Server application wrapper runtime.

Structs

• LumberJack
  Logging and tracing initialization.

Enums

• CbErrrt or installer
  Errors that can be returned from functions that call application callbacks.
• Error
  Errors that qsu will return to application.

Functions

• default_service_name
  Attempt to derive a default service name based on the executable’s name.

Attribute Macros

• async_trait