1 /* src/vm/jit/mips/asmpart.S - Java-C interface functions for mips
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
8 This file is part of CACAO.
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.
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.
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
25 Contact: cacao@complang.tuwien.ac.at
27 Authors: Andreas Krall
29 Changes: Christian Thalinger
31 $Id: asmpart.S 3055 2005-07-18 21:58:32Z twisti $
38 #include "vm/jit/mips/offsets.h"
39 #include "vm/jit/mips/asmoffsets.h"
40 #include "vm/jit/mips/md-asm.h"
47 /* exported functions and variables *******************************************/
49 .globl asm_calljavafunction
50 .globl asm_calljavafunction_int
52 .globl asm_calljavafunction2
53 .globl asm_calljavafunction2int
54 .globl asm_calljavafunction2long
55 .globl asm_calljavafunction2float
56 .globl asm_calljavafunction2double
58 .globl asm_call_jit_compiler
59 .globl asm_handle_exception
60 .globl asm_handle_nat_exception
62 .globl asm_wrapper_patcher
64 .globl asm_perform_threadswitch
65 .globl asm_initialize_thread_stack
66 .globl asm_switchstackandcall
67 .globl asm_getclassvalues_atomic
68 .globl asm_criticalsections
70 .globl compare_and_swap
73 /********************* function asm_calljavafunction ***************************
75 * This function calls a Java-method (which possibly needs compilation) *
76 * with up to 4 address parameters. *
78 * This functions calls the JIT-compiler which eventually translates the *
79 * method into machine code. *
81 * A possibly throwed exception will be returned to the caller as function *
82 * return value, so the java method cannot return a fucntion value (this *
83 * function usually calls 'main' and '<clinit>' which do not return a *
87 * javaobject_header *asm_calljavafunction (methodinfo *m, *
88 * void *arg1, void *arg2, void *arg3, void *arg4); *
90 *******************************************************************************/
92 .ent asm_calljavafunction
96 .dword 0 /* catch type all */
97 .dword calljava_xhandler /* handler pc */
98 .dword calljava_xhandler /* end pc */
99 .dword asm_calljavafunction /* start pc */
100 .word 1 /* extable size */
101 .word 0 /* 4-byte ALIGNMENT PADDING */
102 .dword 0 /* line number table start */
103 .dword 0 /* line number table size */
104 .word 0 /* 4-byte ALIGNMENT PADDING */
105 .word 0 /* fltsave */
106 .word 0 /* intsave */
109 .word 10*8 /* frame size */
110 .dword 0 /* method pointer (pointer to name) */
112 asm_calljavafunction:
113 asm_calljavafunction_int:
114 aaddiu sp,sp,-10*8 /* allocate stack space */
115 ast ra,0(sp) /* save return address */
120 ast pv,3*8(sp) /* procedure vector (delay slot) */
126 sdc1 fss0,4*8(sp) /* save non JavaABI saved flt registers */
133 move itmp1,a0 /* pass method pointer via tmp1 */
135 move a0,a1 /* pass the remaining parameters */
140 ala mptr,asm_call_jit_compiler/* fake virtual function call (2 instr) */
141 ast mptr,1*8(sp) /* store function address */
142 move mptr,sp /* set method pointer */
146 ald pv,1*8(mptr) /* method call as in Java */
147 jalr pv /* call JIT compiler */
149 aaddiu pv,ra,-22*4 /* recompute procedure vector */
154 ald ra,0(sp) /* restore return address */
155 ald pv,3*8(sp) /* restore procedure vector */
157 ldc1 fss0,4*8(sp) /* restore non JavaABI saved flt regs */
164 aaddiu sp,sp,10*8 /* free stack space */
169 jal builtin_throw_exception
170 move v0,zero /* clear return value for exception */
173 .end asm_calljavafunction
176 .ent asm_calljavafunction2
180 .dword 0 /* catch type all */
181 .dword calljava_xhandler2 /* handler pc */
182 .dword calljava_xhandler2 /* end pc */
183 .dword asm_calljavafunction2 /* start pc */
184 .word 1 /* extable size */
185 .word 0 /* 4-byte ALIGNMENT PADDING */
186 .dword 0 /* line number table start */
187 .dword 0 /* line number table size */
188 .word 0 /* 4-byte ALIGNMENT PADDING */
189 .word 0 /* fltsave */
190 .word 1 /* intsave */
193 .word 12*8 /* frame size */
194 .dword 0 /* method pointer (pointer to name) */
196 asm_calljavafunction2:
197 asm_calljavafunction2int:
198 asm_calljavafunction2long:
199 asm_calljavafunction2float:
200 asm_calljavafunction2double:
201 aaddiu sp,sp,-12*8 /* allocate stack space (only 11 needed)*/
202 ast ra,0(sp) /* save return address */
206 ast pv,1*8(sp) /* procedure vector */
213 sdc1 fss0,5*8(sp) /* save non JavaABI saved flt registers */
220 ast a0,4*8(sp) /* save method pointer for compiler */
224 blez s7,calljava_argsloaded
226 ald a0,offjniitem(t0)
227 ldc1 fa0,offjniitem(t0)
229 blez s7,calljava_argsloaded
231 ald a1,offjniitem+sizejniblock*1(t0)
232 ldc1 fa1,offjniitem+sizejniblock*1(t0)
234 blez s7,calljava_argsloaded
236 ald a2,offjniitem+sizejniblock*2(t0)
237 ldc1 fa2,offjniitem+sizejniblock*2(t0)
239 blez s7,calljava_argsloaded
241 ald a3,offjniitem+sizejniblock*3(t0)
242 ldc1 fa3,offjniitem+sizejniblock*3(t0)
244 blez s7,calljava_argsloaded
246 ald a4,offjniitem+sizejniblock*4(t0)
247 ldc1 fa4,offjniitem+sizejniblock*4(t0)
249 blez s7,calljava_argsloaded
251 ald a5,offjniitem+sizejniblock*5(t0)
252 ldc1 fa5,offjniitem+sizejniblock*5(t0)
254 blez s7,calljava_argsloaded
256 ald a6,offjniitem+sizejniblock*6(t0)
257 ldc1 fa6,offjniitem+sizejniblock*6(t0)
259 blez s7,calljava_argsloaded
261 ald a7,offjniitem+sizejniblock*7(t0)
262 ldc1 fa7,offjniitem+sizejniblock*7(t0)
266 move t8,sp /* save stack pointer */
267 blez s7,calljava_nocopy
274 ald t3,offjniitem+sizejniblock*8(t0)
277 ala t0,sizejniblock(t0)
279 bnez t1,calljava_copyloop
282 ald itmp1,4*8(t8) /* pass method pointer via itmp1 */
284 ala mptr,asm_call_jit_compiler/* fake virtual function call (2 instr) */
285 ast mptr,2*8(sp) /* store function address */
286 ala mptr,1*8(sp) /* set method pointer */
290 ald pv,1*8(mptr) /* method call as in Java */
291 jalr pv /* call JIT compiler */
293 aaddiu pv,ra,-76*4 /* recompute procedure vector */
298 ald ra,0(sp) /* restore return address */
299 ald pv,8(sp) /* restore procedure vector */
302 ldc1 fss0,5*8(sp) /* restore non JavaABI saved flt regs */
309 aaddiu sp,sp,12*8 /* free stack space */
316 jal builtin_throw_exception
319 .end asm_calljavafunction2
322 /****************** function asm_call_jit_compiler *****************************
324 * invokes the compiler for untranslated JavaVM methods. *
326 * Register REG_ITEMP1 contains a pointer to the method info structure *
327 * (prepared by createcompilerstub). Using the return address in R31 and the *
328 * offset in the LDA instruction or using the value in methodptr R25 the *
329 * patching address for storing the method address can be computed: *
331 * method address was either loaded using *
332 * M_ALD (REG_PV, REG_PV, a) ; invokestatic/special ($28) *
333 * M_JSR (REG_RA, REG_PV); *
335 * M_LDA (REG_PV, REG_RA, val) *
337 * M_ALD (REG_PV, REG_METHODPTR, m) ; invokevirtual/interface ($25) *
338 * M_JSR (REG_RA, REG_PV); *
340 * in the static case the method pointer can be computed using the *
341 * return address and the lda function following the jmp instruction *
343 *******************************************************************************/
346 .ent asm_call_jit_compiler
348 asm_call_jit_compiler:
349 lw t0,-12(ra) /* load instruction LD PV,xxx($y) */
350 srl t0,t0,21 /* shift right register number $y */
351 and t0,t0,31 /* isolate register number */
352 addiu t0,t0,-mptrreg /* test for REG_METHODPTR */
355 lw t0,0(ra) /* load instruction LDA PV,xxx(RA) */
357 sra t0,t0,16 /* isolate offset */
358 aaddu mptr,t0,ra /* compute update address */
361 aaddiu sp,sp,-(20*8+sizestackframeinfo) /* allocate stack space */
363 SAVE_ARGUMENT_REGISTERS(0)
365 ast mptr,16*8(sp) /* save method pointer */
366 ast ra,17*8(sp) /* save return address */
367 ast itmp1,18*8(sp) /* save methodinfo pointer */
369 aaddiu a0,sp,20*8 /* create stackframe info */
370 move a1,zero /* we don't have pv handy */
371 aaddiu a2,sp,(20*8+sizestackframeinfo) /* pass java sp */
372 move a3,ra /* pass java ra */
373 move a4,a3 /* xpc is equal to ra */
374 jal stacktrace_create_extern_stackframeinfo
376 ald a0,18*8(sp) /* pass methodinfo pointer */
377 jal jit_compile /* jit compiler */
378 ast v0,18*8(sp) /* save return value */
380 aaddiu a0,sp,20*8 /* remove stackframe info */
381 jal stacktrace_remove_stackframeinfo
383 RESTORE_ARGUMENT_REGISTERS(0)
385 ald mptr,16*8(sp) /* restore method pointer */
386 ald ra,17*8(sp) /* restore return address */
387 ald v0,18*8(sp) /* restore return value */
388 aaddiu sp,sp,20*8+sizestackframeinfo /* deallocate stack area */
390 beqz v0,L_asm_call_jit_compiler_exception
392 lw t0,-12(ra) /* load instruction LDQ PV,xxx($yy) */
394 sra t0,t0,16 /* isolate offset */
396 aaddu t0,t0,mptr /* compute update address via method pointer*/
397 ast v0,0(t0) /* save new method address there */
399 move pv,v0 /* move method address into pv */
401 jr pv /* and call method. The method returns */
402 /* directly to the caller (ra). */
404 L_asm_call_jit_compiler_exception:
405 #if defined(USE_THREADS) && defined(NATIVE_THREADS)
408 jal builtin_asm_get_exceptionptrptr
414 ald xptr,0(v0) /* get the exception pointer */
415 ast zero,0(v0) /* clear the exception pointer */
417 aaddiu xpc,ra,-4 /* faulting address is return adress - 4 */
418 b asm_handle_nat_exception
420 .end asm_call_jit_compiler
423 /********************* function asm_handle_exception ***************************
425 * This function handles an exception. It does not use the usual calling *
426 * conventions. The exception pointer is passed in REG_ITMP1 and the *
427 * pc from the exception raising position is passed in REG_ITMP2. It searches *
428 * the local exception table for a handler. If no one is found, it unwinds *
429 * stacks and continues searching the callers. *
431 * void asm_handle_exception (exceptionptr, exceptionpc); *
433 *******************************************************************************/
435 .ent asm_handle_nat_exception
437 asm_handle_nat_exception:
438 lw t0,0(ra) /* load instruction LDA PV,xxx(RA) */
440 sra t0,t0,16 /* isolate offset */
441 aaddu pv,t0,ra /* compute update address */
443 .aent asm_handle_exception
445 asm_handle_exception:
446 aaddiu sp,sp,-14*8 /* allocate stack */
448 sd v0,0*8(sp) /* save possible used registers */
449 sd t0,1*8(sp) /* also registers used by trace_exception */
463 addu t3,zero,1 /* set no unwind flag */
465 aaddiu sp,sp,-6*8 /* allocate stack */
466 sd xptr,0*8(sp) /* save used registers */
473 ald a1,MethodPointer(pv)
478 jal builtin_trace_exception /* trace_exception(xptr,methodptr) */
480 ld xptr,0*8(sp) /* restore used register */
485 aaddiu sp,sp,6*8 /* deallocate stack */
487 lw t0,ExTableSize(pv) /* t0 = exception table size */
488 beqz t0,empty_table /* if empty table skip */
489 aaddiu t1,pv,ExTableStart /* t1 = start of exception table */
492 ald t2,ExStartPC(t1) /* t2 = exception start pc */
493 sle t2,t2,xpc /* t2 = (startpc <= xpc) */
494 beqz t2,ex_table_cont /* if (false) continue */
495 ald t2,ExEndPC(t1) /* t2 = exception end pc */
496 slt t2,xpc,t2 /* t2 = (xpc < endpc) */
497 beqz t2,ex_table_cont /* if (false) continue */
498 ald a1,ExCatchType(t1) /* arg1 = exception catch type */
499 beqz a1,ex_handle_it /* NULL catches everything */
501 lw itmp3,offclassloaded(a1)
502 bnez itmp3,L_class_loaded
504 aaddiu sp,sp,-8*8 /* allocate stack */
505 sd t0,0*8(sp) /* save used register */
515 jal load_class_bootstrap
517 ld t0,0*8(sp) /* restore used register */
525 aaddiu sp,sp,8*8 /* deallocate stack */
528 lw itmp3,offclasslinked(a1)
529 aaddiu sp,sp,-8*8 /* allocate stack */
531 bnez itmp3,L_class_linked
533 sd t0,0*8(sp) /* save used register */
544 ld t0,0*8(sp) /* restore used register */
556 ald a0,offobjvftbl(xptr) /* a0 = vftblptr(xptr) */
557 ald a1,offclassvftbl(a1) /* a1 = vftblptr(catchtype) class (not obj) */
558 lw a0,offbaseval(a0) /* a0 = baseval(xptr) */
559 lw v0,offbaseval(a1) /* a2 = baseval(catchtype) */
560 lw a1,offdiffval(a1) /* a1 = diffval(catchtype) */
562 subu a0,a0,v0 /* a0 = baseval(xptr) - baseval(catchtype) */
563 sltu v0,a1,a0 /* v0 = xptr is instanceof catchtype */
564 aaddiu sp,sp,8*8 /* deallocate stack */
565 bnez v0,ex_table_cont /* if (false) continue */
568 ald xpc,ExHandlerPC(t1) /* xpc = exception handler pc */
570 beqz t3,ex_jump /* if (!(no stack unwinding) skip */
572 ld v0,0*8(sp) /* restore possible used registers */
573 ld t0,1*8(sp) /* also registers used by trace_exception */
587 aaddiu sp,sp,14*8 /* deallocate stack */
590 jr xpc /* jump to the handler */
593 aaddiu t1,t1,ExEntrySize /* next exception table entry */
594 addiu t0,t0,-1 /* decrement entry counter */
595 bgtz t0,ex_table_loop /* if (t0 > 0) next entry */
598 beqz t3,ex_already_cleared /* if here the first time, then */
599 aaddiu sp,sp,14*8 /* deallocate stack and */
600 move t3,zero /* clear the no unwind flag */
602 lw t0,IsSync(pv) /* t0 = SyncOffset */
603 beqz t0,no_monitor_exit /* if zero no monitorexit */
605 #if defined(USE_THREADS)
606 aaddu t0,sp,t0 /* add stackptr to Offset */
607 ald a0,-8(t0) /* load monitorexit pointer */
609 aaddiu sp,sp,-8*8 /* allocate stack */
610 sd t0,0*8(sp) /* save used register */
618 jal builtin_monitorexit /* builtin_monitorexit(objectptr) */
620 ld t0,0*8(sp) /* restore used register */
627 aaddiu sp,sp,8*8 /* deallocate stack */
631 lw t0,FrameSize(pv) /* t0 = frame size */
632 aaddu sp,sp,t0 /* unwind stack */
633 move t0,sp /* t0 = pointer to save area */
634 lw t1,IsLeaf(pv) /* t1 = is leaf procedure */
635 bnez t1,ex_no_restore /* if (leaf) skip */
636 ld ra,-8(t0) /* restore ra */
637 aaddiu t0,t0,-8 /* t0-- */
639 move xpc,ra /* the new xpc is ra */
640 lw t1,IntSave(pv) /* t1 = saved int register count */
641 ala t2,ex_int2 /* t2 = current pc */
642 sll t1,t1,2 /* t1 = register count * 4 */
643 asubu t2,t2,t1 /* t2 = ex_int_sav - 4 * register count */
644 jr t2 /* jump to save position */
654 sll t1,t1,1 /* t1 = register count * 4 * 2 */
655 asubu t0,t0,t1 /* t0 = t0 - 8 * register count */
657 lw t1,FltSave(pv) /* t1 = saved flt register count */
658 ala t2,ex_flt2 /* t2 = current pc */
659 sll t1,t1,2 /* t1 = register count * 4 */
660 asubu t2,t2,t1 /* t2 = ex_int_sav - 4 * register count */
661 jr t2 /* jump to save position */
667 lw t0,0(ra) /* load instruction LDA PV,xxx(RA) */
669 sra t0,t0,16 /* isolate offset */
670 aaddu pv,t0,ra /* compute update address */
673 .end asm_handle_nat_exception
676 /* asm_wrapper_patcher *********************************************************
681 32 return address into JIT code (patch position)
682 24 pointer to virtual java_objectheader
683 16 machine code (which is patched back later)
684 8 unresolved class/method/field reference
685 0 patcher function pointer to call
687 *******************************************************************************/
689 .ent asm_wrapper_patcher
692 aaddiu sp,sp,-((16+21+4)*8+sizestackframeinfo) /* create stack frame */
694 SAVE_ARGUMENT_REGISTERS(0) /* save 8 int/8 float argument registers */
695 SAVE_TEMPORARY_REGISTERS(16) /* save 5 int/16 float temporary registers */
697 ast itmp1,(16+21+0)*8(sp) /* save itmp1 */
698 ast itmp2,(16+21+1)*8(sp) /* save itmp2 */
699 ast ra,(16+21+2)*8(sp) /* save method return address (for leafs) */
700 ast pv,(16+21+3)*8(sp) /* save pv of calling java function */
702 aaddiu a0,sp,(16+21+4)*8 /* create stackframe info */
703 move a1,pv /* pass java pv */
704 aaddiu a2,sp,((5+16+21+4)*8+sizestackframeinfo) /* pass java sp */
705 move a3,ra /* this is correct for leafs */
706 ald a4,((4+16+21+4)*8+sizestackframeinfo)(sp) /* pass xpc */
707 jal stacktrace_create_extern_stackframeinfo
709 aaddiu a0,sp,((0+16+21+4)*8+sizestackframeinfo) /* pass sp */
710 ald itmp3,((0+16+21+4)*8+sizestackframeinfo)(sp) /* get function */
711 ald itmp1,(16+21+3)*8(sp) /* save pv to the position of fp */
712 ast itmp1,((0+16+21+4)*8+sizestackframeinfo)(sp)
714 ast v0,((0+16+21+4)*8+sizestackframeinfo)(sp) /* save return value */
716 aaddiu a0,sp,(16+21+4)*8 /* remove stackframe info */
717 jal stacktrace_remove_stackframeinfo
719 RESTORE_ARGUMENT_REGISTERS(0) /* restore 8 int/8 float argument registers */
720 RESTORE_TEMPORARY_REGISTERS(16) /* restore 5 int/16 float temporary reg. */
722 ald itmp1,(16+21+0)*8(sp) /* restore itmp1 */
723 ald itmp2,(16+21+1)*8(sp) /* restore itmp2 */
724 ald ra,(16+21+2)*8(sp) /* restore method return address (for leafs)*/
725 ald pv,(16+21+3)*8(sp) /* restore pv of calling java function */
727 ald v0,((0+16+21+4)*8+sizestackframeinfo)(sp) /* restore return value */
729 ald itmp3,((4+16+21+4)*8+sizestackframeinfo)(sp) /* get ra to jit code*/
730 aaddiu sp,sp,((5+16+21+4)*8+sizestackframeinfo) /* remove stack frame */
732 beqz v0,L_asm_wrapper_patcher_exception
734 jr itmp3 /* jump to new patched code */
736 L_asm_wrapper_patcher_exception:
737 move xpc,itmp3 /* return address into JIT code is xpc */
739 #if defined(USE_THREADS) && defined(NATIVE_THREADS)
744 jal builtin_asm_get_exceptionptrptr
752 ld xptr,0(v0) /* get the exception pointer */
753 sd zero,0(v0) /* clear the exception pointer */
754 b asm_handle_exception
756 .end asm_wrapper_patcher
759 /******************* function asm_initialize_thread_stack **********************
761 * u1* asm_initialize_thread_stack (void *func, u1 *stack); *
763 * initialize a thread stack *
765 *******************************************************************************/
767 .ent asm_initialize_thread_stack
769 asm_initialize_thread_stack:
770 aaddiu a1,a1,-14*8 /* allocate save area */
771 sd zero, 0*8(a1) /* s0 initalize thread area */
772 sd zero, 1*8(a1) /* s1 */
773 sd zero, 2*8(a1) /* s2 */
774 sd zero, 3*8(a1) /* s3 */
775 sd zero, 4*8(a1) /* s4 */
776 sd zero, 5*8(a1) /* s5 */
777 sd zero, 6*8(a1) /* s6 */
778 sd zero, 7*8(a1) /* s7 */
779 sd zero, 8*8(a1) /* s8 */
780 sd zero, 9*8(a1) /* fs0 */
781 sd zero,10*8(a1) /* fs1 */
782 sd zero,11*8(a1) /* fs2 */
783 sd zero,12*8(a1) /* fs3 */
788 .end asm_initialize_thread_stack
791 /******************* function asm_perform_threadswitch *************************
793 * void asm_perform_threadswitch (u1 **from, u1 **to, u1 **stackTop); *
795 * performs a threadswitch *
797 *******************************************************************************/
799 .ent asm_perform_threadswitch
801 asm_perform_threadswitch:
802 aaddiu sp,sp,-14*8 /* allocate new stack */
803 sd s0, 0*8(sp) /* save saved registers of old thread */
817 ast sp,0(a0) /* save old stack pointer */
818 ast sp,0(a2) /* stackTop = old stack pointer */
819 ald sp,0(a1) /* load new stack pointer */
820 ld s0, 0*8(sp) /* load saved registers of new thread */
834 aaddiu sp,sp,14*8 /* deallocate new stack */
838 .end asm_perform_threadswitch
841 /********************* function asm_switchstackandcall *************************
843 * void asm_switchstackandcall (void *stack, void *func, void **stacktopsave); *
845 * Switches to a new stack, calls a function and switches back. *
846 * a0 new stack pointer *
847 * a1 function pointer *
848 * a2 pointer to variable where stack top should be stored *
850 *******************************************************************************/
852 .ent asm_switchstackandcall
854 asm_switchstackandcall:
855 aaddiu a0,a0,-16 /* allocate new stack */
856 sd ra,0(a0) /* save return address on new stack */
857 sd sp,8(a0) /* save old stack pointer on new stack */
858 sd sp,0(a2) /* save old stack pointer to variable */
859 move sp,a0 /* switch to new stack */
863 jalr itmp3 /* and call function */
865 ld ra,0(sp) /* load return address */
866 ld sp,8(sp) /* switch to old stack */
870 .end asm_switchstackandcall
873 .ent asm_getclassvalues_atomic
875 asm_getclassvalues_atomic:
882 sw t0,offcast_super_baseval(a2)
883 sw t1,offcast_super_diffval(a2)
884 sw t2,offcast_sub_baseval(a2)
887 .end asm_getclassvalues_atomic
891 asm_criticalsections:
892 #if defined(USE_THREADS) && defined(NATIVE_THREADS)
895 .dword _crit_restart1
898 .dword _crit_restart2
905 .ent compare_and_swap
918 .end compare_and_swap
922 * These are local overrides for various environment variables in Emacs.
923 * Please do not remove this and leave it at the end of the file, where
924 * Emacs will automagically detect them.
925 * ---------------------------------------------------------------------
928 * indent-tabs-mode: t