Struct GuestClient 

pub struct GuestClient<T> { /* private fields */ }

Guest agent management

Implementations

impl GuestClient<Channel>

pub async fn connect<D>(dst: D) -> Result<Self, Error>

where D: TryInto<Endpoint>, D::Error: Into<StdError>,

Attempt to create a new client by connecting to a given endpoint.

impl<T> GuestClient<T>

where T: GrpcService<BoxBody>, T::Error: Into<StdError>, T::ResponseBody: Body<Data = Bytes> + Send + 'static, <T::ResponseBody as Body>::Error: Into<StdError> + Send,

pub fn new(inner: T) -> Self

pub fn with_origin(inner: T, origin: Uri) -> Self

pub fn with_interceptor<F>( inner: T, interceptor: F, ) -> GuestClient<InterceptedService<T, F>>

where F: Interceptor, T::ResponseBody: Default, T: Service<Request<BoxBody>, Response = Response<<T as GrpcService<BoxBody>>::ResponseBody>>, <T as Service<Request<BoxBody>>>::Error: Into<StdError> + Send + Sync,

pub fn send_compressed(self, encoding: CompressionEncoding) -> Self

Compress requests with the given encoding.

This requires the server to support it otherwise it might respond with an error.

pub fn accept_compressed(self, encoding: CompressionEncoding) -> Self

Enable decompressing responses.

pub fn max_decoding_message_size(self, limit: usize) -> Self

Limits the maximum size of a decoded message.

Default: 4MB

pub fn max_encoding_message_size(self, limit: usize) -> Self

Limits the maximum size of an encoded message.

Default: usize::MAX

pub async fn init( &mut self, request: impl IntoRequest<GuestInitRequest>, ) -> Result<Response<GuestInitResponse>, Status>

Initialize guest environment (mounts, network) MUST be called first after connection, before Container.Init

pub async fn ping( &mut self, request: impl IntoRequest<PingRequest>, ) -> Result<Response<PingResponse>, Status>

Health check

pub async fn shutdown( &mut self, request: impl IntoRequest<ShutdownRequest>, ) -> Result<Response<ShutdownResponse>, Status>

Shutdown guest agent gracefully

pub async fn quiesce( &mut self, request: impl IntoRequest<QuiesceRequest>, ) -> Result<Response<QuiesceResponse>, Status>

Quiesce all writable filesystems (FIFREEZE ioctl). Flushes dirty pages and blocks new writes atomically. Used before SIGSTOP for point-in-time consistent snapshots. Follows QEMU guest-agent’s guest-fsfreeze-freeze protocol.

pub async fn thaw( &mut self, request: impl IntoRequest<ThawRequest>, ) -> Result<Response<ThawResponse>, Status>

Thaw previously quiesced filesystems (FITHAW ioctl). Must be called after SIGCONT to unblock writes.

Trait Implementations

impl<T: Clone> Clone for GuestClient<T>

fn clone(&self) -> GuestClient<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for GuestClient<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.