# systemctl
Small rust crate to interact with systemd units
[](https://crates.io/crates/systemctl)
[](https://github.com/gwbres/systemctl/blob/main/LICENSE-APACHE)
[](https://github.com/gwbres/systemctl/blob/main/LICENSE-MIT)
[](https://crates.io/crates/systemctl)
[](https://github.com/gwbres/systemctl/actions/workflows/rust.yml)
[](https://docs.rs/systemctl/badge.svg)
## Unit / service operation
Nominal service operations:
```rust
use systemctl;
systemctl::stop("systemd-journald.service").unwrap();
systemctl::restart("systemd-journald.service").unwrap();
```
## Service enumeration
```rust
use systemctl;
// list all units
systemctl::list_units(None, None);
// list all services
// by adding a --type filter
systemctl::list_units(Some("service"), None);
// list all services currently `enabled`
// by adding a --state filter
systemctl::list_units(Some("service"), Some("enabled"));
```
## Unit structure
Use the unit structure for more information
```rust
let unit = systemctl::Unit::from_systemctl("sshd")
.unwrap();
unit.restart().unwrap();
println!("active: {}", unit.active);
println!("preset: {}", unit.preset);
println!("auto_start (enabled): {}", unit.auto_start);
println!("config script : {}", unit.script);
println!("pid: {}", unit.pid);
println!("Running task(s): {}", unit.tasks.unwrap());
println!("Memory consumption: {}", unit.memory.unwrap());
```
## TODO
* [ ] conclude `from_systemctl()` parser
* [ ] restart(), status() syscalls