Struct NetworkInterfaces

pub struct NetworkInterfaces {
    pub interfaces: HashMap<String, Interface>,
    /* private fields */
}

Represents the collection of network interfaces defined in an interfaces(5) file.

The NetworkInterfaces struct provides methods to load, manipulate, and save network interface configurations.

Examples

Loading and modifying interfaces:

use interface_rs::NetworkInterfaces;
use interface_rs::interface::Interface;

let mut net_ifaces = NetworkInterfaces::load("/path/to/interfaces").unwrap();

// Modify an interface
if let Some(iface) = net_ifaces.interfaces.get_mut("eth0") {
    iface.method = Some("static".to_string());
    iface.options.push(("address".to_string(), "192.168.1.100".to_string()));
}

// Save changes
net_ifaces.save().unwrap();

Fields

interfaces: HashMap<String, Interface>

A mapping of interface names to their configurations.

Implementations

impl NetworkInterfaces

pub fn load<P: AsRef<Path>>(path: P) -> Result<Self, NetworkInterfacesError>

Loads the interfaces(5) file into memory.

Arguments

• path - The path to the interfaces file.

Returns

A NetworkInterfaces instance containing the parsed interfaces.

Errors

Returns a NetworkInterfacesError if the file cannot be read or parsed.

pub fn get_interface(&self, name: &str) -> Option<&Interface>

Retrieves a reference to an interface by name.

Arguments

• name - The name of the interface.

Returns

An Option containing a reference to the Interface if found.

pub fn add_interface(&mut self, iface: Interface)

Adds or updates an interface in the collection.

Arguments

• iface - The Interface to add or update.

pub fn delete_interface(&mut self, name: &str)

Deletes an interface by name.

Arguments

• name - The name of the interface to delete.

pub fn save(&mut self) -> Result<(), NetworkInterfacesError>

Saves changes back to the interfaces(5) file.

Errors

Returns a NetworkInterfacesError if the file cannot be written or has been modified on disk.

pub fn reload(&mut self) -> Result<(), NetworkInterfacesError>

Reloads the interfaces file from disk.

Errors

Returns a NetworkInterfacesError if the file cannot be read or parsed.

Trait Implementations

impl Debug for NetworkInterfaces

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for NetworkInterfaces

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.