Expand description
Host-only control protocol, independent of the guest agent’s generation.
Structs§
- Branch
Create - Capture directly into a reserved child-owned local handoff directory.
- Branch
Result - Completed direct local branch handoff.
- Capabilities
- Facilities available for this runtime and VM configuration.
- Checkpoint
Create - Create one same-epoch full checkpoint.
- Checkpoint
Result - Full-checkpoint completion, including a published result whose source recovery failed.
- Checkpoint
State - Published full-checkpoint state.
- Control
Error - A recoverable peer error. Codes stay strings for future interoperability.
- Control
Hello - Opening framed-control offer. The envelope generation is always one.
- Control
Message Type Iter - An iterator over the variants of ControlMessageType
- Control
Welcome - Selected generation and limits. The welcome envelope is always generation one.
- CpuState
- CPU capacity, accepted target, observation, and enforcement.
- CpuTarget
- Native CPU-target payload.
- Disk
Checkpoint Create - Seal the owned root disk without capturing RAM or execution state.
- Disk
Checkpoint State - Complete disk-only capture result.
- Disk
Compact - Compact selected sandbox-owned disk chains.
- Empty
- Empty map payload for state and capability queries.
- Json
Control Response - Existing JSON response with an additive discovery advertisement.
- Memory
State - Accepted and observed memory quantities, all in MiB.
- Memory
Target - Native memory-target payload, without SDK convergence policy.
- Pause
- Pause the runtime, optionally requiring guest writeback first.
- Pause
State - Host-confirmed resident suspension state.
- Root
Disk Grow - Grow the owned root disk and its mounted filesystem.
- Root
Disk State - Verified root-disk growth and measured phases.
- Runtime
Capabilities - Complete generation-two runtime facility inventory.
- Secret
Value - Secret material that is redacted in diagnostics and cleared on drop.
- Secrets
Update - Sequential, non-transactional secret modifications.
Enums§
- Checkpoint
Capture Intent - Purpose of a full checkpoint capture.
- Control
Message Type - Known control wire names. The strum spelling is the authoritative mapping.
- Control
Operation - One decoded application operation across all negotiated control generations.
- Control
Request - Legacy JSON request, also used as a checked dispatch representation.
- Error
Effect - State mutation certainty reported by an operation error.
- Secret
Change - One ordered host secret modification, preserving the JSON operation tags.
- Secrets
Result - Completion of a sequential secret batch.
Constants§
- CONTROL_
GENERATION - Current framed host-control generation.
- CONTROL_
GENERATION_ TWO_ MESSAGES - Application messages introduced by framed control generation two.
- CONTROL_
HANDSHAKE_ GENERATION - Stable generation of hello, welcome, and setup errors.
- CONTROL_
PROTOCOL - Stable protocol discriminator; it does not authenticate a peer.
- DEFAULT_
MAX_ IN_ FLIGHT - Maximum outstanding control IDs on a default connection.
- DEFAULT_
REQUEST_ TIMEOUT - Default local request wait, which never cancels or retries a mutation.
- DEFAULT_
SETUP_ TIMEOUT - Default deadline for the complete automatic connection setup.
- MAX_
DISCOVERY_ RESPONSE_ SIZE - Bound for JSON capability responses consumed during discovery.
- MAX_
HANDSHAKE_ FRAME_ SIZE - The opening frame stays small and zero-prefixed across future generations.
- MIN_
CONTROL_ GENERATION - Oldest framed host-control generation retained for released 0.7.x peers.
Functions§
- control_
message_ min_ generation - Generation in which a known application message first became available.
Type Aliases§
- Disk
Compaction Result - Aggregate disk-compaction result shared with SDK-facing types.