/// This contains up-to-date information about all interfaces, plus a diff which
/// details which interfaces and IP addresses have changed since the last callback.
#[derive(Debug, Clone, PartialEq, Eq)]
/// This contains up-to-date information about all interfaces, plus a diff which
/// details which interfaces and IP addresses have changed since the last callback.
#[derive(Debug, Clone, PartialEq, Eq)]
/// If the callback is executing at the time the handle is dropped, drop will block until
/// the callback is finished and it's guaranteed that it will not be called again.
/// If the callback is executing at the time the handle is dropped, drop will block until
/// the callback is finished and it's guaranteed that it will not be called again.
/// Do not drop the handle from within the callback itself. It will probably deadlock.
pub struct WatchHandle {
_inner: watch::WatchHandle,
}
/// Retrieve information about all enabled network interfaces and their IP addresses.
/// Do not drop the handle from within the callback itself. It will probably deadlock.
pub struct WatchHandle {
_inner: watch::WatchHandle,
}
/// Retrieve information about all enabled network interfaces and their IP addresses.
/// This is a once-off operation. If you want to detect changes over time, see `watch_interfaces`.
pub fn list_interfaces() -> Result<HashMap<IfIndex, Interface>, Error> {
list::list_interfaces().map(|list| list.0)
}
/// Retrieve interface information and watch for changes, which will be delivered via callback.
/// This is a once-off operation. If you want to detect changes over time, see `watch_interfaces`.
pub fn list_interfaces() -> Result<HashMap<IfIndex, Interface>, Error> {
list::list_interfaces().map(|list| list.0)
}
/// Retrieve interface information and watch for changes, which will be delivered via callback.
/// If setting up the watch is successful, this returns a `WatchHandle` which must be kept for
/// as long as the provided callback should operate.
/// If setting up the watch is successful, this returns a `WatchHandle` which must be kept for
/// as long as the provided callback should operate.
/// The callback will fire once immediately with an initial interface list, and a diff as if
/// there were originally no interfaces present.
/// The callback will fire once immediately with an initial interface list, and a diff as if
/// there were originally no interfaces present.