hl-engine 0.1.17

Safe Rust lifecycle API for the standalone HL Linux guest engine
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
69

//! Observability and debugger launch policy.

use std::collections::BTreeSet;

use super::DebugOperation;

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct ObservabilitySpec {
    pub lifecycle_events: bool,
    pub syscall_sampling: Option<u32>,
    pub metrics: bool,
    pub events: BTreeSet<EventKind>,
    pub metric_kinds: BTreeSet<MetricKind>,
    pub queue_capacity: Option<u32>,
    pub trace: Option<TraceSpec>,
}
#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
pub enum EventKind {
    Machine,
    Process,
    Thread,
    Exec,
    Signal,
    Fault,
    Syscall,
    Translation,
    Cache,
    Memory,
    Descriptor,
    Filesystem,
    Network,
    Provider,
    Checkpoint,
}
#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
pub enum MetricKind {
    Cpu,
    Memory,
    Translation,
    Cache,
    Syscall,
    Filesystem,
    Network,
    Provider,
}
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct TraceSpec {
    pub queue_capacity: u32,
    pub include_guest_time: bool,
    pub include_host_time: bool,
    pub privacy: TracePrivacy,
}
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum TracePrivacy {
    MetadataOnly,
    Arguments,
}

#[derive(Clone, Debug, Default, Eq, PartialEq)]
pub struct DebugSpec {
    pub authorization: Option<DebugAuthorization>,
    pub operations: BTreeSet<DebugOperation>,
    pub breakpoints: u32,
    pub watchpoints: u32,
}
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct DebugAuthorization {
    pub capability: Vec<u8>,
}