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

OpenLDAP 2.6.9+dfsg-2ubuntu1                       2024/11/26                                        LDAP_TLS(3)