Struct BranchBuilder 

pub struct BranchBuilder { /* private fields */ }

A branchSnapshot mutation being assembled — see Client::branch.

Unlike the run_* builders this has no NetOpts: a branch inherits the snapshot’s own port forwards unless told otherwise, and the guest’s network identity comes from the snapshot, not from the caller.

Implementations

impl BranchBuilder

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

Name the new machine. Generated when unset.

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

vCPU count. Defaults to what the snapshot recorded.

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

Guest RAM in MiB. Defaults to what the snapshot recorded.

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

Add a host→guest forward, "[BIND:]HOST:GUEST". Given at least one, these replace the snapshot’s recorded forwards.

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

Add a port forward from numbers instead of a string.

pub fn no_ports(self) -> Self

Forward nothing, ignoring what the snapshot recorded.

pub fn launch(self) -> Result<String>

Boot the branch and return its machine id.

With no port set, the snapshot’s own forwards are inherited — with any host port that is already taken swapped for a free one, since the machine the snapshot came from is usually still running on it.