https://github.com/viraptor/systemd_socket

Interface to systemd activated sockets; pure rust port
https://github.com/viraptor/systemd_socket

Last synced: about 2 months ago
JSON representation

Interface to systemd activated sockets; pure rust port

• Host: GitHub
• URL: https://github.com/viraptor/systemd_socket
• Owner: viraptor
• Created: 2015-12-30T03:19:37.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-12-31T07:42:15.000Z (about 9 years ago)
• Last Synced: 2023-03-11T03:57:54.394Z (almost 2 years ago)
• Language: Rust
• Size: 10.7 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Rust port of systemd socket activation support

[![Build Status](https://travis-ci.org/viraptor/systemd_socket.svg?branch=master)](https://travis-ci.org/viraptor/systemd_socket)

## Documentation

[master](http://viraptor-rustdoc.s3-website-us-west-2.amazonaws.com/systemd_socket/master/systemd_socket/index.html)

## Usage

To use `systemd_socket`, add to your `Cargo.toml`:

```toml

[dependencies]

systemd_socket = "*"

```

Then, add this to your crate root:

```rust

extern crate systemd_socket;

```

The interface is slightly different than systemd C interface. To get a `Vec` of

all file descriptors passed into the app, call `listen_fds` and then use the

file descriptor numbers as you need:

```rust

let fds = systemd_socket::listen_fds(true).unwrap();

let listener = TcpListener::from_raw_fd(fds[0]);

```

See more complete example in `examples/listener.rs`.

## Notes

Path verification is not implemented for unix sockets.

Crate uses modified [nix](https://github.com/carllerche/nix-rust) until

[SO_TYPE support](https://github.com/carllerche/nix-rust/pull/225) is merged

into upstream.

Crate is based on [rust-systemd](https://github.com/jmesmon/rust-systemd), but

does not depend on linking with the systemd libraries. This also allows running

on rust-stable.