1 /* src/vm/options.c - contains global options
3 Copyright (C) 1996-2005, 2006, 2007, 2008
4 CACAOVM - Verein zur Foerderung der freien virtuellen Maschine CACAO
6 This file is part of CACAO.
8 This program is free software; you can redistribute it and/or
9 modify it under the terms of the GNU General Public License as
10 published by the Free Software Foundation; either version 2, or (at
11 your option) any later version.
13 This program is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
33 #include "mm/memory.hpp"
35 #include "vm/options.h"
40 /* command line option ********************************************************/
42 s4 opt_index = 0; /* index of processed arguments */
43 char *opt_arg; /* this one exports the option argument */
45 bool opt_foo = false; /* option for development */
49 #if defined(ENABLE_JIT)
50 bool opt_jit = true; /* JIT mode execution (default) */
51 bool opt_intrp = false; /* interpreter mode execution */
53 bool opt_jit = false; /* JIT mode execution */
54 bool opt_intrp = true; /* interpreter mode execution (default) */
59 s4 opt_heapmaxsize = 0; /* maximum heap size */
60 s4 opt_heapstartsize = 0; /* initial heap size */
61 s4 opt_stacksize = 0; /* thread stack size */
63 bool opt_verbose = false;
64 bool opt_debugcolor = false; /* use ANSI terminal sequences */
66 bool loadverbose = false;
67 bool initverbose = false;
69 bool opt_verboseclass = false;
70 bool opt_verbosegc = false;
71 bool opt_verbosejni = false;
72 bool opt_verbosecall = false; /* trace all method invocation */
74 bool showmethods = false;
75 bool showconstantpool = false;
78 bool compileverbose = false; /* trace compiler actions */
79 bool showstack = false;
81 bool opt_showdisassemble = false; /* generate disassembler listing */
82 bool opt_showddatasegment = false; /* generate data segment listing */
83 bool opt_showintermediate = false; /* generate intermediate code listing */
85 bool checkbounds = true; /* check array bounds */
86 bool checksync = true; /* do synchronization */
87 #if defined(ENABLE_LOOP)
88 bool opt_loops = false; /* optimize array accesses in loops */
91 bool makeinitializations = true;
93 #if defined(ENABLE_STATISTICS)
94 bool opt_stat = false;
95 bool opt_getloadingtime = false; /* to measure the runtime */
96 bool opt_getcompilingtime = false; /* compute compile time */
98 #if defined(ENABLE_VERIFIER)
99 bool opt_verify = true; /* true if classfiles should be verified */
102 #if defined(ENABLE_PROFILING)
103 bool opt_prof = false;
104 bool opt_prof_bb = false;
107 #if defined(ENABLE_OPAGENT)
108 bool opt_opagent = false;
111 /* optimization options *******************************************************/
113 #if defined(ENABLE_IFCONV)
114 bool opt_ifconv = false;
117 #if defined(ENABLE_LSRA) || defined(ENABLE_SSA)
118 bool opt_lsra = false;
120 #if defined(ENABLE_SSA)
121 bool opt_ssa_dce = false; /* enable dead code elemination */
122 bool opt_ssa_cp = false; /* enable copy propagation */
126 /* interpreter options ********************************************************/
128 #if defined(ENABLE_INTRP)
129 bool opt_no_dynamic = false; /* suppress dynamic superinstructions */
130 bool opt_no_replication = false; /* don't use replication in intrp */
131 bool opt_no_quicksuper = false; /* instructions for quickening cannot be
132 part of dynamic superinstructions */
134 s4 opt_static_supers = 0x7fffffff;
135 bool vm_debug = false; /* XXX this should be called `opt_trace' */
138 #if defined(ENABLE_DEBUG_FILTER)
139 const char *opt_filter_verbosecall_include = 0;
140 const char *opt_filter_verbosecall_exclude = 0;
141 const char *opt_filter_show_method = 0;
145 /* -XX options ****************************************************************/
147 /* NOTE: For better readability keep these alpha-sorted. */
149 /* Options which must always be available (production options in
152 int64_t opt_MaxDirectMemorySize = -1;
153 int opt_MaxPermSize = 0;
154 int opt_PermSize = 0;
155 int opt_ThreadStackSize = 0;
157 /* Debugging options which can be turned off. */
159 bool opt_AlwaysEmitLongBranches = false;
160 bool opt_AlwaysMmapFirstPage = false;
161 int opt_CompileAll = 0;
162 char* opt_CompileMethod = NULL;
163 char* opt_CompileSignature = NULL;
164 int opt_DebugExceptions = 0;
165 int opt_DebugFinalizer = 0;
166 int opt_DebugLocalReferences = 0;
167 int opt_DebugLocks = 0;
168 int opt_DebugPackage = 0;
169 int opt_DebugPatcher = 0;
170 int opt_DebugProperties = 0;
171 int opt_DebugStackFrameInfo = 0;
172 int opt_DebugStackTrace = 0;
173 int opt_DebugThreads = 0;
174 #if defined(ENABLE_DISASSEMBLER)
175 int opt_DisassembleStubs = 0;
177 #if defined(ENABLE_OPAGENT)
178 int opt_EnableOpagent = 0;
180 #if defined(ENABLE_GC_CACAO)
181 int opt_GCDebugRootSet = 0;
182 int opt_GCStress = 0;
184 #if defined(ENABLE_INLINING)
186 #if defined(ENABLE_INLINING_DEBUG) || !defined(NDEBUG)
187 int opt_InlineAll = 0;
188 int opt_InlineCount = INT_MAX;
189 int opt_InlineMaxSize = INT_MAX;
190 int opt_InlineMinSize = 0;
193 int opt_PrintConfig = 0;
194 int opt_PrintWarnings = 0;
195 int opt_ProfileGCMemoryUsage = 0;
196 int opt_ProfileMemoryUsage = 0;
197 FILE *opt_ProfileMemoryUsageGNUPlot = NULL;
198 int opt_RegallocSpillAll = 0;
199 #if defined(ENABLE_REPLACEMENT)
200 int opt_TestReplacement = 0;
202 int opt_TraceBuiltinCalls = 0;
203 int opt_TraceCompilerCalls = 0;
204 int opt_TraceExceptions = 0;
205 int opt_TraceHPI = 0;
206 #if defined(ENABLE_INLINING) && !defined(NDEBUG)
207 int opt_TraceInlining = 0;
209 int opt_TraceJavaCalls = 0;
210 int opt_TraceJNICalls = 0;
211 int opt_TraceJVMCalls = 0;
212 int opt_TraceJVMCallsVerbose = 0;
213 int opt_TraceLinkClass = 0;
214 #if defined(ENABLE_REPLACEMENT)
215 int opt_TraceReplacement = 0;
217 int opt_TraceSubsystemInitialization = 0;
218 int opt_TraceTraps = 0;
227 /* Options which must always be available (production options in
230 OPT_MaxDirectMemorySize,
235 /* Debugging options which can be turned off. */
237 OPT_AlwaysEmitLongBranches,
238 OPT_AlwaysMmapFirstPage,
241 OPT_CompileSignature,
244 OPT_DebugLocalReferences,
249 OPT_DebugStackFrameInfo,
252 OPT_DisassembleStubs,
263 OPT_ProfileGCMemoryUsage,
264 OPT_ProfileMemoryUsage,
265 OPT_ProfileMemoryUsageGNUPlot,
266 OPT_RegallocSpillAll,
268 OPT_TraceBuiltinCalls,
269 OPT_TraceCompilerCalls,
276 OPT_TraceJVMCallsVerbose,
278 OPT_TraceReplacement,
279 OPT_TraceSubsystemInitialization,
287 option_t options_XX[] = {
288 /* Options which must always be available (production options in
291 { "MaxDirectMemorySize", OPT_MaxDirectMemorySize, OPT_TYPE_VALUE, "Maximum total size of NIO direct-buffer allocations" },
292 { "MaxPermSize", OPT_MaxPermSize, OPT_TYPE_VALUE, "not implemented" },
293 { "PermSize", OPT_PermSize, OPT_TYPE_VALUE, "not implemented" },
294 { "ThreadStackSize", OPT_ThreadStackSize, OPT_TYPE_VALUE, "TODO" },
296 /* Debugging options which can be turned off. */
298 { "AlwaysEmitLongBranches", OPT_AlwaysEmitLongBranches, OPT_TYPE_BOOLEAN, "Always emit long-branches." },
299 { "AlwaysMmapFirstPage", OPT_AlwaysMmapFirstPage, OPT_TYPE_BOOLEAN, "Always mmap memory page at address 0x0." },
300 { "CompileAll", OPT_CompileAll, OPT_TYPE_BOOLEAN, "compile all methods, no execution" },
301 { "CompileMethod", OPT_CompileMethod, OPT_TYPE_VALUE, "compile only a specific method" },
302 { "CompileSignature", OPT_CompileSignature, OPT_TYPE_VALUE, "specify signature for a specific method" },
303 { "DebugExceptions", OPT_DebugExceptions, OPT_TYPE_BOOLEAN, "debug exceptions" },
304 { "DebugFinalizer", OPT_DebugFinalizer, OPT_TYPE_BOOLEAN, "debug finalizer thread" },
305 { "DebugLocalReferences", OPT_DebugLocalReferences, OPT_TYPE_BOOLEAN, "print debug information for local reference tables" },
306 { "DebugLocks", OPT_DebugLocks, OPT_TYPE_BOOLEAN, "print debug information for locks" },
307 { "DebugPackage", OPT_DebugPackage, OPT_TYPE_BOOLEAN, "debug Java boot-packages" },
308 { "DebugPatcher", OPT_DebugPatcher, OPT_TYPE_BOOLEAN, "debug JIT code patching" },
309 { "DebugProperties", OPT_DebugProperties, OPT_TYPE_BOOLEAN, "print debug information for properties" },
310 { "DebugStackFrameInfo", OPT_DebugStackFrameInfo, OPT_TYPE_BOOLEAN, "TODO" },
311 { "DebugStackTrace", OPT_DebugStackTrace, OPT_TYPE_BOOLEAN, "debug stacktrace creation" },
312 { "DebugThreads", OPT_DebugThreads, OPT_TYPE_BOOLEAN, "print debug information for threads" },
313 #if defined(ENABLE_DISASSEMBLER)
314 { "DisassembleStubs", OPT_DisassembleStubs, OPT_TYPE_BOOLEAN, "disassemble builtin and native stubs when generated" },
316 #if defined(ENABLE_OPAGENT)
317 { "EnableOpagent", OPT_EnableOpagent, OPT_TYPE_BOOLEAN, "enable providing JIT output to Oprofile" },
319 #if defined(ENABLE_GC_CACAO)
320 { "GCDebugRootSet", OPT_GCDebugRootSet, OPT_TYPE_BOOLEAN, "GC: print root-set at collection" },
321 { "GCStress", OPT_GCStress, OPT_TYPE_BOOLEAN, "GC: forced collection at every allocation" },
323 #if defined(ENABLE_INLINING)
324 { "Inline", OPT_Inline, OPT_TYPE_BOOLEAN, "enable method inlining" },
325 #if defined(ENABLE_INLINING_DEBUG) || !defined(NDEBUG)
326 { "InlineAll", OPT_InlineAll, OPT_TYPE_BOOLEAN, "use inlining in all compilations" },
327 { "InlineCount", OPT_InlineCount, OPT_TYPE_VALUE, "stop inlining after the given number of roots" },
328 { "InlineMaxSize", OPT_InlineMaxSize, OPT_TYPE_VALUE, "maximum size for inlined result" },
329 { "InlineMinSize", OPT_InlineMinSize, OPT_TYPE_VALUE, "minimum size for inlined result" },
332 { "PrintConfig", OPT_PrintConfig, OPT_TYPE_BOOLEAN, "print VM configuration" },
333 { "PrintWarnings", OPT_PrintWarnings, OPT_TYPE_BOOLEAN, "print warnings about suspicious behavior"},
334 { "ProfileGCMemoryUsage", OPT_ProfileGCMemoryUsage, OPT_TYPE_VALUE, "profiles GC memory usage in the given interval, <value> is in seconds (default: 5)" },
335 { "ProfileMemoryUsage", OPT_ProfileMemoryUsage, OPT_TYPE_VALUE, "TODO" },
336 { "ProfileMemoryUsageGNUPlot", OPT_ProfileMemoryUsageGNUPlot, OPT_TYPE_VALUE, "TODO" },
337 { "RegallocSpillAll", OPT_RegallocSpillAll, OPT_TYPE_BOOLEAN, "spill all variables to the stack" },
338 #if defined(ENABLE_REPLACEMENT)
339 { "TestReplacement", OPT_TestReplacement, OPT_TYPE_BOOLEAN, "activate all replacement points during code generation" },
341 { "TraceBuiltinCalls", OPT_TraceBuiltinCalls, OPT_TYPE_BOOLEAN, "trace calls to VM builtin functions" },
342 { "TraceCompilerCalls", OPT_TraceCompilerCalls, OPT_TYPE_BOOLEAN, "trace JIT compiler calls" },
343 { "TraceExceptions", OPT_TraceExceptions, OPT_TYPE_BOOLEAN, "trace Exception throwing" },
344 { "TraceHPI", OPT_TraceHPI, OPT_TYPE_BOOLEAN, "Trace Host Porting Interface (HPI)" },
345 #if defined(ENABLE_INLINING) && !defined(NDEBUG)
346 { "TraceInlining", OPT_TraceInlining, OPT_TYPE_VALUE, "trace method inlining with the given verbosity level (default: 1)" },
348 #if !defined(ENABLE_VMLOG)
349 { "TraceJavaCalls", OPT_TraceJavaCalls, OPT_TYPE_BOOLEAN, "trace Java method calls" },
351 { "TraceJNICalls", OPT_TraceJNICalls, OPT_TYPE_BOOLEAN, "trace JNI method calls" },
352 { "TraceJVMCalls", OPT_TraceJVMCalls, OPT_TYPE_BOOLEAN, "trace JVM method calls but omit very frequent ones" },
353 { "TraceJVMCallsVerbose", OPT_TraceJVMCallsVerbose, OPT_TYPE_BOOLEAN, "trace all JVM method calls" },
354 { "TraceLinkClass", OPT_TraceLinkClass, OPT_TYPE_BOOLEAN, "trace class linking" },
355 #if defined(ENABLE_REPLACEMENT)
356 { "TraceReplacement", OPT_TraceReplacement, OPT_TYPE_VALUE, "trace on-stack replacement with the given verbosity level (default: 1)" },
358 { "TraceSubsystemInitialization", OPT_TraceSubsystemInitialization, OPT_TYPE_BOOLEAN, "trace initialization of subsystems" },
359 { "TraceTraps", OPT_TraceTraps, OPT_TYPE_BOOLEAN, "trace traps generated by JIT code" },
360 #if defined(ENABLE_VMLOG)
361 { "Vmlog", OPT_Vmlog, OPT_TYPE_VALUE, "prefix for vmlog trace files (enables vmlog)" },
362 { "VmlogStrings", OPT_VmlogStrings, OPT_TYPE_VALUE, "prefix of vmlog string file to load" },
363 { "VmlogIgnore", OPT_VmlogIgnore, OPT_TYPE_VALUE, "prefix of vmlog ignore file to load" },
368 { NULL, -1, -1, NULL }
372 /* options_get *****************************************************************
376 *******************************************************************************/
378 int options_get(opt_struct *opts, JavaVMInitArgs *vm_args)
383 if (opt_index >= vm_args->nOptions)
386 /* get the current option */
388 option = vm_args->options[opt_index].optionString;
390 if ((option == NULL) || (option[0] != '-'))
393 for (i = 0; opts[i].name; i++) {
395 /* boolean option found */
397 if (strcmp(option + 1, opts[i].name) == 0) {
399 return opts[i].value;
403 /* parameter option found */
405 /* with a space between */
407 if (strcmp(option + 1, opts[i].name) == 0) {
410 if (opt_index < vm_args->nOptions) {
411 opt_arg = os_strdup(vm_args->options[opt_index].optionString);
413 return opts[i].value;
419 /* parameter and option have no space between */
421 /* FIXME: this assumption is plain wrong, hits you if there is a
422 * parameter with no argument starting with same letter as param with argument
423 * but named after that one, ouch! */
425 size_t l = os_strlen(opts[i].name);
427 if (os_strlen(option + 1) > l) {
428 if (memcmp(option + 1, opts[i].name, l) == 0) {
430 opt_arg = os_strdup(option + 1 + l);
431 return opts[i].value;
442 /* options_xxusage *************************************************************
444 Print usage message for debugging options.
446 *******************************************************************************/
448 static void options_xxusage(void)
455 /* Prevent compiler warning. */
459 for (opt = options_XX; opt->name != NULL; opt++) {
463 case OPT_TYPE_BOOLEAN:
464 printf("+%s", opt->name);
465 length = os_strlen(" -XX:+") + os_strlen(opt->name);
469 printf("%s=<value>", opt->name);
470 length = os_strlen(" -XX:") + os_strlen(opt->name) +
471 os_strlen("=<value>");
475 vm_abort("options_xxusage: unkown option type %d", opt->type);
478 /* Check if the help fits into one 80-column line.
479 Documentation starts at column 29. */
481 if (length < (29 - 1)) {
482 /* Print missing spaces up to column 29. */
484 for (i = length; i < 29; i++)
489 printf(" "); /* 29 spaces */
492 /* Check documentation length. */
494 length = os_strlen(opt->doc);
496 if (length < (80 - 29)) {
497 printf("%s", opt->doc);
500 for (c = opt->doc, i = 29; *c != 0; c++, i++) {
501 /* If we are at the end of the line, break it. */
505 printf(" "); /* 29 spaces */
516 /* exit with error code */
522 /* options_xx ******************************************************************
526 *******************************************************************************/
528 void options_xx(JavaVMInitArgs *vm_args)
541 /* Iterate over all passed options. */
543 for (i = 0; i < vm_args->nOptions; i++) {
544 /* Get the current option. */
546 name = vm_args->options[i].optionString;
548 /* Check for help (-XX). */
550 if (strcmp(name, "-XX") == 0)
553 /* Check if the option start with -XX. */
555 start = strstr(name, "-XX:");
557 if ((start == NULL) || (start != name))
560 /* Check if the option is a boolean option. */
562 if (name[4] == '+') {
563 start = name + 4 + 1;
566 else if (name[4] == '-') {
567 start = name + 4 + 1;
575 /* Search for a '=' in the option name and get the option name
576 length and the value of the option. */
578 end = strchr(start, '=');
581 length = os_strlen(start);
585 length = end - start;
589 /* Search the option in the option array. */
591 for (opt = options_XX; opt->name != NULL; opt++) {
592 if (strncmp(opt->name, start, length) == 0) {
593 /* Check if the options passed fits to the type. */
596 case OPT_TYPE_BOOLEAN:
597 if ((enable == -1) || (value != NULL))
601 if ((enable != -1) || (value == NULL))
605 vm_abort("options_xx: unknown option type %d for option %s",
606 opt->type, opt->name);
613 /* Process the option. */
615 switch (opt->value) {
617 /* Options which must always be available (production options
620 case OPT_MaxDirectMemorySize:
621 opt_MaxDirectMemorySize = os_atoi(value);
624 case OPT_MaxPermSize:
625 /* Currently ignored. */
629 /* Currently ignored. */
632 case OPT_ThreadStackSize:
633 /* currently ignored */
636 /* Debugging options which can be turned off. */
638 case OPT_AlwaysEmitLongBranches:
639 opt_AlwaysEmitLongBranches = enable;
642 case OPT_AlwaysMmapFirstPage:
643 opt_AlwaysMmapFirstPage = enable;
647 opt_CompileAll = enable;
649 makeinitializations = false;
652 case OPT_CompileMethod:
653 opt_CompileMethod = value;
655 makeinitializations = false;
658 case OPT_CompileSignature:
659 opt_CompileSignature = value;
662 case OPT_DebugExceptions:
663 opt_DebugExceptions = enable;
666 case OPT_DebugFinalizer:
667 opt_DebugFinalizer = enable;
670 case OPT_DebugLocalReferences:
671 opt_DebugLocalReferences = enable;
675 opt_DebugLocks = enable;
678 case OPT_DebugPackage:
679 opt_DebugPackage = enable;
682 case OPT_DebugPatcher:
683 opt_DebugPatcher = enable;
686 case OPT_DebugProperties:
687 opt_DebugProperties = enable;
690 case OPT_DebugStackFrameInfo:
691 opt_DebugStackFrameInfo = enable;
694 case OPT_DebugStackTrace:
695 opt_DebugStackTrace = enable;
698 case OPT_DebugThreads:
699 opt_DebugThreads = enable;
702 #if defined(ENABLE_DISASSEMBLER)
703 case OPT_DisassembleStubs:
704 opt_DisassembleStubs = enable;
708 #if defined(ENABLE_OPAGENT)
709 case OPT_EnableOpagent:
710 opt_EnableOpagent = enable;
714 #if defined(ENABLE_GC_CACAO)
715 case OPT_GCDebugRootSet:
716 opt_GCDebugRootSet = enable;
720 opt_GCStress = enable;
724 #if defined(ENABLE_INLINING)
728 #if defined(ENABLE_INLINING_DEBUG) || !defined(NDEBUG)
730 opt_InlineAll = enable;
733 case OPT_InlineCount:
735 opt_InlineCount = os_atoi(value);
738 case OPT_InlineMaxSize:
740 opt_InlineMaxSize = os_atoi(value);
743 case OPT_InlineMinSize:
745 opt_InlineMinSize = os_atoi(value);
750 case OPT_PrintConfig:
751 opt_PrintConfig = enable;
754 case OPT_PrintWarnings:
755 opt_PrintWarnings = enable;
758 case OPT_ProfileGCMemoryUsage:
760 opt_ProfileGCMemoryUsage = 5;
762 opt_ProfileGCMemoryUsage = os_atoi(value);
765 case OPT_ProfileMemoryUsage:
767 opt_ProfileMemoryUsage = 5;
769 opt_ProfileMemoryUsage = os_atoi(value);
771 # if defined(ENABLE_STATISTICS)
772 /* we also need statistics */
778 case OPT_ProfileMemoryUsageGNUPlot:
780 filename = "profile.dat";
784 file = fopen(filename, "w");
787 #warning Use below method instead!
788 //os::abort_errno("options_xx: fopen failed");
789 vm_abort("options_xx: fopen failed");
791 opt_ProfileMemoryUsageGNUPlot = file;
794 case OPT_RegallocSpillAll:
795 opt_RegallocSpillAll = enable;
798 #if defined(ENABLE_REPLACEMENT)
799 case OPT_TestReplacement:
800 opt_TestReplacement = enable;
804 case OPT_TraceBuiltinCalls:
805 opt_TraceBuiltinCalls = enable;
808 case OPT_TraceCompilerCalls:
809 opt_TraceCompilerCalls = enable;
812 case OPT_TraceExceptions:
813 opt_TraceExceptions = enable;
817 opt_TraceHPI = enable;
820 #if defined(ENABLE_INLINING) && !defined(NDEBUG)
821 case OPT_TraceInlining:
823 opt_TraceInlining = 1;
825 opt_TraceInlining = os_atoi(value);
829 case OPT_TraceJavaCalls:
830 opt_verbosecall = enable;
831 opt_TraceJavaCalls = enable;
834 case OPT_TraceJNICalls:
835 opt_TraceJNICalls = enable;
838 case OPT_TraceJVMCalls:
839 opt_TraceJVMCalls = enable;
842 case OPT_TraceJVMCallsVerbose:
843 opt_TraceJVMCallsVerbose = enable;
846 case OPT_TraceLinkClass:
847 opt_TraceLinkClass = enable;
850 #if defined(ENABLE_REPLACEMENT)
851 case OPT_TraceReplacement:
853 opt_TraceReplacement = 1;
855 opt_TraceReplacement = os_atoi(value);
859 case OPT_TraceSubsystemInitialization:
860 opt_TraceSubsystemInitialization = enable;
864 opt_TraceTraps = enable;
867 #if defined(ENABLE_VMLOG)
870 vmlog_cacao_set_prefix("vmlog");
872 vmlog_cacao_set_prefix(value);
874 opt_TraceJavaCalls = 1;
877 case OPT_VmlogStrings:
879 vmlog_cacao_set_stringprefix(value);
882 case OPT_VmlogIgnore:
884 vmlog_cacao_set_ignoreprefix(value);
889 fprintf(stderr, "Unknown -XX option: %s\n", name);
897 * These are local overrides for various environment variables in Emacs.
898 * Please do not remove this and leave it at the end of the file, where
899 * Emacs will automagically detect them.
900 * ---------------------------------------------------------------------
903 * indent-tabs-mode: t