6 releases

0.1.5 Nov 14, 2024
0.1.4 Sep 21, 2024

#1557 in Network programming

Download history 118/week @ 2024-08-29 200/week @ 2024-09-05 142/week @ 2024-09-12 180/week @ 2024-09-19 27/week @ 2024-09-26 8/week @ 2024-10-03 4/week @ 2024-10-10 5/week @ 2024-10-31 26/week @ 2024-11-07 1662/week @ 2024-11-14

1,693 downloads per month

MIT/Apache

39KB
764 lines

getifaddrs

A cross-platform library for retrieving network interface information.

This crate provides a simple and consistent API for querying network interface details across different operating systems. It supports Unix-like systems (Linux, macOS, *BSD) and Windows.

Features

  • Retrieve network interface information (name, IP address, netmask, flags, etc.)
  • Filter interfaces based on various criteria (loopback, IPv4/IPv6, name, index)
  • Cross-platform support (Unix-like systems and Windows)
  • Provides a cross-platform implementation of if_indextoname and if_nametoindex

Usage

Add this to your Cargo.toml:

[dependencies]
getifaddrs = "0.1"

Example

use getifaddrs::{getifaddrs, InterfaceFlags};

fn main() -> std::io::Result<()> {
    for interface in getifaddrs()? {
        println!("Interface: {}", interface.name);
        println!("  Address: {}", interface.address);
        if let Some(netmask) = interface.netmask {
            println!("  Netmask: {}", netmask);
        }
        println!("  Flags: {:?}", interface.flags);
        if interface.flags.contains(InterfaceFlags::UP) {
            println!("  Status: Up");
        } else {
            println!("  Status: Down");
        }
        println!();
    }
    Ok(())
}

License

This project is licensed under the MIT License.

Dependencies

~0–8.5MB
~65K SLoC