From a8e804bf8f887d8a5fd5814adc674fcad5ac70ea Mon Sep 17 00:00:00 2001 From: Kurt Zeilenga Date: Thu, 31 Aug 2000 05:52:55 +0000 Subject: [PATCH] Update repl pages Add RFC titles to REF table --- doc/guide/admin/intro.sdf | 49 +++++++++++++++------------------ doc/guide/admin/replication.sdf | 3 ++ doc/guide/preamble.sdf | 44 ++++++++++++++++------------- doc/guide/release/autoconf.sdf | 12 ++++---- doc/guide/release/license.sdf | 12 ++++---- 5 files changed, 62 insertions(+), 58 deletions(-) diff --git a/doc/guide/admin/intro.sdf b/doc/guide/admin/intro.sdf index 730da605e2..11d4a68b5b 100644 --- a/doc/guide/admin/intro.sdf +++ b/doc/guide/admin/intro.sdf @@ -27,7 +27,7 @@ quick-response to high-volume lookup or search operations. They may have the ability to replicate information widely in order to increase availability and reliability, while reducing response time. When directory information is replicated, temporary inconsistencies between -the replicas may be OK, as long as they get in sync eventually. +the replicas may be okay, as long as they get in sync eventually. There are many different ways to provide a directory service. Different methods allow different kinds of information to be stored in the directory, @@ -44,7 +44,6 @@ you are in relation to the data itself. The Internet {{TERM[expand]DNS}} is an example of a globally distributed directory service. - H2: What is LDAP? {{slapd}}'s model for directory service is based on a global directory @@ -81,9 +80,11 @@ example LDAP directory tree using traditional naming. title="LDAP directory tree (traditional naming)" FT[align="Center"] Figure 1.1: LDAP directory tree (traditional naming) -The tree may also be arranged based upon Internet domain names. -Figure 1.2 shows an example using this increasingly popular naming -approach. +The tree may also be arranged based upon Internet domain names. This +naming approach is becoming increasing popular as it allows for +directory services to be locating using the {{TERM[expand]DNS}}. +Figure 1.2 shows an example LDAP directory tree using domain-based +naming. !import "intro_dctree.gif"; align="center"; \ title="LDAP directory tree (Internet naming)" @@ -91,7 +92,7 @@ FT[align="Center"] Figure 1.2: LDAP directory tree (Internet naming) In addition, LDAP allows you to control which attributes are required and allowed in an entry through the use of a special attribute called -{{objectClass}}. The values of the {{objectClass}} attribute +{{EX:objectClass}}. The values of the {{EX:objectClass}} attribute determine the {{schema}} rules the entry must obey. {{How is the information referenced?}} @@ -125,9 +126,11 @@ do with LDAP and how it might be useful to you. {{How is the information protected from unauthorized access?}} Some directory services provide no protection, allowing anyone to see -the information. LDAP provides a method for a client to authenticate, -or prove its identity to a directory server, paving the way for rich -access control to protect the information the server contains. +the information. LDAP provides a mechanisms for a client to +authenticate, or prove its identity to a directory server, paving +the way for rich access control to protect the information the server +contains. LDAP also supports privacy and integrity security +services. H2: How does LDAP work? @@ -153,8 +156,8 @@ yourself. Some of slapd's more interesting features and capabilities include: {{B:LDAPv2}} and {{B:LDAPv3}}: {{slapd}} supports both version 2 and 3 of the {{TERM[expand]LDAP}}. {{slapd}} provides support -for the latest features while maintaining interoperability with existing -clients. {{slapd}} supports both IPv4 and IPv6 protocols. +for the latest features while maintaining interoperability with +existing clients. {{slapd}} supports both IPv4 and IPv6. {{B:{{TERM[expand]SASL}}}}: {{slapd}} supports strong authentication services through the use of SASL. {{slapd}}'s @@ -209,8 +212,8 @@ requests, reducing the amount of system overhead required. copies of its database. This {{single-master/multiple-slave}} replication scheme is vital in high-volume environments where a single {{slapd}} just doesn't provide the necessary availability -or reliability. {{slapd}} -also includes experimental support for {{multi-master}} replication. +or reliability. {{slapd}} also includes experimental support for +{{multi-master}} replication. {{B:Configuration}}: {{slapd}} is highly configurable through a single configuration file which allows you to change just about @@ -222,7 +225,6 @@ database backend does not handle range queries or negation queries very well. These features and more will be coming in a future release. - H2: What about X.500? Technically, LDAP is a directory access protocol to an {{TERM:X.500}} @@ -246,19 +248,12 @@ guide, which is all about running LDAP via {{slapd}}, without running X.500 DAP. If you are not running X.500 DAP, want to stop running X.500 DAP, or have no immediate plans to run X.500 DAP, read on. -It is possible to replicate data from a {{slapd}} directory -server to a X.500 {{TERM:DSA}}, which allows your organization to -make your data available as part of the global X.500 DAP directory -service on a {{read-only}} basis. See the -{{SECT:Replication to an X.500 DSA}} -section in the -{{SECT:Replication with slurpd}} chapter of this document. - -Another way to make data in a {{slapd}} server available to the -X.500 community would be by using a X.500 DAP to LDAP gateway. At -this time, no such software has been written (to the best of our -knowledge), but hopefully some group will see fit to write such a -gateway. +It is possible to replicate data from an LDAP directory +server to a X.500 DAP {{TERM:DSA}}. This requires an LDAP/DAP +gateway. OpenLDAP does not provide such a gateway, but our +replication daemon can be used to replicate to such a gateway. +See the {{SECT:Replication with slurpd}} chapter of this document +for information regarding replication. H2: What is slurpd and what can it do? diff --git a/doc/guide/admin/replication.sdf b/doc/guide/admin/replication.sdf index 556fbb0973..6b9930e59e 100644 --- a/doc/guide/admin/replication.sdf +++ b/doc/guide/admin/replication.sdf @@ -347,6 +347,7 @@ and exit, use the command > slurpd -r /usr/tmp/replog.slave.example.com:389 -o +!if 0 H2: Replication to an X.500 DSA @@ -386,3 +387,5 @@ attribute and {{EX:modifyTimeStamp}} to the OID for the {{EX:lastModifiedTime}} attribute. Since attribute names are carried as OIDs over DAP, this should perform the appropriate translation of attribute names. + +!endif diff --git a/doc/guide/preamble.sdf b/doc/guide/preamble.sdf index 8b6a9f0ecc..179428f176 100644 --- a/doc/guide/preamble.sdf +++ b/doc/guide/preamble.sdf @@ -26,9 +26,9 @@ !define HTML_URL_CATALOG "../index.html" !macro HTML_HEADER - !block inline - - !endblock +# !block inline +# +# !endblock !if DOC_LOGO !block inline @@ -47,8 +47,10 @@ !macro HTML_FOOTER !HTML_PRE_SECTION !HTML_NAVIGATE +# !block inline; expand +# +# !endblock !block inline; expand -

