Struct KernelBuilder 

pub struct KernelBuilder { /* private fields */ }

Boots a kernel directly, no bootloader (bsdkrun kernel).

Implementations

impl KernelBuilder

pub fn name(self, name: impl Into<String>) -> Self

Name the machine (--name).

pub fn cpus(self, cpus: u32) -> Self

vCPU count (--cpus).

pub fn mem(self, mib: u32) -> Self

Guest RAM in MiB (--mem).

pub fn port(self, forward: impl Into<String>) -> Self

Add a host->guest TCP port forward, "HOST:GUEST".

pub fn forward(self, host: u16, guest: u16) -> Self

Add a port forward from numbers instead of a string.

pub fn mac(self, mac: impl Into<String>) -> Self

Pin the guest MAC address (--mac).

pub fn network(self, network: impl Into<String>) -> Self

Join a global network (--network).

pub fn no_net(self) -> Self

Disable guest networking entirely (--no-net).

pub fn log_level(self, level: u32) -> Self

bsdkrun’s global --log-level for the create call (default 1, so boot diagnostics land in the error when a boot fails).

pub fn to_args(&self) -> Vec<String>

The exact argv create() will run (minus the binary and global flags) — for inspection and tests.

pub fn create(self) -> Result<Sandbox>

Boot the machine (detached) and return a handle to it.

pub fn persist(self) -> Self

Keep the root disk across rm (--persist).

pub fn volume(self, name: impl Into<String>) -> Self

Use a persistent CoW volume as the root disk (-v).

pub fn attach_disk(self, disk: impl Into<String>) -> Self

Attach an extra raw disk, "PATH" or "PATH:ro" (--attach-disk).

pub fn format(self, format: impl Into<String>) -> Self

Kernel image format (--format, e.g. "elf").

pub fn initramfs(self, path: impl Into<String>) -> Self

Initramfs image path (--initramfs takes a value for direct-kernel boots, unlike the Linux builder’s bare flag).

pub fn cmdline(self, cmdline: impl Into<String>) -> Self

Kernel command line (--cmdline).

pub fn disk(self, disk: impl Into<String>) -> Self

Root disk (--disk).

Trait Implementations

impl Clone for KernelBuilder

fn clone(&self) -> KernelBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KernelBuilder

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

Formats the value using the given formatter.