* throw_main_exception_exit: Added.
[cacao.git] / src / cacaoh / headers.c
1 /* src/cacaoh/headers.c - functions for header generation
2
3    Copyright (C) 1996-2005 R. Grafl, A. Krall, C. Kruegel, C. Oates,
4    R. Obermaisser, M. Platter, M. Probst, S. Ring, E. Steiner,
5    C. Thalinger, D. Thuernbeck, P. Tomsich, C. Ullrich, J. Wenninger,
6    Institut f. Computersprachen - TU Wien
7
8    This file is part of CACAO.
9
10    This program is free software; you can redistribute it and/or
11    modify it under the terms of the GNU General Public License as
12    published by the Free Software Foundation; either version 2, or (at
13    your option) any later version.
14
15    This program is distributed in the hope that it will be useful, but
16    WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18    General Public License for more details.
19
20    You should have received a copy of the GNU General Public License
21    along with this program; if not, write to the Free Software
22    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
23    02111-1307, USA.
24
25    Contact: cacao@complang.tuwien.ac.at
26
27    Authors: Reinhard Grafl
28
29    Changes: Mark Probst
30             Philipp Tomsich
31             Christian Thalinger
32
33    $Id: headers.c 3673 2005-11-16 12:03:38Z twisti $
34
35 */
36
37
38 #include <assert.h>
39 #include <ctype.h>
40 #include <stdarg.h>
41 #include <stdlib.h>
42 #include <string.h>
43
44 #include "config.h"
45
46 #if defined(USE_THREADS) && defined(NATIVE_THREADS)
47 # if defined(__DARWIN__)
48 #  include <signal.h>
49 # endif
50 # include <ucontext.h>
51 #endif
52
53 #include "mm/boehm.h"
54 #include "mm/memory.h"
55 #include "native/include/java_lang_String.h"
56 #include "native/include/java_lang_Throwable.h"
57 #include "toolbox/chain.h"
58 #include "toolbox/logging.h"
59 #include "vm/builtin.h"
60 #include "vm/class.h"
61 #include "vm/global.h"
62 #include "vm/method.h"
63 #include "vm/tables.h"
64 #include "vm/loader.h"
65 #include "vm/options.h"
66 #include "vm/stringlocal.h"
67 #include "vm/jit/asmpart.h"
68
69
70 #if defined(ENABLE_INTRP)
71 /* dummy interpreter stack to keep the compiler happy */
72
73 u1 intrp_main_stack[1];
74 #endif
75
76
77 /* for raising exceptions from native methods *********************************/
78
79 #if !defined(USE_THREADS) || !defined(NATIVE_THREADS)
80 java_objectheader *_no_threads_exceptionptr = NULL;
81 #endif
82
83
84 /* replace some non-vmcore functions ******************************************/
85
86 functionptr native_findfunction(utf *cname, utf *mname, utf *desc,
87                                                                 bool isstatic)
88 {
89         /* return something different than NULL, otherwise we get an exception */
90
91         return (functionptr) 1;
92 }
93
94 java_objectheader *native_new_and_init(classinfo *c) { return NULL; }
95 java_objectheader *native_new_and_init_string(classinfo *c, java_lang_String *s) { return NULL; }
96 java_objectheader *native_new_and_init_int(classinfo *c, s4 i) { return NULL; }
97 java_objectheader *native_new_and_init_throwable(classinfo *c, java_lang_Throwable *t) { return NULL; }
98
99
100 java_objectheader *asm_calljavafunction(methodinfo *m, void *arg1, void *arg2,
101                                                                                 void *arg3, void *arg4) { return NULL; }
102
103 void asm_call_jit_compiler(void) {}
104
105 /* code patching functions */
106 void patcher_builtin_new(u1 *sp) {}
107 void patcher_builtin_newarray(u1 *sp) {}
108 void patcher_builtin_arraycheckcast(u1 *sp) {}
109 void patcher_builtin_arrayinstanceof(u1 *sp) {}
110
111 s4 asm_builtin_idiv(s4 a, s4 b) { return 0; }
112 s4 asm_builtin_irem(s4 a, s4 b) { return 0; }
113 s8 asm_builtin_ldiv(s8 a, s8 b) { return 0; }
114 s8 asm_builtin_lrem(s8 a, s8 b) { return 0; }
115
116 s4 asm_builtin_f2i(float a) { return 0; }
117 s8 asm_builtin_f2l(float a) { return 0; }
118 s4 asm_builtin_d2i(double a) { return 0; }
119 s8 asm_builtin_d2l(double a) { return 0; }
120
121 void use_class_as_object(void) {}
122 void asm_builtin_monitorenter(java_objectheader *o) {}
123 void *asm_builtin_monitorexit(java_objectheader *o) { return NULL; }
124
125 s4 asm_builtin_arraycheckcast(java_objectheader *obj, vftbl_t *target)
126 {
127         return 0;
128 }
129
130 #if defined(__MIPS__)
131 long compare_and_swap(long *p, long oldval, long newval)
132 {
133         if (*p == oldval) {
134                 *p = newval;
135                 return oldval;
136         } else
137                 return *p;
138 }
139 #endif
140
141
142 void asm_builtin_aastore(java_objectarray *a, s4 index, java_objectheader *o) {}
143
144 functionptr createcompilerstub(methodinfo *m) { return NULL; }
145 functionptr codegen_createnativestub(functionptr f, methodinfo *m) { return NULL; }
146
147 void removecompilerstub(functionptr stub) {}
148 void removenativestub(functionptr stub) {}
149
150 void asm_perform_threadswitch(u1 **from, u1 **to, u1 **stackTop) {}
151 u1* asm_initialize_thread_stack(void *func, u1 *stack) { return NULL; }
152
153 void *asm_switchstackandcall(void *stack, void *func, void **stacktopsave, void * p) { return NULL; }
154
155 void asm_handle_builtin_exception(classinfo *c) {}
156 void asm_getclassvalues_atomic(vftbl_t *super, vftbl_t *sub, castinfo *out) {}
157
158
159 void setVMClassField(classinfo *c) {}
160 void *Java_java_lang_VMObject_clone(void *env, void *clazz, void * this)
161 {
162         return NULL;
163 }
164
165 typecheck_result typeinfo_is_assignable_to_class(typeinfo *value,classref_or_classinfo dest)
166 {
167         return typecheck_TRUE;
168 }
169
170 void typeinfo_init_classinfo(typeinfo *info,classinfo *c)
171 {
172 }
173
174 bool typeinfo_init_class(typeinfo *info,classref_or_classinfo c)
175 {
176         return true;
177 }
178
179 void typeinfo_print(FILE *file,typeinfo *info,int indent) {}
180
181 void exceptions_print_exception(java_objectheader *xptr) {}
182 void stacktrace_print_trace(java_objectheader *xptr) {}
183
184
185 /* exception functions ********************************************************/
186
187 /* these should not be called */
188
189 void throw_main_exception_exit(void) { assert(0); }
190 void throw_exception(void) { assert(0); }
191 void throw_exception_exit(void) { assert(0); }
192
193 java_objectheader *new_verifyerror(methodinfo *m, const char *message)
194 {
195         assert(0);
196
197         /* keep compiler happy */
198
199         return NULL;
200 }
201
202 java_objectheader *new_exception_throwable(const char *classname, java_lang_Throwable *throwable)
203 {
204         assert(0);
205
206         /* keep compiler happy */
207
208         return NULL;
209 }
210
211
212 void throw_cacao_exception_exit(const char *exception, const char *message, ...)
213 {
214         va_list ap;
215
216         fprintf(stderr, "%s: ", exception);
217
218         va_start(ap, message);
219         vfprintf(stderr, message, ap);
220         va_end(ap);
221
222         fputc('\n', stderr);
223
224         exit(1);
225 }
226
227
228 void exceptions_throw_outofmemory_exit(void)
229 {
230         fprintf(stderr, "java.lang.InternalError: Out of memory\n");
231         exit(1);
232 }
233
234
235 java_objectheader *new_exception(const char *classname)
236 {
237         fprintf(stderr, "%s\n", classname);
238         exit(1);
239
240         /* keep compiler happy */
241
242         return NULL;
243 }
244
245
246 java_objectheader *new_exception_message(const char *classname, const char *message)
247 {
248         fprintf(stderr, "%s: %s\n", classname, message);
249         exit(1);
250
251         /* keep compiler happy */
252
253         return NULL;
254 }
255
256
257 java_objectheader *new_exception_utfmessage(const char *classname, utf *message)
258 {
259         fprintf(stderr, "%s: ", classname);
260         utf_display(message);
261         fputc('\n', stderr);
262
263         exit(1);
264
265         /* keep compiler happy */
266
267         return NULL;
268 }
269
270
271 java_objectheader *new_exception_javastring(const char *classname,
272                                                                                         java_lang_String *message)
273 {
274         fprintf(stderr, "%s: ", classname);
275         /* TODO print message */
276         fputc('\n', stderr);
277
278         exit(1);
279
280         /* keep compiler happy */
281
282         return NULL;
283 }
284
285
286 java_objectheader *new_classformaterror(classinfo *c, const char *message, ...)
287 {
288         va_list ap;
289
290         utf_display(c->name);
291         fprintf(stderr, ": ");
292
293         va_start(ap, message);
294         vfprintf(stderr, message, ap);
295         va_end(ap);
296
297         fputc('\n', stderr);
298
299         exit(1);
300
301         /* keep compiler happy */
302
303         return NULL;
304 }
305
306
307 java_objectheader *new_classnotfoundexception(utf *name)
308 {
309         fprintf(stderr, "java.lang.ClassNotFoundException: ");
310         utf_fprint(stderr, name);
311         fputc('\n', stderr);
312
313         exit(1);
314
315         /* keep compiler happy */
316
317         return NULL;
318 }
319
320
321 java_objectheader *new_noclassdeffounderror(utf *name)
322 {
323         fprintf(stderr, "java.lang.NoClassDefFoundError: ");
324         utf_fprint(stderr, name);
325         fputc('\n', stderr);
326
327         exit(1);
328
329         /* keep compiler happy */
330
331         return NULL;
332 }
333
334
335 java_objectheader *exceptions_new_nosuchmethoderror(classinfo *c,
336                                                                                                         utf *name, utf *desc)
337 {
338         fprintf(stderr, "java.lang.NoSuchMethodError: ");
339         utf_fprint(stderr, c->name);
340         fprintf(stderr, ".");
341         utf_fprint(stderr, name);
342         utf_fprint(stderr, desc);
343         fputc('\n', stderr);
344
345         exit(1);
346
347         /* keep compiler happy */
348
349         return NULL;
350 }
351
352
353 java_objectheader *new_internalerror(const char *message, ...)
354 {
355         va_list ap;
356
357         fprintf(stderr, "%s: ", string_java_lang_InternalError);
358
359         va_start(ap, message);
360         vfprintf(stderr, message, ap);
361         va_end(ap);
362
363         exit(1);
364
365         /* keep compiler happy */
366
367         return NULL;
368 }
369
370
371 java_objectheader *new_unsupportedclassversionerror(classinfo *c, const char *message, ...)
372 {
373         va_list ap;
374
375         fprintf(stderr, "%s: ", string_java_lang_UnsupportedClassVersionError);
376
377         utf_display(c->name);
378         fprintf(stderr, ": ");
379
380         va_start(ap, message);
381         vfprintf(stderr, message, ap);
382         va_end(ap);
383
384         exit(1);
385
386         /* keep compiler happy */
387
388         return NULL;
389 }
390
391
392 java_objectheader *new_illegalmonitorstateexception(void)
393 {
394         fprintf(stderr, "%s", string_java_lang_IllegalMonitorStateException);
395         exit(1);
396
397         /* keep compiler happy */
398
399         return NULL;
400 }
401
402
403 java_objectheader *new_negativearraysizeexception(void)
404 {
405         fprintf(stderr, "%s", string_java_lang_NegativeArraySizeException);
406         exit(1);
407
408         /* keep compiler happy */
409
410         return NULL;
411 }
412
413
414 java_objectheader *new_nullpointerexception(void)
415 {
416         fprintf(stderr, "%s", string_java_lang_NullPointerException);
417         exit(1);
418
419         /* keep compiler happy */
420
421         return NULL;
422 }
423
424 void classnotfoundexception_to_noclassdeffounderror(void)
425 {
426 }
427
428 /* machine dependent stuff ****************************************************/
429
430 #if defined(USE_THREADS) && defined(NATIVE_THREADS)
431 threadcritnode asm_criticalsections;
432 void thread_restartcriticalsection(ucontext_t *uc) {}
433 #endif
434
435 void md_param_alloc(methoddesc *md) {}
436
437
438 /************************ global variables **********************/
439
440 chain *nativemethod_chain;              /* chain with native methods          */
441 chain *nativeclass_chain;               /* chain with processed classes       */
442 chain *ident_chain;     /* chain with method and field names in current class */
443 FILE *file = NULL;
444 static u4 outputsize;
445 static bool dopadding;
446
447
448 static void printIDpart(int c)
449 {
450         if ((c >= 'a' && c <= 'z') ||
451                 (c >= 'A' && c <= 'Z') ||
452                 (c >= '0' && c <= '9') ||
453                 (c == '_'))
454                 putc(c, file);
455         else
456                 putc('_', file);
457 }
458
459
460 void printID(utf *u)
461 {
462         char *utf_ptr = u->text;
463         int i;
464
465         for (i = 0; i < utf_strlen(u); i++) 
466                 printIDpart(utf_nextu2(&utf_ptr));
467 }
468
469
470 static void addoutputsize (int len)
471 {
472         u4 newsize,i;
473         if (!dopadding) return;
474
475         newsize = ALIGN(outputsize, len);
476         
477         for (i = outputsize; i < newsize; i++) fprintf(file, "   u1 pad%d\n", (int) i);
478         outputsize = newsize;
479 }
480
481
482 void printOverloadPart(utf *desc)
483 {
484         char *utf_ptr=desc->text;
485         u2 c;
486
487         fprintf(file, "__");
488
489         while ((c = utf_nextu2(&utf_ptr)) != ')') {
490                 switch (c) {
491                 case 'I':
492                 case 'S':
493                 case 'B':
494                 case 'C':
495                 case 'Z':
496                 case 'J':
497                 case 'F':
498                 case 'D': 
499                         fprintf(file, "%c", (char) c);
500                         break;
501                 case '[':
502                         fprintf(file, "_3");
503                         break;
504                 case 'L':
505                         putc('L', file);
506                         while ((c = utf_nextu2(&utf_ptr)) != ';')
507                                 printIDpart(c);
508                         fprintf(file, "_2");
509                         break;
510                 case '(':
511                         break;
512                 default: 
513                         log_text("invalid method descriptor");
514                         assert(0);
515                 }
516         }
517 }
518
519 static char *printtype(char *utf_ptr)
520 {
521         u2 c;
522
523         switch (utf_nextu2(&utf_ptr)) {
524         case 'V': fprintf (file, "void");
525                 break;
526         case 'I':
527         case 'S':
528         case 'B':
529         case 'C':
530         case 'Z': addoutputsize (4);
531                 fprintf (file, "s4");
532                 break;
533         case 'J': addoutputsize (8);
534                 fprintf (file, "s8");
535                 break;
536         case 'F': addoutputsize (4);
537                 fprintf (file, "float");
538                 break;
539         case 'D': addoutputsize (8);
540                 fprintf (file, "double");
541                 break;
542         case '[':
543                 addoutputsize ( sizeof(java_arrayheader*) ); 
544                 switch (utf_nextu2(&utf_ptr)) {
545                 case 'I':  fprintf (file, "java_intarray*"); break;
546                 case 'J':  fprintf (file, "java_longarray*"); break;
547                 case 'Z':  fprintf (file, "java_booleanarray*"); break;
548                 case 'B':  fprintf (file, "java_bytearray*"); break;
549                 case 'S':  fprintf (file, "java_shortarray*"); break;
550                 case 'C':  fprintf (file, "java_chararray*"); break;
551                 case 'F':  fprintf (file, "java_floatarray*"); break;
552                 case 'D':  fprintf (file, "java_doublearray*"); break;
553                                 
554                 case '[': fprintf(file, "java_objectarray*");
555                         while ((c = utf_nextu2(&utf_ptr)) == '[');
556                         if (c == 'L')
557                                 while (utf_nextu2(&utf_ptr) != ';');
558                         break;
559                            
560                 case 'L':  fprintf(file, "java_objectarray*");
561                         while (utf_nextu2(&utf_ptr) != ';');
562                         break;
563                 default:
564                         log_text("invalid type descriptor");
565                         assert(0);
566                 }
567                 break;
568                 
569         case 'L': 
570                 addoutputsize ( sizeof(java_objectheader*));
571                 fprintf (file, "struct ");
572                 while ( (c = utf_nextu2(&utf_ptr)) != ';' ) printIDpart (c);     
573                 fprintf (file, "*");
574                 break;
575                                         
576         default:
577                 log_text("Unknown type in field descriptor");
578                 assert(0);
579         }
580         
581         return utf_ptr;
582 }
583
584
585 /***** determine the number of entries of a utf string in the ident chain *****/
586
587 static int searchidentchain_utf(utf *ident) 
588 {
589         utf *u = chain_first(ident_chain);     /* first element of list */
590         int count = 0;
591
592         while (u) {
593                 if (u==ident) count++;         /* string found */
594                 u = chain_next(ident_chain);   /* next element in list */ 
595         }
596
597         return count;
598 }
599
600
601 /************** print structure for direct access to objects ******************/
602
603 static void printfields(classinfo *c)
604 {
605         u4 i;
606         fieldinfo *f;
607         int ident_count;
608         
609         if (!c) {
610                 addoutputsize(sizeof(java_objectheader));
611                 fprintf(file, "   java_objectheader header;\n");
612                 return;
613         }
614                 
615         printfields(c->super.cls);
616         
617         for (i = 0; i < c->fieldscount; i++) {
618                 f = &(c->fields[i]);
619                 
620                 if (!(f->flags & ACC_STATIC)) {
621                         fprintf(file, "   ");
622                         printtype(f->descriptor->text);
623                         fprintf(file, " ");
624                         utf_fprint(file, f->name);
625
626                         /* rename multiple fieldnames */
627                         if ((ident_count = searchidentchain_utf(f->name)))
628                                 fprintf(file, "%d", ident_count - 1);
629                         chain_addlast(ident_chain, f->name);    
630
631                         fprintf(file, ";\n");
632                 }
633         }
634 }
635
636
637 /***************** store prototype for native method in file ******************/
638
639 void printmethod(methodinfo *m)
640 {
641         char *utf_ptr;
642         u2 paramnum = 1;
643
644         /* search for return-type in descriptor */      
645         utf_ptr = m->descriptor->text;
646         while (utf_nextu2(&utf_ptr) != ')');
647
648         /* create remarks */
649         fprintf(file, "\n/*\n * Class:     ");
650         utf_fprint(file, m->class->name);
651         fprintf(file, "\n * Method:    ");
652         utf_fprint(file, m->name);
653         fprintf(file, "\n * Signature: ");
654         utf_fprint(file, m->descriptor);
655         fprintf(file, "\n */\n");
656
657         /* create prototype */                  
658         fprintf(file, "JNIEXPORT ");
659         printtype(utf_ptr);
660         fprintf(file, " JNICALL Java_");
661         printID(m->class->name);
662
663         chain_addlast(ident_chain, m->name);
664
665         fprintf(file, "_");
666         printID(m->name);
667         if (m->nativelyoverloaded) printOverloadPart(m->descriptor);
668         fprintf(file, "(JNIEnv *env");
669         
670         utf_ptr = m->descriptor->text + 1;
671                         
672         if (!(m->flags & ACC_STATIC)) {
673                 fprintf(file, ", struct ");
674                 printID(m->class->name);
675                 fprintf(file, "* this");
676
677         } else {
678                 fprintf(file, ", jclass clazz");
679         }
680
681         if ((*utf_ptr) != ')') fprintf(file, ", ");
682                         
683         while ((*utf_ptr) != ')') {
684                 utf_ptr = printtype(utf_ptr);
685                 fprintf(file, " par%d", paramnum++);
686                 if ((*utf_ptr)!=')') fprintf(file, ", ");
687         }
688                         
689         fprintf(file, ");\n\n");
690 }
691
692
693 /******* remove package-name in fully-qualified classname *********************/
694
695 void gen_header_filename(char *buffer, utf *u)
696 {
697         s4 i;
698   
699         for (i = 0; i < utf_strlen(u); i++) {
700                 if ((u->text[i] == '/') || (u->text[i] == '$')) {
701                         buffer[i] = '_';  /* convert '$' and '/' to '_' */
702
703                 } else {
704                         buffer[i] = u->text[i];
705                 }
706         }
707         buffer[utf_strlen(u)] = '\0';
708 }
709
710
711 /* create headerfile for classes and store native methods in chain ************/
712
713 void headerfile_generate(classinfo *c, char *opt_directory)
714 {
715         char header_filename[1024] = "";
716         char classname[1024]; 
717         char uclassname[1024];
718         u2 i;
719         methodinfo *m;                  
720         u2 i2;
721         methodinfo *m2;
722         u2 nativelyoverloaded;                  
723                       
724         /* store class in chain */                    
725         chain_addlast(nativeclass_chain, c);
726                                 
727         /* open headerfile for class */
728         gen_header_filename(classname, c->name);
729
730         /* create chain for renaming fields */
731         ident_chain = chain_new();
732         
733         if (opt_directory) {
734                 sprintf(header_filename, "%s/%s.h", opt_directory, classname);
735
736         } else {
737                 sprintf(header_filename, "%s.h", classname);
738         }
739
740         file = fopen(header_filename, "w");
741         if (!file) {
742                 log_text("Can not open file to store header information");
743                 assert(0);
744         }
745
746         fprintf(file, "/* This file is machine generated, don't edit it! */\n\n");
747
748         /* convert to uppercase */
749         for (i = 0; classname[i]; i++) {
750                 uclassname[i] = toupper(classname[i]);
751         }
752         uclassname[i] = '\0';
753
754         fprintf(file, "#ifndef _%s_H\n#define _%s_H\n\n", uclassname, uclassname);
755
756         /* create structure for direct access to objects */     
757         fprintf(file, "/* Structure information for class: ");
758         utf_fprint(file, c->name);
759         fprintf(file, " */\n\n");
760         fprintf(file, "typedef struct ");
761         printID(c->name);                                                       
762         fprintf(file, " {\n");
763         outputsize = 0;
764         dopadding = true;
765
766         printfields(c);
767
768         fprintf(file, "} ");
769         printID(c->name);
770         fprintf(file, ";\n\n");
771
772         /* create chain for renaming overloaded methods */
773         chain_free(ident_chain);
774         ident_chain = chain_new();
775
776         /* create method-prototypes */
777                                 
778         /* find overloaded methods */
779         for (i = 0; i < c->methodscount; i++) {
780
781                 m = &(c->methods[i]);
782
783                 if (!(m->flags & ACC_NATIVE)) continue;
784                 if (!m->nativelyoverloaded) {
785                         nativelyoverloaded=false;
786                         for (i2=i+1;i2<c->methodscount; i2++) {
787                                 m2 = &(c->methods[i2]);
788                                 if (!(m2->flags & ACC_NATIVE)) continue;
789                                 if (m->name==m2->name) {
790                                         m2->nativelyoverloaded=true;
791                                         nativelyoverloaded=true;
792                                 }
793                         }
794                         m->nativelyoverloaded=nativelyoverloaded;
795                 }
796
797         }
798
799         for (i = 0; i < c->methodscount; i++) {
800
801                 m = &(c->methods[i]);
802
803                 if (m->flags & ACC_NATIVE) {
804                         chain_addlast(nativemethod_chain, m);
805                         printmethod(m);
806                 }
807         }
808
809         chain_free(ident_chain);
810
811         fprintf(file, "#endif\n\n");
812
813         fclose(file);
814 }
815
816
817 /******** print classname, '$' used to seperate inner-class name ***********/
818
819 void print_classname(classinfo *clazz)
820 {
821         utf *u = clazz->name;
822     char *endpos  = u->text + u->blength;
823     char *utf_ptr = u->text; 
824         u2 c;
825
826     while (utf_ptr < endpos) {
827                 if ((c = utf_nextu2(&utf_ptr)) == '_')
828                         putc('$', file);
829                 else
830                         putc(c, file);
831         }
832
833
834
835 /*
836  * These are local overrides for various environment variables in Emacs.
837  * Please do not remove this and leave it at the end of the file, where
838  * Emacs will automagically detect them.
839  * ---------------------------------------------------------------------
840  * Local variables:
841  * mode: c
842  * indent-tabs-mode: t
843  * c-basic-offset: 4
844  * tab-width: 4
845  * End:
846  */