internal/

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
backend Package backend defines the interface for VM backends.	Package backend defines the interface for VM backends.
cloudhypervisor Package cloudhypervisor implements the backend interface using cloud-hypervisor on Linux.	Package cloudhypervisor implements the backend interface using cloud-hypervisor on Linux.
fake Package fake is a dumb, instant, pure-Go implementation of the backend interfaces used to exercise the cross-process coordination layer (client ↔ helper ↔ holder) on a CI runner that cannot boot a real VM.	Package fake is a dumb, instant, pure-Go implementation of the backend interfaces used to exercise the cross-process coordination layer (client ↔ helper ↔ holder) on a CI runner that cannot boot a real VM.
remote Package remote is a pure-Go backend.Backend that drives a spawned helper over the control protocol instead of touching a hypervisor directly.	Package remote is a pure-Go backend.Backend that drives a spawned helper over the control protocol instead of touching a hypervisor directly.
control Package control is the client half of the holder protocol: it spawns a holder process, waits for its members to come up, and drives them (createnetwork/ reserve/boot-member/status/stop) over the per-member unix sockets.	Package control is the client half of the holder protocol: it spawns a holder process, waits for its members to come up, and drives them (createnetwork/ reserve/boot-member/status/stop) over the per-member unix sockets.
dhcp Package dhcp parses macOS dhcpd_leases file to discover VM IP addresses.	Package dhcp parses macOS dhcpd_leases file to discover VM IP addresses.
fetch Package fetch downloads and caches remote files (cloud images, VMM binaries, firmware), verifying an optional SHA256 and writing atomically so a cached file is always complete.	Package fetch downloads and caches remote files (cloud images, VMM binaries, firmware), verifying an optional SHA256 and writing atomically so a cached file is always complete.
fixture Package fixture packs a host directory into a read-only ext4 filesystem image for attaching to a VM as a block device (ADR-0015).	Package fixture packs a host directory into a read-only ext4 filesystem image for attaching to a VM as a block device (ADR-0015).
helperdist Package helperdist resolves the signed fleetbox-helper binary the darwin client drives: it returns a locally pre-staged helper named by the FLEETBOX_HELPER environment variable, or downloads the checksum-pinned helper for this platform into ~/.fleetbox/bin, strips its Gatekeeper quarantine, and makes it executable.	Package helperdist resolves the signed fleetbox-helper binary the darwin client drives: it returns a locally pre-staged helper named by the FLEETBOX_HELPER environment variable, or downloads the checksum-pinned helper for this platform into ~/.fleetbox/bin, strips its Gatekeeper quarantine, and makes it executable.
holder Package holder is the server half of the holder protocol: one process owns one cluster — its shared network and every VM on it — so a cluster gets the same VM↔VM connectivity the library StartN gives (ADR-0008).	Package holder is the server half of the holder protocol: one process owns one cluster — its shared network and every VM on it — so a cluster gets the same VM↔VM connectivity the library StartN gives (ADR-0008).
image Package image handles cloud image download, verification, and conversion.	Package image handles cloud image download, verification, and conversion.
opts Package opts holds the backend-neutral VM creation options.	Package opts holds the backend-neutral VM creation options.
orchestrator Package orchestrator owns the VM lifecycle CLIENT-SIDE: it resolves the per-call dependencies (store, SSH key, image), spawns the VM helper, creates the network and boots/waits/tears down members by driving that helper over the control protocol.	Package orchestrator owns the VM lifecycle CLIENT-SIDE: it resolves the per-call dependencies (store, SSH key, image), spawns the VM helper, creates the network and boots/waits/tears down members by driving that helper over the control protocol.
seed Package seed creates cloud-init NoCloud seed ISOs.	Package seed creates cloud-init NoCloud seed ISOs.
sshkey Package sshkey manages SSH key generation and provides an SSH client for VM access.	Package sshkey manages SSH key generation and provides an SSH client for VM access.
store Package store manages VM state directories under ~/.fleetbox/clusters/<cluster>/<member>/.	Package store manages VM state directories under ~/.fleetbox/clusters/<cluster>/<member>/.