LeoBorai/network-interface

Retrieve system's Network Interfaces on Linux, macOS and Windows on a standardized manner

Rust

102

66 commits

updated Jan 3, 2026

crates.io/crates/network-interface

See the code

README

network-interface

Retrieve system's Network Interfaces/Adapters on Android, FreeBSD, Linux, macOS, iOS and Windows on a standarized manner

This crate is under development, feel free to contribute on GitHub. API and implementation is subject to change.

The main goal of network-interface crate is to retrieve system's Network Interfaces in a standardized manner.

standardized manner means that every supported platform must expose the same API and no further changes to the implementation are required to support such platform.

Usage

use network_interface::NetworkInterface;
use network_interface::NetworkInterfaceConfig;

fn main() {
    let network_interfaces = NetworkInterface::show().unwrap();

    for itf in network_interfaces.iter() {
        println!("{:?}", itf);
    }
}

Output

NetworkInterface { name: "lo", addr: Some(V4(V4IfAddr { ip: 127.0.0.1, broadcast: Some(127.0.0.1), netmask: Some(255.0.0.0) })) }
NetworkInterface { name: "wlp1s0", addr: Some(V4(V4IfAddr { ip: 192.168.0.16, broadcast: Some(192.168.0.255), netmask: Some(255.255.255.0) })) }
NetworkInterface { name: "wg0", addr: Some(V4(V4IfAddr { ip: 10.8.0.4, broadcast: Some(10.8.0.4), netmask: Some(255.255.255.0) })) }
NetworkInterface { name: "docker0", addr: Some(V4(V4IfAddr { ip: 172.17.0.1, broadcast: Some(172.17.255.255), netmask: Some(255.255.0.0) })) }
NetworkInterface { name: "lo", addr: Some(V6(V6IfAddr { ip: ::1, broadcast: None, netmask: Some(ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff) })) }
NetworkInterface { name: "wlp1s0", addr: Some(V6(V6IfAddr { ip: <redacted>, broadcast: None, netmask: Some(ffff:ffff:ffff:ffff::) })) }
NetworkInterface { name: "docker0", addr: Some(V6(V6IfAddr { ip: <redacted>, broadcast: None, netmask: Some(ffff:ffff:ffff:ffff::) })) }
NetworkInterface { name: "veth9d2904f", addr: Some(V6(V6IfAddr { ip: <redacted>, broadcast: None, netmask: Some(ffff:ffff:ffff:ffff::) })) }
NetworkInterface { name: "vethcdd79af", addr: Some(V6(V6IfAddr { ip: <redacted>, broadcast: None, netmask: Some(ffff:ffff:ffff:ffff::) })) }

Release

In order to create a release you must push a Git tag as follows

git tag -a <version> -m <message>

Example

git tag -a v0.1.0 -m "First release"

Tags must follow semver conventions Tags must be prefixed with a lowercase v letter.

Then push tags as follows:

git push origin main --follow-tags

Contributing

Every contribution to this project is welcome. Feel free to open a pull request, an issue or just by starting this project.

License

Distributed under the terms of both the MIT license and the Apache License (Version 2.0)

multiplatform

netifa

network

Significant stargazers

Davy Duperron

165 followers · starred Feb 2024

reuben olinsky

110 followers · starred Apr 2025

Gemingyang

13 followers · starred May 2023

Giuliano Bellini

1,024 followers · starred Feb 2024

Similar repos

LeoBorai/local-ip-address

Retrieve system's local IP address and Network Interfaces/Adapters on FreeBSD, Linux, macOS and…

148

same org

ifaddr/ifaddr

Python Library to enumerate all network interfaces

ohadravid/netstat2-rs

Cross-platform Rust library to retrieve network sockets information

jackpal/gateway

A golang library for discovering the address of a LAN gateway.

249

node-modules/address

Get current machine IP and MAC address.

238

wlynxg/anet

fix go bug #68082 #40569

JakubOnderka/ip_network

Rust crate for IPv4 and IPv6 network structs.

GuillaumeGomez/sysinfo

Cross-platform library to fetch system information

2,749