From: Kurt Zeilenga Date: Wed, 14 Jun 2006 04:15:41 +0000 (+0000) Subject: cleanup X-Git-Tag: OPENLDAP_REL_ENG_2_4_3ALPHA~9^2~113 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=3e63cadf94b4a64a7df9e02b324e77838edea698;p=openldap cleanup --- diff --git a/doc/man/man3/ldap_extended_operation.3 b/doc/man/man3/ldap_extended_operation.3 index 2c9e31037d..25e61d9989 100644 --- a/doc/man/man3/ldap_extended_operation.3 +++ b/doc/man/man3/ldap_extended_operation.3 @@ -12,27 +12,33 @@ OpenLDAP LDAP (libldap, -lldap) #include .LP .ft B -int ldap_extended_operation( ld, requestoid, requestdata, sctrls[], cctrls[], msgidp ); -.ft -LDAP *ld; -const char *requestoid; -const struct berval *requestdata; -LDAPControl *sctrls[], *cctrls[]; -int *msgidp; +int ldap_extended_operation( +.RS +.ft B +LDAP *\fIld\fB, +const char *\fIrequestoid\fB, +const struct berval *\fIrequestdata\fB, +LDAPControl **\fIsctrls\fB, +LDAPControl **\fIcctrls\fB, +int *\fImsgidp\fB ); +.RE .LP .ft B -int ldap_extended_operation_s( ld, requestoid, requestdata, sctrls[], cctrls[], retoidp, retdatap ); -.ft -LDAP *ld, -const char *requestoid; -const struct berval *requestdata; -LDAPControl *sctrls[], *cctrls[]; -char **retoidp; -struct berval **retdatap; +int ldap_extended_operation_s( +.RS +.ft B +LDAP *\fIld\fB, +const char *\fIrequestoid\fB, +const struct berval *\fIrequestdata\fB, +LDAPControl **\fIsctrls\fB, +LDAPControl **\fIcctrls\fB, +char **\fIretoidp\fB; +struct berval **\fIretdatap\fB ); +.RE .SH DESCRIPTION The -.B ldap_extended_operation_s -method is used to synchronously send an extended operation to the server. +.B ldap_extended_operation_s() +routine is used to synchronously perform an LDAP extended operation. It takes \fIrequestoid\fP, which points to a dotted OID text string identifying the extended operation to perform. \fIrequestdata\fP is the data required for the operation, \fIseverctrls\fP is an array of LDAPControl structures to use with this @@ -46,19 +52,15 @@ to NULL. The memory used by this structure should be freed with the ber_bvfree function. .LP The -.B ldap_extended_operation -works just like ldap_extended_operation_s, but the operation is asynchornous. -It returns the message id of the request it initiated. +.B ldap_extended_operation() +works just like +.BR ldap_extended_operation_s() , +but the operation is asynchornous. It provides the message id of +the request it initiated in the integer pointed to be \fImsgidp\fP. The result of this operation can be obtained by calling .BR ldap_result(3). -.SH NOTES -The LDAP server must support the operation; otherwise an -LDAP_NOT_SUPPORTED error is returned. .SH SEE ALSO .BR ldap_result (3), .BR ldap_parse_extended_result (3) .SH ACKNOWLEDGEMENTS -.B OpenLDAP -is developed and maintained by The OpenLDAP Project (http://www.openldap.org/). -.B OpenLDAP -is derived from University of Michigan LDAP 3.3 Release. +.so ../Project