Struct SystemdAdapterImpl 

pub struct SystemdAdapterImpl { /* private fields */ }

Linux systemd adapter.

Manages daemons as systemd transient units via systemd-run and systemctl.

Requirements

• Linux with systemd (version 232+)
• User must have permissions for systemd-run --user or root for system units

Example

use duende_core::adapters::SystemdAdapter;
use duende_core::PlatformAdapter;

let adapter = SystemdAdapter::user();
let handle = adapter.spawn(my_daemon).await?;

Implementations

impl SystemdAdapter

pub fn new() -> Self

Creates a new systemd adapter with default settings (user mode).

Alias for user() for API compatibility.

pub fn system() -> Self

Creates a new systemd adapter for system-level daemons.

Requires root or appropriate polkit permissions.

pub fn user() -> Self

Creates a new systemd adapter for user-level daemons.

Uses systemd --user session, no root required.

pub fn with_unit_dir(unit_dir: PathBuf, user_mode: bool) -> Self

Creates adapter with custom unit directory.

pub fn unit_dir(&self) -> &PathBuf

Returns the unit directory path.

pub const fn is_user_mode(&self) -> bool

Returns whether running in user mode.

impl SystemdAdapter

pub async fn stop(&self, unit_name: &str) -> PlatformResult<()>

Stops a systemd unit.

pub async fn reset_failed(&self, unit_name: &str) -> PlatformResult<()>

Resets a failed systemd unit.

Trait Implementations

impl Default for SystemdAdapter

fn default() -> Self

Returns the “default value” for a type.

impl PlatformAdapter for SystemdAdapter

fn platform(&self) -> Platform

Returns the platform identifier.

fn spawn<'life0, 'async_trait>( &'life0 self, daemon: Box<dyn Daemon>, ) -> Pin<Box<dyn Future<Output = PlatformResult<DaemonHandle>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Spawns a daemon on this platform.

fn signal<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, sig: Signal, ) -> Pin<Box<dyn Future<Output = PlatformResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sends a signal to a daemon.

fn status<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, ) -> Pin<Box<dyn Future<Output = PlatformResult<DaemonStatus>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Queries daemon status.

fn attach_tracer<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, ) -> Pin<Box<dyn Future<Output = PlatformResult<TracerHandle>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Attaches a tracer to a running daemon.

fn stop<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, timeout: Duration, ) -> Pin<Box<dyn Future<Output = PlatformResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Gracefully stops a daemon.

fn kill<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, ) -> Pin<Box<dyn Future<Output = PlatformResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Forcefully kills a daemon.

fn pause<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, ) -> Pin<Box<dyn Future<Output = PlatformResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Pauses a daemon.

fn resume<'life0, 'life1, 'async_trait>( &'life0 self, handle: &'life1 DaemonHandle, ) -> Pin<Box<dyn Future<Output = PlatformResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Resumes a paused daemon.