CLDAP_OPEN(3LDAP) LDAP Library Functions CLDAP_OPEN(3LDAP)

NAME

cldap_open - LDAP connectionless communication preparation

SYNOPSIS

cc[ flag... ] file... -lldap[ library... ]
#include <lber.h>
#include <ldap.h>

LDAP *cldap_open(char *host, int port);

PARAMETERS

host
The name of the host on which the LDAP server is running.


port
The port number to connect.

DESCRIPTION

The cldap_open() function is called to prepare for connectionless
LDAP communication (over udp(4P)). It allocates an LDAP structure
which is passed to future search requests.


If the default IANA-assigned port of 389 is desired, LDAP_PORT
should be specified for port. host can contain a space-separated list
of hosts or addresses to try. cldap_open() returns a pointer to an
LDAP structure, which should be passed to subsequent calls to
cldap_search_s(3LDAP), cldap_setretryinfo(3LDAP), and
cldap_close(3LDAP). Certain fields in the LDAP structure can be set
to indicate size limit, time limit, and how aliases are handled
during operations. See ldap_open(3LDAP) and <ldap.h> for more
details.

ERRORS

If an error occurs, cldap_open() will return NULL and errno will be
set appropriately.

ATTRIBUTES

See attributes(7) for a description of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|Interface Stability | Evolving |
+--------------------+-----------------+

SEE ALSO

ldap(3LDAP) cldap_close(3LDAP), cldap_search_s(3LDAP),
cldap_setretryinfo(3LDAP), udp(4P), attributes(7)

January 27, 2002 CLDAP_OPEN(3LDAP)