git.sur5r.net Git - openldap/blob - servers/slapd/acl.c

   1 /* acl.c - routines to parse and check acl's */
   2 /* $OpenLDAP$ */
   3 /*
   4  * Copyright 1998-2002 The OpenLDAP Foundation, All Rights Reserved.
   5  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
   6  */
   7
   8 #include "portable.h"
   9
  10 #include <stdio.h>
  11
  12 #include <ac/regex.h>
  13 #include <ac/socket.h>
  14 #include <ac/string.h>
  15
  16 #include "slap.h"
  17 #include "sets.h"
  18 #include "lber_pvt.h"
  19
  20
  21 /*
  22  * speed up compares
  23  */
  24 static struct berval
  25         aci_bv_entry            = { sizeof("entry") - 1,        "entry" },
  26         aci_bv_br_entry         = { sizeof("[entry]") - 1,      "[entry]" },
  27         aci_bv_br_all           = { sizeof("[all]") - 1,        "[all]" },
  28         aci_bv_access_id        = { sizeof("access-id") - 1,    "access-id" },
  29         aci_bv_anonymous        = { sizeof("anonymous") - 1,    "anonymous" },
  30         aci_bv_users            = { sizeof("users") - 1,        "users" },
  31         aci_bv_self             = { sizeof("self") - 1,         "self" },
  32         aci_bv_dnattr           = { sizeof("dnattr") - 1,       "dnattr" },
  33         aci_bv_group            = { sizeof("group") - 1,        "group" },
  34         aci_bv_role             = { sizeof("role") - 1,         "role" },
  35         aci_bv_set              = { sizeof("set") - 1,          "set" },
  36         aci_bv_set_ref          = { sizeof("set-ref") - 1,      "set-ref"},
  37         aci_bv_grant            = { sizeof("grant") - 1,        "grant" },
  38         aci_bv_deny             = { sizeof("deny") - 1,         "deny" };
  39
  40 static AccessControl * acl_get(
  41         AccessControl *ac, int *count,
  42         Backend *be, Operation *op,
  43         Entry *e,
  44         AttributeDescription *desc,
  45         int nmatches, regmatch_t *matches );
  46
  47 static slap_control_t acl_mask(
  48         AccessControl *ac, slap_mask_t *mask,
  49         Backend *be, Connection *conn, Operation *op,
  50         Entry *e,
  51         AttributeDescription *desc,
  52         struct berval *val,
  53         regmatch_t *matches,
  54         int count,
  55         AccessControlState *state );
  56
  57 #ifdef SLAPD_ACI_ENABLED
  58 static int aci_mask(
  59         Backend *be,
  60     Connection *conn,
  61         Operation *op,
  62         Entry *e,
  63         AttributeDescription *desc,
  64         struct berval *val,
  65         struct berval *aci,
  66         regmatch_t *matches,
  67         slap_access_t *grant,
  68         slap_access_t *deny );
  69 #endif
  70
  71 static int      regex_matches(
  72         struct berval *pat, char *str, char *buf, regmatch_t *matches);
  73 static void     string_expand(
  74         struct berval *newbuf, struct berval *pattern,
  75         char *match, regmatch_t *matches);
  76
  77 typedef struct AciSetCookie {
  78         Backend *be;
  79         Entry *e;
  80         Connection *conn;
  81         Operation *op;
  82 } AciSetCookie;
  83
  84 SLAP_SET_GATHER aci_set_gather;
  85 static int aci_match_set ( struct berval *subj, Backend *be,
  86     Entry *e, Connection *conn, Operation *op, int setref );
  87
  88 /*
  89  * access_allowed - check whether op->o_ndn is allowed the requested access
  90  * to entry e, attribute attr, value val.  if val is null, access to
  91  * the whole attribute is assumed (all values).
  92  *
  93  * This routine loops through all access controls and calls
  94  * acl_mask() on each applicable access control.
  95  * The loop exits when a definitive answer is reached or
  96  * or no more controls remain.
  97  *
  98  * returns:
  99  *              0       access denied
 100  *              1       access granted
 101  */
 102
 103 int
 104 access_allowed(
 105     Backend             *be,
 106     Connection          *conn,
 107     Operation           *op,
 108     Entry               *e,
 109         AttributeDescription    *desc,
 110     struct berval       *val,
 111     slap_access_t       access,
 112         AccessControlState *state )
 113 {
 114         int                             ret = 1;
 115         int                             count;
 116         AccessControl   *a;
 117 #ifdef LDAP_DEBUG
 118         char accessmaskbuf[ACCESSMASK_MAXLEN];
 119 #endif
 120         slap_mask_t mask;
 121         slap_control_t control;
 122         const char *attr;
 123         regmatch_t matches[MAXREMATCHES];
 124
 125         assert( e != NULL );
 126         assert( desc != NULL );
 127         assert( access > ACL_NONE );
 128
 129         attr = desc->ad_cname.bv_val;
 130
 131         assert( attr != NULL );
 132
 133         if( state && state->as_recorded ) {
 134                 if( state->as_recorded & ACL_STATE_RECORDED_NV &&
 135                         val == NULL )
 136                 {
 137                         return state->as_result;
 138
 139                 } else if ( state->as_recorded & ACL_STATE_RECORDED_VD &&
 140                         val != NULL && state->as_vd_acl == NULL )
 141                 {
 142                         return state->as_result;
 143                 }
 144         }
 145
 146 #ifdef NEW_LOGGING
 147         LDAP_LOG(( "acl", LDAP_LEVEL_ENTRY,
 148                 "access_allowed: conn %d %s access to \"%s\" \"%s\" requested\n",
 149                 conn ? conn->c_connid : -1, access2str( access ), e->e_dn, attr ));
 150 #else
 151         Debug( LDAP_DEBUG_ACL,
 152                 "=> access_allowed: %s access to \"%s\" \"%s\" requested\n",
 153             access2str( access ), e->e_dn, attr );
 154 #endif
 155
 156         if ( op == NULL ) {
 157                 /* no-op call */
 158                 goto done;
 159         }
 160
 161         if ( be == NULL ) be = &backends[0];
 162         assert( be != NULL );
 163
 164         /* grant database root access */
 165         if ( be != NULL && be_isroot( be, &op->o_ndn ) ) {
 166 #ifdef NEW_LOGGING
 167                 LDAP_LOG(( "acl", LDAP_LEVEL_INFO,
 168                        "access_allowed: conn %d root access granted\n",
 169                        conn->c_connid));
 170 #else
 171                 Debug( LDAP_DEBUG_ACL,
 172                     "<= root access granted\n",
 173                         0, 0, 0 );
 174 #endif
 175                 goto done;
 176         }
 177
 178         /*
 179          * no-user-modification operational attributes are ignored
 180          * by ACL_WRITE checking as any found here are not provided
 181          * by the user
 182          */
 183         if ( access >= ACL_WRITE && is_at_no_user_mod( desc->ad_type )
 184                 && desc != slap_schema.si_ad_entry
 185                 && desc != slap_schema.si_ad_children )
 186         {
 187 #ifdef NEW_LOGGING
 188                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 189                        "access_allowed: conn %d NoUserMod Operational attribute: %s access granted\n",
 190                        conn->c_connid, attr ));
 191 #else
 192                 Debug( LDAP_DEBUG_ACL, "NoUserMod Operational attribute:"
 193                         " %s access granted\n",
 194                         attr, 0, 0 );
 195 #endif
 196                 goto done;
 197         }
 198
 199         /* use backend default access if no backend acls */
 200         if( be != NULL && be->be_acl == NULL ) {
 201 #ifdef NEW_LOGGING
 202                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 203                        "access_allowed: conn %d backend default %s access %s to \"%s\"\n",
 204                        conn->c_connid, access2str( access ),
 205                        be->be_dfltaccess >= access ? "granted" : "denied", op->o_dn.bv_val ));
 206 #else
 207                 Debug( LDAP_DEBUG_ACL,
 208                         "=> access_allowed: backend default %s access %s to \"%s\"\n",
 209                         access2str( access ),
 210                         be->be_dfltaccess >= access ? "granted" : "denied", op->o_dn.bv_val );
 211 #endif
 212                 ret = be->be_dfltaccess >= access;
 213                 goto done;
 214
 215 #ifdef notdef
 216         /* be is always non-NULL */
 217         /* use global default access if no global acls */
 218         } else if ( be == NULL && global_acl == NULL ) {
 219 #ifdef NEW_LOGGING
 220                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 221                        "access_allowed: conn %d global default %s access %s to \"%s\"\n",
 222                        conn->c_connid, access2str( access ),
 223                        global_default_access >= access ? "granted" : "denied", op->o_dn.bv_val ));
 224 #else
 225                 Debug( LDAP_DEBUG_ACL,
 226                         "=> access_allowed: global default %s access %s to \"%s\"\n",
 227                         access2str( access ),
 228                         global_default_access >= access ? "granted" : "denied", op->o_dn.bv_val );
 229 #endif
 230                 ret = global_default_access >= access;
 231                 goto done;
 232 #endif
 233         }
 234
 235         ret = 0;
 236         control = ACL_BREAK;
 237
 238         if( state && ( state->as_recorded & ACL_STATE_RECORDED_VD )) {
 239                 assert( state->as_vd_acl != NULL );
 240
 241                 a = state->as_vd_acl;
 242                 mask = state->as_vd_acl_mask;
 243                 count = state->as_vd_acl_count;
 244                 AC_MEMCPY( matches, state->as_vd_acl_matches,
 245                         sizeof(matches) );
 246                 goto vd_access;
 247
 248         } else {
 249                 a = NULL;
 250                 ACL_INIT(mask);
 251                 count = 0;
 252                 memset(matches, '\0', sizeof(matches));
 253         }
 254
 255         while((a = acl_get( a, &count, be, op, e, desc,
 256                 MAXREMATCHES, matches )) != NULL)
 257         {
 258                 int i;
 259
 260                 for (i = 0; i < MAXREMATCHES && matches[i].rm_so > 0; i++) {
 261 #ifdef NEW_LOGGING
 262                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 263                             "access_allowed: conn %d match[%d]:  %d %d ",
 264                             conn->c_connid, i,
 265                                 (int)matches[i].rm_so, (int)matches[i].rm_eo ));
 266 #else
 267                         Debug( LDAP_DEBUG_ACL, "=> match[%d]: %d %d ", i,
 268                             (int)matches[i].rm_so, (int)matches[i].rm_eo );
 269 #endif
 270                         if( matches[i].rm_so <= matches[0].rm_eo ) {
 271                                 int n;
 272                                 for ( n = matches[i].rm_so; n < matches[i].rm_eo; n++) {
 273                                         Debug( LDAP_DEBUG_ACL, "%c", e->e_ndn[n], 0, 0 );
 274                                 }
 275                         }
 276 #ifdef NEW_LOGGING
 277                         LDAP_LOG(( "acl", LDAP_LEVEL_ARGS, "\n" ));
 278 #else
 279                         Debug( LDAP_DEBUG_ARGS, "\n", 0, 0, 0 );
 280 #endif
 281                 }
 282
 283 vd_access:
 284                 control = acl_mask( a, &mask, be, conn, op,
 285                         e, desc, val, matches, count, state );
 286
 287                 if ( control != ACL_BREAK ) {
 288                         break;
 289                 }
 290
 291                 memset(matches, '\0', sizeof(matches));
 292         }
 293
 294         if ( ACL_IS_INVALID( mask ) ) {
 295 #ifdef NEW_LOGGING
 296                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 297                     "access_allowed: conn %d     \"%s\" (%s) invalid!\n",
 298                     conn->c_connid, e->e_dn, attr ));
 299 #else
 300                 Debug( LDAP_DEBUG_ACL,
 301                         "=> access_allowed: \"%s\" (%s) invalid!\n",
 302                         e->e_dn, attr, 0 );
 303 #endif
 304                 ACL_INIT(mask);
 305
 306         } else if ( control == ACL_BREAK ) {
 307 #ifdef NEW_LOGGING
 308                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 309                        "access_allowed: conn %d  no more rules\n", conn->c_connid ));
 310 #else
 311                 Debug( LDAP_DEBUG_ACL,
 312                         "=> access_allowed: no more rules\n", 0, 0, 0);
 313 #endif
 314
 315                 goto done;
 316         }
 317
 318 #ifdef NEW_LOGGING
 319         LDAP_LOG(( "acl", LDAP_LEVEL_ENTRY,
 320                 "access_allowed: conn %d  %s access %s by %s\n",
 321                 conn->c_connid,
 322                 access2str( access ),
 323                 ACL_GRANT( mask, access ) ? "granted" : "denied",
 324                 accessmask2str( mask, accessmaskbuf ) ));
 325 #else
 326         Debug( LDAP_DEBUG_ACL,
 327                 "=> access_allowed: %s access %s by %s\n",
 328                 access2str( access ),
 329                 ACL_GRANT(mask, access) ? "granted" : "denied",
 330                 accessmask2str( mask, accessmaskbuf ) );
 331 #endif
 332
 333         ret = ACL_GRANT(mask, access);
 334
 335 done:
 336         if( state != NULL ) {
 337                 state->as_recorded |= ACL_STATE_RECORDED;
 338                 state->as_result = ret;
 339         }
 340         return ret;
 341 }
 342
 343 /*
 344  * acl_get - return the acl applicable to entry e, attribute
 345  * attr.  the acl returned is suitable for use in subsequent calls to
 346  * acl_access_allowed().
 347  */
 348
 349 static AccessControl *
 350 acl_get(
 351         AccessControl *a,
 352         int                     *count,
 353     Backend             *be,
 354     Operation   *op,
 355     Entry               *e,
 356         AttributeDescription *desc,
 357     int                 nmatch,
 358     regmatch_t  *matches )
 359 {
 360         const char *attr;
 361         int dnlen, patlen;
 362
 363         assert( e != NULL );
 364         assert( count != NULL );
 365         assert( desc != NULL );
 366
 367         attr = desc->ad_cname.bv_val;
 368
 369         assert( attr != NULL );
 370
 371         if( a == NULL ) {
 372                 if( be == NULL ) {
 373                         a = global_acl;
 374                 } else {
 375                         a = be->be_acl;
 376                 }
 377
 378                 assert( a != NULL );
 379
 380         } else {
 381                 a = a->acl_next;
 382         }
 383
 384         dnlen = e->e_nname.bv_len;
 385
 386         for ( ; a != NULL; a = a->acl_next ) {
 387                 (*count) ++;
 388
 389                 if (a->acl_dn_pat.bv_len != 0) {
 390                         if ( a->acl_dn_style == ACL_STYLE_REGEX ) {
 391 #ifdef NEW_LOGGING
 392                                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 393                                            "acl_get: dnpat [%d] %s nsub: %d\n",
 394                                            *count, a->acl_dn_pat.bv_val, (int) a->acl_dn_re.re_nsub ));
 395 #else
 396                                 Debug( LDAP_DEBUG_ACL, "=> dnpat: [%d] %s nsub: %d\n",
 397                                         *count, a->acl_dn_pat.bv_val, (int) a->acl_dn_re.re_nsub );
 398 #endif
 399                                 if (regexec(&a->acl_dn_re, e->e_ndn, nmatch, matches, 0))
 400                                         continue;
 401
 402                         } else {
 403 #ifdef NEW_LOGGING
 404                                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 405                                            "acl_get: dn [%d] %s\n",
 406                                            *count, a->acl_dn_pat.bv_val ));
 407 #else
 408                                 Debug( LDAP_DEBUG_ACL, "=> dn: [%d] %s\n",
 409                                         *count, a->acl_dn_pat.bv_val, 0 );
 410 #endif
 411                                 patlen = a->acl_dn_pat.bv_len;
 412                                 if ( dnlen < patlen )
 413                                         continue;
 414
 415                                 if ( a->acl_dn_style == ACL_STYLE_BASE ) {
 416                                         /* base dn -- entire object DN must match */
 417                                         if ( dnlen != patlen )
 418                                                 continue;
 419
 420                                 } else if ( a->acl_dn_style == ACL_STYLE_ONE ) {
 421                                         int rdnlen = -1;
 422
 423                                         if ( dnlen <= patlen )
 424                                                 continue;
 425
 426                                         if ( !DN_SEPARATOR( e->e_ndn[dnlen - patlen - 1] ) )
 427                                                 continue;
 428
 429                                         rdnlen = dn_rdnlen( NULL, &e->e_nname );
 430                                         if ( rdnlen != dnlen - patlen - 1 )
 431                                                 continue;
 432
 433                                 } else if ( a->acl_dn_style == ACL_STYLE_SUBTREE ) {
 434                                         if ( dnlen > patlen && !DN_SEPARATOR( e->e_ndn[dnlen - patlen - 1] ) )
 435                                                 continue;
 436
 437                                 } else if ( a->acl_dn_style == ACL_STYLE_CHILDREN ) {
 438                                         if ( dnlen <= patlen )
 439                                                 continue;
 440                                         if ( !DN_SEPARATOR( e->e_ndn[dnlen - patlen - 1] ) )
 441                                                 continue;
 442                                 }
 443
 444                                 if ( strcmp( a->acl_dn_pat.bv_val, e->e_ndn + dnlen - patlen ) != 0 )
 445                                         continue;
 446                         }
 447
 448 #ifdef NEW_LOGGING
 449                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 450                                    "acl_get: [%d] matched\n",
 451                                    *count ));
 452 #else
 453                         Debug( LDAP_DEBUG_ACL, "=> acl_get: [%d] matched\n",
 454                                 *count, 0, 0 );
 455 #endif
 456                 }
 457
 458                 if ( a->acl_filter != NULL ) {
 459                         ber_int_t rc = test_filter( NULL, NULL, NULL, e, a->acl_filter );
 460                         if ( rc != LDAP_COMPARE_TRUE ) {
 461                                 continue;
 462                         }
 463                 }
 464
 465 #ifdef NEW_LOGGING
 466                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 467                            "acl_get: [%d] check attr %s\n",
 468                            *count, attr ));
 469 #else
 470                 Debug( LDAP_DEBUG_ACL, "=> acl_get: [%d] check attr %s\n",
 471                        *count, attr, 0);
 472 #endif
 473                 if ( attr == NULL || a->acl_attrs == NULL ||
 474                         ad_inlist( desc, a->acl_attrs ) )
 475                 {
 476 #ifdef NEW_LOGGING
 477                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 478                                    "acl_get:  [%d] acl %s attr: %s\n",
 479                                    *count, e->e_dn, attr ));
 480 #else
 481                         Debug( LDAP_DEBUG_ACL,
 482                                 "<= acl_get: [%d] acl %s attr: %s\n",
 483                                 *count, e->e_dn, attr );
 484 #endif
 485                         return a;
 486                 }
 487                 matches[0].rm_so = matches[0].rm_eo = -1;
 488         }
 489
 490 #ifdef NEW_LOGGING
 491         LDAP_LOG(( "acl", LDAP_LEVEL_ENTRY,
 492                    "acl_get: done.\n" ));
 493 #else
 494         Debug( LDAP_DEBUG_ACL, "<= acl_get: done.\n", 0, 0, 0 );
 495 #endif
 496         return( NULL );
 497 }
 498
 499 /*
 500  * Record value-dependent access control state
 501  */
 502 #define ACL_RECORD_VALUE_STATE do { \
 503                 if( state && !( state->as_recorded & ACL_STATE_RECORDED_VD )) { \
 504                         state->as_recorded |= ACL_STATE_RECORDED_VD; \
 505                         state->as_vd_acl = a; \
 506                         AC_MEMCPY( state->as_vd_acl_matches, matches, \
 507                                 sizeof( state->as_vd_acl_matches )) ; \
 508                         state->as_vd_acl_count = count; \
 509                         state->as_vd_access = b; \
 510                         state->as_vd_access_count = i; \
 511                 } \
 512         } while( 0 )
 513
 514 /*
 515  * acl_mask - modifies mask based upon the given acl and the
 516  * requested access to entry e, attribute attr, value val.  if val
 517  * is null, access to the whole attribute is assumed (all values).
 518  *
 519  * returns      0       access NOT allowed
 520  *              1       access allowed
 521  */
 522
 523 static slap_control_t
 524 acl_mask(
 525     AccessControl       *a,
 526         slap_mask_t *mask,
 527     Backend             *be,
 528     Connection  *conn,
 529     Operation   *op,
 530     Entry               *e,
 531         AttributeDescription *desc,
 532     struct berval       *val,
 533         regmatch_t      *matches,
 534         int     count,
 535         AccessControlState *state )
 536 {
 537         int             i, odnlen, patlen;
 538         int             vd_recorded = 0;
 539         Access  *b;
 540 #ifdef LDAP_DEBUG
 541         char accessmaskbuf[ACCESSMASK_MAXLEN];
 542 #endif
 543         const char *attr;
 544
 545         assert( a != NULL );
 546         assert( mask != NULL );
 547         assert( desc != NULL );
 548
 549         attr = desc->ad_cname.bv_val;
 550
 551         assert( attr != NULL );
 552
 553 #ifdef NEW_LOGGING
 554         LDAP_LOG(( "acl", LDAP_LEVEL_ENTRY,
 555                    "acl_mask: conn %d  access to entry \"%s\", attr \"%s\" requested\n",
 556                    conn->c_connid, e->e_dn, attr ));
 557
 558         LDAP_LOG(( "acl", LDAP_LEVEL_ARGS,
 559                    " to %s by \"%s\", (%s) \n",
 560                    val ? "value" : "all values",
 561                    op->o_ndn.bv_val ? op->o_ndn.bv_val : "",
 562                    accessmask2str( *mask, accessmaskbuf ) ));
 563 #else
 564         Debug( LDAP_DEBUG_ACL,
 565                 "=> acl_mask: access to entry \"%s\", attr \"%s\" requested\n",
 566                 e->e_dn, attr, 0 );
 567
 568         Debug( LDAP_DEBUG_ACL,
 569                 "=> acl_mask: to %s by \"%s\", (%s) \n",
 570                 val ? "value" : "all values",
 571                 op->o_ndn.bv_val ?  op->o_ndn.bv_val : "",
 572                 accessmask2str( *mask, accessmaskbuf ) );
 573 #endif
 574
 575         if( state && ( state->as_recorded & ACL_STATE_RECORDED_VD )
 576                 && state->as_vd_acl == a )
 577         {
 578                 b = state->as_vd_access;
 579                 i = state->as_vd_access_count;
 580
 581         } else {
 582                 b = a->acl_access;
 583                 i = 1;
 584         }
 585
 586         for ( ; b != NULL; b = b->a_next, i++ ) {
 587                 slap_mask_t oldmask, modmask;
 588
 589                 ACL_INVALIDATE( modmask );
 590
 591                 /* AND <who> clauses */
 592                 if ( b->a_dn_pat.bv_len != 0 ) {
 593 #ifdef NEW_LOGGING
 594                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 595                                    "acl_mask: conn %d  check a_dn_pat: %s\n",
 596                                    conn->c_connid, b->a_dn_pat.bv_val ));
 597 #else
 598                         Debug( LDAP_DEBUG_ACL, "<= check a_dn_pat: %s\n",
 599                                 b->a_dn_pat.bv_val, 0, 0);
 600 #endif
 601                         /*
 602                          * if access applies to the entry itself, and the
 603                          * user is bound as somebody in the same namespace as
 604                          * the entry, OR the given dn matches the dn pattern
 605                          */
 606                         if ( ber_bvcmp( &b->a_dn_pat, &aci_bv_anonymous ) == 0 ) {
 607                                 if ( op->o_ndn.bv_len != 0 ) {
 608                                         continue;
 609                                 }
 610
 611                         } else if ( ber_bvcmp( &b->a_dn_pat, &aci_bv_users ) == 0 ) {
 612                                 if ( op->o_ndn.bv_len == 0 ) {
 613                                         continue;
 614                                 }
 615
 616                         } else if ( ber_bvcmp( &b->a_dn_pat, &aci_bv_self ) == 0 ) {
 617                                 if ( op->o_ndn.bv_len == 0 ) {
 618                                         continue;
 619                                 }
 620
 621                                 if ( e->e_dn == NULL || !dn_match( &e->e_nname, &op->o_ndn ) ) {
 622                                         continue;
 623                                 }
 624
 625                         } else if ( b->a_dn_style == ACL_STYLE_REGEX ) {
 626                                 if ( ber_bvccmp( &b->a_dn_pat, '*' ) == 0 ) {
 627                                         int ret = regex_matches( &b->a_dn_pat,
 628                                                 op->o_ndn.bv_val, e->e_ndn, matches );
 629
 630                                         if( ret == 0 ) {
 631                                                 continue;
 632                                         }
 633                                 }
 634
 635                         } else {
 636                                 if ( e->e_dn == NULL )
 637                                         continue;
 638
 639                                 patlen = b->a_dn_pat.bv_len;
 640                                 odnlen = op->o_ndn.bv_len;
 641                                 if ( odnlen < patlen )
 642                                         continue;
 643
 644                                 if ( b->a_dn_style == ACL_STYLE_BASE ) {
 645                                         /* base dn -- entire object DN must match */
 646                                         if ( odnlen != patlen )
 647                                                 continue;
 648
 649                                 } else if ( b->a_dn_style == ACL_STYLE_ONE ) {
 650                                         int rdnlen = -1;
 651
 652                                         if ( odnlen <= patlen )
 653                                                 continue;
 654
 655                                         if ( !DN_SEPARATOR( op->o_ndn.bv_val[odnlen - patlen - 1] ) )
 656                                                 continue;
 657
 658                                         rdnlen = dn_rdnlen( NULL, &op->o_ndn );
 659                                         if ( rdnlen != odnlen - patlen - 1 )
 660                                                 continue;
 661
 662                                 } else if ( b->a_dn_style == ACL_STYLE_SUBTREE ) {
 663                                         if ( odnlen > patlen && !DN_SEPARATOR( op->o_ndn.bv_val[odnlen - patlen - 1] ) )
 664                                                 continue;
 665
 666                                 } else if ( b->a_dn_style == ACL_STYLE_CHILDREN ) {
 667                                         if ( odnlen <= patlen )
 668                                                 continue;
 669                                         if ( !DN_SEPARATOR( op->o_ndn.bv_val[odnlen - patlen - 1] ) )
 670                                                 continue;
 671                                 }
 672
 673                                 if ( strcmp( b->a_dn_pat.bv_val, op->o_ndn.bv_val + odnlen - patlen ) != 0 )
 674                                         continue;
 675                         }
 676                 }
 677
 678                 if ( b->a_sockurl_pat.bv_len ) {
 679 #ifdef NEW_LOGGING
 680                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 681                                    "acl_mask: conn %d  check a_sockurl_pat: %s\n",
 682                                    conn->c_connid, b->a_sockurl_pat.bv_val ));
 683 #else
 684                         Debug( LDAP_DEBUG_ACL, "<= check a_sockurl_pat: %s\n",
 685                                 b->a_sockurl_pat.bv_val, 0, 0 );
 686 #endif
 687
 688                         if ( ber_bvccmp( &b->a_sockurl_pat, '*' ) != 0) {
 689                                 if ( b->a_sockurl_style == ACL_STYLE_REGEX) {
 690                                         if (!regex_matches( &b->a_sockurl_pat, conn->c_listener_url.bv_val,
 691                                                         e->e_ndn, matches ) )
 692                                         {
 693                                                 continue;
 694                                         }
 695                                 } else {
 696                                         if ( ber_bvstrcasecmp( &b->a_sockurl_pat, &conn->c_listener_url ) != 0 )
 697                                                 continue;
 698                                 }
 699                         }
 700                 }
 701
 702                 if ( b->a_domain_pat.bv_len ) {
 703 #ifdef NEW_LOGGING
 704                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 705                                    "acl_mask: conn %d  check a_domain_pat: %s\n",
 706                                    conn->c_connid, b->a_domain_pat.bv_val ));
 707 #else
 708                         Debug( LDAP_DEBUG_ACL, "<= check a_domain_pat: %s\n",
 709                                 b->a_domain_pat.bv_val, 0, 0 );
 710 #endif
 711                         if ( ber_bvccmp( &b->a_domain_pat, '*' ) != 0) {
 712                                 if ( b->a_domain_style == ACL_STYLE_REGEX) {
 713                                         if (!regex_matches( &b->a_domain_pat, conn->c_peer_domain.bv_val,
 714                                                         e->e_ndn, matches ) )
 715                                         {
 716                                                 continue;
 717                                         }
 718                                 } else {
 719                                         if ( ber_bvstrcasecmp( &b->a_domain_pat, &conn->c_peer_domain ) != 0 )
 720                                                 continue;
 721                                 }
 722                         }
 723                 }
 724
 725                 if ( b->a_peername_pat.bv_len ) {
 726 #ifdef NEW_LOGGING
 727                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 728                                    "acl_mask: conn %d  check a_perrname_path: %s\n",
 729                                    conn->c_connid, b->a_peername_pat.bv_val ));
 730 #else
 731                         Debug( LDAP_DEBUG_ACL, "<= check a_peername_path: %s\n",
 732                                 b->a_peername_pat.bv_val, 0, 0 );
 733 #endif
 734                         if ( ber_bvccmp( &b->a_peername_pat, '*' ) != 0) {
 735                                 if ( b->a_peername_style == ACL_STYLE_REGEX) {
 736                                         if (!regex_matches( &b->a_peername_pat, conn->c_peer_name.bv_val,
 737                                                         e->e_ndn, matches ) )
 738                                         {
 739                                                 continue;
 740                                         }
 741                                 } else {
 742                                         if ( ber_bvstrcasecmp( &b->a_peername_pat, &conn->c_peer_name ) != 0 )
 743                                                 continue;
 744                                 }
 745                         }
 746                 }
 747
 748                 if ( b->a_sockname_pat.bv_len ) {
 749 #ifdef NEW_LOGGING
 750                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 751                                    "acl_mask: conn %d  check a_sockname_path: %s\n",
 752                                    conn->c_connid, b->a_sockname_pat.bv_val ));
 753 #else
 754                         Debug( LDAP_DEBUG_ACL, "<= check a_sockname_path: %s\n",
 755                                 b->a_sockname_pat.bv_val, 0, 0 );
 756 #endif
 757                         if ( ber_bvccmp( &b->a_sockname_pat, '*' ) != 0) {
 758                                 if ( b->a_sockname_style == ACL_STYLE_REGEX) {
 759                                         if (!regex_matches( &b->a_sockname_pat, conn->c_sock_name.bv_val,
 760                                                         e->e_ndn, matches ) )
 761                                         {
 762                                                 continue;
 763                                         }
 764                                 } else {
 765                                         if ( ber_bvstrcasecmp( &b->a_sockname_pat, &conn->c_sock_name ) != 0 )
 766                                                 continue;
 767                                 }
 768                         }
 769                 }
 770
 771                 if ( b->a_dn_at != NULL && op->o_ndn.bv_len != 0 ) {
 772                         Attribute       *at;
 773                         struct berval   bv;
 774                         int rc, match = 0;
 775                         const char *text;
 776                         const char *attr = b->a_dn_at->ad_cname.bv_val;
 777
 778                         assert( attr != NULL );
 779
 780 #ifdef NEW_LOGGING
 781                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 782                                    "acl_mask: conn %d  check a_dn_pat: %s\n",
 783                                    conn->c_connid, attr ));
 784 #else
 785                         Debug( LDAP_DEBUG_ACL, "<= check a_dn_at: %s\n",
 786                                 attr, 0, 0);
 787 #endif
 788                         bv = op->o_ndn;
 789
 790                         /* see if asker is listed in dnattr */
 791                         for( at = attrs_find( e->e_attrs, b->a_dn_at );
 792                                 at != NULL;
 793                                 at = attrs_find( at->a_next, b->a_dn_at ) )
 794                         {
 795                                 if( value_find( b->a_dn_at, at->a_vals, &bv ) == 0 ) {
 796                                         /* found it */
 797                                         match = 1;
 798                                         break;
 799                                 }
 800                         }
 801
 802                         if( match ) {
 803                                 /* have a dnattr match. if this is a self clause then
 804                                  * the target must also match the op dn.
 805                                  */
 806                                 if ( b->a_dn_self ) {
 807                                         /* check if the target is an attribute. */
 808                                         if ( val == NULL )
 809                                                 continue;
 810                                         /* target is attribute, check if the attribute value
 811                                          * is the op dn.
 812                                          */
 813                                         rc = value_match( &match, b->a_dn_at,
 814                                                 b->a_dn_at->ad_type->sat_equality, 0,
 815                                                 val, &bv, &text );
 816                                         /* on match error or no match, fail the ACL clause */
 817                                         if (rc != LDAP_SUCCESS || match != 0 )
 818                                                 continue;
 819                                 }
 820                         } else {
 821                                 /* no dnattr match, check if this is a self clause */
 822                                 if ( ! b->a_dn_self )
 823                                         continue;
 824
 825                                 ACL_RECORD_VALUE_STATE;
 826
 827                                 /* this is a self clause, check if the target is an
 828                                  * attribute.
 829                                  */
 830                                 if ( val == NULL )
 831                                         continue;
 832
 833                                 /* target is attribute, check if the attribute value
 834                                  * is the op dn.
 835                                  */
 836                                 rc = value_match( &match, b->a_dn_at,
 837                                         b->a_dn_at->ad_type->sat_equality, 0,
 838                                         val, &bv, &text );
 839
 840                                 /* on match error or no match, fail the ACL clause */
 841                                 if (rc != LDAP_SUCCESS || match != 0 )
 842                                         continue;
 843                         }
 844                 }
 845
 846                 if ( b->a_group_pat.bv_len && op->o_ndn.bv_len ) {
 847                         char buf[1024];
 848                         struct berval bv;
 849                         struct berval ndn = { 0, NULL };
 850                         int rc;
 851
 852                         bv.bv_len = sizeof(buf) - 1;
 853                         bv.bv_val = buf;
 854
 855                         /* b->a_group is an unexpanded entry name, expanded it should be an
 856                          * entry with objectclass group* and we test to see if odn is one of
 857                          * the values in the attribute group
 858                          */
 859                         /* see if asker is listed in dnattr */
 860                         if ( b->a_group_style == ACL_STYLE_REGEX ) {
 861                                 string_expand(&bv, &b->a_group_pat, e->e_ndn, matches);
 862                                 if ( dnNormalize2(NULL, &bv, &ndn) != LDAP_SUCCESS ) {
 863                                         /* did not expand to a valid dn */
 864                                         continue;
 865                                 }
 866                                 bv = ndn;
 867                         } else {
 868                                 bv = b->a_group_pat;
 869                         }
 870
 871                         rc = backend_group(be, conn, op, e, &bv, &op->o_ndn,
 872                                 b->a_group_oc, b->a_group_at);
 873                         if ( ndn.bv_val )
 874                                 free( ndn.bv_val );
 875                         if ( rc != 0 ) {
 876                                 continue;
 877                         }
 878                 }
 879
 880                 if ( b->a_set_pat.bv_len != 0 ) {
 881                         if (aci_match_set( &b->a_set_pat, be, e, conn, op, 0 ) == 0) {
 882                                 continue;
 883                         }
 884                 }
 885
 886                 if ( b->a_authz.sai_ssf ) {
 887 #ifdef NEW_LOGGING
 888                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 889                                    "acl_mask: conn %d  check a_authz.sai_ssf: ACL %u > OP %u\n",
 890                                    conn->c_connid, b->a_authz.sai_ssf, op->o_ssf ));
 891 #else
 892                         Debug( LDAP_DEBUG_ACL, "<= check a_authz.sai_ssf: ACL %u > OP %u\n",
 893                                 b->a_authz.sai_ssf, op->o_ssf, 0 );
 894 #endif
 895                         if ( b->a_authz.sai_ssf >  op->o_ssf ) {
 896                                 continue;
 897                         }
 898                 }
 899
 900                 if ( b->a_authz.sai_transport_ssf ) {
 901 #ifdef NEW_LOGGING
 902                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 903                                    "acl_mask: conn %d  check a_authz.sai_transport_ssf: ACL %u > OP %u\n",
 904                                    conn->c_connid, b->a_authz.sai_transport_ssf, op->o_transport_ssf ));
 905 #else
 906                         Debug( LDAP_DEBUG_ACL,
 907                                 "<= check a_authz.sai_transport_ssf: ACL %u > OP %u\n",
 908                                 b->a_authz.sai_transport_ssf, op->o_transport_ssf, 0 );
 909 #endif
 910                         if ( b->a_authz.sai_transport_ssf >  op->o_transport_ssf ) {
 911                                 continue;
 912                         }
 913                 }
 914
 915                 if ( b->a_authz.sai_tls_ssf ) {
 916 #ifdef NEW_LOGGING
 917                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 918                                    "acl_mask: conn %d  check a_authz.sai_tls_ssf: ACL %u > OP %u\n",
 919                                    conn->c_connid, b->a_authz.sai_tls_ssf, op->o_tls_ssf ));
 920 #else
 921                         Debug( LDAP_DEBUG_ACL,
 922                                 "<= check a_authz.sai_tls_ssf: ACL %u > OP %u\n",
 923                                 b->a_authz.sai_tls_ssf, op->o_tls_ssf, 0 );
 924 #endif
 925                         if ( b->a_authz.sai_tls_ssf >  op->o_tls_ssf ) {
 926                                 continue;
 927                         }
 928                 }
 929
 930                 if ( b->a_authz.sai_sasl_ssf ) {
 931 #ifdef NEW_LOGGING
 932                         LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
 933                                    "acl_mask: conn %d check a_authz.sai_sasl_ssf: ACL %u > OP %u\n",
 934                                    conn->c_connid, b->a_authz.sai_sasl_ssf, op->o_sasl_ssf ));
 935 #else
 936                         Debug( LDAP_DEBUG_ACL,
 937                                 "<= check a_authz.sai_sasl_ssf: ACL %u > OP %u\n",
 938                                 b->a_authz.sai_sasl_ssf, op->o_sasl_ssf, 0 );
 939 #endif
 940                         if ( b->a_authz.sai_sasl_ssf >  op->o_sasl_ssf ) {
 941                                 continue;
 942                         }
 943                 }
 944
 945 #ifdef SLAPD_ACI_ENABLED
 946                 if ( b->a_aci_at != NULL ) {
 947                         Attribute       *at;
 948                         slap_access_t grant, deny, tgrant, tdeny;
 949
 950                         /* this case works different from the others above.
 951                          * since aci's themselves give permissions, we need
 952                          * to first check b->a_access_mask, the ACL's access level.
 953                          */
 954
 955                         if ( e->e_nname.bv_len == 0 ) {
 956                                 /* no ACIs in the root DSE */
 957                                 continue;
 958                         }
 959
 960                         /* first check if the right being requested
 961                          * is allowed by the ACL clause.
 962                          */
 963                         if ( ! ACL_GRANT( b->a_access_mask, *mask ) ) {
 964                                 continue;
 965                         }
 966
 967                         /* get the aci attribute */
 968                         at = attr_find( e->e_attrs, b->a_aci_at );
 969                         if ( at == NULL ) {
 970                                 continue;
 971                         }
 972
 973                         ACL_RECORD_VALUE_STATE;
 974
 975                         /* start out with nothing granted, nothing denied */
 976                         ACL_INIT(tgrant);
 977                         ACL_INIT(tdeny);
 978
 979                         /* the aci is an multi-valued attribute.  The
 980                          * rights are determined by OR'ing the individual
 981                          * rights given by the acis.
 982                          */
 983                         for ( i = 0; at->a_vals[i].bv_val != NULL; i++ ) {
 984                                 if (aci_mask( be, conn, op,
 985                                         e, desc, val, &at->a_vals[i],
 986                                         matches, &grant, &deny ) != 0)
 987                                 {
 988                                         tgrant |= grant;
 989                                         tdeny |= deny;
 990                                 }
 991                         }
 992
 993                         /* remove anything that the ACL clause does not allow */
 994                         tgrant &= b->a_access_mask & ACL_PRIV_MASK;
 995                         tdeny &= ACL_PRIV_MASK;
 996
 997                         /* see if we have anything to contribute */
 998                         if( ACL_IS_INVALID(tgrant) && ACL_IS_INVALID(tdeny) ) {
 999                                 continue;
1000                         }
1001
1002                         /* this could be improved by changing acl_mask so that it can deal with
1003                          * by clauses that return grant/deny pairs.  Right now, it does either
1004                          * additive or subtractive rights, but not both at the same time.  So,
1005                          * we need to combine the grant/deny pair into a single rights mask in
1006                          * a smart way:  if either grant or deny is "empty", then we use the
1007                          * opposite as is, otherwise we remove any denied rights from the grant
1008                          * rights mask and construct an additive mask.
1009                          */
1010                         if (ACL_IS_INVALID(tdeny)) {
1011                                 modmask = tgrant | ACL_PRIV_ADDITIVE;
1012
1013                         } else if (ACL_IS_INVALID(tgrant)) {
1014                                 modmask = tdeny | ACL_PRIV_SUBSTRACTIVE;
1015
1016                         } else {
1017                                 modmask = (tgrant & ~tdeny) | ACL_PRIV_ADDITIVE;
1018                         }
1019
1020                 } else
1021 #endif
1022                 {
1023                         modmask = b->a_access_mask;
1024                 }
1025
1026 #ifdef NEW_LOGGING
1027                 LDAP_LOG(( "acl", LDAP_LEVEL_RESULTS,
1028                            "acl_mask: conn %d  [%d] applying %s (%s)\n",
1029                            conn->c_connid, i, accessmask2str( modmask, accessmaskbuf),
1030                            b->a_type == ACL_CONTINUE ? "continue" : b->a_type == ACL_BREAK
1031                            ? "break" : "stop" ));
1032 #else
1033                 Debug( LDAP_DEBUG_ACL,
1034                         "<= acl_mask: [%d] applying %s (%s)\n",
1035                         i, accessmask2str( modmask, accessmaskbuf ),
1036                         b->a_type == ACL_CONTINUE
1037                                 ? "continue"
1038                                 : b->a_type == ACL_BREAK
1039                                         ? "break"
1040                                         : "stop" );
1041 #endif
1042                 /* save old mask */
1043                 oldmask = *mask;
1044
1045                 if( ACL_IS_ADDITIVE(modmask) ) {
1046                         /* add privs */
1047                         ACL_PRIV_SET( *mask, modmask );
1048
1049                         /* cleanup */
1050                         ACL_PRIV_CLR( *mask, ~ACL_PRIV_MASK );
1051
1052                 } else if( ACL_IS_SUBTRACTIVE(modmask) ) {
1053                         /* substract privs */
1054                         ACL_PRIV_CLR( *mask, modmask );
1055
1056                         /* cleanup */
1057                         ACL_PRIV_CLR( *mask, ~ACL_PRIV_MASK );
1058
1059                 } else {
1060                         /* assign privs */
1061                         *mask = modmask;
1062                 }
1063
1064 #ifdef NEW_LOGGING
1065                 LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL1,
1066                            "acl_mask: conn %d  [%d] mask: %s\n",
1067                            conn->c_connid, i, accessmask2str( *mask, accessmaskbuf) ));
1068 #else
1069                 Debug( LDAP_DEBUG_ACL,
1070                         "<= acl_mask: [%d] mask: %s\n",
1071                         i, accessmask2str(*mask, accessmaskbuf), 0 );
1072 #endif
1073
1074                 if( b->a_type == ACL_CONTINUE ) {
1075                         continue;
1076
1077                 } else if ( b->a_type == ACL_BREAK ) {
1078                         return ACL_BREAK;
1079
1080                 } else {
1081                         return ACL_STOP;
1082                 }
1083         }
1084
1085         /* implicit "by * none" clause */
1086         ACL_INIT(*mask);
1087
1088 #ifdef NEW_LOGGING
1089         LDAP_LOG(( "acl", LDAP_LEVEL_RESULTS,
1090                    "acl_mask: conn %d  no more <who> clauses, returning %d (stop)\n",
1091                    conn->c_connid, accessmask2str( *mask, accessmaskbuf) ));
1092 #else
1093         Debug( LDAP_DEBUG_ACL,
1094                 "<= acl_mask: no more <who> clauses, returning %s (stop)\n",
1095                 accessmask2str(*mask, accessmaskbuf), 0, 0 );
1096 #endif
1097         return ACL_STOP;
1098 }
1099
1100 /*
1101  * acl_check_modlist - check access control on the given entry to see if
1102  * it allows the given modifications by the user associated with op.
1103  * returns      1       if mods allowed ok
1104  *                      0       mods not allowed
1105  */
1106
1107 int
1108 acl_check_modlist(
1109     Backend     *be,
1110     Connection  *conn,
1111     Operation   *op,
1112     Entry       *e,
1113     Modifications       *mlist
1114 )
1115 {
1116         struct berval *bv;
1117
1118         assert( be != NULL );
1119
1120         /* short circuit root database access */
1121         if ( be_isroot( be, &op->o_ndn ) ) {
1122 #ifdef NEW_LOGGING
1123                 LDAP_LOG(( "acl", LDAP_LEVEL_DETAIL1,
1124                            "acl_check_modlist: conn %d  access granted to root user\n",
1125                            conn->c_connid ));
1126 #else
1127                 Debug( LDAP_DEBUG_ACL,
1128                         "<= acl_access_allowed: granted to database root\n",
1129                     0, 0, 0 );
1130 #endif
1131                 return 1;
1132         }
1133
1134         /* use backend default access if no backend acls */
1135         if( be != NULL && be->be_acl == NULL ) {
1136 #ifdef NEW_LOGGING
1137                 LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL1,
1138                            "acl_check_modlist: conn %d  backend default %s access %s to \"%s\"\n",
1139                            conn->c_connid, access2str( ACL_WRITE ),
1140                            be->be_dfltaccess >= ACL_WRITE ? "granted" : "denied", op->o_dn.bv_val ));
1141 #else
1142                 Debug( LDAP_DEBUG_ACL,
1143                         "=> access_allowed: backend default %s access %s to \"%s\"\n",
1144                         access2str( ACL_WRITE ),
1145                         be->be_dfltaccess >= ACL_WRITE ? "granted" : "denied", op->o_dn.bv_val );
1146 #endif
1147                 return be->be_dfltaccess >= ACL_WRITE;
1148
1149 #ifdef notdef
1150         /* be is always non-NULL */
1151         /* use global default access if no global acls */
1152         } else if ( be == NULL && global_acl == NULL ) {
1153 #ifdef NEW_LOGGING
1154                 LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL1,
1155                            "acl_check_modlist: conn %d  global default %s access %s to \"%s\"\n",
1156                            conn->c_connid, access2str( ACL_WRITE ),
1157                            global_default_access >= ACL_WRITE ? "granted" : "denied", op->o_dn ));
1158 #else
1159                 Debug( LDAP_DEBUG_ACL,
1160                         "=> access_allowed: global default %s access %s to \"%s\"\n",
1161                         access2str( ACL_WRITE ),
1162                         global_default_access >= ACL_WRITE ? "granted" : "denied", op->o_dn );
1163 #endif
1164                 return global_default_access >= ACL_WRITE;
1165 #endif
1166         }
1167
1168         for ( ; mlist != NULL; mlist = mlist->sml_next ) {
1169                 static AccessControlState state_init = ACL_STATE_INIT;
1170                 AccessControlState state;
1171
1172                 /*
1173                  * no-user-modification operational attributes are ignored
1174                  * by ACL_WRITE checking as any found here are not provided
1175                  * by the user
1176                  */
1177                 if ( is_at_no_user_mod( mlist->sml_desc->ad_type ) ) {
1178 #ifdef NEW_LOGGING
1179                         LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL1,
1180                                    "acl_check_modlist: conn %d  no-user-mod %s: modify access granted\n",
1181                                    conn->c_connid, mlist->sml_desc->ad_cname.bv_val ));
1182 #else
1183                         Debug( LDAP_DEBUG_ACL, "acl: no-user-mod %s:"
1184                                 " modify access granted\n",
1185                                 mlist->sml_desc->ad_cname.bv_val, 0, 0 );
1186 #endif
1187                         continue;
1188                 }
1189
1190                 state = state_init;
1191
1192                 switch ( mlist->sml_op ) {
1193                 case LDAP_MOD_REPLACE:
1194                         /*
1195                          * We must check both permission to delete the whole
1196                          * attribute and permission to add the specific attributes.
1197                          * This prevents abuse from selfwriters.
1198                          */
1199                         if ( ! access_allowed( be, conn, op, e,
1200                                 mlist->sml_desc, NULL, ACL_WRITE, &state ) )
1201                         {
1202                                 return( 0 );
1203                         }
1204
1205                         if ( mlist->sml_bvalues == NULL ) break;
1206
1207                         /* fall thru to check value to add */
1208
1209                 case LDAP_MOD_ADD:
1210                         assert( mlist->sml_bvalues != NULL );
1211
1212                         for ( bv = mlist->sml_bvalues; bv->bv_val != NULL; bv++ ) {
1213                                 if ( ! access_allowed( be, conn, op, e,
1214                                         mlist->sml_desc, bv, ACL_WRITE, &state ) )
1215                                 {
1216                                         return( 0 );
1217                                 }
1218                         }
1219                         break;
1220
1221                 case LDAP_MOD_DELETE:
1222                         if ( mlist->sml_bvalues == NULL ) {
1223                                 if ( ! access_allowed( be, conn, op, e,
1224                                         mlist->sml_desc, NULL, ACL_WRITE, NULL ) )
1225                                 {
1226                                         return( 0 );
1227                                 }
1228                                 break;
1229                         }
1230                         for ( bv = mlist->sml_bvalues; bv->bv_val != NULL; bv++ ) {
1231                                 if ( ! access_allowed( be, conn, op, e,
1232                                         mlist->sml_desc, bv, ACL_WRITE, &state ) )
1233                                 {
1234                                         return( 0 );
1235                                 }
1236                         }
1237                         break;
1238
1239                 case SLAP_MOD_SOFTADD:
1240                         /* allow adding attribute via modrdn thru */
1241                         break;
1242
1243                 default:
1244                         assert( 0 );
1245                         return( 0 );
1246                 }
1247         }
1248
1249         return( 1 );
1250 }
1251
1252 static char *
1253 aci_bvstrdup( struct berval *bv )
1254 {
1255         char *s;
1256
1257         s = (char *)ch_malloc(bv->bv_len + 1);
1258         if (s != NULL) {
1259                 AC_MEMCPY(s, bv->bv_val, bv->bv_len);
1260                 s[bv->bv_len] = 0;
1261         }
1262         return(s);
1263 }
1264
1265 static int
1266 aci_get_part(
1267         struct berval *list,
1268         int ix,
1269         char sep,
1270         struct berval *bv )
1271 {
1272         int len;
1273         char *p;
1274
1275         if (bv) {
1276                 bv->bv_len = 0;
1277                 bv->bv_val = NULL;
1278         }
1279         len = list->bv_len;
1280         p = list->bv_val;
1281         while (len >= 0 && --ix >= 0) {
1282                 while (--len >= 0 && *p++ != sep) ;
1283         }
1284         while (len >= 0 && *p == ' ') {
1285                 len--;
1286                 p++;
1287         }
1288         if (len < 0)
1289                 return(-1);
1290
1291         if (!bv)
1292                 return(0);
1293
1294         bv->bv_val = p;
1295         while (--len >= 0 && *p != sep) {
1296                 bv->bv_len++;
1297                 p++;
1298         }
1299         while (bv->bv_len > 0 && *--p == ' ')
1300                 bv->bv_len--;
1301         return(bv->bv_len);
1302 }
1303
1304 BerVarray
1305 aci_set_gather (void *cookie, struct berval *name, struct berval *attr)
1306 {
1307         AciSetCookie *cp = cookie;
1308         BerVarray bvals = NULL;
1309         struct berval ndn;
1310
1311         /* this routine needs to return the bervals instead of
1312          * plain strings, since syntax is not known.  It should
1313          * also return the syntax or some "comparison cookie".
1314          */
1315
1316         if (dnNormalize2(NULL, name, &ndn) == LDAP_SUCCESS) {
1317                 const char *text;
1318                 AttributeDescription *desc = NULL;
1319                 if (slap_bv2ad(attr, &desc, &text) == LDAP_SUCCESS) {
1320                         backend_attribute(cp->be, NULL, NULL,
1321                                 cp->e, &ndn, desc, &bvals);
1322                 }
1323                 free(ndn.bv_val);
1324         }
1325         return(bvals);
1326 }
1327
1328 static int
1329 aci_match_set (
1330         struct berval *subj,
1331     Backend *be,
1332     Entry *e,
1333     Connection *conn,
1334     Operation *op,
1335     int setref
1336 )
1337 {
1338         struct berval set = { 0, NULL };
1339         int rc = 0;
1340         AciSetCookie cookie;
1341
1342         if (setref == 0) {
1343                 ber_dupbv( &set, subj );
1344         } else {
1345                 struct berval subjdn, ndn = { 0, NULL };
1346                 struct berval setat;
1347                 BerVarray bvals;
1348                 const char *text;
1349                 AttributeDescription *desc = NULL;
1350
1351                 /* format of string is "entry/setAttrName" */
1352                 if (aci_get_part(subj, 0, '/', &subjdn) < 0) {
1353                         return(0);
1354                 }
1355
1356                 if ( aci_get_part(subj, 1, '/', &setat) < 0 ) {
1357                         setat.bv_val = SLAPD_ACI_SET_ATTR;
1358                         setat.bv_len = sizeof(SLAPD_ACI_SET_ATTR)-1;
1359                 }
1360
1361                 if ( setat.bv_val != NULL ) {
1362                         /*
1363                          * NOTE: dnNormalize2 honors the ber_len field
1364                          * as the length of the dn to be normalized
1365                          */
1366                         if ( dnNormalize2(NULL, &subjdn, &ndn) == LDAP_SUCCESS
1367                                 && slap_bv2ad(&setat, &desc, &text) == LDAP_SUCCESS )
1368                         {
1369                                 backend_attribute(be, NULL, NULL, e,
1370                                         &ndn, desc, &bvals);
1371                                 if ( bvals != NULL ) {
1372                                         if ( bvals[0].bv_val != NULL ) {
1373                                                 int i;
1374                                                 set = bvals[0];
1375                                                 bvals[0].bv_val = NULL;
1376                                                 for (i=1;bvals[i].bv_val;i++);
1377                                                 bvals[0].bv_val = bvals[i-1].bv_val;
1378                                                 bvals[i-1].bv_val = NULL;
1379                                         }
1380                                         ber_bvarray_free(bvals);
1381                                 }
1382                         }
1383                         if (ndn.bv_val)
1384                                 free(ndn.bv_val);
1385                 }
1386         }
1387
1388         if (set.bv_val != NULL) {
1389                 cookie.be = be;
1390                 cookie.e = e;
1391                 cookie.conn = conn;
1392                 cookie.op = op;
1393                 rc = (slap_set_filter(aci_set_gather, &cookie, &set,
1394                         &op->o_ndn, &e->e_nname, NULL) > 0);
1395                 ch_free(set.bv_val);
1396         }
1397         return(rc);
1398 }
1399
1400 #ifdef SLAPD_ACI_ENABLED
1401 static int
1402 aci_list_map_rights(
1403         struct berval *list )
1404 {
1405         struct berval bv;
1406         slap_access_t mask;
1407         int i;
1408
1409         ACL_INIT(mask);
1410         for (i = 0; aci_get_part(list, i, ',', &bv) >= 0; i++) {
1411                 if (bv.bv_len <= 0)
1412                         continue;
1413                 switch (*bv.bv_val) {
1414                 case 'c':
1415                         ACL_PRIV_SET(mask, ACL_PRIV_COMPARE);
1416                         break;
1417                 case 's':
1418                         /* **** NOTE: draft-ietf-ldapext-aci-model-0.3.txt defines
1419                          * the right 's' to mean "set", but in the examples states
1420                          * that the right 's' means "search".  The latter definition
1421                          * is used here.
1422                          */
1423                         ACL_PRIV_SET(mask, ACL_PRIV_SEARCH);
1424                         break;
1425                 case 'r':
1426                         ACL_PRIV_SET(mask, ACL_PRIV_READ);
1427                         break;
1428                 case 'w':
1429                         ACL_PRIV_SET(mask, ACL_PRIV_WRITE);
1430                         break;
1431                 case 'x':
1432                         /* **** NOTE: draft-ietf-ldapext-aci-model-0.3.txt does not
1433                          * define any equivalent to the AUTH right, so I've just used
1434                          * 'x' for now.
1435                          */
1436                         ACL_PRIV_SET(mask, ACL_PRIV_AUTH);
1437                         break;
1438                 default:
1439                         break;
1440                 }
1441
1442         }
1443         return(mask);
1444 }
1445
1446 static int
1447 aci_list_has_attr(
1448         struct berval *list,
1449         const struct berval *attr,
1450         struct berval *val )
1451 {
1452         struct berval bv, left, right;
1453         int i;
1454
1455         for (i = 0; aci_get_part(list, i, ',', &bv) >= 0; i++) {
1456                 if (aci_get_part(&bv, 0, '=', &left) < 0
1457                         || aci_get_part(&bv, 1, '=', &right) < 0)
1458                 {
1459                         if (ber_bvstrcasecmp(attr, &bv) == 0)
1460                                 return(1);
1461                 } else if (val == NULL) {
1462                         if (ber_bvstrcasecmp(attr, &left) == 0)
1463                                 return(1);
1464                 } else {
1465                         if (ber_bvstrcasecmp(attr, &left) == 0) {
1466                                 /* this is experimental code that implements a
1467                                  * simple (prefix) match of the attribute value.
1468                                  * the ACI draft does not provide for aci's that
1469                                  * apply to specific values, but it would be
1470                                  * nice to have.  If the <attr> part of an aci's
1471                                  * rights list is of the form <attr>=<value>,
1472                                  * that means the aci applies only to attrs with
1473                                  * the given value.  Furthermore, if the attr is
1474                                  * of the form <attr>=<value>*, then <value> is
1475                                  * treated as a prefix, and the aci applies to
1476                                  * any value with that prefix.
1477                                  *
1478                                  * Ideally, this would allow r.e. matches.
1479                                  */
1480                                 if (aci_get_part(&right, 0, '*', &left) < 0
1481                                         || right.bv_len <= left.bv_len)
1482                                 {
1483                                         if (ber_bvstrcasecmp(val, &right) == 0)
1484                                                 return(1);
1485                                 } else if (val->bv_len >= left.bv_len) {
1486                                         if (strncasecmp( val->bv_val, left.bv_val, left.bv_len ) == 0)
1487                                                 return(1);
1488                                 }
1489                         }
1490                 }
1491         }
1492         return(0);
1493 }
1494
1495 static slap_access_t
1496 aci_list_get_attr_rights(
1497         struct berval *list,
1498         const struct berval *attr,
1499         struct berval *val )
1500 {
1501     struct berval bv;
1502     slap_access_t mask;
1503     int i;
1504
1505         /* loop through each rights/attr pair, skip first part (action) */
1506         ACL_INIT(mask);
1507         for (i = 1; aci_get_part(list, i + 1, ';', &bv) >= 0; i += 2) {
1508                 if (aci_list_has_attr(&bv, attr, val) == 0)
1509                         continue;
1510                 if (aci_get_part(list, i, ';', &bv) < 0)
1511                         continue;
1512                 mask |= aci_list_map_rights(&bv);
1513         }
1514         return(mask);
1515 }
1516
1517 static int
1518 aci_list_get_rights(
1519         struct berval *list,
1520         const struct berval *attr,
1521         struct berval *val,
1522         slap_access_t *grant,
1523         slap_access_t *deny )
1524 {
1525     struct berval perm, actn;
1526     slap_access_t *mask;
1527     int i, found;
1528
1529         if (attr == NULL || attr->bv_len == 0
1530                         || ber_bvstrcasecmp( attr, &aci_bv_entry ) == 0) {
1531                 attr = &aci_bv_br_entry;
1532         }
1533
1534         found = 0;
1535         ACL_INIT(*grant);
1536         ACL_INIT(*deny);
1537         /* loop through each permissions clause */
1538         for (i = 0; aci_get_part(list, i, '$', &perm) >= 0; i++) {
1539                 if (aci_get_part(&perm, 0, ';', &actn) < 0)
1540                         continue;
1541                 if (ber_bvstrcasecmp( &aci_bv_grant, &actn ) == 0) {
1542                         mask = grant;
1543                 } else if (ber_bvstrcasecmp( &aci_bv_deny, &actn ) == 0) {
1544                         mask = deny;
1545                 } else {
1546                         continue;
1547                 }
1548
1549                 found = 1;
1550                 *mask |= aci_list_get_attr_rights(&perm, attr, val);
1551                 *mask |= aci_list_get_attr_rights(&perm, &aci_bv_br_all, NULL);
1552         }
1553         return(found);
1554 }
1555
1556 static int
1557 aci_group_member (
1558         struct berval *subj,
1559         struct berval *defgrpoc,
1560         struct berval *defgrpat,
1561     Backend             *be,
1562     Entry               *e,
1563     Connection          *conn,
1564     Operation           *op,
1565         regmatch_t      *matches
1566 )
1567 {
1568         struct berval bv;
1569         struct berval subjdn;
1570         struct berval grpoc;
1571         struct berval grpat;
1572         ObjectClass *grp_oc = NULL;
1573         AttributeDescription *grp_ad = NULL;
1574         const char *text;
1575         int rc;
1576
1577         /* format of string is "group/objectClassValue/groupAttrName" */
1578         if (aci_get_part(subj, 0, '/', &subjdn) < 0) {
1579                 return(0);
1580         }
1581
1582         if (aci_get_part(subj, 1, '/', &grpoc) < 0) {
1583                 grpoc = *defgrpoc;
1584         }
1585
1586         if (aci_get_part(subj, 2, '/', &grpat) < 0) {
1587                 grpat = *defgrpat;
1588         }
1589
1590         rc = slap_bv2ad( &grpat, &grp_ad, &text );
1591         if( rc != LDAP_SUCCESS ) {
1592                 rc = 0;
1593                 goto done;
1594         }
1595         rc = 0;
1596
1597         grp_oc = oc_bvfind( &grpoc );
1598
1599         if (grp_oc != NULL && grp_ad != NULL ) {
1600                 struct berval ndn;
1601                 bv.bv_val = (char *)ch_malloc(1024);
1602                 bv.bv_len = 1024;
1603                 string_expand(&bv, &subjdn, e->e_ndn, matches);
1604                 if ( dnNormalize2(NULL, &bv, &ndn) == LDAP_SUCCESS ) {
1605                         rc = (backend_group(be, conn, op, e, &ndn, &op->o_ndn, grp_oc, grp_ad) == 0);
1606                         free( ndn.bv_val );
1607                 }
1608                 ch_free(bv.bv_val);
1609         }
1610
1611 done:
1612         return(rc);
1613 }
1614
1615 static struct berval GroupClass = {
1616         sizeof(SLAPD_GROUP_CLASS)-1, SLAPD_GROUP_CLASS };
1617 static struct berval GroupAttr = {
1618         sizeof(SLAPD_GROUP_ATTR)-1, SLAPD_GROUP_ATTR };
1619 static struct berval RoleClass = {
1620         sizeof(SLAPD_ROLE_CLASS)-1, SLAPD_ROLE_CLASS };
1621 static struct berval RoleAttr = {
1622         sizeof(SLAPD_ROLE_ATTR)-1, SLAPD_ROLE_ATTR };
1623
1624 static int
1625 aci_mask(
1626     Backend                     *be,
1627     Connection          *conn,
1628     Operation           *op,
1629     Entry                       *e,
1630         AttributeDescription *desc,
1631     struct berval       *val,
1632     struct berval       *aci,
1633         regmatch_t              *matches,
1634         slap_access_t   *grant,
1635         slap_access_t   *deny
1636 )
1637 {
1638     struct berval bv, perms, sdn;
1639         int rc;
1640
1641
1642         assert( desc->ad_cname.bv_val != NULL );
1643
1644         /* parse an aci of the form:
1645                 oid#scope#action;rights;attr;rights;attr$action;rights;attr;rights;attr#dnType#subjectDN
1646
1647            See draft-ietf-ldapext-aci-model-04.txt section 9.1 for
1648            a full description of the format for this attribute.
1649
1650            For now, this routine only supports scope=entry.
1651          */
1652
1653         /* check that the aci has all 5 components */
1654         if (aci_get_part(aci, 4, '#', NULL) < 0)
1655                 return(0);
1656
1657         /* check that the aci family is supported */
1658         if (aci_get_part(aci, 0, '#', &bv) < 0)
1659                 return(0);
1660
1661         /* check that the scope is "entry" */
1662         if (aci_get_part(aci, 1, '#', &bv) < 0
1663                 || ber_bvstrcasecmp( &aci_bv_entry, &bv ) != 0)
1664         {
1665                 return(0);
1666         }
1667
1668         /* get the list of permissions clauses, bail if empty */
1669         if (aci_get_part(aci, 2, '#', &perms) <= 0)
1670                 return(0);
1671
1672         /* check if any permissions allow desired access */
1673         if (aci_list_get_rights(&perms, &desc->ad_cname, val, grant, deny) == 0)
1674                 return(0);
1675
1676         /* see if we have a DN match */
1677         if (aci_get_part(aci, 3, '#', &bv) < 0)
1678                 return(0);
1679
1680         if (aci_get_part(aci, 4, '#', &sdn) < 0)
1681                 return(0);
1682
1683         if (ber_bvstrcasecmp( &aci_bv_access_id, &bv ) == 0) {
1684                 struct berval ndn;
1685                 rc = 1;
1686                 if ( dnNormalize2(NULL, &sdn, &ndn) == LDAP_SUCCESS ) {
1687                         if (!dn_match( &op->o_ndn, &ndn))
1688                                 rc = 0;
1689                         free(ndn.bv_val);
1690                 }
1691                 return(rc);
1692         }
1693
1694         if (ber_bvstrcasecmp( &aci_bv_self, &bv ) == 0) {
1695                 if (dn_match(&op->o_ndn, &e->e_nname))
1696                         return(1);
1697
1698         } else if (ber_bvstrcasecmp( &aci_bv_dnattr, &bv ) == 0) {
1699                 Attribute *at;
1700                 AttributeDescription *ad = NULL;
1701                 const char *text;
1702
1703                 rc = slap_bv2ad( &sdn, &ad, &text );
1704
1705                 if( rc != LDAP_SUCCESS ) {
1706                         return 0;
1707                 }
1708
1709                 rc = 0;
1710
1711                 bv = op->o_ndn;
1712
1713                 for(at = attrs_find( e->e_attrs, ad );
1714                         at != NULL;
1715                         at = attrs_find( at->a_next, ad ) )
1716                 {
1717                         if (value_find( ad, at->a_vals, &bv) == 0 ) {
1718                                 rc = 1;
1719                                 break;
1720                         }
1721                 }
1722
1723                 return rc;
1724
1725
1726         } else if (ber_bvstrcasecmp( &aci_bv_group, &bv ) == 0) {
1727                 if (aci_group_member(&sdn, &GroupClass, &GroupAttr, be, e, conn, op, matches))
1728                         return(1);
1729
1730         } else if (ber_bvstrcasecmp( &aci_bv_role, &bv ) == 0) {
1731                 if (aci_group_member(&sdn, &RoleClass, &RoleAttr, be, e, conn, op, matches))
1732                         return(1);
1733
1734         } else if (ber_bvstrcasecmp( &aci_bv_set, &bv ) == 0) {
1735                 if (aci_match_set(&sdn, be, e, conn, op, 0))
1736                         return(1);
1737
1738         } else if (ber_bvstrcasecmp( &aci_bv_set_ref, &bv ) == 0) {
1739                 if (aci_match_set(&sdn, be, e, conn, op, 1))
1740                         return(1);
1741
1742         }
1743
1744         return(0);
1745 }
1746
1747 #endif  /* SLAPD_ACI_ENABLED */
1748
1749 static void
1750 string_expand(
1751         struct berval *bv,
1752         struct berval *pat,
1753         char *match,
1754         regmatch_t *matches)
1755 {
1756         ber_len_t       size;
1757         char   *sp;
1758         char   *dp;
1759         int     flag;
1760
1761         size = 0;
1762         bv->bv_val[0] = '\0';
1763         bv->bv_len--; /* leave space for lone $ */
1764
1765         flag = 0;
1766         for ( dp = bv->bv_val, sp = pat->bv_val; size < bv->bv_len &&
1767                 sp < pat->bv_val + pat->bv_len ; sp++) {
1768                 /* did we previously see a $ */
1769                 if (flag) {
1770                         if (*sp == '$') {
1771                                 *dp++ = '$';
1772                                 size++;
1773                         } else if (*sp >= '0' && *sp <= '9' ) {
1774                                 int     n;
1775                                 int     i;
1776                                 int     l;
1777
1778                                 n = *sp - '0';
1779                                 *dp = '\0';
1780                                 i = matches[n].rm_so;
1781                                 l = matches[n].rm_eo;
1782                                 for ( ; size < bv->bv_len && i < l; size++, i++ ) {
1783                                         *dp++ = match[i];
1784                                         size++;
1785                                 }
1786                                 *dp = '\0';
1787                         }
1788                         flag = 0;
1789                 } else {
1790                         if (*sp == '$') {
1791                                 flag = 1;
1792                         } else {
1793                                 *dp++ = *sp;
1794                                 size++;
1795                         }
1796                 }
1797         }
1798
1799         if (flag) {
1800                 /* must have ended with a single $ */
1801                 *dp++ = '$';
1802                 size++;
1803         }
1804
1805         *dp = '\0';
1806         bv->bv_len = size;
1807
1808 #ifdef NEW_LOGGING
1809         LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL1,
1810                    "string_expand:  pattern = %.*s\n", pat->bv_len, pat->bv_val ));
1811         LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL1,
1812                    "string_expand:  expanded = %s\n", bv->bv_val ));
1813 #else
1814         Debug( LDAP_DEBUG_TRACE, "=> string_expand: pattern:  %.*s\n", pat->bv_len, pat->bv_val, 0 );
1815         Debug( LDAP_DEBUG_TRACE, "=> string_expand: expanded: %s\n", bv->bv_val, 0, 0 );
1816 #endif
1817 }
1818
1819 static int
1820 regex_matches(
1821         struct berval *pat,                     /* pattern to expand and match against */
1822         char *str,                              /* string to match against pattern */
1823         char *buf,                              /* buffer with $N expansion variables */
1824         regmatch_t *matches             /* offsets in buffer for $N expansion variables */
1825 )
1826 {
1827         regex_t re;
1828         char newbuf[512];
1829         struct berval bv;
1830         int     rc;
1831
1832         bv.bv_len = sizeof(newbuf);
1833         bv.bv_val = newbuf;
1834
1835         if(str == NULL) str = "";
1836
1837         string_expand(&bv, pat, buf, matches);
1838         if (( rc = regcomp(&re, newbuf, REG_EXTENDED|REG_ICASE))) {
1839                 char error[512];
1840                 regerror(rc, &re, error, sizeof(error));
1841
1842 #ifdef NEW_LOGGING
1843                 LDAP_LOG(( "aci", LDAP_LEVEL_ERR,
1844                            "regex_matches: compile( \"%s\", \"%s\") failed %s\n",
1845                            pat->bv_val, str, error ));
1846 #else
1847                 Debug( LDAP_DEBUG_TRACE,
1848                     "compile( \"%s\", \"%s\") failed %s\n",
1849                         pat->bv_val, str, error );
1850 #endif
1851                 return( 0 );
1852         }
1853
1854         rc = regexec(&re, str, 0, NULL, 0);
1855         regfree( &re );
1856
1857 #ifdef NEW_LOGGING
1858         LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL2,
1859                    "regex_matches: string:   %s\n", str ));
1860         LDAP_LOG(( "aci", LDAP_LEVEL_DETAIL2,
1861                    "regex_matches: rc:  %d  %s\n",
1862                    rc, rc ? "matches" : "no matches" ));
1863 #else
1864         Debug( LDAP_DEBUG_TRACE,
1865             "=> regex_matches: string:   %s\n", str, 0, 0 );
1866         Debug( LDAP_DEBUG_TRACE,
1867             "=> regex_matches: rc: %d %s\n",
1868                 rc, !rc ? "matches" : "no matches", 0 );
1869 #endif
1870         return( !rc );
1871 }
1872