2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2005 The OpenLDAP Foundation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
11 * A copy of this license is available in the file LICENSE in the
12 * top-level directory of the distribution or, alternatively, at
13 * <http://www.OpenLDAP.org/license.html>.
15 /* Portions Copyright (c) 1994 Regents of the University of Michigan.
16 * All rights reserved.
23 #include <ac/stdlib.h>
24 #include <ac/socket.h>
25 #include <ac/string.h>
29 #include "ldap_schema.h"
31 /* extension to UFN that turns trailing "dc=value" rdns in DNS style,
32 * e.g. "ou=People,dc=openldap,dc=org" => "People, openldap.org" */
36 /* parsing/printing routines */
37 static int str2strval( const char *str, ber_len_t stoplen, struct berval *val,
38 const char **next, unsigned flags, int *retFlags, void *ctx );
39 static int DCE2strval( const char *str, struct berval *val,
40 const char **next, unsigned flags, void *ctx );
41 static int IA52strval( const char *str, struct berval *val,
42 const char **next, unsigned flags, void *ctx );
43 static int quotedIA52strval( const char *str, struct berval *val,
44 const char **next, unsigned flags, void *ctx );
45 static int hexstr2binval( const char *str, struct berval *val,
46 const char **next, unsigned flags, void *ctx );
47 static int hexstr2bin( const char *str, char *c );
48 static int byte2hexpair( const char *val, char *pair );
49 static int binval2hexstr( struct berval *val, char *str );
50 static int strval2strlen( struct berval *val, unsigned flags,
52 static int strval2str( struct berval *val, char *str, unsigned flags,
54 static int strval2IA5strlen( struct berval *val, unsigned flags,
56 static int strval2IA5str( struct berval *val, char *str, unsigned flags,
58 static int strval2DCEstrlen( struct berval *val, unsigned flags,
60 static int strval2DCEstr( struct berval *val, char *str, unsigned flags,
62 static int strval2ADstrlen( struct berval *val, unsigned flags,
64 static int strval2ADstr( struct berval *val, char *str, unsigned flags,
66 static int dn2domain( LDAPDN dn, struct berval *bv, int pos, int *iRDN );
69 static LDAPAVA * ldapava_new(
70 const struct berval *attr, const struct berval *val, unsigned flags, void *ctx );
72 /* Higher level helpers */
73 static int rdn2strlen( LDAPRDN rdn, unsigned flags, ber_len_t *len,
74 int ( *s2l )( struct berval *, unsigned, ber_len_t * ) );
75 static int rdn2str( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len,
76 int ( *s2s )( struct berval *, char *, unsigned, ber_len_t * ));
77 static int rdn2UFNstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len );
78 static int rdn2UFNstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len );
79 static int rdn2DCEstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len );
80 static int rdn2DCEstr( LDAPRDN rdn, char *str, unsigned flag, ber_len_t *len, int first );
81 static int rdn2ADstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len );
82 static int rdn2ADstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len, int first );
85 * RFC 1823 ldap_get_dn
88 ldap_get_dn( LDAP *ld, LDAPMessage *entry )
94 LDAP_LOG ( OPERATION, ENTRY, "ldap_get_dn\n", 0, 0, 0 );
96 Debug( LDAP_DEBUG_TRACE, "ldap_get_dn\n", 0, 0, 0 );
100 assert( LDAP_VALID(ld) );
101 assert( entry != NULL );
103 tmp = *entry->lm_ber; /* struct copy */
104 if ( ber_scanf( &tmp, "{a" /*}*/, &dn ) == LBER_ERROR ) {
105 ld->ld_errno = LDAP_DECODING_ERROR;
113 ldap_get_dn_ber( LDAP *ld, LDAPMessage *entry, BerElement **berout,
116 BerElement tmp, *ber;
118 int rc = LDAP_SUCCESS;
121 LDAP_LOG ( OPERATION, ENTRY, "ldap_get_dn_ber\n", 0, 0, 0 );
123 Debug( LDAP_DEBUG_TRACE, "ldap_get_dn_ber\n", 0, 0, 0 );
126 assert( ld != NULL );
127 assert( LDAP_VALID(ld) );
128 assert( entry != NULL );
129 assert( dn != NULL );
136 ber = ldap_alloc_ber_with_options( ld );
138 return LDAP_NO_MEMORY;
145 *ber = *entry->lm_ber; /* struct copy */
146 if ( ber_scanf( ber, "{ml{" /*}*/, dn, &len ) == LBER_ERROR ) {
147 rc = ld->ld_errno = LDAP_DECODING_ERROR;
149 if ( rc == LDAP_SUCCESS ) {
150 /* set the length to avoid overrun */
151 rc = ber_set_option( ber, LBER_OPT_REMAINING_BYTES, &len );
152 if( rc != LBER_OPT_SUCCESS ) {
153 rc = ld->ld_errno = LDAP_LOCAL_ERROR;
156 if ( rc != LDAP_SUCCESS && berout ) {
164 * RFC 1823 ldap_dn2ufn
167 ldap_dn2ufn( LDAP_CONST char *dn )
172 LDAP_LOG ( OPERATION, ENTRY, "ldap_dn2ufn\n", 0, 0, 0 );
174 Debug( LDAP_DEBUG_TRACE, "ldap_dn2ufn\n", 0, 0, 0 );
177 ( void )ldap_dn_normalize( dn, LDAP_DN_FORMAT_LDAP,
178 &out, LDAP_DN_FORMAT_UFN );
184 * RFC 1823 ldap_explode_dn
187 ldap_explode_dn( LDAP_CONST char *dn, int notypes )
190 char **values = NULL;
192 unsigned flag = notypes ? LDAP_DN_FORMAT_UFN : LDAP_DN_FORMAT_LDAPV3;
195 LDAP_LOG ( OPERATION, ENTRY, "ldap_explode_dn\n", 0, 0, 0 );
197 Debug( LDAP_DEBUG_TRACE, "ldap_explode_dn\n", 0, 0, 0 );
200 if ( ldap_str2dn( dn, &tmpDN, LDAP_DN_FORMAT_LDAP )
205 if( tmpDN == NULL ) {
206 values = LDAP_MALLOC( sizeof( char * ) );
207 if( values == NULL ) return NULL;
213 for ( iRDN = 0; tmpDN[ iRDN ]; iRDN++ );
215 values = LDAP_MALLOC( sizeof( char * ) * ( 1 + iRDN ) );
216 if ( values == NULL ) {
217 ldap_dnfree( tmpDN );
221 for ( iRDN = 0; tmpDN[ iRDN ]; iRDN++ ) {
222 ldap_rdn2str( tmpDN[ iRDN ], &values[ iRDN ], flag );
224 ldap_dnfree( tmpDN );
225 values[ iRDN ] = NULL;
231 ldap_explode_rdn( LDAP_CONST char *rdn, int notypes )
234 char **values = NULL;
239 LDAP_LOG ( OPERATION, ENTRY, "ldap_explode_rdn\n", 0, 0, 0 );
241 Debug( LDAP_DEBUG_TRACE, "ldap_explode_rdn\n", 0, 0, 0 );
245 * we only parse the first rdn
246 * FIXME: we prefer efficiency over checking if the _ENTIRE_
249 if ( ldap_str2rdn( rdn, &tmpRDN, (char **) &p, LDAP_DN_FORMAT_LDAP )
254 for ( iAVA = 0; tmpRDN[ iAVA ]; iAVA++ ) ;
255 values = LDAP_MALLOC( sizeof( char * ) * ( 1 + iAVA ) );
256 if ( values == NULL ) {
257 ldap_rdnfree( tmpRDN );
261 for ( iAVA = 0; tmpRDN[ iAVA ]; iAVA++ ) {
262 ber_len_t l = 0, vl, al = 0;
264 LDAPAVA *ava = tmpRDN[ iAVA ];
266 if ( ava->la_flags & LDAP_AVA_BINARY ) {
267 vl = 1 + 2 * ava->la_value.bv_len;
270 if ( strval2strlen( &ava->la_value,
271 ava->la_flags, &vl ) ) {
277 al = ava->la_attr.bv_len;
278 l = vl + ava->la_attr.bv_len + 1;
280 str = LDAP_MALLOC( l + 1 );
281 AC_MEMCPY( str, ava->la_attr.bv_val,
282 ava->la_attr.bv_len );
287 str = LDAP_MALLOC( l + 1 );
290 if ( ava->la_flags & LDAP_AVA_BINARY ) {
292 if ( binval2hexstr( &ava->la_value, &str[ al ] ) ) {
297 if ( strval2str( &ava->la_value, &str[ al ],
298 ava->la_flags, &vl ) ) {
304 values[ iAVA ] = str;
306 values[ iAVA ] = NULL;
308 ldap_rdnfree( tmpRDN );
313 LBER_VFREE( values );
314 ldap_rdnfree( tmpRDN );
319 ldap_dn2dcedn( LDAP_CONST char *dn )
324 LDAP_LOG ( OPERATION, ENTRY, "ldap_dn2dcedn\n", 0, 0, 0 );
326 Debug( LDAP_DEBUG_TRACE, "ldap_dn2dcedn\n", 0, 0, 0 );
329 ( void )ldap_dn_normalize( dn, LDAP_DN_FORMAT_LDAP,
330 &out, LDAP_DN_FORMAT_DCE );
336 ldap_dcedn2dn( LDAP_CONST char *dce )
341 LDAP_LOG ( OPERATION, ENTRY, "ldap_dcedn2dn\n", 0, 0, 0 );
343 Debug( LDAP_DEBUG_TRACE, "ldap_dcedn2dn\n", 0, 0, 0 );
346 ( void )ldap_dn_normalize( dce, LDAP_DN_FORMAT_DCE, &out, LDAP_DN_FORMAT_LDAPV3 );
352 ldap_dn2ad_canonical( LDAP_CONST char *dn )
357 LDAP_LOG ( OPERATION, ENTRY, "ldap_dn2ad_canonical\n", 0, 0, 0 );
359 Debug( LDAP_DEBUG_TRACE, "ldap_dn2ad_canonical\n", 0, 0, 0 );
362 ( void )ldap_dn_normalize( dn, LDAP_DN_FORMAT_LDAP,
363 &out, LDAP_DN_FORMAT_AD_CANONICAL );
369 * function that changes the string representation of dnin
370 * from ( fin & LDAP_DN_FORMAT_MASK ) to ( fout & LDAP_DN_FORMAT_MASK )
373 * LDAP_DN_FORMAT_LDAP (rfc 2253 and ldapbis liberal,
374 * plus some rfc 1779)
375 * LDAP_DN_FORMAT_LDAPV3 (rfc 2253 and ldapbis)
376 * LDAP_DN_FORMAT_LDAPV2 (rfc 1779)
377 * LDAP_DN_FORMAT_DCE (?)
379 * fout can be any of the above except
380 * LDAP_DN_FORMAT_LDAP
382 * LDAP_DN_FORMAT_UFN (rfc 1781, partial and with extensions)
383 * LDAP_DN_FORMAT_AD_CANONICAL (?)
386 ldap_dn_normalize( LDAP_CONST char *dnin,
387 unsigned fin, char **dnout, unsigned fout )
393 LDAP_LOG ( OPERATION, ENTRY, "ldap_dn_normalize\n", 0, 0, 0 );
395 Debug( LDAP_DEBUG_TRACE, "ldap_dn_normalize\n", 0, 0, 0 );
402 if ( dnin == NULL ) {
403 return( LDAP_SUCCESS );
406 rc = ldap_str2dn( dnin , &tmpDN, fin );
407 if ( rc != LDAP_SUCCESS ) {
411 rc = ldap_dn2str( tmpDN, dnout, fout );
413 ldap_dnfree( tmpDN );
421 /* #define B4ATTRTYPE 0x0001 */
422 #define B4OIDATTRTYPE 0x0002
423 #define B4STRINGATTRTYPE 0x0003
425 #define B4AVAEQUALS 0x0100
426 #define B4AVASEP 0x0200
427 #define B4RDNSEP 0x0300
428 #define GOTAVA 0x0400
430 #define B4ATTRVALUE 0x0010
431 #define B4STRINGVALUE 0x0020
432 #define B4IA5VALUEQUOTED 0x0030
433 #define B4IA5VALUE 0x0040
434 #define B4BINARYVALUE 0x0050
437 * Helpers (mostly from slap.h)
438 * c is assumed to Unicode in an ASCII compatible format (UTF-8)
439 * Macros assume "C" Locale (ASCII)
441 #define LDAP_DN_ASCII_SPACE(c) \
442 ( (c) == ' ' || (c) == '\t' || (c) == '\n' || (c) == '\r' )
443 #define LDAP_DN_ASCII_LOWER(c) LDAP_LOWER(c)
444 #define LDAP_DN_ASCII_UPPER(c) LDAP_UPPER(c)
445 #define LDAP_DN_ASCII_ALPHA(c) LDAP_ALPHA(c)
447 #define LDAP_DN_ASCII_DIGIT(c) LDAP_DIGIT(c)
448 #define LDAP_DN_ASCII_LCASE_HEXALPHA(c) LDAP_HEXLOWER(c)
449 #define LDAP_DN_ASCII_UCASE_HEXALPHA(c) LDAP_HEXUPPER(c)
450 #define LDAP_DN_ASCII_HEXDIGIT(c) LDAP_HEX(c)
451 #define LDAP_DN_ASCII_ALNUM(c) LDAP_ALNUM(c)
452 #define LDAP_DN_ASCII_PRINTABLE(c) ( (c) >= ' ' && (c) <= '~' )
455 #define LDAP_DN_OID_LEADCHAR(c) LDAP_DIGIT(c)
456 #define LDAP_DN_DESC_LEADCHAR(c) LDAP_ALPHA(c)
457 #define LDAP_DN_DESC_CHAR(c) LDAP_LDH(c)
458 #define LDAP_DN_LANG_SEP(c) ( (c) == ';' )
459 #define LDAP_DN_ATTRDESC_CHAR(c) \
460 ( LDAP_DN_DESC_CHAR(c) || LDAP_DN_LANG_SEP(c) )
462 /* special symbols */
463 #define LDAP_DN_AVA_EQUALS(c) ( (c) == '=' )
464 #define LDAP_DN_AVA_SEP(c) ( (c) == '+' )
465 #define LDAP_DN_RDN_SEP(c) ( (c) == ',' )
466 #define LDAP_DN_RDN_SEP_V2(c) ( LDAP_DN_RDN_SEP(c) || (c) == ';' )
467 #define LDAP_DN_OCTOTHORPE(c) ( (c) == '#' )
468 #define LDAP_DN_QUOTES(c) ( (c) == '\"' )
469 #define LDAP_DN_ESCAPE(c) ( (c) == '\\' )
470 #define LDAP_DN_VALUE_END(c) \
471 ( LDAP_DN_RDN_SEP(c) || LDAP_DN_AVA_SEP(c) )
473 /* NOTE: according to draft-ietf-ldapbis-dn, '=' can be escaped
474 * and treated as special, i.e. escaped both as "\<hexpair>" and
475 * as "\=", but it is treated as a regular char, i.e. it can also
478 * As such, we currently choose to allow reading unescaped '=',
479 * but we always produce escaped '\3D'; this may change in the
480 * future, if compatibility issues do not arise */
482 #define LDAP_DN_NE(c) \
483 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_SEP(c) \
484 || LDAP_DN_QUOTES(c) \
485 || (c) == '<' || (c) == '>' )
486 #define LDAP_DN_MAYESCAPE(c) \
487 ( LDAP_DN_ESCAPE(c) || LDAP_DN_NE(c) \
488 || LDAP_DN_AVA_EQUALS(c) \
489 || LDAP_DN_ASCII_SPACE(c) || LDAP_DN_OCTOTHORPE(c) )
490 #define LDAP_DN_SHOULDESCAPE(c) ( LDAP_DN_AVA_EQUALS(c) )
491 #else /* ! LDAP_DEVEL */
492 #define LDAP_DN_NE(c) \
493 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_SEP(c) \
494 || LDAP_DN_AVA_EQUALS(c) || LDAP_DN_QUOTES(c) \
495 || (c) == '<' || (c) == '>' )
496 #define LDAP_DN_MAYESCAPE(c) \
497 ( LDAP_DN_ESCAPE(c) || LDAP_DN_NE(c) \
498 || LDAP_DN_ASCII_SPACE(c) || LDAP_DN_OCTOTHORPE(c) )
499 #define LDAP_DN_SHOULDESCAPE(c) ( 0 )
500 #endif /* ! LDAP_DEVEL */
502 #define LDAP_DN_NEEDESCAPE(c) \
503 ( LDAP_DN_ESCAPE(c) || LDAP_DN_NE(c) )
504 #define LDAP_DN_NEEDESCAPE_LEAD(c) LDAP_DN_MAYESCAPE(c)
505 #define LDAP_DN_NEEDESCAPE_TRAIL(c) \
506 ( LDAP_DN_ASCII_SPACE(c) || LDAP_DN_NEEDESCAPE(c) )
507 #define LDAP_DN_WILLESCAPE_CHAR(c) \
508 ( LDAP_DN_RDN_SEP(c) || LDAP_DN_AVA_SEP(c) || LDAP_DN_ESCAPE(c) )
509 #define LDAP_DN_IS_PRETTY(f) ( (f) & LDAP_DN_PRETTY )
510 #define LDAP_DN_WILLESCAPE_HEX(f, c) \
511 ( ( !LDAP_DN_IS_PRETTY( f ) ) && LDAP_DN_WILLESCAPE_CHAR(c) )
514 #define LDAP_DN_VALUE_END_V2(c) \
515 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_SEP(c) )
517 #define LDAP_DN_V2_SPECIAL(c) \
518 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_EQUALS(c) \
519 || LDAP_DN_AVA_SEP(c) || (c) == '<' || (c) == '>' \
520 || LDAP_DN_OCTOTHORPE(c) )
521 #define LDAP_DN_V2_PAIR(c) \
522 ( LDAP_DN_V2_SPECIAL(c) || LDAP_DN_ESCAPE(c) || LDAP_DN_QUOTES(c) )
525 * DCE (mostly from Luke Howard and IBM implementation for AIX)
527 * From: "Application Development Guide - Directory Services" (FIXME: add link?)
528 * Here escapes and valid chars for GDS are considered; as soon as more
529 * specific info is found, the macros will be updated.
531 * Chars: 'a'-'z', 'A'-'Z', '0'-'9',
532 * '.', ':', ',', ''', '+', '-', '=', '(', ')', '?', '/', ' '.
534 * Metachars: '/', ',', '=', '\'.
536 * the '\' is used to escape other metachars.
542 * Attribute types must start with alphabetic chars and can contain
543 * alphabetic chars and digits (FIXME: no '-'?). OIDs are allowed.
545 #define LDAP_DN_RDN_SEP_DCE(c) ( (c) == '/' )
546 #define LDAP_DN_AVA_SEP_DCE(c) ( (c) == ',' )
547 #define LDAP_DN_ESCAPE_DCE(c) ( LDAP_DN_ESCAPE(c) )
548 #define LDAP_DN_VALUE_END_DCE(c) \
549 ( LDAP_DN_RDN_SEP_DCE(c) || LDAP_DN_AVA_SEP_DCE(c) )
550 #define LDAP_DN_NEEDESCAPE_DCE(c) \
551 ( LDAP_DN_VALUE_END_DCE(c) || LDAP_DN_AVA_EQUALS(c) )
554 #define LDAP_DN_RDN_SEP_AD(c) ( (c) == '/' )
555 #define LDAP_DN_ESCAPE_AD(c) ( LDAP_DN_ESCAPE(c) )
556 #define LDAP_DN_AVA_SEP_AD(c) ( (c) == ',' ) /* assume same as DCE */
557 #define LDAP_DN_VALUE_END_AD(c) \
558 ( LDAP_DN_RDN_SEP_AD(c) || LDAP_DN_AVA_SEP_AD(c) )
559 #define LDAP_DN_NEEDESCAPE_AD(c) \
560 ( LDAP_DN_VALUE_END_AD(c) || LDAP_DN_AVA_EQUALS(c) )
563 #define LDAP_DN_HEXPAIR(s) \
564 ( LDAP_DN_ASCII_HEXDIGIT((s)[0]) && LDAP_DN_ASCII_HEXDIGIT((s)[1]) )
565 /* better look at the AttributeDescription? */
567 /* FIXME: no composite rdn or non-"dc" types, right?
568 * (what about "dc" in OID form?) */
569 /* FIXME: we do not allow binary values in domain, right? */
570 /* NOTE: use this macro only when ABSOLUTELY SURE rdn IS VALID! */
571 /* NOTE: don't use strcasecmp() as it is locale specific! */
572 #define LDAP_DC_ATTR "dc"
573 #define LDAP_DC_ATTRU "DC"
574 #define LDAP_DN_IS_RDN_DC( r ) \
575 ( (r) && (r)[0] && !(r)[1] \
576 && ((r)[0]->la_flags & LDAP_AVA_STRING) \
577 && ((r)[0]->la_attr.bv_len == 2) \
578 && (((r)[0]->la_attr.bv_val[0] == LDAP_DC_ATTR[0]) \
579 || ((r)[0]->la_attr.bv_val[0] == LDAP_DC_ATTRU[0])) \
580 && (((r)[0]->la_attr.bv_val[1] == LDAP_DC_ATTR[1]) \
581 || ((r)[0]->la_attr.bv_val[1] == LDAP_DC_ATTRU[1])))
583 /* Composite rules */
584 #define LDAP_DN_ALLOW_ONE_SPACE(f) \
585 ( LDAP_DN_LDAPV2(f) \
586 || !( (f) & LDAP_DN_P_NOSPACEAFTERRDN ) )
587 #define LDAP_DN_ALLOW_SPACES(f) \
588 ( LDAP_DN_LDAPV2(f) \
589 || !( (f) & ( LDAP_DN_P_NOLEADTRAILSPACES | LDAP_DN_P_NOSPACEAFTERRDN ) ) )
590 #define LDAP_DN_LDAP(f) \
591 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_LDAP )
592 #define LDAP_DN_LDAPV3(f) \
593 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_LDAPV3 )
594 #define LDAP_DN_LDAPV2(f) \
595 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_LDAPV2 )
596 #define LDAP_DN_DCE(f) \
597 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_DCE )
598 #define LDAP_DN_UFN(f) \
599 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_UFN )
600 #define LDAP_DN_ADC(f) \
601 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_AD_CANONICAL )
602 #define LDAP_DN_FORMAT(f) ( (f) & LDAP_DN_FORMAT_MASK )
605 * LDAPAVA helpers (will become part of the API for operations
606 * on structural representations of DNs).
609 ldapava_new( const struct berval *attr, const struct berval *val,
610 unsigned flags, void *ctx )
617 ava = LDAP_MALLOCX( sizeof( LDAPAVA ) + attr->bv_len + 1, ctx );
620 ava->la_attr.bv_len = attr->bv_len;
621 ava->la_attr.bv_val = (char *)(ava+1);
622 AC_MEMCPY( ava->la_attr.bv_val, attr->bv_val, attr->bv_len );
623 ava->la_attr.bv_val[attr->bv_len] = '\0';
625 ava->la_value = *val;
626 ava->la_flags = flags | LDAP_AVA_FREE_VALUE;
628 ava->la_private = NULL;
635 ldapava_free( LDAPAVA *ava, void *ctx )
640 /* ava's private must be freed by caller
641 * (at present let's skip this check because la_private
642 * basically holds static data) */
643 assert( ava->la_private == NULL );
646 if (ava->la_flags & LDAP_AVA_FREE_VALUE)
647 LDAP_FREEX( ava->la_value.bv_val, ctx );
649 LDAP_FREEX( ava, ctx );
653 ldap_rdnfree( LDAPRDN rdn )
655 ldap_rdnfree_x( rdn, NULL );
659 ldap_rdnfree_x( LDAPRDN rdn, void *ctx )
667 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
668 ldapava_free( rdn[ iAVA ], ctx );
671 LDAP_FREEX( rdn, ctx );
675 ldap_dnfree( LDAPDN dn )
677 ldap_dnfree_x( dn, NULL );
681 ldap_dnfree_x( LDAPDN dn, void *ctx )
689 for ( iRDN = 0; dn[ iRDN ]; iRDN++ ) {
690 ldap_rdnfree_x( dn[ iRDN ], ctx );
693 LDAP_FREEX( dn, ctx );
697 * Converts a string representation of a DN (in LDAPv3, LDAPv2 or DCE)
698 * into a structural representation of the DN, by separating attribute
699 * types and values encoded in the more appropriate form, which is
700 * string or OID for attribute types and binary form of the BER encoded
701 * value or Unicode string. Formats different from LDAPv3 are parsed
702 * according to their own rules and turned into the more appropriate
703 * form according to LDAPv3.
705 * NOTE: I realize the code is getting spaghettish; it is rather
706 * experimental and will hopefully turn into something more simple
707 * and readable as soon as it works as expected.
711 * Default sizes of AVA and RDN static working arrays; if required
712 * the are dynamically resized. The values can be tuned in case
713 * of special requirements (e.g. very deep DN trees or high number
716 #define TMP_AVA_SLOTS 8
717 #define TMP_RDN_SLOTS 32
720 ldap_str2dn( LDAP_CONST char *str, LDAPDN *dn, unsigned flags )
726 bv.bv_len = strlen( str );
727 bv.bv_val = (char *) str;
729 return ldap_bv2dn_x( &bv, dn, flags, NULL );
733 ldap_bv2dn( struct berval *bv, LDAPDN *dn, unsigned flags )
735 return ldap_bv2dn_x( bv, dn, flags, NULL );
739 ldap_bv2dn_x( struct berval *bv, LDAPDN *dn, unsigned flags, void *ctx )
742 int rc = LDAP_DECODING_ERROR;
746 LDAPRDN newRDN = NULL, tmpDN_[TMP_RDN_SLOTS], *tmpDN = tmpDN_;
747 int num_slots = TMP_RDN_SLOTS;
748 char *str = bv->bv_val;
749 char *end = str + bv->bv_len;
752 assert( bv->bv_val );
756 LDAP_LOG ( OPERATION, ARGS, "ldap_bv2dn(%s,%u)\n", str, flags, 0 );
758 Debug( LDAP_DEBUG_TRACE, "=> ldap_bv2dn(%s,%u)\n", str, flags, 0 );
763 switch ( LDAP_DN_FORMAT( flags ) ) {
764 case LDAP_DN_FORMAT_LDAP:
765 case LDAP_DN_FORMAT_LDAPV3:
766 case LDAP_DN_FORMAT_LDAPV2:
767 case LDAP_DN_FORMAT_DCE:
770 /* unsupported in str2dn */
771 case LDAP_DN_FORMAT_UFN:
772 case LDAP_DN_FORMAT_AD_CANONICAL:
773 return LDAP_PARAM_ERROR;
775 case LDAP_DN_FORMAT_LBER:
777 return LDAP_PARAM_ERROR;
780 if ( bv->bv_len == 0 ) {
784 if( memchr( bv->bv_val, '\0', bv->bv_len ) != NULL ) {
785 /* value must have embedded NULs */
786 return LDAP_DECODING_ERROR;
790 if ( LDAP_DN_DCE( flags ) ) {
793 * (from Luke Howard: thnx) A RDN separator is required
794 * at the beginning of an (absolute) DN.
796 if ( !LDAP_DN_RDN_SEP_DCE( p[ 0 ] ) ) {
802 * actually we do not want to accept by default the DCE form,
803 * we do not want to auto-detect it
806 } else if ( LDAP_DN_LDAP( flags ) ) {
808 * if dn starts with '/' let's make it a DCE dn
810 if ( LDAP_DN_RDN_SEP_DCE( p[ 0 ] ) ) {
811 flags |= LDAP_DN_FORMAT_DCE;
817 for ( ; p < end; p++ ) {
820 tmpbv.bv_len = bv->bv_len - ( p - str );
821 tmpbv.bv_val = (char *)p;
823 err = ldap_bv2rdn_x( &tmpbv, &newRDN, (char **) &p, flags,ctx);
824 if ( err != LDAP_SUCCESS ) {
829 * We expect a rdn separator
831 if ( p < end && p[ 0 ] ) {
832 switch ( LDAP_DN_FORMAT( flags ) ) {
833 case LDAP_DN_FORMAT_LDAPV3:
834 if ( !LDAP_DN_RDN_SEP( p[ 0 ] ) ) {
835 rc = LDAP_DECODING_ERROR;
840 case LDAP_DN_FORMAT_LDAP:
841 case LDAP_DN_FORMAT_LDAPV2:
842 if ( !LDAP_DN_RDN_SEP_V2( p[ 0 ] ) ) {
843 rc = LDAP_DECODING_ERROR;
848 case LDAP_DN_FORMAT_DCE:
849 if ( !LDAP_DN_RDN_SEP_DCE( p[ 0 ] ) ) {
850 rc = LDAP_DECODING_ERROR;
858 tmpDN[nrdns++] = newRDN;
862 * make the static RDN array dynamically rescalable
864 if ( nrdns == num_slots ) {
867 if ( tmpDN == tmpDN_ ) {
868 tmp = LDAP_MALLOCX( num_slots * 2 * sizeof( LDAPRDN * ), ctx );
873 AC_MEMCPY( tmp, tmpDN, num_slots * sizeof( LDAPRDN * ) );
876 tmp = LDAP_REALLOCX( tmpDN, num_slots * 2 * sizeof( LDAPRDN * ), ctx );
887 if ( p >= end || p[ 0 ] == '\0' ) {
889 * the DN is over, phew
891 newDN = (LDAPDN)LDAP_MALLOCX( sizeof(LDAPRDN *) * (nrdns+1), ctx );
892 if ( newDN == NULL ) {
898 if ( LDAP_DN_DCE( flags ) ) {
899 /* add in reversed order */
900 for ( i=0; i<nrdns; i++ )
901 newDN[i] = tmpDN[nrdns-1-i];
903 for ( i=0; i<nrdns; i++ )
915 ldap_rdnfree_x( newRDN, ctx );
918 for ( nrdns-- ;nrdns >= 0; nrdns-- ) {
919 ldap_rdnfree_x( tmpDN[nrdns], ctx );
924 if ( tmpDN != tmpDN_ ) {
925 LDAP_FREEX( tmpDN, ctx );
929 LDAP_LOG ( OPERATION, RESULTS, "<= ldap_bv2dn(%s)=%d %s\n",
930 str, rc, ldap_err2string( rc ) );
932 Debug( LDAP_DEBUG_TRACE, "<= ldap_bv2dn(%s)=%d %s\n", str, rc,
933 ldap_err2string( rc ) );
943 * Parses a relative DN according to flags up to a rdn separator
944 * or to the end of str.
945 * Returns the rdn and a pointer to the string continuation, which
946 * corresponds to the rdn separator or to '\0' in case the string is over.
949 ldap_str2rdn( LDAP_CONST char *str, LDAPRDN *rdn,
950 char **n_in, unsigned flags )
955 assert( str[ 0 ] != '\0' ); /* FIXME: is this required? */
957 bv.bv_len = strlen( str );
958 bv.bv_val = (char *) str;
960 return ldap_bv2rdn_x( &bv, rdn, n_in, flags, NULL );
964 ldap_bv2rdn( struct berval *bv, LDAPRDN *rdn,
965 char **n_in, unsigned flags )
967 return ldap_bv2rdn_x( bv, rdn, n_in, flags, NULL );
971 ldap_bv2rdn_x( struct berval *bv, LDAPRDN *rdn,
972 char **n_in, unsigned flags, void *ctx )
974 const char **n = (const char **) n_in;
978 int rc = LDAP_DECODING_ERROR;
979 int attrTypeEncoding = LDAP_AVA_STRING,
980 attrValueEncoding = LDAP_AVA_STRING;
982 struct berval attrType = BER_BVNULL;
983 struct berval attrValue = BER_BVNULL;
985 LDAPRDN newRDN = NULL;
986 LDAPAVA *tmpRDN_[TMP_AVA_SLOTS], **tmpRDN = tmpRDN_;
987 int num_slots = TMP_AVA_SLOTS;
993 assert( bv->bv_len );
994 assert( bv->bv_val );
995 assert( rdn || flags & LDAP_DN_SKIP );
999 stoplen = bv->bv_len;
1006 switch ( LDAP_DN_FORMAT( flags ) ) {
1007 case LDAP_DN_FORMAT_LDAP:
1008 case LDAP_DN_FORMAT_LDAPV3:
1009 case LDAP_DN_FORMAT_LDAPV2:
1010 case LDAP_DN_FORMAT_DCE:
1013 /* unsupported in str2dn */
1014 case LDAP_DN_FORMAT_UFN:
1015 case LDAP_DN_FORMAT_AD_CANONICAL:
1016 return LDAP_PARAM_ERROR;
1018 case LDAP_DN_FORMAT_LBER:
1020 return LDAP_PARAM_ERROR;
1023 if ( bv->bv_len == 0 ) {
1024 return LDAP_SUCCESS;
1028 if( memchr( bv->bv_val, '\0', bv->bv_len ) != NULL ) {
1029 /* value must have embedded NULs */
1030 return LDAP_DECODING_ERROR;
1034 for ( ; p[ 0 ] || state == GOTAVA; ) {
1037 * The parser in principle advances one token a time,
1038 * or toggles state if preferable.
1043 * an AttributeType can be encoded as:
1044 * - its string representation; in detail, implementations
1045 * MUST recognize AttributeType string type names listed
1046 * in section 2.3 of draft-ietf-ldapbis-dn-XX.txt, and
1047 * MAY recognize other names.
1048 * - its numeric OID (a dotted decimal string); in detail
1049 * RFC 2253 asserts that ``Implementations MUST allow
1050 * an oid in the attribute type to be prefixed by one
1051 * of the character strings "oid." or "OID."''. As soon
1052 * as draft-ietf-ldapbis-dn-XX.txt obsoletes RFC 2253
1053 * I'm not sure whether this is required or not any
1054 * longer; to be liberal, we still implement it.
1057 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1058 if ( !LDAP_DN_ALLOW_ONE_SPACE( flags ) ) {
1065 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1066 if ( !LDAP_DN_ALLOW_SPACES( flags ) ) {
1071 /* whitespace is allowed (and trimmed) */
1073 while ( p[ 0 ] && LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1078 /* error: we expected an AVA */
1084 if ( LDAP_DN_OID_LEADCHAR( p[ 0 ] ) ) {
1085 state = B4OIDATTRTYPE;
1089 /* else must be alpha */
1090 if ( !LDAP_DN_DESC_LEADCHAR( p[ 0 ] ) ) {
1094 /* LDAPv2 "oid." prefix */
1095 if ( LDAP_DN_LDAPV2( flags ) ) {
1097 * to be overly pedantic, we only accept
1100 if ( flags & LDAP_DN_PEDANTIC ) {
1101 if ( !strncmp( p, "OID.", 4 )
1102 || !strncmp( p, "oid.", 4 ) ) {
1104 state = B4OIDATTRTYPE;
1108 if ( !strncasecmp( p, "oid.", 4 ) ) {
1110 state = B4OIDATTRTYPE;
1116 state = B4STRINGATTRTYPE;
1119 case B4OIDATTRTYPE: {
1120 int err = LDAP_SUCCESS;
1122 attrType.bv_val = ldap_int_parse_numericoid( &p, &err,
1125 if ( err != LDAP_SUCCESS ) {
1128 attrType.bv_len = p - attrType.bv_val;
1130 attrTypeEncoding = LDAP_AVA_BINARY;
1132 state = B4AVAEQUALS;
1136 case B4STRINGATTRTYPE: {
1137 const char *startPos, *endPos = NULL;
1141 * the starting char has been found to be
1142 * a LDAP_DN_DESC_LEADCHAR so we don't re-check it
1143 * FIXME: DCE attr types seem to have a more
1144 * restrictive syntax (no '-' ...)
1146 for ( startPos = p++; p[ 0 ]; p++ ) {
1147 if ( LDAP_DN_DESC_CHAR( p[ 0 ] ) ) {
1151 if ( LDAP_DN_LANG_SEP( p[ 0 ] ) ) {
1154 * RFC 2253 does not explicitly
1155 * allow lang extensions to attribute
1158 if ( flags & LDAP_DN_PEDANTIC ) {
1163 * we trim ';' and following lang
1164 * and so from attribute types
1167 for ( ; LDAP_DN_ATTRDESC_CHAR( p[ 0 ] )
1168 || LDAP_DN_LANG_SEP( p[ 0 ] ); p++ ) {
1176 len = ( endPos ? endPos : p ) - startPos;
1181 attrTypeEncoding = LDAP_AVA_STRING;
1184 * here we need to decide whether to use it as is
1185 * or turn it in OID form; as a consequence, we
1186 * need to decide whether to binary encode the value
1189 state = B4AVAEQUALS;
1191 if ( flags & LDAP_DN_SKIP ) {
1195 attrType.bv_val = (char *)startPos;
1196 attrType.bv_len = len;
1202 /* spaces may not be allowed */
1203 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1204 if ( !LDAP_DN_ALLOW_SPACES( flags ) ) {
1209 for ( p++; LDAP_DN_ASCII_SPACE( p[ 0 ] ); p++ ) {
1214 /* need equal sign */
1215 if ( !LDAP_DN_AVA_EQUALS( p[ 0 ] ) ) {
1220 /* spaces may not be allowed */
1221 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1222 if ( !LDAP_DN_ALLOW_SPACES( flags ) ) {
1227 for ( p++; LDAP_DN_ASCII_SPACE( p[ 0 ] ); p++ ) {
1233 * octothorpe means a BER encoded value will follow
1234 * FIXME: I don't think DCE will allow it
1236 if ( LDAP_DN_OCTOTHORPE( p[ 0 ] ) ) {
1238 attrValueEncoding = LDAP_AVA_BINARY;
1239 state = B4BINARYVALUE;
1243 /* STRING value expected */
1246 * if we're pedantic, an attribute type in OID form
1247 * SHOULD imply a BER encoded attribute value; we
1248 * should at least issue a warning
1250 if ( ( flags & LDAP_DN_PEDANTIC )
1251 && ( attrTypeEncoding == LDAP_AVA_BINARY ) ) {
1252 /* OID attrType SHOULD use binary encoding */
1256 attrValueEncoding = LDAP_AVA_STRING;
1259 * LDAPv2 allows the attribute value to be quoted;
1260 * also, IA5 values are expected, in principle
1262 if ( LDAP_DN_LDAPV2( flags ) || LDAP_DN_LDAP( flags ) ) {
1263 if ( LDAP_DN_QUOTES( p[ 0 ] ) ) {
1265 state = B4IA5VALUEQUOTED;
1269 if ( LDAP_DN_LDAPV2( flags ) ) {
1276 * here STRING means RFC 2253 string
1277 * FIXME: what about DCE strings?
1283 state = B4STRINGVALUE;
1288 if ( hexstr2binval( p, &attrValue, &p, flags, ctx ) ) {
1296 switch ( LDAP_DN_FORMAT( flags ) ) {
1297 case LDAP_DN_FORMAT_LDAP:
1298 case LDAP_DN_FORMAT_LDAPV3:
1299 if ( str2strval( p, stoplen - ( p - str ),
1300 &attrValue, &p, flags,
1301 &attrValueEncoding, ctx ) ) {
1306 case LDAP_DN_FORMAT_DCE:
1307 if ( DCE2strval( p, &attrValue, &p, flags, ctx ) ) {
1320 if ( IA52strval( p, &attrValue, &p, flags, ctx ) ) {
1327 case B4IA5VALUEQUOTED:
1329 /* lead quote already stripped */
1330 if ( quotedIA52strval( p, &attrValue,
1331 &p, flags, ctx ) ) {
1341 if ( !( flags & LDAP_DN_SKIP ) ) {
1345 * we accept empty values
1347 ava = ldapava_new( &attrType, &attrValue,
1348 attrValueEncoding, ctx );
1349 if ( ava == NULL ) {
1350 rc = LDAP_NO_MEMORY;
1353 tmpRDN[navas++] = ava;
1355 attrValue.bv_val = NULL;
1356 attrValue.bv_len = 0;
1359 * prepare room for new AVAs if needed
1361 if (navas == num_slots) {
1364 if ( tmpRDN == tmpRDN_ ) {
1365 tmp = LDAP_MALLOCX( num_slots * 2 * sizeof( LDAPAVA * ), ctx );
1366 if ( tmp == NULL ) {
1367 rc = LDAP_NO_MEMORY;
1370 AC_MEMCPY( tmp, tmpRDN, num_slots * sizeof( LDAPAVA * ) );
1373 tmp = LDAP_REALLOCX( tmpRDN, num_slots * 2 * sizeof( LDAPAVA * ), ctx );
1374 if ( tmp == NULL ) {
1375 rc = LDAP_NO_MEMORY;
1386 * if we got an AVA separator ('+', or ',' for DCE )
1387 * we expect a new AVA for this RDN; otherwise
1388 * we add the RDN to the DN
1390 switch ( LDAP_DN_FORMAT( flags ) ) {
1391 case LDAP_DN_FORMAT_LDAP:
1392 case LDAP_DN_FORMAT_LDAPV3:
1393 case LDAP_DN_FORMAT_LDAPV2:
1394 if ( !LDAP_DN_AVA_SEP( p[ 0 ] ) ) {
1399 case LDAP_DN_FORMAT_DCE:
1400 if ( !LDAP_DN_AVA_SEP_DCE( p[ 0 ] ) ) {
1408 * the RDN is over, phew
1411 if ( !( flags & LDAP_DN_SKIP ) ) {
1412 newRDN = (LDAPRDN)LDAP_MALLOCX(
1413 sizeof(LDAPAVA) * (navas+1), ctx );
1414 if ( newRDN == NULL ) {
1415 rc = LDAP_NO_MEMORY;
1418 AC_MEMCPY( newRDN, tmpRDN, sizeof(LDAPAVA *) * navas);
1419 newRDN[navas] = NULL;
1427 /* they should have been used in an AVA */
1428 attrType.bv_val = NULL;
1429 attrValue.bv_val = NULL;
1444 /* They are set to NULL after they're used in an AVA */
1446 if ( attrValue.bv_val ) {
1447 LDAP_FREEX( attrValue.bv_val, ctx );
1450 for ( navas-- ; navas >= 0; navas-- ) {
1451 ldapava_free( tmpRDN[navas], ctx );
1456 if ( tmpRDN != tmpRDN_ ) {
1457 LDAP_FREEX( tmpRDN, ctx );
1468 * reads in a UTF-8 string value, unescaping stuff:
1469 * '\' + LDAP_DN_NEEDESCAPE(c) -> 'c'
1470 * '\' + HEXPAIR(p) -> unhex(p)
1473 str2strval( const char *str, ber_len_t stoplen, struct berval *val, const char **next, unsigned flags, int *retFlags, void *ctx )
1475 const char *p, *end, *startPos, *endPos = NULL;
1476 ber_len_t len, escapes;
1483 end = str + stoplen;
1484 for ( startPos = p = str, escapes = 0; p < end; p++ ) {
1485 if ( LDAP_DN_ESCAPE( p[ 0 ] ) ) {
1487 if ( p[ 0 ] == '\0' ) {
1490 if ( LDAP_DN_MAYESCAPE( p[ 0 ] ) ) {
1495 if ( LDAP_DN_HEXPAIR( p ) ) {
1498 hexstr2bin( p, &c );
1501 if ( !LDAP_DN_ASCII_PRINTABLE( c ) ) {
1504 * we assume the string is UTF-8
1506 *retFlags = LDAP_AVA_NONPRINTABLE;
1513 if ( LDAP_DN_PEDANTIC & flags ) {
1517 * we do not allow escaping
1518 * of chars that don't need
1519 * to and do not belong to
1524 } else if ( !LDAP_DN_ASCII_PRINTABLE( p[ 0 ] ) ) {
1525 if ( p[ 0 ] == '\0' ) {
1528 *retFlags = LDAP_AVA_NONPRINTABLE;
1530 } else if ( ( LDAP_DN_LDAP( flags ) && LDAP_DN_VALUE_END_V2( p[ 0 ] ) )
1531 || ( LDAP_DN_LDAPV3( flags ) && LDAP_DN_VALUE_END( p[ 0 ] ) ) ) {
1534 } else if ( LDAP_DN_NEEDESCAPE( p[ 0 ] ) ) {
1536 * FIXME: maybe we can add
1537 * escapes if not pedantic?
1544 * we do allow unescaped spaces at the end
1545 * of the value only in non-pedantic mode
1547 if ( p > startPos + 1 && LDAP_DN_ASCII_SPACE( p[ -1 ] ) &&
1548 !LDAP_DN_ESCAPE( p[ -2 ] ) ) {
1549 if ( flags & LDAP_DN_PEDANTIC ) {
1553 /* strip trailing (unescaped) spaces */
1554 for ( endPos = p - 1;
1555 endPos > startPos + 1 &&
1556 LDAP_DN_ASCII_SPACE( endPos[ -1 ] ) &&
1557 !LDAP_DN_ESCAPE( endPos[ -2 ] );
1564 if ( flags & LDAP_DN_SKIP ) {
1569 * FIXME: test memory?
1571 len = ( endPos ? endPos : p ) - startPos - escapes;
1574 if ( escapes == 0 ) {
1575 if ( *retFlags & LDAP_AVA_NONPRINTABLE ) {
1576 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1577 AC_MEMCPY( val->bv_val, startPos, len );
1578 val->bv_val[ len ] = '\0';
1580 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1586 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1587 for ( s = 0, d = 0; d < len; ) {
1588 if ( LDAP_DN_ESCAPE( startPos[ s ] ) ) {
1590 if ( LDAP_DN_MAYESCAPE( startPos[ s ] ) ) {
1591 val->bv_val[ d++ ] =
1594 } else if ( LDAP_DN_HEXPAIR( &startPos[ s ] ) ) {
1597 hexstr2bin( &startPos[ s ], &c );
1598 val->bv_val[ d++ ] = c;
1602 /* we should never get here */
1607 val->bv_val[ d++ ] = startPos[ s++ ];
1611 val->bv_val[ d ] = '\0';
1619 DCE2strval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1621 const char *p, *startPos, *endPos = NULL;
1622 ber_len_t len, escapes;
1630 for ( startPos = p = str, escapes = 0; p[ 0 ]; p++ ) {
1631 if ( LDAP_DN_ESCAPE_DCE( p[ 0 ] ) ) {
1633 if ( LDAP_DN_NEEDESCAPE_DCE( p[ 0 ] ) ) {
1640 } else if ( LDAP_DN_VALUE_END_DCE( p[ 0 ] ) ) {
1645 * FIXME: can we accept anything else? I guess we need
1646 * to stop if a value is not legal
1651 * (unescaped) trailing spaces are trimmed must be silently ignored;
1654 if ( p > startPos + 1 && LDAP_DN_ASCII_SPACE( p[ -1 ] ) &&
1655 !LDAP_DN_ESCAPE( p[ -2 ] ) ) {
1656 if ( flags & LDAP_DN_PEDANTIC ) {
1660 /* strip trailing (unescaped) spaces */
1661 for ( endPos = p - 1;
1662 endPos > startPos + 1 &&
1663 LDAP_DN_ASCII_SPACE( endPos[ -1 ] ) &&
1664 !LDAP_DN_ESCAPE( endPos[ -2 ] );
1671 if ( flags & LDAP_DN_SKIP ) {
1675 len = ( endPos ? endPos : p ) - startPos - escapes;
1677 if ( escapes == 0 ){
1678 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1683 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1684 for ( s = 0, d = 0; d < len; ) {
1686 * This point is reached only if escapes
1687 * are properly used, so all we need to
1690 if ( LDAP_DN_ESCAPE_DCE( startPos[ s ] ) ) {
1694 val->bv_val[ d++ ] = startPos[ s++ ];
1696 val->bv_val[ d ] = '\0';
1697 assert( strlen( val->bv_val ) == len );
1704 IA52strval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1706 const char *p, *startPos, *endPos = NULL;
1707 ber_len_t len, escapes;
1719 for ( startPos = p = str, escapes = 0; p[ 0 ]; p++ ) {
1720 if ( LDAP_DN_ESCAPE( p[ 0 ] ) ) {
1722 if ( p[ 0 ] == '\0' ) {
1726 if ( !LDAP_DN_NEEDESCAPE( p[ 0 ] )
1727 && ( LDAP_DN_PEDANTIC & flags ) ) {
1732 } else if ( LDAP_DN_VALUE_END_V2( p[ 0 ] ) ) {
1737 * FIXME: can we accept anything else? I guess we need
1738 * to stop if a value is not legal
1742 /* strip trailing (unescaped) spaces */
1744 endPos > startPos + 1 &&
1745 LDAP_DN_ASCII_SPACE( endPos[ -1 ] ) &&
1746 !LDAP_DN_ESCAPE( endPos[ -2 ] );
1752 if ( flags & LDAP_DN_SKIP ) {
1756 len = ( endPos ? endPos : p ) - startPos - escapes;
1758 if ( escapes == 0 ) {
1759 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1764 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1765 for ( s = 0, d = 0; d < len; ) {
1766 if ( LDAP_DN_ESCAPE( startPos[ s ] ) ) {
1769 val->bv_val[ d++ ] = startPos[ s++ ];
1771 val->bv_val[ d ] = '\0';
1772 assert( strlen( val->bv_val ) == len );
1779 quotedIA52strval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1781 const char *p, *startPos, *endPos = NULL;
1783 unsigned escapes = 0;
1791 /* initial quote already eaten */
1792 for ( startPos = p = str; p[ 0 ]; p++ ) {
1794 * According to RFC 1779, the quoted value can
1795 * contain escaped as well as unescaped special values;
1796 * as a consequence we tolerate escaped values
1797 * (e.g. '"\,"' -> '\,') and escape unescaped specials
1798 * (e.g. '","' -> '\,').
1800 if ( LDAP_DN_ESCAPE( p[ 0 ] ) ) {
1801 if ( p[ 1 ] == '\0' ) {
1806 if ( !LDAP_DN_V2_PAIR( p[ 0 ] )
1807 && ( LDAP_DN_PEDANTIC & flags ) ) {
1809 * do we allow to escape normal chars?
1810 * LDAPv2 does not allow any mechanism
1811 * for escaping chars with '\' and hex
1818 } else if ( LDAP_DN_QUOTES( p[ 0 ] ) ) {
1820 /* eat closing quotes */
1826 * FIXME: can we accept anything else? I guess we need
1827 * to stop if a value is not legal
1831 if ( endPos == NULL ) {
1835 /* Strip trailing (unescaped) spaces */
1836 for ( ; p[ 0 ] && LDAP_DN_ASCII_SPACE( p[ 0 ] ); p++ ) {
1841 if ( flags & LDAP_DN_SKIP ) {
1845 len = endPos - startPos - escapes;
1846 assert( endPos >= startPos + escapes );
1848 if ( escapes == 0 ) {
1849 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1854 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1857 for ( s = d = 0; d < len; ) {
1858 if ( LDAP_DN_ESCAPE( str[ s ] ) ) {
1861 val->bv_val[ d++ ] = str[ s++ ];
1863 val->bv_val[ d ] = '\0';
1864 assert( strlen( val->bv_val ) == len );
1871 hexstr2bin( const char *str, char *c )
1881 if ( LDAP_DN_ASCII_DIGIT( c1 ) ) {
1885 if ( LDAP_DN_ASCII_UCASE_HEXALPHA( c1 ) ) {
1888 assert( LDAP_DN_ASCII_LCASE_HEXALPHA( c1 ) );
1895 if ( LDAP_DN_ASCII_DIGIT( c2 ) ) {
1899 if ( LDAP_DN_ASCII_UCASE_HEXALPHA( c2 ) ) {
1900 *c += c2 - 'A' + 10;
1902 assert( LDAP_DN_ASCII_LCASE_HEXALPHA( c2 ) );
1903 *c += c2 - 'a' + 10;
1911 hexstr2binval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1913 const char *p, *startPos, *endPos = NULL;
1923 for ( startPos = p = str; p[ 0 ]; p += 2 ) {
1924 switch ( LDAP_DN_FORMAT( flags ) ) {
1925 case LDAP_DN_FORMAT_LDAPV3:
1926 if ( LDAP_DN_VALUE_END( p[ 0 ] ) ) {
1931 case LDAP_DN_FORMAT_LDAP:
1932 case LDAP_DN_FORMAT_LDAPV2:
1933 if ( LDAP_DN_VALUE_END_V2( p[ 0 ] ) ) {
1938 case LDAP_DN_FORMAT_DCE:
1939 if ( LDAP_DN_VALUE_END_DCE( p[ 0 ] ) ) {
1945 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1946 if ( flags & LDAP_DN_PEDANTIC ) {
1951 for ( ; p[ 0 ]; p++ ) {
1952 switch ( LDAP_DN_FORMAT( flags ) ) {
1953 case LDAP_DN_FORMAT_LDAPV3:
1954 if ( LDAP_DN_VALUE_END( p[ 0 ] ) ) {
1959 case LDAP_DN_FORMAT_LDAP:
1960 case LDAP_DN_FORMAT_LDAPV2:
1961 if ( LDAP_DN_VALUE_END_V2( p[ 0 ] ) ) {
1966 case LDAP_DN_FORMAT_DCE:
1967 if ( LDAP_DN_VALUE_END_DCE( p[ 0 ] ) ) {
1976 if ( !LDAP_DN_HEXPAIR( p ) ) {
1984 if ( flags & LDAP_DN_SKIP ) {
1988 len = ( ( endPos ? endPos : p ) - startPos ) / 2;
1990 assert( 2 * len == (ber_len_t) (( endPos ? endPos : p ) - startPos ));
1993 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1994 if ( val->bv_val == NULL ) {
1995 return( LDAP_NO_MEMORY );
1998 for ( s = 0, d = 0; d < len; s += 2, d++ ) {
2001 hexstr2bin( &startPos[ s ], &c );
2003 val->bv_val[ d ] = c;
2006 val->bv_val[ d ] = '\0';
2012 * convert a byte in a hexadecimal pair
2015 byte2hexpair( const char *val, char *pair )
2017 static const char hexdig[] = "0123456789ABCDEF";
2023 * we assume the string has enough room for the hex encoding
2027 pair[ 0 ] = hexdig[ 0x0f & ( val[ 0 ] >> 4 ) ];
2028 pair[ 1 ] = hexdig[ 0x0f & val[ 0 ] ];
2034 * convert a binary value in hexadecimal pairs
2037 binval2hexstr( struct berval *val, char *str )
2044 if ( val->bv_len == 0 ) {
2049 * we assume the string has enough room for the hex encoding
2053 for ( s = 0, d = 0; s < val->bv_len; s++, d += 2 ) {
2054 byte2hexpair( &val->bv_val[ s ], &str[ d ] );
2061 * Length of the string representation, accounting for escaped hex
2065 strval2strlen( struct berval *val, unsigned flags, ber_len_t *len )
2067 ber_len_t l, cl = 1;
2069 int escaped_byte_len = LDAP_DN_IS_PRETTY( flags ) ? 1 : 3;
2070 #ifdef PRETTY_ESCAPE
2071 int escaped_ascii_len = LDAP_DN_IS_PRETTY( flags ) ? 2 : 3;
2072 #endif /* PRETTY_ESCAPE */
2078 if ( val->bv_len == 0 ) {
2082 for ( l = 0, p = val->bv_val; p < val->bv_val + val->bv_len; p += cl ) {
2087 if ( p[ 0 ] == '\0' ) {
2093 cl = LDAP_UTF8_CHARLEN2( p, cl );
2095 /* illegal utf-8 char! */
2098 } else if ( cl > 1 ) {
2101 for ( cnt = 1; cnt < cl; cnt++ ) {
2102 if ( ( p[ cnt ] & 0xc0 ) != 0x80 ) {
2106 l += escaped_byte_len * cl;
2108 } else if ( LDAP_DN_NEEDESCAPE( p[ 0 ] )
2109 || LDAP_DN_SHOULDESCAPE( p[ 0 ] )
2110 || ( p == val->bv_val && LDAP_DN_NEEDESCAPE_LEAD( p[ 0 ] ) )
2111 || ( !p[ 1 ] && LDAP_DN_NEEDESCAPE_TRAIL( p[ 0 ] ) ) ) {
2112 #ifdef PRETTY_ESCAPE
2114 if ( LDAP_DN_WILLESCAPE_HEX( flags, p[ 0 ] ) ) {
2116 if ( LDAP_DN_WILLESCAPE_CHAR( p[ 0 ] ) ) {
2120 * there might be some chars we want
2121 * to escape in form of a couple
2122 * of hexdigits for optimization purposes
2127 l += escaped_ascii_len;
2129 #else /* ! PRETTY_ESCAPE */
2131 #endif /* ! PRETTY_ESCAPE */
2144 * convert to string representation, escaping with hex the UTF-8 stuff;
2145 * assume the destination has enough room for escaping
2148 strval2str( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2150 ber_len_t s, d, end;
2156 if ( val->bv_len == 0 ) {
2162 * we assume the string has enough room for the hex encoding
2165 for ( s = 0, d = 0, end = val->bv_len - 1; s < val->bv_len; ) {
2171 if ( val->bv_val[ s ] == '\0' ) {
2181 * The length was checked in strval2strlen();
2182 * LDAP_UTF8_CHARLEN() should suffice
2184 cl = LDAP_UTF8_CHARLEN2( &val->bv_val[ s ], cl );
2188 * there might be some chars we want to escape in form
2189 * of a couple of hexdigits for optimization purposes
2191 if ( ( cl > 1 && !LDAP_DN_IS_PRETTY( flags ) )
2192 #ifdef PRETTY_ESCAPE
2194 || LDAP_DN_WILLESCAPE_HEX( flags, val->bv_val[ s ] )
2196 || LDAP_DN_WILLESCAPE_CHAR( val->bv_val[ s ] )
2198 #else /* ! PRETTY_ESCAPE */
2199 || LDAP_DN_NEEDESCAPE( val->bv_val[ s ] )
2200 || LDAP_DN_SHOULDESCAPE( val->bv_val[ s ] )
2201 || ( d == 0 && LDAP_DN_NEEDESCAPE_LEAD( val->bv_val[ s ] ) )
2202 || ( s == end && LDAP_DN_NEEDESCAPE_TRAIL( val->bv_val[ s ] ) )
2204 #endif /* ! PRETTY_ESCAPE */
2208 byte2hexpair( &val->bv_val[ s ], &str[ d ] );
2213 } else if ( cl > 1 ) {
2215 str[ d++ ] = val->bv_val[ s++ ];
2219 #ifdef PRETTY_ESCAPE
2220 if ( LDAP_DN_NEEDESCAPE( val->bv_val[ s ] )
2221 || LDAP_DN_SHOULDESCAPE( val->bv_val[ s ] )
2222 || ( d == 0 && LDAP_DN_NEEDESCAPE_LEAD( val->bv_val[ s ] ) )
2223 || ( s == end && LDAP_DN_NEEDESCAPE_TRAIL( val->bv_val[ s ] ) ) ) {
2225 if ( !LDAP_DN_IS_PRETTY( flags ) ) {
2226 byte2hexpair( &val->bv_val[ s ], &str[ d ] );
2232 #endif /* PRETTY_ESCAPE */
2233 str[ d++ ] = val->bv_val[ s++ ];
2243 * Length of the IA5 string representation (no UTF-8 allowed)
2246 strval2IA5strlen( struct berval *val, unsigned flags, ber_len_t *len )
2255 if ( val->bv_len == 0 ) {
2259 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2261 * Turn value into a binary encoded BER
2266 for ( l = 0, p = val->bv_val; p[ 0 ]; p++ ) {
2267 if ( LDAP_DN_NEEDESCAPE( p[ 0 ] )
2268 || LDAP_DN_SHOULDESCAPE( p[ 0 ] )
2269 || ( p == val->bv_val && LDAP_DN_NEEDESCAPE_LEAD( p[ 0 ] ) )
2270 || ( !p[ 1 ] && LDAP_DN_NEEDESCAPE_TRAIL( p[ 0 ] ) ) ) {
2285 * convert to string representation (np UTF-8)
2286 * assume the destination has enough room for escaping
2289 strval2IA5str( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2291 ber_len_t s, d, end;
2297 if ( val->bv_len == 0 ) {
2302 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2304 * Turn value into a binary encoded BER
2311 * we assume the string has enough room for the hex encoding
2315 for ( s = 0, d = 0, end = val->bv_len - 1; s < val->bv_len; ) {
2316 if ( LDAP_DN_NEEDESCAPE( val->bv_val[ s ] )
2317 || LDAP_DN_SHOULDESCAPE( val->bv_val[ s ] )
2318 || ( s == 0 && LDAP_DN_NEEDESCAPE_LEAD( val->bv_val[ s ] ) )
2319 || ( s == end && LDAP_DN_NEEDESCAPE_TRAIL( val->bv_val[ s ] ) ) ) {
2322 str[ d++ ] = val->bv_val[ s++ ];
2332 * Length of the (supposedly) DCE string representation,
2333 * accounting for escaped hex of UTF-8 chars
2336 strval2DCEstrlen( struct berval *val, unsigned flags, ber_len_t *len )
2345 if ( val->bv_len == 0 ) {
2349 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2351 * FIXME: Turn the value into a binary encoded BER?
2356 for ( l = 0, p = val->bv_val; p[ 0 ]; p++ ) {
2357 if ( LDAP_DN_NEEDESCAPE_DCE( p[ 0 ] ) ) {
2372 * convert to (supposedly) DCE string representation,
2373 * escaping with hex the UTF-8 stuff;
2374 * assume the destination has enough room for escaping
2377 strval2DCEstr( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2385 if ( val->bv_len == 0 ) {
2390 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2392 * FIXME: Turn the value into a binary encoded BER?
2400 * we assume the string has enough room for the hex encoding
2404 for ( s = 0, d = 0; s < val->bv_len; ) {
2405 if ( LDAP_DN_NEEDESCAPE_DCE( val->bv_val[ s ] ) ) {
2408 str[ d++ ] = val->bv_val[ s++ ];
2418 * Length of the (supposedly) AD canonical string representation,
2419 * accounting for escaped hex of UTF-8 chars
2422 strval2ADstrlen( struct berval *val, unsigned flags, ber_len_t *len )
2431 if ( val->bv_len == 0 ) {
2435 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2437 * FIXME: Turn the value into a binary encoded BER?
2442 for ( l = 0, p = val->bv_val; p[ 0 ]; p++ ) {
2443 if ( LDAP_DN_NEEDESCAPE_AD( p[ 0 ] ) ) {
2458 * convert to (supposedly) AD string representation,
2459 * escaping with hex the UTF-8 stuff;
2460 * assume the destination has enough room for escaping
2463 strval2ADstr( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2471 if ( val->bv_len == 0 ) {
2476 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2478 * FIXME: Turn the value into a binary encoded BER?
2486 * we assume the string has enough room for the hex encoding
2490 for ( s = 0, d = 0; s < val->bv_len; ) {
2491 if ( LDAP_DN_NEEDESCAPE_AD( val->bv_val[ s ] ) ) {
2494 str[ d++ ] = val->bv_val[ s++ ];
2504 * If the DN is terminated by single-AVA RDNs with attribute type of "dc",
2505 * the first part of the AD representation of the DN is written in DNS
2506 * form, i.e. dot separated domain name components (as suggested
2507 * by Luke Howard, http://www.padl.com/~lukeh)
2510 dn2domain( LDAPDN dn, struct berval *bv, int pos, int *iRDN )
2513 int domain = 0, first = 1;
2514 ber_len_t l = 1; /* we move the null also */
2517 /* we are guaranteed there's enough memory in str */
2523 assert( *iRDN >= 0 );
2525 str = bv->bv_val + pos;
2527 for ( i = *iRDN; i >= 0; i-- ) {
2537 if ( !LDAP_DN_IS_RDN_DC( rdn ) ) {
2545 AC_MEMCPY( str, ava->la_value.bv_val,
2546 ava->la_value.bv_len + 1);
2547 l += ava->la_value.bv_len;
2550 AC_MEMCPY( str + ava->la_value.bv_len + 1, bv->bv_val + pos, l);
2551 AC_MEMCPY( str, ava->la_value.bv_val,
2552 ava->la_value.bv_len );
2553 str[ ava->la_value.bv_len ] = '.';
2554 l += ava->la_value.bv_len + 1;
2559 bv->bv_len = pos + l - 1;
2565 rdn2strlen( LDAPRDN rdn, unsigned flags, ber_len_t *len,
2566 int ( *s2l )( struct berval *v, unsigned f, ber_len_t *l ) )
2573 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2574 LDAPAVA *ava = rdn[ iAVA ];
2576 /* len(type) + '=' + '+' | ',' */
2577 l += ava->la_attr.bv_len + 2;
2579 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2580 /* octothorpe + twice the length */
2581 l += 1 + 2 * ava->la_value.bv_len;
2585 unsigned f = flags | ava->la_flags;
2587 if ( ( *s2l )( &ava->la_value, f, &vl ) ) {
2600 rdn2str( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len,
2601 int ( *s2s ) ( struct berval *v, char * s, unsigned f, ber_len_t *l ) )
2606 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2607 LDAPAVA *ava = rdn[ iAVA ];
2609 AC_MEMCPY( &str[ l ], ava->la_attr.bv_val,
2610 ava->la_attr.bv_len );
2611 l += ava->la_attr.bv_len;
2615 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2617 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2620 l += 2 * ava->la_value.bv_len;
2624 unsigned f = flags | ava->la_flags;
2626 if ( ( *s2s )( &ava->la_value, &str[ l ], f, &vl ) ) {
2631 str[ l++ ] = ( rdn[ iAVA + 1] ? '+' : ',' );
2640 rdn2DCEstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len )
2647 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2648 LDAPAVA *ava = rdn[ iAVA ];
2650 /* len(type) + '=' + ',' | '/' */
2651 l += ava->la_attr.bv_len + 2;
2653 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2654 /* octothorpe + twice the length */
2655 l += 1 + 2 * ava->la_value.bv_len;
2658 unsigned f = flags | ava->la_flags;
2660 if ( strval2DCEstrlen( &ava->la_value, f, &vl ) ) {
2673 rdn2DCEstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len, int first )
2678 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2679 LDAPAVA *ava = rdn[ iAVA ];
2684 str[ l++ ] = ( iAVA ? ',' : '/' );
2687 AC_MEMCPY( &str[ l ], ava->la_attr.bv_val,
2688 ava->la_attr.bv_len );
2689 l += ava->la_attr.bv_len;
2693 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2695 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2698 l += 2 * ava->la_value.bv_len;
2701 unsigned f = flags | ava->la_flags;
2703 if ( strval2DCEstr( &ava->la_value, &str[ l ], f, &vl ) ) {
2716 rdn2UFNstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len )
2726 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2727 LDAPAVA *ava = rdn[ iAVA ];
2730 l += ( rdn[ iAVA + 1 ] ? 3 : 2 );
2732 /* FIXME: are binary values allowed in UFN? */
2733 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2734 /* octothorpe + twice the value */
2735 l += 1 + 2 * ava->la_value.bv_len;
2739 unsigned f = flags | ava->la_flags;
2741 if ( strval2strlen( &ava->la_value, f, &vl ) ) {
2754 rdn2UFNstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len )
2759 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2760 LDAPAVA *ava = rdn[ iAVA ];
2762 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2764 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2767 l += 2 * ava->la_value.bv_len;
2771 unsigned f = flags | ava->la_flags;
2773 if ( strval2str( &ava->la_value, &str[ l ], f, &vl ) ) {
2779 if ( rdn[ iAVA + 1 ] ) {
2780 AC_MEMCPY( &str[ l ], " + ", 3 );
2784 AC_MEMCPY( &str[ l ], ", ", 2 );
2795 rdn2ADstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len )
2805 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2806 LDAPAVA *ava = rdn[ iAVA ];
2811 /* FIXME: are binary values allowed in UFN? */
2812 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2813 /* octothorpe + twice the value */
2814 l += 1 + 2 * ava->la_value.bv_len;
2817 unsigned f = flags | ava->la_flags;
2819 if ( strval2ADstrlen( &ava->la_value, f, &vl ) ) {
2832 rdn2ADstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len, int first )
2837 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2838 LDAPAVA *ava = rdn[ iAVA ];
2843 str[ l++ ] = ( iAVA ? ',' : '/' );
2846 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2848 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2851 l += 2 * ava->la_value.bv_len;
2854 unsigned f = flags | ava->la_flags;
2856 if ( strval2ADstr( &ava->la_value, &str[ l ], f, &vl ) ) {
2871 * Returns in str a string representation of rdn based on flags.
2872 * There is some duplication of code between this and ldap_dn2str;
2873 * this is wanted to reduce the allocation of temporary buffers.
2876 ldap_rdn2str( LDAPRDN rdn, char **str, unsigned flags )
2883 if((flags & LDAP_DN_FORMAT_MASK) == LDAP_DN_FORMAT_LBER) {
2884 return LDAP_PARAM_ERROR;
2887 rc = ldap_rdn2bv_x( rdn, &bv, flags, NULL );
2893 ldap_rdn2bv( LDAPRDN rdn, struct berval *bv, unsigned flags )
2895 return ldap_rdn2bv_x( rdn, bv, flags, NULL );
2899 ldap_rdn2bv_x( LDAPRDN rdn, struct berval *bv, unsigned flags, void *ctx )
2909 if ( rdn == NULL ) {
2910 bv->bv_val = LDAP_STRDUPX( "", ctx );
2911 return( LDAP_SUCCESS );
2915 * This routine wastes "back" bytes at the end of the string
2918 switch ( LDAP_DN_FORMAT( flags ) ) {
2919 case LDAP_DN_FORMAT_LDAPV3:
2920 if ( rdn2strlen( rdn, flags, &l, strval2strlen ) ) {
2921 return LDAP_DECODING_ERROR;
2925 case LDAP_DN_FORMAT_LDAPV2:
2926 if ( rdn2strlen( rdn, flags, &l, strval2IA5strlen ) ) {
2927 return LDAP_DECODING_ERROR;
2931 case LDAP_DN_FORMAT_UFN:
2932 if ( rdn2UFNstrlen( rdn, flags, &l ) ) {
2933 return LDAP_DECODING_ERROR;
2937 case LDAP_DN_FORMAT_DCE:
2938 if ( rdn2DCEstrlen( rdn, flags, &l ) ) {
2939 return LDAP_DECODING_ERROR;
2943 case LDAP_DN_FORMAT_AD_CANONICAL:
2944 if ( rdn2ADstrlen( rdn, flags, &l ) ) {
2945 return LDAP_DECODING_ERROR;
2950 return LDAP_PARAM_ERROR;
2953 bv->bv_val = LDAP_MALLOCX( l + 1, ctx );
2955 switch ( LDAP_DN_FORMAT( flags ) ) {
2956 case LDAP_DN_FORMAT_LDAPV3:
2957 rc = rdn2str( rdn, bv->bv_val, flags, &l, strval2str );
2961 case LDAP_DN_FORMAT_LDAPV2:
2962 rc = rdn2str( rdn, bv->bv_val, flags, &l, strval2IA5str );
2966 case LDAP_DN_FORMAT_UFN:
2967 rc = rdn2UFNstr( rdn, bv->bv_val, flags, &l );
2971 case LDAP_DN_FORMAT_DCE:
2972 rc = rdn2DCEstr( rdn, bv->bv_val, flags, &l, 1 );
2976 case LDAP_DN_FORMAT_AD_CANONICAL:
2977 rc = rdn2ADstr( rdn, bv->bv_val, flags, &l, 1 );
2982 /* need at least one of the previous */
2983 return LDAP_PARAM_ERROR;
2987 LDAP_FREEX( bv->bv_val, ctx );
2991 bv->bv_len = l - back;
2992 bv->bv_val[ bv->bv_len ] = '\0';
2994 return LDAP_SUCCESS;
2998 * Very bulk implementation; many optimizations can be performed
2999 * - a NULL dn results in an empty string ""
3002 * a) what do we do if a UTF-8 string must be converted in LDAPv2?
3003 * we must encode it in binary form ('#' + HEXPAIRs)
3004 * b) does DCE/AD support UTF-8?
3005 * no clue; don't think so.
3006 * c) what do we do when binary values must be converted in UTF/DCE/AD?
3007 * use binary encoded BER
3009 int ldap_dn2str( LDAPDN dn, char **str, unsigned flags )
3016 if((flags & LDAP_DN_FORMAT_MASK) == LDAP_DN_FORMAT_LBER) {
3017 return LDAP_PARAM_ERROR;
3020 rc = ldap_dn2bv_x( dn, &bv, flags, NULL );
3025 int ldap_dn2bv( LDAPDN dn, struct berval *bv, unsigned flags )
3027 return ldap_dn2bv_x( dn, bv, flags, NULL );
3030 int ldap_dn2bv_x( LDAPDN dn, struct berval *bv, unsigned flags, void *ctx )
3033 int rc = LDAP_ENCODING_ERROR;
3036 /* stringifying helpers for LDAPv3/LDAPv2 */
3037 int ( *sv2l ) ( struct berval *v, unsigned f, ber_len_t *l );
3038 int ( *sv2s ) ( struct berval *v, char *s, unsigned f, ber_len_t *l );
3045 LDAP_LOG ( OPERATION, ARGS, "=> ldap_dn2bv(%u)\n", flags, 0, 0 );
3047 Debug( LDAP_DEBUG_TRACE, "=> ldap_dn2bv(%u)\n", flags, 0, 0 );
3051 * a null dn means an empty dn string
3052 * FIXME: better raise an error?
3055 bv->bv_val = LDAP_STRDUPX( "", ctx );
3056 return( LDAP_SUCCESS );
3059 switch ( LDAP_DN_FORMAT( flags ) ) {
3060 case LDAP_DN_FORMAT_LDAPV3:
3061 sv2l = strval2strlen;
3065 case LDAP_DN_FORMAT_LDAPV2:
3066 sv2l = strval2IA5strlen;
3067 sv2s = strval2IA5str;
3070 for ( iRDN = 0, len = 0; dn[ iRDN ]; iRDN++ ) {
3072 if ( rdn2strlen( dn[ iRDN ], flags, &rdnl, sv2l ) ) {
3073 goto return_results;
3079 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1, ctx ) ) == NULL ) {
3080 rc = LDAP_NO_MEMORY;
3084 for ( l = 0, iRDN = 0; dn[ iRDN ]; iRDN++ ) {
3087 if ( rdn2str( dn[ iRDN ], &bv->bv_val[ l ], flags,
3089 LDAP_FREEX( bv->bv_val, ctx );
3091 goto return_results;
3099 * trim the last ',' (the allocated memory
3100 * is one byte longer than required)
3102 bv->bv_len = len - 1;
3103 bv->bv_val[ bv->bv_len ] = '\0';
3108 case LDAP_DN_FORMAT_UFN: {
3110 * FIXME: quoting from RFC 1781:
3112 To take a distinguished name, and generate a name of this format with
3113 attribute types omitted, the following steps are followed.
3115 1. If the first attribute is of type CommonName, the type may be
3118 2. If the last attribute is of type Country, the type may be
3121 3. If the last attribute is of type Country, the last
3122 Organisation attribute may have the type omitted.
3124 4. All attributes of type OrganisationalUnit may have the type
3125 omitted, unless they are after an Organisation attribute or
3126 the first attribute is of type OrganisationalUnit.
3128 * this should be the pedantic implementation.
3130 * Here the standard implementation reflects
3131 * the one historically provided by OpenLDAP
3132 * (and UMIch, I presume), with the variant
3133 * of spaces and plusses (' + ') separating
3136 * A non-standard but nice implementation could
3137 * be to turn the final "dc" attributes into a
3138 * dot-separated domain.
3140 * Other improvements could involve the use of
3141 * friendly country names and so.
3144 int leftmost_dc = -1;
3146 #endif /* DC_IN_UFN */
3148 for ( iRDN = 0, len = 0; dn[ iRDN ]; iRDN++ ) {
3151 if ( rdn2UFNstrlen( dn[ iRDN ], flags, &rdnl ) ) {
3152 goto return_results;
3157 if ( LDAP_DN_IS_RDN_DC( dn[ iRDN ] ) ) {
3158 if ( leftmost_dc == -1 ) {
3164 #endif /* DC_IN_UFN */
3167 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1, ctx ) ) == NULL ) {
3168 rc = LDAP_NO_MEMORY;
3173 if ( leftmost_dc == -1 ) {
3174 #endif /* DC_IN_UFN */
3175 for ( l = 0, iRDN = 0; dn[ iRDN ]; iRDN++ ) {
3178 if ( rdn2UFNstr( dn[ iRDN ], &bv->bv_val[ l ],
3180 LDAP_FREEX( bv->bv_val, ctx );
3182 goto return_results;
3188 * trim the last ', ' (the allocated memory
3189 * is two bytes longer than required)
3191 bv->bv_len = len - 2;
3192 bv->bv_val[ bv->bv_len ] = '\0';
3195 last_iRDN = iRDN - 1;
3197 for ( l = 0, iRDN = 0; iRDN < leftmost_dc; iRDN++ ) {
3200 if ( rdn2UFNstr( dn[ iRDN ], &bv->bv_val[ l ],
3202 LDAP_FREEX( bv->bv_val, ctx );
3204 goto return_results;
3209 if ( !dn2domain( dn, bv, l, &last_iRDN ) ) {
3210 LDAP_FREEX( bv->bv_val, ctx );
3212 goto return_results;
3215 /* the string is correctly terminated by dn2domain */
3217 #endif /* DC_IN_UFN */
3223 case LDAP_DN_FORMAT_DCE:
3224 for ( iRDN = 0, len = 0; dn[ iRDN ]; iRDN++ ) {
3226 if ( rdn2DCEstrlen( dn[ iRDN ], flags, &rdnl ) ) {
3227 goto return_results;
3233 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1, ctx ) ) == NULL ) {
3234 rc = LDAP_NO_MEMORY;
3238 for ( l = 0; iRDN--; ) {
3241 if ( rdn2DCEstr( dn[ iRDN ], &bv->bv_val[ l ], flags,
3243 LDAP_FREEX( bv->bv_val, ctx );
3245 goto return_results;
3253 bv->bv_val[ bv->bv_len ] = '\0';
3258 case LDAP_DN_FORMAT_AD_CANONICAL: {
3259 int trailing_slash = 1;
3262 * Sort of UFN for DCE DNs: a slash ('/') separated
3263 * global->local DN with no types; strictly speaking,
3264 * the naming context should be a domain, which is
3265 * written in DNS-style, e.g. dot-deparated.
3269 * "givenName=Bill+sn=Gates,ou=People,dc=microsoft,dc=com"
3273 * "microsoft.com/People/Bill,Gates"
3275 for ( iRDN = 0, len = -1; dn[ iRDN ]; iRDN++ ) {
3278 if ( rdn2ADstrlen( dn[ iRDN ], flags, &rdnl ) ) {
3279 goto return_results;
3285 /* reserve room for trailing '/' in case the DN
3286 * is exactly a domain */
3287 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1 + 1, ctx ) ) == NULL )
3289 rc = LDAP_NO_MEMORY;
3294 if ( iRDN && dn2domain( dn, bv, 0, &iRDN ) != 0 ) {
3295 for ( l = bv->bv_len; iRDN >= 0 ; iRDN-- ) {
3300 if ( rdn2ADstr( dn[ iRDN ], &bv->bv_val[ l ],
3301 flags, &rdnl, 0 ) ) {
3302 LDAP_FREEX( bv->bv_val, ctx );
3304 goto return_results;
3313 * Strictly speaking, AD canonical requires
3314 * a DN to be in the form "..., dc=smtg",
3315 * i.e. terminated by a domain component
3317 if ( flags & LDAP_DN_PEDANTIC ) {
3318 LDAP_FREEX( bv->bv_val, ctx );
3320 rc = LDAP_ENCODING_ERROR;
3324 for ( l = 0; iRDN >= 0 ; iRDN-- ) {
3327 if ( rdn2ADstr( dn[ iRDN ], &bv->bv_val[ l ],
3328 flags, &rdnl, first ) ) {
3329 LDAP_FREEX( bv->bv_val, ctx );
3331 goto return_results;
3340 if ( trailing_slash ) {
3341 /* the DN is exactly a domain -- need a trailing
3342 * slash; room was reserved in advance */
3343 bv->bv_val[ len ] = '/';
3348 bv->bv_val[ bv->bv_len ] = '\0';
3354 return LDAP_PARAM_ERROR;
3358 LDAP_LOG ( OPERATION, RESULTS, "<= ldap_dn2bv(%s)=%d %s\n",
3359 bv->bv_val, rc, ldap_err2string( rc ) );
3361 Debug( LDAP_DEBUG_TRACE, "<= ldap_dn2bv(%s)=%d %s\n",
3362 bv->bv_val, rc, ldap_err2string( rc ) );
3370 #include <openssl/x509.h>
3371 #include <openssl/err.h>
3373 /* Convert a structured DN from an X.509 certificate into an LDAPV3 DN.
3374 * x509_name must be an (X509_NAME *). If func is non-NULL, the
3375 * constructed DN will use numeric OIDs to identify attributeTypes,
3376 * and the func() will be invoked to rewrite the DN with the given
3379 * Otherwise the DN will use shortNames as defined in the OpenSSL
3382 * It's preferable to let slapd do the OID to attributeType mapping,
3383 * because the OpenSSL tables are known to have many typos in versions
3384 * up to (at least) 0.9.6c. However, the LDAP client has no schema tables,
3385 * so we're forced to use OpenSSL's mapping there.
3386 * -- Howard Chu 2002-04-18
3390 ldap_X509dn2bv( void *x509_name, struct berval *bv, LDAPDN_rewrite_func *func,
3395 LDAPAVA *newAVA, *baseAVA;
3396 X509_NAME_ENTRY *ne;
3399 char oids[8192], *oidptr = oids, *oidbuf = NULL;
3401 int i, j, k = 0, navas, nrdns, rc = LDAP_SUCCESS;
3403 size_t dnsize, oidrem = sizeof(oids), oidsize = 0;
3412 /* Get the number of AVAs. This is not necessarily the same as
3413 * the number of RDNs.
3415 navas = X509_NAME_entry_count( x509_name );
3417 /* Get the last element, to see how many RDNs there are */
3418 ne = X509_NAME_get_entry( x509_name, navas - 1 );
3419 nrdns = ne->set + 1;
3421 /* Allocate the DN/RDN/AVA stuff as a single block */
3422 dnsize = sizeof(LDAPRDN) * (nrdns+1);
3423 dnsize += sizeof(LDAPAVA *) * (navas+nrdns);
3424 dnsize += sizeof(LDAPAVA) * navas;
3425 if (dnsize > sizeof(ptrs)) {
3426 newDN = (LDAPDN)LDAP_MALLOC( dnsize );
3427 if ( newDN == NULL )
3428 return LDAP_NO_MEMORY;
3430 newDN = (LDAPDN)ptrs;
3433 newDN[nrdns] = NULL;
3434 newRDN = (LDAPRDN)(newDN + nrdns+1);
3435 newAVA = (LDAPAVA *)(newRDN + navas + nrdns);
3438 /* Retrieve RDNs in reverse order; LDAP is backwards from X.500. */
3439 for ( i = nrdns - 1, j = 0; i >= 0; i-- ) {
3440 ne = X509_NAME_get_entry( x509_name, i );
3441 obj = X509_NAME_ENTRY_get_object( ne );
3442 str = X509_NAME_ENTRY_get_data( ne );
3444 /* If set changed, move to next RDN */
3445 if ( set != ne->set ) {
3446 /* If this is not the first time, end the
3447 * previous RDN and advance.
3453 newDN[j++] = newRDN;
3458 newAVA->la_private = NULL;
3459 newAVA->la_flags = LDAP_AVA_STRING;
3462 int n = OBJ_obj2nid( obj );
3466 newAVA->la_attr.bv_val = (char *)OBJ_nid2sn( n );
3467 newAVA->la_attr.bv_len = strlen( newAVA->la_attr.bv_val );
3469 newAVA->la_attr.bv_val = LDAP_STRDUP( newAVA->la_attr.bv_val );
3470 __etoa( newAVA->la_attr.bv_val );
3471 newAVA->la_flags |= LDAP_AVA_FREE_ATTR;
3474 get_oid: newAVA->la_attr.bv_val = oidptr;
3475 newAVA->la_attr.bv_len = OBJ_obj2txt( oidptr, oidrem, obj, 1 );
3477 __etoa( newAVA->la_attr.bv_val );
3479 oidptr += newAVA->la_attr.bv_len + 1;
3480 oidrem -= newAVA->la_attr.bv_len + 1;
3482 /* Running out of OID buffer space? */
3484 if ( oidsize == 0 ) {
3485 oidsize = sizeof(oids) * 2;
3487 oidbuf = LDAP_MALLOC( oidsize );
3488 if ( oidbuf == NULL ) goto nomem;
3492 oidbuf = LDAP_REALLOC( oidbuf, oidsize*2 );
3493 if ( oidbuf == NULL ) goto nomem;
3494 /* Buffer moved! Fix AVA pointers */
3495 if ( old != oidbuf ) {
3497 long dif = oidbuf - old;
3499 for (a=baseAVA; a<=newAVA; a++){
3500 if (a->la_attr.bv_val >= old &&
3501 a->la_attr.bv_val <= (old + oidsize))
3502 a->la_attr.bv_val += dif;
3505 oidptr = oidbuf + oidsize - oidrem;
3511 Val.bv_val = (char *) str->data;
3512 Val.bv_len = str->length;
3513 switch( str->type ) {
3514 case V_ASN1_UNIVERSALSTRING:
3515 /* This uses 32-bit ISO 10646-1 */
3516 csize = 4; goto to_utf8;
3517 case V_ASN1_BMPSTRING:
3518 /* This uses 16-bit ISO 10646-1 */
3519 csize = 2; goto to_utf8;
3520 case V_ASN1_T61STRING:
3521 /* This uses 8-bit, assume ISO 8859-1 */
3523 to_utf8: rc = ldap_ucs_to_utf8s( &Val, csize, &newAVA->la_value );
3524 newAVA->la_flags |= LDAP_AVA_FREE_VALUE;
3525 if (rc != LDAP_SUCCESS) goto nomem;
3526 newAVA->la_flags = LDAP_AVA_NONPRINTABLE;
3528 case V_ASN1_UTF8STRING:
3529 newAVA->la_flags = LDAP_AVA_NONPRINTABLE;
3530 /* This is already in UTF-8 encoding */
3531 case V_ASN1_IA5STRING:
3532 case V_ASN1_PRINTABLESTRING:
3533 /* These are always 7-bit strings */
3534 newAVA->la_value = Val;
3545 rc = func( newDN, flags, NULL );
3546 if ( rc != LDAP_SUCCESS )
3550 rc = ldap_dn2bv_x( newDN, bv, LDAP_DN_FORMAT_LDAPV3, NULL );
3553 for (;baseAVA < newAVA; baseAVA++) {
3554 if (baseAVA->la_flags & LDAP_AVA_FREE_ATTR)
3555 LDAP_FREE( baseAVA->la_attr.bv_val );
3556 if (baseAVA->la_flags & LDAP_AVA_FREE_VALUE)
3557 LDAP_FREE( baseAVA->la_value.bv_val );
3561 LDAP_FREE( oidbuf );
3562 if ( newDN != (LDAPDN) ptrs )
3566 #endif /* HAVE_TLS */