aegis-resource 0.1.1

Resource management for the Aegis WebAssembly sandbox
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

//! Error types for resource management.

use thiserror::Error;

/// Errors related to resource management.
#[derive(Debug, Error)]
pub enum ResourceError {
    /// Memory allocation failed.
    #[error("Memory allocation failed: requested {requested} bytes, available {available} bytes")]
    MemoryAllocationFailed {
        /// Requested memory in bytes.
        requested: usize,
        /// Available memory in bytes.
        available: usize,
    },

    /// Memory limit exceeded.
    #[error("Memory limit exceeded: {used} bytes used, limit is {limit} bytes")]
    MemoryLimitExceeded {
        /// Memory used in bytes.
        used: usize,
        /// Memory limit in bytes.
        limit: usize,
    },

    /// Fuel exhausted.
    #[error("Fuel exhausted: consumed {consumed} units, limit was {limit} units")]
    FuelExhausted {
        /// Fuel consumed.
        consumed: u64,
        /// Fuel limit.
        limit: u64,
    },

    /// Refuel request denied.
    #[error("Refuel denied: {reason}")]
    RefuelDenied {
        /// Reason for denial.
        reason: String,
    },

    /// Execution timeout.
    #[error("Execution timeout after {elapsed:?}, limit was {limit:?}")]
    Timeout {
        /// Time elapsed.
        elapsed: std::time::Duration,
        /// Time limit.
        limit: std::time::Duration,
    },

    /// Stack overflow.
    #[error("Stack overflow")]
    StackOverflow,

    /// Table size exceeded.
    #[error("Table size exceeded: {current} elements, limit is {limit} elements")]
    TableSizeExceeded {
        /// Current table size.
        current: u32,
        /// Table size limit.
        limit: u32,
    },

    /// Epochs are disabled.
    #[error("Epoch-based interruption is disabled in the engine configuration")]
    EpochsDisabled,

    /// Fuel is disabled.
    #[error("Fuel consumption is disabled in the engine configuration")]
    FuelDisabled,

    /// Failed to spawn thread.
    #[error("Failed to spawn thread: {0}")]
    ThreadSpawnFailed(String),

    /// Configuration error.
    #[error("Invalid resource configuration: {0}")]
    InvalidConfig(String),
}

/// Result type for resource operations.
pub type ResourceResult<T> = std::result::Result<T, ResourceError>;