[SSSD] [PATCH] MAN: Add a link explaining search scopes

Jakub Hrozek jhrozek at redhat.com
Wed Dec 4 13:58:39 UTC 2013


As discussed in one of the threads on sssd-devel, it might be nice to
add a link an explanation on different LDAP search scopes.
-------------- next part --------------
>From 7503dbad16762cd63a3b62b8c745aa7e3e94289f Mon Sep 17 00:00:00 2001
From: Jakub Hrozek <jhrozek at redhat.com>
Date: Wed, 4 Dec 2013 14:51:59 +0100
Subject: [PATCH 1/2] MAN: Add a link explaining different LDAP scopes

---
 src/man/include/ldap_search_bases.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/man/include/ldap_search_bases.xml b/src/man/include/ldap_search_bases.xml
index ddabe2827eb5200a74d97b794c220b8460119fd7..49dd94093606da0df92b7693c6f895b8f38f2a66 100644
--- a/src/man/include/ldap_search_bases.xml
+++ b/src/man/include/ldap_search_bases.xml
@@ -10,8 +10,12 @@ search_base[?scope?[filter][?search_base?scope?[filter]]*]
 </programlisting>
     </para>
     <para>
-        The scope can be one of "base", "onelevel" or
-        "subtree". The filter must be a valid LDAP search
+        The scope can be one of "base", "onelevel" or "subtree". The
+        scope functions as specified in section 4.5.1.2 of
+        http://tools.ietf.org/html/rfc4511
+    </para>
+    <para>
+        The filter must be a valid LDAP search
         filter as specified by
         http://www.ietf.org/rfc/rfc2254.txt
     </para>
-- 
1.8.4.2

-------------- next part --------------
>From 890ef0f2a841dfd19247ec5a8cb02bbed6b60185 Mon Sep 17 00:00:00 2001
From: Jakub Hrozek <jhrozek at redhat.com>
Date: Wed, 4 Dec 2013 14:53:50 +0100
Subject: [PATCH 2/2] MAN: Remove unused experimental file

---
 src/man/include/ldap_search_bases_experimental.xml | 35 ----------------------
 src/man/po/po4a.cfg                                |  1 -
 2 files changed, 36 deletions(-)
 delete mode 100644 src/man/include/ldap_search_bases_experimental.xml

diff --git a/src/man/include/ldap_search_bases_experimental.xml b/src/man/include/ldap_search_bases_experimental.xml
deleted file mode 100644
index 78f9ff1de90c59fe0e2c13121e10caaea7437593..0000000000000000000000000000000000000000
--- a/src/man/include/ldap_search_bases_experimental.xml
+++ /dev/null
@@ -1,35 +0,0 @@
-<listitem>
-    <para>
-        An optional base DN, search scope and LDAP filter
-        to restrict LDAP searches for this attribute type.
-    </para>
-    <para>
-        syntax:
-<programlisting>
-search_base[?scope?[filter][?search_base?scope?[filter]]*]
-</programlisting>
-    </para>
-    <para>
-        The scope can be one of "base", "onelevel" or
-        "subtree". The filter must be a valid LDAP search
-        filter as specified by
-        http://www.ietf.org/rfc/rfc2254.txt
-    </para>
-    <para>
-        For examples of this syntax, please refer to the
-        <quote>ldap_search_base</quote> examples section.
-    </para>
-    <para>
-        Default: the value of
-        <emphasis>ldap_search_base</emphasis>
-    </para>
-    <para>
-        Please note that specifying scope or filter is not supported for
-        searches against an Active Directory Server that might yield a
-        large number of results and trigger the Range Retrieval extension
-        in the response.
-    </para>
-    <para>
-            <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="experimental.xml" />
-    </para>
-</listitem>
diff --git a/src/man/po/po4a.cfg b/src/man/po/po4a.cfg
index 7939eac754fae8318efb38069e1ccda743231f07..b03b255d062c9b5c9df750c143f113bbf8c6a2b6 100644
--- a/src/man/po/po4a.cfg
+++ b/src/man/po/po4a.cfg
@@ -34,6 +34,5 @@
 [type:docbook] include/local.xml $lang:$(builddir)/$lang/include/local.xml opt:"-k 0"
 [type:docbook] include/seealso.xml $lang:$(builddir)/$lang/include/seealso.xml opt:"-k 0"
 [type:docbook] include/ldap_search_bases.xml $lang:$(builddir)/$lang/include/ldap_search_bases.xml opt:"-k 0"
-[type:docbook] include/ldap_search_bases_experimental.xml $lang:$(builddir)/$lang/include/ldap_search_bases_experimental.xml opt:"-k 0"
 [type:docbook] include/autofs_restart.xml $lang:$(builddir)/$lang/include/autofs_restart.xml opt:"-k 0"
 [type:docbook] include/override_homedir.xml $lang:$(builddir)/$lang/include/override_homedir.xml opt:"-k 0"
-- 
1.8.4.2



More information about the sssd-devel mailing list