Movatterモバイル変換

ldap_get_values(3) — Linux manual page

LDAP_GET_VALUES(3)       Library Functions ManualLDAP_GET_VALUES(3)

NAME        top

       ldap_get_values, ldap_get_values_len, ldap_count_values - LDAP       attribute value handling routines

LIBRARY        top

       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS        top

#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        top

       These routines are used to retrieve and manipulate attribute       values from an LDAP entry as returned byldap_first_entry(3) orldap_next_entry(3).ldap_get_values()takes theentry and the       attributeattr whose values are desired and returns a NULL-       terminated array of the attribute's values.attr may be an       attribute type as returned fromldap_first_attribute(3) orldap_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 callingldap_count_values().  The array of values returned can be freed by       callingldap_value_free().       If the attribute values are binary in nature, and thus not       suitable to be returned as an array of char *'s, theldap_get_values_len()routine can be used instead.  It takes the       same parameters asldap_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 callingldap_count_values_len().  The array of values returned can be       freed by callingldap_value_free_len().

ERRORS        top

       If an error occurs inldap_get_values()orldap_get_values_len(),       NULL is returned and theld_errnofield in theld parameter is set       to indicate the error.  Seeldap_error(3) for a description of       possible error codes.

NOTES        top

       These routines dynamically allocate memory which the caller must       free using the supplied routines.

SEE ALSO        top

ldap(3),ldap_first_entry(3),ldap_first_attribute(3),ldap_error(3)

ACKNOWLEDGEMENTS        top

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

COLOPHON        top

       This page is part of theOpenLDAP (an open source implementation       of the Lightweight Directory Access Protocol) project.       Information about the project can be found at        ⟨http://www.openldap.org/⟩.  If you have a bug report for this       manual page, see ⟨http://www.openldap.org/its/⟩.  This page was       obtained from the project's upstream Git repository       ⟨https://git.openldap.org/openldap/openldap.git⟩ on 2025-08-11.       (At that time, the date of the most recent commit that was found       in the repository was 2025-08-05.)  If you discover any rendering       problems in this HTML version of the page, or you believe there is       a better or more up-to-date source for the page, or you have       corrections or improvements to the information in this COLOPHON       (which isnot part of the original manual page), send a mail to       man-pages@man7.orgOpenLDAP LDVERSION             RELEASEDATELDAP_GET_VALUES(3)

Pages that refer to this page:ldap(3), ldap_first_attribute(3), ldap_first_entry(3), ldap_get_dn(3), ldap_parse_reference(3), ldap_parse_result(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.