dope-sys 0.26.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
39
40
41
42
43
44
45

use std::{iter, mem};

use crate::{Errno, kernel::errno};

pub mod signal;
pub mod timer;

pub mod affinity;
mod attrs;
mod handle;
pub mod raw;

pub use attrs::Attrs;
pub use handle::Handle;

/// Smallest stack extent the C library accepts for one spawned thread.
pub const STACK_MIN: usize = libc::PTHREAD_STACK_MIN;

/// Native thread services and their backend-specific signal and timer owners.
pub trait Thread: errno::Source {
    type Cpus: DoubleEndedIterator<Item = affinity::raw::Cpu>
        + ExactSizeIterator
        + iter::FusedIterator;
    type Timer: crate::Timer;
    type Receiver: signal::raw::Receiver;

    fn current() -> Result<Self::Cpus, affinity::Error>;
    fn bind(cpu: affinity::raw::Cpu) -> Result<(), affinity::Error>;

    /// Returns whether the caller is the process's original thread.
    fn is_main() -> bool;

    /// Admits the native IEEE CRC32 backend without shared feature state.
    /// A denied native query retains its exact errno; callers may use software CRC.
    fn try_crc32() -> Result<bool, Errno> {
        raw::try_crc32(Self::read)
    }

    /// Initializes N caller-owned bytes from the operating system; N must not exceed 256.
    fn entropy<const N: usize>(
        bytes: &mut mem::MaybeUninit<[u8; N]>,
    ) -> Result<&mut [u8; N], Errno> {
        raw::entropy::<Self, N>(bytes)
    }
}