Lib.rs

chrony-candm

chrony-candm is a Rust crate for communicating with Chrony's control & monitoring interface. It provides programmatic access to information about Chrony's status that one would otherwise have to scrape from the output of chronyc. For API documentation, see docs.rs.

Security

See CONTRIBUTING for more information.

License

This library is licensed under the GNU General Public License, version 2.0. For details, see LICENSE. See NOTICE and THIRD-PARTY respectively for first- and third-party copyright notices and acknowledgements.

chrony-candm is a community contribution from Amazon and is not affiliated with the Chrony project.

lib.rs:

This crate is a library for communicating with Chrony's control & monitoring interface. It provides programmatic access to information that you'd otherwise have to scrape from the output of chronyc.

For simple use cases which involve non-privileged queries to the locally-running Chrony daemon, your main entry-point into the library will be the [blocking_query] function with a server argument of &LOCAL_SERVER_ADDR. For privileged commands, use [blocking_query_uds] instead (this will require permissions to write to the /var/run/chrony directory).

use chrony_candm::request::RequestBody;
use chrony_candm::reply::ReplyBody;
use chrony_candm::{blocking_query,LOCAL_SERVER_ADDR};

let request_body = RequestBody::Tracking;
let options = Default::default();
let reply = blocking_query(request_body, options, &LOCAL_SERVER_ADDR)?;
if let ReplyBody::Tracking(tracking) = reply.body {
    println!("The current RMS offset is {} seconds.", tracking.rms_offset);
}

Asynchronous applications can use [Client] instead of the standalone blocking_query and blocking_query_uds functions.