#api-bindings #linux #listen

sd-listen-fds

Minimal, pure-rust helper to accept file descriptors from systemd

2 unstable releases

0.2.0 Aug 27, 2023
0.1.0 Jul 31, 2023

#201 in Unix APIs

Download history 3/week @ 2023-08-05 2/week @ 2023-08-12 57/week @ 2023-08-19 33/week @ 2023-08-26 8/week @ 2023-09-02 9/week @ 2023-09-09 17/week @ 2023-09-16 4/week @ 2023-09-23 20/week @ 2023-09-30 7/week @ 2023-10-07 15/week @ 2023-10-14 57/week @ 2023-10-21 85/week @ 2023-10-28 56/week @ 2023-11-04 138/week @ 2023-11-11 130/week @ 2023-11-18

434 downloads per month

MIT/Apache

8KB
114 lines

sd-listen-fds

Documentation License: Apache 2.0 License: MIT

Exposes file descriptors passed in by systemd, the Linux init daemon, without dependencies, foreign or otherwise. Enables easy implementation of socket-activated services in pure Rust.

Unlike services that open sockets themselves, socket-activated services are started on-demand, may start up concurrently with their dependencies, and may be restarted without losing inbound data. Portable applications can call sd_listen_fds::get() and open their own socket if it succeeds with an empty Vec.

See also the sd_listen_fds API exposed by the foreign libsystemd library. Compared to using libsystemd bindings, this crate is smaller, safer, and builds everywhere.

Example

let fds = sd_listen_fds::get().unwrap();
let (_name, fd) = fds
    .into_iter()
    .next()
    .expect("must be launched as a systemd socket-activated service");
let socket = TcpListener::from(fd);

my-service.socket (see also systemd.socket)

[Socket]
# TCP port number. Other types of sockets are also possible.
ListenStream=1234

[Install]
WantedBy=sockets.target

[Unit]
Description=My Rust service
Documentation=https://example.com/my-service/

my-service.service (see also systemd.service)

[Service]
ExecStart=/path/to/my-service

[Unit]
Requires=my-service.socket
Description=My Rust service
Documentation=https://example.com/my-service/

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps