Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   20652 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ldap_first_message(3LDAP)   LDAP Library Functions   ldap_first_message(3LDAP)

NAME
       ldap_first_message,  ldap_count_messages,  ldap_next_message, ldap_msg‐
       type - LDAP message processing functions

SYNOPSIS
       cc[ flag... ] file... -lldap[ library... ]

       #include <lber.h>
       #include <ldap.h>

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

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

       LDAPMessage *ldap_next_message(LDAP *ld, LDAPMessage *msg);

       int ldap_msgtype(LDAPMessage *res);

DESCRIPTION
       ldap_count_messages() is used to count  the  number  of	messages  that
       remain  in a chain of results if called with a  message, entry, or ref‐
       erence	returned   by	 ldap_first_message(),	  ldap_next_message(),
       ldap_first_entry(),   ldap_next_entry(),	  ldap_first_reference(),  and
       ldap_next_reference()

       ldap_first_message() and	  ldap_next_message() functions	 are  used  to
       step  through  the  list	 of  messages  in  a  result chain returned by
       ldap_result().

       ldap_msgtype() function returns the type of an LDAP message.

RETURN VALUES
       ldap_first_message()  and   ldap_next_message()	return	   LDAPMessage
       which  can  include  referral  messages, entry messages and result mes‐
       sages.

       ldap_count_messages() returns the number of  messages  contained	 in  a
       chain of results.

ERRORS
       ldap_first_message() and	 ldap_next_message() return  NULL when no more
       messages exist.	NULL is also returned if an error occurs while	 step‐
       ping through the entries, in which case the error parameters
	in the session handle  ld will be set to indicate the error.

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       │Availability		     │SUNWcsl (32-bit)		   │
       │			     │SUNWcslx (64-bit)		   │
       │Interface Stability	     │Evolving			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       ldap_error(3LDAP), ldap_result(3LDAP), attributes(5)

SunOS 5.10			  27 Jan 2002	     ldap_first_message(3LDAP)

Vote for polarhome