______________
@@ -58,9 +60,9 @@ ______________
!endmacro !macro HTML_TOPIC_HEADER - !block inline; expand - - !endblock +# !block inline; expand +# +# !endblock !define DOC_TOPIC_LOGO $var{'DOC_LOGO'} !if DOC_TOPIC_LOGO !default DOC_TOPIC_LOGO_BASE $var{'DOC_LOGO_BASE'} @@ -81,8 +83,10 @@ ______________
!macro HTML_TOPIC_FOOTER !HTML_PRE_SECTION !HTML_TOPIC_NAVIGATE +# !block inline; expand +# +# !endblock !block inline; expand -

______________
@@ -186,15 +190,17 @@ X.500|X.500 Directory Services !block references; data Reference|Status|Document|Jump -RFC2079|PS|RFC2079|ftp://ftp.isi.edu/in-notes/rfc2079.txt -RFC2251|PS|RFC2251|ftp://ftp.isi.edu/in-notes/rfc2251.txt -RFC2252|PS|RFC2252|ftp://ftp.isi.edu/in-notes/rfc2252.txt -RFC2253|PS|RFC2253|ftp://ftp.isi.edu/in-notes/rfc2253.txt -RFC2254|PS|RFC2254|ftp://ftp.isi.edu/in-notes/rfc2254.txt -RFC2255|PS|RFC2255|ftp://ftp.isi.edu/in-notes/rfc2255.txt -RFC2256|PS|RFC2256|ftp://ftp.isi.edu/in-notes/rfc2256.txt -RFC2798|PS|RFC2798|ftp://ftp.isi.edu/in-notes/rfc2798.txt -RFC2829|PS|RFC2829|ftp://ftp.isi.edu/in-notes/rfc2829.txt -RFC2830|PS|RFC2830|ftp://ftp.isi.edu/in-notes/rfc2830.txt -RFC2831|PS|RFC2831|ftp://ftp.isi.edu/in-notes/rfc2831.txt +RFC2079|PS|Definition of an X.500 Attribute Type and an Object Class to Hold Uniform Resource Identifers|ftp://ftp.isi.edu/in-notes/rfc2079.txt +RFC2251|PS|Lightweight Directory Access Protocol (v3)|ftp://ftp.isi.edu/in-notes/rfc2251.txt +RFC2252|PS|LDAPv3: Attribute Syntax Definitions|ftp://ftp.isi.edu/in-notes/rfc2252.txt +RFC2253|PS|LDAPv3: UTF-8 String Representation of Distinguished Names|ftp://ftp.isi.edu/in-notes/rfc2253.txt +RFC2254|PS|The String Representation of LDAP Search Filters|ftp://ftp.isi.edu/in-notes/rfc2254.txt +RFC2255|PS|The LDAP URL Format|ftp://ftp.isi.edu/in-notes/rfc2255.txt +RFC2256|PS|A Summary of the X.500(96) User Schema for use with LDAPv3|ftp://ftp.isi.edu/in-notes/rfc2256.txt +RFC2296|PS|Use of Language Codes in LDAP|ftp://ftp.isi.edu/in-notes/rfc2296.txt +RFC2798|INFO|Definition of the inetOrgPerson LDAP Object Class|ftp://ftp.isi.edu/in-notes/rfc2798.txt +RFC2829|PS|Authentication Methods for LDAP|ftp://ftp.isi.edu/in-notes/rfc2829.txt +RFC2830|PS|LDAPv3: Extension for Transport Layer Security|ftp://ftp.isi.edu/in-notes/rfc2830.txt +RFC2831|PS|Using Digest Authentication as a SASL Mechanism|ftp://ftp.isi.edu/in-notes/rfc2831.txt +RFC2849|PS|The LDAP Data Interchange Format|ftp://ftp.isi.edu/in-notes/rfc2849.txt !endblock diff --git a/doc/guide/release/autoconf.sdf b/doc/guide/release/autoconf.sdf index 6382079c1f..008c288d8e 100644 --- a/doc/guide/release/autoconf.sdf +++ b/doc/guide/release/autoconf.sdf @@ -5,12 +5,12 @@ H1: Generic configure Instructions -!block inline - -!endblock +#!block inline +# +#!endblock !include "../release/autoconf-install.txt" ; verbatim -!block inline - -!endblock +#!block inline +# +#!endblock diff --git a/doc/guide/release/license.sdf b/doc/guide/release/license.sdf index 1b8c78e044..f870c6137d 100644 --- a/doc/guide/release/license.sdf +++ b/doc/guide/release/license.sdf @@ -4,12 +4,12 @@ H1: The OpenLDAP Public License -!block inline - -!endblock +#!block inline +# +#!endblock !include "../LICENSE" ; verbatim -!block inline - -!endblock +#!block inline +# +#!endblock -- 2.39.5