LDAP_FIRST_ENTRY man page on SmartOS

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


       ldap_first_entry,  ldap_next_entry, ldap_count_entries, ldap_count_ref‐
       erences, ldap_first_reference, ldap_next_reference - LDAP entry parsing
       and counting functions

       cc[ flag... ] file... -lldap[ library... ]
       #include <lber.h>
       #include <ldap.h>

       LDAPMessage *ldap_first_entry(LDAP*ld, LDAPMessage *result);

       LDAPMessage *ldap_next_entry(LDAP *ld, LDAPMessage *entry);

       ldap_count_entries(LDAP *ld, LDAPMessage *result);

       LDAPMessage *ldap_first_reference(LDAP *ld, LDAPMessage *res);

       LDAPMessage *ldap_next_reference(LDAP *ld, LDAPMessage *res);

       int ldap_count_references(LDAP *ld, LDAPMessage *res);

       These   functions   are	 used	to   parse   results   received	  from
       ldap_result(3LDAP) or the synchronous LDAP search  operation  functions
       ldap_search_s(3LDAP) and ldap_search_st(3LDAP).

       The  ldap_first_entry() function is used to retrieve the first entry in
       a chain of search results.  It takes the result as returned by  a  call
       to  ldap_result(3LDAP) or ldap_search_s(3LDAP) or ldap_search_st(3LDAP)
       and returns a pointer to the first entry in the result.

       This  pointer  should   be   supplied   on   a	subsequent   call   to
       ldap_next_entry()  to get the next entry, the result of which should be
       supplied to the next call to ldap_next_entry(), etc.  ldap_next_entry()
       will  return NULL when there are no more entries.  The entries returned
       from these calls are used  in  calls  to	 the  functions	 described  in
       ldap_get_dn(3LDAP),	ldap_first_attribute(3LDAP),	 ldap_get_val‐
       ues(3LDAP), etc.

       A count of the number of entries in the search result can  be  obtained
       by calling ldap_count_entries().

       ldap_first_reference()  and    ldap_next_reference()  are  used to step
       through and retrieve the list of continuation references from a	search
       result chain.

       The  ldap_count_references()  function  is  used to count the number of
       references that are contained in and remain in a search result chain.

       If an error occurs in ldap_first_entry() or ldap_next_entry(), NULL  is
       returned and the	 ld_errno field in the ld parameter is set to indicate
       the error.  If an error occurs in ldap_count_entries(), −1 is returned,
       and  ld_errno  is  set  appropriately.	See  ldap_error(3LDAP)	for  a
       description of possible error codes.

       See attributes(5) for a description of the following attributes:

       │Interface Stability │ Evolving	      │

       ldap(3LDAP),	     ldap_result(3LDAP),	   ldap_search(3LDAP),
       ldap_first_attribute(3LDAP),		       ldap_get_values(3LDAP),
       ldap_get_dn(3LDAP), attributes(5)

				 Jan 27, 2002	       LDAP_FIRST_ENTRY(3LDAP)

List of man pages available for SmartOS

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]
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