pasque 0.3.0

UDP and IP over HTTP/3
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

//! Platform specific network operations
//! 
//! Implements operations for configuring routes and addresses for tunnel. So
//! far only Linux is supported.

#[cfg(target_os = "linux")]
pub mod linux;
#[cfg(target_os = "linux")]
pub use linux as platform;

use crate::PsqError;


/// Platform-specific functions for networking operations.
/// 
/// If a function is not supported in the current platform, returns [PsqError::Unimplemented].
pub trait OsNetworking {
    /// Add IP route to given destination prefix.
    /// 
    /// `destination` is given as string in CIDR notation.
    fn add_route(&self, destination: &str, ifname: &String) -> Result<(), PsqError>;

    /// Assign IP address to given interface.
    fn add_address(&self, addr: &str, ifname: &String) -> Result<(), PsqError>;
}


/// Return a correct type of OsNetworking instance based on the current
/// platform.
/// 
/// For the time being only Linux is supported.
pub fn get_os_networking() -> Box<dyn OsNetworking> {
    #[cfg(target_os = "linux")]
    return Box::new(linux::LinuxNetworking);

    #[cfg(not(target_os = "linux"))]
    return Box::new(NotImplementedNetworking);
}


pub struct NotImplementedNetworking;

impl OsNetworking for NotImplementedNetworking {
    fn add_route(&self, _destination: &str, _ifname: &String) -> Result<(), PsqError> {
        Err(PsqError::Unimplemented)
    }

    fn add_address(&self, _addr: &str, _ifname: &String) -> Result<(), PsqError> {
        Err(PsqError::Unimplemented)
    }
}