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 <http://www.openldap.org/>. OpenLDAP Software is derived from the University of Michigan LDAP 3.3 Release.  

Referenced By

ldap(3), ldappasswd(1).

The man pages ldap_install_tls(3), ldap_start_tls(3), ldap_start_tls_s(3) and ldap_tls_inplace(3) are aliases of ldap_tls(3).

2018/12/19 OpenLDAP 2.4.47