ldap_start_tls (3)
NAME
ldap_start_tls, ldap_start_tls_s, ldap_tls_inplace, ldap_install_tls - LDAP TLS initialization routines
LIBRARY
OpenLDAP LDAP (libldap, -lldap)
SYNOPSIS
#include <ldap.h>
int ldap_start_tls(LDAP *ld);
int ldap_start_tls_s(LDAP *ld, LDAPControl **serverctrls, LDAPControl **clientctrls);
int ldap_tls_inplace(LDAP *ld);
int ldap_install_tls(LDAP *ld);
DESCRIPTION
These routines are used to initiate TLS processing on an LDAP session.
ldap_start_tls_s()
sends a StartTLS request to a server, waits for the reply, and then installs
TLS handlers on the session if the request succeeded. The routine returns
LDAP_SUCCESS
if everything succeeded, otherwise it returns an LDAP error code.
ldap_start_tls()
sends a StartTLS request to a server and does nothing else. It returns
LDAP_SUCCESS
if the request was sent successfully.
ldap_tls_inplace()
returns 1 if TLS handlers have been installed on the specified session, 0
otherwise.
ldap_install_tls()
installs the TLS handlers on the given session. It returns
LDAP_LOCAL_ERROR
if TLS is already installed.
SEE ALSO
ldap(3),
ldap_error(3)
ACKNOWLEDGEMENTS
OpenLDAP Software
is developed and maintained by The OpenLDAP Project <
www.openldap.org>.
OpenLDAP Software
is derived from the University of Michigan LDAP 3.3 Release.