Enum Backend 

pub enum Backend {
    Ptrace,
    Liteinst,
    InGuestTrap,
    Kvm,
}

Process instrumentation backend used to run a Hermit guest.

Variants

Ptrace

Use Reverie’s ptrace backend.

Liteinst

Use LiteInst, with Detcore’s Tool running inside the guest.

InGuestTrap

Use in-guest LiteInst with syscall site patching off: the same in-guest Detcore host as liteinst, but every trapped syscall reaches the Tool through the seccomp SIGSYS fallback and no syscall site is rewritten. Hermit sets REVERIE_LITEINST_SITE_PATCHING=0 in the guest’s environment and refuses a run whose environment asks for any other value.

Kvm

Use the KVM backend.

Implementations

impl Backend

pub const fn as_str(self) -> &'static str

Returns the command-line spelling for this backend.

pub const fn is_in_guest_liteinst(self) -> bool

Whether this backend hosts Detcore’s Tool inside each guest process through the in-guest LiteInst preload runtime: liteinst and in-guest-trap, which differ only in whether syscall sites are patched. Every refusal, capability and launch step of in-guest LiteInst applies to both.

pub const fn runtime_name(self) -> &'static str

The name of the backend runtime that executes this backend’s guest, as its statistics source names itself (BackendStatsSnapshot::BACKEND_NAME). in-guest-trap runs the in-guest LiteInst runtime, so its statistics come from that runtime’s source, which is named liteinst.

pub fn available() -> impl Iterator<Item = Self>

Returns backends whose Hermit integration prerequisites are met.

Some integrations use CLI launch adapters rather than direct run_with_backend dispatch.

pub fn is_available(self) -> bool

Returns whether this backend’s integration prerequisites are met.

pub fn ensure_available(self) -> Result<(), Error>

Returns an actionable error when this backend’s prerequisites are not met.

pub fn ensure_available_for(self, namespaces: NamespaceUse) -> Result<(), Error>

Backend::ensure_available for a run that creates namespaces: a --no-namespace ptrace run is not refused where only unshare of a user namespace is denied, since it never makes that call; the ptrace and seccomp probes still apply.

Trait Implementations

impl Clone for Backend

fn clone(&self) -> Backend

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Backend

impl Debug for Backend

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

Formats the value using the given formatter.

impl Default for Backend

fn default() -> Backend

Returns the “default value” for a type.

impl Eq for Backend

impl PartialEq for Backend

fn eq(&self, other: &Backend) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Backend

impl ValueEnum for Backend

fn value_variants<'a>() -> &'a [Self]

All possible argument values, in display order.

fn to_possible_value<'a>(&self) -> Option<PossibleValue>

The canonical argument value.

fn from_str(input: &str, ignore_case: bool) -> Result<Self, String>

Parse an argument into Self.