From b3b24fb6904770e9bb211b42c7745e85b98d9a2b Mon Sep 17 00:00:00 2001
From: Andrew Bartlett <abartlet@samba.org>
Date: Sat, 2 Nov 2002 12:13:44 +0000
Subject: Merge of my 'ldap trust ids' patch from HEAD.

This hopefully provides a peformance boost by not hitting getpwnam() for every
entry in an enumeration, instead reteriving entries directly (if available).

idra has reviewed this patch.

Andrew Bartlett
(This used to be commit 8abe71c4d7a796001c5765f4dd88c2e6f5637802)
---
 docs/docbook/manpages/smb.conf.5.sgml | 46 +++++++++++++++++++++++++++++------
 1 file changed, 39 insertions(+), 7 deletions(-)

(limited to 'docs/docbook/manpages/smb.conf.5.sgml')

diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml
index e4c4587c1f..621b764a11 100644
--- a/docs/docbook/manpages/smb.conf.5.sgml
+++ b/docs/docbook/manpages/smb.conf.5.sgml
@@ -663,6 +663,7 @@
 		<listitem><para><link linkend="LDAPUSERSUFFIX"><parameter>ldap user suffix</parameter></link></para></listitem>
 		<listitem><para><link linkend="LDAPMACHINESUFFIX"><parameter>ldap machine suffix</parameter></link></para></listitem>
 		<listitem><para><link linkend="LDAPPASSWDSYNC"><parameter>ldap passwd sync</parameter></link></para></listitem>
+		<listitem><para><link linkend="LDAPTRUSTIDS"><parameter>ldap trust ids</parameter></link></para></listitem>
 
 		<listitem><para><link linkend="LMANNOUNCE"><parameter>lm announce</parameter></link></para></listitem>
 		<listitem><para><link linkend="LMINTERVAL"><parameter>lm interval</parameter></link></para></listitem>
@@ -3464,16 +3465,20 @@
 		The <parameter>ldap ssl</parameter> can be set to one of three values:
 		</para>	
 		<itemizedlist>
-			<listitem><para><parameter>On</parameter>  =  Always use SSL when contacting the 
-			<parameter>ldap	server</parameter>.</para></listitem>
-			
 			<listitem><para><parameter>Off</parameter> = Never use SSL when querying the directory.</para></listitem>
 
 			<listitem><para><parameter>Start_tls</parameter> = Use the LDAPv3 StartTLS extended operation 
 			(RFC2830) for communicating with the directory server.</para></listitem>
+	    
+			<listitem><para><parameter>On</parameter>  =
+			Use SSL on the ldaps port when contacting the 
+			<parameter>ldap	server</parameter>.  Only
+			available when the backwards-compatiblity <command>
+			--with-ldapsam</command> option is specified
+			to configure.  See <link linkend="PASSDBBACKEND"><paramater>passdb backend</parameter></link></para></listitem>
 		</itemizedlist>		
 		
-		<para>Default : <command>ldap ssl = on</command></para>
+		<para>Default : <command>ldap ssl = start_tls</command></para>
 		</listitem>
 		</varlistentry>
 
@@ -3540,9 +3545,24 @@
 		</listitem>
 		</varlistentry>
 
+		<varlistentry>
+		<term><anchor id="LDAPTRUSTIDS">ldap trust ids (G)</term>
+		<listitem><para>Normally, Samba validates each entry
+		in the LDAP server against getpwnam().  This allows
+		LDAP to be used for Samba with the unix system using
+		NIS (for example) and also ensures that Samba does not
+		present accounts that do not otherwise exist.  </para>
+	        <para>This option is used to disable this functionality, and
+		instead to rely on the presence of the appropriate
+		attributes in LDAP directly, which can result in a
+		significant performance boost in some situations.  
+                Setting this option to yes effectivly assumes
+		that the local machine is running <command>nss_ldap</command> against the
+		same LDAP server.</para>
 
-
-
+		<para>Default: <command>ldap trust ids = No</command></para>
+		</listitem>
+		</varlistentry>
 
 		<varlistentry>
 		<term><anchor id="LEVEL2OPLOCKS">level2 oplocks (S)</term>
@@ -5357,8 +5377,20 @@
 			<listitem><para><command>ldapsam_nua</command> - The LDAP based passdb 
                         backend, with non unix account support.  Takes an LDAP URL as an optional argument (defaults to 
                         <command>ldap://localhost</command>)</para>
+		        <para>Note:  In this module, any account
+                        without a matching POSIX account is regarded
+                        as 'non unix'.
                         <para>See also <link linkend="NONUNIXACCOUNTRANGE">
-                        <parameter>non unix account range</parameter></link></para></listitem>
+                        <parameter>non unix account
+                        range</parameter></link></para>
+	                
+		        <para>LDAP connections should be secured where
+                        possible.  This may be done using either
+                        Start-TLS (see <link linkend="LDAPSSL">
+                        <parameter>ldap ssl</parameter>) or by
+                        specifying <paramater>ldaps://</paramater> in
+                        the URL argument.  
+                        </para></listitem>
 			
 			<listitem><para><command>nisplussam</command> - The NIS+ based passdb backend. Takes name NIS domain as an optional argument. Only works with sun NIS+ servers. </para></listitem>
 			
-- 
cgit