2002-06-13 11:59:10 +08:00
|
|
|
.TH LDAP_GET_VALUES 3 "RELEASEDATE" "OpenLDAP LDVERSION"
|
1999-09-12 12:41:47 +08:00
|
|
|
.\" $OpenLDAP$
|
2003-01-04 04:20:47 +08:00
|
|
|
.\" Copyright 1998-2003 The OpenLDAP Foundation All Rights Reserved.
|
1999-09-12 12:41:47 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
1998-08-09 08:43:13 +08:00
|
|
|
.SH NAME
|
|
|
|
|
ldap_get_values, ldap_get_values_len, ldap_count_values \- LDAP attribute value handling routines
|
2002-06-21 15:32:54 +08:00
|
|
|
.SH LIBRARY
|
2002-06-22 05:25:38 +08:00
|
|
|
OpenLDAP LDAP (libldap, -lldap)
|
1998-08-09 08:43:13 +08:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.nf
|
|
|
|
|
.ft B
|
|
|
|
|
#include <ldap.h>
|
|
|
|
|
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
char **ldap_get_values(ld, entry, attr)
|
|
|
|
|
.ft
|
|
|
|
|
LDAP *ld;
|
|
|
|
|
LDAPMessage *entry;
|
|
|
|
|
char *attr
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
struct berval **ldap_get_values_len(ld, entry, attr)
|
|
|
|
|
.ft
|
|
|
|
|
LDAP *ld;
|
|
|
|
|
LDAPMessage *entry;
|
|
|
|
|
char *attr
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
ldap_count_values(vals)
|
|
|
|
|
.ft
|
|
|
|
|
char **vals;
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
ldap_count_values_len(vals)
|
|
|
|
|
.ft
|
|
|
|
|
struct berval **vals;
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
ldap_value_free(vals)
|
|
|
|
|
.ft
|
|
|
|
|
char **vals;
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
ldap_value_free_len(vals)
|
|
|
|
|
.ft
|
|
|
|
|
struct berval **vals;
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
These routines are used to retrieve and manipulate attribute values
|
|
|
|
|
from an LDAP entry as returned by
|
|
|
|
|
.BR ldap_first_entry (3)
|
|
|
|
|
or
|
|
|
|
|
.BR ldap_next_entry (3).
|
|
|
|
|
.B ldap_get_values()
|
|
|
|
|
takes the \fIentry\fP and the attribute \fIattr\fP
|
|
|
|
|
whose values are desired and returns a NULL-terminated array of the
|
|
|
|
|
attribute's values. \fIattr\fP may be an attribute type as returned
|
|
|
|
|
from
|
|
|
|
|
.BR ldap_first_attribute (3)
|
|
|
|
|
or
|
|
|
|
|
.BR ldap_next_attribute (3),
|
|
|
|
|
or if the attribute type is known it can simply be given.
|
|
|
|
|
.LP
|
|
|
|
|
The number of values in the array can be counted by calling
|
|
|
|
|
.BR ldap_count_values() .
|
|
|
|
|
The array of values returned can be freed by calling
|
|
|
|
|
.BR ldap_value_free() .
|
|
|
|
|
.LP
|
|
|
|
|
If the attribute values are binary in nature, and thus not suitable
|
|
|
|
|
to be returned as an array of char *'s, the
|
|
|
|
|
.B ldap_get_values_len()
|
|
|
|
|
routine can be used instead. It takes the same parameters as
|
|
|
|
|
.BR 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.
|
|
|
|
|
.LP
|
|
|
|
|
The number of values in the array can be counted by calling
|
|
|
|
|
.BR ldap_count_values_len() .
|
|
|
|
|
The array of values returned can be freed by calling
|
|
|
|
|
.BR ldap_value_free_len() .
|
|
|
|
|
.SH ERRORS
|
|
|
|
|
If an error occurs in
|
|
|
|
|
.B ldap_get_values()
|
|
|
|
|
or
|
|
|
|
|
.BR ldap_get_values_len() ,
|
|
|
|
|
NULL is returned and the
|
|
|
|
|
.B ld_errno
|
|
|
|
|
field in the \fIld\fP parameter is set to
|
|
|
|
|
indicate the error. See
|
|
|
|
|
.BR ldap_error (3)
|
|
|
|
|
for a description of possible error codes.
|
|
|
|
|
.SH NOTES
|
1998-12-23 03:08:27 +08:00
|
|
|
These routines dynamically allocate memory which the caller must free
|
|
|
|
|
using the supplied routines.
|
1998-08-09 08:43:13 +08:00
|
|
|
.SH SEE ALSO
|
2002-05-09 10:07:41 +08:00
|
|
|
.BR ldap (3),
|
|
|
|
|
.BR ldap_first_entry (3),
|
|
|
|
|
.BR ldap_first_attribute (3),
|
|
|
|
|
.BR ldap_error (3)
|
1998-10-25 09:41:42 +08:00
|
|
|
.SH ACKNOWLEDGEMENTS
|
2003-06-29 23:34:32 +08:00
|
|
|
.B OpenLDAP
|
1998-10-25 09:41:42 +08:00
|
|
|
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
|
2003-06-29 23:34:32 +08:00
|
|
|
.B OpenLDAP
|
1998-10-25 09:41:42 +08:00
|
|
|
is derived from University of Michigan LDAP 3.3 Release.
|
