dope 0.6.0

The manifold runtime
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
52
53
54
55

pub mod config;
pub mod link;
pub mod multishot;
mod tcp;
mod unix;
pub mod wire;

use std::io;
use std::net::SocketAddr;

use config::Submittable;
pub use tcp::Tcp;
pub use unix::Unix;

use crate::{Drive, Driver, backend};

pub trait Transport: 'static + Sized {
    type Addr;
    type StreamOpts: Default + Copy + 'static + Submittable;
    type ListenerOpts: Default + Clone + 'static;

    /// `recv(MSG_TRUNC)` frees bytes in-kernel without writing the buffer — true
    /// for TCP, false for AF_UNIX (which always copies).
    const KERNEL_DISCARD: bool = false;

    fn to_sock_addr(addr: Self::Addr) -> io::Result<backend::socket::Addr>;

    fn socket_params(addr: &Self::Addr) -> (i32, i32, i32);

    fn bind_listener_slot<'d>(
        driver: &'d Driver,
        addr: &Self::Addr,
        backlog: i32,
        opts: &Self::ListenerOpts,
    ) -> io::Result<(backend::socket::Fd<'d>, SocketAddr)>;

    fn submit_shutdown<'d>(fd: &backend::socket::Fd<'d>, how: i32, driver: &'d Driver) -> bool {
        driver.push(backend::sqe::Sqe::shutdown(fd, how)).is_ok()
    }

    fn submit_quickack<'d>(fd: &backend::socket::Fd<'d>, driver: &'d Driver) -> bool {
        let _ = (fd, driver);
        false
    }

    fn per_ip_cap(_opts: &Self::ListenerOpts) -> Option<u32> {
        None
    }

    fn apply_profile_defaults(
        _opts: &mut Self::StreamOpts,
        _user_timeout: Option<std::time::Duration>,
    ) {
    }
}