manuf

Crates.iomanuf
lib.rsmanuf
version0.2.0
sourcesrc
created_at2018-08-09 11:55:37.966504
updated_at2020-05-20 11:05:07.809474
descriptionEthernet vendor codes, and well-known MAC addresses
homepage
repositoryhttps://github.com/flier/rust-manuf
max_upload_size
id78492
size1,720,098
Flier Lu (flier)

documentation

https://docs.rs/manuf/

README

rust-manuf LICENSE Crates.io Version Document Build Status Codecov

rust-manuf is a Rust library provides the Ethernet vendor codes, and well-known MAC addresses

Usage

To use rust-manuf, add this to your Cargo.toml:

[dependencies]
manuf = "0.2"

Use vendor function to find name and description base on an ethernet (MAC) address.

assert_eq!(
    manuf::vendor([0x8c, 0x85, 0x90, 0x0b, 0xcb, 0x9e]),
    Some(("Apple", "Apple, Inc."))
);

Use prefix function to find vendor's prefix and mask for the ethernet (MAC) address.

assert!(
    manuf::prefix("Apple")
        .any(|prefix| prefix == ([0x8c, 0x85, 0x90, 0x00, 0x00, 0x00], 24))
);

use parse function to extract verdor's ((prefix, prefix_length), (name, description)) from a manuf file.

let f = File::open("manuf").unwrap();
let r = BufReader::new(f);

for ((prefix, prefix_len), (name, desc)) in manuf::parse(r) {
    println!("{:?}/{}\t{}\t{}", prefix, prefix_len, name, desc)
}

Note: The manuf file was generated by the Wireshark project.

If you want to use the latest version of manuf file, please add the latest feature.

[dependencies]
manuf = { version = "0.2", features = ["latest"] }

License

Released under the terms of the MIT license.

Commit count: 14

cargo fmt