pub struct NspawnBackend { /* private fields */ }Expand description
systemd-nspawn sandbox backend.
Implementations§
Source§impl NspawnBackend
impl NspawnBackend
pub fn new(config: NspawnConfig) -> Self
Sourcepub fn with_rafs_store(self, rafs_store: Option<Arc<RafsStore>>) -> Self
pub fn with_rafs_store(self, rafs_store: Option<Arc<RafsStore>>) -> Self
Attach the RAFS image store used to compose the per-sandbox tenant VFS
for Model B (#715) FUSE-rooting. Threaded in from BackendCtx at
selection time (see the inventory registration below). Without a store,
nspawn behaves exactly as before — a host-root (--directory=/)
container, no tenant-VFS root.
Trait Implementations§
Source§impl Debug for NspawnBackend
impl Debug for NspawnBackend
Source§impl SandboxBackend for NspawnBackend
impl SandboxBackend for NspawnBackend
Source§fn backend_type(&self) -> &'static str
fn backend_type(&self) -> &'static str
Human-readable backend name (e.g.
"kata", "nspawn").Source§fn is_available(&self) -> bool
fn is_available(&self) -> bool
Check whether the backend’s runtime dependencies are available.
Source§fn initialize<'life0, 'life1, 'async_trait>(
&'life0 self,
_config: &'life1 PoolConfig,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn initialize<'life0, 'life1, 'async_trait>(
&'life0 self,
_config: &'life1 PoolConfig,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
One-time initialisation (verify paths, enable rootless mode, …).
Source§fn start<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
sandbox: &'life1 mut PodSandbox,
config: &'life2 PodSandboxConfig,
pool_config: &'life3 PoolConfig,
annotations: &'life4 HashMap<String, String>,
) -> Pin<Box<dyn Future<Output = Result<Arc<dyn SandboxHandle>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait,
fn start<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
sandbox: &'life1 mut PodSandbox,
config: &'life2 PodSandboxConfig,
pool_config: &'life3 PoolConfig,
annotations: &'life4 HashMap<String, String>,
) -> Pin<Box<dyn Future<Output = Result<Arc<dyn SandboxHandle>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait,
Start a sandbox and return the backend-specific handle.
Source§fn stop<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn stop<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Gracefully stop a running sandbox.
Source§fn destroy<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn destroy<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Destroy a sandbox and clean up all resources.
Source§fn reset<'life0, 'life1, 'async_trait>(
&'life0 self,
_sandbox: &'life1 mut PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn reset<'life0, 'life1, 'async_trait>(
&'life0 self,
_sandbox: &'life1 mut PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Reset a sandbox for warm-pool reuse. Read more
Source§fn get_pids<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Vec<u32>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn get_pids<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Vec<u32>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Get PIDs belonging to this sandbox (for monitoring / cgroup ops).
Source§fn deliver_namespace<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
_namespace: Namespace,
_subject: Subject,
transport: NamespaceTransport,
) -> Pin<Box<dyn Future<Output = Result<NamespaceDelivery>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn deliver_namespace<'life0, 'life1, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
_namespace: Namespace,
_subject: Subject,
transport: NamespaceTransport,
) -> Pin<Box<dyn Future<Output = Result<NamespaceDelivery>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn supports_exec(&self) -> bool
fn supports_exec(&self) -> bool
Whether
exec_sync is supported.Source§fn exec_sync<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
command: &'life2 [String],
timeout_secs: u64,
) -> Pin<Box<dyn Future<Output = Result<(i32, Vec<u8>, Vec<u8>)>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn exec_sync<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
command: &'life2 [String],
timeout_secs: u64,
) -> Pin<Box<dyn Future<Output = Result<(i32, Vec<u8>, Vec<u8>)>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Run a command synchronously inside the sandbox.
Source§fn update_resources<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
resources: &'life2 LinuxContainerResources,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn update_resources<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
sandbox: &'life1 PodSandbox,
resources: &'life2 LinuxContainerResources,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Apply resource limits to a running sandbox (optional).
Source§fn container_stats<'life0, 'life1, 'async_trait>(
&'life0 self,
_sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Option<(CpuUsage, MemoryUsage)>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn container_stats<'life0, 'life1, 'async_trait>(
&'life0 self,
_sandbox: &'life1 PodSandbox,
) -> Pin<Box<dyn Future<Output = Result<Option<(CpuUsage, MemoryUsage)>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Fetch live per-container resource usage from the sandbox’s guest. Read more
Auto Trait Implementations§
impl Freeze for NspawnBackend
impl !RefUnwindSafe for NspawnBackend
impl Send for NspawnBackend
impl Sync for NspawnBackend
impl Unpin for NspawnBackend
impl UnsafeUnpin for NspawnBackend
impl !UnwindSafe for NspawnBackend
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
Mutably borrows from an owned value. Read more
§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>
Converts
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>
Converts
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§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§impl<T> ServiceExt for T
impl<T> ServiceExt for T
§fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>where
Self: Sized,
fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>where
Self: Sized,
Apply a transformation to the response body. Read more
§fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>where
Self: Sized,
fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>where
Self: Sized,
High level tracing that classifies responses using HTTP status codes. Read more
§fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>where
Self: Sized,
fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>where
Self: Sized,
High level tracing that classifies responses using gRPC headers. Read more