proc-tree 0.1.1

Linux process tree: snapshot, incremental maintenance via fork/exec events, ancestry chain queries, PID reuse detection
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

# proc-tree

[![Crates.io](https://img.shields.io/crates/v/proc-tree.svg)](https://docs.rs/proc-tree)
[![Docs.rs](https://docs.rs/proc-tree/badge.svg)](https://docs.rs/proc-tree)

Linux process tree — snapshot, incremental fork/exec/exit maintenance, ancestry queries, PID reuse detection.

## Quick start

```rust
use proc_tree::{DefaultTree, DefaultCache, snapshot, resolve, build_chain_string};

let tree = DefaultTree::new(65536, 600);
let cache = DefaultCache::new(65536, 600);

snapshot(&tree, &cache);

let info = resolve(&cache, 1).unwrap();
println!("PID 1: {} ({})", info.cmd, info.user);

let chain = build_chain_string(&tree, &cache, std::process::id());
```

## Module structure

| Module | Purpose |
|--------|---------|
| `types` | `PidNode`, `ProcInfo` data types |
| `traits` | `TreeStore`, `CacheStore` trait definitions |
| `ops` | All algorithms: `snapshot`, `resolve`, `display`, `children`, etc. |
| `proc` | Raw `/proc` reading: `parse_proc_entry`, `read_proc_comm`, `uid_to_username`, `read_proc_start_time_ns` |
| `tree` | `ProcEvent`, `ProcessLink` types |
| `default_store` | `DefaultStore<V>`, `DefaultTree`, `DefaultCache` |

## Custom backend

Implement `TreeStore` and `CacheStore` for any storage (Redis, moka, dashmap, ...). See [docs.rs](https://docs.rs/proc-tree) for the trait definitions.

## License

[MIT LICENSE](./LICENSE)