dope-net 0.24.0

Owned network transports for dope
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

use dope_core::{
    dope_sys::engine::admit::Cancelled,
    driver::{
        self,
        result::SubmitCause,
        retained::{
            self,
            flight::{self, cancel},
        },
        route::{self, Identity, kind},
    },
    io::{
        fd::handles,
        socket::{self, option, pending},
        transfer,
    },
};
use o3::base::time::Positive;

use crate::link::{
    self,
    oneshot::{Error, phase, phase::Phase},
};

pub(super) struct Creating<'d> {
    pub(super) socket: handles::Creation<'d>,
    pub(super) options: option::Set,
    pub(super) send_window: Positive,
}
pub(super) struct ConnectRetry<'d> {
    pub(super) fd: handles::Descriptor<'d>,
    pub(super) options: option::Set,
    pub(super) send_window: Positive,
}
pub(super) struct Connecting<'d> {
    pub(super) pending: pending::Connection<'d>,
    pub(super) send_window: Positive,
}
pub(super) struct Sending<'d> {
    pub(super) fd: handles::Descriptor<'d>,
    pub(super) flight: flight::Flight<'d, kind::Send>,
    pub(super) bytes: transfer::NonZero,
}

impl<'d> ConnectRetry<'d> {
    pub(super) fn submit<ID: Identity, A: socket::Prepared>(
        self,
        addr: &A,
        target: route::Target<'d, ID>,
        slots: &flight::Slots<'d, ID>,
        driver: &mut retained::Context<'_, '_, 'd>,
    ) -> (Phase<'d>, phase::Dial<'d>) {
        let Self {
            fd,
            options: opts,
            send_window: window,
        } = self;
        match link::Connect::new(fd, addr, target).submit(slots, driver.reborrow(), opts) {
            Ok(pending) => (
                Phase::Connecting(Connecting {
                    pending,
                    send_window: window,
                }),
                phase::Dial::Pending,
            ),
            Err(reject) => {
                let (fd, cause) = reject.into_parts();
                match cause {
                    pending::Cause::Submit(error) => match error.cause() {
                        SubmitCause::Full => (
                            Phase::ConnectRetry(Self {
                                fd,
                                options: opts,
                                send_window: window,
                            }),
                            phase::Dial::Retry(error),
                        ),
                        SubmitCause::IdentityExhausted => (
                            Phase::Retired,
                            phase::Dial::Failed(Error::Submit(error), fd),
                        ),
                    },
                    pending::Cause::Option(error) => (
                        Phase::Retired,
                        phase::Dial::Failed(Error::Option(error), fd),
                    ),
                }
            }
        }
    }
}

impl<'d> Connecting<'d> {
    pub(super) fn cancel(
        self,
        driver: &mut driver::Context<'_, 'd>,
    ) -> (Phase<'d>, Result<phase::Cancellation<'d>, cancel::Failure>) {
        let Self {
            pending,
            send_window: window,
        } = self;
        match pending.try_cancel(driver) {
            Ok(pending) => (
                Phase::ConnectingCancelled(pending),
                Ok(phase::Cancellation::Pending),
            ),
            Err((pending, error)) => {
                let phase = Phase::Connecting(Self {
                    pending,
                    send_window: window,
                });
                match error {
                    cancel::Error::Full(error) => (phase, Ok(phase::Cancellation::Retry(error))),
                    cancel::Error::Rejected(cause) => (phase, Err(cause)),
                }
            }
        }
    }
}

impl<'d> Sending<'d> {
    pub(super) fn cancel(
        mut self,
        driver: &mut driver::Context<'_, 'd>,
    ) -> (Phase<'d>, Result<phase::Cancellation<'d>, cancel::Failure>) {
        let result = match self.flight.try_cancel(driver) {
            Ok(status) => match status {
                Cancelled::Submitted | Cancelled::Queued | Cancelled::Completed => {
                    Ok(phase::Cancellation::Pending)
                }
            },
            Err(cancel::Error::Full(error)) => Ok(phase::Cancellation::Retry(error)),
            Err(cancel::Error::Rejected(cause)) => Err(cause),
        };
        (Phase::Sending(self), result)
    }
}