]> git.sur5r.net Git - openldap/blob - servers/slapd/dn.c
ad0126807efc7a09335f34b091c18948d0aa4649
[openldap] / servers / slapd / dn.c
1 /* dn.c - routines for dealing with distinguished names */
2 /* $OpenLDAP$ */
3 /*
4  * Copyright 1998-2000 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/ctype.h>
13 #include <ac/socket.h>
14 #include <ac/string.h>
15 #include <ac/time.h>
16
17 #include "ldap_pvt.h"
18
19 #include "slap.h"
20
21 #define SLAP_LDAPDN_PRETTY 0x1
22
23 /*
24  * The DN syntax-related functions take advantage of the dn representation
25  * handling functions ldap_str2dn/ldap_dn2str.  The latter are not schema-
26  * aware, so the attributes and their values need be validated (and possibly
27  * normalized).  In the current implementation the required validation/nor-
28  * malization/"pretty"ing are done on newly created DN structural represen-
29  * tations; however the idea is to move towards DN handling in structural
30  * representation instead of the current string representation.  To this
31  * purpose, we need to do only the required operations and keep track of
32  * what has been done to minimize their impact on performances.
33  *
34  * Developers are strongly encouraged to use this feature, to speed-up
35  * its stabilization.
36  */
37
38 #define AVA_PRIVATE( ava ) ( ( AttributeDescription * )(ava)->la_private )
39
40 /*
41  * In-place, schema-aware validation of the
42  * structural representation of a distinguished name.
43  */
44 static int
45 LDAPDN_validate( LDAPDN *dn )
46 {
47         int             iRDN;
48         int             rc;
49
50         assert( dn );
51
52         for ( iRDN = 0; dn[ iRDN ]; iRDN++ ) {
53                 LDAPRDN         *rdn = dn[ iRDN ][ 0 ];
54                 int             iAVA;
55
56                 assert( rdn );
57
58                 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
59                         LDAPAVA                 *ava = rdn[ iAVA ][ 0 ];
60                         AttributeDescription    *ad;
61                         slap_syntax_validate_func *validate = NULL;
62
63                         assert( ava );
64                         
65                         if ( ( ad = AVA_PRIVATE( ava ) ) == NULL ) {
66                                 const char      *text = NULL;
67
68                                 rc = slap_bv2ad( ava->la_attr, &ad, &text );
69                                 if ( rc != LDAP_SUCCESS ) {
70                                         return LDAP_INVALID_SYNTAX;
71                                 }
72
73                                 ava->la_private = ( void * )ad;
74                         }
75
76                         /* 
77                          * Replace attr oid/name with the canonical name
78                          */
79                         ber_bvfree( ava->la_attr );
80                         ava->la_attr = ber_bvdup( &ad->ad_cname );
81
82                         validate = ad->ad_type->sat_syntax->ssyn_validate;
83
84                         if ( validate ) {
85                                 /*
86                                  * validate value by validate function
87                                  */
88                                 rc = ( *validate )( ad->ad_type->sat_syntax,
89                                         ava->la_value );
90                         
91                                 if ( rc != LDAP_SUCCESS ) {
92                                         return LDAP_INVALID_SYNTAX;
93                                 }
94                         }
95                 }
96         }
97
98         return LDAP_SUCCESS;
99 }
100
101 /*
102  * dn validate routine
103  */
104 int
105 dnValidate(
106         Syntax *syntax,
107         struct berval *in )
108 {
109         int             rc;
110         LDAPDN          *dn = NULL;
111
112         assert( in );
113
114         if ( in->bv_len == 0 ) {
115                 return( LDAP_SUCCESS );
116         }
117
118         rc = ldap_str2dn( in->bv_val, &dn, LDAP_DN_FORMAT_LDAP );
119
120         /*
121          * Schema-aware validate
122          */
123         if ( rc == LDAP_SUCCESS ) {
124                 rc = LDAPDN_validate( dn );
125         }
126         
127         ldap_dnfree( dn );
128         
129         if ( rc != LDAP_SUCCESS ) {
130                 return( LDAP_INVALID_SYNTAX );
131         }
132
133         return( LDAP_SUCCESS );
134 }
135
136 /*
137  * AVA sorting inside a RDN
138  *
139  * rule: sort attributeTypes in alphabetical order; in case of multiple
140  * occurrences of the same attributeType, sort values in byte order
141  * (use memcmp, which implies alphabetical order in case of IA5 value;
142  * this should guarantee the repeatability of the operation).
143  *
144  * uses a linear search; should be fine since the number of AVAs in
145  * a RDN should be limited.
146  */
147 static void
148 AVA_Sort( LDAPRDN *rdn, int iAVA )
149 {
150         int             i;
151         LDAPAVA         *ava_in = rdn[ iAVA ][ 0 ];
152
153         assert( rdn );
154         assert( ava_in );
155         
156         for ( i = 0; i < iAVA; i++ ) {
157                 LDAPAVA         *ava = rdn[ i ][ 0 ];
158                 int             a, j;
159
160                 assert( ava );
161
162                 a = strcmp( ava_in->la_attr->bv_val, ava->la_attr->bv_val );
163
164                 if ( a > 0 ) {
165                         break;
166                 }
167
168                 while ( a == 0 ) {
169                         int             v, d;
170
171                         d = ava_in->la_value->bv_len - ava->la_value->bv_len;
172
173                         v = memcmp( ava_in->la_value->bv_val, 
174                                         ava->la_value->bv_val,
175                                         d <= 0 ? ava_in->la_value->bv_len 
176                                                 : ava->la_value->bv_len );
177
178                         if ( v == 0 && d != 0 ) {
179                                 v = d;
180                         }
181
182                         if ( v <= 0 ) {
183                                 /* 
184                                  * got it!
185                                  */
186                                 break;
187                         }
188
189                         if ( ++i == iAVA ) {
190                                 /*
191                                  * already sorted
192                                  */
193                                 return;
194                         }
195
196                         ava = rdn[ i ][ 0 ];
197                         a = strcmp( ava_in->la_value->bv_val, 
198                                         ava->la_value->bv_val );
199                 }
200
201                 /*
202                  * move ahead
203                  */
204                 for ( j = iAVA; j > i; j-- ) {
205                         rdn[ j ][ 0 ] = rdn[ j - 1 ][ 0 ];
206                 }
207                 rdn[ i ][ 0 ] = ava_in;
208
209                 return;
210         }
211 }
212
213 /*
214  * In-place, schema-aware normalization / "pretty"ing of the
215  * structural representation of a distinguished name.
216  */
217 static int
218 LDAPDN_rewrite( LDAPDN *dn, unsigned flags )
219 {
220         int             iRDN;
221         int             rc;
222
223         assert( dn );
224
225         for ( iRDN = 0; dn[ iRDN ]; iRDN++ ) {
226                 LDAPRDN         *rdn = dn[ iRDN ][ 0 ];
227                 int             iAVA;
228
229                 assert( rdn );
230
231                 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
232                         LDAPAVA                 *ava = rdn[ iAVA ][ 0 ];
233                         AttributeDescription    *ad;
234                         slap_syntax_transform_func *transf = NULL;
235                         MatchingRule *mr;
236                         struct berval           *bv = NULL;
237
238                         assert( ava );
239
240                         if ( ( ad = AVA_PRIVATE( ava ) ) == NULL ) {
241                                 const char      *text = NULL;
242
243                                 rc = slap_bv2ad( ava->la_attr, &ad, &text );
244                                 if ( rc != LDAP_SUCCESS ) {
245                                         return LDAP_INVALID_SYNTAX;
246                                 }
247                                 
248                                 ava->la_private = ( void * )ad;
249                         }
250
251                         /* 
252                          * Replace attr oid/name with the canonical name
253                          */
254                         ber_bvfree( ava->la_attr );
255                         ava->la_attr = ber_bvdup( &ad->ad_cname );
256
257                         if( flags & SLAP_LDAPDN_PRETTY ) {
258                                 transf = ad->ad_type->sat_syntax->ssyn_pretty;
259                                 mr = NULL;
260                         } else {
261                                 transf = ad->ad_type->sat_syntax->ssyn_normalize;
262                                 mr = ad->ad_type->sat_equality;
263                         }
264
265                         if ( transf ) {
266                                 /*
267                                  * transform value by normalize/pretty function
268                                  */
269                                 rc = ( *transf )( ad->ad_type->sat_syntax,
270                                         ava->la_value, &bv );
271                         
272                                 if ( rc != LDAP_SUCCESS ) {
273                                         return LDAP_INVALID_SYNTAX;
274                                 }
275                         }
276
277                         if( mr && ( mr->smr_usage & SLAP_MR_DN_FOLD ) ) {
278                                 struct berval *s = bv;
279
280                                 bv = ber_bvstr( UTF8normalize( bv ? bv : ava->la_value, 
281                                         UTF8_CASEFOLD ) );
282
283                                 ber_bvfree( s );
284                         }
285
286                         if( bv ) {
287                                 ber_bvfree( ava->la_value );
288                                 ava->la_value = bv;
289                         }
290
291                         AVA_Sort( rdn, iAVA );
292                 }
293         }
294
295         return LDAP_SUCCESS;
296 }
297
298 /*
299  * dn normalize routine
300  */
301 int
302 dnNormalize(
303         Syntax *syntax,
304         struct berval *val,
305         struct berval **normalized )
306 {
307         struct berval *out = NULL;
308
309         Debug( LDAP_DEBUG_TRACE, ">>> dnNormalize: <%s>\n", val->bv_val, 0, 0 );
310
311         assert( val );
312         assert( normalized );
313
314         if ( val->bv_len != 0 ) {
315                 LDAPDN          *dn = NULL;
316                 char            *dn_out = NULL;
317                 int             rc;
318
319                 /*
320                  * Go to structural representation
321                  */
322                 rc = ldap_str2dn( val->bv_val, &dn, LDAP_DN_FORMAT_LDAP );
323                 if ( rc != LDAP_SUCCESS ) {
324                         return LDAP_INVALID_SYNTAX;
325                 }
326
327                 /*
328                  * Schema-aware rewrite
329                  */
330                 if ( LDAPDN_rewrite( dn, 0 ) != LDAP_SUCCESS ) {
331                         ldap_dnfree( dn );
332                         return LDAP_INVALID_SYNTAX;
333                 }
334
335                 /*
336                  * Back to string representation
337                  */
338                 rc = ldap_dn2str( dn, &dn_out, LDAP_DN_FORMAT_LDAPV3 );
339
340                 ldap_dnfree( dn );
341
342                 if ( rc != LDAP_SUCCESS ) {
343                         return LDAP_INVALID_SYNTAX;
344                 }
345
346                 out = ber_bvstr( dn_out );
347
348         } else {
349                 out = ber_bvdup( val );
350         }
351
352         Debug( LDAP_DEBUG_TRACE, "<<< dnNormalize: <%s>\n", out->bv_val, 0, 0 );
353
354         *normalized = out;
355
356         return LDAP_SUCCESS;
357 }
358
359 /*
360  * dn "pretty"ing routine
361  */
362 int
363 dnPretty(
364         Syntax *syntax,
365         struct berval *val,
366         struct berval **pretty)
367 {
368         struct berval *out = NULL;
369
370         Debug( LDAP_DEBUG_TRACE, ">>> dnPretty: <%s>\n", val->bv_val, 0, 0 );
371
372         assert( val );
373         assert( pretty );
374
375         if ( val->bv_len != 0 ) {
376                 LDAPDN          *dn = NULL;
377                 char            *dn_out = NULL;
378                 int             rc;
379
380                 /* FIXME: should be liberal in what we accept */
381                 rc = ldap_str2dn( val->bv_val, &dn, LDAP_DN_FORMAT_LDAP );
382                 if ( rc != LDAP_SUCCESS ) {
383                         return LDAP_INVALID_SYNTAX;
384                 }
385
386                 /*
387                  * Schema-aware rewrite
388                  */
389                 if ( LDAPDN_rewrite( dn, SLAP_LDAPDN_PRETTY ) != LDAP_SUCCESS ) {
390                         ldap_dnfree( dn );
391                         return LDAP_INVALID_SYNTAX;
392                 }
393
394                 /* FIXME: not sure why the default isn't pretty */
395                 /* RE: the default is the form that is used as
396                  * an internal representation; the pretty form
397                  * is a variant */
398                 rc = ldap_dn2str( dn, &dn_out,
399                         LDAP_DN_FORMAT_LDAPV3 | LDAP_DN_PRETTY );
400
401                 ldap_dnfree( dn );
402
403                 if ( rc != LDAP_SUCCESS ) {
404                         return LDAP_INVALID_SYNTAX;
405                 }
406
407                 out = ber_bvstr( dn_out );
408
409         } else {
410                 out = ber_bvdup( val );
411         }
412
413         Debug( LDAP_DEBUG_TRACE, "<<< dnPretty: <%s>\n", out->bv_val, 0, 0 );
414
415         *pretty = out;
416
417         return LDAP_SUCCESS;
418 }
419
420 /*
421  * dnMatch routine
422  *
423  * note: uses exact string match (strcmp) because it is supposed to work
424  * on normalized DNs.
425  */
426 int
427 dnMatch(
428         int *matchp,
429         slap_mask_t flags,
430         Syntax *syntax,
431         MatchingRule *mr,
432         struct berval *value,
433         void *assertedValue )
434 {
435         int match;
436         struct berval *asserted = (struct berval *) assertedValue;
437
438         assert( matchp );
439         assert( value );
440         assert( assertedValue );
441         
442         match = value->bv_len - asserted->bv_len;
443
444         if ( match == 0 ) {
445                 match = strcmp( value->bv_val, asserted->bv_val );
446         }
447
448 #ifdef NEW_LOGGING
449         LDAP_LOG(( "schema", LDAP_LEVEL_ENTRY,
450                 "dnMatch: %d\n    %s\n    %s\n", match,
451                 value->bv_val, asserted->bv_val ));
452 #else
453         Debug( LDAP_DEBUG_ARGS, "dnMatch %d\n\t\"%s\"\n\t\"%s\"\n",
454                 match, value->bv_val, asserted->bv_val );
455 #endif
456
457         *matchp = match;
458         return( LDAP_SUCCESS );
459 }
460
461 #ifdef SLAP_DN_MIGRATION
462 /*
463  * these routines are provided for migration purposes only!
464  *      dn_validate is deprecated in favor of dnValidate
465  *      dn_normalize is deprecated in favor of dnNormalize
466  *      strcmp/strcasecmp for DNs is deprecated in favor of dnMatch
467  *
468  * other routines are likewise deprecated but may not yet have
469  * replacement functions.
470  */
471
472 /*
473  * dn_validate - validate and compress dn.  the dn is
474  * compressed in place are returned if valid.
475  * Deprecated in favor of dnValidate()
476  */
477 char *
478 dn_validate( char *dn )
479 {
480         struct berval val, *pretty;
481         int             rc;
482
483         if ( dn == NULL || dn[0] == '\0' ) {
484                 return dn;
485         }
486
487         val.bv_val = dn;
488         val.bv_len = strlen( dn );
489
490         rc = dnPretty( NULL, &val, &pretty );
491         if ( rc != LDAP_SUCCESS ) {
492                 return NULL;
493         }
494
495         if ( val.bv_len < pretty->bv_len ) {
496                 ber_bvfree( pretty );
497                 return NULL;
498         }
499
500         AC_MEMCPY( dn, pretty->bv_val, pretty->bv_len + 1 );
501         ber_bvfree( pretty );
502
503         return dn;
504 }
505
506 /*
507  * dn_normalize - put dn into a canonical form suitable for storing
508  * in a hash database.  this involves normalizing the case as well as
509  * the format.  the dn is normalized in place as well as returned if valid.
510  * Deprecated in favor of dnNormalize()
511  */
512 char *
513 dn_normalize( char *dn )
514 {
515         struct berval   val, *normalized;
516         int             rc;
517
518         if ( dn == NULL || dn[0] == '\0' ) {
519                 return dn;
520         }
521
522         val.bv_val = dn;
523         val.bv_len = strlen( dn );
524
525         rc = dnNormalize( NULL, &val, &normalized );
526         if ( rc != LDAP_SUCCESS ) {
527                 return NULL;
528         }
529
530         if ( val.bv_len < normalized->bv_len ) {
531                 ber_bvfree( normalized );
532                 return NULL;
533         }
534
535         AC_MEMCPY( dn, normalized->bv_val, normalized->bv_len + 1 );
536         ber_bvfree( normalized );
537
538         return dn;
539 }
540
541 /*
542  * dnParent - dn's parent, in-place
543  */
544 int
545 dnParent( 
546         const char      *dn, 
547         const char      **pdn )
548 {
549         LDAPRDN         *tmpRDN;
550         const char      *p;
551         int             rc;
552
553         rc = ldap_str2rdn( dn, &tmpRDN, &p, LDAP_DN_FORMAT_LDAP );
554         if ( rc != LDAP_SUCCESS ) {
555                 return rc;
556         }
557         ldap_rdnfree( tmpRDN );
558
559         assert( DN_SEPARATOR( p[ 0 ] ) );
560         p++;
561
562         while ( ASCII_SPACE( p[ 0 ] ) ) {
563                 p++;
564         }
565
566         *pdn = p;
567
568         return LDAP_SUCCESS;
569 }
570
571 /*
572  * dn_parent - return the dn's parent, in-place
573  * FIXME: should be replaced by dnParent()
574  */
575 char *
576 dn_parent(
577         Backend         *be,
578         const char      *dn )
579 {
580 #if 0
581         const char      *s;
582         int     inquote;
583
584         if( dn == NULL ) {
585                 return NULL;
586         }
587
588         while(*dn != '\0' && ASCII_SPACE(*dn)) {
589                 dn++;
590         }
591
592         if( *dn == '\0' ) {
593                 return NULL;
594         }
595
596         if ( be != NULL && be_issuffix( be, dn ) ) {
597                 return NULL;
598         }
599
600         /*
601          * assume it is an X.500-style name, which looks like
602          * foo=bar,sha=baz,...
603          */
604
605         inquote = 0;
606         for ( s = dn; *s; s++ ) {
607                 if ( *s == '\\' ) {
608                         if ( *(s + 1) ) {
609                                 s++;
610                         }
611                         continue;
612                 }
613                 if ( inquote ) {
614                         if ( *s == '"' ) {
615                                 inquote = 0;
616                         }
617                 } else {
618                         if ( *s == '"' ) {
619                                 inquote = 1;
620                         } else if ( DN_SEPARATOR( *s ) ) {
621                                 return (char *)s + 1;
622                         }
623                 }
624         }
625
626         return "";
627 #endif
628         const char      *pdn;
629
630         if ( dn == NULL ) {
631                 return NULL;
632         }
633
634         while ( dn[ 0 ] != '\0' && ASCII_SPACE( dn[ 0 ] ) ) {
635                 dn++;
636         }
637
638         if ( dn[ 0 ] == '\0' ) {
639                 return NULL;
640         }
641
642         if ( be != NULL && be_issuffix( be, dn ) ) {
643                 return NULL;
644         }
645
646         if ( dnParent( dn, &pdn ) != LDAP_SUCCESS ) {
647                 return NULL;
648         }
649         
650         return ( char * )pdn;
651 }
652
653 int
654 dnExtractRdn( 
655         const char      *dn, 
656         struct berval   **rdn )
657 {
658         LDAPRDN         *tmpRDN;
659         const char      *p;
660         char            *rdnout;
661         int             rc;
662
663         assert( dn );
664         assert( rdn );
665
666         rc = ldap_str2rdn( dn, &tmpRDN, &p, LDAP_DN_FORMAT_LDAP );
667         if ( rc != LDAP_SUCCESS ) {
668                 return rc;
669         }
670
671         rc = ldap_rdn2str( tmpRDN, &rdnout, LDAP_DN_FORMAT_LDAPV3 );
672         ldap_rdnfree( tmpRDN );
673         if ( rc != LDAP_SUCCESS ) {
674                 return rc;
675         }
676
677         *rdn = ber_bvstr( rdnout );
678         if ( *rdn == NULL ) {
679                 free( rdnout );
680                 return LDAP_NO_MEMORY;
681         }
682
683         return LDAP_SUCCESS;
684 }
685
686 /*
687  * FIXME: should be replaced by dnExtractRdn() (together with dn_rdn)
688  */
689 int 
690 dn_rdnlen(
691         Backend         *be,
692         const char      *dn_in )
693 {
694 #if 0
695         char    *s;
696         int     inquote;
697
698         if( dn_in == NULL ) {
699                 return 0;
700         }
701
702         while(*dn_in && ASCII_SPACE(*dn_in)) {
703                 dn_in++;
704         }
705
706         if( *dn_in == '\0' ) {
707                 return( 0 );
708         }
709
710         if ( be != NULL && be_issuffix( be, dn_in ) ) {
711                 return( 0 );
712         }
713
714         inquote = 0;
715
716         for ( s = (char *)dn_in; *s; s++ ) {
717                 if ( *s == '\\' ) {
718                         if ( *(s + 1) ) {
719                                 s++;
720                         }
721                         continue;
722                 }
723                 if ( inquote ) {
724                         if ( *s == '"' ) {
725                                 inquote = 0;
726                         }
727                 } else {
728                         if ( *s == '"' ) {
729                                 inquote = 1;
730                         } else if ( DN_SEPARATOR( *s ) ) {
731                                 break;
732                         }
733                 }
734         }
735
736         return( s - dn_in );
737 #endif
738         struct berval   *rdn = NULL;
739         int             retval = 0;
740
741         assert( dn_in );
742
743         if ( dn_in == NULL ) {
744                 return 0;
745         }
746
747         while ( dn_in[ 0 ] && ASCII_SPACE( dn_in[ 0 ] ) ) {
748                 dn_in++;
749         }
750
751         if ( dn_in[ 0 ] == '\0' ) {
752                 return 0;
753         }
754
755         if ( be != NULL && be_issuffix( be, dn_in ) ) {
756                 return 0;
757         }
758
759         if ( dnExtractRdn( dn_in, &rdn ) != LDAP_SUCCESS ) {
760                 ber_bvfree( rdn );
761                 return 0;
762         }
763
764         retval = rdn->bv_len;
765         ber_bvfree( rdn );
766
767         return retval;
768 }
769
770 /*
771  * FIXME: should be replaced by dnExtractRdn() (together with dn_rdnlen)
772  */
773 char * dn_rdn(
774         Backend *be,
775         const char      *dn_in )
776 {
777 #if 0
778         char *rdn;
779         int i = dn_rdnlen( be, dn_in );
780
781         rdn = ch_malloc( i + 1 );
782         strncpy(rdn, dn_in, i);
783         rdn[i] = '\0';
784         return rdn;
785 #endif 
786         struct berval   *rdn = NULL;
787         char            *retval;
788
789         assert( dn_in );
790
791         if ( dn_in == NULL ) {
792                 return NULL;
793         }
794
795         while ( dn_in[ 0 ] && ASCII_SPACE( dn_in[ 0 ] ) ) {
796                 dn_in++;
797         }
798
799         if ( dn_in[ 0 ] == '\0' ) {
800                 return NULL;
801         }
802
803         if ( be != NULL && be_issuffix( be, dn_in ) ) {
804                 return NULL;
805         }
806
807         if ( dnExtractRdn( dn_in, &rdn ) != LDAP_SUCCESS ) {
808                 ber_bvfree( rdn );
809                 return NULL;
810         }
811
812         retval = rdn->bv_val;
813         free( rdn );
814
815         return retval;
816 }
817
818 /*
819  * return a charray of all subtrees to which the DN resides in
820  */
821 char **dn_subtree(
822         Backend *be,
823         const char      *dn )
824 {
825         char **subtree = NULL;
826         
827         do {
828                 charray_add( &subtree, dn );
829
830                 dn = dn_parent( be, dn );
831
832         } while ( dn != NULL );
833
834         return subtree;
835 }
836
837 /*
838  * dn_issuffix - tells whether suffix is a suffix of dn.
839  * Both dn and suffix must be normalized.
840  *      deprecated in favor of dnIsSuffix()
841  */
842 int
843 dn_issuffix(
844         const char      *dn,
845         const char      *suffix
846 )
847 {
848         struct berval   bvdn, bvsuffix;
849
850         assert( dn );
851         assert( suffix );
852
853         bvdn.bv_val = (char *) dn;
854         bvdn.bv_len = strlen( dn );
855         bvsuffix.bv_val = (char *) suffix;
856         bvsuffix.bv_len = strlen( suffix );
857
858         return dnIsSuffix( &bvdn, &bvsuffix );
859 }
860
861 /*
862  * get_next_substring(), rdn_attr_type(), rdn_attr_value(), and
863  * build_new_dn().
864  *
865  * Copyright 1999, Juan C. Gomez, All rights reserved.
866  * This software is not subject to any license of Silicon Graphics
867  * Inc. or Purdue University.
868  *
869  * Redistribution and use in source and binary forms are permitted
870  * without restriction or fee of any kind as long as this notice
871  * is preserved.
872  *
873  */
874
875 /* get_next_substring:
876  *
877  * Gets next substring in s, using d (or the end of the string '\0') as a
878  * string delimiter, and places it in a duplicated memory space. Leading
879  * spaces are ignored. String s **must** be null-terminated.
880  */
881
882 static char *
883 get_next_substring( const char * s, char d )
884 {
885
886         char    *str, *r;
887
888         r = str = ch_malloc( strlen(s) + 1 );
889
890         /* Skip leading spaces */
891         
892         while ( *s && ASCII_SPACE(*s) ) {
893                 s++;
894         }
895         
896         /* Copy word */
897
898         while ( *s && (*s != d) ) {
899
900                 /* Don't stop when you see trailing spaces may be a multi-word
901                 * string, i.e. name=John Doe!
902                 */
903
904                 *str++ = *s++;
905         }
906         
907         *str = '\0';
908         
909         return r;
910         
911 }
912
913
914 /* rdn_attr_type:
915  *
916  * Given a string (i.e. an rdn) of the form:
917  *       "attribute_type = attribute_value"
918  * this function returns the type of an attribute, that is the
919  * string "attribute_type" which is placed in newly allocated
920  * memory. The returned string will be null-terminated.
921  */
922
923 char * rdn_attr_type( const char * s )
924 {
925         return get_next_substring( s, '=' );
926 }
927
928
929 /* rdn_attr_value:
930  *
931  * Given a string (i.e. an rdn) of the form:
932  *       "attribute_type = attribute_value"
933  * this function returns "attribute_type" which is placed in newly allocated
934  * memory. The returned string will be null-terminated and may contain
935  * spaces (i.e. "John Doe\0").
936  */
937
938 char *
939 rdn_attr_value( const char * rdn )
940 {
941
942         const char      *str;
943
944         if ( (str = strchr( rdn, '=' )) != NULL ) {
945                 return get_next_substring(++str, '\0');
946         }
947
948         return NULL;
949
950 }
951
952
953 /* rdn_attrs:
954  *
955  * Given a string (i.e. an rdn) of the form:
956  *   "attribute_type=attribute_value[+attribute_type=attribute_value[...]]"
957  * this function stores the types of the attributes in ptypes, that is the
958  * array of strings "attribute_type" which is placed in newly allocated
959  * memory, and the values of the attributes in pvalues, that is the
960  * array of strings "attribute_value" which is placed in newly allocated
961  * memory. Returns 0 on success, -1 on failure.
962  *
963  * note: got part of the code from dn_validate
964  */
965
966 int
967 rdn_attrs( const char * rdn_in, char ***ptypes, char ***pvalues)
968 {
969         char **parts, **p;
970
971         *ptypes = NULL;
972         *pvalues = NULL;
973
974         /*
975          * explode the rdn in parts
976          */
977         parts = ldap_explode_rdn( rdn_in, 0 );
978
979         if ( parts == NULL ) {
980                 return( -1 );
981         }
982
983         for ( p = parts; p[0]; p++ ) {
984                 char *s, *e, *d;
985                 
986                 /* split each rdn part in type value */
987                 s = strchr( p[0], '=' );
988                 if ( s == NULL ) {
989                         charray_free( *ptypes );
990                         charray_free( *pvalues );
991                         charray_free( parts );
992                         return( -1 );
993                 }
994                 
995                 /* type should be fine */
996                 charray_add_n( ptypes, p[0], ( s-p[0] ) );
997
998                 /* value needs to be unescaped
999                  * (maybe this should be moved to ldap_explode_rdn?) */
1000                 for ( e = d = s + 1; e[0]; e++ ) {
1001                         if ( *e != '\\' ) {
1002                                 *d++ = *e;
1003                         }
1004                 }
1005                 d[0] = '\0';
1006                 charray_add( pvalues, s + 1 );
1007         }
1008
1009         /* free array */
1010         charray_free( parts );
1011
1012         return( 0 );
1013 }
1014
1015
1016 /* rdn_validate:
1017  *
1018  * 1 if rdn is a legal rdn;
1019  * 0 otherwise (including a sequence of rdns)
1020  *
1021  * note: got it from dn_rdn; it should be rewritten
1022  * according to dn_validate
1023  */
1024 int
1025 rdn_validate( const char * rdn )
1026 {
1027         int     inquote;
1028
1029         if ( rdn == NULL ) {
1030                 return( 0 );
1031         }
1032
1033         if ( strchr( rdn, '=' ) == NULL ) {
1034                 return( 0 );
1035         }
1036
1037         while ( *rdn && ASCII_SPACE( *rdn ) ) {
1038                 rdn++;
1039         }
1040
1041         if( *rdn == '\0' ) {
1042                 return( 0 );
1043         }
1044
1045         inquote = 0;
1046
1047         for ( ; *rdn; rdn++ ) {
1048                 if ( *rdn == '\\' ) {
1049                         if ( *(rdn + 1) ) {
1050                                 rdn++;
1051                         }
1052                         continue;
1053                 }
1054                 if ( inquote ) {
1055                         if ( *rdn == '"' ) {
1056                                 inquote = 0;
1057                         }
1058                 } else {
1059                         if ( *rdn == '"' ) {
1060                                 inquote = 1;
1061                         } else if ( DN_SEPARATOR( *rdn ) ) {
1062                                 return( 0 );
1063                         }
1064                 }
1065         }
1066
1067         return( 1 );
1068 }
1069
1070
1071 /* build_new_dn:
1072  *
1073  * Used by ldbm/bdb2 back_modrdn to create the new dn of entries being
1074  * renamed.
1075  *
1076  * new_dn = parent (p_dn) + separator(s) + rdn (newrdn) + null.
1077  */
1078
1079 void
1080 build_new_dn( char ** new_dn,
1081         const char *e_dn,
1082         const char * p_dn,
1083         const char * newrdn )
1084 {
1085
1086         if ( p_dn == NULL ) {
1087                 *new_dn = ch_strdup( newrdn );
1088                 return;
1089         }
1090
1091         *new_dn = (char *) ch_malloc( strlen( p_dn ) + strlen( newrdn ) + 3 );
1092
1093         strcpy( *new_dn, newrdn );
1094         strcat( *new_dn, "," );
1095         strcat( *new_dn, p_dn );
1096 }
1097
1098 #endif /* SLAP_DN_MIGRATION */
1099
1100 /*
1101  * dnIsSuffix - tells whether suffix is a suffix of dn.
1102  * Both dn and suffix must be normalized.
1103  */
1104 int
1105 dnIsSuffix(
1106         const struct berval *dn,
1107         const struct berval *suffix )
1108 {
1109         int     d = dn->bv_len - suffix->bv_len;
1110
1111         assert( dn );
1112         assert( suffix );
1113
1114         /* empty suffix matches any dn */
1115         if ( suffix->bv_len == 0 ) {
1116                 return 1;
1117         }
1118
1119         /* suffix longer than dn */
1120         if ( d < 0 ) {
1121                 return 0;
1122         }
1123
1124         /* no rdn separator or escaped rdn separator */
1125         if ( d > 1 && ( !DN_SEPARATOR( dn->bv_val[ d - 1 ] ) 
1126                                 || DN_ESCAPE( dn->bv_val[ d - 2 ] ) ) ) {
1127                 return 0;
1128         }
1129
1130         /* no possible match or malformed dn */
1131         if ( d == 1 ) {
1132                 return 0;
1133         }
1134
1135         /* compare */
1136         return( strcmp( dn->bv_val + d, suffix->bv_val ) == 0 );
1137 }