Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

SunOS 5.10 - man page for ldap_open (sunos section 3ldap)

ldap_open(3LDAP)					      LDAP Library Functions						  ldap_open(3LDAP)

NAME
ldap_open, ldap_init - initialize an LDAP session
SYNOPSIS
cc [ flag... ] file... -lldap [ library... ] #include <lber.h> #include <ldap.h> LDAP *ldap_open(const char *host, int port); LDAP *ldap_init(const char *host, int port);
DESCRIPTION
The ldap_open() function initializes an LDAP session and also opens a connection to an LDAP server before it returns to the caller. Unlike ldap_open(), ldap_init() does not open a connection to the LDAP server until an operation, such as a search request, is performed. The ldap_open() function is deprecated and should no longer be used. Call ldap_init() instead. A list of LDAP hostnames or an IPv4 or IPv6 address can be specified with the ldap_open() and ldap_init() functions. The hostname can include a port number, separated from the hostname by a colon (:). A port number included as part of the hostname takes precedence over the port parameter. The ldap_open() and ldap_init() functions attempt connections with LDAP hosts in the order listed and return the first suc- cessful connection.
PARAMETERS
These functions support the following parameters. host The hostname, IPv4 or IPv6 address of the host that runs the LDAP server. A space-separated list of hostnames can also be used for this parameter. port TCP port number of a connection. Supply the constant LDAP_PORT to obtain the default LDAP port of 389. If a host includes a port number, the default parameter is ignored.
RETURN VALUES
The ldap_open() and ldap_init() functions return a handle to an LDAP session that contains a pointer to an opaque structure. The structure must be passed to subsequent calls for the session. If a session cannot be initialized, the functions return NULL and errno should be set appropriately. Various aspects of this opaque structure can be read or written to control the session-wide parameters. Use the ldap_get_option(3LDAP) to access the current option values and the ldap_set_option(3LDAP) to set values for these options.
EXAMPLES
Example 1: Specifying IPv4 and IPv6 Addresses LDAP sessions can be initialized with hostnames, IPv4 or IPv6 addresses, such as those shown in the following examples. ldap_init("hosta:636 hostb", 389) ldap_init("192.168.82.110:389", 389) ldap_init("[fec0::114:a00:20ff:ab3d:83ed]", 389)
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |Safe | +-----------------------------+-----------------------------+
SEE ALSO
errno(3C), ldap(3LDAP), ldap_bind(3LDAP), ldap_get_option(3LDAP), ldap_set_option(3LDAP), attributes(5) SunOS 5.10 15 Jan 2004 ldap_open(3LDAP)