aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorStonewall Jackson <stonewall@sacredheartsc.com>2023-02-12 17:59:45 -0500
committerStonewall Jackson <stonewall@sacredheartsc.com>2023-02-12 17:59:45 -0500
commita6c5b918849a92c02f7b135a4d674b8640812f7d (patch)
tree8f43acc571a96d6302b05073ff2bf6212dbfef43
parent74b97b1f29da242f6f5a46849b99fd5adcaa1447 (diff)
downloadselfhosted-a6c5b918849a92c02f7b135a4d674b8640812f7d.tar.gz
selfhosted-a6c5b918849a92c02f7b135a4d674b8640812f7d.zip
freebsd_loader: add docs
-rw-r--r--roles/freebsd_loader/README.md39
1 files changed, 39 insertions, 0 deletions
diff --git a/roles/freebsd_loader/README.md b/roles/freebsd_loader/README.md
new file mode 100644
index 0000000..5c487fb
--- /dev/null
+++ b/roles/freebsd_loader/README.md
@@ -0,0 +1,39 @@
+FreeBSD Bootloader
+==================
+
+Description
+-----------
+
+The `freebsd_loader` role is used to set options in FreeBSD's
+[loader.conf](https://man.freebsd.org/cgi/man.cgi?loader.conf(5)).
+
+It is only used for configuring `loader.conf` options for OPNsense
+firewalls.
+
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable | Default | Description
+---------------------------------|-----------|------------
+`freebsd_loader_config` | {} | Mapping of bootloader options
+
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- hosts: opnsense_firewalls
+ roles:
+ - role: freebsd_loader
+ vars:
+ freebsd_loader_config:
+ 'mrsas_load': 'YES'
+ 'hw.mfi.mrsas_enable': 1
+ 'kern.ipc.nmbclusters': 1000000
+ 'kern.ipc.nmbjumbop': 524288
+````