pub struct KataHandle {
pub hypervisor: Arc<dyn Hypervisor>,
pub api_socket: PathBuf,
pub virtiofs_socket: Option<PathBuf>,
pub vfs_server: Option<SandboxFsServer>,
pub vfs_9p: Option<Vfs9pVsockServer>,
pub rootfs_mount_tag: Mutex<Option<String>>,
pub agent: Mutex<Option<Arc<KataAgentClient>>>,
}Expand description
Kata-specific state stored on each PodSandbox.
Fields§
§hypervisor: Arc<dyn Hypervisor>The Kata hypervisor handle for VM lifecycle management.
api_socket: PathBufPath to the VM API socket.
virtiofs_socket: Option<PathBuf>Path to the virtio-fs socket the guest mounts. Served by the composed
VFS namespace (vfs_server).
vfs_server: Option<SandboxFsServer>Per-sandbox composed VFS server (FS-D, #365). When set, the guest’s
filesystem is the hyprstream VFS (rootfs + injected mounts) served by
hyprstream-vfs-server. Held for the VM’s lifetime so the serving thread
- injected registries outlive the guest; dropped on sandbox teardown.
vfs_9p: Option<Vfs9pVsockServer>Per-sandbox tenant-VFS 9P-over-vsock channel (V2, #731). A second
vsock port (VFS_9P_VSOCK_PORT), distinct from the kata-agent’s 1024,
serving the same Subject-scoped tenant Mount as native 9P so an in-guest
9P client (V3, #732) can dial the host. Held for the VM’s lifetime; its
Drop aborts the serve task and removes the host UDS on sandbox
teardown. None when the sandbox has no tenant VFS (no image_id) or the
channel could not be stood up.
rootfs_mount_tag: Mutex<Option<String>>virtio-fs mount tag of the composed tenant VFS share attached to this
sandbox’s VM, when one was attached (#721). exec_sync passes this to
the kata-agent so CreateContainer mounts the share, by tag, as the
container’s rootfs. None when the VM booted its own rootfs with no
tenant VFS (e.g. sandbox.image_id unset).
Interior-mutable (parking_lot::Mutex) because the handle is shared
(Arc) once the sandbox has started: the post-start deliver_namespace
path (#742) composes+attaches a tenant VFS over virtio-fs after
construction and must record the resulting rootfs tag through a shared
&self — it has no &mut KataHandle. Both the boot path
(start()) and the delivery path write through
record_rootfs_mount_tag; readers
use rootfs_mount_tag. parking_lot
(not std::sync) so the lock is infallible — no poisoning, so no
unwrap/expect at the (-D clippy::unwrap_used) call sites.
agent: Mutex<Option<Arc<KataAgentClient>>>kata-agent ttrpc/vsock client (#344), connected lazily on first
exec_sync call and cached for subsequent calls. None until then,
or if the guest agent connection could not be established (e.g. the
VM image has no kata-agent, or it hasn’t finished booting yet).
Guarded by a tokio::sync::Mutex rather than stored as a plain
Option because exec_sync takes &PodSandbox (shared ref) and
must be able to lazily populate the connection on first use.
Implementations§
Source§impl KataHandle
impl KataHandle
Sourcepub fn rootfs_mount_tag(&self) -> Option<String>
pub fn rootfs_mount_tag(&self) -> Option<String>
Read the recorded container rootfs virtio-fs mount tag, if any.
Set either at boot (start() → the ROOTFS_MOUNT_TAG share) or by a
post-start deliver_namespace (#742). exec_sync reads this to tell the
kata-agent which virtio-fs share to mount, by tag, as the container
rootfs. Returns an owned clone so the lock is not held across the caller’s
.awaits.
Sourcepub fn record_rootfs_mount_tag(&self, tag: String)
pub fn record_rootfs_mount_tag(&self, tag: String)
Record the container rootfs virtio-fs mount tag through the shared
(Arc) handle.
Called from both the boot path and — the point of #742 — the post-start
deliver_namespace path, which composes+attaches the tenant VFS after
the handle is already Arc-shared and so cannot take &mut. A later
exec_sync then mounts the delivered share as the container rootfs.
Last write wins (a re-delivery replaces the prior tag).
Trait Implementations§
Source§impl Debug for KataHandle
impl Debug for KataHandle
Source§impl SandboxHandle for KataHandle
impl SandboxHandle for KataHandle
Auto Trait Implementations§
impl !Freeze for KataHandle
impl !RefUnwindSafe for KataHandle
impl Send for KataHandle
impl Sync for KataHandle
impl Unpin for KataHandle
impl UnsafeUnpin for KataHandle
impl !UnwindSafe for KataHandle
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more