git.sur5r.net Git - openldap/blob - libraries/libldap/request.c

   1 /* $OpenLDAP$ */
   2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
   3  *
   4  * Copyright 1998-2006 The OpenLDAP Foundation.
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted only as authorized by the OpenLDAP
   9  * Public License.
  10  *
  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>.
  14  */
  15 /* Portions Copyright (c) 1995 Regents of the University of Michigan.
  16  * All rights reserved.
  17  */
  18 /* This notice applies to changes, created by or for Novell, Inc.,
  19  * to preexisting works for which notices appear elsewhere in this file.
  20  *
  21  * Copyright (C) 1999, 2000 Novell, Inc. All Rights Reserved.
  22  *
  23  * THIS WORK IS SUBJECT TO U.S. AND INTERNATIONAL COPYRIGHT LAWS AND TREATIES.
  24  * USE, MODIFICATION, AND REDISTRIBUTION OF THIS WORK IS SUBJECT TO VERSION
  25  * 2.0.1 OF THE OPENLDAP PUBLIC LICENSE, A COPY OF WHICH IS AVAILABLE AT
  26  * HTTP://WWW.OPENLDAP.ORG/LICENSE.HTML OR IN THE FILE "LICENSE" IN THE
  27  * TOP-LEVEL DIRECTORY OF THE DISTRIBUTION. ANY USE OR EXPLOITATION OF THIS
  28  * WORK OTHER THAN AS AUTHORIZED IN VERSION 2.0.1 OF THE OPENLDAP PUBLIC
  29  * LICENSE, OR OTHER PRIOR WRITTEN CONSENT FROM NOVELL, COULD SUBJECT THE
  30  * PERPETRATOR TO CRIMINAL AND CIVIL LIABILITY.
  31  *---
  32  * Modification to OpenLDAP source by Novell, Inc.
  33  * April 2000 sfs  Added code to chase V3 referrals
  34  *  request.c - sending of ldap requests; handling of referrals
  35  *---
  36  * Note: A verbatim copy of version 2.0.1 of the OpenLDAP Public License
  37  * can be found in the file "build/LICENSE-2.0.1" in this distribution
  38  * of OpenLDAP Software.
  39  */
  40
  41 #include "portable.h"
  42
  43 #include <stdio.h>
  44
  45 #include <ac/stdlib.h>
  46
  47 #include <ac/errno.h>
  48 #include <ac/socket.h>
  49 #include <ac/string.h>
  50 #include <ac/time.h>
  51 #include <ac/unistd.h>
  52
  53 #include "ldap-int.h"
  54 #include "lber.h"
  55
  56 static LDAPConn *find_connection LDAP_P(( LDAP *ld, LDAPURLDesc *srv, int any ));
  57 static void use_connection LDAP_P(( LDAP *ld, LDAPConn *lc ));
  58 static void ldap_free_request_int LDAP_P(( LDAP *ld, LDAPRequest *lr ));
  59
  60 static BerElement *
  61 re_encode_request( LDAP *ld,
  62         BerElement *origber,
  63         ber_int_t msgid,
  64         int sref,
  65         LDAPURLDesc *srv,
  66         int *type );
  67
  68 BerElement *
  69 ldap_alloc_ber_with_options( LDAP *ld )
  70 {
  71         BerElement      *ber;
  72
  73         ber = ber_alloc_t( ld->ld_lberoptions );
  74         if ( ber == NULL ) {
  75                 ld->ld_errno = LDAP_NO_MEMORY;
  76         }
  77
  78         return( ber );
  79 }
  80
  81
  82 void
  83 ldap_set_ber_options( LDAP *ld, BerElement *ber )
  84 {
  85         ber->ber_options = ld->ld_lberoptions;
  86 }
  87
  88
  89 ber_int_t
  90 ldap_send_initial_request(
  91         LDAP *ld,
  92         ber_tag_t msgtype,
  93         const char *dn,
  94         BerElement *ber,
  95         ber_int_t msgid)
  96 {
  97         int rc = 1;
  98
  99         Debug( LDAP_DEBUG_TRACE, "ldap_send_initial_request\n", 0, 0, 0 );
 100
 101 #ifdef LDAP_R_COMPILE
 102         ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
 103 #endif
 104         if ( ber_sockbuf_ctrl( ld->ld_sb, LBER_SB_OPT_GET_FD, NULL ) == -1 ) {
 105                 /* not connected yet */
 106                 rc = ldap_open_defconn( ld );
 107
 108         }
 109 #ifdef LDAP_R_COMPILE
 110         ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
 111 #endif
 112         if( rc < 0 ) {
 113                 ber_free( ber, 1 );
 114                 return( -1 );
 115         } else if ( rc == 0 ) {
 116                 Debug( LDAP_DEBUG_TRACE,
 117                         "ldap_open_defconn: successful\n",
 118                         0, 0, 0 );
 119         }
 120
 121 #ifdef LDAP_CONNECTIONLESS
 122         if (LDAP_IS_UDP(ld)) {
 123                 if (msgtype == LDAP_REQ_BIND) {
 124                         if (ld->ld_options.ldo_cldapdn)
 125                                 ldap_memfree(ld->ld_options.ldo_cldapdn);
 126                         ld->ld_options.ldo_cldapdn = ldap_strdup(dn);
 127                         return 0;
 128                 }
 129                 if (msgtype != LDAP_REQ_ABANDON && msgtype != LDAP_REQ_SEARCH)
 130                         return LDAP_PARAM_ERROR;
 131         }
 132 #endif
 133 #ifdef LDAP_R_COMPILE
 134         ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
 135 #endif
 136         rc = ldap_send_server_request( ld, ber, msgid, NULL,
 137                 NULL, NULL, NULL );
 138 #ifdef LDAP_R_COMPILE
 139         ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
 140 #endif
 141         return(rc);
 142 }
 143
 144
 145 int
 146 ldap_int_flush_request(
 147         LDAP *ld,
 148         LDAPRequest *lr )
 149 {
 150         LDAPConn *lc = lr->lr_conn;
 151
 152         if ( ber_flush2( lc->lconn_sb, lr->lr_ber, LBER_FLUSH_FREE_NEVER ) != 0 ) {
 153                 if ( sock_errno() == EAGAIN ) {
 154                         /* need to continue write later */
 155                         lr->lr_status = LDAP_REQST_WRITING;
 156                         ldap_mark_select_write( ld, lc->lconn_sb );
 157                         ld->ld_errno = LDAP_BUSY;
 158                         return -2;
 159                 } else {
 160                         ld->ld_errno = LDAP_SERVER_DOWN;
 161                         ldap_free_request( ld, lr );
 162                         ldap_free_connection( ld, lc, 0, 0 );
 163                         return( -1 );
 164                 }
 165         } else {
 166                 if ( lr->lr_parent == NULL ) {
 167                         lr->lr_ber->ber_end = lr->lr_ber->ber_ptr;
 168                         lr->lr_ber->ber_ptr = lr->lr_ber->ber_buf;
 169                 }
 170                 lr->lr_status = LDAP_REQST_INPROGRESS;
 171
 172                 /* sent -- waiting for a response */
 173                 ldap_mark_select_read( ld, lc->lconn_sb );
 174         }
 175         return 0;
 176 }
 177
 178 int
 179 ldap_send_server_request(
 180         LDAP *ld,
 181         BerElement *ber,
 182         ber_int_t msgid,
 183         LDAPRequest *parentreq,
 184         LDAPURLDesc **srvlist,
 185         LDAPConn *lc,
 186         LDAPreqinfo *bind )
 187 {
 188         LDAPRequest     *lr;
 189         int             incparent, rc;
 190
 191         Debug( LDAP_DEBUG_TRACE, "ldap_send_server_request\n", 0, 0, 0 );
 192
 193         incparent = 0;
 194         ld->ld_errno = LDAP_SUCCESS;    /* optimistic */
 195
 196         if ( lc == NULL ) {
 197                 if ( srvlist == NULL ) {
 198                         lc = ld->ld_defconn;
 199                 } else {
 200                         lc = find_connection( ld, *srvlist, 1 );
 201                         if ( lc == NULL ) {
 202                                 if ( (bind != NULL) && (parentreq != NULL) ) {
 203                                         /* Remember the bind in the parent */
 204                                         incparent = 1;
 205                                         ++parentreq->lr_outrefcnt;
 206                                 }
 207                                 lc = ldap_new_connection( ld, srvlist, 0, 1, bind );
 208                         }
 209                 }
 210         }
 211
 212         if ( lc == NULL || lc->lconn_status != LDAP_CONNST_CONNECTED ) {
 213                 ber_free( ber, 1 );
 214                 if ( ld->ld_errno == LDAP_SUCCESS ) {
 215                         ld->ld_errno = LDAP_SERVER_DOWN;
 216                 }
 217                 if ( incparent ) {
 218                         /* Forget about the bind */
 219                         --parentreq->lr_outrefcnt;
 220                 }
 221                 return( -1 );
 222         }
 223
 224         use_connection( ld, lc );
 225
 226         /* If we still have an incomplete write, try to finish it before
 227          * dealing with the new request. If we don't finish here, return
 228          * LDAP_BUSY and let the caller retry later. We only allow a single
 229          * request to be in WRITING state.
 230          */
 231         rc = 0;
 232         if ( ld->ld_requests &&
 233                 ld->ld_requests->lr_status == LDAP_REQST_WRITING &&
 234                 ldap_int_flush_request( ld, ld->ld_requests ) < 0 )
 235         {
 236                 rc = -1;
 237         }
 238         if ( rc ) return rc;
 239
 240         lr = (LDAPRequest *)LDAP_CALLOC( 1, sizeof( LDAPRequest ) );
 241         if ( lr == NULL ) {
 242                 ld->ld_errno = LDAP_NO_MEMORY;
 243                 ldap_free_connection( ld, lc, 0, 0 );
 244                 ber_free( ber, 1 );
 245                 if ( incparent ) {
 246                         /* Forget about the bind */
 247                         --parentreq->lr_outrefcnt;
 248                 }
 249                 return( -1 );
 250         }
 251         lr->lr_msgid = msgid;
 252         lr->lr_status = LDAP_REQST_INPROGRESS;
 253         lr->lr_res_errno = LDAP_SUCCESS;        /* optimistic */
 254         lr->lr_ber = ber;
 255         lr->lr_conn = lc;
 256         if ( parentreq != NULL ) {      /* sub-request */
 257                 if ( !incparent ) {
 258                         /* Increment if we didn't do it before the bind */
 259                         ++parentreq->lr_outrefcnt;
 260                 }
 261                 lr->lr_origid = parentreq->lr_origid;
 262                 lr->lr_parentcnt = ++parentreq->lr_parentcnt;
 263                 lr->lr_parent = parentreq;
 264                 lr->lr_refnext = parentreq->lr_child;
 265                 parentreq->lr_child = lr;
 266         } else {                        /* original request */
 267                 lr->lr_origid = lr->lr_msgid;
 268         }
 269
 270         /* Extract requestDN for future reference */
 271         {
 272                 BerElement tmpber = *ber;
 273                 ber_int_t       bint;
 274                 ber_tag_t       tag, rtag;
 275
 276                 ber_reset( &tmpber, 1 );
 277                 rtag = ber_scanf( &tmpber, "{it", /*}*/ &bint, &tag );
 278                 switch ( tag ) {
 279                 case LDAP_REQ_BIND:
 280                         rtag = ber_scanf( &tmpber, "{i" /*}*/, &bint );
 281                         break;
 282                 case LDAP_REQ_DELETE:
 283                         break;
 284                 default:
 285                         rtag = ber_scanf( &tmpber, "{" /*}*/ );
 286                 case LDAP_REQ_ABANDON:
 287                         break;
 288                 }
 289                 if ( tag != LDAP_REQ_ABANDON ) {
 290                         ber_skip_tag( &tmpber, &lr->lr_dn.bv_len );
 291                         lr->lr_dn.bv_val = tmpber.ber_ptr;
 292                 }
 293         }
 294
 295         lr->lr_prev = NULL;
 296         lr->lr_next = ld->ld_requests;
 297         if ( lr->lr_next != NULL ) {
 298                 lr->lr_next->lr_prev = lr;
 299         }
 300         ld->ld_requests = lr;
 301
 302         ld->ld_errno = LDAP_SUCCESS;
 303         if ( ldap_int_flush_request( ld, lr ) == -1 ) {
 304                 msgid = -1;
 305         }
 306
 307         return( msgid );
 308 }
 309
 310 LDAPConn *
 311 ldap_new_connection( LDAP *ld, LDAPURLDesc **srvlist, int use_ldsb,
 312         int connect, LDAPreqinfo *bind )
 313 {
 314         LDAPConn        *lc;
 315
 316         Debug( LDAP_DEBUG_TRACE, "ldap_new_connection %d %d %d\n",
 317                 use_ldsb, connect, (bind != NULL) );
 318         /*
 319          * make a new LDAP server connection
 320          * XXX open connection synchronously for now
 321          */
 322         lc = (LDAPConn *)LDAP_CALLOC( 1, sizeof( LDAPConn ) );
 323         if ( lc == NULL ) {
 324                 ld->ld_errno = LDAP_NO_MEMORY;
 325                 return( NULL );
 326         }
 327
 328         if ( use_ldsb ) {
 329                 assert( ld->ld_sb != NULL );
 330                 lc->lconn_sb = ld->ld_sb;
 331
 332         } else {
 333                 lc->lconn_sb = ber_sockbuf_alloc();
 334                 if ( lc->lconn_sb == NULL ) {
 335                         LDAP_FREE( (char *)lc );
 336                         ld->ld_errno = LDAP_NO_MEMORY;
 337                         return( NULL );
 338                 }
 339         }
 340
 341         if ( connect ) {
 342                 LDAPURLDesc     **srvp, *srv = NULL;
 343
 344                 for ( srvp = srvlist; *srvp != NULL; srvp = &(*srvp)->lud_next ) {
 345                         if ( ldap_int_open_connection( ld, lc, *srvp, 0 ) != -1 )
 346                         {
 347                                 srv = *srvp;
 348
 349                                 if ( ld->ld_urllist_proc ) {
 350                                         ld->ld_urllist_proc( ld, srvlist, srvp, ld->ld_urllist_params );
 351                                 }
 352
 353                                 break;
 354                         }
 355                 }
 356
 357                 if ( srv == NULL ) {
 358                         if ( !use_ldsb ) {
 359                                 ber_sockbuf_free( lc->lconn_sb );
 360                         }
 361                         LDAP_FREE( (char *)lc );
 362                         ld->ld_errno = LDAP_SERVER_DOWN;
 363                         return( NULL );
 364                 }
 365
 366                 lc->lconn_server = ldap_url_dup( srv );
 367         }
 368
 369         lc->lconn_status = LDAP_CONNST_CONNECTED;
 370 #ifdef LDAP_R_COMPILE
 371         ldap_pvt_thread_mutex_lock( &ld->ld_conn_mutex );
 372 #endif
 373         lc->lconn_next = ld->ld_conns;
 374         ld->ld_conns = lc;
 375 #ifdef LDAP_R_COMPILE
 376         ldap_pvt_thread_mutex_unlock( &ld->ld_conn_mutex );
 377 #endif
 378
 379         if ( bind != NULL ) {
 380                 int             err = 0;
 381                 LDAPConn        *savedefconn;
 382
 383                 /* Set flag to prevent additional referrals
 384                  * from being processed on this
 385                  * connection until the bind has completed
 386                  */
 387                 lc->lconn_rebind_inprogress = 1;
 388                 /* V3 rebind function */
 389                 if ( ld->ld_rebind_proc != NULL) {
 390                         LDAPURLDesc     *srvfunc;
 391
 392                         srvfunc = ldap_url_dup( *srvlist );
 393                         if ( srvfunc == NULL ) {
 394                                 ld->ld_errno = LDAP_NO_MEMORY;
 395                                 err = -1;
 396                         } else {
 397                                 savedefconn = ld->ld_defconn;
 398                                 ++lc->lconn_refcnt;     /* avoid premature free */
 399                                 ld->ld_defconn = lc;
 400
 401                                 Debug( LDAP_DEBUG_TRACE, "Call application rebind_proc\n", 0, 0, 0);
 402 #ifdef LDAP_R_COMPILE
 403                                 ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
 404                                 ldap_pvt_thread_mutex_unlock( &ld->ld_res_mutex );
 405 #endif
 406                                 err = (*ld->ld_rebind_proc)( ld,
 407                                         bind->ri_url, bind->ri_request, bind->ri_msgid,
 408                                         ld->ld_rebind_params );
 409 #ifdef LDAP_R_COMPILE
 410                                 ldap_pvt_thread_mutex_lock( &ld->ld_res_mutex );
 411                                 ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
 412 #endif
 413
 414                                 ld->ld_defconn = savedefconn;
 415                                 --lc->lconn_refcnt;
 416
 417                                 if ( err != 0 ) {
 418                                         err = -1;
 419                                         ldap_free_connection( ld, lc, 1, 0 );
 420                                         lc = NULL;
 421                                 }
 422                                 ldap_free_urldesc( srvfunc );
 423                         }
 424
 425                 } else {
 426                         int             msgid, rc;
 427                         struct berval   passwd = BER_BVNULL;
 428
 429                         savedefconn = ld->ld_defconn;
 430                         ++lc->lconn_refcnt;     /* avoid premature free */
 431                         ld->ld_defconn = lc;
 432
 433                         Debug( LDAP_DEBUG_TRACE, "anonymous rebind via ldap_bind_s\n", 0, 0, 0);
 434 #ifdef LDAP_R_COMPILE
 435                         ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
 436                         ldap_pvt_thread_mutex_unlock( &ld->ld_res_mutex );
 437 #endif
 438                         rc = ldap_sasl_bind( ld, "", LDAP_SASL_SIMPLE, &passwd,
 439                                 NULL, NULL, &msgid );
 440                         if ( rc != LDAP_SUCCESS ) {
 441                                 err = -1;
 442
 443                         } else {
 444                                 for ( err = 1; err > 0; ) {
 445                                         struct timeval  tv = { 0, 100000 };
 446                                         LDAPMessage     *res = NULL;
 447
 448                                         switch ( ldap_result( ld, msgid, LDAP_MSG_ALL, &tv, &res ) ) {
 449                                         case -1:
 450                                                 err = -1;
 451                                                 break;
 452
 453                                         case 0:
 454 #ifdef LDAP_R_COMPILE
 455                                                 ldap_pvt_thread_yield();
 456 #endif
 457                                                 break;
 458
 459                                         case LDAP_RES_BIND:
 460                                                 rc = ldap_parse_result( ld, res, &err, NULL, NULL, NULL, NULL, 1 );
 461                                                 if ( rc != LDAP_SUCCESS ) {
 462                                                         err = -1;
 463
 464                                                 } else if ( err != LDAP_SUCCESS ) {
 465                                                         err = -1;
 466                                                 }
 467                                                 /* else err == LDAP_SUCCESS == 0 */
 468                                                 break;
 469
 470                                         default:
 471                                                 assert( 0 );
 472                                         }
 473                                 }
 474                         }
 475 #ifdef LDAP_R_COMPILE
 476                         ldap_pvt_thread_mutex_lock( &ld->ld_res_mutex );
 477                         ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
 478 #endif
 479                         ld->ld_defconn = savedefconn;
 480                         --lc->lconn_refcnt;
 481
 482                         if ( err != 0 ) {
 483                                 ldap_free_connection( ld, lc, 1, 0 );
 484                                 lc = NULL;
 485                         }
 486                 }
 487                 if ( lc != NULL )
 488                         lc->lconn_rebind_inprogress = 0;
 489         }
 490
 491         return( lc );
 492 }
 493
 494
 495 static LDAPConn *
 496 find_connection( LDAP *ld, LDAPURLDesc *srv, int any )
 497 /*
 498  * return an existing connection (if any) to the server srv
 499  * if "any" is non-zero, check for any server in the "srv" chain
 500  */
 501 {
 502         LDAPConn        *lc;
 503         LDAPURLDesc     *lcu, *lsu;
 504         int lcu_port, lsu_port;
 505         int found = 0;
 506
 507 #ifdef LDAP_R_COMPILE
 508         ldap_pvt_thread_mutex_lock( &ld->ld_conn_mutex );
 509 #endif
 510         for ( lc = ld->ld_conns; lc != NULL; lc = lc->lconn_next ) {
 511                 lcu = lc->lconn_server;
 512                 lcu_port = ldap_pvt_url_scheme_port( lcu->lud_scheme,
 513                         lcu->lud_port );
 514
 515                 for ( lsu = srv; lsu != NULL; lsu = lsu->lud_next ) {
 516                         lsu_port = ldap_pvt_url_scheme_port( lsu->lud_scheme,
 517                                 lsu->lud_port );
 518
 519                         if ( lsu_port == lcu_port
 520                                 && strcmp( lcu->lud_scheme, lsu->lud_scheme ) == 0
 521                                 && lcu->lud_host != NULL && *lcu->lud_host != '\0'
 522                                 && lsu->lud_host != NULL && *lsu->lud_host != '\0'
 523                                 && strcasecmp( lsu->lud_host, lcu->lud_host ) == 0 )
 524                         {
 525                                 found = 1;
 526                                 break;
 527                         }
 528
 529                         if ( !any ) break;
 530                 }
 531                 if ( found )
 532                         break;
 533         }
 534 #ifdef LDAP_R_COMPILE
 535         ldap_pvt_thread_mutex_unlock( &ld->ld_conn_mutex );
 536 #endif
 537         return lc;
 538 }
 539
 540
 541
 542 static void
 543 use_connection( LDAP *ld, LDAPConn *lc )
 544 {
 545         ++lc->lconn_refcnt;
 546         lc->lconn_lastused = time( NULL );
 547 }
 548
 549
 550 void
 551 ldap_free_connection( LDAP *ld, LDAPConn *lc, int force, int unbind )
 552 {
 553         LDAPConn        *tmplc, *prevlc;
 554
 555         Debug( LDAP_DEBUG_TRACE,
 556                 "ldap_free_connection %d %d\n",
 557                 force, unbind, 0 );
 558
 559         if ( force || --lc->lconn_refcnt <= 0 ) {
 560                 /* remove from connections list first */
 561 #ifdef LDAP_R_COMPILE
 562                 ldap_pvt_thread_mutex_lock( &ld->ld_conn_mutex );
 563 #endif
 564
 565                 for ( prevlc = NULL, tmplc = ld->ld_conns;
 566                         tmplc != NULL;
 567                         tmplc = tmplc->lconn_next )
 568                 {
 569                         if ( tmplc == lc ) {
 570                                 if ( prevlc == NULL ) {
 571                                     ld->ld_conns = tmplc->lconn_next;
 572                                 } else {
 573                                     prevlc->lconn_next = tmplc->lconn_next;
 574                                 }
 575                                 break;
 576                         }
 577                         prevlc = tmplc;
 578                 }
 579 #ifdef LDAP_R_COMPILE
 580                 ldap_pvt_thread_mutex_unlock( &ld->ld_conn_mutex );
 581 #endif
 582
 583                 if ( lc->lconn_status == LDAP_CONNST_CONNECTED ) {
 584                         ldap_mark_select_clear( ld, lc->lconn_sb );
 585                         if ( unbind ) {
 586                                 ldap_send_unbind( ld, lc->lconn_sb,
 587                                                 NULL, NULL );
 588                         }
 589                 }
 590
 591                 if ( lc->lconn_ber != NULL ) {
 592                         ber_free( lc->lconn_ber, 1 );
 593                 }
 594
 595                 ldap_int_sasl_close( ld, lc );
 596
 597                 ldap_free_urllist( lc->lconn_server );
 598 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
 599                 if ( lc->lconn_krbinstance != NULL ) {
 600                         LDAP_FREE( lc->lconn_krbinstance );
 601                 }
 602 #endif
 603
 604                 /* FIXME: is this at all possible?
 605                  * ldap_ld_free() in unbind.c calls ldap_free_connection()
 606                  * with force == 1 __after__ explicitly calling
 607                  * ldap_free_request() on all requests */
 608                 if ( force ) {
 609                         LDAPRequest     *lr;
 610
 611                         for ( lr = ld->ld_requests; lr; ) {
 612                                 LDAPRequest     *lr_next = lr->lr_next;
 613
 614                                 if ( lr->lr_conn == lc ) {
 615                                         ldap_free_request_int( ld, lr );
 616                                 }
 617
 618                                 lr = lr_next;
 619                         }
 620                 }
 621
 622                 if ( lc->lconn_sb != ld->ld_sb ) {
 623                         ber_sockbuf_free( lc->lconn_sb );
 624                 }
 625
 626                 if ( lc->lconn_rebind_queue != NULL) {
 627                         int i;
 628                         for( i = 0; lc->lconn_rebind_queue[i] != NULL; i++ ) {
 629                                 LDAP_VFREE( lc->lconn_rebind_queue[i] );
 630                         }
 631                         LDAP_FREE( lc->lconn_rebind_queue );
 632                 }
 633
 634                 LDAP_FREE( lc );
 635
 636                 Debug( LDAP_DEBUG_TRACE,
 637                         "ldap_free_connection: actually freed\n",
 638                         0, 0, 0 );
 639
 640         } else {
 641                 lc->lconn_lastused = time( NULL );
 642                 Debug( LDAP_DEBUG_TRACE, "ldap_free_connection: refcnt %d\n",
 643                                 lc->lconn_refcnt, 0, 0 );
 644         }
 645 }
 646
 647
 648 #ifdef LDAP_DEBUG
 649 void
 650 ldap_dump_connection( LDAP *ld, LDAPConn *lconns, int all )
 651 {
 652         LDAPConn        *lc;
 653         char            timebuf[32];
 654
 655         Debug( LDAP_DEBUG_TRACE, "** ld %p Connection%s:\n", (void *)ld, all ? "s" : "", 0 );
 656         for ( lc = lconns; lc != NULL; lc = lc->lconn_next ) {
 657                 if ( lc->lconn_server != NULL ) {
 658                         Debug( LDAP_DEBUG_TRACE, "* host: %s  port: %d%s\n",
 659                                 ( lc->lconn_server->lud_host == NULL ) ? "(null)"
 660                                 : lc->lconn_server->lud_host,
 661                                 lc->lconn_server->lud_port, ( lc->lconn_sb ==
 662                                 ld->ld_sb ) ? "  (default)" : "" );
 663                 }
 664                 Debug( LDAP_DEBUG_TRACE, "  refcnt: %d  status: %s\n", lc->lconn_refcnt,
 665                         ( lc->lconn_status == LDAP_CONNST_NEEDSOCKET )
 666                         ?  "NeedSocket" : ( lc->lconn_status == LDAP_CONNST_CONNECTING )
 667                         ? "Connecting" : "Connected", 0 );
 668                 Debug( LDAP_DEBUG_TRACE, "  last used: %s%s\n",
 669                         ldap_pvt_ctime( &lc->lconn_lastused, timebuf ),
 670                         lc->lconn_rebind_inprogress ? "  rebind in progress" : "", 0 );
 671                 if ( lc->lconn_rebind_inprogress ) {
 672                         if ( lc->lconn_rebind_queue != NULL) {
 673                                 int     i;
 674
 675                                 for ( i = 0; lc->lconn_rebind_queue[i] != NULL; i++ ) {
 676                                         int     j;
 677                                         for( j = 0; lc->lconn_rebind_queue[i][j] != 0; j++ ) {
 678                                                 Debug( LDAP_DEBUG_TRACE, "    queue %d entry %d - %s\n",
 679                                                         i, j, lc->lconn_rebind_queue[i][j] );
 680                                         }
 681                                 }
 682                         } else {
 683                                 Debug( LDAP_DEBUG_TRACE, "    queue is empty\n", 0, 0, 0 );
 684                         }
 685                 }
 686                 Debug( LDAP_DEBUG_TRACE, "\n", 0, 0, 0 );
 687                 if ( !all ) {
 688                         break;
 689                 }
 690         }
 691 }
 692
 693
 694 void
 695 ldap_dump_requests_and_responses( LDAP *ld )
 696 {
 697         LDAPRequest     *lr;
 698         LDAPMessage     *lm, *l;
 699         int             i;
 700
 701         Debug( LDAP_DEBUG_TRACE, "** ld %p Outstanding Requests:\n",
 702                 (void *)ld, 0, 0 );
 703         lr = ld->ld_requests;
 704         if ( lr == NULL ) {
 705                 Debug( LDAP_DEBUG_TRACE, "   Empty\n", 0, 0, 0 );
 706         }
 707         for ( i = 0; lr != NULL; lr = lr->lr_next, i++ ) {
 708                 Debug( LDAP_DEBUG_TRACE, " * msgid %d,  origid %d, status %s\n",
 709                         lr->lr_msgid, lr->lr_origid,
 710                         ( lr->lr_status == LDAP_REQST_INPROGRESS ) ? "InProgress" :
 711                         ( lr->lr_status == LDAP_REQST_CHASINGREFS ) ? "ChasingRefs" :
 712                         ( lr->lr_status == LDAP_REQST_NOTCONNECTED ) ? "NotConnected" :
 713                         ( lr->lr_status == LDAP_REQST_WRITING ) ? "Writing" :
 714                         ( lr->lr_status == LDAP_REQST_COMPLETED ) ? "RequestCompleted"
 715                                 : "InvalidStatus" );
 716                 Debug( LDAP_DEBUG_TRACE, "   outstanding referrals %d, parent count %d\n",
 717                         lr->lr_outrefcnt, lr->lr_parentcnt, 0 );
 718         }
 719         Debug( LDAP_DEBUG_TRACE, "  ld %p request count %d (abandoned %d)\n",
 720                 (void *)ld, i, ld->ld_nabandoned );
 721         Debug( LDAP_DEBUG_TRACE, "** ld %p Response Queue:\n", (void *)ld, 0, 0 );
 722         if ( ( lm = ld->ld_responses ) == NULL ) {
 723                 Debug( LDAP_DEBUG_TRACE, "   Empty\n", 0, 0, 0 );
 724         }
 725         for ( i = 0; lm != NULL; lm = lm->lm_next, i++ ) {
 726                 Debug( LDAP_DEBUG_TRACE, " * msgid %d,  type %lu\n",
 727                     lm->lm_msgid, (unsigned long)lm->lm_msgtype, 0 );
 728                 if ( ( l = lm->lm_chain ) != NULL ) {
 729                         Debug( LDAP_DEBUG_TRACE, "   chained responses:\n", 0, 0, 0 );
 730                         for ( ; l != NULL; l = l->lm_chain ) {
 731                                 Debug( LDAP_DEBUG_TRACE,
 732                                         "  * msgid %d,  type %lu\n",
 733                                         l->lm_msgid,
 734                                         (unsigned long)l->lm_msgtype, 0 );
 735                         }
 736                 }
 737         }
 738         Debug( LDAP_DEBUG_TRACE, "  ld %p response count %d\n", (void *)ld, i, 0 );
 739 }
 740 #endif /* LDAP_DEBUG */
 741
 742 static void
 743 ldap_free_request_int( LDAP *ld, LDAPRequest *lr )
 744 {
 745         /* if lr_refcnt > 0, the request has been looked up
 746          * by ldap_find_request_by_msgid(); if in the meanwhile
 747          * the request is free()'d by someone else, just decrease
 748          * the reference count and extract it from the request
 749          * list; later on, it will be freed. */
 750         if ( lr->lr_prev == NULL ) {
 751                 if ( lr->lr_refcnt == 0 ) {
 752                         /* free'ing the first request? */
 753                         assert( ld->ld_requests == lr );
 754                 }
 755
 756                 if ( ld->ld_requests == lr ) {
 757                         ld->ld_requests = lr->lr_next;
 758                 }
 759
 760         } else {
 761                 lr->lr_prev->lr_next = lr->lr_next;
 762         }
 763
 764         if ( lr->lr_next != NULL ) {
 765                 lr->lr_next->lr_prev = lr->lr_prev;
 766         }
 767
 768         if ( lr->lr_refcnt > 0 ) {
 769                 lr->lr_refcnt = -lr->lr_refcnt;
 770
 771                 lr->lr_prev = NULL;
 772                 lr->lr_next = NULL;
 773
 774                 return;
 775         }
 776
 777         if ( lr->lr_ber != NULL ) {
 778                 ber_free( lr->lr_ber, 1 );
 779                 lr->lr_ber = NULL;
 780         }
 781
 782         if ( lr->lr_res_error != NULL ) {
 783                 LDAP_FREE( lr->lr_res_error );
 784                 lr->lr_res_error = NULL;
 785         }
 786
 787         if ( lr->lr_res_matched != NULL ) {
 788                 LDAP_FREE( lr->lr_res_matched );
 789                 lr->lr_res_matched = NULL;
 790         }
 791
 792         LDAP_FREE( lr );
 793 }
 794
 795 void
 796 ldap_free_request( LDAP *ld, LDAPRequest *lr )
 797 {
 798         LDAPRequest     **ttmplr;
 799 #ifdef LDAP_R_COMPILE
 800         LDAP_PVT_THREAD_ASSERT_MUTEX_OWNER( &ld->ld_req_mutex );
 801 #endif
 802
 803         Debug( LDAP_DEBUG_TRACE, "ldap_free_request (origid %d, msgid %d)\n",
 804                 lr->lr_origid, lr->lr_msgid, 0 );
 805
 806         /* free all referrals (child requests) */
 807         while ( lr->lr_child )
 808                 ldap_free_request( ld, lr->lr_child );
 809
 810         if ( lr->lr_parent != NULL ) {
 811                 --lr->lr_parent->lr_outrefcnt;
 812                 for ( ttmplr = &lr->lr_parent->lr_child;
 813                         *ttmplr && *ttmplr != lr;
 814                         ttmplr = &(*ttmplr)->lr_refnext );
 815                 if ( *ttmplr == lr )
 816                         *ttmplr = lr->lr_refnext;
 817         }
 818         ldap_free_request_int( ld, lr );
 819 }
 820
 821 /*
 822  * call first time with *cntp = -1
 823  * when returns *cntp == -1, no referrals are left
 824  *
 825  * NOTE: may replace *refsp, or shuffle the contents
 826  * of the original array.
 827  */
 828 static int ldap_int_nextref(
 829         LDAP                    *ld,
 830         char                    ***refsp,
 831         int                     *cntp,
 832         void                    *params )
 833 {
 834         assert( refsp != NULL );
 835         assert( *refsp != NULL );
 836         assert( cntp != NULL );
 837
 838         if ( *cntp < -1 ) {
 839                 *cntp = -1;
 840                 return -1;
 841         }
 842
 843         (*cntp)++;
 844
 845         if ( (*refsp)[ *cntp ] == NULL ) {
 846                 *cntp = -1;
 847         }
 848
 849         return 0;
 850 }
 851
 852 /*
 853  * Chase v3 referrals
 854  *
 855  * Parameters:
 856  *  (IN) ld = LDAP connection handle
 857  *  (IN) lr = LDAP Request structure
 858  *  (IN) refs = array of pointers to referral strings that we will chase
 859  *              The array will be free'd by this function when no longer needed
 860  *  (IN) sref != 0 if following search reference
 861  *  (OUT) errstrp = Place to return a string of referrals which could not be followed
 862  *  (OUT) hadrefp = 1 if sucessfully followed referral
 863  *
 864  * Return value - number of referrals followed
 865  */
 866 int
 867 ldap_chase_v3referrals( LDAP *ld, LDAPRequest *lr, char **refs, int sref, char **errstrp, int *hadrefp )
 868 {
 869         char            *unfollowed;
 870         int              unfollowedcnt = 0;
 871         LDAPRequest     *origreq;
 872         LDAPURLDesc     *srv = NULL;
 873         BerElement      *ber;
 874         char            **refarray = NULL;
 875         LDAPConn        *lc;
 876         int                      rc, count, i, j, id;
 877         LDAPreqinfo  rinfo;
 878
 879         ld->ld_errno = LDAP_SUCCESS;    /* optimistic */
 880         *hadrefp = 0;
 881
 882         Debug( LDAP_DEBUG_TRACE, "ldap_chase_v3referrals\n", 0, 0, 0 );
 883
 884         unfollowed = NULL;
 885         rc = count = 0;
 886
 887         /* If no referrals in array, return */
 888         if ( (refs == NULL) || ( (refs)[0] == NULL) ) {
 889                 rc = 0;
 890                 goto done;
 891         }
 892
 893         /* Check for hop limit exceeded */
 894         if ( lr->lr_parentcnt >= ld->ld_refhoplimit ) {
 895                 Debug( LDAP_DEBUG_ANY,
 896                     "more than %d referral hops (dropping)\n", ld->ld_refhoplimit, 0, 0 );
 897                 ld->ld_errno = LDAP_REFERRAL_LIMIT_EXCEEDED;
 898                 rc = -1;
 899                 goto done;
 900         }
 901
 902         /* find original request */
 903         for ( origreq = lr;
 904                 origreq->lr_parent != NULL;
 905                 origreq = origreq->lr_parent )
 906         {
 907                 /* empty */ ;
 908         }
 909
 910         refarray = refs;
 911         refs = NULL;
 912
 913         if ( ld->ld_nextref_proc == NULL ) {
 914                 ld->ld_nextref_proc = ldap_int_nextref;
 915         }
 916
 917         /* parse out & follow referrals */
 918         i = -1;
 919         for ( ld->ld_nextref_proc( ld, &refarray, &i, ld->ld_nextref_params );
 920                         i != -1;
 921                         ld->ld_nextref_proc( ld, &refarray, &i, ld->ld_nextref_params ) )
 922         {
 923
 924                 /* Parse the referral URL */
 925                 rc = ldap_url_parse_ext( refarray[i], &srv, LDAP_PVT_URL_PARSE_NOEMPTY_DN );
 926                 if ( rc != LDAP_URL_SUCCESS ) {
 927                         /* ldap_url_parse_ext() returns LDAP_URL_* errors
 928                          * which do not map on API errors */
 929                         ld->ld_errno = LDAP_PARAM_ERROR;
 930                         rc = -1;
 931                         goto done;
 932                 }
 933
 934                 if( srv->lud_crit_exts ) {
 935                         /* we do not support any extensions */
 936                         ld->ld_errno = LDAP_NOT_SUPPORTED;
 937                         rc = -1;
 938                         goto done;
 939                 }
 940
 941                 /* check connection for re-bind in progress */
 942                 if (( lc = find_connection( ld, srv, 1 )) != NULL ) {
 943                         /* See if we've already requested this DN with this conn */
 944                         LDAPRequest *lp;
 945                         int looped = 0;
 946                         int len = srv->lud_dn ? strlen( srv->lud_dn ) : 0;
 947                         for ( lp = origreq; lp; ) {
 948                                 if ( lp->lr_conn == lc
 949                                         && len == lp->lr_dn.bv_len
 950                                         && len
 951                                         && strncmp( srv->lud_dn, lp->lr_dn.bv_val, len ) == 0 )
 952                                 {
 953                                         looped = 1;
 954                                         break;
 955                                 }
 956                                 if ( lp == origreq ) {
 957                                         lp = lp->lr_child;
 958                                 } else {
 959                                         lp = lr->lr_refnext;
 960                                 }
 961                         }
 962                         if ( looped ) {
 963                                 ldap_free_urllist( srv );
 964                                 srv = NULL;
 965                                 ld->ld_errno = LDAP_CLIENT_LOOP;
 966                                 rc = -1;
 967                                 continue;
 968                         }
 969
 970                         if ( lc->lconn_rebind_inprogress ) {
 971                                 /* We are already chasing a referral or search reference and a
 972                                  * bind on that connection is in progress.  We must queue
 973                                  * referrals on that connection, so we don't get a request
 974                                  * going out before the bind operation completes. This happens
 975                                  * if two search references come in one behind the other
 976                                  * for the same server with different contexts.
 977                                  */
 978                                 Debug( LDAP_DEBUG_TRACE,
 979                                         "ldap_chase_v3referrals: queue referral \"%s\"\n",
 980                                         refarray[i], 0, 0);
 981                                 if( lc->lconn_rebind_queue == NULL ) {
 982                                         /* Create a referral list */
 983                                         lc->lconn_rebind_queue =
 984                                                 (char ***) LDAP_MALLOC( sizeof(void *) * 2);
 985
 986                                         if( lc->lconn_rebind_queue == NULL) {
 987                                                 ld->ld_errno = LDAP_NO_MEMORY;
 988                                                 rc = -1;
 989                                                 goto done;
 990                                         }
 991
 992                                         lc->lconn_rebind_queue[0] = refarray;
 993                                         lc->lconn_rebind_queue[1] = NULL;
 994                                         refarray = NULL;
 995
 996                                 } else {
 997                                         /* Count how many referral arrays we already have */
 998                                         for( j = 0; lc->lconn_rebind_queue[j] != NULL; j++) {
 999                                                 /* empty */;
1000                                         }
1001
1002                                         /* Add the new referral to the list */
1003                                         lc->lconn_rebind_queue = (char ***) LDAP_REALLOC(
1004                                                 lc->lconn_rebind_queue, sizeof(void *) * (j + 2));
1005
1006                                         if( lc->lconn_rebind_queue == NULL ) {
1007                                                 ld->ld_errno = LDAP_NO_MEMORY;
1008                                                 rc = -1;
1009                                                 goto done;
1010                                         }
1011                                         lc->lconn_rebind_queue[j] = refarray;
1012                                         lc->lconn_rebind_queue[j+1] = NULL;
1013                                         refarray = NULL;
1014                                 }
1015
1016                                 /* We have queued the referral/reference, now just return */
1017                                 rc = 0;
1018                                 *hadrefp = 1;
1019                                 count = 1; /* Pretend we already followed referral */
1020                                 goto done;
1021                         }
1022                 }
1023                 /* Re-encode the request with the new starting point of the search.
1024                  * Note: In the future we also need to replace the filter if one
1025                  * was provided with the search reference
1026                  */
1027
1028                 /* For references we don't want old dn if new dn empty */
1029                 if ( sref && srv->lud_dn == NULL ) {
1030                         srv->lud_dn = LDAP_STRDUP( "" );
1031                 }
1032
1033                 LDAP_NEXT_MSGID( ld, id );
1034                 ber = re_encode_request( ld, origreq->lr_ber, id,
1035                         sref, srv, &rinfo.ri_request );
1036
1037                 if( ber == NULL ) {
1038                         ld->ld_errno = LDAP_ENCODING_ERROR;
1039                         rc = -1;
1040                         goto done;
1041                 }
1042
1043                 Debug( LDAP_DEBUG_TRACE,
1044                         "ldap_chase_v3referral: msgid %d, url \"%s\"\n",
1045                         lr->lr_msgid, refarray[i], 0);
1046
1047                 /* Send the new request to the server - may require a bind */
1048                 rinfo.ri_msgid = origreq->lr_origid;
1049                 rinfo.ri_url = refarray[i];
1050 #ifdef LDAP_R_COMPILE
1051                 ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
1052 #endif
1053                 rc = ldap_send_server_request( ld, ber, id,
1054                         origreq, &srv, NULL, &rinfo );
1055 #ifdef LDAP_R_COMPILE
1056                 ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
1057 #endif
1058                 if ( rc < 0 ) {
1059                         /* Failure, try next referral in the list */
1060                         Debug( LDAP_DEBUG_ANY, "Unable to chase referral \"%s\" (%d: %s)\n",
1061                                 refarray[i], ld->ld_errno, ldap_err2string( ld->ld_errno ) );
1062                         unfollowedcnt += ldap_append_referral( ld, &unfollowed, refarray[i] );
1063                         ldap_free_urllist( srv );
1064                         srv = NULL;
1065                         ld->ld_errno = LDAP_REFERRAL;
1066                 } else {
1067                         /* Success, no need to try this referral list further */
1068                         rc = 0;
1069                         ++count;
1070                         *hadrefp = 1;
1071
1072                         /* check if there is a queue of referrals that came in during bind */
1073                         if ( lc == NULL) {
1074                                 lc = find_connection( ld, srv, 1 );
1075                                 if ( lc == NULL ) {
1076                                         ld->ld_errno = LDAP_OPERATIONS_ERROR;
1077                                         rc = -1;
1078                                         goto done;
1079                                 }
1080                         }
1081
1082                         if ( lc->lconn_rebind_queue != NULL ) {
1083                                 /* Release resources of previous list */
1084                                 LDAP_VFREE( refarray );
1085                                 refarray = NULL;
1086                                 ldap_free_urllist( srv );
1087                                 srv = NULL;
1088
1089                                 /* Pull entries off end of queue so list always null terminated */
1090                                 for( j = 0; lc->lconn_rebind_queue[j] != NULL; j++ )
1091                                         ;
1092                                 refarray = lc->lconn_rebind_queue[j - 1];
1093                                 lc->lconn_rebind_queue[j-1] = NULL;
1094                                 /* we pulled off last entry from queue, free queue */
1095                                 if ( j == 1 ) {
1096                                         LDAP_FREE( lc->lconn_rebind_queue );
1097                                         lc->lconn_rebind_queue = NULL;
1098                                 }
1099                                 /* restart the loop the with new referral list */
1100                                 i = -1;
1101                                 continue;
1102                         }
1103                         break; /* referral followed, break out of for loop */
1104                 }
1105         } /* end for loop */
1106 done:
1107         LDAP_VFREE( refarray );
1108         ldap_free_urllist( srv );
1109         LDAP_FREE( *errstrp );
1110
1111         if( rc == 0 ) {
1112                 *errstrp = NULL;
1113                 LDAP_FREE( unfollowed );
1114                 return count;
1115         } else {
1116                 *errstrp = unfollowed;
1117                 return rc;
1118         }
1119 }
1120
1121 /*
1122  * XXX merging of errors in this routine needs to be improved
1123  */
1124 int
1125 ldap_chase_referrals( LDAP *ld,
1126         LDAPRequest *lr,
1127         char **errstrp,
1128         int sref,
1129         int *hadrefp )
1130 {
1131         int             rc, count, id;
1132         unsigned        len;
1133         char            *p, *ref, *unfollowed;
1134         LDAPRequest     *origreq;
1135         LDAPURLDesc     *srv;
1136         BerElement      *ber;
1137         LDAPreqinfo  rinfo;
1138         LDAPConn        *lc;
1139
1140         Debug( LDAP_DEBUG_TRACE, "ldap_chase_referrals\n", 0, 0, 0 );
1141
1142         ld->ld_errno = LDAP_SUCCESS;    /* optimistic */
1143         *hadrefp = 0;
1144
1145         if ( *errstrp == NULL ) {
1146                 return( 0 );
1147         }
1148
1149         len = strlen( *errstrp );
1150         for ( p = *errstrp; len >= LDAP_REF_STR_LEN; ++p, --len ) {
1151                 if ( strncasecmp( p, LDAP_REF_STR, LDAP_REF_STR_LEN ) == 0 ) {
1152                         *p = '\0';
1153                         p += LDAP_REF_STR_LEN;
1154                         break;
1155                 }
1156         }
1157
1158         if ( len < LDAP_REF_STR_LEN ) {
1159                 return( 0 );
1160         }
1161
1162         if ( lr->lr_parentcnt >= ld->ld_refhoplimit ) {
1163                 Debug( LDAP_DEBUG_ANY,
1164                     "more than %d referral hops (dropping)\n",
1165                     ld->ld_refhoplimit, 0, 0 );
1166                     /* XXX report as error in ld->ld_errno? */
1167                     return( 0 );
1168         }
1169
1170         /* find original request */
1171         for ( origreq = lr; origreq->lr_parent != NULL;
1172              origreq = origreq->lr_parent ) {
1173                 /* empty */;
1174         }
1175
1176         unfollowed = NULL;
1177         rc = count = 0;
1178
1179         /* parse out & follow referrals */
1180         for ( ref = p; rc == 0 && ref != NULL; ref = p ) {
1181                 p = strchr( ref, '\n' );
1182                 if ( p != NULL ) {
1183                         *p++ = '\0';
1184                 }
1185
1186                 rc = ldap_url_parse_ext( ref, &srv, LDAP_PVT_URL_PARSE_NOEMPTY_DN );
1187                 if ( rc != LDAP_URL_SUCCESS ) {
1188                         Debug( LDAP_DEBUG_TRACE,
1189                                 "ignoring %s referral <%s>\n",
1190                                 ref, rc == LDAP_URL_ERR_BADSCHEME ? "unknown" : "incorrect", 0 );
1191                         rc = ldap_append_referral( ld, &unfollowed, ref );
1192                         *hadrefp = 1;
1193                         continue;
1194                 }
1195
1196                 Debug( LDAP_DEBUG_TRACE,
1197                     "chasing LDAP referral: <%s>\n", ref, 0, 0 );
1198
1199                 *hadrefp = 1;
1200
1201                 /* See if we've already been here */
1202                 if (( lc = find_connection( ld, srv, 1 )) != NULL ) {
1203                         LDAPRequest *lp;
1204                         int looped = 0;
1205                         int len = srv->lud_dn ? strlen( srv->lud_dn ) : 0;
1206                         for ( lp = lr; lp; lp = lp->lr_parent ) {
1207                                 if ( lp->lr_conn == lc
1208                                         && len == lp->lr_dn.bv_len )
1209                                 {
1210                                         if ( len && strncmp( srv->lud_dn, lp->lr_dn.bv_val, len ) )
1211                                                         continue;
1212                                         looped = 1;
1213                                         break;
1214                                 }
1215                         }
1216                         if ( looped ) {
1217                                 ldap_free_urllist(srv);
1218                                 ld->ld_errno = LDAP_CLIENT_LOOP;
1219                                 rc = -1;
1220                                 continue;
1221                         }
1222                 }
1223
1224                 LDAP_NEXT_MSGID( ld, id );
1225                 ber = re_encode_request( ld, origreq->lr_ber,
1226                     id, sref, srv, &rinfo.ri_request );
1227
1228                 if ( ber == NULL ) {
1229                         return -1 ;
1230                 }
1231
1232                 /* copy the complete referral for rebind process */
1233                 rinfo.ri_url = LDAP_STRDUP( ref );
1234
1235                 rinfo.ri_msgid = origreq->lr_origid;
1236
1237 #ifdef LDAP_R_COMPILE
1238                 ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
1239 #endif
1240                 rc = ldap_send_server_request( ld, ber, id,
1241                         lr, &srv, NULL, &rinfo );
1242 #ifdef LDAP_R_COMPILE
1243                 ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
1244 #endif
1245
1246                 LDAP_FREE( rinfo.ri_url );
1247
1248                 if( rc >= 0 ) {
1249                         ++count;
1250                 } else {
1251                         Debug( LDAP_DEBUG_ANY,
1252                                 "Unable to chase referral \"%s\" (%d: %s)\n",
1253                                 ref, ld->ld_errno, ldap_err2string( ld->ld_errno ) );
1254                         rc = ldap_append_referral( ld, &unfollowed, ref );
1255                 }
1256
1257                 ldap_free_urllist(srv);
1258         }
1259
1260         LDAP_FREE( *errstrp );
1261         *errstrp = unfollowed;
1262
1263         return(( rc == 0 ) ? count : rc );
1264 }
1265
1266
1267 int
1268 ldap_append_referral( LDAP *ld, char **referralsp, char *s )
1269 {
1270         int     first;
1271
1272         if ( *referralsp == NULL ) {
1273                 first = 1;
1274                 *referralsp = (char *)LDAP_MALLOC( strlen( s ) + LDAP_REF_STR_LEN
1275                     + 1 );
1276         } else {
1277                 first = 0;
1278                 *referralsp = (char *)LDAP_REALLOC( *referralsp,
1279                     strlen( *referralsp ) + strlen( s ) + 2 );
1280         }
1281
1282         if ( *referralsp == NULL ) {
1283                 ld->ld_errno = LDAP_NO_MEMORY;
1284                 return( -1 );
1285         }
1286
1287         if ( first ) {
1288                 strcpy( *referralsp, LDAP_REF_STR );
1289         } else {
1290                 strcat( *referralsp, "\n" );
1291         }
1292         strcat( *referralsp, s );
1293
1294         return( 0 );
1295 }
1296
1297
1298
1299 static BerElement *
1300 re_encode_request( LDAP *ld,
1301         BerElement *origber,
1302         ber_int_t msgid,
1303         int sref,
1304         LDAPURLDesc *srv,
1305         int *type )
1306 {
1307         /*
1308          * XXX this routine knows way too much about how the lber library works!
1309          */
1310         ber_int_t       along;
1311         ber_tag_t       tag;
1312         ber_tag_t       rtag;
1313         ber_int_t       ver;
1314         ber_int_t       scope;
1315         int             rc;
1316         BerElement      tmpber, *ber;
1317         struct berval           dn;
1318
1319         Debug( LDAP_DEBUG_TRACE,
1320             "re_encode_request: new msgid %ld, new dn <%s>\n",
1321             (long) msgid,
1322                 ( srv == NULL || srv->lud_dn == NULL) ? "NONE" : srv->lud_dn, 0 );
1323
1324         tmpber = *origber;
1325
1326         /*
1327          * all LDAP requests are sequences that start with a message id.
1328          * For all except delete, this is followed by a sequence that is
1329          * tagged with the operation code.  For delete, the provided DN
1330          * is not wrapped by a sequence.
1331          */
1332         rtag = ber_scanf( &tmpber, "{it", /*}*/ &along, &tag );
1333
1334         if ( rtag == LBER_ERROR ) {
1335                 ld->ld_errno = LDAP_DECODING_ERROR;
1336                 return( NULL );
1337         }
1338
1339         assert( tag != 0);
1340         if ( tag == LDAP_REQ_BIND ) {
1341                 /* bind requests have a version number before the DN & other stuff */
1342                 rtag = ber_scanf( &tmpber, "{im" /*}*/, &ver, &dn );
1343
1344         } else if ( tag == LDAP_REQ_DELETE ) {
1345                 /* delete requests don't have a DN wrapping sequence */
1346                 rtag = ber_scanf( &tmpber, "m", &dn );
1347
1348         } else if ( tag == LDAP_REQ_SEARCH ) {
1349                 /* search requests need to be re-scope-ed */
1350                 rtag = ber_scanf( &tmpber, "{me" /*"}"*/, &dn, &scope );
1351
1352                 if( srv->lud_scope != LDAP_SCOPE_DEFAULT ) {
1353                         /* use the scope provided in reference */
1354                         scope = srv->lud_scope;
1355
1356                 } else if ( sref ) {
1357                         /* use scope implied by previous operation
1358                          *   base -> base
1359                          *   one -> base
1360                          *   subtree -> subtree
1361                          *   subordinate -> subtree
1362                          */
1363                         switch( scope ) {
1364                         default:
1365                         case LDAP_SCOPE_BASE:
1366                         case LDAP_SCOPE_ONELEVEL:
1367                                 scope = LDAP_SCOPE_BASE;
1368                                 break;
1369                         case LDAP_SCOPE_SUBTREE:
1370                         case LDAP_SCOPE_SUBORDINATE:
1371                                 scope = LDAP_SCOPE_SUBTREE;
1372                                 break;
1373                         }
1374                 }
1375
1376         } else {
1377                 rtag = ber_scanf( &tmpber, "{m" /*}*/, &dn );
1378         }
1379
1380         if( rtag == LBER_ERROR ) {
1381                 ld->ld_errno = LDAP_DECODING_ERROR;
1382                 return NULL;
1383         }
1384
1385         /* restore character zero'd out by ber_scanf*/
1386         dn.bv_val[dn.bv_len] = tmpber.ber_tag;
1387
1388         if (( ber = ldap_alloc_ber_with_options( ld )) == NULL ) {
1389                 return NULL;
1390         }
1391
1392         if ( srv->lud_dn ) {
1393                 ber_str2bv( srv->lud_dn, 0, 0, &dn );
1394         }
1395
1396         if ( tag == LDAP_REQ_BIND ) {
1397                 rc = ber_printf( ber, "{it{iO" /*}}*/, msgid, tag, ver, &dn );
1398         } else if ( tag == LDAP_REQ_DELETE ) {
1399                 rc = ber_printf( ber, "{itON}", msgid, tag, &dn );
1400         } else if ( tag == LDAP_REQ_SEARCH ) {
1401                 rc = ber_printf( ber, "{it{Oe" /*}}*/, msgid, tag, &dn, scope );
1402         } else {
1403                 rc = ber_printf( ber, "{it{O" /*}}*/, msgid, tag, &dn );
1404         }
1405
1406         if ( rc == -1 ) {
1407                 ld->ld_errno = LDAP_ENCODING_ERROR;
1408                 ber_free( ber, 1 );
1409                 return NULL;
1410         }
1411
1412         if ( tag != LDAP_REQ_DELETE && (
1413                 ber_write(ber, tmpber.ber_ptr, ( tmpber.ber_end - tmpber.ber_ptr ), 0)
1414                 != ( tmpber.ber_end - tmpber.ber_ptr ) ||
1415             ber_printf( ber, /*{{*/ "N}N}" ) == -1 ) )
1416         {
1417                 ld->ld_errno = LDAP_ENCODING_ERROR;
1418                 ber_free( ber, 1 );
1419                 return NULL;
1420         }
1421
1422 #ifdef LDAP_DEBUG
1423         if ( ldap_debug & LDAP_DEBUG_PACKETS ) {
1424                 Debug( LDAP_DEBUG_ANY, "re_encode_request new request is:\n",
1425                     0, 0, 0 );
1426                 ber_log_dump( LDAP_DEBUG_BER, ldap_debug, ber, 0 );
1427         }
1428 #endif /* LDAP_DEBUG */
1429
1430         *type = tag;    /* return request type */
1431         return ber;
1432 }
1433
1434
1435 LDAPRequest *
1436 ldap_find_request_by_msgid( LDAP *ld, ber_int_t msgid )
1437 {
1438         LDAPRequest     *lr;
1439
1440 #ifdef LDAP_R_COMPILE
1441         ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
1442 #endif
1443         for ( lr = ld->ld_requests; lr != NULL; lr = lr->lr_next ) {
1444                 if ( lr->lr_status == LDAP_REQST_COMPLETED ) {
1445                         continue;       /* Skip completed requests */
1446                 }
1447                 if ( msgid == lr->lr_msgid ) {
1448                         lr->lr_refcnt++;
1449                         break;
1450                 }
1451         }
1452 #ifdef LDAP_R_COMPILE
1453         ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
1454 #endif
1455
1456         return( lr );
1457 }
1458
1459 void
1460 ldap_return_request( LDAP *ld, LDAPRequest *lrx, int freeit )
1461 {
1462         LDAPRequest     *lr;
1463
1464 #ifdef LDAP_R_COMPILE
1465         ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
1466 #endif
1467         for ( lr = ld->ld_requests; lr != NULL; lr = lr->lr_next ) {
1468                 if ( lr == lrx ) {
1469                         if ( lr->lr_refcnt > 0 ) {
1470                                 lr->lr_refcnt--;
1471
1472                         } else if ( lr->lr_refcnt < 0 ) {
1473                                 lr->lr_refcnt++;
1474                                 if ( lr->lr_refcnt == 0 ) {
1475                                         lr = NULL;
1476                                 }
1477                         }
1478                         break;
1479                 }
1480         }
1481         if ( lr == NULL ) {
1482                 ldap_free_request_int( ld, lrx );
1483
1484         } else if ( freeit ) {
1485                 ldap_free_request( ld, lrx );
1486         }
1487 #ifdef LDAP_R_COMPILE
1488         ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
1489 #endif
1490 }