net/wireguard: Updating and fallback instructions for wireguard kernel support

1 files changed, 18 insertions, 0 deletions

diff --git a/UPDATING b/UPDATING
index ba258eb20802..0f0ca76243ad 100644
--- a/UPDATING
+++ b/UPDATING
@@ -5,6 +5,24 @@ they are unavoidable.
 You should get into the habit of checking this file for changes each time
 you update your ports collection, before attempting any port upgrades.
 
+20210322:
+  AFFECTS: users of net/wireguard
+  AUTHOR: decke@FreeBSD.org
+
+  A wireguard kernel implementation supporting FreeBSD 12.1 and newer was
+  added as net/wireguard-kmod recently.
+
+  The new default for users of net/wireguard is the kernel module where it
+  is supported and needs to be loaded at boot time from your /etc/rc.conf
+  or /etc/rc.conf.d/wireguard file:
+
+  kld_list="/boot/modules/if_wg.ko"
+
+  If you experience problems with it you can switch back to wireguard-go
+  easily by unloading (or not loading) the kernel module. The userland
+  tools wg-quick(8) and wg(8) try to use kernel support and otherwise fall
+  back to wireguard-go automatically. Config files are fully compatible.
+
 20210317:
   AFFECTS: users of security/strongswan
   AUTHOR: driesm.michiels@gmail.com