3 * Copyright 1998-2002 The OpenLDAP Foundation, All Rights Reserved.
4 * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
8 * LDAPv3 Extended Operation Request
9 * ExtendedRequest ::= [APPLICATION 23] SEQUENCE {
10 * requestName [0] LDAPOID,
11 * requestValue [1] OCTET STRING OPTIONAL
14 * LDAPv3 Extended Operation Response
15 * ExtendedResponse ::= [APPLICATION 24] SEQUENCE {
16 * COMPONENTS OF LDAPResult,
17 * responseName [10] LDAPOID OPTIONAL,
18 * response [11] OCTET STRING OPTIONAL
26 #include <ac/stdlib.h>
28 #include <ac/socket.h>
29 #include <ac/string.h>
35 ldap_extended_operation(
37 LDAP_CONST char *reqoid,
38 struct berval *reqdata,
47 LDAP_LOG (( "extended", LDAP_LEVEL_ENTRY, "ldap_extended_operation\n" ));
49 Debug( LDAP_DEBUG_TRACE, "ldap_extended_operation\n", 0, 0, 0 );
53 assert( LDAP_VALID( ld ) );
54 assert( reqoid != NULL || *reqoid == '\0' );
55 assert( msgidp != NULL );
57 /* must be version 3 (or greater) */
58 if ( ld->ld_version < LDAP_VERSION3 ) {
59 ld->ld_errno = LDAP_NOT_SUPPORTED;
60 return( ld->ld_errno );
63 /* create a message to send */
64 if ( (ber = ldap_alloc_ber_with_options( ld )) == NULL ) {
65 ld->ld_errno = LDAP_NO_MEMORY;
66 return( ld->ld_errno );
69 if ( reqdata != NULL ) {
70 rc = ber_printf( ber, "{it{tstON}", /* '}' */
71 ++ld->ld_msgid, LDAP_REQ_EXTENDED,
72 LDAP_TAG_EXOP_REQ_OID, reqoid,
73 LDAP_TAG_EXOP_REQ_VALUE, reqdata );
76 rc = ber_printf( ber, "{it{tsN}", /* '}' */
77 ++ld->ld_msgid, LDAP_REQ_EXTENDED,
78 LDAP_TAG_EXOP_REQ_OID, reqoid );
82 ld->ld_errno = LDAP_ENCODING_ERROR;
84 return( ld->ld_errno );
87 /* Put Server Controls */
88 if( ldap_int_put_controls( ld, sctrls, ber ) != LDAP_SUCCESS ) {
93 if ( ber_printf( ber, /*{*/ "N}" ) == -1 ) {
94 ld->ld_errno = LDAP_ENCODING_ERROR;
96 return( ld->ld_errno );
99 /* send the message */
100 *msgidp = ldap_send_initial_request( ld, LDAP_REQ_EXTENDED, NULL, ber );
102 return( *msgidp < 0 ? ld->ld_errno : LDAP_SUCCESS );
106 ldap_extended_operation_s(
108 LDAP_CONST char *reqoid,
109 struct berval *reqdata,
110 LDAPControl **sctrls,
111 LDAPControl **cctrls,
113 struct berval **retdatap )
120 LDAP_LOG (( "extended", LDAP_LEVEL_ENTRY, "ldap_extended_operation_s\n" ));
122 Debug( LDAP_DEBUG_TRACE, "ldap_extended_operation_s\n", 0, 0, 0 );
125 assert( ld != NULL );
126 assert( LDAP_VALID( ld ) );
127 assert( reqoid != NULL || *reqoid == '\0' );
128 assert( retoidp != NULL || retdatap != NULL );
130 rc = ldap_extended_operation( ld, reqoid, reqdata,
131 sctrls, cctrls, &msgid );
133 if ( rc != LDAP_SUCCESS ) {
137 if ( ldap_result( ld, msgid, 1, (struct timeval *) NULL, &res ) == -1 ) {
138 return( ld->ld_errno );
144 rc = ldap_parse_extended_result( ld, res, retoidp, retdatap, 0 );
146 if( rc != LDAP_SUCCESS ) {
151 return( ldap_result2error( ld, res, 1 ) );
154 /* Parse an extended result */
156 ldap_parse_extended_result (
160 struct berval **retdatap,
167 struct berval *resdata;
171 assert( ld != NULL );
172 assert( LDAP_VALID( ld ) );
173 assert( res != NULL );
176 LDAP_LOG (( "extended", LDAP_LEVEL_ENTRY, "ldap_parse_extended_result\n" ));
178 Debug( LDAP_DEBUG_TRACE, "ldap_parse_extended_result\n", 0, 0, 0 );
181 if( ld->ld_version < LDAP_VERSION3 ) {
182 ld->ld_errno = LDAP_NOT_SUPPORTED;
186 if( res->lm_msgtype != LDAP_RES_EXTENDED ) {
187 ld->ld_errno = LDAP_PARAM_ERROR;
191 if( retoidp != NULL ) *retoidp = NULL;
192 if( retdatap != NULL ) *retdatap = NULL;
194 if ( ld->ld_error ) {
195 LDAP_FREE( ld->ld_error );
199 if ( ld->ld_matched ) {
200 LDAP_FREE( ld->ld_matched );
201 ld->ld_matched = NULL;
204 ber = ber_dup( res->lm_ber );
207 ld->ld_errno = LDAP_NO_MEMORY;
211 rc = ber_scanf( ber, "{iaa" /*}*/, &errcode,
212 &ld->ld_matched, &ld->ld_error );
214 if( rc == LBER_ERROR ) {
215 ld->ld_errno = LDAP_DECODING_ERROR;
223 tag = ber_peek_tag( ber, &len );
225 if( tag == LDAP_TAG_REFERRAL ) {
226 /* skip over referral */
227 if( ber_scanf( ber, "x" ) == LBER_ERROR ) {
228 ld->ld_errno = LDAP_DECODING_ERROR;
233 tag = ber_peek_tag( ber, &len );
236 if( tag == LDAP_TAG_EXOP_RES_OID ) {
237 /* we have a resoid */
238 if( ber_scanf( ber, "a", &resoid ) == LBER_ERROR ) {
239 ld->ld_errno = LDAP_DECODING_ERROR;
244 tag = ber_peek_tag( ber, &len );
247 if( tag == LDAP_TAG_EXOP_RES_VALUE ) {
248 /* we have a resdata */
249 if( ber_scanf( ber, "O", &resdata ) == LBER_ERROR ) {
250 ld->ld_errno = LDAP_DECODING_ERROR;
252 if( resoid != NULL ) LDAP_FREE( resoid );
259 if( retoidp != NULL ) {
265 if( retdatap != NULL ) {
268 ber_bvfree( resdata );
271 ld->ld_errno = errcode;
281 /* Parse an extended partial */
283 ldap_parse_extended_partial (
287 struct berval **retdatap,
288 LDAPControl ***serverctrls,
295 struct berval *resdata;
298 assert( ld != NULL );
299 assert( LDAP_VALID( ld ) );
300 assert( res != NULL );
303 LDAP_LOG (( "extended", LDAP_LEVEL_ENTRY,
304 "ldap_parse_extended_partial\n" ));
306 Debug( LDAP_DEBUG_TRACE, "ldap_parse_extended_partial\n", 0, 0, 0 );
309 if( ld->ld_version < LDAP_VERSION3 ) {
310 ld->ld_errno = LDAP_NOT_SUPPORTED;
314 if( res->lm_msgtype != LDAP_RES_EXTENDED_PARTIAL ) {
315 ld->ld_errno = LDAP_PARAM_ERROR;
319 if( retoidp != NULL ) *retoidp = NULL;
320 if( retdatap != NULL ) *retdatap = NULL;
322 ber = ber_dup( res->lm_ber );
325 ld->ld_errno = LDAP_NO_MEMORY;
329 rc = ber_scanf( ber, "{" /*}*/ );
331 if( rc == LBER_ERROR ) {
332 ld->ld_errno = LDAP_DECODING_ERROR;
340 tag = ber_peek_tag( ber, &len );
342 if( tag == LDAP_TAG_EXOP_RES_OID ) {
343 /* we have a resoid */
344 if( ber_scanf( ber, "a", &resoid ) == LBER_ERROR ) {
345 ld->ld_errno = LDAP_DECODING_ERROR;
350 tag = ber_peek_tag( ber, &len );
353 if( tag == LDAP_TAG_EXOP_RES_VALUE ) {
354 /* we have a resdata */
355 if( ber_scanf( ber, "O", &resdata ) == LBER_ERROR ) {
356 ld->ld_errno = LDAP_DECODING_ERROR;
358 if( resoid != NULL ) LDAP_FREE( resoid );
363 if ( serverctrls == NULL ) {
365 goto free_and_return;
368 if ( ber_scanf( ber, /*{*/ "}" ) == LBER_ERROR ) {
369 rc = LDAP_DECODING_ERROR;
370 goto free_and_return;
373 rc = ldap_int_get_controls( ber, serverctrls );
378 if( retoidp != NULL ) {
384 if( retdatap != NULL ) {
387 ber_bvfree( resdata );