dope-sys 0.24.0

Typed operating-system call contracts
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

use std::convert::Infallible;

use crate::{engine::Buffer, io::Retry, memory, ring::map};

/// Ends the native reactor and its receive projection as one lifetime.
pub trait Shutdown: Buffer + Sized {
    type State: Cleanup;

    fn try_shutdown(self, context: Self::Context) -> Result<(), Self::State>;
}

/// Retains every resource needed to retry the exact failed shutdown phase.
pub trait Cleanup: Retry<Failure: Into<Failure<Self::Error>>> {
    type Error;

    fn failure(&self) -> Failure<Self::Error>;
}

/// Exact failure from the reactor or its retained receive storage.
#[derive(Debug, Eq, PartialEq)]
pub enum Failure<E> {
    Backend(map::Storage<E>),
    Context(memory::Error),
}

impl Cleanup for Infallible {
    type Error = Infallible;

    fn failure(&self) -> Failure<Self::Error> {
        match *self {}
    }
}

impl<E> From<Infallible> for Failure<E> {
    fn from(value: Infallible) -> Self {
        match value {}
    }
}