zlayer-gcs 0.12.2

Host-side bridge to the Hyper-V Guest Compute Service (GCS) running inside a UVM
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

//! GCS (Guest Compute Service) bridge for Windows Hyper-V utility VMs.
//!
//! Host-side library that connects to a running UVM's in-guest GCS over an
//! hvsock (Hyper-V virtual socket), negotiates the GCS protocol, and
//! dispatches RPCs (`CreateContainer`, `ExecuteProcess`, `ModifySettings`, ...).
//!
//! Mirrors hcsshim's `internal/gcs/{guestconnection.go, container.go,
//! prot/protocol.go}` Go reference implementation.
//!
//! All FFI sits behind `#[cfg(target_os = "windows")]` — the crate compiles
//! cleanly on non-Windows hosts (with the public types stubbed) so the rest
//! of the workspace stays buildable on Linux/`macOS` dev boxes.

#![cfg_attr(not(target_os = "windows"), allow(dead_code, unused_imports))]
#![deny(rust_2018_idioms)]
#![warn(clippy::pedantic, clippy::nursery)]
#![allow(
    clippy::module_name_repetitions,
    clippy::missing_errors_doc,
    clippy::missing_panics_doc
)]

pub mod bridge;
pub mod diagnostics;
pub mod error;
pub mod frame;
/// Host-side receiver for the in-guest GCS log-forward stream.
///
/// Only meaningful (non-empty) on Windows with the `windows-debug` feature;
/// see the module docs for the hcsshim mechanism it mirrors.
#[cfg(all(target_os = "windows", feature = "windows-debug"))]
pub mod log_forward;
pub mod protocol;
pub mod transport;

pub use error::{GcsError, GcsResult};

#[cfg(test)]
mod tests {
    #[test]
    fn crate_exports_compile() {
        // Just ensures every public symbol typechecks.
        let _: super::GcsError = std::io::Error::other("x").into();
    }
}