From f6994f502b33ea689659c92e9ad4247bdb4fb015 Mon Sep 17 00:00:00 2001
From: Denis Kenzior <denkenz@gmail.com>
Date: Thu, 24 Oct 2019 13:39:40 -0500
Subject: [PATCH] manpage: Document Blacklist settings

---
 src/iwd.conf.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/src/iwd.conf.rst b/src/iwd.conf.rst
index d1ff34a3..93fd68e5 100644
--- a/src/iwd.conf.rst
+++ b/src/iwd.conf.rst
@@ -76,6 +76,38 @@ The group ``[General]`` contains general settings.
 
        If not specified, ``systemd`` is used as default.
 
+Blacklist
+---------
+
+The group ``[Blacklist]`` contains settings related to blacklisting of BSSes.
+If iwd determines that a connection to a BSS fails for a reason that indicates
+the BSS is currently misbehaving or misconfigured (e.g. timeouts, unexpected
+status/reason codes, etc), then iwd will blacklist this BSS and avoid connecting
+to it for a period of time.  These options let the user control how long
+a misbehaved BSS spends on the blacklist.
+
+.. list-table::
+   :header-rows: 0
+   :stub-columns: 0
+   :widths: 20 80
+   :align: left
+
+   * - InitialTimeout
+     - Values: uint64 value in seconds (default: **60**)
+
+       The initial time that a BSS spends on the blacklist.
+   * - Multiplier
+     - Values: unsigned int value in seconds (default: **30**)
+
+       If the BSS was blacklisted previously and another connection attempt
+       has failed after the initial timeout has expired, then the BSS blacklist
+       time will be extended by a multiple of *Multiplier* for each
+       unsuccessful attempt up to *MaxiumTimeout* time in seconds.
+   * - MaximumTimeout
+     - Values: uint64 value in seconds (default: **86400**)
+
+       Maximum time that a BSS is blacklisted.
+
 SEE ALSO
 ========