a3s-box-runtime 3.2.3

MicroVM runtime engine — VM lifecycle, OCI images, attestation, networking
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

//! Stable, bounded host paths used by VM and Sandbox runtimes.

use std::path::{Path, PathBuf};

pub(crate) fn runtime_socket_dir(home_dir: &Path, box_id: &str) -> PathBuf {
    #[cfg(all(unix, target_os = "macos"))]
    {
        let _ = home_dir;
        PathBuf::from("/private/tmp")
            .join("a3s-box-sockets")
            .join(box_id)
    }

    #[cfg(all(unix, not(target_os = "macos")))]
    {
        let _ = home_dir;
        PathBuf::from("/tmp").join("a3s-box-sockets").join(box_id)
    }

    #[cfg(not(unix))]
    {
        home_dir.join("boxes").join(box_id).join("sockets")
    }
}

/// Short host path for one Sandbox runtime owner and its private control socket.
///
/// Unix-domain socket paths have a small fixed kernel limit. Keeping the A3S
/// OCI root below the already-short external socket directory makes Sandbox
/// startup independent of the configured A3S home path length.
pub(crate) fn sandbox_runtime_root(home_dir: &Path, box_id: &str) -> PathBuf {
    runtime_socket_dir(home_dir, box_id).join("oci")
}

/// Runtime root used before Sandbox owners moved beside the short socket paths.
pub(crate) fn legacy_sandbox_runtime_root(home_dir: &Path, box_id: &str) -> PathBuf {
    home_dir.join("run").join("a3s-oci").join(box_id)
}