LDAP_TLS 3 "RELEASEDATE" "OpenLDAP LDVERSION"
OpenLDAP: pkg/ldap/doc/man/man3/ldap_tls.3,v 1.1.2.6 2010/04/13 20:22:40 kurt Exp
Copyright 1998-2010 The OpenLDAP Foundation All Rights Reserved.
Copying restrictions apply. See COPYRIGHT/LICENSE.
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
.so ../Project