2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2006 The OpenLDAP Foundation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
11 * A copy of this license is available in the file LICENSE in the
12 * top-level directory of the distribution or, alternatively, at
13 * <http://www.OpenLDAP.org/license.html>.
15 /* Portions Copyright (C) The Internet Society (1997).
16 * ASN.1 fragments are from RFC 2251; see RFC for full legal notices.
20 * LDAPv3 Extended Operation Request
21 * ExtendedRequest ::= [APPLICATION 23] SEQUENCE {
22 * requestName [0] LDAPOID,
23 * requestValue [1] OCTET STRING OPTIONAL
26 * LDAPv3 Extended Operation Response
27 * ExtendedResponse ::= [APPLICATION 24] SEQUENCE {
28 * COMPONENTS OF LDAPResult,
29 * responseName [10] LDAPOID OPTIONAL,
30 * response [11] OCTET STRING OPTIONAL
38 #include <ac/stdlib.h>
40 #include <ac/socket.h>
41 #include <ac/string.h>
48 ldap_extended_operation(
50 LDAP_CONST char *reqoid,
51 struct berval *reqdata,
60 Debug( LDAP_DEBUG_TRACE, "ldap_extended_operation\n", 0, 0, 0 );
63 assert( LDAP_VALID( ld ) );
64 assert( reqoid != NULL && *reqoid != '\0' );
65 assert( msgidp != NULL );
67 /* must be version 3 (or greater) */
68 if ( ld->ld_version < LDAP_VERSION3 ) {
69 ld->ld_errno = LDAP_NOT_SUPPORTED;
70 return( ld->ld_errno );
73 /* create a message to send */
74 if ( (ber = ldap_alloc_ber_with_options( ld )) == NULL ) {
75 ld->ld_errno = LDAP_NO_MEMORY;
76 return( ld->ld_errno );
79 LDAP_NEXT_MSGID( ld, id );
80 if ( reqdata != NULL ) {
81 rc = ber_printf( ber, "{it{tstON}", /* '}' */
82 id, LDAP_REQ_EXTENDED,
83 LDAP_TAG_EXOP_REQ_OID, reqoid,
84 LDAP_TAG_EXOP_REQ_VALUE, reqdata );
87 rc = ber_printf( ber, "{it{tsN}", /* '}' */
88 id, LDAP_REQ_EXTENDED,
89 LDAP_TAG_EXOP_REQ_OID, reqoid );
93 ld->ld_errno = LDAP_ENCODING_ERROR;
95 return( ld->ld_errno );
98 /* Put Server Controls */
99 if( ldap_int_put_controls( ld, sctrls, ber ) != LDAP_SUCCESS ) {
104 if ( ber_printf( ber, /*{*/ "N}" ) == -1 ) {
105 ld->ld_errno = LDAP_ENCODING_ERROR;
107 return( ld->ld_errno );
110 /* send the message */
111 *msgidp = ldap_send_initial_request( ld, LDAP_REQ_EXTENDED, NULL, ber, id );
113 return( *msgidp < 0 ? ld->ld_errno : LDAP_SUCCESS );
117 ldap_extended_operation_s(
119 LDAP_CONST char *reqoid,
120 struct berval *reqdata,
121 LDAPControl **sctrls,
122 LDAPControl **cctrls,
124 struct berval **retdatap )
130 Debug( LDAP_DEBUG_TRACE, "ldap_extended_operation_s\n", 0, 0, 0 );
132 assert( ld != NULL );
133 assert( LDAP_VALID( ld ) );
134 assert( reqoid != NULL && *reqoid != '\0' );
136 rc = ldap_extended_operation( ld, reqoid, reqdata,
137 sctrls, cctrls, &msgid );
139 if ( rc != LDAP_SUCCESS ) {
143 if ( ldap_result( ld, msgid, LDAP_MSG_ALL, (struct timeval *) NULL, &res ) == -1 ) {
144 return( ld->ld_errno );
147 if ( retoidp != NULL ) *retoidp = NULL;
148 if ( retdatap != NULL ) *retdatap = NULL;
150 rc = ldap_parse_extended_result( ld, res, retoidp, retdatap, 0 );
152 if( rc != LDAP_SUCCESS ) {
157 return( ldap_result2error( ld, res, 1 ) );
160 /* Parse an extended result */
162 ldap_parse_extended_result (
166 struct berval **retdatap,
173 struct berval *resdata;
177 assert( ld != NULL );
178 assert( LDAP_VALID( ld ) );
179 assert( res != NULL );
181 Debug( LDAP_DEBUG_TRACE, "ldap_parse_extended_result\n", 0, 0, 0 );
183 if( ld->ld_version < LDAP_VERSION3 ) {
184 ld->ld_errno = LDAP_NOT_SUPPORTED;
188 if( res->lm_msgtype != LDAP_RES_EXTENDED ) {
189 ld->ld_errno = LDAP_PARAM_ERROR;
193 if( retoidp != NULL ) *retoidp = NULL;
194 if( retdatap != NULL ) *retdatap = NULL;
196 if ( ld->ld_error ) {
197 LDAP_FREE( ld->ld_error );
201 if ( ld->ld_matched ) {
202 LDAP_FREE( ld->ld_matched );
203 ld->ld_matched = NULL;
206 ber = ber_dup( res->lm_ber );
209 ld->ld_errno = LDAP_NO_MEMORY;
213 rc = ber_scanf( ber, "{eAA" /*}*/, &errcode,
214 &ld->ld_matched, &ld->ld_error );
216 if( rc == LBER_ERROR ) {
217 ld->ld_errno = LDAP_DECODING_ERROR;
225 tag = ber_peek_tag( ber, &len );
227 if( tag == LDAP_TAG_REFERRAL ) {
228 /* skip over referral */
229 if( ber_scanf( ber, "x" ) == LBER_ERROR ) {
230 ld->ld_errno = LDAP_DECODING_ERROR;
235 tag = ber_peek_tag( ber, &len );
238 if( tag == LDAP_TAG_EXOP_RES_OID ) {
239 /* we have a resoid */
240 if( ber_scanf( ber, "a", &resoid ) == LBER_ERROR ) {
241 ld->ld_errno = LDAP_DECODING_ERROR;
246 assert( resoid[ 0 ] != '\0' );
248 tag = ber_peek_tag( ber, &len );
251 if( tag == LDAP_TAG_EXOP_RES_VALUE ) {
252 /* we have a resdata */
253 if( ber_scanf( ber, "O", &resdata ) == LBER_ERROR ) {
254 ld->ld_errno = LDAP_DECODING_ERROR;
256 if( resoid != NULL ) LDAP_FREE( resoid );
263 if( retoidp != NULL ) {
269 if( retdatap != NULL ) {
272 ber_bvfree( resdata );
275 ld->ld_errno = errcode;
285 /* Parse an extended partial */
287 ldap_parse_intermediate (
291 struct berval **retdatap,
292 LDAPControl ***serverctrls,
299 struct berval *resdata;
302 assert( ld != NULL );
303 assert( LDAP_VALID( ld ) );
304 assert( res != NULL );
306 Debug( LDAP_DEBUG_TRACE, "ldap_parse_intermediate\n", 0, 0, 0 );
308 if( ld->ld_version < LDAP_VERSION3 ) {
309 ld->ld_errno = LDAP_NOT_SUPPORTED;
313 if( res->lm_msgtype != LDAP_RES_INTERMEDIATE ) {
314 ld->ld_errno = LDAP_PARAM_ERROR;
318 if( retoidp != NULL ) *retoidp = NULL;
319 if( retdatap != NULL ) *retdatap = NULL;
321 ber = ber_dup( res->lm_ber );
324 ld->ld_errno = LDAP_NO_MEMORY;
328 rc = ber_scanf( ber, "{" /*}*/ );
330 if( rc == LBER_ERROR ) {
331 ld->ld_errno = LDAP_DECODING_ERROR;
339 tag = ber_peek_tag( ber, &len );
342 * NOTE: accept intermediate and extended response tag values
343 * as older versions of slapd(8) incorrectly used extended
345 * Should be removed when 2.2 is moved to Historic.
347 if( tag == LDAP_TAG_IM_RES_OID || tag == LDAP_TAG_EXOP_RES_OID ) {
348 /* we have a resoid */
349 if( ber_scanf( ber, "a", &resoid ) == LBER_ERROR ) {
350 ld->ld_errno = LDAP_DECODING_ERROR;
355 assert( resoid[ 0 ] != '\0' );
357 tag = ber_peek_tag( ber, &len );
360 if( tag == LDAP_TAG_IM_RES_VALUE || tag == LDAP_TAG_EXOP_RES_VALUE ) {
361 /* we have a resdata */
362 if( ber_scanf( ber, "O", &resdata ) == LBER_ERROR ) {
363 ld->ld_errno = LDAP_DECODING_ERROR;
365 if( resoid != NULL ) LDAP_FREE( resoid );
370 if ( serverctrls == NULL ) {
372 goto free_and_return;
375 if ( ber_scanf( ber, /*{*/ "}" ) == LBER_ERROR ) {
376 rc = LDAP_DECODING_ERROR;
377 goto free_and_return;
380 rc = ldap_pvt_get_controls( ber, serverctrls );
385 if( retoidp != NULL ) {
391 if( retdatap != NULL ) {
394 ber_bvfree( resdata );