ldap_control_create, ldap_control_find, ldap_control_dup, ldap_controls_dup, ldap_control_free, ldap_controls_free − LDAP control manipulation routines


OpenLDAP LDAP (libldap, −lldap)


#include <ldap.h>

int ldap_control_create(const char *oid, int iscritical, struct berval *value, int dupval, LDAPControl **ctrlp);

LDAPControl *ldap_control_find( const char *oid, LDAPControl **ctrls, LDAPControl ***nextctrlp);

LDAPControl *ldap_control_dup(LDAPControl *ctrl);

LDAPControl **ldap_controls_dup(LDAPControl **ctrls);

void ldap_control_free(LDAPControl *ctrl);

void ldap_controls_free(LDAPControl **ctrls);


These routines are used to manipulate structures used for LDAP controls.

ldap_control_create() creates a control with the specified OID using the contents of the value parameter for the control value, if any. The content of value is duplicated if dupval is non-zero. The iscritical parameter must be non-zero for a critical control. The created control is returned in the ctrlp parameter. The routine returns LDAP_SUCCESS on success or some other error code on failure. The content of value, for supported control types, can be prepared using helpers provided by this implementation of libldap, usually in the form ldap_create_<control name>_control_value(). Otherwise, it can be BER-encoded using the functionalities of liblber.

ldap_control_find() searches the NULL-terminated ctrls array for a control whose OID matches the oid parameter. The routine returns a pointer to the control if found, NULL otherwise. If the parameter nextctrlp is not NULL, on return it will point to the next control in the array, and can be passed to the ldap_control_find() routine for subsequent calls, to find further occurrences of the same control type. The use of this function is discouraged; the recommended way of handling controls in responses consists in going through the array of controls, dealing with each of them in the returned order, since it could matter.

ldap_control_dup() duplicates an individual control structure, and ldap_controls_dup() duplicates a NULL-terminated array of controls.

ldap_control_free() frees an individual control structure, and ldap_controls_free() frees a NULL-terminated array of controls.


ldap(3), ldap_error(3)


OpenLDAP Software is developed and maintained by The OpenLDAP Project <http://www.openldap.org/>. OpenLDAP Software is derived from University of Michigan LDAP 3.3 Release.

More Linux Commands

svipc(7) - System V interprocess communication mechanisms...
This manual page refers to the Linux implementation of the System V interprocess communication (IPC) mechanisms: message queues, semaphore sets, and shared memo

ClientWhitePointOfCCC(3) - Color Conversion Context macros
The DisplayOfCCC macro returns the display associated with the specified CCC. The VisualOfCCC macro returns the visual associated with the specified CCC. The Sc

DefaultVisual(3) - Display macros and functions (Man Page)
The AllPlanes macro returns a value with all bits set to 1 suitable for use in a plane argument to a procedure. The BlackPixel macro returns the black pixel val

xcursorgen(1) - create an X cursor file from a collection of
Xcursorgen reads the config-file to find the list of cursor images along with their hotspot and nominal size information. Xcursorgen converts all of the images

XIQueryPointer(3) - get device pointer coordinates (ManPage)
The XIQueryPointer function returns the root window the devices pointer is logically on and the pointer coordinates relative to the root windows origin. If XIQu

wcursyncup(3ncurses) - create curses windows (Man Page).....
Calling newwin creates and returns a pointer to a new window with the given number of lines and columns. The upper left-hand corner of the window is at line beg

lattice(1) - linked rings. (Commands - Linux manual page)...
From Terry Walsh (http://reallyslick.com): Fly through an endless world of linked rings. You can choose from several different textures for the rings and alter

gnutls_x509_crl_export(3) - API function - Linux man page...
This function will export the revocation list to DER or PEM format. If the buffer provided is not long enough to hold the output, then GNUTLS_E_SHORT_MEMORY_BUF

intro.8 - intro(8) - Introduction to administration and privileged com
Section 8 of the manual describes commands which either can be or are used only by the superuser, like system-administration commands, daemons, and hardware-rel

busctl(1) Introspect the bus (Commands - Linux man page)....
busctl may be used to introspect and monitor the D-Bus bus. OPTIONS The following options are understood: --address=ADDRESS Connect to the bus specified by ADDR

This function sets a callback to be called in order to retrieve the certificate to be used in the handshake. The callbacks function prototype is: int (*callback

gvfs-info(1) Show information about files - Linux man page
gvfs-info shows information about the given locations. gvfs-info is similar to the traditional ls utility, but using gvfs locations instead of local files: for

We can't live, work or learn in freedom unless the software we use is free.