search..
No manual entry for -- in section 3
LDAP_EXTENDED_OPERATION(3)  Library Functions Manual LDAP_EXTENDED_OPERATION(3)

NAME
       ldap_extended_operation,	 ldap_extended_operation_s  -  Extends the LDAP
       operations to the LDAP server.

LIBRARY
       OpenLDAP LDAP (libldap, -lldap)

SYNOPSIS
       #include <ldap.h>

       int ldap_extended_operation(
	      LDAP *ld,
	      const char *requestoid,
	      const struct berval *requestdata,
	      LDAPControl **sctrls,
	      LDAPControl **cctrls,
	      int *msgidp );

       int ldap_extended_operation_s(
	      LDAP *ld,
	      const char *requestoid,
	      const struct berval *requestdata,
	      LDAPControl **sctrls,
	      LDAPControl **cctrls,
	      char **retoidp,
	      struct berval **retdatap );

DESCRIPTION
       The ldap_extended_operation_s() routine is used to synchronously perform
       an LDAP extended operation.  It takes requestoid, which points to a dot-
       ted-decimal OID string identifying the extended	operation  to  perform.
       requestdata  is the data required for the request, sctrls is an array of
       LDAPControl structures to use with this extended operation, cctrls is an
       array of LDAPControl structures that list the  client  controls	to  use
       with this extended operation.

       The  output  parameter retoidp points to a dotted-decimal OID string re-
       turned by the LDAP server.  The memory used  by	the  string  should  be
       freed  with the ldap_memfree(3) function.  The output parameter retdatap
       points to a pointer to a berval structure  that	contains  the  returned
       data.   If no data is returned by the server, the pointer is set this to
       NULL.  The memory used by  this	structure  should  be  freed  with  the
       ber_bvfree(3) function.

       The   ldap_extended_operation()	works  just  like  ldap_extended_opera-
       tion_s(), but the operation is asynchronous.  It provides the message id
       of the request it initiated in the integer pointed to  be  msgidp.   The
       result of this operation can be obtained by calling ldap_result(3).

SEE ALSO
       ber_bvfree(3),  ldap_memfree(3), ldap_parse_extended_result(3), ldap_re-
       sult(3)

ACKNOWLEDGEMENTS
       OpenLDAP Software is developed and maintained by	 The  OpenLDAP	Project
       <http://www.openldap.org/>.   OpenLDAP Software is derived from the Uni-
       versity of Michigan LDAP 3.3 Release.

OpenLDAP 2.6.10+dfsg-1		   2025/05/22	     LDAP_EXTENDED_OPERATION(3)