use crate::error::{Error, Result};
use crate::network::ioctl;
use crate::network::netgraph::NgBridge;
#[derive(Debug, Clone)]
pub struct Bridge {
name: String,
}
impl Bridge {
pub fn create(name: &str) -> Result<Self> {
if Self::exists(name)? {
return Err(Error::BridgeAlreadyExists(name.to_string()));
}
Self::load_modules()?;
ioctl::create_interface("bridge", Some(name))?;
if let Err(e) = ioctl::set_interface_up(name, true) {
let _ = ioctl::destroy_interface(name);
return Err(e);
}
Ok(Self {
name: name.to_string(),
})
}
pub fn open(name: &str) -> Result<Self> {
if !Self::exists(name)? {
return Err(Error::InterfaceNotFound(name.to_string()));
}
Ok(Self {
name: name.to_string(),
})
}
pub fn create_or_open(name: &str) -> Result<Self> {
if Self::exists(name)? {
Self::open(name)
} else {
Self::create(name)
}
}
pub fn ensure(name: &str) -> Result<(Self, bool)> {
if Self::exists(name)? {
Ok((Self::open(name)?, false))
} else {
Ok((Self::create(name)?, true))
}
}
pub fn exists(name: &str) -> Result<bool> {
ioctl::interface_exists(name)
}
pub fn destroy(&self) -> Result<()> {
ioctl::destroy_interface(&self.name)
}
pub fn add_member(&self, interface: &str) -> Result<()> {
ioctl::bridge_add_member(&self.name, interface)
}
pub fn remove_member(&self, interface: &str) -> Result<()> {
ioctl::bridge_delete_member(&self.name, interface)
}
pub fn set_address(&self, addr: &str) -> Result<()> {
ioctl::set_ipv4_address(&self.name, addr)
}
pub fn enable_vlan_filtering(&self) -> Result<()> {
ioctl::bridge_enable_vlan_filtering(&self.name)
}
pub fn add_trunk_member(&self, interface: &str, tagged_vlans: &[u16]) -> Result<()> {
if tagged_vlans.is_empty() {
return Err(Error::Network(
"At least one tagged VLAN required for trunk".to_string(),
));
}
ioctl::bridge_add_member(&self.name, interface)?;
ioctl::bridge_set_tagged_vlans(&self.name, interface, tagged_vlans)
}
pub fn add_member_untagged(&self, interface: &str, vlan_id: u16) -> Result<()> {
ioctl::bridge_add_member(&self.name, interface)?;
ioctl::bridge_set_pvid(&self.name, interface, vlan_id)
}
pub fn disable_hwfilter(interface: &str) -> Result<()> {
ioctl::disable_hwfilter(interface)
}
pub fn members(&self) -> Result<Vec<String>> {
ioctl::bridge_list_members(&self.name)
}
fn load_modules() -> Result<()> {
crate::sys::load_modules(&["if_bridge", "bridgestp", "if_epair"])
}
}
pub fn destroy_bridge(name: &str, force: bool) -> Result<()> {
if Bridge::exists(name)? {
let bridge = Bridge::open(name)?;
let members = bridge.members()?;
if !members.is_empty() && !force {
return Err(Error::Network(format!(
"Bridge '{}' has {} member(s) attached: {}. Use --force to destroy anyway.",
name,
members.len(),
members.join(", ")
)));
}
return bridge.destroy();
}
if let Ok(ng) = NgBridge::open(name) {
return ng.destroy();
}
Err(Error::InterfaceNotFound(name.to_string()))
}
#[cfg(test)]
mod tests;