ldap_count_references 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(3LDAP)				       LDAP_FIRST_ENTRY(3LDAP)

NAME
       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

SYNOPSIS
       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);

DESCRIPTION
       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.

ERRORS
       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.

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

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       │Interface Stability │ Evolving	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       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)
[top]

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