networkmanager-rs

A NetworkManager API library using the D-Bus message bus system

Status

This project is still under development. Currently implemented parts can be found in the docs.

• NetworkManager D-Bus API >= v1.24.2

Usage

Add networkmanager to your Cargo.toml with:

toml [dependencies] networkmanager = "0.2"

Example

```rust,no_run use networkmanager::devices::{Any, Wired, Wireless}; use networkmanager::types::DeviceType; use networkmanager::{Error, NetworkManager};

fn main() -> Result<(), Error> { let nm = NetworkManager::new()?;

let enp0s2 = nm.get_device_by_ip_iface("enp0s2")?;

for dev in nm.get_devices()? {
    println!("Is autoconnected: {:?}", Any::autoconnect(&dev)?);
    println!("Device Type: {:?}", Any::device_type(&dev)?);
    match Any::device_type(&dev)? {
        DeviceType::WiFi => {
            println!("Access Point: {:?}", Wireless::access_points(&dev)?);
        }
        DeviceType::Ethernet => {
            println!("Speed: {:?}", dev.speed()?);
            println!(
                "Permanent Hardware Address: {:?}",
                Wired::perm_hw_address(&dev)?
            );
            println!("S390 Subchannels: {:?}", Wired::s390_subchannels(&dev)?);
            println!("Carrier: {:?}", Wired::carrier(&dev)?);
        }
        _ => {}
    }
}
Ok(())

} ```

Build prerequisites

• ### Debian and its derivatives (e.g. Ubuntu)
  • network-manager
  • libdbus-1-dev
  • pkg-config
• ### Fedora
  • NetworkManager
  • dbus-devel
  • pkg-config

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.