1 /* op.c - relay backend operations */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 2004-2009 The OpenLDAP Foundation.
6 * Portions Copyright 2004 Pierangelo Masarati.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted only as authorized by the OpenLDAP
13 * A copy of this license is available in the file LICENSE in the
14 * top-level directory of the distribution or, alternatively, at
15 * <http://www.OpenLDAP.org/license.html>.
18 * This work was initially developed by Pierangelo Masarati for inclusion
19 * in OpenLDAP Software.
27 #include "back-relay.h"
29 /* Results when no real database (.rf_bd) or operation handler (.rf_op) */
30 static const struct relay_fail_modes_s {
31 slap_mask_t rf_bd, rf_op;
32 #define RB_ERR_MASK 0x0000FFFFU /* bitmask for default return value */
33 #define RB_BDERR 0x80000000U /* use .rf_bd's default return value */
34 #define RB_OPERR 0x40000000U /* set rs->sr_err = .rf_op return value */
35 #define RB_REF 0x20000000U /* use default_referral if available */
36 #define RB_SEND 0x10000000U /* send result; RB_??ERR is also set */
37 #define RB_SENDREF 0/*unused*/ /* like RB_SEND when referral found */
38 #define RB_NO_BIND (RB_OPERR | LDAP_INVALID_CREDENTIALS)
39 #define RB_NOT_SUPP (RB_OPERR | LDAP_UNWILLING_TO_PERFORM)
40 #define RB_NO_OBJ (RB_REF | LDAP_NO_SUCH_OBJECT)
41 #define RB_CHK_REF (RB_REF | RB_SENDREF | LDAP_SUCCESS)
42 } relay_fail_modes[relay_op_last] = {
43 /* .rf_bd is unused when zero, otherwise both fields have RB_BDERR */
44 # define RB_OP(b, o) { (b) | RB_BD2ERR(b), (o) | RB_BD2ERR(b) }
45 # define RB_BD2ERR(b) ((b) ? RB_BDERR : 0)
46 /* indexed by slap_operation_t: */
47 RB_OP(RB_NO_BIND|RB_SEND, RB_NO_BIND |RB_SEND), /* Bind */
48 RB_OP(0, LDAP_SUCCESS), /* Unbind: unused */
49 RB_OP(RB_NO_OBJ |RB_SEND, RB_NOT_SUPP |RB_SEND), /* Search */
50 RB_OP(RB_NO_OBJ |RB_SEND, SLAP_CB_CONTINUE), /* Compare */
51 RB_OP(RB_NO_OBJ |RB_SEND, RB_NOT_SUPP |RB_SEND), /* Modify */
52 RB_OP(RB_NO_OBJ |RB_SEND, RB_NOT_SUPP |RB_SEND), /* Modrdn */
53 RB_OP(RB_NO_OBJ |RB_SEND, RB_NOT_SUPP |RB_SEND), /* Add */
54 RB_OP(RB_NO_OBJ |RB_SEND, RB_NOT_SUPP |RB_SEND), /* Delete */
55 RB_OP(0, LDAP_SUCCESS), /* Abandon:unused */
56 RB_OP(RB_NO_OBJ, RB_NOT_SUPP), /* Extended */
57 RB_OP(0, SLAP_CB_CONTINUE), /* Cancel: unused */
58 RB_OP(0, LDAP_SUCCESS), /* operational */
59 RB_OP(RB_CHK_REF, LDAP_SUCCESS), /* chk_referrals:unused*/
60 RB_OP(0, SLAP_CB_CONTINUE),/* chk_controls:unused */
61 /* additional relay_operation_t indexes from back-relay.h: */
62 RB_OP(0, 0/*unused*/), /* entry_get = op_last */
63 RB_OP(0, 0/*unused*/), /* entry_release */
64 RB_OP(0, 0/*unused*/), /* has_subordinates */
68 * Callbacks: Caller changed op->o_bd from Relay to underlying
69 * BackendDB. sc_response sets it to Relay BackendDB, sc_cleanup puts
70 * back underlying BackendDB. Caller will restore Relay BackendDB.
73 typedef struct relay_callback {
79 relay_back_cleanup_cb( Operation *op, SlapReply *rs )
81 op->o_bd = ((relay_callback *) op->o_callback)->rcb_bd;
82 return SLAP_CB_CONTINUE;
86 relay_back_response_cb( Operation *op, SlapReply *rs )
88 relay_callback *rcb = (relay_callback *) op->o_callback;
90 rcb->rcb_sc.sc_cleanup = relay_back_cleanup_cb;
91 rcb->rcb_bd = op->o_bd;
92 op->o_bd = op->o_callback->sc_private;
93 return SLAP_CB_CONTINUE;
96 /* quick hack for ITS#6337: use malloc'ed callback for bind */
98 relay_back_cleanup2_cb( Operation *op, SlapReply *rs )
100 op->o_bd = ((relay_callback *) op->o_callback)->rcb_bd;
101 op->o_tmpfree( op->o_callback, op->o_tmpmemctx );
102 op->o_callback = NULL;
103 return SLAP_CB_CONTINUE;
107 relay_back_response2_cb( Operation *op, SlapReply *rs )
109 relay_callback *rcb = (relay_callback *) op->o_callback;
111 rcb->rcb_sc.sc_cleanup = relay_back_cleanup2_cb;
112 rcb->rcb_bd = op->o_bd;
113 op->o_bd = op->o_callback->sc_private;
114 return SLAP_CB_CONTINUE;
117 #define relay_back_add_cb( rcb, op, bd ) \
119 (rcb)->rcb_sc.sc_next = (op)->o_callback; \
120 (rcb)->rcb_sc.sc_response = relay_back_response_cb; \
121 (rcb)->rcb_sc.sc_cleanup = 0; \
122 (rcb)->rcb_sc.sc_private = (op)->o_bd; \
123 (op)->o_callback = (slap_callback *) (rcb); \
127 * Select the backend database with the operation's DN. On failure,
128 * set/send results depending on operation type <which>'s fail_modes.
131 relay_back_select_backend( Operation *op, SlapReply *rs, int which )
134 char *key = (char *) op->o_bd->be_private;
135 BackendDB *bd = ((relay_back_info *) key)->ri_bd;
136 slap_mask_t fail_mode = relay_fail_modes[which].rf_bd;
137 int useDN = 0, rc = ( fail_mode & RB_ERR_MASK );
139 if ( bd == NULL && !BER_BVISNULL( &op->o_req_ndn ) ) {
141 bd = select_backend( &op->o_req_ndn, 1 );
145 key += which; /* <relay, op type> key from RELAY_WRAP_OP() */
146 LDAP_SLIST_FOREACH( oex, &op->o_extra, oe_next ) {
147 if ( oex->oe_key == key )
154 Debug( LDAP_DEBUG_ANY,
155 "%s: back-relay for DN=\"%s\" would call self.\n",
156 op->o_log_prefix, op->o_req_dn.bv_val, 0 );
158 } else if ( useDN && ( fail_mode & RB_REF ) && default_referral ) {
161 /* if we set sr_err to LDAP_REFERRAL, we must provide one */
162 rs->sr_ref = referral_rewrite(
163 default_referral, NULL, &op->o_req_dn,
164 op->o_tag == LDAP_REQ_SEARCH ?
165 op->ors_scope : LDAP_SCOPE_DEFAULT );
166 if ( rs->sr_ref != NULL ) {
167 rs->sr_flags |= REP_REF_MUSTBEFREED;
169 rs->sr_ref = default_referral;
172 if ( fail_mode & RB_SENDREF )
173 fail_mode = (RB_BDERR | RB_SEND);
176 if ( fail_mode & RB_BDERR ) {
178 if ( fail_mode & RB_SEND ) {
179 send_ldap_result( op, rs );
187 * Forward <act> on <op> to database <bd>, with <relay, op type>-specific
188 * key in op->o_extra so relay_back_select_backend() can catch recursion.
190 #define RELAY_WRAP_OP( op, bd, which, act ) { \
191 OpExtraDB wrap_oex; \
192 BackendDB *const wrap_bd = (op)->o_bd; \
193 wrap_oex.oe_db = wrap_bd; \
194 wrap_oex.oe.oe_key = (char *) wrap_bd->be_private + (which); \
195 LDAP_SLIST_INSERT_HEAD( &(op)->o_extra, &wrap_oex.oe, oe_next ); \
198 (op)->o_bd = wrap_bd; \
199 LDAP_SLIST_REMOVE( &(op)->o_extra, &wrap_oex.oe, OpExtra, oe_next ); \
203 * Forward backend function #<which> on <op> to operation DN's database
204 * like RELAY_WRAP_OP, after setting up callbacks. If no database or no
205 * backend function, set/send results depending on <which>'s fail_modes.
208 relay_back_op( Operation *op, SlapReply *rs, int which )
212 slap_mask_t fail_mode = relay_fail_modes[which].rf_op;
213 int rc = ( fail_mode & RB_ERR_MASK );
215 bd = relay_back_select_backend( op, rs, which );
217 if ( fail_mode & RB_BDERR )
218 return rs->sr_err; /* sr_err was set above */
220 } else if ( (func = (&bd->be_bind)[which]) != 0 ) {
223 if ( which == op_bind ) {
224 /* quick hack for ITS#6337: use malloc'ed callback for bind */
225 relay_callback *rcbp = op->o_tmpcalloc( sizeof( relay_callback ), 1, op->o_tmpmemctx );
226 relay_back_add_cb( rcbp, op, bd );
227 rcbp->rcb_sc.sc_response = relay_back_response2_cb;
230 relay_back_add_cb( &rcb, op, bd );
233 RELAY_WRAP_OP( op, bd, which, {
237 if ( op->o_callback == (slap_callback *) &rcb ) {
238 op->o_callback = op->o_callback->sc_next;
241 } else if ( fail_mode & RB_OPERR ) {
243 if ( rc == LDAP_UNWILLING_TO_PERFORM ) {
244 rs->sr_text = "operation not supported within naming context";
247 if ( fail_mode & RB_SEND ) {
248 send_ldap_result( op, rs );
257 relay_back_op_bind( Operation *op, SlapReply *rs )
259 /* allow rootdn as a means to auth without the need to actually
260 * contact the proxied DSA */
261 switch ( be_rootdn_bind( op, rs ) ) {
262 case SLAP_CB_CONTINUE:
269 return relay_back_op( op, rs, op_bind );
272 #define RELAY_DEFOP(func, which) \
273 int func( Operation *op, SlapReply *rs ) \
274 { return relay_back_op( op, rs, which ); }
276 RELAY_DEFOP( relay_back_op_search, op_search )
277 RELAY_DEFOP( relay_back_op_compare, op_compare )
278 RELAY_DEFOP( relay_back_op_modify, op_modify )
279 RELAY_DEFOP( relay_back_op_modrdn, op_modrdn )
280 RELAY_DEFOP( relay_back_op_add, op_add )
281 RELAY_DEFOP( relay_back_op_delete, op_delete )
282 RELAY_DEFOP( relay_back_op_extended, op_extended )
283 RELAY_DEFOP( relay_back_operational, op_aux_operational )
285 /* Abandon, Cancel, Unbind and some DN-less calls like be_connection_init
286 * need no extra handling: slapd already calls them for all databases.
291 relay_back_entry_release_rw( Operation *op, Entry *e, int rw )
294 int rc = LDAP_UNWILLING_TO_PERFORM;
296 bd = relay_back_select_backend( op, NULL, relay_op_entry_release );
297 if ( bd && bd->be_release ) {
298 RELAY_WRAP_OP( op, bd, relay_op_entry_release, {
299 rc = bd->be_release( op, e, rw );
301 } else if ( e->e_private == NULL ) {
310 relay_back_entry_get_rw( Operation *op, struct berval *ndn,
311 ObjectClass *oc, AttributeDescription *at, int rw, Entry **e )
314 int rc = LDAP_NO_SUCH_OBJECT;
316 bd = relay_back_select_backend( op, NULL, relay_op_entry_get );
317 if ( bd && bd->be_fetch ) {
318 RELAY_WRAP_OP( op, bd, relay_op_entry_get, {
319 rc = bd->be_fetch( op, ndn, oc, at, rw, e );
326 #if 0 /* Give the RB_SENDREF flag a nonzero value if implementing this */
328 * NOTE: even the existence of this function is questionable: we cannot
329 * pass the bi_chk_referrals() call thru the rwm overlay because there
330 * is no way to rewrite the req_dn back; but then relay_back_chk_referrals()
331 * is passing the target database a DN that likely does not belong to its
332 * naming context... mmmh.
334 RELAY_DEFOP( relay_back_chk_referrals, op_aux_chk_referrals )
338 relay_back_has_subordinates( Operation *op, Entry *e, int *hasSubs )
343 bd = relay_back_select_backend( op, NULL, relay_op_has_subordinates );
344 if ( bd && bd->be_has_subordinates ) {
345 RELAY_WRAP_OP( op, bd, relay_op_has_subordinates, {
346 rc = bd->be_has_subordinates( op, e, hasSubs );
355 * FIXME: must implement tools as well