Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marirs/mac-oui
Lookup for MAC OUI vendor details from the oui database
https://github.com/marirs/mac-oui
mac-address networking oui oui-database oui-search ouilookup rust rust-crate rust-lang rust-library
Last synced: 12 days ago
JSON representation
Lookup for MAC OUI vendor details from the oui database
- Host: GitHub
- URL: https://github.com/marirs/mac-oui
- Owner: marirs
- License: mit
- Created: 2021-02-12T05:32:46.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-07T03:57:22.000Z (2 months ago)
- Last Synced: 2024-10-08T11:51:09.810Z (about 1 month ago)
- Topics: mac-address, networking, oui, oui-database, oui-search, ouilookup, rust, rust-crate, rust-lang, rust-library
- Language: Rust
- Homepage:
- Size: 6.36 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
MAC Address lookup tool
=========================
[](https://github.com/marirs/mac-oui/actions/workflows/linux_arm.yml)
[](https://github.com/marirs/mac-oui/actions/workflows/linux_x86_64.yml)
[](https://github.com/marirs/mac-oui/actions/workflows/macos.yml)
[](https://github.com/marirs/mac-oui/actions/workflows/windows.yml)
[](https://docs.rs/mac_oui)
Lookup the MAC Address for a corresponding details (eg: org, created, etc...)
## Requirements
- Rust 1.70+ (edition 2021)
## Compile
- Dev
```bash
cargo b
```
- Release
```bash
cargo b --release
```
## Usage
You can include this in your Cargo.toml file:
```toml
[dependencies]
mac_oui = "0.4.11"
```
If you want to use it with the inbuilt oui db; then:
```toml
[dependencies]
mac_oui = { version = "0.4.11", features = ["with-db"] }
```
and then
```rust
use mac_oui::Oui;
fn main () {
let oui_db = Oui::default();
assert!(oui_db.is_ok());
}
```
## Running the Example
You can run the default example that is included in the following manner.
- `cargo run --example mac_lookup ` eg:
```bash
cargo run --features="with-db" --example mac_lookup '70:B3:D5:e7:4f:81'
Finished dev [optimized + debuginfo] target(s) in 1.54s
Running `target/debug/examples/mac_lookup '70:B3:D5:e7:4f:81'`
Entry {
oui: "70:B3:D5",
is_private: false,
company_name: "Ieee Registration Authority",
company_address: "445 Hoes Lane Piscataway NJ 08554 US",
country_code: "US",
assignment_block_size: "MA-L",
date_created: "2014-01-12",
date_updated: "2016-04-27",
}
```
- Example of lookup by Manufacturer
```bash
$ cargo run --features="with-db" --example manufacturer_lookup "Apple, Inc"
Finished dev [optimized + debuginfo] target(s) in 0.02s
Running `target/debug/examples/manufacturer_lookup 'Apple, Inc'`
[
Entry {
oui: "...",
is_private: false,
company_name: "Apple, Inc",
company_address: "1 Infinite Loop Cupertino CA 95014 US",
country_code: "US",
assignment_block_size: "MA-L",
date_created: "2017-02-21",
date_updated: "2017-02-21",
},
....
]
```
- Example Getting a list of Manufacturers
```bash
$ cargo run --features="with-db" --example db_stats
Finished dev [optimized + debuginfo] target(s) in 0.06s
Running `target/debug/examples/db_stats`
Total Records= 51615
Total Manufacturers= 30840
Total MAC Addrs= 51615
====Manufacturers====
[
"\"Azimut\" Production Association Jsc",
"\"Continent\" Co Ltd",
"\"Meta-chrom\" Co Ltd",
"\"Rpc \"Energoautomatika\" Ltd",
"(UN)Manned",
"+plugg srl",
"01db-Metravib",
"1.A Connect GmbH",
"1000eyes GmbH",
"100fio networks Tech Llc",
"10net Communications/Dca",
"11811347 Canada Inc",
"11wave Technonlogy Co, Ltd",
"12Sided Tech, Llc",
"1394 Printer Working Group",
"1394 Trade Association",
"16063",
"1Net Corp",
"1Verge Internet Tech (Beijing) Co, Ltd",
"1more",
]
...
[
"杭州德澜科技有限公司（HangZhou Delan Tech Co, Ltd）",
"\u{200b}Asung Techno Co, Ltd",
"éolane",
"Östling Marking Systems GmbH",
"Öresundskraft AB",
"Åmic AB",
"µTech Tecnologia Ltda",
"«Intellect module» Llc",
"zxsolution",
"zte Corp",
"zhejiang yuanwang communication technolgy Co, Ltd",
"zhejiang ebang communication Co, Ltd",
"zhejiang Dusun Electron Co, Ltd",
"zhejiang Anhong Tech Co, Ltd",
"z-max mediasolution",
"yLez Tech Pte Ltd",
"xxter b.v.",
"xvtec Ltd",
"xn systems",
"xmi systems",
]
```
---