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.