#dbus #systemd #zbus #log #logging

logcontrol-zbus

zbus-based DBus frontend for the logcontrol interface

3 stable releases

2.0.0 Feb 13, 2024
1.1.0 Sep 30, 2023
1.0.0 Sep 30, 2023

#355 in Debugging

Download history 4/week @ 2024-01-16 5/week @ 2024-02-06 55/week @ 2024-02-13 60/week @ 2024-02-20 35/week @ 2024-02-27 5/week @ 2024-03-05 1/week @ 2024-03-12 3/week @ 2024-03-19 9/week @ 2024-03-26 40/week @ 2024-04-02

54 downloads per month

MIT/Apache

32KB
215 lines

logcontrol-zbus

Crates.io docs.rs

zbus DBus frontend for the logcontrol interface.

Usage

$ cargo add logcontrol-zbus
use logcontrol_zbus::ConnectionBuilderExt;

#[async_std::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Use an implementation such as logcontrol-tracing
    let control = create_log_control();
    let _conn = zbus::ConnectionBuilder::session()?
        .name("de.swsnr.logcontrol.SimpleServerExample")?
        .serve_log_control(logcontrol_zbus::LogControl1::new(control))?
        .build()
        .await?;

    // Do other things or go to wait forever
    std::future::pending::<()>().await;

    Ok(())
}

lib.rs:

A logcontrol::LogControl1 frontend with zbus.

LogControl1 provides the DBus interface implementation. It receives the underlying logcontrol::LogControl1 as sole argument and exposes it over DBus, as a standard zbus DBus interface:

use logcontrol_zbus::{LogControl1, ConnectionBuilderExt};

#[async_std::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let control = create_log_control();
    let _conn = zbus::ConnectionBuilder::session()?
        .name("de.swsnr.logcontrol.SimpleServerExample")?
        .serve_log_control(LogControl1::new(control))?
        .build()
        .await?;

    // Do other things or go to wait forever
    std::future::pending::<()>().await;

    Ok(())
}

Note that for systemctl to find the log control interface with systemctl service-log-level and systemctl service-log-target you need to make sure that

  • the interface is registered under logcontrol::DBUS_OBJ_PATH, and
  • the unit file provides the claimed bus name in the BusName attribute.

Otherwise systemd will not be able to change the log level or target.

Dependencies

~11–23MB
~329K SLoC