mozilla / mtu

Rust crate for obtaining the local network interface name and MTU towards a given IP address
https://crates.io/crates/mtu
Apache License 2.0
12 stars 2 forks source link
interface mozilla mtu

Coverage Status Average time to resolve an issue Percentage of issues still open Maintenance

mtu

A crate to return the name and maximum transmission unit (MTU) of the local network interface towards a given destination SocketAddr, optionally from a given local SocketAddr.

Usage

This crate exports a single function interface_and_mtu that, given a pair of local and remote SocketAddrs, returns the name and maximum transmission unit (MTU) of the local network interface used by a socket bound to the local address and connected towards the remote destination.

If the local address is None, the function will let the operating system choose the local address based on the given remote address. If the remote address is None, the function will return the name and MTU of the local network interface with the given local address.

Example

let saddr = "127.0.0.1:443".parse().unwrap();
let (name, mtu) = mtu::interface_and_mtu(&(None, saddr)).unwrap();
println!("MTU for {saddr:?} is {mtu} on {name}");

Supported Platforms

Notes

The returned MTU may exceed the maximum IP packet size of 65,535 bytes on some platforms for some remote destinations. (For example, loopback destinations on Windows.)

The returned interface name is obtained from the operating system.

Contributing

We're happy to receive PRs that improve this crate. Please take a look at our community guidelines beforehand.

License: MIT OR Apache-2.0