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

pack200-java-1.8.0-openjdk(1) Packages a JAR file into a com
The pack200 command is a Java application that transforms a JAR file into a compressed pack200 file with the Java gzip compressor. The pack200 files are highly

XGetTextProperty(3) - set and read text properties (ManPage)
The XSetTextProperty function replaces the existing specified property for the named window with the data, type, format, and number of items determined by the v

free_menu(3menu) - create and destroy menus - Linux man page
free_menu.3menu - The function new_menu creates a new menu connected to a specified item pointer array (which must be NULL-terminated). The function free_menu d

smistrip(1) - extract MIB or PIB modules from text files, li
The smistrip program is used to extract MIB and PIB module files from ASCII documents like RFCs or Internet Drafts. Modules are identified by a starting ASN.1 D

gjar(1) - - Archive tool for Java archives - Linux man page
gjar is an implementation of Suns jar utility that comes with the JDK . If any file is a directory then it is processed recursively. The manifest file name and

kmousetool(1) - Accessibility tool to help click the mouse
KMouseTool clicks the mouse whenever the mouse cursor pauses briefly. It was designed to help those with repetitive strain injuries, for whom pressing buttons h

rt_tgsigqueueinfo(2) - queue a signal and data to a process
RETURN VALUE ERRORS VERSIONS CONFORMING TO NOTES SEE ALSO COLOPHON NAME rt_sigqueueinfo - queue a signal and data to a process SYNOPSIS long sys_rt_sigqueueinfo

crypt_ra(3) - password hashing (Library - Linux man page)...
The crypt, crypt_r, crypt_rn, and crypt_ra functions calculate a cryptographic hash function of key with one of a number of supported methods as requested with

wunctrl(3ncurses) - miscellaneous curses utility routines...
The unctrl routine returns a character string which is a printable representation of the character c, ignoring attributes. Control characters are displayed in t

arpwatch(8) - keep track of ethernet/ip address pairings....
Arpwatch keeps track for MAC/IP address pairings. It syslogs activity and reports certain changes via email. Arpwatch uses pcap(3) to listen for arp packets on

uptime(1) - tell how long the system has been running.......
Print the current time, the length of time the system has been up, the number of users on the system, and the average number of jobs in the run queue over the l

rsa(1ssl) - RSA key processing tool - Linux manual page.....
The rsa command processes RSA keys. They can be converted between various forms and their components printed out. Note this command uses the traditional SSLeay

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