1 unstable release

0.3.0 Feb 2, 2025

#1962 in Network programming

Download history 118/week @ 2025-02-02

118 downloads per month

MIT license

21KB
386 lines

ifaddrsx

Crates.io Documentation License: MIT

A Rust library for retrieving network interface information, including names and IP addresses of all active network interfaces. This crate provides a cross-platform solution that works on Windows, Linux, macOS, and other Unix-like systems.

Features

  • Get network interface names
  • Retrieve IPv4 and IPv6 addresses for each interface
  • Cross-platform support (Windows, Linux, macOS, and other Unix-like systems)
  • Easy-to-use API
  • No unsafe code (except for necessary FFI bindings)

Installation

Add this to your Cargo.toml:

[dependencies]
ifaddrsx = "0.3"

Usage

use ifaddrsx::get_ifaddrs;

fn main() {
    let ifaddrs = get_ifaddrs().unwrap();
    for ifaddr in ifaddrs {
        println!("Interface: {}", ifaddr.name);
        println!("  IP Addresses: {:?}", ifaddr.ips);
    }
}

Platform Support

  • Windows (via WinAPI)
  • Linux (via netlink)
  • macOS and other Unix-like systems (via getifaddrs)

Dependencies

  • bitflags: For flag handling
  • ipnetwork: IP address manipulation
  • libc: System library bindings
  • Platform-specific dependencies:
    • Windows: winapi with network-related features
    • Unix: nix for network operations

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Sprite Tong spritetong@gmail.com

Dependencies

~2MB
~37K SLoC