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

   1 /*
   2  * Copyright 1998-1999 The OpenLDAP Foundation, All Rights Reserved.
   3  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
   4  */
   5 /*  Portions
   6  *  Copyright (c) 1990 Regents of the University of Michigan.
   7  *  All rights reserved.
   8  *
   9  *  result.c - wait for an ldap result
  10  */
  11
  12 #include "portable.h"
  13
  14 #include <stdio.h>
  15 #include <stdlib.h>
  16
  17 #include <ac/errno.h>
  18 #include <ac/socket.h>
  19 #include <ac/string.h>
  20 #include <ac/time.h>
  21 #include <ac/unistd.h>
  22
  23 #include "ldap-int.h"
  24
  25
  26 static int ldap_abandoned LDAP_P(( LDAP *ld, int msgid ));
  27 static int ldap_mark_abandoned LDAP_P(( LDAP *ld, int msgid ));
  28 static int wait4msg LDAP_P(( LDAP *ld, int msgid, int all, struct timeval *timeout,
  29         LDAPMessage **result ));
  30 static int try_read1msg LDAP_P(( LDAP *ld, int msgid, int all, Sockbuf *sb, LDAPConn *lc,
  31         LDAPMessage **result ));
  32 static unsigned long build_result_ber LDAP_P(( LDAP *ld, BerElement *ber, LDAPRequest *lr ));
  33 static void merge_error_info LDAP_P(( LDAP *ld, LDAPRequest *parentr, LDAPRequest *lr ));
  34
  35
  36 /*
  37  * ldap_result - wait for an ldap result response to a message from the
  38  * ldap server.  If msgid is -1, any message will be accepted, otherwise
  39  * ldap_result will wait for a response with msgid.  If all is 0 the
  40  * first message with id msgid will be accepted, otherwise, ldap_result
  41  * will wait for all responses with id msgid and then return a pointer to
  42  * the entire list of messages.  This is only useful for search responses,
  43  * which can be of two message types (zero or more entries, followed by an
  44  * ldap result).  The type of the first message received is returned.
  45  * When waiting, any messages that have been abandoned are discarded.
  46  *
  47  * Example:
  48  *      ldap_result( s, msgid, all, timeout, result )
  49  */
  50 int
  51 ldap_result( LDAP *ld, int msgid, int all, struct timeval *timeout,
  52         LDAPMessage **result )
  53 {
  54         LDAPMessage     *lm, *lastlm, *nextlm;
  55
  56         assert( ld != NULL );
  57         assert( result != NULL );
  58
  59         Debug( LDAP_DEBUG_TRACE, "ldap_result\n", 0, 0, 0 );
  60
  61         if( ld == NULL ) {
  62                 return -1;
  63         }
  64
  65         if( result == NULL ) {
  66                 ld->ld_errno = LDAP_PARAM_ERROR;
  67                 return -1;
  68         }
  69
  70         /*
  71          * First, look through the list of responses we have received on
  72          * this association and see if the response we're interested in
  73          * is there.  If it is, return it.  If not, call wait4msg() to
  74          * wait until it arrives or timeout occurs.
  75          */
  76
  77         *result = NULLMSG;
  78         lastlm = NULLMSG;
  79         for ( lm = ld->ld_responses; lm != NULLMSG; lm = nextlm ) {
  80                 nextlm = lm->lm_next;
  81
  82                 if ( ldap_abandoned( ld, lm->lm_msgid ) ) {
  83                         ldap_mark_abandoned( ld, lm->lm_msgid );
  84
  85                         if ( lastlm == NULLMSG ) {
  86                                 ld->ld_responses = lm->lm_next;
  87                         } else {
  88                                 lastlm->lm_next = nextlm;
  89                         }
  90
  91                         ldap_msgfree( lm );
  92
  93                         continue;
  94                 }
  95
  96                 if ( msgid == LDAP_RES_ANY || lm->lm_msgid == msgid ) {
  97                         LDAPMessage     *tmp;
  98
  99                         if ( all == 0
 100                             || (lm->lm_msgtype != LDAP_RES_SEARCH_RESULT
 101                             && lm->lm_msgtype != LDAP_RES_SEARCH_REFERENCE      /* LDAPv3 */
 102                             && lm->lm_msgtype != LDAP_RES_SEARCH_ENTRY) )
 103                                 break;
 104
 105                         for ( tmp = lm; tmp != NULLMSG; tmp = tmp->lm_chain ) {
 106                                 if ( tmp->lm_msgtype == LDAP_RES_SEARCH_RESULT )
 107                                         break;
 108                         }
 109
 110                         if ( tmp == NULLMSG ) {
 111                                 return( wait4msg( ld, msgid, all, timeout,
 112                                     result ) );
 113                         }
 114
 115                         break;
 116                 }
 117                 lastlm = lm;
 118         }
 119         if ( lm == NULLMSG ) {
 120                 return( wait4msg( ld, msgid, all, timeout, result ) );
 121         }
 122
 123         if ( lastlm == NULLMSG ) {
 124                 ld->ld_responses = (all == 0 && lm->lm_chain != NULLMSG
 125                     ? lm->lm_chain : lm->lm_next);
 126         } else {
 127                 lastlm->lm_next = (all == 0 && lm->lm_chain != NULLMSG
 128                     ? lm->lm_chain : lm->lm_next);
 129         }
 130         if ( all == 0 )
 131                 lm->lm_chain = NULLMSG;
 132         lm->lm_next = NULLMSG;
 133
 134         *result = lm;
 135         ld->ld_errno = LDAP_SUCCESS;
 136         return( lm->lm_msgtype );
 137 }
 138
 139 static int
 140 wait4msg( LDAP *ld, int msgid, int all, struct timeval *timeout,
 141         LDAPMessage **result )
 142 {
 143         int             rc;
 144         struct timeval  tv, *tvp;
 145         time_t          start_time = 0;
 146         time_t          tmp_time;
 147         LDAPConn        *lc, *nextlc;
 148
 149         assert( ld != NULL );
 150         assert( result != NULL );
 151
 152 #ifdef LDAP_DEBUG
 153         if ( timeout == NULL ) {
 154                 Debug( LDAP_DEBUG_TRACE, "wait4msg (infinite timeout)\n",
 155                     0, 0, 0 );
 156         } else {
 157                 Debug( LDAP_DEBUG_TRACE, "wait4msg (timeout %ld sec, %ld usec)\n",
 158                        (long) timeout->tv_sec, (long) timeout->tv_usec, 0 );
 159         }
 160 #endif /* LDAP_DEBUG */
 161
 162         if ( timeout == NULL ) {
 163                 tvp = NULL;
 164         } else {
 165                 tv = *timeout;
 166                 tvp = &tv;
 167                 start_time = time( NULL );
 168         }
 169
 170         rc = -2;
 171         while ( rc == -2 ) {
 172 #ifdef LDAP_DEBUG
 173                 if ( ldap_debug & LDAP_DEBUG_TRACE ) {
 174                         ldap_dump_connection( ld, ld->ld_conns, 1 );
 175                         ldap_dump_requests_and_responses( ld );
 176                 }
 177 #endif /* LDAP_DEBUG */
 178                 for ( lc = ld->ld_conns; lc != NULL; lc = lc->lconn_next ) {
 179                         if ( ber_pvt_sb_data_ready(lc->lconn_sb) ) {
 180                                 rc = try_read1msg( ld, msgid, all, lc->lconn_sb,
 181                                     lc, result );
 182                                 break;
 183                         }
 184                 }
 185
 186                 if ( lc == NULL ) {
 187                         rc = do_ldap_select( ld, tvp );
 188
 189
 190 #ifdef LDAP_DEBUG
 191                         if ( rc == -1 ) {
 192                             Debug( LDAP_DEBUG_TRACE,
 193                                     "do_ldap_select returned -1: errno %d\n",
 194                                     errno, 0, 0 );
 195                         }
 196 #endif
 197
 198                         if ( rc == 0 || ( rc == -1 && (
 199                                 ( LDAP_BOOL_GET(&ld->ld_options, LDAP_BOOL_RESTART)
 200                                         == LDAP_OPT_OFF )
 201                                 || errno != EINTR )))
 202                         {
 203                                 ld->ld_errno = (rc == -1 ? LDAP_SERVER_DOWN :
 204                                     LDAP_TIMEOUT);
 205                                 return( rc );
 206                         }
 207
 208                         if ( rc == -1 ) {
 209                                 rc = -2;        /* select interrupted: loop */
 210                         } else {
 211                                 rc = -2;
 212                                 for ( lc = ld->ld_conns; rc == -2 && lc != NULL;
 213                                     lc = nextlc ) {
 214                                         nextlc = lc->lconn_next;
 215                                         if ( lc->lconn_status ==
 216                                             LDAP_CONNST_CONNECTED &&
 217                                             ldap_is_read_ready( ld,
 218                                             lc->lconn_sb )) {
 219                                                 rc = try_read1msg( ld, msgid, all,
 220                                                     lc->lconn_sb, lc, result );
 221                                         }
 222                                 }
 223                         }
 224                 }
 225
 226                 if ( rc == -2 && tvp != NULL ) {
 227                         tmp_time = time( NULL );
 228                         if (( tv.tv_sec -=  ( tmp_time - start_time )) <= 0 ) {
 229                                 rc = 0; /* timed out */
 230                                 ld->ld_errno = LDAP_TIMEOUT;
 231                                 break;
 232                         }
 233
 234                         Debug( LDAP_DEBUG_TRACE, "wait4msg:  %ld secs to go\n",
 235                                (long) tv.tv_sec, 0, 0 );
 236                         start_time = tmp_time;
 237                 }
 238         }
 239
 240         return( rc );
 241 }
 242
 243
 244 static int
 245 try_read1msg( LDAP *ld, int msgid, int all, Sockbuf *sb,
 246     LDAPConn *lc, LDAPMessage **result )
 247 {
 248         BerElement      *ber;
 249         LDAPMessage     *new, *l, *prev, *tmp;
 250         long            id;
 251         unsigned long   tag, len;
 252         int             foundit = 0;
 253         LDAPRequest     *lr;
 254         BerElement      tmpber;
 255         int             rc, refer_cnt, hadref, simple_request;
 256         unsigned long   lderr;
 257
 258         assert( ld != NULL );
 259         assert( lc != NULL );
 260
 261         ber = &lc->lconn_ber;
 262
 263         Debug( LDAP_DEBUG_TRACE, "read1msg\n", 0, 0, 0 );
 264
 265 #if 0
 266         ber_init_w_nullc( &ber, 0 );
 267         ldap_set_ber_options( ld, &ber );
 268 #endif
 269
 270         /* get the next message */
 271         errno = 0;
 272         if ( (tag = ber_get_next( sb, &len, ber ))
 273             != LDAP_TAG_MESSAGE ) {
 274                 if ( tag == LBER_DEFAULT) {
 275 #ifdef LDAP_DEBUG
 276                         Debug( LDAP_DEBUG_CONNS,
 277                               "ber_get_next failed.\n", 0, 0, 0 );
 278 #endif
 279 #ifdef EWOULDBLOCK
 280                         if (errno==EWOULDBLOCK) return -2;
 281 #endif
 282 #ifdef EAGAIN
 283                         if (errno == EAGAIN) return -2;
 284 #endif
 285                         ld->ld_errno = LDAP_SERVER_DOWN;
 286                         return -1;
 287                 }
 288                 ld->ld_errno = LDAP_LOCAL_ERROR;
 289                 return -1;
 290         }
 291
 292         /* message id */
 293         if ( ber_get_int( ber, &id ) == LBER_ERROR ) {
 294                 ld->ld_errno = LDAP_DECODING_ERROR;
 295                 return( -1 );
 296         }
 297
 298         /* if it's been abandoned, toss it */
 299         if ( ldap_abandoned( ld, (int)id ) ) {
 300                 ber_clear( ber, 1 );    /* gack! */
 301                 return( -2 );   /* continue looking */
 302         }
 303
 304         if (( lr = ldap_find_request_by_msgid( ld, id )) == NULL ) {
 305                 Debug( LDAP_DEBUG_ANY,
 306                     "no request for response with msgid %ld (tossing)\n",
 307                     id, 0, 0 );
 308                 ber_clear( ber, 1 );    /* gack! */
 309                 return( -2 );   /* continue looking */
 310         }
 311         Debug( LDAP_DEBUG_TRACE, "ldap_read: %s msgid %ld, original id %d\n",
 312             ( tag == LDAP_RES_SEARCH_ENTRY ) ? "entry" :
 313                 ( tag == LDAP_RES_SEARCH_REFERENCE ) ? "reference" : "result",
 314                 id, lr->lr_origid );
 315         id = lr->lr_origid;
 316
 317         /* the message type */
 318         if ( (tag = ber_peek_tag( ber, &len )) == LBER_ERROR ) {
 319                 ld->ld_errno = LDAP_DECODING_ERROR;
 320                 return( -1 );
 321         }
 322
 323         refer_cnt = 0;
 324         hadref = simple_request = 0;
 325         rc = -2;        /* default is to keep looking (no response found) */
 326         lr->lr_res_msgtype = tag;
 327
 328         if ( tag != LDAP_RES_SEARCH_ENTRY ) {
 329                 if ( ld->ld_version >= LDAP_VERSION2 &&
 330                         ( lr->lr_parent != NULL ||
 331                         ( LDAP_BOOL_GET(&ld->ld_options, LDAP_BOOL_REFERRALS)
 332                                 != LDAP_OPT_OFF ) ) )
 333                 {
 334                         tmpber = *ber;  /* struct copy */
 335                         if ( ber_scanf( &tmpber, "{iaa}", &lderr,
 336                             &lr->lr_res_matched, &lr->lr_res_error )
 337                             != LBER_ERROR ) {
 338                                 if ( lderr != LDAP_SUCCESS ) {
 339                                         /* referrals are in error string */
 340                                         refer_cnt = ldap_chase_referrals( ld, lr,
 341                                             &lr->lr_res_error, &hadref );
 342                                 }
 343
 344                                 /* save errno, message, and matched string */
 345                                 if ( !hadref || lr->lr_res_error == NULL ) {
 346                                         lr->lr_res_errno = ( lderr ==
 347                                         LDAP_PARTIAL_RESULTS ) ? LDAP_SUCCESS
 348                                         : lderr;
 349                                 } else if ( ld->ld_errno != LDAP_SUCCESS ) {
 350                                         lr->lr_res_errno = ld->ld_errno;
 351                                 } else {
 352                                         lr->lr_res_errno = LDAP_PARTIAL_RESULTS;
 353                                 }
 354 Debug( LDAP_DEBUG_TRACE,
 355     "new result:  res_errno: %d, res_error: <%s>, res_matched: <%s>\n",
 356     lr->lr_res_errno, lr->lr_res_error ? lr->lr_res_error : "",
 357     lr->lr_res_matched ? lr->lr_res_matched : "" );
 358                         }
 359                 }
 360
 361                 Debug( LDAP_DEBUG_TRACE,
 362                     "read1msg:  %d new referrals\n", refer_cnt, 0, 0 );
 363
 364                 if ( refer_cnt != 0 ) { /* chasing referrals */
 365                         ber_clear( ber, 1 );    /* gack! */
 366                         if ( refer_cnt < 0 ) {
 367                                 return( -1 );   /* fatal error */
 368                         }
 369                         lr->lr_status = LDAP_REQST_CHASINGREFS;
 370                 } else {
 371                         if ( lr->lr_outrefcnt <= 0 && lr->lr_parent == NULL ) {
 372                                 /* request without any referrals */
 373                                 simple_request = ( hadref ? 0 : 1 );
 374                         } else {
 375                                 /* request with referrals or child request */
 376                                 ber_clear( ber, 1 );    /* gack! */
 377                         }
 378
 379                         while ( lr->lr_parent != NULL ) {
 380                                 merge_error_info( ld, lr->lr_parent, lr );
 381
 382                                 lr = lr->lr_parent;
 383                                 if ( --lr->lr_outrefcnt > 0 ) {
 384                                         break;  /* not completely done yet */
 385                                 }
 386                         }
 387
 388                         if ( lr->lr_outrefcnt <= 0 && lr->lr_parent == NULL ) {
 389                                 id = lr->lr_msgid;
 390                                 tag = lr->lr_res_msgtype;
 391                                 Debug( LDAP_DEBUG_ANY, "request %ld done\n",
 392                                     id, 0, 0 );
 393 Debug( LDAP_DEBUG_TRACE,
 394 "res_errno: %d, res_error: <%s>, res_matched: <%s>\n",
 395 lr->lr_res_errno, lr->lr_res_error ? lr->lr_res_error : "",
 396 lr->lr_res_matched ? lr->lr_res_matched : "" );
 397                                 if ( !simple_request ) {
 398                                         ber_clear( ber, 1 ); /* gack! */
 399                                         if ( build_result_ber( ld, ber, lr )
 400                                             == LBER_ERROR ) {
 401                                                 ld->ld_errno = LDAP_NO_MEMORY;
 402                                                 rc = -1; /* fatal error */
 403                                         }
 404                                 }
 405
 406                                 ldap_free_request( ld, lr );
 407                         }
 408
 409                         if ( lc != NULL ) {
 410                                 ldap_free_connection( ld, lc, 0, 1 );
 411                         }
 412                 }
 413         }
 414
 415         if ( ber->ber_buf == NULL ) {
 416                 return( rc );
 417         }
 418
 419         /* make a new ldap message */
 420         if ( (new = (LDAPMessage *) calloc( 1, sizeof(LDAPMessage) ))
 421             == NULL ) {
 422                 ld->ld_errno = LDAP_NO_MEMORY;
 423                 return( -1 );
 424         }
 425         new->lm_msgid = (int)id;
 426         new->lm_msgtype = tag;
 427         new->lm_ber = ber_dup( ber );
 428         ber_clear( ber, 0 ); /* don't kill buffer */
 429
 430 #ifndef LDAP_NOCACHE
 431                 if ( ld->ld_cache != NULL ) {
 432                         ldap_add_result_to_cache( ld, new );
 433                 }
 434 #endif /* LDAP_NOCACHE */
 435
 436         /* is this the one we're looking for? */
 437         if ( msgid == LDAP_RES_ANY || id == msgid ) {
 438                 if ( all == 0
 439                     || (new->lm_msgtype != LDAP_RES_SEARCH_RESULT
 440                     && new->lm_msgtype != LDAP_RES_SEARCH_ENTRY) ) {
 441                         *result = new;
 442                         ld->ld_errno = LDAP_SUCCESS;
 443                         return( tag );
 444                 } else if ( new->lm_msgtype == LDAP_RES_SEARCH_RESULT) {
 445                         foundit = 1;    /* return the chain later */
 446                 }
 447         }
 448
 449         /*
 450          * if not, we must add it to the list of responses.  if
 451          * the msgid is already there, it must be part of an existing
 452          * search response.
 453          */
 454
 455         prev = NULLMSG;
 456         for ( l = ld->ld_responses; l != NULLMSG; l = l->lm_next ) {
 457                 if ( l->lm_msgid == new->lm_msgid )
 458                         break;
 459                 prev = l;
 460         }
 461
 462         /* not part of an existing search response */
 463         if ( l == NULLMSG ) {
 464                 if ( foundit ) {
 465                         *result = new;
 466                         ld->ld_errno = LDAP_SUCCESS;
 467                         return( tag );
 468                 }
 469
 470                 new->lm_next = ld->ld_responses;
 471                 ld->ld_responses = new;
 472                 return( -2 );   /* continue looking */
 473         }
 474
 475         Debug( LDAP_DEBUG_TRACE, "adding response id %d type %d:\n",
 476             new->lm_msgid, new->lm_msgtype, 0 );
 477
 478         /* part of a search response - add to end of list of entries */
 479         for ( tmp = l; tmp->lm_chain != NULLMSG &&
 480             tmp->lm_chain->lm_msgtype == LDAP_RES_SEARCH_ENTRY;
 481             tmp = tmp->lm_chain )
 482                 ;       /* NULL */
 483         tmp->lm_chain = new;
 484
 485         /* return the whole chain if that's what we were looking for */
 486         if ( foundit ) {
 487                 if ( prev == NULLMSG )
 488                         ld->ld_responses = l->lm_next;
 489                 else
 490                         prev->lm_next = l->lm_next;
 491                 *result = l;
 492                 ld->ld_errno = LDAP_SUCCESS;
 493 #ifdef LDAP_WORLD_P16
 494                 /*
 495                  * XXX questionable fix; see text for [P16] on
 496                  * http://www.critical-angle.com/ldapworld/patch/
 497                  *
 498                  * inclusion of this patch causes searchs to hang on
 499                  * multiple platforms
 500                  */
 501                 return( l->lm_msgtype );
 502 #else   /* LDAP_WORLD_P16 */
 503                 return( tag );
 504 #endif  /* !LDAP_WORLD_P16 */
 505         }
 506
 507         return( -2 );   /* continue looking */
 508 }
 509
 510
 511 static unsigned long
 512 build_result_ber( LDAP *ld, BerElement *ber, LDAPRequest *lr )
 513 {
 514         unsigned long   len;
 515         long            along;
 516
 517         ber_init_w_nullc( ber, 0 );
 518         ldap_set_ber_options( ld, ber );
 519         if ( ber_printf( ber, "{it{ess}}", lr->lr_msgid,
 520             (unsigned long) lr->lr_res_msgtype, lr->lr_res_errno,
 521             lr->lr_res_matched ? lr->lr_res_matched : "",
 522             lr->lr_res_error ? lr->lr_res_error : "" ) == -1 ) {
 523                 return( LBER_ERROR );
 524         }
 525
 526         ber_reset( ber, 1 );
 527         if ( ber_skip_tag( ber, &len ) == LBER_ERROR ) {
 528                 return( LBER_ERROR );
 529         }
 530
 531         if ( ber_get_int( ber, &along ) == LBER_ERROR ) {
 532                 return( LBER_ERROR );
 533         }
 534
 535         return( ber_peek_tag( ber, &len ));
 536 }
 537
 538
 539 static void
 540 merge_error_info( LDAP *ld, LDAPRequest *parentr, LDAPRequest *lr )
 541 {
 542 /*
 543  * Merge error information in "lr" with "parentr" error code and string.
 544  */
 545         if ( lr->lr_res_errno == LDAP_PARTIAL_RESULTS ) {
 546                 parentr->lr_res_errno = lr->lr_res_errno;
 547                 if ( lr->lr_res_error != NULL ) {
 548                         (void)ldap_append_referral( ld, &parentr->lr_res_error,
 549                             lr->lr_res_error );
 550                 }
 551         } else if ( lr->lr_res_errno != LDAP_SUCCESS &&
 552             parentr->lr_res_errno == LDAP_SUCCESS ) {
 553                 parentr->lr_res_errno = lr->lr_res_errno;
 554                 if ( parentr->lr_res_error != NULL ) {
 555                         free( parentr->lr_res_error );
 556                 }
 557                 parentr->lr_res_error = lr->lr_res_error;
 558                 lr->lr_res_error = NULL;
 559                 if ( LDAP_NAME_ERROR( lr->lr_res_errno )) {
 560                         if ( parentr->lr_res_matched != NULL ) {
 561                                 free( parentr->lr_res_matched );
 562                         }
 563                         parentr->lr_res_matched = lr->lr_res_matched;
 564                         lr->lr_res_matched = NULL;
 565                 }
 566         }
 567
 568         Debug( LDAP_DEBUG_TRACE, "merged parent (id %d) error info:  ",
 569             parentr->lr_msgid, 0, 0 );
 570         Debug( LDAP_DEBUG_TRACE, "result errno %d, error <%s>, matched <%s>\n",
 571             parentr->lr_res_errno, parentr->lr_res_error ?
 572             parentr->lr_res_error : "", parentr->lr_res_matched ?
 573             parentr->lr_res_matched : "" );
 574 }
 575
 576
 577
 578 int
 579 ldap_msgtype( LDAPMessage *lm )
 580 {
 581         assert( lm != NULL );
 582         return ( lm == NULL ) ? lm->lm_msgtype : -1;
 583 }
 584
 585
 586 int
 587 ldap_msgid( LDAPMessage *lm )
 588 {
 589         assert( lm != NULL );
 590
 591         return ( lm == NULL ) ? lm->lm_msgid : -1;
 592 }
 593
 594
 595 int
 596 ldap_msgfree( LDAPMessage *lm )
 597 {
 598         LDAPMessage     *next;
 599         int             type = 0;
 600
 601         assert( lm != NULL );
 602
 603         Debug( LDAP_DEBUG_TRACE, "ldap_msgfree\n", 0, 0, 0 );
 604
 605         for ( ; lm != NULLMSG; lm = next ) {
 606                 next = lm->lm_chain;
 607                 type = lm->lm_msgtype;
 608                 ber_free( lm->lm_ber, 1 );
 609                 free( (char *) lm );
 610         }
 611
 612         return( type );
 613 }
 614
 615 /*
 616  * ldap_msgdelete - delete a message.  It returns:
 617  *      0       if the entire message was deleted
 618  *      -1      if the message was not found, or only part of it was found
 619  */
 620 int
 621 ldap_msgdelete( LDAP *ld, int msgid )
 622 {
 623         LDAPMessage     *lm, *prev;
 624
 625         assert( ld != NULL );
 626
 627         Debug( LDAP_DEBUG_TRACE, "ldap_msgdelete\n", 0, 0, 0 );
 628
 629         prev = NULLMSG;
 630         for ( lm = ld->ld_responses; lm != NULLMSG; lm = lm->lm_next ) {
 631                 if ( lm->lm_msgid == msgid )
 632                         break;
 633                 prev = lm;
 634         }
 635
 636         if ( lm == NULLMSG )
 637                 return( -1 );
 638
 639         if ( prev == NULLMSG )
 640                 ld->ld_responses = lm->lm_next;
 641         else
 642                 prev->lm_next = lm->lm_next;
 643
 644         if ( ldap_msgfree( lm ) == LDAP_RES_SEARCH_ENTRY )
 645                 return( -1 );
 646
 647         return( 0 );
 648 }
 649
 650
 651 /*
 652  * return 1 if message msgid is waiting to be abandoned, 0 otherwise
 653  */
 654 static int
 655 ldap_abandoned( LDAP *ld, int msgid )
 656 {
 657         int     i;
 658
 659         if ( ld->ld_abandoned == NULL )
 660                 return( 0 );
 661
 662         for ( i = 0; ld->ld_abandoned[i] != -1; i++ )
 663                 if ( ld->ld_abandoned[i] == msgid )
 664                         return( 1 );
 665
 666         return( 0 );
 667 }
 668
 669
 670 static int
 671 ldap_mark_abandoned( LDAP *ld, int msgid )
 672 {
 673         int     i;
 674
 675         if ( ld->ld_abandoned == NULL )
 676                 return( -1 );
 677
 678         for ( i = 0; ld->ld_abandoned[i] != -1; i++ )
 679                 if ( ld->ld_abandoned[i] == msgid )
 680                         break;
 681
 682         if ( ld->ld_abandoned[i] == -1 )
 683                 return( -1 );
 684
 685         for ( ; ld->ld_abandoned[i] != -1; i++ ) {
 686                 ld->ld_abandoned[i] = ld->ld_abandoned[i + 1];
 687         }
 688
 689         return( 0 );
 690 }
 691
 692
 693 #ifdef LDAP_CONNECTIONLESS
 694 int
 695 cldap_getmsg( LDAP *ld, struct timeval *timeout, BerElement *ber )
 696 {
 697         int             rc;
 698         unsigned long   tag, len;
 699
 700         if ( ! ber_pvt_sb_data_ready(&ld->ld_sb) ) {
 701                 rc = ldap_select1( ld, timeout );
 702                 if ( rc == -1 || rc == 0 ) {
 703                         ld->ld_errno = (rc == -1 ? LDAP_SERVER_DOWN :
 704                             LDAP_TIMEOUT);
 705                         return( rc );
 706                 }
 707         }
 708
 709         /* get the next message */
 710         if ( (tag = ber_get_next( &ld->ld_sb, &len, ber ))
 711             != LDAP_TAG_MESSAGE ) {
 712                 ld->ld_errno = (tag == LBER_DEFAULT ? LDAP_SERVER_DOWN :
 713                     LDAP_LOCAL_ERROR);
 714                 return( -1 );
 715         }
 716
 717         return( tag );
 718 }
 719 #endif /* LDAP_CONNECTIONLESS */