1.1.1 Functions

The ldap module defines the following functions:

initialize( uri)

Opens a new connection with an LDAP server, and return an LDAP object (see 1.1.4) used to perform operations on that server. Parameter uri has to be a valid LDAP URL.

See Also:

RFC 2255, The LDAP URL Format

open( host [, port=PORT]): Opens a new connection with an LDAP server, and return an LDAP object (see 1.1.4) used to perform operations on that server. host is a string containing solely the host name. port is an integer specifying the port where the LDAP server is listening (default is 389). Note: Using this function is deprecated.

explode_dn( dn [, notypes=0])

This function takes dn and breaks it up into its component parts. Each part is known as an RDN (Relative Distinguished Name). The notypes parameter is used to specify that only the RDN values be returned and not their types. For example, the DN "cn=Bob, c=US" would be returned as either ["cn=Bob", "c=US"] or ["Bob","US"] depending on whether notypes was 0 or 1, respectively.

See Also:

RFC 2253, Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names

explode_rdn( rdn [, notypes=0]): This function takes a (multi-valued) rdn and breaks it up into a list of characteristic attributes. The notypes parameter is used to specify that only the RDN values be returned and not their types.

get_option( option): This function returns the value of the global option specified by option.

set_option( option, invalue): This function sets the value of the global option specified by option to invalue.