LDAP_GET_VALUES
NAMELIBRARY
SYNOPSIS
DESCRIPTION
ERRORS
NOTES
SEE ALSO
ACKNOWLEDGEMENTS
NAME
ldap_get_values, ldap_get_values_len, ldap_count_values − LDAP attribute value handling routines
LIBRARY
OpenLDAP LDAP (libldap, −lldap)
SYNOPSIS
#include <ldap.h>
char
**ldap_get_values(ld, entry, attr)
LDAP *ld;
LDAPMessage *entry;
char *attr;
struct
berval **ldap_get_values_len(ld, entry, attr)
LDAP *ld;
LDAPMessage *entry;
char *attr;
int
ldap_count_values(vals)
char **vals;
int
ldap_count_values_len(vals)
struct berval **vals;
void
ldap_value_free(vals)
char **vals;
void
ldap_value_free_len(vals)
struct berval **vals;
DESCRIPTION
These routines are used to retrieve and manipulate attribute values from an LDAP entry as returned by ldap_first_entry(3) or ldap_next_entry(3). ldap_get_values() takes the entry and the attribute attr whose values are desired and returns a NULL-terminated array of the attribute’s values. attr may be an attribute type as returned from ldap_first_attribute(3) or ldap_next_attribute(3), or if the attribute type is known it can simply be given.
The number of values in the array can be counted by calling ldap_count_values(). The array of values returned can be freed by calling ldap_value_free().
If the attribute values are binary in nature, and thus not suitable to be returned as an array of char *’s, the ldap_get_values_len() routine can be used instead. It takes the same parameters as ldap_get_values(), but returns a NULL-terminated array of pointers to berval structures, each containing the length of and a pointer to a value.
The number of values in the array can be counted by calling ldap_count_values_len(). The array of values returned can be freed by calling ldap_value_free_len().
ERRORS
If an error occurs in ldap_get_values() or ldap_get_values_len(), NULL is returned and the ld_errno field in the ld parameter is set to indicate the error. See ldap_error(3) for a description of possible error codes.
NOTES
These routines dynamically allocate memory which the caller must free using the supplied routines.
SEE ALSO
ldap(3), ldap_first_entry(3), ldap_first_attribute(3), ldap_error(3)
ACKNOWLEDGEMENTS
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
manpages/beforelight.1.html
beforelight(1) - screen saver (Commands - Linux man page)...
The beforelight program is a sample implementation of a screen saver for X servers supporting the MIT-SCREEN-SAVER extension. AUTHORS Keith Packard, MIT X Conso
manpages/XSetWMColormapWindows.3.html
XSetWMColormapWindows(3) - set or read a window's WM_COLORMA
The XSetWMColormapWindows function replaces the WM_COLORMAP_WINDOWS property on the specified window with the list of windows specified by the colormap_windows
manpages/glRasterPos4dv.3gl.html
glRasterPos4dv(3gl) - specify the raster position for pixel
The GL maintains a 3D position in window coordinates. This position, called the raster position, is used to position pixel and bitmap write operations. It is ma
manpages/startproc.html
301 Moved Permanently - statproc
manpages/ppmntsc.1.html
ppmntsc(1) - Make RGB colors legal for NTSC or PAL color sys
This program is part of Netpbm(1) This program makes colors legal in the NTSC (or PAL) color systems. Often, images generated on the computer are made for use i
manpages/is_scrollok.3ncurses.html
is_scrollok(3ncurses) - curses window properties (Man Page)
This implementation provides functions which return properties set in the WINDOW structure, allowing it to be opaque if the symbol NCURSES_OPAQUE is defined: is
manpages/inchstr.3ncurses.html
inchstr(3ncurses) - get a string of characters (and attribut
These routines return a NULL-terminated array of chtype quantities, starting at the current cursor position in the named window and ending at the right margin o
manpages/texi2pdf.1.html
texi2pdf(1) - convert Texinfo documents to PDF (Man Page)...
texi2pdf.1 - Run each Texinfo or (La)TeX FILE through TeX in turn until all cross-references are resolved, building all indices. The directory containing each F
manpages/Tcl_FSCopyDirectory.3.html
Tcl_FSCopyDirectory(3) - procedures to interact with any fil
There are several reasons for calling the Tcl_FS API functions (e.g. Tcl_FSAccess and Tcl_FSStat) rather than calling system level functions like access and sta
manpages/gnutls_anon_set_params_function.3.html
gnutls_anon_set_params_function(3) - API function (ManPage)
This function will set a callback in order for the server to get the Diffie-Hellman or RSA parameters for anonymous authentication. The callback should return G
manpages/pcre32_get_stringnumber.3.html
pcre32_get_stringnumber(3) Perl-compatible regular expressio
This convenience function finds the number of a named substring capturing parenthesis in a compiled pattern. Its arguments are: code Compiled regular expression
manpages/XtSetSensitive.3.html
XtSetSensitive(3) - set and check a widget's sensitivity sta
The XtSetSensitive function first calls XtSetValues on the current widget with an argument list specifying that the sensitive field should change to the new val
