LDAP_UFN(3LDAP) LDAP Library Functions LDAP_UFN(3LDAP)
NAME
ldap_ufn, ldap_ufn_search_s, ldap_ufn_search_c, ldap_ufn_search_ct,
ldap_ufn_setfilter, ldap_ufn_setprefix, ldap_ufn_timeout - LDAP user
friendly search functions
SYNOPSIS
cc[
flag... ]
file... -lldap[
library... ]
#include <lber.h>
#include <ldap.h>
int ldap_ufn_search_c(
LDAP *ld,
char *ufn,
char **attrs,
int attrsonly,
LDAPMessage **res,
int (*cancelproc)(),
void *cancelparm);
int ldap_ufn_search_ct(
LDAP *ld,
char *ufn,
char **attrs,
int attrsonly,
LDAPMessage **res,
int (*cancelproc)(),
void *cancelparm,
char *tag1,
char *tag2,
char *tag3);
int ldap_ufn_search_s(
LDAP *ld,
char *ufn,
char **attrs,
int attrsonly,
LDAPMessage **res);
LDAPFiltDesc *ldap_ufn_setfilter(
LDAP *ld,
char *fname);
void ldap_ufn_setprefix(
LDAP *ld,
char *prefix);
int ldap_ufn_timeout(
void *tvparam);
DESCRIPTION
These functions are used to perform LDAP user friendly search operations.
ldap_ufn_search_s() is the simplest form. It does the search
synchronously. It takes
ld to identify the LDAP connection. The
ufn parameter is the user friendly name for which to search. The
attrs,
attrsonly and
res parameters are the same as for
ldap_search(3LDAP).
The
ldap_ufn_search_c() function functions the same as
ldap_ufn_search_s(), except that it takes
cancelproc, a function to call
periodically during the search. It should be a function taking a single
void * argument, given by
cancelparm. If
cancelproc returns a non-zero
result, the search will be abandoned and no results returned. The purpose
of this function is to provide a way for the search to be cancelled, for
example, by a user or because some other condition occurs.
The
ldap_ufn_search_ct() function is like
ldap_ufn_search_c(), except
that it takes three extra parameters.
tag1 is passed to the
ldap_init_getfilter(3LDAP) function when resolving the first component of
the UFN.
tag2 is used when resolving intermediate components.
tag3 is
used when resolving the last component. By default, the tags used by the
other UFN search functions during these three phases of the search are
"ufn first", "ufn intermediate", and "ufn last".
The
ldap_ufn_setfilter() function is used to set the
ldapfilter.conf(5) file for use with the
ldap_init_getfilter(3LDAP) function to
fname.
The
ldap_ufn_setprefix() function is used to set the default prefix
(actually, it's a suffix) appended to UFNs before searhing. UFNs with
fewer than three components have the prefix appended first, before
searching. If that fails, the UFN is tried with progressively shorter
versions of the prefix, stripping off components. If the UFN has three
or more components, it is tried by itself first. If that fails, a
similar process is applied with the prefix appended.
The
ldap_ufn_timeout() function is used to set the timeout associated
with
ldap_ufn_search_s() searches. The
timeout parameter should actually
be a pointer to a struct timeval. This is so
ldap_ufn_timeout() can be
used as a cancelproc in the above functions.
ATTRIBUTES
See
attributes(7) for a description of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|Interface Stability | Evolving |
+--------------------+-----------------+
SEE ALSO
gettimeofday(3C),
ldap(3LDAP),
ldap_error(3LDAP),
ldap_getfilter(3LDAP),
ldap_search(3LDAP),
ldapfilter.conf(5),
attributes(7)NOTES
These functions may allocates memory. Return values are contained in
<
ldap.h>.
January 27, 2002
LDAP_UFN(3LDAP)