microsandbox-utils 0.2.6

`microsandbox-utils` is a library containing general utilities for the microsandbox project.
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

use async_trait::async_trait;
use tokio::{
    fs::File,
    io::unix::AsyncFd,
    process::{ChildStderr, ChildStdin, ChildStdout},
};

use crate::MicrosandboxUtilsResult;

//--------------------------------------------------------------------------------------------------
// Types
//--------------------------------------------------------------------------------------------------

/// The type of child IO to use.
pub enum ChildIo {
    /// A pseudo-TTY.
    TTY {
        /// The master read end of the pseudo-TTY.
        master_read: AsyncFd<std::fs::File>,

        /// The master write end of the pseudo-TTY.
        master_write: File,
    },

    /// Pipes for stdin, stdout, and stderr.
    Piped {
        /// The stdin pipe.
        stdin: Option<ChildStdin>,

        /// The stdout pipe.
        stdout: Option<ChildStdout>,

        /// The stderr pipe.
        stderr: Option<ChildStderr>,
    },
}

//--------------------------------------------------------------------------------------------------
// Traits
//--------------------------------------------------------------------------------------------------

/// A trait for monitoring processes
#[async_trait]
pub trait ProcessMonitor {
    /// Start monitoring a process
    async fn start(&mut self, pid: u32, child_io: ChildIo) -> MicrosandboxUtilsResult<()>;

    /// Stop monitoring
    async fn stop(&mut self) -> MicrosandboxUtilsResult<()>;
}