fmd-adm 0.3.0

Idiomatic Rust bindings for illumos libfmd_adm
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# fmd-adm

Idiomatic Rust bindings for illumos
[libfmd_adm](https://illumos.org/man/3LIB/libfmd_adm), the Fault
Management Daemon administrative library.

This crate provides a safe wrapper around the raw FFI bindings in
[fmd-adm-sys](../fmd-adm-sys/).

## Usage

```rust
use fmd_adm::FmdAdm;

let adm = FmdAdm::open().expect("failed to connect to fmd");

for module in adm.modules().unwrap() {
    println!("{} v{} - {}", module.name, module.version, module.description);
}

for case in adm.cases(None).unwrap() {
    println!("{} - {}", case.uuid, case.code);
}
```

## API overview

All operations go through the `FmdAdm` handle, which connects to the local
fault management daemon on construction and disconnects on drop.

- **Modules**: `modules()`
- **Resources**: `resources()`, `resource_count()`,
  `resource_repaired()`, `resource_replaced()`, `resource_acquit()`
- **Cases**: `cases()`, `case_acquit()`
- **SERD engines**: `serd_engines()`
- **Transports**: `transports()`
- **Statistics**: `stats()`

## Privileges

Opening a handle does not require elevated privileges, but most query and
mutation operations do. Run with `pfexec` or appropriate RBAC profiles to
access fmd data.