search..
No manual entry for -- in section 3
LDAP_TLS(3)		    Library Functions Manual		    LDAP_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 suc-
       ceeded. The routine returns LDAP_SUCCESS if everything succeeded, other-
       wise  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 Uni-
       versity of Michigan LDAP 3.3 Release.

OpenLDAP 2.6.10+dfsg-1		   2025/05/22			    LDAP_TLS(3)