#proc #linux #info #procfs #sys #filesystem

lpfs

Retriving infomations from linux proc filesystem

2 unstable releases

0.2.0 Feb 2, 2020
0.1.0 Nov 24, 2019

#10 in #procfs

Download history 10/week @ 2024-07-22 116/week @ 2024-07-29 14/week @ 2024-08-05 22/week @ 2024-08-12 47/week @ 2024-08-19 1/week @ 2024-08-26 43/week @ 2024-09-02 52/week @ 2024-09-23 7/week @ 2024-09-30 20/week @ 2024-10-07 13/week @ 2024-10-14 2/week @ 2024-10-21 55/week @ 2024-11-04

70 downloads per month

MIT license

205KB
3K SLoC

docs.rs crates.io license

The goal of this repo is to make retriving system informations reside in proc file system easier.

Example

use lpfs::proc::*;
use lpfs::pid::*;

fn main() {
    //  /proc/stat
    println!("{:?}", stat().unwrap());

    //  /proc/1/stat
    println!("{:?}", stat_of(1).unwrap());
}

Interface Design

eminence/procfs is a similar crate with different interface design.

Top-Level Files

Each file is retrived by a function reside in lpfs::proc with same name. For example, lpfs::proc::cmdline retrive from /proc/cmdline.

Process Directories

It's similar with top-level files, here is an example with stat.

function file
stat_of(pid) /proc/[pid]/stat
stat_self() /proc/self/stat
stat_of_task(pid, tid) /proc/[pid]/task/[tid]/stat
stat_self_task(tid) /proc/self/task/[tid]/stat

These functions reside in lpfs::pid

Minial Requirement

rust 2018 (rustc 1.31.0 +)

Supported

all linux distribution with 3.+ kernel version.

LICENSE

MIT

No runtime deps