]> git.ipfire.org Git - thirdparty/openldap.git/commitdiff
ITS#9271 Document ldap_parse_intermediate
authorOndřej Kuzník <ondra@mistotebe.net>
Wed, 27 May 2020 14:50:24 +0000 (15:50 +0100)
committerQuanah Gibson-Mount <quanah@openldap.org>
Thu, 28 May 2020 16:38:31 +0000 (16:38 +0000)
doc/man/man3/ldap_parse_result.3
doc/man/man3/ldap_parse_result.3.links

index d2ca18e7116ec31f628d2b9635111c0711973cd9..1e18d525b1f8003f68cfe63a12dd553ae4321467 100644 (file)
@@ -24,6 +24,11 @@ int ldap_parse_sasl_bind_result( LDAP *ld, LDAPMessage *result,
 .ft B
 int ldap_parse_extended_result( LDAP *ld, LDAPMessage *result,
        char **retoidp, struct berval **retdatap, int freeit )
+.LP
+.ft B
+int ldap_parse_intermediate( LDAP *ld, LDAPMessage *result,
+       char **retoidp, struct berval **retdatap,
+       LDAPControl ***serverctrlsp, int freeit )
 .SH DESCRIPTION
 .LP
 These routines are used to extract information from a result message.
@@ -41,7 +46,9 @@ the routines
 and
 .B ldap_parse_extended_result()
 are used to get all the result information from SASL bind and extended
-operations.
+operations. To extract information from intermediate responses,
+.B ldap_parse_intermediate()
+can be used.
 .LP
 The \fIerrcodep\fP parameter will be filled in with the result code from
 the result message.
@@ -77,13 +84,13 @@ with an allocated berval structure containing the credentials from the
 server if present. The structure should be freed using
 .BR ber_bvfree (3).
 .LP
-For extended results, the \fIretoidp\fP parameter will be filled in
+For extended results and intermediate responses, the \fIretoidp\fP parameter will be filled in
 with the dotted-OID text representation of the name of the extended
 operation response. The string should be freed using
 .BR ldap_memfree (3).
 If no OID was returned, \fI*retoidp\fP is set to NULL.
 .LP
-For extended results, the \fIretdatap\fP parameter will be filled in
+For extended results and intermediate responses, the \fIretdatap\fP parameter will be filled in
 with a pointer to a berval structure containing the data from the
 extended operation response. The structure should be freed using
 .BR ber_bvfree (3).
index 9c322c36a565b7d91fb884645a190cc2fa9b8ab9..e2f4755c358bb6266686ad23ebdec2ad41c19462 100644 (file)
@@ -1,2 +1,3 @@
 ldap_parse_sasl_bind_result.3
 ldap_parse_extended_result.3
+ldap_parse_intermediate.3