]> git.sur5r.net Git - openldap/blob - libraries/liblber/decode.c
e8b889d2e78a8e0fa69951fcb4b101fd0199984c
[openldap] / libraries / liblber / decode.c
1 /* decode.c - ber input decoding routines */
2 /* $OpenLDAP$ */
3 /*
4  * Copyright 1998-1999 The OpenLDAP Foundation, All Rights Reserved.
5  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
6  */
7 /* Portions
8  * Copyright (c) 1990 Regents of the University of Michigan.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms are permitted
12  * provided that this notice is preserved and that due credit is given
13  * to the University of Michigan at Ann Arbor. The name of the University
14  * may not be used to endorse or promote products derived from this
15  * software without specific prior written permission. This software
16  * is provided ``as is'' without express or implied warranty.
17  */
18
19 #include "portable.h"
20
21 #include <stdio.h>
22
23 #include <ac/stdlib.h>
24
25 #include <ac/stdarg.h>
26 #include <ac/string.h>
27 #include <ac/socket.h>
28
29 #undef LDAP_F_PRE
30 #define LDAP_F_PRE LDAP_F_EXPORT
31
32 #include "lber-int.h"
33
34 static ber_len_t ber_getnint LDAP_P((
35         BerElement *ber,
36         ber_int_t *num,
37         ber_len_t len ));
38
39 /* return the tag - LBER_DEFAULT returned means trouble */
40 ber_tag_t
41 ber_get_tag( BerElement *ber )
42 {
43         unsigned char   xbyte;
44         ber_tag_t       tag;
45         char            *tagp;
46         unsigned int    i;
47
48         assert( ber != NULL );
49         assert( BER_VALID( ber ) );
50
51         if ( ber_read( ber, (char *) &xbyte, 1 ) != 1 )
52                 return( LBER_DEFAULT );
53
54         if ( (xbyte & LBER_BIG_TAG_MASK) != LBER_BIG_TAG_MASK )
55                 return( (ber_tag_t) xbyte );
56
57         tagp = (char *) &tag;
58         tagp[0] = xbyte;
59         for ( i = 1; i < sizeof(ber_tag_t); i++ ) {
60                 if ( ber_read( ber, (char *) &xbyte, 1 ) != 1 )
61                         return( LBER_DEFAULT );
62
63                 tagp[i] = xbyte;
64
65                 if ( ! (xbyte & LBER_MORE_TAG_MASK) )
66                         break;
67         }
68
69         /* tag too big! */
70         if ( i == sizeof(ber_tag_t) )
71                 return( LBER_DEFAULT );
72
73         /* want leading, not trailing 0's */
74         return( tag >> (sizeof(ber_tag_t) - i - 1) );
75 }
76
77 ber_tag_t
78 ber_skip_tag( BerElement *ber, ber_len_t *len )
79 {
80         ber_tag_t       tag;
81         unsigned char   lc;
82         ber_len_t       noctets;
83         int             diff;
84         ber_len_t       netlen;
85
86         assert( ber != NULL );
87         assert( len != NULL );
88         assert( BER_VALID( ber ) );
89
90         /*
91          * Any ber element looks like this: tag length contents.
92          * Assuming everything's ok, we return the tag byte (we
93          * can assume a single byte), and return the length in len.
94          *
95          * Assumptions:
96          *      1) definite lengths
97          *      2) primitive encodings used whenever possible
98          */
99
100         /*
101          * First, we read the tag.
102          */
103
104         if ( (tag = ber_get_tag( ber )) == LBER_DEFAULT )
105                 return( LBER_DEFAULT );
106
107         /*
108          * Next, read the length.  The first byte contains the length of
109          * the length.  If bit 8 is set, the length is the long form,
110          * otherwise it's the short form.  We don't allow a length that's
111          * greater than what we can hold in a ber_len_t.
112          */
113
114         *len = netlen = 0;
115         if ( ber_read( ber, (char *) &lc, 1 ) != 1 )
116                 return( LBER_DEFAULT );
117         if ( lc & 0x80U ) {
118                 noctets = (lc & 0x7fU);
119                 if ( noctets > sizeof(ber_len_t) )
120                         return( LBER_DEFAULT );
121                 diff = sizeof(ber_len_t) - noctets;
122                 if ( (unsigned) ber_read( ber, (char *) &netlen + diff, noctets )
123                     != noctets )
124                         return( LBER_DEFAULT );
125                 *len = LBER_LEN_NTOH( netlen );
126         } else {
127                 *len = lc;
128         }
129
130         return( tag );
131 }
132
133 ber_tag_t
134 ber_peek_tag(
135         BerElement *ber_in,
136         ber_len_t *len )
137 {
138         char*   save;
139         BerElement *ber;
140         ber_tag_t tag;
141
142         assert( ber_in != NULL );
143         assert( BER_VALID( ber_in ) );
144
145         /* save state */
146         save = ber->ber_ptr;
147
148         tag = ber_skip_tag( ber, len );
149
150         /* restore state */
151         ber->ber_ptr = save;
152
153         return( tag );
154 }
155
156 static ber_len_t
157 ber_getnint(
158         BerElement *ber,
159         ber_int_t *num,
160         ber_len_t len )
161 {
162         unsigned char buf[sizeof(ber_int_t)];
163
164         assert( ber != NULL );
165         assert( num != NULL );
166
167         assert( BER_VALID( ber ) );
168
169         /*
170          * The tag and length have already been stripped off.  We should
171          * be sitting right before len bytes of 2's complement integer,
172          * ready to be read straight into an int.  We may have to sign
173          * extend after we read it in.
174          */
175
176         if ( len > sizeof(ber_int_t) )
177                 return( -1 );
178
179         /* read into the low-order bytes of our buffer */
180         if ( (ber_len_t) ber_read( ber, (char *) buf, len ) != len ) {
181                 return( -1 );
182         }
183
184         if( len ) {
185                 /* sign extend if necessary */
186                 ber_len_t i;
187                 ber_int_t netnum = 0x80 & buf[0] ? -1 : 0;
188
189                 /* shift in the bytes */
190                 for( i=0 ; i<len; i++ ) {
191                         netnum = (netnum << 8 ) | buf[i];
192                 }
193
194                 *num = netnum;
195
196         } else {
197                 *num = 0;
198         }
199
200         return( len );
201 }
202
203 ber_tag_t
204 ber_get_int(
205         BerElement *ber,
206         ber_int_t *num )
207 {
208         ber_tag_t       tag;
209         ber_len_t       len;
210
211         assert( ber != NULL );
212         assert( BER_VALID( ber ) );
213
214         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
215                 return( LBER_DEFAULT );
216
217         if ( ber_getnint( ber, num, len ) != len )
218                 return( LBER_DEFAULT );
219         else
220                 return( tag );
221 }
222
223 ber_tag_t
224 ber_get_stringb(
225         BerElement *ber,
226         char *buf,
227         ber_len_t *len )
228 {
229         ber_len_t       datalen;
230         ber_tag_t       tag;
231
232 #ifdef STR_TRANSLATION
233         char            *transbuf;
234 #endif /* STR_TRANSLATION */
235
236         assert( ber != NULL );
237         assert( BER_VALID( ber ) );
238
239         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT )
240                 return( LBER_DEFAULT );
241         if ( datalen > (*len - 1) )
242                 return( LBER_DEFAULT );
243
244         if ( (ber_len_t) ber_read( ber, buf, datalen ) != datalen )
245                 return( LBER_DEFAULT );
246
247         buf[datalen] = '\0';
248
249 #ifdef STR_TRANSLATION
250         if ( datalen > 0 && ( ber->ber_options & LBER_TRANSLATE_STRINGS ) != 0
251             && ber->ber_decode_translate_proc ) {
252                 transbuf = buf;
253                 ++datalen;
254                 if ( (*(ber->ber_decode_translate_proc))( &transbuf, &datalen,
255                     0 ) != 0 ) {
256                         return( LBER_DEFAULT );
257                 }
258                 if ( datalen > *len ) {
259                         LBER_FREE( transbuf );
260                         return( LBER_DEFAULT );
261                 }
262                 SAFEMEMCPY( buf, transbuf, datalen );
263                 LBER_FREE( transbuf );
264                 --datalen;
265         }
266 #endif /* STR_TRANSLATION */
267
268         *len = datalen;
269         return( tag );
270 }
271
272 ber_tag_t
273 ber_get_stringa( BerElement *ber, char **buf )
274 {
275         ber_len_t       datalen;
276         ber_tag_t       tag;
277
278         assert( ber != NULL );
279         assert( buf != NULL );
280
281         assert( BER_VALID( ber ) );
282
283         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
284                 *buf = NULL;
285                 return( LBER_DEFAULT );
286         }
287
288         if ( (*buf = (char *) LBER_MALLOC( datalen + 1 )) == NULL )
289                 return( LBER_DEFAULT );
290
291         if ( (ber_len_t) ber_read( ber, *buf, datalen ) != datalen ) {
292                 LBER_FREE( *buf );
293                 *buf = NULL;
294                 return( LBER_DEFAULT );
295         }
296         (*buf)[datalen] = '\0';
297
298 #ifdef STR_TRANSLATION
299         if ( datalen > 0 && ( ber->ber_options & LBER_TRANSLATE_STRINGS ) != 0
300             && ber->ber_decode_translate_proc ) {
301                 ++datalen;
302                 if ( (*(ber->ber_decode_translate_proc))( buf, &datalen, 1 )
303                     != 0 ) {
304                         LBER_FREE( *buf );
305                         *buf = NULL;
306                         return( LBER_DEFAULT );
307                 }
308         }
309 #endif /* STR_TRANSLATION */
310
311         return( tag );
312 }
313
314 ber_tag_t
315 ber_get_stringal( BerElement *ber, struct berval **bv )
316 {
317         ber_len_t       len;
318         ber_tag_t       tag;
319
320         assert( ber != NULL );
321         assert( bv != NULL );
322
323         assert( BER_VALID( ber ) );
324
325         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT ) {
326                 *bv = NULL;
327                 return( LBER_DEFAULT );
328         }
329
330         if ( (*bv = (struct berval *) LBER_MALLOC( sizeof(struct berval) )) == NULL )
331                 return( LBER_DEFAULT );
332
333         if ( ((*bv)->bv_val = (char *) LBER_MALLOC( len + 1 )) == NULL ) {
334                 LBER_FREE( *bv );
335                 *bv = NULL;
336                 return( LBER_DEFAULT );
337         }
338
339         if ( (ber_len_t) ber_read( ber, (*bv)->bv_val, len ) != len ) {
340                 ber_bvfree( *bv );
341                 *bv = NULL;
342                 return( LBER_DEFAULT );
343         }
344         ((*bv)->bv_val)[len] = '\0';
345         (*bv)->bv_len = len;
346
347 #ifdef STR_TRANSLATION
348         if ( len > 0 && ( ber->ber_options & LBER_TRANSLATE_STRINGS ) != 0
349             && ber->ber_decode_translate_proc ) {
350                 ++len;
351                 if ( (*(ber->ber_decode_translate_proc))( &((*bv)->bv_val),
352                     &len, 1 ) != 0 ) {
353                         ber_bvfree( *bv );
354                         *bv = NULL;
355                         return( LBER_DEFAULT );
356                 }
357                 (*bv)->bv_len = len - 1;
358         }
359 #endif /* STR_TRANSLATION */
360
361         return( tag );
362 }
363
364 ber_tag_t
365 ber_get_bitstringa(
366         BerElement *ber,
367         char **buf,
368         ber_len_t *blen )
369 {
370         ber_len_t       datalen;
371         ber_tag_t       tag;
372         unsigned char   unusedbits;
373
374         assert( ber != NULL );
375         assert( buf != NULL );
376         assert( blen != NULL );
377
378         assert( BER_VALID( ber ) );
379
380         if ( (tag = ber_skip_tag( ber, &datalen )) == LBER_DEFAULT ) {
381                 *buf = NULL;
382                 return( LBER_DEFAULT );
383         }
384         --datalen;
385
386         if ( (*buf = (char *) LBER_MALLOC( datalen )) == NULL )
387                 return( LBER_DEFAULT );
388
389         if ( ber_read( ber, (char *)&unusedbits, 1 ) != 1 ) {
390                 LBER_FREE( buf );
391                 *buf = NULL;
392                 return( LBER_DEFAULT );
393         }
394
395         if ( (ber_len_t) ber_read( ber, *buf, datalen ) != datalen ) {
396                 LBER_FREE( buf );
397                 *buf = NULL;
398                 return( LBER_DEFAULT );
399         }
400
401         *blen = datalen * 8 - unusedbits;
402         return( tag );
403 }
404
405 ber_tag_t
406 ber_get_null( BerElement *ber )
407 {
408         ber_len_t       len;
409         ber_tag_t       tag;
410
411         assert( ber != NULL );
412         assert( BER_VALID( ber ) );
413
414         if ( (tag = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
415                 return( LBER_DEFAULT );
416
417         if ( len != 0 )
418                 return( LBER_DEFAULT );
419
420         return( tag );
421 }
422
423 ber_tag_t
424 ber_get_boolean(
425         BerElement *ber,
426         ber_int_t *boolval )
427 {
428         ber_int_t       longbool;
429         ber_tag_t       rc;
430
431         assert( ber != NULL );
432         assert( boolval != NULL );
433
434         assert( BER_VALID( ber ) );
435
436         rc = ber_get_int( ber, &longbool );
437         *boolval = longbool;
438
439         return( rc );
440 }
441
442 ber_tag_t
443 ber_first_element(
444         BerElement *ber,
445         ber_len_t *len,
446         char **last )
447 {
448         assert( ber != NULL );
449         assert( len != NULL );
450         assert( last != NULL );
451
452         /* skip the sequence header, use the len to mark where to stop */
453         if ( ber_skip_tag( ber, len ) == LBER_DEFAULT ) {
454                 return( LBER_ERROR );
455         }
456
457         *last = ber->ber_ptr + *len;
458
459         if ( *last == ber->ber_ptr ) {
460                 return( LBER_DEFAULT );
461         }
462
463         return( ber_peek_tag( ber, len ) );
464 }
465
466 ber_tag_t
467 ber_next_element(
468         BerElement *ber,
469         ber_len_t *len,
470         LDAP_CONST char *last )
471 {
472         assert( ber != NULL );
473         assert( len != NULL );
474         assert( last != NULL );
475
476         assert( BER_VALID( ber ) );
477
478         if ( ber->ber_ptr == last ) {
479                 /* set last to NULL on end of SEQUENCE */
480                 return( LBER_DEFAULT );
481         }
482
483         return( ber_peek_tag( ber, len ) );
484 }
485
486 /* VARARGS */
487 ber_tag_t
488 ber_scanf ( BerElement *ber,
489         LDAP_CONST char *fmt,
490         ... )
491 {
492         va_list         ap;
493         LDAP_CONST char         *fmt_reset;
494         char            *last;
495         char            *s, **ss, ***sss;
496         struct berval   ***bv, **bvp, *bval;
497         ber_int_t       *i;
498         int j;
499         ber_len_t       *l;
500         ber_tag_t       *t;
501         ber_tag_t       rc, tag;
502         ber_len_t       len;
503
504         va_start( ap, fmt );
505
506         assert( ber != NULL );
507         assert( fmt != NULL );
508
509         assert( BER_VALID( ber ) );
510
511         fmt_reset = fmt;
512
513         ber_log_printf( LDAP_DEBUG_TRACE, ber->ber_debug,
514                 "ber_scanf fmt (%s) ber:\n", fmt );
515         ber_log_dump( LDAP_DEBUG_BER, ber->ber_debug, ber, 1 );
516
517         for ( rc = 0; *fmt && rc != LBER_DEFAULT; fmt++ ) {
518                 /* When this is modified, remember to update
519                  * the error-cleanup code below accordingly. */
520                 switch ( *fmt ) {
521                 case '!': { /* Hook */
522                                 BERDecodeCallback *f;
523                                 void *p;
524
525                                 f = va_arg( ap, BERDecodeCallback * );
526                                 p = va_arg( ap, void * );
527
528                                 rc = (*f)( ber, p, 0 );
529                         } break;
530
531                 case 'a':       /* octet string - allocate storage as needed */
532                         ss = va_arg( ap, char ** );
533                         rc = ber_get_stringa( ber, ss );
534                         break;
535
536                 case 'b':       /* boolean */
537                         i = va_arg( ap, ber_int_t * );
538                         rc = ber_get_boolean( ber, i );
539                         break;
540
541                 case 'e':       /* enumerated */
542                 case 'i':       /* int */
543                         i = va_arg( ap, ber_int_t * );
544                         rc = ber_get_int( ber, i );
545                         break;
546
547                 case 'l':       /* length of next item */
548                         l = va_arg( ap, ber_len_t * );
549                         rc = ber_peek_tag( ber, l );
550                         break;
551
552                 case 'n':       /* null */
553                         rc = ber_get_null( ber );
554                         break;
555
556                 case 's':       /* octet string - in a buffer */
557                         s = va_arg( ap, char * );
558                         l = va_arg( ap, ber_len_t * );
559                         rc = ber_get_stringb( ber, s, l );
560                         break;
561
562                 case 'o':       /* octet string in a supplied berval */
563                         bval = va_arg( ap, struct berval * );
564                         ber_peek_tag( ber, &bval->bv_len );
565                         rc = ber_get_stringa( ber, &bval->bv_val );
566                         break;
567
568                 case 'O':       /* octet string - allocate & include length */
569                         bvp = va_arg( ap, struct berval ** );
570                         rc = ber_get_stringal( ber, bvp );
571                         break;
572
573                 case 'B':       /* bit string - allocate storage as needed */
574                         ss = va_arg( ap, char ** );
575                         l = va_arg( ap, ber_len_t * ); /* for length, in bits */
576                         rc = ber_get_bitstringa( ber, ss, l );
577                         break;
578
579                 case 't':       /* tag of next item */
580                         t = va_arg( ap, ber_tag_t * );
581                         *t = rc = ber_peek_tag( ber, &len );
582                         break;
583
584                 case 'T':       /* skip tag of next item */
585                         t = va_arg( ap, ber_tag_t * );
586                         *t = rc = ber_skip_tag( ber, &len );
587                         break;
588
589                 case 'v':       /* sequence of strings */
590                         sss = va_arg( ap, char *** );
591                         *sss = NULL;
592                         j = 0;
593                         for ( tag = ber_first_element( ber, &len, &last );
594                             tag != LBER_DEFAULT && rc != LBER_DEFAULT;
595                             tag = ber_next_element( ber, &len, last ) )
596                         {
597                                 *sss = (char **) LBER_REALLOC( *sss,
598                                         (j + 2) * sizeof(char *) );
599
600                                 rc = ber_get_stringa( ber, &((*sss)[j]) );
601                                 j++;
602                         }
603                         if ( j > 0 )
604                                 (*sss)[j] = NULL;
605                         break;
606
607                 case 'V':       /* sequence of strings + lengths */
608                         bv = va_arg( ap, struct berval *** );
609                         *bv = NULL;
610                         j = 0;
611                         for ( tag = ber_first_element( ber, &len, &last );
612                             tag != LBER_DEFAULT && rc != LBER_DEFAULT;
613                             tag = ber_next_element( ber, &len, last ) )
614                         {
615                                 *bv = (struct berval **) LBER_REALLOC( *bv,
616                                         (j + 2) * sizeof(struct berval *) );
617                 
618                                 rc = ber_get_stringal( ber, &((*bv)[j]) );
619                                 j++;
620                         }
621                         if ( j > 0 )
622                                 (*bv)[j] = NULL;
623                         break;
624
625                 case 'x':       /* skip the next element - whatever it is */
626                         if ( (rc = ber_skip_tag( ber, &len )) == LBER_DEFAULT )
627                                 break;
628                         ber->ber_ptr += len;
629                         break;
630
631                 case '{':       /* begin sequence */
632                 case '[':       /* begin set */
633                         if ( *(fmt + 1) != 'v' && *(fmt + 1) != 'V' )
634                                 rc = ber_skip_tag( ber, &len );
635                         break;
636
637                 case '}':       /* end sequence */
638                 case ']':       /* end set */
639                         break;
640
641                 default:
642                         if( ber->ber_debug ) {
643                                 ber_log_printf( LDAP_DEBUG_ANY, ber->ber_debug,
644                                         "ber_scanf: unknown fmt %c\n", *fmt );
645                         }
646                         rc = LBER_DEFAULT;
647                         break;
648                 }
649         }
650
651         va_end( ap );
652
653         if ( rc == LBER_DEFAULT ) {
654             /*
655              * Error.  Reclaim malloced memory that was given to the caller.
656              * Set allocated pointers to NULL, "data length" outvalues to 0.
657              */
658             va_start( ap, fmt );
659
660             for ( ; fmt_reset < fmt; fmt_reset++ ) {
661                 switch ( *fmt_reset ) {
662                 case '!': { /* Hook */
663                                 BERDecodeCallback *f;
664                                 void *p;
665
666                                 f = va_arg( ap, BERDecodeCallback * );
667                                 p = va_arg( ap, void * );
668
669                                 (void) (*f)( ber, p, 1 );
670                         } break;
671
672                 case 'a':       /* octet string - allocate storage as needed */
673                         ss = va_arg( ap, char ** );
674                         if ( *ss ) {
675                                 LBER_FREE( *ss );
676                                 *ss = NULL;
677                         }
678                         break;
679
680                 case 'b':       /* boolean */
681                 case 'e':       /* enumerated */
682                 case 'i':       /* int */
683                         (void) va_arg( ap, int * );
684                         break;
685
686                 case 's':       /* octet string - in a buffer */
687                         (void) va_arg( ap, char * );
688                         (void) va_arg( ap, ber_len_t * );
689                         break;
690
691                 case 'l':       /* length of next item */
692                         (void) va_arg( ap, ber_len_t * );
693                         break;
694
695                 case 't':       /* tag of next item */
696                 case 'T':       /* skip tag of next item */
697                         (void) va_arg( ap, ber_tag_t * );
698                         break;
699
700                 case 'o':       /* octet string in a supplied berval */
701                         bval = va_arg( ap, struct berval * );
702                         if ( bval->bv_val != NULL ) {
703                                 LBER_FREE( bval->bv_val );
704                                 bval->bv_val = NULL;
705                         }
706                         bval->bv_len = 0;
707                         break;
708
709                 case 'O':       /* octet string - allocate & include length */
710                         bvp = va_arg( ap, struct berval ** );
711                         if ( *bvp ) {
712                                 ber_bvfree( *bvp );
713                                 *bvp = NULL;
714                         }
715                         break;
716
717                 case 'B':       /* bit string - allocate storage as needed */
718                         ss = va_arg( ap, char ** );
719                         if ( *ss ) {
720                                 LBER_FREE( *ss );
721                                 *ss = NULL;
722                         }
723                         *(va_arg( ap, ber_len_t * )) = 0; /* for length, in bits */
724                         break;
725
726                 case 'v':       /* sequence of strings */
727                         sss = va_arg( ap, char *** );
728                         if ( *sss ) {
729                                 for (j = 0;  (*sss)[j];  j++) {
730                                         LBER_FREE( (*sss)[j] );
731                                         (*sss)[j] = NULL;
732                                 }
733                                 LBER_FREE( *sss );
734                                 *sss = NULL;
735                         }
736                         break;
737
738                 case 'V':       /* sequence of strings + lengths */
739                         bv = va_arg( ap, struct berval *** );
740                         if ( *bv ) {
741                                 ber_bvecfree( *bv );
742                                 *bv = NULL;
743                         }
744                         break;
745
746                 case 'n':       /* null */
747                 case 'x':       /* skip the next element - whatever it is */
748                 case '{':       /* begin sequence */
749                 case '[':       /* begin set */
750                 case '}':       /* end sequence */
751                 case ']':       /* end set */
752                         break;
753
754                 default:
755                         /* format should be good */
756                         assert( 0 );
757                 }
758             }
759
760             va_end( ap );
761         }
762
763         return( rc );
764 }
765
766
767 #ifdef STR_TRANSLATION
768 void
769 ber_set_string_translators( BerElement *ber, BERTranslateProc encode_proc,
770         BERTranslateProc decode_proc )
771 {
772         assert( ber != NULL );
773         assert( BER_VALID( ber ) );
774
775     ber->ber_encode_translate_proc = encode_proc;
776     ber->ber_decode_translate_proc = decode_proc;
777 }
778 #endif /* STR_TRANSLATION */