Crate local_ip_address[][src]

Expand description

Local IP Address

Retrieve system’s local IP address and Network Interfaces/Adapters on Linux, macOS and Windows.


Get the local IP address of your system by executing the local_ip function:

use local_ip_address::local_ip;

let my_local_ip = local_ip().unwrap();

println!("This is my local IP address: {:?}", my_local_ip);

Retrieve all the available network interfaces from both, the AF_INET and the AF_INET6 family by executing the list_afinet_netifas function:

use local_ip_address::list_afinet_netifas;

let network_interfaces = list_afinet_netifas().unwrap();

for (name, ip) in network_interfaces.iter() {
    println!("{}:\t{:?}", name, ip);

Underlying approach on retrieving network interfaces or the local IP address may differ based on the running operative system.

LinuxEstablishes a Netlink socket interchange to retrieve network interfaces
macOSUses of getifaddrs to retrieve network interfaces
WindowsConsumes Win32 API’s to retrieve the network adapters table


pub use crate::linux::*;




Finds the network interface with the provided name in the vector of network interfaces provided

Retrieves the local ip address of the machine in the local network from the AF_INET family.