Crate utmp_rs

A Rust crate for parsing utmp files like /var/run/utmp and /var/log/wtmp.

Usage

Simplest way is to use parse_from_* functions, which returns a Vec<UtmpEntry> on success:

let entries = utmp_rs::parse_from_path("/var/run/utmp")?;
// ...

If you don’t need to collect them all, UtmpParser can be used as an iterator:

use utmp_rs::UtmpParser;
for entry in UtmpParser::from_path("/var/run/utmp")? {
    let entry = entry?;
    // ...
}

All the parse_from_* functions as well as UtmpParser parse utmp file based on the native format for the target platform. If cross-platform parsing is needed, Utmp32Parser or Utmp64Parser can be used instead of UtmpParser.

Enums

ParseError

UtmpEntry

Parsed utmp entry.

UtmpError

Functions

parse_from_file

Parse utmp entries from the given file.

parse_from_path

Parse utmp entries from the given path.

parse_from_reader

Parse utmp entries from the given reader.

Type Aliases

Utmp32Parser

Parser to parse a 32-bit utmp file.

Utmp64Parser

Parser to parse a 64-bit utmp file.

UtmpParser

Parser to parse a utmp file. It can be used as an iterator.