bsdkrun/networks

Global networks — put machines on a shared subnet so they can reach each other by name.

Names resolve on Linux and FreeBSD via the network’s DNS; NetBSD resolves via a synced /etc/hosts block. Joins auto-sync, and sync refreshes an existing network without restarting its members.

Values

connect

</>

pub fn connect(
  machine: String,
  network: String,
) -> Result(Nil, error.Error)

Join machine to network. Applies on the machine’s next start.

create

</>

pub fn create(name: String) -> Result(Nil, error.Error)

Create a global network.

disconnect

</>

pub fn disconnect(machine: String) -> Result(Nil, error.Error)

Detach machine from its network. Applies on its next start.

list

</>

pub fn list() -> Result(List(types.NetworkInfo), error.Error)

List global networks.

members

</>

pub fn members(
  network: String,
) -> Result(List(types.SandboxInfo), error.Error)

The machines currently attached to network, running or stopped.

remove

</>

pub fn remove(
  names: List(String),
  force: Bool,
) -> Result(Nil, error.Error)

Remove one or more networks. force removes them even with members attached.

sync

</>

pub fn sync(network: String) -> Result(Nil, error.Error)

Re-push name resolution to every member of network, without restarting them.