2 <title>Flag reference</title>
5 <title>Help and verbosity options (<xref linkend="options-help">)</title>
8 <tgroup cols=3 align=left colsep=1 rowsep=1>
12 <entry>Description</entry>
13 <entry>Static/Dynamic</entry>
14 <entry>Reverse</entry>
19 <entry><option>-?</option></entry>
25 <entry><option>-help</option></entry>
31 <entry><option>-v</option></entry>
32 <entry>verbose mode (equivalent to <option>-v3</option>)</entry>
33 <entry>dynamic</entry>
37 <entry><option>-v</option><replaceable>n</replaceable></entry>
38 <entry>set verbosity level</entry>
39 <entry>dynamic</entry>
43 <entry><option>--version</option></entry>
44 <entry>display GHC version</entry>
49 <entry><option>--numeric-version</option></entry>
50 <entry>display GHC version (numeric only)</entry>
60 <title>Which phases to run (<xref linkend="options-order">)</title>
63 <tgroup cols=3 align=left colsep=1 rowsep=1>
67 <entry>Description</entry>
68 <entry>Static/Dynamic</entry>
69 <entry>Reverse</entry>
74 <entry><option>-cpp</option></entry>
75 <entry>Run the C pre-processor on the Haskell source</entry>
76 <entry>dynamic</entry>
80 <entry><option>-E</option></entry>
81 <entry>Stop after preprocessing (<literal>.hspp</literal> file)</entry>
86 <entry><option>-C</option></entry>
87 <entry>Stop after generating C (<literal>.hc</literal> file)</entry>
92 <entry><option>-S</option></entry>
93 <entry>Stop after generating assembly (<literal>.s</literal> file)</entry>
98 <entry><option>-c</option></entry>
99 <entry>Stop after compiling to object code (<literal>.o</literal> file)</entry>
100 <entry>static</entry>
104 <entry><option>-fasm</option></entry>
105 <entry>Use the native code generator</entry>
106 <entry>dynamic</entry>
107 <entry>-fvia-C</entry>
110 <entry><option>-fvia-C</option></entry>
111 <entry>Compile via C</entry>
112 <entry>dynamic</entry>
121 <title>Redirecting output (<xref linkend="options-output">)</title>
124 <tgroup cols=3 align=left colsep=1 rowsep=1>
128 <entry>Description</entry>
129 <entry>Static/Dynamic</entry>
130 <entry>Reverse</entry>
135 <entry><option>-hisuf</option> <replaceable>suffix</replaceable></entry>
136 <entry>set the suffix to use for interface files</entry>
137 <entry>static</entry>
141 <entry><option>-o</option> <replaceable>filename</replaceable></entry>
142 <entry>set output filename</entry>
143 <entry>static</entry>
147 <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
148 <entry>set output directory</entry>
149 <entry>static</entry>
153 <entry><option>-ohi</option> <replaceable>filename</replaceable></entry>
154 <entry>set the filename in which to put the interface</entry>
155 <entry>static</entry>
159 <entry><option>-osuf</option> <replaceable>suffix</replaceable></entry>
160 <entry>set the output file suffix</entry>
161 <entry>static</entry>
170 <title>Keeping intermediate files (<xref linkend="keeping-intermediates">)</title>
173 <tgroup cols=3 align=left colsep=1 rowsep=1>
177 <entry>Description</entry>
178 <entry>Static/Dynamic</entry>
179 <entry>Reverse</entry>
184 <entry><option>-keep-hc-file</option></entry>
185 <entry>retain intermediate <literal>.hc</literal> files</entry>
186 <entry>static</entry>
190 <entry><option>-keep-s-file</option></entry>
191 <entry>retain intermediate <literal>.s</literal> files</entry>
192 <entry>static</entry>
196 <entry><option>-keep-raw-s-file</option></entry>
197 <entry>retain intermediate <literal>.raw_s</literal> files</entry>
198 <entry>static</entry>
202 <entry><option>-keep-tmp-files</option></entry>
203 <entry>retain all intermediate temporary files</entry>
204 <entry>static</entry>
213 <title>Temporary files (<xref linkend="temp-files">)</title>
216 <tgroup cols=3 align=left colsep=1 rowsep=1>
220 <entry>Description</entry>
221 <entry>Static/Dynamic</entry>
222 <entry>Reverse</entry>
227 <entry><option>-tmpdir</option></entry>
228 <entry>set the directory for temporary files</entry>
229 <entry>static</entry>
238 <title>Finding imports (<xref linkend="options-finding-imports">)</title>
241 <tgroup cols=3 align=left colsep=1 rowsep=1>
246 <entry>Description</entry>
247 <entry>Static/Dynamic</entry>
248 <entry>Reverse</entry>
253 <entry><option>-i</option><replaceable>dir1</replaceable>:<replaceable>dir2</replaceable>:...</entry>
254 <entry>add <replaceable>dir</replaceable>,
255 <replaceable>dir2</replaceable>, etc. to import path</entry>
256 <entry>static</entry>
260 <entry><option>-i</option></entry>
261 <entry>Empty the import directory list</entry>
262 <entry>static</entry>
271 <title>Interface file options (<xref linkend="hi-options">)</title>
274 <tgroup cols=3 align=left colsep=1 rowsep=1>
279 <entry>Description</entry>
280 <entry>Static/Dynamic</entry>
281 <entry>Reverse</entry>
286 <entry><option>-ohi</option> <replaceable>file</replaceable></entry>
287 <entry>Put the interface file in <replaceable>file</replaceable></entry>
288 <entry>static</entry>
292 <entry><option>-ddump-hi</option></entry>
293 <entry>Dump the new interface to stdout</entry>
294 <entry>dynamic</entry>
298 <entry><option>-ddump-hi-diffs</option></entry>
299 <entry>Show the differences vs. the old interface</entry>
300 <entry>dynamic</entry>
309 <title>Recompilation checking (<xref linkend="recomp">)</title>
312 <tgroup cols=3 align=left colsep=1 rowsep=1>
317 <entry>Description</entry>
318 <entry>Static/Dynamic</entry>
319 <entry>Reverse</entry>
324 <entry><option>-no-recomp</option></entry>
325 <entry>Turn off recompilation checking</entry>
326 <entry>static</entry>
327 <entry>-recomp</entry>
335 <title>Packages (<xref linkend="packages">)</title>
337 <tgroup cols=3 align=left colsep=1 rowsep=1>
341 <entry>Description</entry>
342 <entry>Static/Dynamic</entry>
343 <entry>Reverse</entry>
348 <entry><option>--add-package</option></entry>
349 <entry>Install a new package</entry>
350 <entry>static</entry>
354 <entry><option>--delete-package</option> <replaceable>name</replaceable></entry>
355 <entry>Delete package entry <replaceable>name</replaceable></entry>
356 <entry>static</entry>
360 <entry><option>--list-packages</option></entry>
361 <entry>List installed packages</entry>
362 <entry>static</entry>
366 <entry><option>-package</option> <replaceable>name</replaceable></entry>
367 <entry>Use package <replaceable>name</replaceable></entry>
368 <entry>static</entry>
372 <entry><option>-package-name</option> <replaceable>name</replaceable></entry>
373 <entry>Compile code for package <replaceable>name</replaceable></entry>
374 <entry>static</entry>
383 <title>Language options (<xref linkend="options-language">)</title>
386 <tgroup cols=3 align=left colsep=1 rowsep=1>
390 <entry>Description</entry>
391 <entry>Static/Dynamic</entry>
392 <entry>Reverse</entry>
397 <entry><option>-fallow-overlapping-instances</option></entry>
399 <entry>dynamic</entry>
400 <entry><option>-fno-allow-overlapping-instances</option></entry>
403 <entry><option>-fallow-undecidable-instances</option></entry>
404 <entry>Enable undecidable instances</entry>
405 <entry>dynamic</entry>
406 <entry><option>-fno-allow-undecidable-instances</option></entry>
409 <entry><option>-fgenerics</option></entry>
410 <entry>Enable generics</entry>
411 <entry>dynamic</entry>
412 <entry><option>-fno-fgenerics</option></entry>
415 <entry><option>-fglasgow-exts</option></entry>
416 <entry>Enable most language extensions</entry>
417 <entry>dynamic</entry>
418 <entry><option>-fno-glasgow-exts</option></entry>
421 <entry><option>-fignore-asserts</option></entry>
422 <entry>Ignore assertions</entry>
423 <entry>dynamic</entry>
424 <entry><option>-fno-ignore-asserts</option></entry>
427 <entry><option>-fno-implicit-prelude</option></entry>
428 <entry>Don't implicitly <literal>import Prelude</literal></entry>
429 <entry>dynamic</entry>
433 <entry><option>-fno-monomorphism-restriction</option></entry>
434 <entry>Disable the monomorphism restriction</entry>
435 <entry>dynamic</entry>
436 <entry><option>-</option></entry>
439 <entry><option>-firrefutable-tuples</option></entry>
440 <entry>Make tuple pattern matching irrefutable</entry>
441 <entry>dynamic</entry>
442 <entry><option>-fno-irrefutable-tuples</option></entry>
445 <entry><option>-fcontext-stack</option><replaceable>n</replaceable></entry>
446 <entry>set the limit for context reduction</entry>
447 <entry>dynamic</entry>
448 <entry><option>-</option></entry>
456 <title>Warnings (<xref linkend="options-sanity">)</title>
459 <tgroup cols=3 align=left colsep=1 rowsep=1>
463 <entry>Description</entry>
464 <entry>Static/Dynamic</entry>
465 <entry>Reverse</entry>
470 <entry><option>-W</option></entry>
471 <entry>enable normal warnings</entry>
472 <entry>static</entry>
473 <entry><option>-w</option></entry>
476 <entry><option>-w</option></entry>
477 <entry>disable all warnings</entry>
478 <entry>static</entry>
482 <entry><option>-Wall</option></entry>
483 <entry>enable all warnings</entry>
484 <entry>static</entry>
485 <entry><option>-w</option></entry>
489 <entry><option>-fwarn-deprecations</option></entry>
490 <entry>warn about uses of functions & types that are deprecated</entry>
491 <entry>dynamic</entry>
492 <entry><option>-fno-warn-deprecations</option></entry>
496 <entry><option>-fwarn-duplicate-exports</option></entry>
497 <entry>warn when an entity is exported multiple times</entry>
498 <entry>dynamic</entry>
499 <entry><option>-fno-warn-duplicate-exports</option></entry>
503 <entry><option>-fwarn-hi-shadowing</option></entry>
504 <entry>warn when a <literal>.hi</literal> file in the
505 current directory shadows a library</entry>
506 <entry>dynamic</entry>
507 <entry><option>-fno-warn-hi-shadowing</option></entry>
511 <entry><option>-fwarn-incomplete-patterns</option></entry>
512 <entry>warn when a pattern match could fail</entry>
513 <entry>dynamic</entry>
514 <entry><option>-fno-warn-incomplete-patterns</option></entry>
518 <entry><option>-fwarn-missing-fields</option></entry>
519 <entry>warn when fields of a record are uninitialised</entry>
520 <entry>dynamic</entry>
521 <entry><option>-fno-warn-missing-fields</option></entry>
525 <entry><option>-fwarn-missing-methods</option></entry>
526 <entry>warn when class methods are undefined</entry>
527 <entry>dynamic</entry>
528 <entry><option>-fno-warn-missing-methods</option></entry>
532 <entry><option>-fwarn-missing-signatures</option></entry>
533 <entry>warn about top-level functions without signatures</entry>
534 <entry>dynamic</entry>
535 <entry><option>-fno-warn-missing-signatures</option></entry>
539 <entry><option>-fwarn-name-shadowing</option></entry>
540 <entry>warn when names are shadowed</entry>
541 <entry>dynamic</entry>
542 <entry><option>-fno-warn-name-shadowing</option></entry>
546 <entry><option>-fwarn-overlapping-patterns</option></entry>
547 <entry>warn about overlapping patterns</entry>
548 <entry>dynamic</entry>
549 <entry><option>-fno-warn-overlapping-patterns</option></entry>
553 <entry><option>-fwarn-simple-patterns</option></entry>
554 <entry>warn about lambda-patterns that can fail</entry>
555 <entry>dynamic</entry>
556 <entry><option>-fno-warn-simple-patterns</option></entry>
560 <entry><option>-fwarn-type-defaults</option></entry>
561 <entry>warn when defaulting happens</entry>
562 <entry>dynamic</entry>
563 <entry><option>-fno-warn-type-defaults</option></entry>
567 <entry><option>-fwarn-unused-binds</option></entry>
568 <entry>warn about bindings that are unused</entry>
569 <entry>dynamic</entry>
570 <entry><option>-fno-warn-unused-binds</option></entry>
574 <entry><option>-fwarn-unused-imports</option></entry>
575 <entry>warn about unnecessary imports</entry>
576 <entry>dynamic</entry>
577 <entry><option>-fno-warn-unused-imports</option></entry>
581 <entry><option>-fwarn-unused-matches</option></entry>
582 <entry>warn about variables in patterns that aren't used</entry>
583 <entry>dynamic</entry>
584 <entry><option>-fno-warn-unused-matches</option></entry>
593 <title>Optimisation levels (<xref linkend="options-optimise">)</title>
596 <tgroup cols=3 align=left colsep=1 rowsep=1>
600 <entry>Description</entry>
601 <entry>Static/Dynamic</entry>
602 <entry>Reverse</entry>
607 <entry><option>-O</option></entry>
608 <entry>Enable default optimisation (level 1)</entry>
609 <entry>static</entry>
610 <entry><option>-O0</option></entry>
613 <entry><option>-O</option><replaceable>n</replaceable></entry>
614 <entry>Set optimisation level <replaceable>n</replaceable></entry>
615 <entry>static</entry>
616 <entry><option>-O0</option></entry>
619 <entry><option>-O2-for-C</option></entry>
620 <entry>Run <command>gcc</command> with <option>-O2</option></entry>
621 <entry>static</entry>
630 <title>Individual optimisations (<xref linkend="options-f">)</title>
633 <tgroup cols=3 align=left colsep=1 rowsep=1>
637 <entry>Description</entry>
638 <entry>Static/Dynamic</entry>
639 <entry>Reverse</entry>
644 <entry><option>-fall-strict</option></entry>
645 <entry>Make everything strict</entry>
646 <entry>dynamic</entry>
647 <entry><option>-fno-all-strict</option></entry>
651 <entry><option>-fcase-merge</option></entry>
652 <entry>Enable case-merging</entry>
653 <entry>static</entry>
654 <entry><option>-fno-case-merge</option></entry>
658 <entry><option>-fdicts-strict</option></entry>
659 <entry>Make dictionaries strict</entry>
660 <entry>dynamic</entry>
661 <entry><option>-fno-dicts-strict</option></entry>
665 <entry><option>-fdo-eta-reduction</option></entry>
666 <entry>Enable eta-reduction</entry>
667 <entry>static</entry>
668 <entry><option>-fno-do-eta-reduction</option></entry>
672 <entry><option>-fdo-lambda-eta-expansion</option></entry>
673 <entry>Enable lambda eta-reduction</entry>
674 <entry>static</entry>
675 <entry><option>-fno-do-lambda-eta-expansion</option></entry>
679 <entry><option>-fexcess-precision</option></entry>
680 <entry>Enable excess intermediate precision</entry>
681 <entry>static</entry>
682 <entry><option>-fno-excess-precision</option></entry>
686 <entry><option>-ffoldr-build-on</option></entry>
687 <entry>Enable foldr-build optimisation</entry>
688 <entry>static</entry>
689 <entry><option>-fno-foldr-build-on</option></entry>
693 <entry><option>-fignore-asserts</option></entry>
694 <entry>Ignore assertions in the source</entry>
695 <entry>static</entry>
696 <entry><option>-fno-ignore-asserts</option></entry>
700 <entry><option>-fignore-interface-pragmas</option></entry>
701 <entry>Ignore pragmas in interface files</entry>
702 <entry>static</entry>
703 <entry><option>-fno-ignore-interface-pragmas</option></entry>
707 <entry><option>-flet-no-escape</option></entry>
708 <entry>Enable let-no-escape optimisation</entry>
709 <entry>static</entry>
710 <entry><option>-fno-let-no-escape</option></entry>
714 <entry><option>-fliberate-case-threshold</option></entry>
715 <entry>Tweak the liberate-case optimisation</entry>
716 <entry>static</entry>
717 <entry><option>-fno-liberate-case-threshold</option></entry>
721 <entry><option>-fomit-interface-pragmas</option></entry>
722 <entry>Don't generate interface pragmas</entry>
723 <entry>static</entry>
724 <entry><option>-fno-omit-interface-pragmas</option></entry>
728 <entry><option>-fmax-simplifier-iterations</option></entry>
729 <entry>Set the max iterations for the simplifier</entry>
730 <entry>static</entry>
735 <entry><option>-fno-cpr</option></entry>
736 <entry>Turn off CPR analysis</entry>
737 <entry>static</entry>
742 <entry><option>-fno-cse</option></entry>
743 <entry>Turn off common sub-expression</entry>
744 <entry>static</entry>
749 <entry><option>-fno-pre-inlining</option></entry>
750 <entry>Turn off pre-inlining</entry>
751 <entry>static</entry>
756 <entry><option>-fno-strictness</option></entry>
757 <entry>Turn off strictness analysis</entry>
758 <entry>static</entry>
763 <entry><option>-fnumbers-strict</option></entry>
764 <entry>Make numbers strict</entry>
765 <entry>dynamic</entry>
766 <entry><option>-fno-numbers-strict</option></entry>
770 <entry><option>-funbox-strict-fields</option></entry>
771 <entry>Flatten strict constructor fields</entry>
772 <entry>static</entry>
773 <entry><option>-fno-unbox-strict-fields</option></entry>
777 <entry><option>-funfolding-creation-threshold</option></entry>
778 <entry>Tweak unfolding settings</entry>
779 <entry>static</entry>
780 <entry><option>-fno-unfolding-creation-threshold</option></entry>
784 <entry><option>-funfolding-fun-discount</option></entry>
785 <entry>Tweak unfolding settings</entry>
786 <entry>static</entry>
787 <entry><option>-fno-unfolding-fun-discount</option></entry>
791 <entry><option>-funfolding-keeness-factor</option></entry>
792 <entry>Tweak unfolding settings</entry>
793 <entry>static</entry>
794 <entry><option>-fno-unfolding-keeness-factor</option></entry>
798 <entry><option>-funfolding-interface-threshold</option></entry>
799 <entry>Tweak unfolding settings</entry>
800 <entry>static</entry>
801 <entry><option>-fno-unfolding-interface-threshold</option></entry>
805 <entry><option>-funfolding-update-in-place</option></entry>
806 <entry>Tweak unfolding settings</entry>
807 <entry>static</entry>
808 <entry><option>-fno-unfolding-update-in-place</option></entry>
812 <entry><option>-funfolding-use-threshold</option></entry>
813 <entry>Tweak unfolding settings</entry>
814 <entry>static</entry>
815 <entry><option>-fno-unfolding-use-threshold</option></entry>
819 <entry><option>-fusagesp</option></entry>
820 <entry>Turn on UsageSP analysis</entry>
821 <entry>static</entry>
822 <entry><option>-fno-usagesp</option></entry>
830 <title>Profiling options (<xref linkend="profiling">)</title>
833 <tgroup cols=3 align=left colsep=1 rowsep=1>
837 <entry>Description</entry>
838 <entry>Static/Dynamic</entry>
839 <entry>Reverse</entry>
844 <entry><option>-auto</option></entry>
845 <entry>Auto-add <literal>_scc_</literal>s to all
846 exported functions</entry>
847 <entry>static</entry>
848 <entry><option>-no-auto</option></entry>
851 <entry><option>-auto-all</option></entry>
852 <entry>Auto-add <literal>_scc_</literal>s to all
853 top-level functions</entry>
854 <entry>static</entry>
855 <entry><option>-no-auto-all</option></entry>
858 <entry><option>-auto-dicts</option></entry>
859 <entry>Auto-add <literal>_scc_</literal>s to all dictionaries</entry>
860 <entry>static</entry>
861 <entry><option>-no-auto-dicts</option></entry>
864 <entry><option>-caf-all</option></entry>
865 <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
866 <entry>static</entry>
867 <entry><option>-no-caf-all</option></entry>
870 <entry><option>-prof</option></entry>
871 <entry>Turn on profiling</entry>
872 <entry>static</entry>
876 <entry><option>-ticky</option></entry>
877 <entry>Turn on ticky-ticky profiling</entry>
878 <entry>static</entry>
887 <title>Parallelism options (<xref linkend="sec-using-parallel">)</title>
890 <tgroup cols=3 align=left colsep=1 rowsep=1>
894 <entry>Description</entry>
895 <entry>Static/Dynamic</entry>
896 <entry>Reverse</entry>
901 <entry><option>-gransim</option></entry>
902 <entry>Enable GRANSIM</entry>
903 <entry>static</entry>
907 <entry><option>-parallel</option></entry>
908 <entry>Enable Parallel Haskell</entry>
909 <entry>static</entry>
913 <entry><option>-smp</option></entry>
914 <entry>Enable SMP support</entry>
915 <entry>static</entry>
924 <title>C pre-processor options (<xref linkend="c-pre-processor">)</title>
927 <tgroup cols=3 align=left colsep=1 rowsep=1>
931 <entry>Description</entry>
932 <entry>Static/Dynamic</entry>
933 <entry>Reverse</entry>
938 <entry><option>-D</option><replaceable>symbol</replaceable><optional>=<replaceable>value</replaceable></optional></entry>
939 <entry>Define a symbol in the C pre-processor</entry>
940 <entry>dynamic</entry>
941 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
944 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
945 <entry>Undefine a symbol in the C pre-processor</entry>
946 <entry>dynamic</entry>
950 <entry><option>-I</option><replaceable>dir</replaceable></entry>
951 <entry>Add <replaceable>dir</replaceable> to the
952 directory search list for <literal>#include</literal> files</entry>
953 <entry>static</entry>
962 <title>C compiler options (<xref linkend="options-C-compiler">)</title>
964 <tgroup cols=3 align=left colsep=1 rowsep=1>
968 <entry>Description</entry>
969 <entry>Static/Dynamic</entry>
970 <entry>Reverse</entry>
975 <entry><option>-#include</option> <replaceable>file</replaceable></entry>
976 <entry>Include <replaceable>file</replaceable> when
977 compiling the <filename>.hc</filename> file</entry>
978 <entry>dynamic</entry>
987 <title>Linking options (<xref linkend="options-linker">)</title>
990 <tgroup cols=3 align=left colsep=1 rowsep=1>
994 <entry>Description</entry>
995 <entry>Static/Dynamic</entry>
996 <entry>Reverse</entry>
1001 <entry><option>-dynamic</option></entry>
1002 <entry>Use dynamic Haskell libraries (if available)</entry>
1003 <entry>static</entry>
1007 <entry><option>-l</option><replaceable>lib</replaceable></entry>
1008 <entry>Link in library <replaceable>lib</replaceable></entry>
1009 <entry>static</entry>
1013 <entry><option>-L</option><replaceable>dir</replaceable></entry>
1014 <entry>Add <replaceable>dir</replaceable> to the list of
1015 directories searched for libraries</entry>
1016 <entry>static</entry>
1020 <entry><option>-package</option> <replaceable>name</replaceable></entry>
1021 <entry>Link in package <replaceable>name</replaceable></entry>
1022 <entry>static</entry>
1026 <entry><option>-split-objs</option></entry>
1027 <entry>Split objects (for libraries)</entry>
1028 <entry>static</entry>
1032 <entry><option>-static</option></entry>
1033 <entry>Use static Haskell libraries</entry>
1034 <entry>static</entry>
1038 <entry><option>-no-hs-main</option></entry>
1039 <entry>Don't asssume this program contains <literal>main</literal></entry>
1040 <entry>static</entry>
1049 <title>Replacing phases (<xref linkend="replacing-phases">)</title>
1052 <tgroup cols=3 align=left colsep=1 rowsep=1>
1056 <entry>Description</entry>
1057 <entry>Static/Dynamic</entry>
1058 <entry>Reverse</entry>
1063 <entry><option>-pgmL</option> <replaceable>cmd</replaceable></entry>
1064 <entry>Use <replaceable>cmd</replaceable> as the literate pre-processor</entry>
1065 <entry>static</entry>
1069 <entry><option>-pgmP</option> <replaceable>cmd</replaceable></entry>
1070 <entry>Use <replaceable>cmd</replaceable> as the C
1071 pre-processor (with <option>-cpp</option> only)</entry>
1072 <entry>static</entry> <entry>-</entry>
1075 <entry><option>-pgmc</option> <replaceable>cmd</replaceable></entry>
1076 <entry>Use <replaceable>cmd</replaceable> as the C compiler</entry>
1077 <entry>static</entry>
1081 <entry><option>-pgma</option> <replaceable>cmd</replaceable></entry>
1082 <entry>Use <replaceable>cmd</replaceable> as the assembler</entry>
1083 <entry>static</entry>
1087 <entry><option>-pgml</option> <replaceable>cmd</replaceable></entry>
1088 <entry>Use <replaceable>cmd</replaceable> as the linker</entry>
1089 <entry>static</entry>
1093 <entry><option>-pgmdll</option> <replaceable>cmd</replaceable></entry>
1094 <entry>Use <replaceable>cmd</replaceable> as the DLL generator</entry>
1095 <entry>static</entry>
1099 <entry><option>-pgmdep</option> <replaceable>cmd</replaceable></entry>
1100 <entry>Use <replaceable>cmd</replaceable> as the dependency generator</entry>
1101 <entry>static</entry>
1107 <indexterm><primary><option>-pgmL</option></primary></indexterm>
1108 <indexterm><primary><option>-pgmP</option></primary></indexterm>
1109 <indexterm><primary><option>-pgmc</option></primary></indexterm>
1110 <indexterm><primary><option>-pgma</option></primary></indexterm>
1111 <indexterm><primary><option>-pgml</option></primary></indexterm>
1112 <indexterm><primary><option>-pgmdll</option></primary></indexterm>
1113 <indexterm><primary><option>-pgmdep</option></primary></indexterm>
1118 <title>Forcing options to particular phases (<xref linkend="forcing-options-through">)</title>
1121 <tgroup cols=3 align=left colsep=1 rowsep=1>
1125 <entry>Description</entry>
1126 <entry>Static/Dynamic</entry>
1127 <entry>Reverse</entry>
1132 <entry><option>-optL</option> <replaceable>option</replaceable></entry>
1133 <entry>pass <replaceable>option</replaceable> to the literate pre-processor</entry>
1134 <entry>dynamic</entry>
1138 <entry><option>-optP</option> <replaceable>option</replaceable></entry>
1139 <entry>pass <replaceable>option</replaceable> to cpp (with
1140 <option>-cpp</option> only)</entry>
1141 <entry>dynamic</entry>
1145 <entry><option>-optc</option> <replaceable>option</replaceable></entry>
1146 <entry>pass <replaceable>option</replaceable> to the C compiler</entry>
1147 <entry>dynamic</entry>
1151 <entry><option>-opta</option> <replaceable>option</replaceable></entry>
1152 <entry>pass <replaceable>option</replaceable> to the assembler</entry>
1153 <entry>dynamic</entry>
1157 <entry><option>-optl</option> <replaceable>option</replaceable></entry>
1158 <entry>pass <replaceable>option</replaceable> to the linker</entry>
1159 <entry>static</entry>
1163 <entry><option>-optdll</option> <replaceable>option</replaceable></entry>
1164 <entry>pass <replaceable>option</replaceable> to the DLL generator</entry>
1165 <entry>static</entry>
1169 <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
1170 <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
1171 <entry>static</entry>
1180 <title>Platform-specific options (<xref linkend="options-platform">)</title>
1183 <tgroup cols=3 align=left colsep=1 rowsep=1>
1187 <entry>Description</entry>
1188 <entry>Static/Dynamic</entry>
1189 <entry>Reverse</entry>
1194 <entry><option>-mv8</option></entry>
1195 <entry>(SPARC only) enable version 8 support</entry>
1196 <entry>static</entry>
1200 <entry><option>-mlong-calls</option></entry>
1201 <entry>(HPPA only) enable long call support</entry>
1202 <entry>static</entry>
1206 <entry><option>-monly-[32]-regs</option></entry>
1207 <entry>(x86 only) give some registers back to the C compiler</entry>
1208 <entry>dynamic</entry>
1217 <title>Compiler debugging options (<xref linkend="options-debugging">)</title>
1220 <tgroup cols=3 align=left colsep=1 rowsep=1>
1224 <entry>Description</entry>
1225 <entry>Static/Dynamic</entry>
1226 <entry>Reverse</entry>
1231 <entry><option>-dcore-lint</option></entry>
1232 <entry>Turn on internal sanity checking</entry>
1233 <entry>dynamic</entry>
1237 <entry><option>-ddump-absC</option></entry>
1238 <entry>Dump abstract C</entry>
1239 <entry>dynamic</entry>
1243 <entry><option>-ddump-asm</option></entry>
1244 <entry>Dump assembly</entry>
1245 <entry>dynamic</entry>
1249 <entry><option>-ddump-bcos</option></entry>
1250 <entry>Dump interpreter byte code</entry>
1251 <entry>dynamic</entry>
1255 <entry><option>-ddump-cpranal</option></entry>
1256 <entry>Dump output from CPR analysis</entry>
1257 <entry>dynamic</entry>
1261 <entry><option>-ddump-cse</option></entry>
1262 <entry>Dump CSE output</entry>
1263 <entry>dynamic</entry>
1267 <entry><option>-ddump-deriv</option></entry>
1268 <entry>Dump deriving output</entry>
1269 <entry>dynamic</entry>
1273 <entry><option>-ddump-ds</option></entry>
1274 <entry>Dump desugarer output</entry>
1275 <entry>dynamic</entry>
1279 <entry><option>-ddump-flatC</option></entry>
1280 <entry>Dump “flat” C</entry>
1281 <entry>dynamic</entry>
1285 <entry><option>-ddump-foreign</option></entry>
1286 <entry>Dump FFI-related output</entry>
1287 <entry>dynamic</entry>
1291 <entry><option>-ddump-inlinings</option></entry>
1292 <entry>Dump inlining info</entry>
1293 <entry>dynamic</entry>
1297 <entry><option>-ddump-occur-anal</option></entry>
1298 <entry>Dump occurrence analysis output</entry>
1299 <entry>dynamic</entry>
1303 <entry><option>-ddump-parsed</option></entry>
1304 <entry>Dump parse tree</entry>
1305 <entry>dynamic</entry>
1309 <entry><option>-ddump-realC</option></entry>
1310 <entry>Dump “real” C</entry>
1311 <entry>dynamic</entry>
1315 <entry><option>-ddump-rn</option></entry>
1316 <entry>Dump renamer output</entry>
1317 <entry>dynamic</entry>
1321 <entry><option>-ddump-rules</option></entry>
1322 <entry>Dump rules</entry>
1323 <entry>dynamic</entry>
1327 <entry><option>-ddump-sat</option></entry>
1328 <entry>Dump saturated output</entry>
1329 <entry>dynamic</entry>
1333 <entry><option>-ddump-simpl</option></entry>
1334 <entry>Dump final simplifier output</entry>
1335 <entry>dynamic</entry>
1339 <entry><option>-ddump-simpl-iterations</option></entry>
1340 <entry>Dump output from each simplifier iteration</entry>
1341 <entry>dynamic</entry>
1345 <entry><option>-ddump-spec</option></entry>
1346 <entry>Dump specialiser output</entry>
1347 <entry>dynamic</entry>
1351 <entry><option>-ddump-stg</option></entry>
1352 <entry>Dump final STG</entry>
1353 <entry>dynamic</entry>
1357 <entry><option>-ddump-stranal</option></entry>
1358 <entry>Dump strictness analyser output</entry>
1359 <entry>dynamic</entry>
1363 <entry><option>-ddump-tc</option></entry>
1364 <entry>Dump typechecker output</entry>
1365 <entry>dynamic</entry>
1369 <entry><option>-ddump-types</option></entry>
1370 <entry>Dump type signatures</entry>
1371 <entry>dynamic</entry>
1375 <entry><option>-ddump-usagesp</option></entry>
1376 <entry>Dump UsageSP analysis output</entry>
1377 <entry>dynamic</entry>
1381 <entry><option>-ddump-worker-wrapper</option></entry>
1382 <entry>Dump worker-wrapper output</entry>
1383 <entry>dynamic</entry>
1387 <entry><option>-dshow-passes</option></entry>
1388 <entry>(equivalent to <option>-v2</option>)</entry>
1389 <entry>dynamic</entry>
1393 <entry><option>-ddump-rn-trace</option></entry>
1394 <entry>Trace renamer</entry>
1395 <entry>dynamic</entry>
1399 <entry><option>-ddump-rn-stats</option></entry>
1400 <entry>Renamer stats</entry>
1401 <entry>dynamic</entry>
1405 <entry><option>-ddump-stix</option></entry>
1406 <entry>Native code generator intermediate form</entry>
1407 <entry>dynamic</entry>
1411 <entry><option>-ddump-simpl-stats</option></entry>
1412 <entry>Dump simplifier stats</entry>
1413 <entry>dynamic</entry>
1417 <entry><option>-dppr-debug</option></entry>
1418 <entry>Turn on debug printing (more verbose)</entry>
1419 <entry>static</entry>
1423 <entry><option>-dppr-noprags</option></entry>
1424 <entry>Don't output pragma info in dumps</entry>
1425 <entry>static</entry>
1429 <entry><option>-dppr-user-length</option></entry>
1430 <entry>Set the depth for printing expressions in error msgs</entry>
1431 <entry>static</entry>
1435 <entry><option>-dsource-stats</option></entry>
1436 <entry>Dump haskell source stats</entry>
1437 <entry>dynamic</entry>
1441 <entry><option>-dstg-lint</option></entry>
1442 <entry>STG pass sanity checking</entry>
1443 <entry>dynamic</entry>
1447 <entry><option>-dstg-stats</option></entry>
1448 <entry>Dump STG stats</entry>
1449 <entry>dynamic</entry>
1453 <entry><option>-dusagesp-lint</option></entry>
1454 <entry>UsageSP sanity checker</entry>
1455 <entry>dynamic</entry>
1459 <entry><option>-dverbose-core2core</option></entry>
1460 <entry>Show output from each core-to-core pass</entry>
1461 <entry>dynamic</entry>
1465 <entry><option>-dverbose-stg2stg</option></entry>
1466 <entry>Show output from each STG-to-STG pass</entry>
1467 <entry>dynamic</entry>
1476 <title>Misc compiler options</title>
1479 <tgroup cols=3 align=left colsep=1 rowsep=1>
1483 <entry>Description</entry>
1484 <entry>Static/Dynamic</entry>
1485 <entry>Reverse</entry>
1490 <entry><option>-funfold-casms-in-hi-file</option></entry>
1491 <entry>Allow casms in unfoldings</entry>
1492 <entry>static</entry>
1496 <entry><option>-femit-extern-decls</option></entry>
1498 <entry>static</entry>
1502 <entry><option>-fglobalise-toplev-names</option></entry>
1503 <entry>Make all top-level names global (for <option>-split-objs</option>)</entry>
1504 <entry>static</entry>
1508 <entry><option>-fno-hi-version-check</option></entry>
1509 <entry>Don't complain about <literal>.hi</literal> file mismatches</entry>
1510 <entry>static</entry>
1514 <entry><option>-dno-black-holing</option></entry>
1515 <entry>Turn off black holing (probably doesn't work)</entry>
1516 <entry>static</entry>
1520 <entry><option>-fno-method-sharing</option></entry>
1522 <entry>static</entry>
1526 <entry><option>-fno-prune-decls</option></entry>
1527 <entry>Renamer: don't prune declarations</entry>
1528 <entry>static</entry>
1532 <entry><option>-fno-prune-tydecls</option></entry>
1533 <entry>Renamer: don't prune type declarations</entry>
1534 <entry>static</entry>
1538 <entry><option>-fhistory-size</option></entry>
1539 <entry>Set simplification history size</entry>
1540 <entry>static</entry>
1544 <entry><option>-funregisterised</option></entry>
1545 <entry>Unregisterised compilation (use <option>-unreg</option> instead)</entry>
1546 <entry>static</entry>
1550 <entry><option>-fno-asm-mangling</option></entry>
1551 <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
1552 <entry>static</entry>
1566 , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) )
1567 , ( "Rghc-timing" , NoArg (enableTimingStats) )
1569 , ( "unreg" , NoArg (addNoDups v_Ways WayUnreg) )
1573 ;;; Local Variables: ***
1575 ;;; sgml-parent-document: ("users_guide.sgml" "book" "chapter") ***