From 1bc59390fa43400d9c4210c5b4060c4056df9566 Mon Sep 17 00:00:00 2001
From: Denis Kenzior <denkenz@gmail.com>
Date: Mon, 1 Jul 2019 16:07:23 -0500
Subject: [PATCH] doc: document new mac randomization options

---
 doc/main.conf | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/doc/main.conf b/doc/main.conf
index ed3d10a6..60a3f8f8 100644
--- a/doc/main.conf
+++ b/doc/main.conf
@@ -51,6 +51,28 @@ roam_rssi_threshold=-70
 #
 # disable_anqp=true
 
+#
+# Control the behavior of MAC address randomization by setting the
+# mac_randomize option.  iwd supports the following options:
+#   "default" - Lets the kernel assign a mac address from the permanent mac
+#   address store when the interface is created by iwd.  Alternatively,
+#   if the 'use_default_interface' is set to true, then the mac address is
+#   not touched.
+#   "once" - MAC address is randomized once when iwd starts.  If
+#   'use_default_interface' is set to true, only the interface(s) managed
+#   by iwd will be randomized.
+#
+# One can control which part of the address is randomized using
+# mac_randomize_bytes option.  iwd supports the following options:
+#   "nic" - Randomize only the NIC specific octets (last 3 octets).  Note that
+#   the randomization range is limited to 00:00:01 to 00:00:FE.  The permanent
+#   mac address of the card is used for the initial 3 octets.
+#   "full" - Randomize the full 6 octets.  The locally-administered bit will
+#   be set.
+#
+# mac_randomize=default
+# mac_randomize_bytes=full
+
 [Scan]
 #
 # Disable periodic scan. Setting this option to 'true' will prevent iwd from