ldap_first_reference man page on OpenDarwin

Man page or keyword search:  
man Server   3202 pages
apropos Keyword Search (all sections)
Output format
OpenDarwin logo
[printable version]

LDAP_FIRST_REFERENCE(3)				       LDAP_FIRST_REFERENCE(3)

NAME
       ldap_first_reference,   ldap_next_reference,   ldap_count_references  -
       Stepping through continuation references in a result chain

LIBRARY
       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS
       #include <ldap.h>

       int ldap_count_references( LDAP *ld, LDAPMessage *result )

       LDAPMessage *ldap_first_reference( LDAP *ld, LDAPMessage *result )

       LDAPMessage *ldap_next_reference( LDAP *ld, LDAPMessage *reference )

DESCRIPTION
       These routines are used to step through the continuation references  in
       a  result  chain	 received  from ldap_result(3) or the synchronous LDAP
       search operation routines.

       The ldap_first_reference() routine is used to retrieve the first refer‐
       ence  message  in a result chain.  It takes the result as returned by a
       call  to	 ldap_result(3),  ldap_search_s(3)  or	ldap_search_st(3)  and
       returns a pointer to the first reference message in the result chain.

       This  pointer should be supplied on a subsequent call to ldap_next_ref‐
       erence() to get the next reference message, the result of which	should
       be   supplied   to   the	  next	call  to  ldap_next_reference(),  etc.
       ldap_next_reference() will return NULL when there are no more reference
       messages.  The reference messages returned from these calls are used by
       ldap_parse_reference(3) to extract referrals and controls.

       A count of the number of reference messages in the search result can be
       obtained	 by  calling  ldap_count_references().	It can also be used to
       count the number of reference messages remaining in a result chain.

ERRORS
       If an error occurs in ldap_first_reference() or	ldap_next_reference(),
       NULL is returned.  If an error occurs in ldap_count_references(), -1 is
       returned.

SEE ALSO
       ldap(3), ldap_result(3), ldap_search(3), ldap_parse_reference(3)

ACKNOWLEDGEMENTS
       OpenLDAP	 is  developed	and  maintained	 by   The   OpenLDAP   Project
       (http://www.openldap.org/).   OpenLDAP  is  derived  from University of
       Michigan LDAP 3.3 Release.

OpenLDAP 2.1.X			  RELEASEDATE	       LDAP_FIRST_REFERENCE(3)
[top]

List of man pages available for OpenDarwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net