From f31d40d613dc9c5310470eaaaafa7d8d04235a6f Mon Sep 17 00:00:00 2001 From: Quanah Gibson-Mount Date: Wed, 26 Aug 2009 00:53:47 +0000 Subject: [PATCH] ITS#6261 --- CHANGES | 2 ++ doc/man/man3/ldap_open.3 | 30 ++++++++++++++++++++++++++++-- 2 files changed, 30 insertions(+), 2 deletions(-) diff --git a/CHANGES b/CHANGES index 08209d4069..d9ab6fa64d 100644 --- a/CHANGES +++ b/CHANGES @@ -38,6 +38,8 @@ OpenLDAP 2.4.18 Engineering Build Environment Tests note which backend is being tested (ITS#5810) Fixed test056-monitor with custom ports (ITS#6213) + Documentation + ldap_open(3) document URI (ITS#6261) OpenLDAP 2.4.17 Release (2009/07/13) Fixed liblber to use ber_strnlen (ITS#6080) diff --git a/doc/man/man3/ldap_open.3 b/doc/man/man3/ldap_open.3 index 0636fc9255..d305ffc0a2 100644 --- a/doc/man/man3/ldap_open.3 +++ b/doc/man/man3/ldap_open.3 @@ -93,6 +93,29 @@ acts like but it returns an integer indicating either success or the failure reason, and it allows to specify details for the connection in the schema portion of the URI. +The +.I uri +parameter may be a comma- or whitespace-separated list of URIs +containing only the +.IR schema , +the +.IR host , +and the +.I port +fields. +Apart from +.BR ldap , +other (non-standard) recognized values of the +.I schema +field are +.B ldaps +(LDAP over TLS), +.B ldapi +(LDAP over IPC), +and +.B cldap +(connectionless LDAP). +If other fields are present, the behavior is undefined. .LP At this time, .B ldap_open() @@ -134,14 +157,17 @@ If an error occurs, .B ldap_open() and .B ldap_init() -will return NULL and errno should be set appropriately. +will return NULL and +.I errno +should be set appropriately. .B ldap_initialize() and .B ldap_init_fd() will directly return the LDAP code associated to the error (or .I LDAP_SUCCESS in case of success); -errno should be set as well whenever appropriate. +.I errno +should be set as well whenever appropriate. .SH SEE ALSO .BR ldap (3), .BR ldap_bind (3), -- 2.39.5