[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