oxios-kernel 1.20.0

Oxios kernel: supervisor, event bus, state store
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

//! Error type for PTY subsystem (RFC-038).
use thiserror::Error;

#[derive(Debug, Error)]
pub enum PtyError {
    /// Master switch disabled in config.
    #[error("pty subsystem is disabled in config")]
    Disabled,

    /// Per-principal session cap reached.
    #[error("session cap reached for principal: max {max}")]
    SessionCapReached { max: u32 },

    /// Requested shell binary is not in `allowed_shells` allowlist.
    #[error("shell not allowed: {shell:?}")]
    ShellNotAllowed { shell: String },

    /// Spawning the PTY child process failed.
    #[error("failed to spawn pty: {0}")]
    Spawn(String),

    /// Resize / write / close on an unknown session.
    #[error("session not found: {0}")]
    NotFound(String),

    /// Resize / write on a closed session.
    #[error("session {0} is closed")]
    Closed(String),

    /// Resize / write on a session owned by another principal.
    #[error("session {0} not owned by caller")]
    NotOwner(String),

    /// Master/slave I/O error.
    #[error("pty io: {0}")]
    Io(String),
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn display_messages() {
        assert_eq!(
            PtyError::Disabled.to_string(),
            "pty subsystem is disabled in config"
        );
        assert_eq!(
            PtyError::SessionCapReached { max: 3 }.to_string(),
            "session cap reached for principal: max 3"
        );
        assert_eq!(
            PtyError::ShellNotAllowed {
                shell: "fish".into()
            }
            .to_string(),
            "shell not allowed: \"fish\""
        );
    }
}