Freebsd

@josephholsten/freebsdv2026.06.15.1· 1d agoMODELS

01README

FreeBSD system primitives via SSH — pkg(8) package management, sysrc(8) rc.conf key-value management, service(8) enable/disable + lifecycle, and kldload(8)/kldstat(8) kernel module management with /boot/loader.conf persistence. All four model types follow the check/apply pattern: check audits compliance without changes; apply converges actual state to desired state. Desired state is declared in globalArgs so the model instance is the declaration. SSH via OpenSSH ControlMaster; sudo privilege escalation optional via become/becomeUser/becomePassword. Model types: - @josephholsten/freebsd/pkg — install or remove packages (pkg install/remove) - @josephholsten/freebsd/rc — manage rc.conf key=value pairs via sysrc(8), including append mode for space-separated list values

@josephholsten/freebsd/service — enable/disable at boot + start/stop/restart - @josephholsten/freebsd/kld — load/unload kernel modules with optional /boot/loader.conf persistence

02Models4

@josephholsten/freebsd/rcv2026.06.15.1rc.ts

Global Arguments

Argument	Type	Required	Description
key	string	yes	rc.conf key to manage
value	string	yes	Desired value. When append=true, the token to ensure is present in the space-separated value.
ensure	enum	yes	Whether the key should exist with the desired value
append	boolean	yes	When true, treat value as a token to append (sysrc key+=value) rather than an exact match

fn check()

Check if rc.conf key matches desired state (dry-run, no changes)

fn apply()

Apply desired rc.conf state via sysrc(8)

Resources

state(infinite)— Result of rc.conf check or apply operation

@josephholsten/freebsd/pkgv2026.06.15.1pkg.ts

Global Arguments

Argument	Type	Required	Description
packages	array	yes	Package names to manage
ensure	enum	yes	Whether packages should be present or absent

fn check()

Check if packages match desired state without modifying

fn apply()

Install or remove packages based on ensure state

fn refresh()

Update the pkg package catalog (pkg update)

fn upgrade()

Upgrade all installed packages (pkg upgrade -y)

fn list()

List all installed packages (pkg query)

Resources

state(infinite)— Package operation state

installed(infinite)— All installed packages on the host

@josephholsten/freebsd/servicev2026.06.15.1service.ts

Global Arguments

Argument	Type	Required	Description
service	string	yes	Service name (e.g. telegraf, nginx)
ensure?	enum	no	Whether the service should be running or stopped
enabled?	boolean	no	Whether the service should be enabled at boot via rc.conf

fn check()

Check if service matches desired state (dry-run)

fn apply()

Apply desired service state to the remote host

fn restart()

Restart the service (imperative, always runs)

Resources

state(infinite)— Result of service check or apply operation

@josephholsten/freebsd/kldv2026.06.15.1kld.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Kernel module name (e.g. ng_ether, if_ath_pci)
ensure	enum	yes	Whether the module should be loaded or unloaded
persist	boolean	yes	Persist the module across reboots via /boot/loader.conf

fn check()

Check if the kernel module is loaded/persisted as desired (dry-run)

fn apply()

Load or unload a kernel module and manage persistence

Resources

state(infinite)— Result of kld check or apply operation

03Stats

100 / 100

Downloads

Archive size

26.4 KB

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://codeberg.org/josephholsten/swamp-freebsd

04Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

05Labels

#freebsd #pkg #rc #service #kld #ssh #cfgmgmt