# NetworkManager bindings for Rust

[![Crates.io](https://img.shields.io/crates/v/networkmanager.svg)](https://crates.io/crates/networkmanager)
[![docs.rs](https://docs.rs/networkmanager/badge.svg)](https://docs.rs/networkmanager)
[![license](https://img.shields.io/crates/l/networkmanager.svg)](https://crates.io/crates/networkmanager)
[![CI](https://github.com/truehumandesign/networkmanager-rs/workflows/Continuous%20Integration/badge.svg)](https://github.com/truehumandesign/networkmanager-rs/actions)

[NetworkManager](https://wiki.gnome.org/Projects/NetworkManager) bindings for Rust using the [D-Bus message bus system](https://www.freedesktop.org/wiki/Software/dbus/)

## Status

**NOTE**: At the moment i dont have any time to take care of this project. Contributors welcome!!

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 and dbus to your `Cargo.toml` with:

```toml
[dependencies]
networkmanager = "0.4"
dbus = "0.9"
```

## Example

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

use dbus::blocking::Connection;

fn main() -> Result<(), Error> {
    let dbus_connection = Connection::new_system()?;

    let nm = NetworkManager::new(&dbus_connection);

    for dev in nm.get_devices()? {
        match dev {
            Device::Ethernet(x) => {
                println!("Is autoconnected: {:?}", x.autoconnect()?);
                println!("Speed: {:?}", x.speed()?);
                println!("S390 Subchannels: {:?}", x.s390_subchannels()?);
                println!("Carrier: {:?}", x.carrier()?);
            }
            Device::WiFi(x) => {
                println!("Access Point: {:?}", x.access_points()?);
            }
            _ => {}
        }
    }

    let enp0s2 = nm.get_device_by_ip_iface("enp0s2")?;
    match enp0s2 {
        Device::Ethernet(x) => {
            // NetworkManager >= 1.24
            // println!("Hardware Address: {:?}", Any::hw_address(&x)?);

            // NetworkManager < 1.24
            // println!("Hardware Address: {:?}", Wired::hw_address(&x)?);

            println!("Speed: {:?}", x.speed()?);
        }
        _ => {}
    }

    Ok(())
}
```

## Build prerequisites

- ### Debian and its derivatives (e.g. Ubuntu)

  - network-manager
  - libdbus-1-dev
  - pkg-config

- ### Fedora

  - NetworkManager
  - dbus-devel
  - pkg-config

## Todo

- Implementations
  - Devices
    - [x] Any
    - [x] Generic
    - [x] Wireless
    - [x] Wired
    - [ ] ADSL
    - [ ] Bluetooth
    - [ ] Bond
    - [x] Bridge
    - [ ] Dummy
    - [ ] Infiniband
    - [ ] IpTunnel
    - [ ] Lowpan
    - [ ] Macsec
    - [ ] MacVLAN
    - [ ] Modem
    - [ ] OLPCMesh
    - [ ] OVSBridge
    - [ ] OVSInterface
    - [ ] OVSPort
    - [ ] PPP
    - [ ] Statistics
    - [ ] Team
    - [ ] TUN/TAP
    - [x] VETH
    - [ ] VLAN
    - [ ] VRF
    - [ ] VXLAN
    - [ ] WifiP2P
    - [ ] WiMax
    - [ ] Wireguard
    - [ ] Wpan
  - Configs
    - [x] IP4
    - [x] IP6
    - [x] DHCP4
    - [x] DHCP6
  - [x] Accesspoint
  - [x] ConnectionActive
  - [ ] NetworkManager (partially implemented)
  - [ ] AgentManager
  - [ ] Checkpoint
  - [ ] DNSManager
  - [ ] PPP
  - [ ] SecretAgent
  - [ ] Settings
  - [ ] Settings Connection
  - [ ] VPN Connection
  - [ ] VPN Plugin
  - [ ] WifiP2P
  - [ ] Wimax NSP
- General
  - [ ] Improve Error handling
  - [ ] dbus::arg::Variants conversion

## License

Licensed under either of

- Apache License, Version 2.0
   ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license
   ([LICENSE-MIT](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.