rtnetlink 0.21.0

manipulate linux networking resources via netlink
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

// SPDX-License-Identifier: MIT

use netlink_packet_route::route::RouteMessage;

use crate::{Handle, RouteAddRequest, RouteDelRequest, RouteGetRequest};

#[derive(Debug, Clone)]
pub struct RouteHandle(Handle);

impl RouteHandle {
    pub fn new(handle: Handle) -> Self {
        RouteHandle(handle)
    }

    /// Retrieve the list of routing table entries (equivalent to `ip route
    /// show`)
    /// The `RouteMessage` could be built by [crate::RouteMessageBuilder].
    /// In order to perform kernel side filter, please enable
    /// `NETLINK_GET_STRICT_CHK` via
    /// `rtnetlink::sys::Socket::set_netlink_get_strict_chk(true)`.
    pub fn get(&self, route: RouteMessage) -> RouteGetRequest {
        RouteGetRequest::new(self.0.clone(), route)
    }

    /// Add an routing table entry (equivalent to `ip route add`)
    /// The `RouteMessage` could be built by [crate::RouteMessageBuilder].
    pub fn add(&self, route: RouteMessage) -> RouteAddRequest {
        RouteAddRequest::new(self.0.clone(), route)
    }

    /// Delete the given routing table entry (equivalent to `ip route del`)
    /// The `RouteMessage` could be built by [crate::RouteMessageBuilder].
    pub fn del(&self, route: RouteMessage) -> RouteDelRequest {
        RouteDelRequest::new(self.0.clone(), route)
    }
}