membase 0.2.1

Ultra-high performance async runtime with fast task cycling, lock-free scheduling, and zero-overhead performance
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

//! Error handling for memory mapping operations.

use std::fmt;
use std::io;
use std::result;

/// A specialized `Result` type for memory mapping operations.
pub type Result<T> = result::Result<T, Error>;

/// Errors that can occur during memory mapping operations.
#[derive(Debug)]
pub enum Error {
    /// An I/O error occurred.
    Io(io::Error),
    
    /// The memory map size is zero.
    ZeroSizedMapping,
    
    /// The requested memory map size exceeds system limits.
    SizeExceedsSystemLimit,
    
    /// Failed to allocate huge pages.
    HugePageAllocationFailed,
    
    /// NUMA allocation failed.
    NumaAllocationFailed,
    
    /// Memory protection error.
    ProtectionError,
    
    /// Memory alignment error.
    AlignmentError,
    
    /// Invalid argument provided.
    InvalidArgument(String),
    
    /// Platform-specific error with error code.
    PlatformError(i32),
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::Io(err) => write!(f, "I/O error: {}", err),
            Error::ZeroSizedMapping => write!(f, "Memory map size cannot be zero"),
            Error::SizeExceedsSystemLimit => write!(f, "Requested memory map size exceeds system limits"),
            Error::HugePageAllocationFailed => write!(f, "Failed to allocate huge pages"),
            Error::NumaAllocationFailed => write!(f, "NUMA memory allocation failed"),
            Error::ProtectionError => write!(f, "Memory protection error"),
            Error::AlignmentError => write!(f, "Memory alignment error"),
            Error::InvalidArgument(msg) => write!(f, "Invalid argument: {}", msg),
            Error::PlatformError(code) => write!(f, "Platform-specific error code: {}", code),
        }
    }
}

impl std::error::Error for Error {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        match self {
            Error::Io(err) => Some(err),
            _ => None,
        }
    }
}

impl From<io::Error> for Error {
    fn from(err: io::Error) -> Error {
        Error::Io(err)
    }
}