docs: Document idmap_nss "range" option

Signed-off-by: Samuel Cabrero <scabrero@samba.org>
Reviewed-by: Alexander Bokovoy <ab@samba.org>

diff --git a/docs-xml/manpages/idmap_nss.8.xml b/docs-xml/manpages/idmap_nss.8.xml
index fc03445df2c0a0e3686a17548a447f99af8fc650..254f38a5f5bc2e0071844dce045ecf77d331ac0f 100644 (file)
--- a/docs-xml/manpages/idmap_nss.8.xml
+++ b/docs-xml/manpages/idmap_nss.8.xml
@@ -27,6 +27,25 @@
        </para>
 </refsynopsisdiv>
 
+<refsect1>
+       <title>IDMAP OPTIONS</title>
+
+       <variablelist>
+               <varlistentry>
+               <term>range = low - high</term>
+               <listitem><para>
+                       Defines the available matching UID and GID range for which the
+                       backend is authoritative. Note that the range acts as a filter.
+                       Returned UIDs or GIDs by NSS modules that fall outside the range
+                       are ignored and the corresponding maps discarded. It is intended
+                       as a way to avoid accidental UID/GID overlaps between local and
+                       remotely defined IDs.
+               </para></listitem>
+               </varlistentry>
+       </variablelist>
+</refsect1>
+
+
 <refsect1>
        <title>EXAMPLES</title>
 
@@ -57,4 +76,4 @@
        </para>
 </refsect1>
 
-</refentry>
+</refentry>
\ No newline at end of file