No empty .Rs/.Re
[netbsd-mini2440.git] / external / bsd / openldap / dist / libraries / libldap / getdn.c
blob24087f604269b8d20f3f6af01fdb0901a31edeac
1 /* $OpenLDAP: pkg/ldap/libraries/libldap/getdn.c,v 1.130.2.3 2008/02/11 23:26:41 kurt Exp $ */
2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2008 The OpenLDAP Foundation.
5 * All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
9 * Public License.
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.
19 #include "portable.h"
21 #include <stdio.h>
23 #include <ac/stdlib.h>
24 #include <ac/socket.h>
25 #include <ac/string.h>
26 #include <ac/time.h>
28 #include "ldap-int.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" */
33 #define DC_IN_UFN
35 /* parsing/printing routines */
36 static int str2strval( const char *str, ber_len_t stoplen, struct berval *val,
37 const char **next, unsigned flags, int *retFlags, void *ctx );
38 static int DCE2strval( const char *str, struct berval *val,
39 const char **next, unsigned flags, void *ctx );
40 static int IA52strval( const char *str, struct berval *val,
41 const char **next, unsigned flags, void *ctx );
42 static int quotedIA52strval( const char *str, struct berval *val,
43 const char **next, unsigned flags, void *ctx );
44 static int hexstr2binval( const char *str, struct berval *val,
45 const char **next, unsigned flags, void *ctx );
46 static int hexstr2bin( const char *str, char *c );
47 static int byte2hexpair( const char *val, char *pair );
48 static int binval2hexstr( struct berval *val, char *str );
49 static int strval2strlen( struct berval *val, unsigned flags,
50 ber_len_t *len );
51 static int strval2str( struct berval *val, char *str, unsigned flags,
52 ber_len_t *len );
53 static int strval2IA5strlen( struct berval *val, unsigned flags,
54 ber_len_t *len );
55 static int strval2IA5str( struct berval *val, char *str, unsigned flags,
56 ber_len_t *len );
57 static int strval2DCEstrlen( struct berval *val, unsigned flags,
58 ber_len_t *len );
59 static int strval2DCEstr( struct berval *val, char *str, unsigned flags,
60 ber_len_t *len );
61 static int strval2ADstrlen( struct berval *val, unsigned flags,
62 ber_len_t *len );
63 static int strval2ADstr( struct berval *val, char *str, unsigned flags,
64 ber_len_t *len );
65 static int dn2domain( LDAPDN dn, struct berval *bv, int pos, int *iRDN );
67 /* AVA helpers */
68 static LDAPAVA * ldapava_new(
69 const struct berval *attr, const struct berval *val, unsigned flags, void *ctx );
71 /* Higher level helpers */
72 static int rdn2strlen( LDAPRDN rdn, unsigned flags, ber_len_t *len,
73 int ( *s2l )( struct berval *, unsigned, ber_len_t * ) );
74 static int rdn2str( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len,
75 int ( *s2s )( struct berval *, char *, unsigned, ber_len_t * ));
76 static int rdn2UFNstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len );
77 static int rdn2UFNstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len );
78 static int rdn2DCEstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len );
79 static int rdn2DCEstr( LDAPRDN rdn, char *str, unsigned flag, ber_len_t *len, int first );
80 static int rdn2ADstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len );
81 static int rdn2ADstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len, int first );
84 * RFC 1823 ldap_get_dn
86 char *
87 ldap_get_dn( LDAP *ld, LDAPMessage *entry )
89 char *dn;
90 BerElement tmp;
92 Debug( LDAP_DEBUG_TRACE, "ldap_get_dn\n", 0, 0, 0 );
94 assert( ld != NULL );
95 assert( LDAP_VALID(ld) );
96 assert( entry != NULL );
98 tmp = *entry->lm_ber; /* struct copy */
99 if ( ber_scanf( &tmp, "{a" /*}*/, &dn ) == LBER_ERROR ) {
100 ld->ld_errno = LDAP_DECODING_ERROR;
101 return( NULL );
104 return( dn );
108 ldap_get_dn_ber( LDAP *ld, LDAPMessage *entry, BerElement **berout,
109 BerValue *dn )
111 BerElement tmp, *ber;
112 ber_len_t len = 0;
113 int rc = LDAP_SUCCESS;
115 Debug( LDAP_DEBUG_TRACE, "ldap_get_dn_ber\n", 0, 0, 0 );
117 assert( ld != NULL );
118 assert( LDAP_VALID(ld) );
119 assert( entry != NULL );
120 assert( dn != NULL );
122 dn->bv_val = NULL;
123 dn->bv_len = 0;
125 if ( berout ) {
126 *berout = NULL;
127 ber = ldap_alloc_ber_with_options( ld );
128 if( ber == NULL ) {
129 return LDAP_NO_MEMORY;
131 *berout = ber;
132 } else {
133 ber = &tmp;
136 *ber = *entry->lm_ber; /* struct copy */
137 if ( ber_scanf( ber, "{ml{" /*}*/, dn, &len ) == LBER_ERROR ) {
138 rc = ld->ld_errno = LDAP_DECODING_ERROR;
140 if ( rc == LDAP_SUCCESS ) {
141 /* set the length to avoid overrun */
142 rc = ber_set_option( ber, LBER_OPT_REMAINING_BYTES, &len );
143 if( rc != LBER_OPT_SUCCESS ) {
144 rc = ld->ld_errno = LDAP_LOCAL_ERROR;
147 if ( rc != LDAP_SUCCESS && berout ) {
148 ber_free( ber, 0 );
149 *berout = NULL;
151 return rc;
155 * RFC 1823 ldap_dn2ufn
157 char *
158 ldap_dn2ufn( LDAP_CONST char *dn )
160 char *out = NULL;
162 Debug( LDAP_DEBUG_TRACE, "ldap_dn2ufn\n", 0, 0, 0 );
164 ( void )ldap_dn_normalize( dn, LDAP_DN_FORMAT_LDAP,
165 &out, LDAP_DN_FORMAT_UFN );
167 return( out );
171 * RFC 1823 ldap_explode_dn
173 char **
174 ldap_explode_dn( LDAP_CONST char *dn, int notypes )
176 LDAPDN tmpDN;
177 char **values = NULL;
178 int iRDN;
179 unsigned flag = notypes ? LDAP_DN_FORMAT_UFN : LDAP_DN_FORMAT_LDAPV3;
181 Debug( LDAP_DEBUG_TRACE, "ldap_explode_dn\n", 0, 0, 0 );
183 if ( ldap_str2dn( dn, &tmpDN, LDAP_DN_FORMAT_LDAP )
184 != LDAP_SUCCESS ) {
185 return NULL;
188 if( tmpDN == NULL ) {
189 values = LDAP_MALLOC( sizeof( char * ) );
190 if( values == NULL ) return NULL;
192 values[0] = NULL;
193 return values;
196 for ( iRDN = 0; tmpDN[ iRDN ]; iRDN++ );
198 values = LDAP_MALLOC( sizeof( char * ) * ( 1 + iRDN ) );
199 if ( values == NULL ) {
200 ldap_dnfree( tmpDN );
201 return NULL;
204 for ( iRDN = 0; tmpDN[ iRDN ]; iRDN++ ) {
205 ldap_rdn2str( tmpDN[ iRDN ], &values[ iRDN ], flag );
207 ldap_dnfree( tmpDN );
208 values[ iRDN ] = NULL;
210 return values;
213 char **
214 ldap_explode_rdn( LDAP_CONST char *rdn, int notypes )
216 LDAPRDN tmpRDN;
217 char **values = NULL;
218 const char *p;
219 int iAVA;
221 Debug( LDAP_DEBUG_TRACE, "ldap_explode_rdn\n", 0, 0, 0 );
224 * we only parse the first rdn
225 * FIXME: we prefer efficiency over checking if the _ENTIRE_
226 * dn can be parsed
228 if ( ldap_str2rdn( rdn, &tmpRDN, (char **) &p, LDAP_DN_FORMAT_LDAP )
229 != LDAP_SUCCESS ) {
230 return( NULL );
233 for ( iAVA = 0; tmpRDN[ iAVA ]; iAVA++ ) ;
234 values = LDAP_MALLOC( sizeof( char * ) * ( 1 + iAVA ) );
235 if ( values == NULL ) {
236 ldap_rdnfree( tmpRDN );
237 return( NULL );
240 for ( iAVA = 0; tmpRDN[ iAVA ]; iAVA++ ) {
241 ber_len_t l = 0, vl, al = 0;
242 char *str;
243 LDAPAVA *ava = tmpRDN[ iAVA ];
245 if ( ava->la_flags & LDAP_AVA_BINARY ) {
246 vl = 1 + 2 * ava->la_value.bv_len;
248 } else {
249 if ( strval2strlen( &ava->la_value,
250 ava->la_flags, &vl ) ) {
251 goto error_return;
255 if ( !notypes ) {
256 al = ava->la_attr.bv_len;
257 l = vl + ava->la_attr.bv_len + 1;
259 str = LDAP_MALLOC( l + 1 );
260 AC_MEMCPY( str, ava->la_attr.bv_val,
261 ava->la_attr.bv_len );
262 str[ al++ ] = '=';
264 } else {
265 l = vl;
266 str = LDAP_MALLOC( l + 1 );
269 if ( ava->la_flags & LDAP_AVA_BINARY ) {
270 str[ al++ ] = '#';
271 if ( binval2hexstr( &ava->la_value, &str[ al ] ) ) {
272 goto error_return;
275 } else {
276 if ( strval2str( &ava->la_value, &str[ al ],
277 ava->la_flags, &vl ) ) {
278 goto error_return;
282 str[ l ] = '\0';
283 values[ iAVA ] = str;
285 values[ iAVA ] = NULL;
287 ldap_rdnfree( tmpRDN );
289 return( values );
291 error_return:;
292 LBER_VFREE( values );
293 ldap_rdnfree( tmpRDN );
294 return( NULL );
297 char *
298 ldap_dn2dcedn( LDAP_CONST char *dn )
300 char *out = NULL;
302 Debug( LDAP_DEBUG_TRACE, "ldap_dn2dcedn\n", 0, 0, 0 );
304 ( void )ldap_dn_normalize( dn, LDAP_DN_FORMAT_LDAP,
305 &out, LDAP_DN_FORMAT_DCE );
307 return( out );
310 char *
311 ldap_dcedn2dn( LDAP_CONST char *dce )
313 char *out = NULL;
315 Debug( LDAP_DEBUG_TRACE, "ldap_dcedn2dn\n", 0, 0, 0 );
317 ( void )ldap_dn_normalize( dce, LDAP_DN_FORMAT_DCE, &out, LDAP_DN_FORMAT_LDAPV3 );
319 return( out );
322 char *
323 ldap_dn2ad_canonical( LDAP_CONST char *dn )
325 char *out = NULL;
327 Debug( LDAP_DEBUG_TRACE, "ldap_dn2ad_canonical\n", 0, 0, 0 );
329 ( void )ldap_dn_normalize( dn, LDAP_DN_FORMAT_LDAP,
330 &out, LDAP_DN_FORMAT_AD_CANONICAL );
332 return( out );
336 * function that changes the string representation of dnin
337 * from ( fin & LDAP_DN_FORMAT_MASK ) to ( fout & LDAP_DN_FORMAT_MASK )
339 * fin can be one of:
340 * LDAP_DN_FORMAT_LDAP (RFC 4514 liberal, plus some RFC 1779)
341 * LDAP_DN_FORMAT_LDAPV3 (RFC 4514)
342 * LDAP_DN_FORMAT_LDAPV2 (RFC 1779)
343 * LDAP_DN_FORMAT_DCE (?)
345 * fout can be any of the above except
346 * LDAP_DN_FORMAT_LDAP
347 * plus:
348 * LDAP_DN_FORMAT_UFN (RFC 1781, partial and with extensions)
349 * LDAP_DN_FORMAT_AD_CANONICAL (?)
352 ldap_dn_normalize( LDAP_CONST char *dnin,
353 unsigned fin, char **dnout, unsigned fout )
355 int rc;
356 LDAPDN tmpDN = NULL;
358 Debug( LDAP_DEBUG_TRACE, "ldap_dn_normalize\n", 0, 0, 0 );
360 assert( dnout != NULL );
362 *dnout = NULL;
364 if ( dnin == NULL ) {
365 return( LDAP_SUCCESS );
368 rc = ldap_str2dn( dnin , &tmpDN, fin );
369 if ( rc != LDAP_SUCCESS ) {
370 return( rc );
373 rc = ldap_dn2str( tmpDN, dnout, fout );
375 ldap_dnfree( tmpDN );
377 return( rc );
380 /* States */
381 #define B4AVA 0x0000
383 /* #define B4ATTRTYPE 0x0001 */
384 #define B4OIDATTRTYPE 0x0002
385 #define B4STRINGATTRTYPE 0x0003
387 #define B4AVAEQUALS 0x0100
388 #define B4AVASEP 0x0200
389 #define B4RDNSEP 0x0300
390 #define GOTAVA 0x0400
392 #define B4ATTRVALUE 0x0010
393 #define B4STRINGVALUE 0x0020
394 #define B4IA5VALUEQUOTED 0x0030
395 #define B4IA5VALUE 0x0040
396 #define B4BINARYVALUE 0x0050
399 * Helpers (mostly from slap.h)
400 * c is assumed to Unicode in an ASCII compatible format (UTF-8)
401 * Macros assume "C" Locale (ASCII)
403 #define LDAP_DN_ASCII_SPACE(c) \
404 ( (c) == ' ' || (c) == '\t' || (c) == '\n' || (c) == '\r' )
405 #define LDAP_DN_ASCII_LOWER(c) LDAP_LOWER(c)
406 #define LDAP_DN_ASCII_UPPER(c) LDAP_UPPER(c)
407 #define LDAP_DN_ASCII_ALPHA(c) LDAP_ALPHA(c)
409 #define LDAP_DN_ASCII_DIGIT(c) LDAP_DIGIT(c)
410 #define LDAP_DN_ASCII_LCASE_HEXALPHA(c) LDAP_HEXLOWER(c)
411 #define LDAP_DN_ASCII_UCASE_HEXALPHA(c) LDAP_HEXUPPER(c)
412 #define LDAP_DN_ASCII_HEXDIGIT(c) LDAP_HEX(c)
413 #define LDAP_DN_ASCII_ALNUM(c) LDAP_ALNUM(c)
414 #define LDAP_DN_ASCII_PRINTABLE(c) ( (c) >= ' ' && (c) <= '~' )
416 /* attribute type */
417 #define LDAP_DN_OID_LEADCHAR(c) LDAP_DIGIT(c)
418 #define LDAP_DN_DESC_LEADCHAR(c) LDAP_ALPHA(c)
419 #define LDAP_DN_DESC_CHAR(c) LDAP_LDH(c)
420 #define LDAP_DN_LANG_SEP(c) ( (c) == ';' )
421 #define LDAP_DN_ATTRDESC_CHAR(c) \
422 ( LDAP_DN_DESC_CHAR(c) || LDAP_DN_LANG_SEP(c) )
424 /* special symbols */
425 #define LDAP_DN_AVA_EQUALS(c) ( (c) == '=' )
426 #define LDAP_DN_AVA_SEP(c) ( (c) == '+' )
427 #define LDAP_DN_RDN_SEP(c) ( (c) == ',' )
428 #define LDAP_DN_RDN_SEP_V2(c) ( LDAP_DN_RDN_SEP(c) || (c) == ';' )
429 #define LDAP_DN_OCTOTHORPE(c) ( (c) == '#' )
430 #define LDAP_DN_QUOTES(c) ( (c) == '\"' )
431 #define LDAP_DN_ESCAPE(c) ( (c) == '\\' )
432 #define LDAP_DN_VALUE_END(c) \
433 ( LDAP_DN_RDN_SEP(c) || LDAP_DN_AVA_SEP(c) )
435 /* NOTE: according to RFC 4514, '=' can be escaped and treated as special,
436 * i.e. escaped both as "\<hexpair>" and * as "\=", but it is treated as
437 * a regular char, i.e. it can also appear as '='.
439 * As such, in 2.2 we used to allow reading unescaped '=', but we always
440 * produced escaped '\3D'; this changes since 2.3, if compatibility issues
441 * do not arise
443 #define LDAP_DN_NE(c) \
444 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_SEP(c) \
445 || LDAP_DN_QUOTES(c) \
446 || (c) == '<' || (c) == '>' )
447 #define LDAP_DN_MAYESCAPE(c) \
448 ( LDAP_DN_ESCAPE(c) || LDAP_DN_NE(c) \
449 || LDAP_DN_AVA_EQUALS(c) \
450 || LDAP_DN_ASCII_SPACE(c) || LDAP_DN_OCTOTHORPE(c) )
451 #define LDAP_DN_SHOULDESCAPE(c) ( LDAP_DN_AVA_EQUALS(c) )
453 #define LDAP_DN_NEEDESCAPE(c) \
454 ( LDAP_DN_ESCAPE(c) || LDAP_DN_NE(c) )
455 #define LDAP_DN_NEEDESCAPE_LEAD(c) LDAP_DN_MAYESCAPE(c)
456 #define LDAP_DN_NEEDESCAPE_TRAIL(c) \
457 ( LDAP_DN_ASCII_SPACE(c) || LDAP_DN_NEEDESCAPE(c) )
458 #define LDAP_DN_WILLESCAPE_CHAR(c) \
459 ( LDAP_DN_RDN_SEP(c) || LDAP_DN_AVA_SEP(c) || LDAP_DN_ESCAPE(c) )
460 #define LDAP_DN_IS_PRETTY(f) ( (f) & LDAP_DN_PRETTY )
461 #define LDAP_DN_WILLESCAPE_HEX(f, c) \
462 ( ( !LDAP_DN_IS_PRETTY( f ) ) && LDAP_DN_WILLESCAPE_CHAR(c) )
464 /* LDAPv2 */
465 #define LDAP_DN_VALUE_END_V2(c) \
466 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_SEP(c) )
467 /* RFC 1779 */
468 #define LDAP_DN_V2_SPECIAL(c) \
469 ( LDAP_DN_RDN_SEP_V2(c) || LDAP_DN_AVA_EQUALS(c) \
470 || LDAP_DN_AVA_SEP(c) || (c) == '<' || (c) == '>' \
471 || LDAP_DN_OCTOTHORPE(c) )
472 #define LDAP_DN_V2_PAIR(c) \
473 ( LDAP_DN_V2_SPECIAL(c) || LDAP_DN_ESCAPE(c) || LDAP_DN_QUOTES(c) )
476 * DCE (mostly from Luke Howard and IBM implementation for AIX)
478 * From: "Application Development Guide - Directory Services" (FIXME: add link?)
479 * Here escapes and valid chars for GDS are considered; as soon as more
480 * specific info is found, the macros will be updated.
482 * Chars: 'a'-'z', 'A'-'Z', '0'-'9',
483 * '.', ':', ',', ''', '+', '-', '=', '(', ')', '?', '/', ' '.
485 * Metachars: '/', ',', '=', '\'.
487 * the '\' is used to escape other metachars.
489 * Assertion: '='
490 * RDN separator: '/'
491 * AVA separator: ','
493 * Attribute types must start with alphabetic chars and can contain
494 * alphabetic chars and digits (FIXME: no '-'?). OIDs are allowed.
496 #define LDAP_DN_RDN_SEP_DCE(c) ( (c) == '/' )
497 #define LDAP_DN_AVA_SEP_DCE(c) ( (c) == ',' )
498 #define LDAP_DN_ESCAPE_DCE(c) ( LDAP_DN_ESCAPE(c) )
499 #define LDAP_DN_VALUE_END_DCE(c) \
500 ( LDAP_DN_RDN_SEP_DCE(c) || LDAP_DN_AVA_SEP_DCE(c) )
501 #define LDAP_DN_NEEDESCAPE_DCE(c) \
502 ( LDAP_DN_VALUE_END_DCE(c) || LDAP_DN_AVA_EQUALS(c) )
504 /* AD Canonical */
505 #define LDAP_DN_RDN_SEP_AD(c) ( (c) == '/' )
506 #define LDAP_DN_ESCAPE_AD(c) ( LDAP_DN_ESCAPE(c) )
507 #define LDAP_DN_AVA_SEP_AD(c) ( (c) == ',' ) /* assume same as DCE */
508 #define LDAP_DN_VALUE_END_AD(c) \
509 ( LDAP_DN_RDN_SEP_AD(c) || LDAP_DN_AVA_SEP_AD(c) )
510 #define LDAP_DN_NEEDESCAPE_AD(c) \
511 ( LDAP_DN_VALUE_END_AD(c) || LDAP_DN_AVA_EQUALS(c) )
513 /* generics */
514 #define LDAP_DN_HEXPAIR(s) \
515 ( LDAP_DN_ASCII_HEXDIGIT((s)[0]) && LDAP_DN_ASCII_HEXDIGIT((s)[1]) )
516 /* better look at the AttributeDescription? */
518 /* FIXME: no composite rdn or non-"dc" types, right?
519 * (what about "dc" in OID form?) */
520 /* FIXME: we do not allow binary values in domain, right? */
521 /* NOTE: use this macro only when ABSOLUTELY SURE rdn IS VALID! */
522 /* NOTE: don't use strcasecmp() as it is locale specific! */
523 #define LDAP_DC_ATTR "dc"
524 #define LDAP_DC_ATTRU "DC"
525 #define LDAP_DN_IS_RDN_DC( r ) \
526 ( (r) && (r)[0] && !(r)[1] \
527 && ((r)[0]->la_flags & LDAP_AVA_STRING) \
528 && ((r)[0]->la_attr.bv_len == 2) \
529 && (((r)[0]->la_attr.bv_val[0] == LDAP_DC_ATTR[0]) \
530 || ((r)[0]->la_attr.bv_val[0] == LDAP_DC_ATTRU[0])) \
531 && (((r)[0]->la_attr.bv_val[1] == LDAP_DC_ATTR[1]) \
532 || ((r)[0]->la_attr.bv_val[1] == LDAP_DC_ATTRU[1])))
534 /* Composite rules */
535 #define LDAP_DN_ALLOW_ONE_SPACE(f) \
536 ( LDAP_DN_LDAPV2(f) \
537 || !( (f) & LDAP_DN_P_NOSPACEAFTERRDN ) )
538 #define LDAP_DN_ALLOW_SPACES(f) \
539 ( LDAP_DN_LDAPV2(f) \
540 || !( (f) & ( LDAP_DN_P_NOLEADTRAILSPACES | LDAP_DN_P_NOSPACEAFTERRDN ) ) )
541 #define LDAP_DN_LDAP(f) \
542 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_LDAP )
543 #define LDAP_DN_LDAPV3(f) \
544 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_LDAPV3 )
545 #define LDAP_DN_LDAPV2(f) \
546 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_LDAPV2 )
547 #define LDAP_DN_DCE(f) \
548 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_DCE )
549 #define LDAP_DN_UFN(f) \
550 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_UFN )
551 #define LDAP_DN_ADC(f) \
552 ( ( (f) & LDAP_DN_FORMAT_MASK ) == LDAP_DN_FORMAT_AD_CANONICAL )
553 #define LDAP_DN_FORMAT(f) ( (f) & LDAP_DN_FORMAT_MASK )
556 * LDAPAVA helpers (will become part of the API for operations
557 * on structural representations of DNs).
559 static LDAPAVA *
560 ldapava_new( const struct berval *attr, const struct berval *val,
561 unsigned flags, void *ctx )
563 LDAPAVA *ava;
565 assert( attr != NULL );
566 assert( val != NULL );
568 ava = LDAP_MALLOCX( sizeof( LDAPAVA ) + attr->bv_len + 1, ctx );
570 if ( ava ) {
571 ava->la_attr.bv_len = attr->bv_len;
572 ava->la_attr.bv_val = (char *)(ava+1);
573 AC_MEMCPY( ava->la_attr.bv_val, attr->bv_val, attr->bv_len );
574 ava->la_attr.bv_val[attr->bv_len] = '\0';
576 ava->la_value = *val;
577 ava->la_flags = flags | LDAP_AVA_FREE_VALUE;
579 ava->la_private = NULL;
582 return( ava );
585 void
586 ldapava_free( LDAPAVA *ava, void *ctx )
588 assert( ava != NULL );
590 #if 0
591 /* ava's private must be freed by caller
592 * (at present let's skip this check because la_private
593 * basically holds static data) */
594 assert( ava->la_private == NULL );
595 #endif
597 if (ava->la_flags & LDAP_AVA_FREE_VALUE)
598 LDAP_FREEX( ava->la_value.bv_val, ctx );
600 LDAP_FREEX( ava, ctx );
603 void
604 ldap_rdnfree( LDAPRDN rdn )
606 ldap_rdnfree_x( rdn, NULL );
609 void
610 ldap_rdnfree_x( LDAPRDN rdn, void *ctx )
612 int iAVA;
614 if ( rdn == NULL ) {
615 return;
618 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
619 ldapava_free( rdn[ iAVA ], ctx );
622 LDAP_FREEX( rdn, ctx );
625 void
626 ldap_dnfree( LDAPDN dn )
628 ldap_dnfree_x( dn, NULL );
631 void
632 ldap_dnfree_x( LDAPDN dn, void *ctx )
634 int iRDN;
636 if ( dn == NULL ) {
637 return;
640 for ( iRDN = 0; dn[ iRDN ]; iRDN++ ) {
641 ldap_rdnfree_x( dn[ iRDN ], ctx );
644 LDAP_FREEX( dn, ctx );
648 * Converts a string representation of a DN (in LDAPv3, LDAPv2 or DCE)
649 * into a structural representation of the DN, by separating attribute
650 * types and values encoded in the more appropriate form, which is
651 * string or OID for attribute types and binary form of the BER encoded
652 * value or Unicode string. Formats different from LDAPv3 are parsed
653 * according to their own rules and turned into the more appropriate
654 * form according to LDAPv3.
656 * NOTE: I realize the code is getting spaghettish; it is rather
657 * experimental and will hopefully turn into something more simple
658 * and readable as soon as it works as expected.
662 * Default sizes of AVA and RDN static working arrays; if required
663 * the are dynamically resized. The values can be tuned in case
664 * of special requirements (e.g. very deep DN trees or high number
665 * of AVAs per RDN).
667 #define TMP_AVA_SLOTS 8
668 #define TMP_RDN_SLOTS 32
671 ldap_str2dn( LDAP_CONST char *str, LDAPDN *dn, unsigned flags )
673 struct berval bv;
675 assert( str != NULL );
677 bv.bv_len = strlen( str );
678 bv.bv_val = (char *) str;
680 return ldap_bv2dn_x( &bv, dn, flags, NULL );
684 ldap_bv2dn( struct berval *bv, LDAPDN *dn, unsigned flags )
686 return ldap_bv2dn_x( bv, dn, flags, NULL );
690 ldap_bv2dn_x( struct berval *bvin, LDAPDN *dn, unsigned flags, void *ctx )
692 const char *p;
693 int rc = LDAP_DECODING_ERROR;
694 int nrdns = 0;
696 LDAPDN newDN = NULL;
697 LDAPRDN newRDN = NULL, tmpDN_[TMP_RDN_SLOTS], *tmpDN = tmpDN_;
698 int num_slots = TMP_RDN_SLOTS;
699 char *str, *end;
700 struct berval bvtmp, *bv = &bvtmp;
702 assert( bvin != NULL );
703 assert( bvin->bv_val != NULL );
704 assert( dn != NULL );
706 *bv = *bvin;
707 str = bv->bv_val;
708 end = str + bv->bv_len;
710 Debug( LDAP_DEBUG_ARGS, "=> ldap_bv2dn(%s,%u)\n", str, flags, 0 );
712 *dn = NULL;
714 switch ( LDAP_DN_FORMAT( flags ) ) {
715 case LDAP_DN_FORMAT_LDAP:
716 case LDAP_DN_FORMAT_LDAPV3:
717 case LDAP_DN_FORMAT_DCE:
718 break;
720 /* allow DN enclosed in brackets */
721 case LDAP_DN_FORMAT_LDAPV2:
722 if ( str[0] == '<' ) {
723 if ( bv->bv_len < 2 || end[ -1 ] != '>' ) {
724 rc = LDAP_DECODING_ERROR;
725 goto parsing_error;
727 bv->bv_val++;
728 bv->bv_len -= 2;
729 str++;
730 end--;
732 break;
734 /* unsupported in str2dn */
735 case LDAP_DN_FORMAT_UFN:
736 case LDAP_DN_FORMAT_AD_CANONICAL:
737 return LDAP_PARAM_ERROR;
739 case LDAP_DN_FORMAT_LBER:
740 default:
741 return LDAP_PARAM_ERROR;
744 if ( bv->bv_len == 0 ) {
745 return LDAP_SUCCESS;
748 if( memchr( bv->bv_val, '\0', bv->bv_len ) != NULL ) {
749 /* value must have embedded NULs */
750 return LDAP_DECODING_ERROR;
753 p = str;
754 if ( LDAP_DN_DCE( flags ) ) {
757 * (from Luke Howard: thnx) A RDN separator is required
758 * at the beginning of an (absolute) DN.
760 if ( !LDAP_DN_RDN_SEP_DCE( p[ 0 ] ) ) {
761 goto parsing_error;
763 p++;
766 * actually we do not want to accept by default the DCE form,
767 * we do not want to auto-detect it
769 #if 0
770 } else if ( LDAP_DN_LDAP( flags ) ) {
772 * if dn starts with '/' let's make it a DCE dn
774 if ( LDAP_DN_RDN_SEP_DCE( p[ 0 ] ) ) {
775 flags |= LDAP_DN_FORMAT_DCE;
776 p++;
778 #endif
781 for ( ; p < end; p++ ) {
782 int err;
783 struct berval tmpbv;
784 tmpbv.bv_len = bv->bv_len - ( p - str );
785 tmpbv.bv_val = (char *)p;
787 err = ldap_bv2rdn_x( &tmpbv, &newRDN, (char **) &p, flags,ctx);
788 if ( err != LDAP_SUCCESS ) {
789 goto parsing_error;
793 * We expect a rdn separator
795 if ( p < end && p[ 0 ] ) {
796 switch ( LDAP_DN_FORMAT( flags ) ) {
797 case LDAP_DN_FORMAT_LDAPV3:
798 if ( !LDAP_DN_RDN_SEP( p[ 0 ] ) ) {
799 rc = LDAP_DECODING_ERROR;
800 goto parsing_error;
802 break;
804 case LDAP_DN_FORMAT_LDAP:
805 case LDAP_DN_FORMAT_LDAPV2:
806 if ( !LDAP_DN_RDN_SEP_V2( p[ 0 ] ) ) {
807 rc = LDAP_DECODING_ERROR;
808 goto parsing_error;
810 break;
812 case LDAP_DN_FORMAT_DCE:
813 if ( !LDAP_DN_RDN_SEP_DCE( p[ 0 ] ) ) {
814 rc = LDAP_DECODING_ERROR;
815 goto parsing_error;
817 break;
822 tmpDN[nrdns++] = newRDN;
823 newRDN = NULL;
826 * make the static RDN array dynamically rescalable
828 if ( nrdns == num_slots ) {
829 LDAPRDN *tmp;
831 if ( tmpDN == tmpDN_ ) {
832 tmp = LDAP_MALLOCX( num_slots * 2 * sizeof( LDAPRDN * ), ctx );
833 if ( tmp == NULL ) {
834 rc = LDAP_NO_MEMORY;
835 goto parsing_error;
837 AC_MEMCPY( tmp, tmpDN, num_slots * sizeof( LDAPRDN * ) );
839 } else {
840 tmp = LDAP_REALLOCX( tmpDN, num_slots * 2 * sizeof( LDAPRDN * ), ctx );
841 if ( tmp == NULL ) {
842 rc = LDAP_NO_MEMORY;
843 goto parsing_error;
847 tmpDN = tmp;
848 num_slots *= 2;
851 if ( p >= end || p[ 0 ] == '\0' ) {
853 * the DN is over, phew
855 newDN = (LDAPDN)LDAP_MALLOCX( sizeof(LDAPRDN *) * (nrdns+1), ctx );
856 if ( newDN == NULL ) {
857 rc = LDAP_NO_MEMORY;
858 goto parsing_error;
859 } else {
860 int i;
862 if ( LDAP_DN_DCE( flags ) ) {
863 /* add in reversed order */
864 for ( i=0; i<nrdns; i++ )
865 newDN[i] = tmpDN[nrdns-1-i];
866 } else {
867 for ( i=0; i<nrdns; i++ )
868 newDN[i] = tmpDN[i];
870 newDN[nrdns] = NULL;
871 rc = LDAP_SUCCESS;
873 goto return_result;
877 parsing_error:;
878 if ( newRDN ) {
879 ldap_rdnfree_x( newRDN, ctx );
882 for ( nrdns-- ;nrdns >= 0; nrdns-- ) {
883 ldap_rdnfree_x( tmpDN[nrdns], ctx );
886 return_result:;
888 if ( tmpDN != tmpDN_ ) {
889 LDAP_FREEX( tmpDN, ctx );
892 Debug( LDAP_DEBUG_ARGS, "<= ldap_bv2dn(%s)=%d %s\n", str, rc,
893 rc ? ldap_err2string( rc ) : "" );
894 *dn = newDN;
896 return( rc );
900 * ldap_str2rdn
902 * Parses a relative DN according to flags up to a rdn separator
903 * or to the end of str.
904 * Returns the rdn and a pointer to the string continuation, which
905 * corresponds to the rdn separator or to '\0' in case the string is over.
908 ldap_str2rdn( LDAP_CONST char *str, LDAPRDN *rdn,
909 char **n_in, unsigned flags )
911 struct berval bv;
913 assert( str != NULL );
914 assert( str[ 0 ] != '\0' ); /* FIXME: is this required? */
916 bv.bv_len = strlen( str );
917 bv.bv_val = (char *) str;
919 return ldap_bv2rdn_x( &bv, rdn, n_in, flags, NULL );
923 ldap_bv2rdn( struct berval *bv, LDAPRDN *rdn,
924 char **n_in, unsigned flags )
926 return ldap_bv2rdn_x( bv, rdn, n_in, flags, NULL );
930 ldap_bv2rdn_x( struct berval *bv, LDAPRDN *rdn,
931 char **n_in, unsigned flags, void *ctx )
933 const char **n = (const char **) n_in;
934 const char *p;
935 int navas = 0;
936 int state = B4AVA;
937 int rc = LDAP_DECODING_ERROR;
938 int attrTypeEncoding = LDAP_AVA_STRING,
939 attrValueEncoding = LDAP_AVA_STRING;
941 struct berval attrType = BER_BVNULL;
942 struct berval attrValue = BER_BVNULL;
944 LDAPRDN newRDN = NULL;
945 LDAPAVA *tmpRDN_[TMP_AVA_SLOTS], **tmpRDN = tmpRDN_;
946 int num_slots = TMP_AVA_SLOTS;
948 char *str;
949 ber_len_t stoplen;
951 assert( bv != NULL );
952 assert( bv->bv_len != 0 );
953 assert( bv->bv_val != NULL );
954 assert( rdn || flags & LDAP_DN_SKIP );
955 assert( n != NULL );
957 str = bv->bv_val;
958 stoplen = bv->bv_len;
960 if ( rdn ) {
961 *rdn = NULL;
963 *n = NULL;
965 switch ( LDAP_DN_FORMAT( flags ) ) {
966 case LDAP_DN_FORMAT_LDAP:
967 case LDAP_DN_FORMAT_LDAPV3:
968 case LDAP_DN_FORMAT_LDAPV2:
969 case LDAP_DN_FORMAT_DCE:
970 break;
972 /* unsupported in str2dn */
973 case LDAP_DN_FORMAT_UFN:
974 case LDAP_DN_FORMAT_AD_CANONICAL:
975 return LDAP_PARAM_ERROR;
977 case LDAP_DN_FORMAT_LBER:
978 default:
979 return LDAP_PARAM_ERROR;
982 if ( bv->bv_len == 0 ) {
983 return LDAP_SUCCESS;
987 if( memchr( bv->bv_val, '\0', bv->bv_len ) != NULL ) {
988 /* value must have embedded NULs */
989 return LDAP_DECODING_ERROR;
992 p = str;
993 for ( ; p[ 0 ] || state == GOTAVA; ) {
996 * The parser in principle advances one token a time,
997 * or toggles state if preferable.
999 switch (state) {
1002 * an AttributeType can be encoded as:
1003 * - its string representation; in detail, implementations
1004 * MUST recognize AttributeType string type names listed
1005 * in Section 3 of RFC 4514, and MAY recognize other names.
1006 * - its numeric OID (a dotted decimal string)
1008 case B4AVA:
1009 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1010 if ( !LDAP_DN_ALLOW_ONE_SPACE( flags ) ) {
1011 /* error */
1012 goto parsing_error;
1014 p++;
1017 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1018 if ( !LDAP_DN_ALLOW_SPACES( flags ) ) {
1019 /* error */
1020 goto parsing_error;
1023 /* whitespace is allowed (and trimmed) */
1024 p++;
1025 while ( p[ 0 ] && LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1026 p++;
1029 if ( !p[ 0 ] ) {
1030 /* error: we expected an AVA */
1031 goto parsing_error;
1035 /* oid */
1036 if ( LDAP_DN_OID_LEADCHAR( p[ 0 ] ) ) {
1037 state = B4OIDATTRTYPE;
1038 break;
1041 /* else must be alpha */
1042 if ( !LDAP_DN_DESC_LEADCHAR( p[ 0 ] ) ) {
1043 goto parsing_error;
1046 /* LDAPv2 "oid." prefix */
1047 if ( LDAP_DN_LDAPV2( flags ) ) {
1049 * to be overly pedantic, we only accept
1050 * "OID." or "oid."
1052 if ( flags & LDAP_DN_PEDANTIC ) {
1053 if ( !strncmp( p, "OID.", 4 )
1054 || !strncmp( p, "oid.", 4 ) ) {
1055 p += 4;
1056 state = B4OIDATTRTYPE;
1057 break;
1059 } else {
1060 if ( !strncasecmp( p, "oid.", 4 ) ) {
1061 p += 4;
1062 state = B4OIDATTRTYPE;
1063 break;
1068 state = B4STRINGATTRTYPE;
1069 break;
1071 case B4OIDATTRTYPE: {
1072 int err = LDAP_SUCCESS;
1074 attrType.bv_val = ldap_int_parse_numericoid( &p, &err,
1075 LDAP_SCHEMA_SKIP);
1077 if ( err != LDAP_SUCCESS ) {
1078 goto parsing_error;
1080 attrType.bv_len = p - attrType.bv_val;
1082 attrTypeEncoding = LDAP_AVA_BINARY;
1084 state = B4AVAEQUALS;
1085 break;
1088 case B4STRINGATTRTYPE: {
1089 const char *startPos, *endPos = NULL;
1090 ber_len_t len;
1093 * the starting char has been found to be
1094 * a LDAP_DN_DESC_LEADCHAR so we don't re-check it
1095 * FIXME: DCE attr types seem to have a more
1096 * restrictive syntax (no '-' ...)
1098 for ( startPos = p++; p[ 0 ]; p++ ) {
1099 if ( LDAP_DN_DESC_CHAR( p[ 0 ] ) ) {
1100 continue;
1103 if ( LDAP_DN_LANG_SEP( p[ 0 ] ) ) {
1106 * RFC 4514 explicitly does not allow attribute
1107 * description options, such as language tags.
1109 if ( flags & LDAP_DN_PEDANTIC ) {
1110 goto parsing_error;
1114 * we trim ';' and following lang
1115 * and so from attribute types
1117 endPos = p;
1118 for ( ; LDAP_DN_ATTRDESC_CHAR( p[ 0 ] )
1119 || LDAP_DN_LANG_SEP( p[ 0 ] ); p++ ) {
1120 /* no op */ ;
1122 break;
1124 break;
1127 len = ( endPos ? endPos : p ) - startPos;
1128 if ( len == 0 ) {
1129 goto parsing_error;
1132 attrTypeEncoding = LDAP_AVA_STRING;
1135 * here we need to decide whether to use it as is
1136 * or turn it in OID form; as a consequence, we
1137 * need to decide whether to binary encode the value
1140 state = B4AVAEQUALS;
1142 if ( flags & LDAP_DN_SKIP ) {
1143 break;
1146 attrType.bv_val = (char *)startPos;
1147 attrType.bv_len = len;
1149 break;
1152 case B4AVAEQUALS:
1153 /* spaces may not be allowed */
1154 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1155 if ( !LDAP_DN_ALLOW_SPACES( flags ) ) {
1156 goto parsing_error;
1159 /* trim spaces */
1160 for ( p++; LDAP_DN_ASCII_SPACE( p[ 0 ] ); p++ ) {
1161 /* no op */
1165 /* need equal sign */
1166 if ( !LDAP_DN_AVA_EQUALS( p[ 0 ] ) ) {
1167 goto parsing_error;
1169 p++;
1171 /* spaces may not be allowed */
1172 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1173 if ( !LDAP_DN_ALLOW_SPACES( flags ) ) {
1174 goto parsing_error;
1177 /* trim spaces */
1178 for ( p++; LDAP_DN_ASCII_SPACE( p[ 0 ] ); p++ ) {
1179 /* no op */
1184 * octothorpe means a BER encoded value will follow
1185 * FIXME: I don't think DCE will allow it
1187 if ( LDAP_DN_OCTOTHORPE( p[ 0 ] ) ) {
1188 p++;
1189 attrValueEncoding = LDAP_AVA_BINARY;
1190 state = B4BINARYVALUE;
1191 break;
1194 /* STRING value expected */
1197 * if we're pedantic, an attribute type in OID form
1198 * SHOULD imply a BER encoded attribute value; we
1199 * should at least issue a warning
1201 if ( ( flags & LDAP_DN_PEDANTIC )
1202 && ( attrTypeEncoding == LDAP_AVA_BINARY ) ) {
1203 /* OID attrType SHOULD use binary encoding */
1204 goto parsing_error;
1207 attrValueEncoding = LDAP_AVA_STRING;
1210 * LDAPv2 allows the attribute value to be quoted;
1211 * also, IA5 values are expected, in principle
1213 if ( LDAP_DN_LDAPV2( flags ) || LDAP_DN_LDAP( flags ) ) {
1214 if ( LDAP_DN_QUOTES( p[ 0 ] ) ) {
1215 p++;
1216 state = B4IA5VALUEQUOTED;
1217 break;
1220 if ( LDAP_DN_LDAPV2( flags ) ) {
1221 state = B4IA5VALUE;
1222 break;
1227 * here STRING means RFC 4514 string
1228 * FIXME: what about DCE strings?
1230 if ( !p[ 0 ] ) {
1231 /* empty value */
1232 state = GOTAVA;
1233 } else {
1234 state = B4STRINGVALUE;
1236 break;
1238 case B4BINARYVALUE:
1239 if ( hexstr2binval( p, &attrValue, &p, flags, ctx ) ) {
1240 goto parsing_error;
1243 state = GOTAVA;
1244 break;
1246 case B4STRINGVALUE:
1247 switch ( LDAP_DN_FORMAT( flags ) ) {
1248 case LDAP_DN_FORMAT_LDAP:
1249 case LDAP_DN_FORMAT_LDAPV3:
1250 if ( str2strval( p, stoplen - ( p - str ),
1251 &attrValue, &p, flags,
1252 &attrValueEncoding, ctx ) ) {
1253 goto parsing_error;
1255 break;
1257 case LDAP_DN_FORMAT_DCE:
1258 if ( DCE2strval( p, &attrValue, &p, flags, ctx ) ) {
1259 goto parsing_error;
1261 break;
1263 default:
1264 assert( 0 );
1267 state = GOTAVA;
1268 break;
1270 case B4IA5VALUE:
1271 if ( IA52strval( p, &attrValue, &p, flags, ctx ) ) {
1272 goto parsing_error;
1275 state = GOTAVA;
1276 break;
1278 case B4IA5VALUEQUOTED:
1280 /* lead quote already stripped */
1281 if ( quotedIA52strval( p, &attrValue,
1282 &p, flags, ctx ) ) {
1283 goto parsing_error;
1286 state = GOTAVA;
1287 break;
1289 case GOTAVA: {
1290 int rdnsep = 0;
1292 if ( !( flags & LDAP_DN_SKIP ) ) {
1293 LDAPAVA *ava;
1296 * we accept empty values
1298 ava = ldapava_new( &attrType, &attrValue,
1299 attrValueEncoding, ctx );
1300 if ( ava == NULL ) {
1301 rc = LDAP_NO_MEMORY;
1302 goto parsing_error;
1304 tmpRDN[navas++] = ava;
1306 attrValue.bv_val = NULL;
1307 attrValue.bv_len = 0;
1310 * prepare room for new AVAs if needed
1312 if (navas == num_slots) {
1313 LDAPAVA **tmp;
1315 if ( tmpRDN == tmpRDN_ ) {
1316 tmp = LDAP_MALLOCX( num_slots * 2 * sizeof( LDAPAVA * ), ctx );
1317 if ( tmp == NULL ) {
1318 rc = LDAP_NO_MEMORY;
1319 goto parsing_error;
1321 AC_MEMCPY( tmp, tmpRDN, num_slots * sizeof( LDAPAVA * ) );
1323 } else {
1324 tmp = LDAP_REALLOCX( tmpRDN, num_slots * 2 * sizeof( LDAPAVA * ), ctx );
1325 if ( tmp == NULL ) {
1326 rc = LDAP_NO_MEMORY;
1327 goto parsing_error;
1331 tmpRDN = tmp;
1332 num_slots *= 2;
1337 * if we got an AVA separator ('+', or ',' for DCE )
1338 * we expect a new AVA for this RDN; otherwise
1339 * we add the RDN to the DN
1341 switch ( LDAP_DN_FORMAT( flags ) ) {
1342 case LDAP_DN_FORMAT_LDAP:
1343 case LDAP_DN_FORMAT_LDAPV3:
1344 case LDAP_DN_FORMAT_LDAPV2:
1345 if ( !LDAP_DN_AVA_SEP( p[ 0 ] ) ) {
1346 rdnsep = 1;
1348 break;
1350 case LDAP_DN_FORMAT_DCE:
1351 if ( !LDAP_DN_AVA_SEP_DCE( p[ 0 ] ) ) {
1352 rdnsep = 1;
1354 break;
1357 if ( rdnsep ) {
1359 * the RDN is over, phew
1361 *n = p;
1362 if ( !( flags & LDAP_DN_SKIP ) ) {
1363 newRDN = (LDAPRDN)LDAP_MALLOCX(
1364 sizeof(LDAPAVA) * (navas+1), ctx );
1365 if ( newRDN == NULL ) {
1366 rc = LDAP_NO_MEMORY;
1367 goto parsing_error;
1368 } else {
1369 AC_MEMCPY( newRDN, tmpRDN, sizeof(LDAPAVA *) * navas);
1370 newRDN[navas] = NULL;
1374 rc = LDAP_SUCCESS;
1375 goto return_result;
1378 /* they should have been used in an AVA */
1379 attrType.bv_val = NULL;
1380 attrValue.bv_val = NULL;
1382 p++;
1383 state = B4AVA;
1384 break;
1387 default:
1388 assert( 0 );
1389 goto parsing_error;
1392 *n = p;
1394 parsing_error:;
1395 /* They are set to NULL after they're used in an AVA */
1397 if ( attrValue.bv_val ) {
1398 LDAP_FREEX( attrValue.bv_val, ctx );
1401 for ( navas-- ; navas >= 0; navas-- ) {
1402 ldapava_free( tmpRDN[navas], ctx );
1405 return_result:;
1407 if ( tmpRDN != tmpRDN_ ) {
1408 LDAP_FREEX( tmpRDN, ctx );
1411 if ( rdn ) {
1412 *rdn = newRDN;
1415 return( rc );
1419 * reads in a UTF-8 string value, unescaping stuff:
1420 * '\' + LDAP_DN_NEEDESCAPE(c) -> 'c'
1421 * '\' + HEXPAIR(p) -> unhex(p)
1423 static int
1424 str2strval( const char *str, ber_len_t stoplen, struct berval *val, const char **next, unsigned flags, int *retFlags, void *ctx )
1426 const char *p, *end, *startPos, *endPos = NULL;
1427 ber_len_t len, escapes;
1429 assert( str != NULL );
1430 assert( val != NULL );
1431 assert( next != NULL );
1433 *next = NULL;
1434 end = str + stoplen;
1435 for ( startPos = p = str, escapes = 0; p < end; p++ ) {
1436 if ( LDAP_DN_ESCAPE( p[ 0 ] ) ) {
1437 p++;
1438 if ( p[ 0 ] == '\0' ) {
1439 return( 1 );
1441 if ( LDAP_DN_MAYESCAPE( p[ 0 ] ) ) {
1442 escapes++;
1443 continue;
1446 if ( LDAP_DN_HEXPAIR( p ) ) {
1447 char c;
1449 hexstr2bin( p, &c );
1450 escapes += 2;
1452 if ( !LDAP_DN_ASCII_PRINTABLE( c ) ) {
1455 * we assume the string is UTF-8
1457 *retFlags = LDAP_AVA_NONPRINTABLE;
1459 p++;
1461 continue;
1464 if ( LDAP_DN_PEDANTIC & flags ) {
1465 return( 1 );
1468 * we do not allow escaping
1469 * of chars that don't need
1470 * to and do not belong to
1471 * HEXDIGITS
1473 return( 1 );
1475 } else if ( !LDAP_DN_ASCII_PRINTABLE( p[ 0 ] ) ) {
1476 if ( p[ 0 ] == '\0' ) {
1477 return( 1 );
1479 *retFlags = LDAP_AVA_NONPRINTABLE;
1481 } else if ( ( LDAP_DN_LDAP( flags ) && LDAP_DN_VALUE_END_V2( p[ 0 ] ) )
1482 || ( LDAP_DN_LDAPV3( flags ) && LDAP_DN_VALUE_END( p[ 0 ] ) ) ) {
1483 break;
1485 } else if ( LDAP_DN_NEEDESCAPE( p[ 0 ] ) ) {
1487 * FIXME: maybe we can add
1488 * escapes if not pedantic?
1490 return( 1 );
1495 * we do allow unescaped spaces at the end
1496 * of the value only in non-pedantic mode
1498 if ( p > startPos + 1 && LDAP_DN_ASCII_SPACE( p[ -1 ] ) &&
1499 !LDAP_DN_ESCAPE( p[ -2 ] ) ) {
1500 if ( flags & LDAP_DN_PEDANTIC ) {
1501 return( 1 );
1504 /* strip trailing (unescaped) spaces */
1505 for ( endPos = p - 1;
1506 endPos > startPos + 1 &&
1507 LDAP_DN_ASCII_SPACE( endPos[ -1 ] ) &&
1508 !LDAP_DN_ESCAPE( endPos[ -2 ] );
1509 endPos-- ) {
1510 /* no op */
1514 *next = p;
1515 if ( flags & LDAP_DN_SKIP ) {
1516 return( 0 );
1520 * FIXME: test memory?
1522 len = ( endPos ? endPos : p ) - startPos - escapes;
1523 val->bv_len = len;
1525 if ( escapes == 0 ) {
1526 if ( *retFlags & LDAP_AVA_NONPRINTABLE ) {
1527 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1528 AC_MEMCPY( val->bv_val, startPos, len );
1529 val->bv_val[ len ] = '\0';
1530 } else {
1531 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1534 } else {
1535 ber_len_t s, d;
1537 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1538 for ( s = 0, d = 0; d < len; ) {
1539 if ( LDAP_DN_ESCAPE( startPos[ s ] ) ) {
1540 s++;
1541 if ( LDAP_DN_MAYESCAPE( startPos[ s ] ) ) {
1542 val->bv_val[ d++ ] =
1543 startPos[ s++ ];
1545 } else if ( LDAP_DN_HEXPAIR( &startPos[ s ] ) ) {
1546 char c;
1548 hexstr2bin( &startPos[ s ], &c );
1549 val->bv_val[ d++ ] = c;
1550 s += 2;
1552 } else {
1553 /* we should never get here */
1554 assert( 0 );
1557 } else {
1558 val->bv_val[ d++ ] = startPos[ s++ ];
1562 val->bv_val[ d ] = '\0';
1563 assert( d == len );
1566 return( 0 );
1569 static int
1570 DCE2strval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1572 const char *p, *startPos, *endPos = NULL;
1573 ber_len_t len, escapes;
1575 assert( str != NULL );
1576 assert( val != NULL );
1577 assert( next != NULL );
1579 *next = NULL;
1581 for ( startPos = p = str, escapes = 0; p[ 0 ]; p++ ) {
1582 if ( LDAP_DN_ESCAPE_DCE( p[ 0 ] ) ) {
1583 p++;
1584 if ( LDAP_DN_NEEDESCAPE_DCE( p[ 0 ] ) ) {
1585 escapes++;
1587 } else {
1588 return( 1 );
1591 } else if ( LDAP_DN_VALUE_END_DCE( p[ 0 ] ) ) {
1592 break;
1596 * FIXME: can we accept anything else? I guess we need
1597 * to stop if a value is not legal
1602 * (unescaped) trailing spaces are trimmed must be silently ignored;
1603 * so we eat them
1605 if ( p > startPos + 1 && LDAP_DN_ASCII_SPACE( p[ -1 ] ) &&
1606 !LDAP_DN_ESCAPE( p[ -2 ] ) ) {
1607 if ( flags & LDAP_DN_PEDANTIC ) {
1608 return( 1 );
1611 /* strip trailing (unescaped) spaces */
1612 for ( endPos = p - 1;
1613 endPos > startPos + 1 &&
1614 LDAP_DN_ASCII_SPACE( endPos[ -1 ] ) &&
1615 !LDAP_DN_ESCAPE( endPos[ -2 ] );
1616 endPos-- ) {
1617 /* no op */
1621 *next = p;
1622 if ( flags & LDAP_DN_SKIP ) {
1623 return( 0 );
1626 len = ( endPos ? endPos : p ) - startPos - escapes;
1627 val->bv_len = len;
1628 if ( escapes == 0 ){
1629 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1631 } else {
1632 ber_len_t s, d;
1634 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1635 for ( s = 0, d = 0; d < len; ) {
1637 * This point is reached only if escapes
1638 * are properly used, so all we need to
1639 * do is eat them
1641 if ( LDAP_DN_ESCAPE_DCE( startPos[ s ] ) ) {
1642 s++;
1645 val->bv_val[ d++ ] = startPos[ s++ ];
1647 val->bv_val[ d ] = '\0';
1648 assert( strlen( val->bv_val ) == len );
1651 return( 0 );
1654 static int
1655 IA52strval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1657 const char *p, *startPos, *endPos = NULL;
1658 ber_len_t len, escapes;
1660 assert( str != NULL );
1661 assert( val != NULL );
1662 assert( next != NULL );
1664 *next = NULL;
1667 * LDAPv2 (RFC 1779)
1670 for ( startPos = p = str, escapes = 0; p[ 0 ]; p++ ) {
1671 if ( LDAP_DN_ESCAPE( p[ 0 ] ) ) {
1672 p++;
1673 if ( p[ 0 ] == '\0' ) {
1674 return( 1 );
1677 if ( !LDAP_DN_NEEDESCAPE( p[ 0 ] )
1678 && ( LDAP_DN_PEDANTIC & flags ) ) {
1679 return( 1 );
1681 escapes++;
1683 } else if ( LDAP_DN_VALUE_END_V2( p[ 0 ] ) ) {
1684 break;
1688 * FIXME: can we accept anything else? I guess we need
1689 * to stop if a value is not legal
1693 /* strip trailing (unescaped) spaces */
1694 for ( endPos = p;
1695 endPos > startPos + 1 &&
1696 LDAP_DN_ASCII_SPACE( endPos[ -1 ] ) &&
1697 !LDAP_DN_ESCAPE( endPos[ -2 ] );
1698 endPos-- ) {
1699 /* no op */
1702 *next = p;
1703 if ( flags & LDAP_DN_SKIP ) {
1704 return( 0 );
1707 len = ( endPos ? endPos : p ) - startPos - escapes;
1708 val->bv_len = len;
1709 if ( escapes == 0 ) {
1710 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1712 } else {
1713 ber_len_t s, d;
1715 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1716 for ( s = 0, d = 0; d < len; ) {
1717 if ( LDAP_DN_ESCAPE( startPos[ s ] ) ) {
1718 s++;
1720 val->bv_val[ d++ ] = startPos[ s++ ];
1722 val->bv_val[ d ] = '\0';
1723 assert( strlen( val->bv_val ) == len );
1726 return( 0 );
1729 static int
1730 quotedIA52strval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1732 const char *p, *startPos, *endPos = NULL;
1733 ber_len_t len;
1734 unsigned escapes = 0;
1736 assert( str != NULL );
1737 assert( val != NULL );
1738 assert( next != NULL );
1740 *next = NULL;
1742 /* initial quote already eaten */
1743 for ( startPos = p = str; p[ 0 ]; p++ ) {
1745 * According to RFC 1779, the quoted value can
1746 * contain escaped as well as unescaped special values;
1747 * as a consequence we tolerate escaped values
1748 * (e.g. '"\,"' -> '\,') and escape unescaped specials
1749 * (e.g. '","' -> '\,').
1751 if ( LDAP_DN_ESCAPE( p[ 0 ] ) ) {
1752 if ( p[ 1 ] == '\0' ) {
1753 return( 1 );
1755 p++;
1757 if ( !LDAP_DN_V2_PAIR( p[ 0 ] )
1758 && ( LDAP_DN_PEDANTIC & flags ) ) {
1760 * do we allow to escape normal chars?
1761 * LDAPv2 does not allow any mechanism
1762 * for escaping chars with '\' and hex
1763 * pair
1765 return( 1 );
1767 escapes++;
1769 } else if ( LDAP_DN_QUOTES( p[ 0 ] ) ) {
1770 endPos = p;
1771 /* eat closing quotes */
1772 p++;
1773 break;
1777 * FIXME: can we accept anything else? I guess we need
1778 * to stop if a value is not legal
1782 if ( endPos == NULL ) {
1783 return( 1 );
1786 /* Strip trailing (unescaped) spaces */
1787 for ( ; p[ 0 ] && LDAP_DN_ASCII_SPACE( p[ 0 ] ); p++ ) {
1788 /* no op */
1791 *next = p;
1792 if ( flags & LDAP_DN_SKIP ) {
1793 return( 0 );
1796 len = endPos - startPos - escapes;
1797 assert( endPos >= startPos + escapes );
1798 val->bv_len = len;
1799 if ( escapes == 0 ) {
1800 val->bv_val = LDAP_STRNDUPX( startPos, len, ctx );
1802 } else {
1803 ber_len_t s, d;
1805 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1806 val->bv_len = len;
1808 for ( s = d = 0; d < len; ) {
1809 if ( LDAP_DN_ESCAPE( str[ s ] ) ) {
1810 s++;
1812 val->bv_val[ d++ ] = str[ s++ ];
1814 val->bv_val[ d ] = '\0';
1815 assert( strlen( val->bv_val ) == len );
1818 return( 0 );
1821 static int
1822 hexstr2bin( const char *str, char *c )
1824 char c1, c2;
1826 assert( str != NULL );
1827 assert( c != NULL );
1829 c1 = str[ 0 ];
1830 c2 = str[ 1 ];
1832 if ( LDAP_DN_ASCII_DIGIT( c1 ) ) {
1833 *c = c1 - '0';
1835 } else {
1836 if ( LDAP_DN_ASCII_UCASE_HEXALPHA( c1 ) ) {
1837 *c = c1 - 'A' + 10;
1838 } else {
1839 assert( LDAP_DN_ASCII_LCASE_HEXALPHA( c1 ) );
1840 *c = c1 - 'a' + 10;
1844 *c <<= 4;
1846 if ( LDAP_DN_ASCII_DIGIT( c2 ) ) {
1847 *c += c2 - '0';
1849 } else {
1850 if ( LDAP_DN_ASCII_UCASE_HEXALPHA( c2 ) ) {
1851 *c += c2 - 'A' + 10;
1852 } else {
1853 assert( LDAP_DN_ASCII_LCASE_HEXALPHA( c2 ) );
1854 *c += c2 - 'a' + 10;
1858 return( 0 );
1861 static int
1862 hexstr2binval( const char *str, struct berval *val, const char **next, unsigned flags, void *ctx )
1864 const char *p, *startPos, *endPos = NULL;
1865 ber_len_t len;
1866 ber_len_t s, d;
1868 assert( str != NULL );
1869 assert( val != NULL );
1870 assert( next != NULL );
1872 *next = NULL;
1874 for ( startPos = p = str; p[ 0 ]; p += 2 ) {
1875 switch ( LDAP_DN_FORMAT( flags ) ) {
1876 case LDAP_DN_FORMAT_LDAPV3:
1877 if ( LDAP_DN_VALUE_END( p[ 0 ] ) ) {
1878 goto end_of_value;
1880 break;
1882 case LDAP_DN_FORMAT_LDAP:
1883 case LDAP_DN_FORMAT_LDAPV2:
1884 if ( LDAP_DN_VALUE_END_V2( p[ 0 ] ) ) {
1885 goto end_of_value;
1887 break;
1889 case LDAP_DN_FORMAT_DCE:
1890 if ( LDAP_DN_VALUE_END_DCE( p[ 0 ] ) ) {
1891 goto end_of_value;
1893 break;
1896 if ( LDAP_DN_ASCII_SPACE( p[ 0 ] ) ) {
1897 if ( flags & LDAP_DN_PEDANTIC ) {
1898 return( 1 );
1900 endPos = p;
1902 for ( ; p[ 0 ]; p++ ) {
1903 switch ( LDAP_DN_FORMAT( flags ) ) {
1904 case LDAP_DN_FORMAT_LDAPV3:
1905 if ( LDAP_DN_VALUE_END( p[ 0 ] ) ) {
1906 goto end_of_value;
1908 break;
1910 case LDAP_DN_FORMAT_LDAP:
1911 case LDAP_DN_FORMAT_LDAPV2:
1912 if ( LDAP_DN_VALUE_END_V2( p[ 0 ] ) ) {
1913 goto end_of_value;
1915 break;
1917 case LDAP_DN_FORMAT_DCE:
1918 if ( LDAP_DN_VALUE_END_DCE( p[ 0 ] ) ) {
1919 goto end_of_value;
1921 break;
1924 break;
1927 if ( !LDAP_DN_HEXPAIR( p ) ) {
1928 return( 1 );
1932 end_of_value:;
1934 *next = p;
1935 if ( flags & LDAP_DN_SKIP ) {
1936 return( 0 );
1939 len = ( ( endPos ? endPos : p ) - startPos ) / 2;
1940 /* must be even! */
1941 assert( 2 * len == (ber_len_t) (( endPos ? endPos : p ) - startPos ));
1943 val->bv_len = len;
1944 val->bv_val = LDAP_MALLOCX( len + 1, ctx );
1945 if ( val->bv_val == NULL ) {
1946 return( LDAP_NO_MEMORY );
1949 for ( s = 0, d = 0; d < len; s += 2, d++ ) {
1950 char c;
1952 hexstr2bin( &startPos[ s ], &c );
1954 val->bv_val[ d ] = c;
1957 val->bv_val[ d ] = '\0';
1959 return( 0 );
1963 * convert a byte in a hexadecimal pair
1965 static int
1966 byte2hexpair( const char *val, char *pair )
1968 static const char hexdig[] = "0123456789ABCDEF";
1970 assert( val != NULL );
1971 assert( pair != NULL );
1974 * we assume the string has enough room for the hex encoding
1975 * of the value
1978 pair[ 0 ] = hexdig[ 0x0f & ( val[ 0 ] >> 4 ) ];
1979 pair[ 1 ] = hexdig[ 0x0f & val[ 0 ] ];
1981 return( 0 );
1985 * convert a binary value in hexadecimal pairs
1987 static int
1988 binval2hexstr( struct berval *val, char *str )
1990 ber_len_t s, d;
1992 assert( val != NULL );
1993 assert( str != NULL );
1995 if ( val->bv_len == 0 ) {
1996 return( 0 );
2000 * we assume the string has enough room for the hex encoding
2001 * of the value
2004 for ( s = 0, d = 0; s < val->bv_len; s++, d += 2 ) {
2005 byte2hexpair( &val->bv_val[ s ], &str[ d ] );
2008 return( 0 );
2012 * Length of the string representation, accounting for escaped hex
2013 * of UTF-8 chars
2015 static int
2016 strval2strlen( struct berval *val, unsigned flags, ber_len_t *len )
2018 ber_len_t l, cl = 1;
2019 char *p, *end;
2020 int escaped_byte_len = LDAP_DN_IS_PRETTY( flags ) ? 1 : 3;
2021 #ifdef PRETTY_ESCAPE
2022 int escaped_ascii_len = LDAP_DN_IS_PRETTY( flags ) ? 2 : 3;
2023 #endif /* PRETTY_ESCAPE */
2025 assert( val != NULL );
2026 assert( len != NULL );
2028 *len = 0;
2029 if ( val->bv_len == 0 ) {
2030 return( 0 );
2033 end = val->bv_val + val->bv_len - 1;
2034 for ( l = 0, p = val->bv_val; p <= end; p += cl ) {
2037 * escape '%x00'
2039 if ( p[ 0 ] == '\0' ) {
2040 cl = 1;
2041 l += 3;
2042 continue;
2045 cl = LDAP_UTF8_CHARLEN2( p, cl );
2046 if ( cl == 0 ) {
2047 /* illegal utf-8 char! */
2048 return( -1 );
2050 } else if ( cl > 1 ) {
2051 ber_len_t cnt;
2053 for ( cnt = 1; cnt < cl; cnt++ ) {
2054 if ( ( p[ cnt ] & 0xc0 ) != 0x80 ) {
2055 return( -1 );
2058 l += escaped_byte_len * cl;
2060 } else if ( LDAP_DN_NEEDESCAPE( p[ 0 ] )
2061 || LDAP_DN_SHOULDESCAPE( p[ 0 ] )
2062 || ( p == val->bv_val && LDAP_DN_NEEDESCAPE_LEAD( p[ 0 ] ) )
2063 || ( p == end && LDAP_DN_NEEDESCAPE_TRAIL( p[ 0 ] ) ) ) {
2064 #ifdef PRETTY_ESCAPE
2065 #if 0
2066 if ( LDAP_DN_WILLESCAPE_HEX( flags, p[ 0 ] ) ) {
2067 #else
2068 if ( LDAP_DN_WILLESCAPE_CHAR( p[ 0 ] ) ) {
2069 #endif
2072 * there might be some chars we want
2073 * to escape in form of a couple
2074 * of hexdigits for optimization purposes
2076 l += 3;
2078 } else {
2079 l += escaped_ascii_len;
2081 #else /* ! PRETTY_ESCAPE */
2082 l += 3;
2083 #endif /* ! PRETTY_ESCAPE */
2085 } else {
2086 l++;
2090 *len = l;
2092 return( 0 );
2096 * convert to string representation, escaping with hex the UTF-8 stuff;
2097 * assume the destination has enough room for escaping
2099 static int
2100 strval2str( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2102 ber_len_t s, d, end;
2104 assert( val != NULL );
2105 assert( str != NULL );
2106 assert( len != NULL );
2108 if ( val->bv_len == 0 ) {
2109 *len = 0;
2110 return( 0 );
2114 * we assume the string has enough room for the hex encoding
2115 * of the value
2117 for ( s = 0, d = 0, end = val->bv_len - 1; s < val->bv_len; ) {
2118 ber_len_t cl;
2121 * escape '%x00'
2123 if ( val->bv_val[ s ] == '\0' ) {
2124 cl = 1;
2125 str[ d++ ] = '\\';
2126 str[ d++ ] = '0';
2127 str[ d++ ] = '0';
2128 s++;
2129 continue;
2133 * The length was checked in strval2strlen();
2134 * LDAP_UTF8_CHARLEN() should suffice
2136 cl = LDAP_UTF8_CHARLEN2( &val->bv_val[ s ], cl );
2137 assert( cl > 0 );
2140 * there might be some chars we want to escape in form
2141 * of a couple of hexdigits for optimization purposes
2143 if ( ( cl > 1 && !LDAP_DN_IS_PRETTY( flags ) )
2144 #ifdef PRETTY_ESCAPE
2145 #if 0
2146 || LDAP_DN_WILLESCAPE_HEX( flags, val->bv_val[ s ] )
2147 #else
2148 || LDAP_DN_WILLESCAPE_CHAR( val->bv_val[ s ] )
2149 #endif
2150 #else /* ! PRETTY_ESCAPE */
2151 || LDAP_DN_NEEDESCAPE( val->bv_val[ s ] )
2152 || LDAP_DN_SHOULDESCAPE( val->bv_val[ s ] )
2153 || ( d == 0 && LDAP_DN_NEEDESCAPE_LEAD( val->bv_val[ s ] ) )
2154 || ( s == end && LDAP_DN_NEEDESCAPE_TRAIL( val->bv_val[ s ] ) )
2156 #endif /* ! PRETTY_ESCAPE */
2158 for ( ; cl--; ) {
2159 str[ d++ ] = '\\';
2160 byte2hexpair( &val->bv_val[ s ], &str[ d ] );
2161 s++;
2162 d += 2;
2165 } else if ( cl > 1 ) {
2166 for ( ; cl--; ) {
2167 str[ d++ ] = val->bv_val[ s++ ];
2170 } else {
2171 #ifdef PRETTY_ESCAPE
2172 if ( LDAP_DN_NEEDESCAPE( val->bv_val[ s ] )
2173 || LDAP_DN_SHOULDESCAPE( val->bv_val[ s ] )
2174 || ( d == 0 && LDAP_DN_NEEDESCAPE_LEAD( val->bv_val[ s ] ) )
2175 || ( s == end && LDAP_DN_NEEDESCAPE_TRAIL( val->bv_val[ s ] ) ) ) {
2176 str[ d++ ] = '\\';
2177 if ( !LDAP_DN_IS_PRETTY( flags ) ) {
2178 byte2hexpair( &val->bv_val[ s ], &str[ d ] );
2179 s++;
2180 d += 2;
2181 continue;
2184 #endif /* PRETTY_ESCAPE */
2185 str[ d++ ] = val->bv_val[ s++ ];
2189 *len = d;
2191 return( 0 );
2195 * Length of the IA5 string representation (no UTF-8 allowed)
2197 static int
2198 strval2IA5strlen( struct berval *val, unsigned flags, ber_len_t *len )
2200 ber_len_t l;
2201 char *p;
2203 assert( val != NULL );
2204 assert( len != NULL );
2206 *len = 0;
2207 if ( val->bv_len == 0 ) {
2208 return( 0 );
2211 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2213 * Turn value into a binary encoded BER
2215 return( -1 );
2217 } else {
2218 for ( l = 0, p = val->bv_val; p[ 0 ]; p++ ) {
2219 if ( LDAP_DN_NEEDESCAPE( p[ 0 ] )
2220 || LDAP_DN_SHOULDESCAPE( p[ 0 ] )
2221 || ( p == val->bv_val && LDAP_DN_NEEDESCAPE_LEAD( p[ 0 ] ) )
2222 || ( !p[ 1 ] && LDAP_DN_NEEDESCAPE_TRAIL( p[ 0 ] ) ) ) {
2223 l += 2;
2225 } else {
2226 l++;
2231 *len = l;
2233 return( 0 );
2237 * convert to string representation (np UTF-8)
2238 * assume the destination has enough room for escaping
2240 static int
2241 strval2IA5str( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2243 ber_len_t s, d, end;
2245 assert( val != NULL );
2246 assert( str != NULL );
2247 assert( len != NULL );
2249 if ( val->bv_len == 0 ) {
2250 *len = 0;
2251 return( 0 );
2254 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2256 * Turn value into a binary encoded BER
2258 *len = 0;
2259 return( -1 );
2261 } else {
2263 * we assume the string has enough room for the hex encoding
2264 * of the value
2267 for ( s = 0, d = 0, end = val->bv_len - 1; s < val->bv_len; ) {
2268 if ( LDAP_DN_NEEDESCAPE( val->bv_val[ s ] )
2269 || LDAP_DN_SHOULDESCAPE( val->bv_val[ s ] )
2270 || ( s == 0 && LDAP_DN_NEEDESCAPE_LEAD( val->bv_val[ s ] ) )
2271 || ( s == end && LDAP_DN_NEEDESCAPE_TRAIL( val->bv_val[ s ] ) ) ) {
2272 str[ d++ ] = '\\';
2274 str[ d++ ] = val->bv_val[ s++ ];
2278 *len = d;
2280 return( 0 );
2284 * Length of the (supposedly) DCE string representation,
2285 * accounting for escaped hex of UTF-8 chars
2287 static int
2288 strval2DCEstrlen( struct berval *val, unsigned flags, ber_len_t *len )
2290 ber_len_t l;
2291 char *p;
2293 assert( val != NULL );
2294 assert( len != NULL );
2296 *len = 0;
2297 if ( val->bv_len == 0 ) {
2298 return( 0 );
2301 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2303 * FIXME: Turn the value into a binary encoded BER?
2305 return( -1 );
2307 } else {
2308 for ( l = 0, p = val->bv_val; p[ 0 ]; p++ ) {
2309 if ( LDAP_DN_NEEDESCAPE_DCE( p[ 0 ] ) ) {
2310 l += 2;
2312 } else {
2313 l++;
2318 *len = l;
2320 return( 0 );
2324 * convert to (supposedly) DCE string representation,
2325 * escaping with hex the UTF-8 stuff;
2326 * assume the destination has enough room for escaping
2328 static int
2329 strval2DCEstr( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2331 ber_len_t s, d;
2333 assert( val != NULL );
2334 assert( str != NULL );
2335 assert( len != NULL );
2337 if ( val->bv_len == 0 ) {
2338 *len = 0;
2339 return( 0 );
2342 if ( flags & LDAP_AVA_NONPRINTABLE ) {
2344 * FIXME: Turn the value into a binary encoded BER?
2346 *len = 0;
2347 return( -1 );
2349 } else {
2352 * we assume the string has enough room for the hex encoding
2353 * of the value
2356 for ( s = 0, d = 0; s < val->bv_len; ) {
2357 if ( LDAP_DN_NEEDESCAPE_DCE( val->bv_val[ s ] ) ) {
2358 str[ d++ ] = '\\';
2360 str[ d++ ] = val->bv_val[ s++ ];
2364 *len = d;
2366 return( 0 );
2370 * Length of the (supposedly) AD canonical string representation,
2371 * accounting for chars that need to be escaped
2373 static int
2374 strval2ADstrlen( struct berval *val, unsigned flags, ber_len_t *len )
2376 ber_len_t l, cl;
2377 char *p;
2379 assert( val != NULL );
2380 assert( len != NULL );
2382 *len = 0;
2383 if ( val->bv_len == 0 ) {
2384 return( 0 );
2387 for ( l = 0, p = val->bv_val; p[ 0 ]; p += cl ) {
2388 cl = LDAP_UTF8_CHARLEN2( p, cl );
2389 if ( cl == 0 ) {
2390 /* illegal utf-8 char */
2391 return -1;
2392 } else if ( (cl == 1) && LDAP_DN_NEEDESCAPE_AD( p[ 0 ] ) ) {
2393 l += 2;
2394 } else {
2395 l += cl;
2399 *len = l;
2401 return( 0 );
2405 * convert to (supposedly) AD string representation,
2406 * assume the destination has enough room for escaping
2408 static int
2409 strval2ADstr( struct berval *val, char *str, unsigned flags, ber_len_t *len )
2411 ber_len_t s, d, cl;
2413 assert( val != NULL );
2414 assert( str != NULL );
2415 assert( len != NULL );
2417 if ( val->bv_len == 0 ) {
2418 *len = 0;
2419 return( 0 );
2423 * we assume the string has enough room for the escaping
2424 * of the value
2427 for ( s = 0, d = 0; s < val->bv_len; ) {
2428 cl = LDAP_UTF8_CHARLEN2( val->bv_val+s, cl );
2429 if ( cl == 0 ) {
2430 /* illegal utf-8 char */
2431 return -1;
2432 } else if ( (cl == 1) && LDAP_DN_NEEDESCAPE_AD(val->bv_val[ s ]) ) {
2433 str[ d++ ] = '\\';
2435 for (; cl--;) {
2436 str[ d++ ] = val->bv_val[ s++ ];
2440 *len = d;
2442 return( 0 );
2446 * If the DN is terminated by single-AVA RDNs with attribute type of "dc",
2447 * the first part of the AD representation of the DN is written in DNS
2448 * form, i.e. dot separated domain name components (as suggested
2449 * by Luke Howard, http://www.padl.com/~lukeh)
2451 static int
2452 dn2domain( LDAPDN dn, struct berval *bv, int pos, int *iRDN )
2454 int i;
2455 int domain = 0, first = 1;
2456 ber_len_t l = 1; /* we move the null also */
2457 char *str;
2459 /* we are guaranteed there's enough memory in str */
2461 /* sanity */
2462 assert( dn != NULL );
2463 assert( bv != NULL );
2464 assert( iRDN != NULL );
2465 assert( *iRDN >= 0 );
2467 str = bv->bv_val + pos;
2469 for ( i = *iRDN; i >= 0; i-- ) {
2470 LDAPRDN rdn;
2471 LDAPAVA *ava;
2473 assert( dn[ i ] != NULL );
2474 rdn = dn[ i ];
2476 assert( rdn[ 0 ] != NULL );
2477 ava = rdn[ 0 ];
2479 if ( !LDAP_DN_IS_RDN_DC( rdn ) ) {
2480 break;
2483 domain = 1;
2485 if ( first ) {
2486 first = 0;
2487 AC_MEMCPY( str, ava->la_value.bv_val,
2488 ava->la_value.bv_len + 1);
2489 l += ava->la_value.bv_len;
2491 } else {
2492 AC_MEMCPY( str + ava->la_value.bv_len + 1, bv->bv_val + pos, l);
2493 AC_MEMCPY( str, ava->la_value.bv_val,
2494 ava->la_value.bv_len );
2495 str[ ava->la_value.bv_len ] = '.';
2496 l += ava->la_value.bv_len + 1;
2500 *iRDN = i;
2501 bv->bv_len = pos + l - 1;
2503 return( domain );
2506 static int
2507 rdn2strlen( LDAPRDN rdn, unsigned flags, ber_len_t *len,
2508 int ( *s2l )( struct berval *v, unsigned f, ber_len_t *l ) )
2510 int iAVA;
2511 ber_len_t l = 0;
2513 *len = 0;
2515 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2516 LDAPAVA *ava = rdn[ iAVA ];
2518 /* len(type) + '=' + '+' | ',' */
2519 l += ava->la_attr.bv_len + 2;
2521 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2522 /* octothorpe + twice the length */
2523 l += 1 + 2 * ava->la_value.bv_len;
2525 } else {
2526 ber_len_t vl;
2527 unsigned f = flags | ava->la_flags;
2529 if ( ( *s2l )( &ava->la_value, f, &vl ) ) {
2530 return( -1 );
2532 l += vl;
2536 *len = l;
2538 return( 0 );
2541 static int
2542 rdn2str( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len,
2543 int ( *s2s ) ( struct berval *v, char * s, unsigned f, ber_len_t *l ) )
2545 int iAVA;
2546 ber_len_t l = 0;
2548 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2549 LDAPAVA *ava = rdn[ iAVA ];
2551 AC_MEMCPY( &str[ l ], ava->la_attr.bv_val,
2552 ava->la_attr.bv_len );
2553 l += ava->la_attr.bv_len;
2555 str[ l++ ] = '=';
2557 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2558 str[ l++ ] = '#';
2559 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2560 return( -1 );
2562 l += 2 * ava->la_value.bv_len;
2564 } else {
2565 ber_len_t vl;
2566 unsigned f = flags | ava->la_flags;
2568 if ( ( *s2s )( &ava->la_value, &str[ l ], f, &vl ) ) {
2569 return( -1 );
2571 l += vl;
2573 str[ l++ ] = ( rdn[ iAVA + 1] ? '+' : ',' );
2576 *len = l;
2578 return( 0 );
2581 static int
2582 rdn2DCEstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len )
2584 int iAVA;
2585 ber_len_t l = 0;
2587 *len = 0;
2589 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2590 LDAPAVA *ava = rdn[ iAVA ];
2592 /* len(type) + '=' + ',' | '/' */
2593 l += ava->la_attr.bv_len + 2;
2595 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2596 /* octothorpe + twice the length */
2597 l += 1 + 2 * ava->la_value.bv_len;
2598 } else {
2599 ber_len_t vl;
2600 unsigned f = flags | ava->la_flags;
2602 if ( strval2DCEstrlen( &ava->la_value, f, &vl ) ) {
2603 return( -1 );
2605 l += vl;
2609 *len = l;
2611 return( 0 );
2614 static int
2615 rdn2DCEstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len, int first )
2617 int iAVA;
2618 ber_len_t l = 0;
2620 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2621 LDAPAVA *ava = rdn[ iAVA ];
2623 if ( first ) {
2624 first = 0;
2625 } else {
2626 str[ l++ ] = ( iAVA ? ',' : '/' );
2629 AC_MEMCPY( &str[ l ], ava->la_attr.bv_val,
2630 ava->la_attr.bv_len );
2631 l += ava->la_attr.bv_len;
2633 str[ l++ ] = '=';
2635 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2636 str[ l++ ] = '#';
2637 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2638 return( -1 );
2640 l += 2 * ava->la_value.bv_len;
2641 } else {
2642 ber_len_t vl;
2643 unsigned f = flags | ava->la_flags;
2645 if ( strval2DCEstr( &ava->la_value, &str[ l ], f, &vl ) ) {
2646 return( -1 );
2648 l += vl;
2652 *len = l;
2654 return( 0 );
2657 static int
2658 rdn2UFNstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len )
2660 int iAVA;
2661 ber_len_t l = 0;
2663 assert( rdn != NULL );
2664 assert( len != NULL );
2666 *len = 0;
2668 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2669 LDAPAVA *ava = rdn[ iAVA ];
2671 /* ' + ' | ', ' */
2672 l += ( rdn[ iAVA + 1 ] ? 3 : 2 );
2674 /* FIXME: are binary values allowed in UFN? */
2675 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2676 /* octothorpe + twice the value */
2677 l += 1 + 2 * ava->la_value.bv_len;
2679 } else {
2680 ber_len_t vl;
2681 unsigned f = flags | ava->la_flags;
2683 if ( strval2strlen( &ava->la_value, f, &vl ) ) {
2684 return( -1 );
2686 l += vl;
2690 *len = l;
2692 return( 0 );
2695 static int
2696 rdn2UFNstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len )
2698 int iAVA;
2699 ber_len_t l = 0;
2701 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2702 LDAPAVA *ava = rdn[ iAVA ];
2704 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2705 str[ l++ ] = '#';
2706 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2707 return( -1 );
2709 l += 2 * ava->la_value.bv_len;
2711 } else {
2712 ber_len_t vl;
2713 unsigned f = flags | ava->la_flags;
2715 if ( strval2str( &ava->la_value, &str[ l ], f, &vl ) ) {
2716 return( -1 );
2718 l += vl;
2721 if ( rdn[ iAVA + 1 ] ) {
2722 AC_MEMCPY( &str[ l ], " + ", 3 );
2723 l += 3;
2725 } else {
2726 AC_MEMCPY( &str[ l ], ", ", 2 );
2727 l += 2;
2731 *len = l;
2733 return( 0 );
2736 static int
2737 rdn2ADstrlen( LDAPRDN rdn, unsigned flags, ber_len_t *len )
2739 int iAVA;
2740 ber_len_t l = 0;
2742 assert( rdn != NULL );
2743 assert( len != NULL );
2745 *len = 0;
2747 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2748 LDAPAVA *ava = rdn[ iAVA ];
2750 /* ',' | '/' */
2751 l++;
2753 /* FIXME: are binary values allowed in UFN? */
2754 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2755 /* octothorpe + twice the value */
2756 l += 1 + 2 * ava->la_value.bv_len;
2757 } else {
2758 ber_len_t vl;
2759 unsigned f = flags | ava->la_flags;
2761 if ( strval2ADstrlen( &ava->la_value, f, &vl ) ) {
2762 return( -1 );
2764 l += vl;
2768 *len = l;
2770 return( 0 );
2773 static int
2774 rdn2ADstr( LDAPRDN rdn, char *str, unsigned flags, ber_len_t *len, int first )
2776 int iAVA;
2777 ber_len_t l = 0;
2779 for ( iAVA = 0; rdn[ iAVA ]; iAVA++ ) {
2780 LDAPAVA *ava = rdn[ iAVA ];
2782 if ( first ) {
2783 first = 0;
2784 } else {
2785 str[ l++ ] = ( iAVA ? ',' : '/' );
2788 if ( ava->la_flags & LDAP_AVA_BINARY ) {
2789 str[ l++ ] = '#';
2790 if ( binval2hexstr( &ava->la_value, &str[ l ] ) ) {
2791 return( -1 );
2793 l += 2 * ava->la_value.bv_len;
2794 } else {
2795 ber_len_t vl;
2796 unsigned f = flags | ava->la_flags;
2798 if ( strval2ADstr( &ava->la_value, &str[ l ], f, &vl ) ) {
2799 return( -1 );
2801 l += vl;
2805 *len = l;
2807 return( 0 );
2811 * ldap_rdn2str
2813 * Returns in str a string representation of rdn based on flags.
2814 * There is some duplication of code between this and ldap_dn2str;
2815 * this is wanted to reduce the allocation of temporary buffers.
2818 ldap_rdn2str( LDAPRDN rdn, char **str, unsigned flags )
2820 struct berval bv;
2821 int rc;
2823 assert( str != NULL );
2825 if((flags & LDAP_DN_FORMAT_MASK) == LDAP_DN_FORMAT_LBER) {
2826 return LDAP_PARAM_ERROR;
2829 rc = ldap_rdn2bv_x( rdn, &bv, flags, NULL );
2830 *str = bv.bv_val;
2831 return rc;
2835 ldap_rdn2bv( LDAPRDN rdn, struct berval *bv, unsigned flags )
2837 return ldap_rdn2bv_x( rdn, bv, flags, NULL );
2841 ldap_rdn2bv_x( LDAPRDN rdn, struct berval *bv, unsigned flags, void *ctx )
2843 int rc, back;
2844 ber_len_t l;
2846 assert( bv != NULL );
2848 bv->bv_len = 0;
2849 bv->bv_val = NULL;
2851 if ( rdn == NULL ) {
2852 bv->bv_val = LDAP_STRDUPX( "", ctx );
2853 return( LDAP_SUCCESS );
2857 * This routine wastes "back" bytes at the end of the string
2860 switch ( LDAP_DN_FORMAT( flags ) ) {
2861 case LDAP_DN_FORMAT_LDAPV3:
2862 if ( rdn2strlen( rdn, flags, &l, strval2strlen ) ) {
2863 return LDAP_DECODING_ERROR;
2865 break;
2867 case LDAP_DN_FORMAT_LDAPV2:
2868 if ( rdn2strlen( rdn, flags, &l, strval2IA5strlen ) ) {
2869 return LDAP_DECODING_ERROR;
2871 break;
2873 case LDAP_DN_FORMAT_UFN:
2874 if ( rdn2UFNstrlen( rdn, flags, &l ) ) {
2875 return LDAP_DECODING_ERROR;
2877 break;
2879 case LDAP_DN_FORMAT_DCE:
2880 if ( rdn2DCEstrlen( rdn, flags, &l ) ) {
2881 return LDAP_DECODING_ERROR;
2883 break;
2885 case LDAP_DN_FORMAT_AD_CANONICAL:
2886 if ( rdn2ADstrlen( rdn, flags, &l ) ) {
2887 return LDAP_DECODING_ERROR;
2889 break;
2891 default:
2892 return LDAP_PARAM_ERROR;
2895 bv->bv_val = LDAP_MALLOCX( l + 1, ctx );
2897 switch ( LDAP_DN_FORMAT( flags ) ) {
2898 case LDAP_DN_FORMAT_LDAPV3:
2899 rc = rdn2str( rdn, bv->bv_val, flags, &l, strval2str );
2900 back = 1;
2901 break;
2903 case LDAP_DN_FORMAT_LDAPV2:
2904 rc = rdn2str( rdn, bv->bv_val, flags, &l, strval2IA5str );
2905 back = 1;
2906 break;
2908 case LDAP_DN_FORMAT_UFN:
2909 rc = rdn2UFNstr( rdn, bv->bv_val, flags, &l );
2910 back = 2;
2911 break;
2913 case LDAP_DN_FORMAT_DCE:
2914 rc = rdn2DCEstr( rdn, bv->bv_val, flags, &l, 1 );
2915 back = 0;
2916 break;
2918 case LDAP_DN_FORMAT_AD_CANONICAL:
2919 rc = rdn2ADstr( rdn, bv->bv_val, flags, &l, 1 );
2920 back = 0;
2921 break;
2923 default:
2924 /* need at least one of the previous */
2925 return LDAP_PARAM_ERROR;
2928 if ( rc ) {
2929 LDAP_FREEX( bv->bv_val, ctx );
2930 return rc;
2933 bv->bv_len = l - back;
2934 bv->bv_val[ bv->bv_len ] = '\0';
2936 return LDAP_SUCCESS;
2940 * Very bulk implementation; many optimizations can be performed
2941 * - a NULL dn results in an empty string ""
2943 * FIXME: doubts
2944 * a) what do we do if a UTF-8 string must be converted in LDAPv2?
2945 * we must encode it in binary form ('#' + HEXPAIRs)
2946 * b) does DCE/AD support UTF-8?
2947 * no clue; don't think so.
2948 * c) what do we do when binary values must be converted in UTF/DCE/AD?
2949 * use binary encoded BER
2951 int ldap_dn2str( LDAPDN dn, char **str, unsigned flags )
2953 struct berval bv;
2954 int rc;
2956 assert( str != NULL );
2958 if((flags & LDAP_DN_FORMAT_MASK) == LDAP_DN_FORMAT_LBER) {
2959 return LDAP_PARAM_ERROR;
2962 rc = ldap_dn2bv_x( dn, &bv, flags, NULL );
2963 *str = bv.bv_val;
2964 return rc;
2967 int ldap_dn2bv( LDAPDN dn, struct berval *bv, unsigned flags )
2969 return ldap_dn2bv_x( dn, bv, flags, NULL );
2972 int ldap_dn2bv_x( LDAPDN dn, struct berval *bv, unsigned flags, void *ctx )
2974 int iRDN;
2975 int rc = LDAP_ENCODING_ERROR;
2976 ber_len_t len, l;
2978 /* stringifying helpers for LDAPv3/LDAPv2 */
2979 int ( *sv2l ) ( struct berval *v, unsigned f, ber_len_t *l );
2980 int ( *sv2s ) ( struct berval *v, char *s, unsigned f, ber_len_t *l );
2982 assert( bv != NULL );
2983 bv->bv_len = 0;
2984 bv->bv_val = NULL;
2986 Debug( LDAP_DEBUG_ARGS, "=> ldap_dn2bv(%u)\n", flags, 0, 0 );
2989 * a null dn means an empty dn string
2990 * FIXME: better raise an error?
2992 if ( dn == NULL ) {
2993 bv->bv_val = LDAP_STRDUPX( "", ctx );
2994 return( LDAP_SUCCESS );
2997 switch ( LDAP_DN_FORMAT( flags ) ) {
2998 case LDAP_DN_FORMAT_LDAPV3:
2999 sv2l = strval2strlen;
3000 sv2s = strval2str;
3002 if( 0 ) {
3003 case LDAP_DN_FORMAT_LDAPV2:
3004 sv2l = strval2IA5strlen;
3005 sv2s = strval2IA5str;
3008 for ( iRDN = 0, len = 0; dn[ iRDN ]; iRDN++ ) {
3009 ber_len_t rdnl;
3010 if ( rdn2strlen( dn[ iRDN ], flags, &rdnl, sv2l ) ) {
3011 goto return_results;
3014 len += rdnl;
3017 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1, ctx ) ) == NULL ) {
3018 rc = LDAP_NO_MEMORY;
3019 break;
3022 for ( l = 0, iRDN = 0; dn[ iRDN ]; iRDN++ ) {
3023 ber_len_t rdnl;
3025 if ( rdn2str( dn[ iRDN ], &bv->bv_val[ l ], flags,
3026 &rdnl, sv2s ) ) {
3027 LDAP_FREEX( bv->bv_val, ctx );
3028 bv->bv_val = NULL;
3029 goto return_results;
3031 l += rdnl;
3034 assert( l == len );
3037 * trim the last ',' (the allocated memory
3038 * is one byte longer than required)
3040 bv->bv_len = len - 1;
3041 bv->bv_val[ bv->bv_len ] = '\0';
3043 rc = LDAP_SUCCESS;
3044 break;
3046 case LDAP_DN_FORMAT_UFN: {
3048 * FIXME: quoting from RFC 1781:
3050 To take a distinguished name, and generate a name of this format with
3051 attribute types omitted, the following steps are followed.
3053 1. If the first attribute is of type CommonName, the type may be
3054 omitted.
3056 2. If the last attribute is of type Country, the type may be
3057 omitted.
3059 3. If the last attribute is of type Country, the last
3060 Organisation attribute may have the type omitted.
3062 4. All attributes of type OrganisationalUnit may have the type
3063 omitted, unless they are after an Organisation attribute or
3064 the first attribute is of type OrganisationalUnit.
3066 * this should be the pedantic implementation.
3068 * Here the standard implementation reflects
3069 * the one historically provided by OpenLDAP
3070 * (and UMIch, I presume), with the variant
3071 * of spaces and plusses (' + ') separating
3072 * rdn components.
3074 * A non-standard but nice implementation could
3075 * be to turn the final "dc" attributes into a
3076 * dot-separated domain.
3078 * Other improvements could involve the use of
3079 * friendly country names and so.
3081 #ifdef DC_IN_UFN
3082 int leftmost_dc = -1;
3083 int last_iRDN = -1;
3084 #endif /* DC_IN_UFN */
3086 for ( iRDN = 0, len = 0; dn[ iRDN ]; iRDN++ ) {
3087 ber_len_t rdnl;
3089 if ( rdn2UFNstrlen( dn[ iRDN ], flags, &rdnl ) ) {
3090 goto return_results;
3092 len += rdnl;
3094 #ifdef DC_IN_UFN
3095 if ( LDAP_DN_IS_RDN_DC( dn[ iRDN ] ) ) {
3096 if ( leftmost_dc == -1 ) {
3097 leftmost_dc = iRDN;
3099 } else {
3100 leftmost_dc = -1;
3102 #endif /* DC_IN_UFN */
3105 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1, ctx ) ) == NULL ) {
3106 rc = LDAP_NO_MEMORY;
3107 break;
3110 #ifdef DC_IN_UFN
3111 if ( leftmost_dc == -1 ) {
3112 #endif /* DC_IN_UFN */
3113 for ( l = 0, iRDN = 0; dn[ iRDN ]; iRDN++ ) {
3114 ber_len_t vl;
3116 if ( rdn2UFNstr( dn[ iRDN ], &bv->bv_val[ l ],
3117 flags, &vl ) ) {
3118 LDAP_FREEX( bv->bv_val, ctx );
3119 bv->bv_val = NULL;
3120 goto return_results;
3122 l += vl;
3126 * trim the last ', ' (the allocated memory
3127 * is two bytes longer than required)
3129 bv->bv_len = len - 2;
3130 bv->bv_val[ bv->bv_len ] = '\0';
3131 #ifdef DC_IN_UFN
3132 } else {
3133 last_iRDN = iRDN - 1;
3135 for ( l = 0, iRDN = 0; iRDN < leftmost_dc; iRDN++ ) {
3136 ber_len_t vl;
3138 if ( rdn2UFNstr( dn[ iRDN ], &bv->bv_val[ l ],
3139 flags, &vl ) ) {
3140 LDAP_FREEX( bv->bv_val, ctx );
3141 bv->bv_val = NULL;
3142 goto return_results;
3144 l += vl;
3147 if ( !dn2domain( dn, bv, l, &last_iRDN ) ) {
3148 LDAP_FREEX( bv->bv_val, ctx );
3149 bv->bv_val = NULL;
3150 goto return_results;
3153 /* the string is correctly terminated by dn2domain */
3155 #endif /* DC_IN_UFN */
3157 rc = LDAP_SUCCESS;
3159 } break;
3161 case LDAP_DN_FORMAT_DCE:
3162 for ( iRDN = 0, len = 0; dn[ iRDN ]; iRDN++ ) {
3163 ber_len_t rdnl;
3164 if ( rdn2DCEstrlen( dn[ iRDN ], flags, &rdnl ) ) {
3165 goto return_results;
3168 len += rdnl;
3171 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1, ctx ) ) == NULL ) {
3172 rc = LDAP_NO_MEMORY;
3173 break;
3176 for ( l = 0; iRDN--; ) {
3177 ber_len_t rdnl;
3179 if ( rdn2DCEstr( dn[ iRDN ], &bv->bv_val[ l ], flags,
3180 &rdnl, 0 ) ) {
3181 LDAP_FREEX( bv->bv_val, ctx );
3182 bv->bv_val = NULL;
3183 goto return_results;
3185 l += rdnl;
3188 assert( l == len );
3190 bv->bv_len = len;
3191 bv->bv_val[ bv->bv_len ] = '\0';
3193 rc = LDAP_SUCCESS;
3194 break;
3196 case LDAP_DN_FORMAT_AD_CANONICAL: {
3197 int trailing_slash = 1;
3200 * Sort of UFN for DCE DNs: a slash ('/') separated
3201 * global->local DN with no types; strictly speaking,
3202 * the naming context should be a domain, which is
3203 * written in DNS-style, e.g. dot-deparated.
3205 * Example:
3207 * "givenName=Bill+sn=Gates,ou=People,dc=microsoft,dc=com"
3209 * will read
3211 * "microsoft.com/People/Bill,Gates"
3213 for ( iRDN = 0, len = -1; dn[ iRDN ]; iRDN++ ) {
3214 ber_len_t rdnl;
3216 if ( rdn2ADstrlen( dn[ iRDN ], flags, &rdnl ) ) {
3217 goto return_results;
3220 len += rdnl;
3223 /* reserve room for trailing '/' in case the DN
3224 * is exactly a domain */
3225 if ( ( bv->bv_val = LDAP_MALLOCX( len + 1 + 1, ctx ) ) == NULL )
3227 rc = LDAP_NO_MEMORY;
3228 break;
3231 iRDN--;
3232 if ( iRDN && dn2domain( dn, bv, 0, &iRDN ) != 0 ) {
3233 for ( l = bv->bv_len; iRDN >= 0 ; iRDN-- ) {
3234 ber_len_t rdnl;
3236 trailing_slash = 0;
3238 if ( rdn2ADstr( dn[ iRDN ], &bv->bv_val[ l ],
3239 flags, &rdnl, 0 ) ) {
3240 LDAP_FREEX( bv->bv_val, ctx );
3241 bv->bv_val = NULL;
3242 goto return_results;
3244 l += rdnl;
3247 } else {
3248 int first = 1;
3251 * Strictly speaking, AD canonical requires
3252 * a DN to be in the form "..., dc=smtg",
3253 * i.e. terminated by a domain component
3255 if ( flags & LDAP_DN_PEDANTIC ) {
3256 LDAP_FREEX( bv->bv_val, ctx );
3257 bv->bv_val = NULL;
3258 rc = LDAP_ENCODING_ERROR;
3259 break;
3262 for ( l = 0; iRDN >= 0 ; iRDN-- ) {
3263 ber_len_t rdnl;
3265 if ( rdn2ADstr( dn[ iRDN ], &bv->bv_val[ l ],
3266 flags, &rdnl, first ) ) {
3267 LDAP_FREEX( bv->bv_val, ctx );
3268 bv->bv_val = NULL;
3269 goto return_results;
3271 if ( first ) {
3272 first = 0;
3274 l += rdnl;
3278 if ( trailing_slash ) {
3279 /* the DN is exactly a domain -- need a trailing
3280 * slash; room was reserved in advance */
3281 bv->bv_val[ len ] = '/';
3282 len++;
3285 bv->bv_len = len;
3286 bv->bv_val[ bv->bv_len ] = '\0';
3288 rc = LDAP_SUCCESS;
3289 } break;
3291 default:
3292 return LDAP_PARAM_ERROR;
3295 Debug( LDAP_DEBUG_ARGS, "<= ldap_dn2bv(%s)=%d %s\n",
3296 bv->bv_val, rc, rc ? ldap_err2string( rc ) : "" );
3298 return_results:;
3299 return( rc );