sprawling-runtime 0.0.10

One run of a sprawling resident, from dispatch to freeze: turns, tools, replay and the sandbox that executes code.
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

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
// Copyright (c) 2026 2youg1 and the sprawling contributors

//! A member's actual execution owner (`crates/runtime/spec/Tools/Exec/Container.lean`).

use std::process::Child;

use kernel::{AxCode, AxError};

use crate::tools::ContainerLease;

use super::Exit;

pub(super) enum Process {
    Host(Child),
    #[cfg(windows)]
    Native(Box<desktop_ffi::confinement::OwnedProcess>),
    Container(Box<ContainerLease>),
}

impl Process {
    pub(super) fn client(&self) -> Option<&Child> {
        match self {
            Self::Host(child) => Some(child),
            #[cfg(windows)]
            Self::Native(_) => None,
            Self::Container(lease) => lease.client(),
        }
    }

    pub(super) fn poll(&mut self) -> Result<Option<Exit>, AxError> {
        match self {
            Self::Host(child) => Ok(Exit::polled(child)),
            #[cfg(windows)]
            Self::Native(child) => child
                .try_wait()
                .map(|exit| {
                    exit.map(|code| Exit::Ended {
                        code: i32::from_ne_bytes(code.to_ne_bytes()),
                    })
                })
                .map_err(|err| {
                    crate::tools::native_windows::denied("poll the native process", err)
                }),
            Self::Container(lease) => lease.poll(),
        }
    }

    pub(super) fn stop(&mut self) -> Result<(), AxError> {
        match self {
            Self::Host(child) => child.kill().map_err(|err| {
                AxError::failure(
                    AxCode::ToolUnavailable,
                    "stop the backlog process",
                    err.to_string(),
                )
                .with_recovery("retry Halt; the backlog retains this process")
            }),
            #[cfg(windows)]
            Self::Native(child) => child.kill().map_err(|err| {
                crate::tools::native_windows::denied("stop the native process tree", err)
            }),
            Self::Container(lease) => lease.stop(),
        }
    }
}