2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2004 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' );
135 assert( retoidp != NULL || retdatap != NULL );
137 rc = ldap_extended_operation( ld, reqoid, reqdata,
138 sctrls, cctrls, &msgid );
140 if ( rc != LDAP_SUCCESS ) {
144 if ( ldap_result( ld, msgid, 1, (struct timeval *) NULL, &res ) == -1 ) {
145 return( ld->ld_errno );
148 if ( retoidp != NULL ) *retoidp = NULL;
149 if ( retdatap != NULL ) *retdatap = NULL;
151 rc = ldap_parse_extended_result( ld, res, retoidp, retdatap, 0 );
153 if( rc != LDAP_SUCCESS ) {
158 return( ldap_result2error( ld, res, 1 ) );
161 /* Parse an extended result */
163 ldap_parse_extended_result (
167 struct berval **retdatap,
174 struct berval *resdata;
178 assert( ld != NULL );
179 assert( LDAP_VALID( ld ) );
180 assert( res != NULL );
182 Debug( LDAP_DEBUG_TRACE, "ldap_parse_extended_result\n", 0, 0, 0 );
184 if( ld->ld_version < LDAP_VERSION3 ) {
185 ld->ld_errno = LDAP_NOT_SUPPORTED;
189 if( res->lm_msgtype != LDAP_RES_EXTENDED ) {
190 ld->ld_errno = LDAP_PARAM_ERROR;
194 if( retoidp != NULL ) *retoidp = NULL;
195 if( retdatap != NULL ) *retdatap = NULL;
197 if ( ld->ld_error ) {
198 LDAP_FREE( ld->ld_error );
202 if ( ld->ld_matched ) {
203 LDAP_FREE( ld->ld_matched );
204 ld->ld_matched = NULL;
207 ber = ber_dup( res->lm_ber );
210 ld->ld_errno = LDAP_NO_MEMORY;
214 rc = ber_scanf( ber, "{iaa" /*}*/, &errcode,
215 &ld->ld_matched, &ld->ld_error );
217 if( rc == LBER_ERROR ) {
218 ld->ld_errno = LDAP_DECODING_ERROR;
226 tag = ber_peek_tag( ber, &len );
228 if( tag == LDAP_TAG_REFERRAL ) {
229 /* skip over referral */
230 if( ber_scanf( ber, "x" ) == LBER_ERROR ) {
231 ld->ld_errno = LDAP_DECODING_ERROR;
236 tag = ber_peek_tag( ber, &len );
239 if( tag == LDAP_TAG_EXOP_RES_OID ) {
240 /* we have a resoid */
241 if( ber_scanf( ber, "a", &resoid ) == LBER_ERROR ) {
242 ld->ld_errno = LDAP_DECODING_ERROR;
247 tag = ber_peek_tag( ber, &len );
250 if( tag == LDAP_TAG_EXOP_RES_VALUE ) {
251 /* we have a resdata */
252 if( ber_scanf( ber, "O", &resdata ) == LBER_ERROR ) {
253 ld->ld_errno = LDAP_DECODING_ERROR;
255 if( resoid != NULL ) LDAP_FREE( resoid );
262 if( retoidp != NULL ) {
268 if( retdatap != NULL ) {
271 ber_bvfree( resdata );
274 ld->ld_errno = errcode;
284 /* Parse an extended partial */
286 ldap_parse_intermediate (
290 struct berval **retdatap,
291 LDAPControl ***serverctrls,
298 struct berval *resdata;
301 assert( ld != NULL );
302 assert( LDAP_VALID( ld ) );
303 assert( res != NULL );
305 Debug( LDAP_DEBUG_TRACE, "ldap_parse_intermediate\n", 0, 0, 0 );
307 if( ld->ld_version < LDAP_VERSION3 ) {
308 ld->ld_errno = LDAP_NOT_SUPPORTED;
312 if( res->lm_msgtype != LDAP_RES_INTERMEDIATE ) {
313 ld->ld_errno = LDAP_PARAM_ERROR;
317 if( retoidp != NULL ) *retoidp = NULL;
318 if( retdatap != NULL ) *retdatap = NULL;
320 ber = ber_dup( res->lm_ber );
323 ld->ld_errno = LDAP_NO_MEMORY;
327 rc = ber_scanf( ber, "{" /*}*/ );
329 if( rc == LBER_ERROR ) {
330 ld->ld_errno = LDAP_DECODING_ERROR;
338 tag = ber_peek_tag( ber, &len );
341 * NOTE: accept intermediate and extended response tag values
342 * as older versions of slapd(8) incorrectly used extended
344 * Should be removed when 2.2 is moved to Historic.
346 if( tag == LDAP_TAG_IM_RES_OID || tag == LDAP_TAG_EXOP_RES_OID ) {
347 /* we have a resoid */
348 if( ber_scanf( ber, "a", &resoid ) == LBER_ERROR ) {
349 ld->ld_errno = LDAP_DECODING_ERROR;
354 tag = ber_peek_tag( ber, &len );
357 if( tag == LDAP_TAG_IM_RES_VALUE || tag == LDAP_TAG_EXOP_RES_VALUE ) {
358 /* we have a resdata */
359 if( ber_scanf( ber, "O", &resdata ) == LBER_ERROR ) {
360 ld->ld_errno = LDAP_DECODING_ERROR;
362 if( resoid != NULL ) LDAP_FREE( resoid );
367 if ( serverctrls == NULL ) {
369 goto free_and_return;
372 if ( ber_scanf( ber, /*{*/ "}" ) == LBER_ERROR ) {
373 rc = LDAP_DECODING_ERROR;
374 goto free_and_return;
377 rc = ldap_pvt_get_controls( ber, serverctrls );
382 if( retoidp != NULL ) {
388 if( retdatap != NULL ) {
391 ber_bvfree( resdata );