1 <sect1 id="flag-reference">
2 <title>Flag reference</title>
4 <para>This section is a quick-reference for GHC's command-line
5 flags. For each flag, we also list its static/dynamic status (see
6 <xref linkend="static-dynamic-flags">), and the flag's opposite
10 <title>Help and verbosity options (<xref linkend="options-help">)</title>
13 <tgroup cols=3 align=left colsep=1 rowsep=1>
17 <entry>Description</entry>
18 <entry>Static/Dynamic</entry>
19 <entry>Reverse</entry>
24 <entry><option>-?</option></entry>
30 <entry><option>-help</option></entry>
36 <entry><option>-v</option></entry>
37 <entry>verbose mode (equivalent to <option>-v3</option>)</entry>
38 <entry>dynamic</entry>
42 <entry><option>-v</option><replaceable>n</replaceable></entry>
43 <entry>set verbosity level</entry>
44 <entry>dynamic</entry>
48 <entry><option>––version</option></entry>
49 <entry>display GHC version</entry>
54 <entry><option>––numeric-version</option></entry>
55 <entry>display GHC version (numeric only)</entry>
60 <entry><option>––print-libdir</option></entry>
61 <entry>display GHC library directory</entry>
71 <title>Which phases to run (<xref linkend="options-order">)</title>
74 <tgroup cols=3 align=left colsep=1 rowsep=1>
78 <entry>Description</entry>
79 <entry>Static/Dynamic</entry>
80 <entry>Reverse</entry>
85 <entry><option>-E</option></entry>
86 <entry>Stop after preprocessing (<literal>.hspp</literal> file)</entry>
91 <entry><option>-C</option></entry>
92 <entry>Stop after generating C (<literal>.hc</literal> file)</entry>
97 <entry><option>-S</option></entry>
98 <entry>Stop after generating assembly (<literal>.s</literal> file)</entry>
103 <entry><option>-c</option></entry>
104 <entry>Stop after compiling to object code (<literal>.o</literal> file)</entry>
105 <entry>static</entry>
114 <title>Redirecting output (<xref linkend="options-output">)</title>
117 <tgroup cols=3 align=left colsep=1 rowsep=1>
121 <entry>Description</entry>
122 <entry>Static/Dynamic</entry>
123 <entry>Reverse</entry>
128 <entry><option>-hcsuf</option> <replaceable>suffix</replaceable></entry>
129 <entry>set the suffix to use for intermediate C files</entry>
130 <entry>static</entry>
134 <entry><option>-hidir</option> <replaceable>dir</replaceable></entry>
135 <entry>set directory for interface files</entry>
136 <entry>static</entry>
140 <entry><option>-hisuf</option> <replaceable>suffix</replaceable></entry>
141 <entry>set the suffix to use for interface files</entry>
142 <entry>static</entry>
146 <entry><option>-o</option> <replaceable>filename</replaceable></entry>
147 <entry>set output filename</entry>
148 <entry>static</entry>
152 <entry><option>-odir</option> <replaceable>dir</replaceable></entry>
153 <entry>set output directory</entry>
154 <entry>static</entry>
158 <entry><option>-ohi</option> <replaceable>filename</replaceable></entry>
159 <entry>set the filename in which to put the interface</entry>
160 <entry>static</entry>
164 <entry><option>-osuf</option> <replaceable>suffix</replaceable></entry>
165 <entry>set the output file suffix</entry>
166 <entry>static</entry>
175 <title>Keeping intermediate files (<xref linkend="keeping-intermediates">)</title>
178 <tgroup cols=3 align=left colsep=1 rowsep=1>
182 <entry>Description</entry>
183 <entry>Static/Dynamic</entry>
184 <entry>Reverse</entry>
189 <entry><option>-keep-hc-file</option></entry>
190 <entry>retain intermediate <literal>.hc</literal> files</entry>
191 <entry>static</entry>
195 <entry><option>-keep-s-file</option></entry>
196 <entry>retain intermediate <literal>.s</literal> files</entry>
197 <entry>static</entry>
201 <entry><option>-keep-raw-s-file</option></entry>
202 <entry>retain intermediate <literal>.raw_s</literal> files</entry>
203 <entry>static</entry>
207 <entry><option>-keep-tmp-files</option></entry>
208 <entry>retain all intermediate temporary files</entry>
209 <entry>static</entry>
218 <title>Temporary files (<xref linkend="temp-files">)</title>
221 <tgroup cols=3 align=left colsep=1 rowsep=1>
225 <entry>Description</entry>
226 <entry>Static/Dynamic</entry>
227 <entry>Reverse</entry>
232 <entry><option>-tmpdir</option></entry>
233 <entry>set the directory for temporary files</entry>
234 <entry>static</entry>
243 <title>Finding imports (<xref linkend="search-path">)</title>
246 <tgroup cols=3 align=left colsep=1 rowsep=1>
251 <entry>Description</entry>
252 <entry>Static/Dynamic</entry>
253 <entry>Reverse</entry>
258 <entry><option>-i</option><replaceable>dir1</replaceable>:<replaceable>dir2</replaceable>:...</entry>
259 <entry>add <replaceable>dir</replaceable>,
260 <replaceable>dir2</replaceable>, etc. to import path</entry>
261 <entry>static</entry>
265 <entry><option>-i</option></entry>
266 <entry>Empty the import directory list</entry>
267 <entry>static</entry>
276 <title>Interface file options (<xref linkend="hi-options">)</title>
279 <tgroup cols=3 align=left colsep=1 rowsep=1>
284 <entry>Description</entry>
285 <entry>Static/Dynamic</entry>
286 <entry>Reverse</entry>
291 <entry><option>-ddump-hi</option></entry>
292 <entry>Dump the new interface to stdout</entry>
293 <entry>dynamic</entry>
297 <entry><option>-ddump-hi-diffs</option></entry>
298 <entry>Show the differences vs. the old interface</entry>
299 <entry>dynamic</entry>
303 <entry><option>-ddump-minimal-imports</option></entry>
304 <entry>Dump a minimal set of imports</entry>
305 <entry>dynamic</entry>
309 <entry><option>--show-iface</option> <replaceable>file</replaceable></entry>
310 <entry>Read the interface in
311 <replaceable>file</replaceable> and dump it as text to
312 <literal>stdout</literal>.</entry>
313 <entry>static</entry>
322 <title>Recompilation checking (<xref linkend="recomp">)</title>
325 <tgroup cols=3 align=left colsep=1 rowsep=1>
330 <entry>Description</entry>
331 <entry>Static/Dynamic</entry>
332 <entry>Reverse</entry>
337 <entry><option>-no-recomp</option></entry>
338 <entry>Turn off recompilation checking</entry>
339 <entry>static</entry>
340 <entry><option>-recomp</option></entry>
348 <title>Interactive-mode options (<xref linkend="ghci-dot-files">)</title>
351 <tgroup cols=3 align=left colsep=1 rowsep=1>
355 <entry>Description</entry>
356 <entry>Static/Dynamic</entry>
357 <entry>Reverse</entry>
362 <entry><option>-ignore-dot-ghci</option></entry>
363 <entry>Disable reading of <filename>.ghci</filename> files</entry>
364 <entry>static</entry>
368 <entry><option>-read-dot-ghci</option></entry>
369 <entry>Enable reading of <filename>.ghci</filename> files</entry>
370 <entry>static</entry>
379 <title>Packages (<xref linkend="packages">)</title>
381 <tgroup cols=3 align=left colsep=1 rowsep=1>
385 <entry>Description</entry>
386 <entry>Static/Dynamic</entry>
387 <entry>Reverse</entry>
392 <entry><option>-package</option> <replaceable>name</replaceable></entry>
393 <entry>Use package <replaceable>name</replaceable></entry>
394 <entry>static</entry>
398 <entry><option>-package-conf</option> <replaceable>file</replaceable></entry>
399 <entry>Load more packages from <replaceable>file</replaceable></entry>
400 <entry>static</entry>
404 <entry><option>-package-name</option> <replaceable>name</replaceable></entry>
405 <entry>Compile code for package <replaceable>name</replaceable></entry>
406 <entry>static</entry>
415 <title>Language options (<xref linkend="options-language">)</title>
418 <tgroup cols=3 align=left colsep=1 rowsep=1>
422 <entry>Description</entry>
423 <entry>Static/Dynamic</entry>
424 <entry>Reverse</entry>
429 <entry><option>-fallow-overlapping-instances</option></entry>
431 <entry>dynamic</entry>
432 <entry><option>-fno-allow-overlapping-instances</option></entry>
435 <entry><option>-fallow-undecidable-instances</option></entry>
436 <entry>Enable undecidable instances</entry>
437 <entry>dynamic</entry>
438 <entry><option>-fno-allow-undecidable-instances</option></entry>
441 <entry><option>-fgenerics</option></entry>
442 <entry>Enable generics</entry>
443 <entry>dynamic</entry>
444 <entry><option>-fno-fgenerics</option></entry>
447 <entry><option>-fglasgow-exts</option></entry>
448 <entry>Enable most language extensions</entry>
449 <entry>dynamic</entry>
450 <entry><option>-fno-glasgow-exts</option></entry>
453 <entry><option>-ffi</option> or <option>-fffi</option></entry>
454 <entry>Enable foreign function interface (implied by
455 <option>-fglasgow-exts</option>)</entry>
456 <entry>dynamic</entry>
457 <entry><option>-fno-ffi</option></entry>
460 <entry><option>-farrows</option></entry>
461 <entry>Enable arrow notation extension</entry>
462 <entry>dynamic</entry>
463 <entry><option>-fno-arrows</option></entry>
466 <entry><option>-fwith</option></entry>
467 <entry>Enable deprecated <literal>with</literal> keyword</entry>
468 <entry>dynamic</entry>
469 <entry><option>-fno-with</option></entry>
472 <entry><option>-fignore-asserts</option></entry>
473 <entry>Ignore assertions</entry>
474 <entry>dynamic</entry>
475 <entry><option>-fno-ignore-asserts</option></entry>
478 <entry><option>-fno-implicit-prelude</option></entry>
479 <entry>Don't implicitly <literal>import Prelude</literal></entry>
480 <entry>dynamic</entry>
484 <entry><option>-fno-monomorphism-restriction</option></entry>
485 <entry>Disable the monomorphism restriction</entry>
486 <entry>dynamic</entry>
487 <entry><option>-</option></entry>
490 <entry><option>-firrefutable-tuples</option></entry>
491 <entry>Make tuple pattern matching irrefutable</entry>
492 <entry>dynamic</entry>
493 <entry><option>-fno-irrefutable-tuples</option></entry>
496 <entry><option>-fcontext-stack</option><replaceable>n</replaceable></entry>
497 <entry>set the limit for context reduction</entry>
498 <entry>dynamic</entry>
499 <entry><option>-</option></entry>
507 <title>Warnings (<xref linkend="options-sanity">)</title>
510 <tgroup cols=3 align=left colsep=1 rowsep=1>
514 <entry>Description</entry>
515 <entry>Static/Dynamic</entry>
516 <entry>Reverse</entry>
521 <entry><option>-W</option></entry>
522 <entry>enable normal warnings</entry>
523 <entry>dynamic</entry>
524 <entry><option>-w</option></entry>
527 <entry><option>-w</option></entry>
528 <entry>disable all warnings</entry>
529 <entry>dynamic</entry>
533 <entry><option>-Wall</option></entry>
534 <entry>enable all warnings</entry>
535 <entry>dynamic</entry>
536 <entry><option>-w</option></entry>
539 <entry><option>-Werror</option></entry>
540 <entry>make warnings fatal</entry>
541 <entry>dynamic</entry>
546 <entry><option>-fwarn-deprecations</option></entry>
547 <entry>warn about uses of functions & types that are deprecated</entry>
548 <entry>dynamic</entry>
549 <entry><option>-fno-warn-deprecations</option></entry>
553 <entry><option>-fwarn-duplicate-exports</option></entry>
554 <entry>warn when an entity is exported multiple times</entry>
555 <entry>dynamic</entry>
556 <entry><option>-fno-warn-duplicate-exports</option></entry>
560 <entry><option>-fwarn-hi-shadowing</option></entry>
561 <entry>warn when a <literal>.hi</literal> file in the
562 current directory shadows a library</entry>
563 <entry>dynamic</entry>
564 <entry><option>-fno-warn-hi-shadowing</option></entry>
568 <entry><option>-fwarn-incomplete-patterns</option></entry>
569 <entry>warn when a pattern match could fail</entry>
570 <entry>dynamic</entry>
571 <entry><option>-fno-warn-incomplete-patterns</option></entry>
575 <entry><option>-fwarn-misc</option></entry>
576 <entry>enable miscellaneous warnings</entry>
577 <entry>dynamic</entry>
578 <entry><option>-fno-warn-misc</option></entry>
582 <entry><option>-fwarn-missing-fields</option></entry>
583 <entry>warn when fields of a record are uninitialised</entry>
584 <entry>dynamic</entry>
585 <entry><option>-fno-warn-missing-fields</option></entry>
589 <entry><option>-fwarn-missing-methods</option></entry>
590 <entry>warn when class methods are undefined</entry>
591 <entry>dynamic</entry>
592 <entry><option>-fno-warn-missing-methods</option></entry>
596 <entry><option>-fwarn-missing-signatures</option></entry>
597 <entry>warn about top-level functions without signatures</entry>
598 <entry>dynamic</entry>
599 <entry><option>-fno-warn-missing-signatures</option></entry>
603 <entry><option>-fwarn-name-shadowing</option></entry>
604 <entry>warn when names are shadowed</entry>
605 <entry>dynamic</entry>
606 <entry><option>-fno-warn-name-shadowing</option></entry>
610 <entry><option>-fwarn-overlapping-patterns</option></entry>
611 <entry>warn about overlapping patterns</entry>
612 <entry>dynamic</entry>
613 <entry><option>-fno-warn-overlapping-patterns</option></entry>
617 <entry><option>-fwarn-simple-patterns</option></entry>
618 <entry>warn about lambda-patterns that can fail</entry>
619 <entry>dynamic</entry>
620 <entry><option>-fno-warn-simple-patterns</option></entry>
624 <entry><option>-fwarn-type-defaults</option></entry>
625 <entry>warn when defaulting happens</entry>
626 <entry>dynamic</entry>
627 <entry><option>-fno-warn-type-defaults</option></entry>
631 <entry><option>-fwarn-unused-binds</option></entry>
632 <entry>warn about bindings that are unused</entry>
633 <entry>dynamic</entry>
634 <entry><option>-fno-warn-unused-binds</option></entry>
638 <entry><option>-fwarn-unused-imports</option></entry>
639 <entry>warn about unnecessary imports</entry>
640 <entry>dynamic</entry>
641 <entry><option>-fno-warn-unused-imports</option></entry>
645 <entry><option>-fwarn-unused-matches</option></entry>
646 <entry>warn about variables in patterns that aren't used</entry>
647 <entry>dynamic</entry>
648 <entry><option>-fno-warn-unused-matches</option></entry>
657 <title>Optimisation levels (<xref linkend="options-optimise">)</title>
660 <tgroup cols=3 align=left colsep=1 rowsep=1>
664 <entry>Description</entry>
665 <entry>Static/Dynamic</entry>
666 <entry>Reverse</entry>
671 <entry><option>-O</option></entry>
672 <entry>Enable default optimisation (level 1)</entry>
673 <entry>static</entry>
674 <entry><option>-O0</option></entry>
677 <entry><option>-O</option><replaceable>n</replaceable></entry>
678 <entry>Set optimisation level <replaceable>n</replaceable></entry>
679 <entry>static</entry>
680 <entry><option>-O0</option></entry>
688 <title>Individual optimisations (<xref linkend="options-f">)</title>
691 <tgroup cols=3 align=left colsep=1 rowsep=1>
695 <entry>Description</entry>
696 <entry>Static/Dynamic</entry>
697 <entry>Reverse</entry>
702 <entry><option>-fcase-merge</option></entry>
703 <entry>Enable case-merging</entry>
704 <entry>static</entry>
705 <entry><option>-fno-case-merge</option></entry>
709 <entry><option>-fdicts-strict</option></entry>
710 <entry>Make dictionaries strict</entry>
711 <entry>dynamic</entry>
712 <entry><option>-fno-dicts-strict</option></entry>
716 <entry><option>-fdo-eta-reduction</option></entry>
717 <entry>Enable eta-reduction</entry>
718 <entry>static</entry>
719 <entry><option>-fno-do-eta-reduction</option></entry>
723 <entry><option>-fdo-lambda-eta-expansion</option></entry>
724 <entry>Enable lambda eta-reduction</entry>
725 <entry>static</entry>
726 <entry><option>-fno-do-lambda-eta-expansion</option></entry>
730 <entry><option>-fexcess-precision</option></entry>
731 <entry>Enable excess intermediate precision</entry>
732 <entry>static</entry>
733 <entry><option>-fno-excess-precision</option></entry>
737 <entry><option>-frules-off</option></entry>
738 <entry>Switch off all rewrite rules (including rules
739 generated by automatic specialisation of overloaded functions)</entry>
740 <entry>static</entry>
741 <entry><option>-frules-off</option></entry>
745 <entry><option>-fignore-asserts</option></entry>
746 <entry>Ignore assertions in the source</entry>
747 <entry>static</entry>
748 <entry><option>-fno-ignore-asserts</option></entry>
752 <entry><option>-fignore-interface-pragmas</option></entry>
753 <entry>Ignore pragmas in interface files</entry>
754 <entry>static</entry>
755 <entry><option>-fno-ignore-interface-pragmas</option></entry>
759 <entry><option>-flet-no-escape</option></entry>
760 <entry>Enable let-no-escape optimisation</entry>
761 <entry>static</entry>
762 <entry><option>-fno-let-no-escape</option></entry>
766 <entry><option>-fliberate-case-threshold</option></entry>
767 <entry>Tweak the liberate-case optimisation (default: 10)</entry>
768 <entry>static</entry>
769 <entry><option>-fno-liberate-case-threshold</option></entry>
773 <entry><option>-fomit-interface-pragmas</option></entry>
774 <entry>Don't generate interface pragmas</entry>
775 <entry>static</entry>
776 <entry><option>-fno-omit-interface-pragmas</option></entry>
780 <entry><option>-fmax-worker-args</option></entry>
781 <entry>If a worker has that many arguments, none will be
782 unpacked anymore (default: 10)</entry>
783 <entry>static</entry>
788 <entry><option>-fmax-simplifier-iterations</option></entry>
789 <entry>Set the max iterations for the simplifier</entry>
790 <entry>static</entry>
795 <entry><option>-fno-cpr</option></entry>
796 <entry>Turn off CPR analysis</entry>
797 <entry>static</entry>
802 <entry><option>-fno-cse</option></entry>
803 <entry>Turn off common sub-expression</entry>
804 <entry>static</entry>
809 <entry><option>-fno-pre-inlining</option></entry>
810 <entry>Turn off pre-inlining</entry>
811 <entry>static</entry>
816 <entry><option>-fno-strictness</option></entry>
817 <entry>Turn off strictness analysis</entry>
818 <entry>static</entry>
823 <entry><option>-fnumbers-strict</option></entry>
824 <entry>Make numbers strict</entry>
825 <entry>dynamic</entry>
826 <entry><option>-fno-numbers-strict</option></entry>
830 <entry><option>-funbox-strict-fields</option></entry>
831 <entry>Flatten strict constructor fields</entry>
832 <entry>static</entry>
833 <entry><option>-fno-unbox-strict-fields</option></entry>
837 <entry><option>-funfolding-creation-threshold</option></entry>
838 <entry>Tweak unfolding settings</entry>
839 <entry>static</entry>
840 <entry><option>-fno-unfolding-creation-threshold</option></entry>
844 <entry><option>-funfolding-fun-discount</option></entry>
845 <entry>Tweak unfolding settings</entry>
846 <entry>static</entry>
847 <entry><option>-fno-unfolding-fun-discount</option></entry>
851 <entry><option>-funfolding-keeness-factor</option></entry>
852 <entry>Tweak unfolding settings</entry>
853 <entry>static</entry>
854 <entry><option>-fno-unfolding-keeness-factor</option></entry>
858 <entry><option>-funfolding-update-in-place</option></entry>
859 <entry>Tweak unfolding settings</entry>
860 <entry>static</entry>
861 <entry><option>-fno-unfolding-update-in-place</option></entry>
865 <entry><option>-funfolding-use-threshold</option></entry>
866 <entry>Tweak unfolding settings</entry>
867 <entry>static</entry>
868 <entry><option>-fno-unfolding-use-threshold</option></entry>
872 <entry><option>-fusagesp</option></entry>
873 <entry>Turn on UsageSP analysis</entry>
874 <entry>static</entry>
875 <entry><option>-fno-usagesp</option></entry>
883 <title>Profiling options (<xref linkend="profiling">)</title>
886 <tgroup cols=3 align=left colsep=1 rowsep=1>
890 <entry>Description</entry>
891 <entry>Static/Dynamic</entry>
892 <entry>Reverse</entry>
897 <entry><option>-auto</option></entry>
898 <entry>Auto-add <literal>_scc_</literal>s to all
899 exported functions</entry>
900 <entry>static</entry>
901 <entry><option>-no-auto</option></entry>
904 <entry><option>-auto-all</option></entry>
905 <entry>Auto-add <literal>_scc_</literal>s to all
906 top-level functions</entry>
907 <entry>static</entry>
908 <entry><option>-no-auto-all</option></entry>
911 <entry><option>-auto-dicts</option></entry>
912 <entry>Auto-add <literal>_scc_</literal>s to all dictionaries</entry>
913 <entry>static</entry>
914 <entry><option>-no-auto-dicts</option></entry>
917 <entry><option>-caf-all</option></entry>
918 <entry>Auto-add <literal>_scc_</literal>s to all CAFs</entry>
919 <entry>static</entry>
920 <entry><option>-no-caf-all</option></entry>
923 <entry><option>-prof</option></entry>
924 <entry>Turn on profiling</entry>
925 <entry>static</entry>
929 <entry><option>-ticky</option></entry>
930 <entry>Turn on ticky-ticky profiling</entry>
931 <entry>static</entry>
940 <title>Parallelism options (<xref linkend="sec-using-parallel">)</title>
943 <tgroup cols=3 align=left colsep=1 rowsep=1>
947 <entry>Description</entry>
948 <entry>Static/Dynamic</entry>
949 <entry>Reverse</entry>
954 <entry><option>-gransim</option></entry>
955 <entry>Enable GRANSIM</entry>
956 <entry>static</entry>
960 <entry><option>-parallel</option></entry>
961 <entry>Enable Parallel Haskell</entry>
962 <entry>static</entry>
966 <entry><option>-smp</option></entry>
967 <entry>Enable SMP support</entry>
968 <entry>static</entry>
977 <title>C pre-processor options (<xref linkend="c-pre-processor">)</title>
980 <tgroup cols=3 align=left colsep=1 rowsep=1>
984 <entry>Description</entry>
985 <entry>Static/Dynamic</entry>
986 <entry>Reverse</entry>
991 <entry><option>-cpp</option></entry>
992 <entry>Run the C pre-processor on Haskell source files</entry>
993 <entry>dynamic</entry>
997 <entry><option>-D</option><replaceable>symbol</replaceable><optional>=<replaceable>value</replaceable></optional></entry>
998 <entry>Define a symbol in the C pre-processor</entry>
999 <entry>dynamic</entry>
1000 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1003 <entry><option>-U</option><replaceable>symbol</replaceable></entry>
1004 <entry>Undefine a symbol in the C pre-processor</entry>
1005 <entry>dynamic</entry>
1009 <entry><option>-I</option><replaceable>dir</replaceable></entry>
1010 <entry>Add <replaceable>dir</replaceable> to the
1011 directory search list for <literal>#include</literal> files</entry>
1012 <entry>static</entry>
1021 <title>C compiler options (<xref linkend="options-C-compiler">)</title>
1023 <tgroup cols=3 align=left colsep=1 rowsep=1>
1027 <entry>Description</entry>
1028 <entry>Static/Dynamic</entry>
1029 <entry>Reverse</entry>
1034 <entry><option>-#include</option> <replaceable>file</replaceable></entry>
1035 <entry>Include <replaceable>file</replaceable> when
1036 compiling the <filename>.hc</filename> file</entry>
1037 <entry>dynamic</entry>
1046 <title>Code generation options (<xref linkend="options-codegen">)</title>
1049 <tgroup cols=3 align=left colsep=1 rowsep=1>
1053 <entry>Description</entry>
1054 <entry>Static/Dynamic</entry>
1055 <entry>Reverse</entry>
1060 <entry><option>-fasm</option></entry>
1061 <entry>Use the native code generator</entry>
1062 <entry>dynamic</entry>
1063 <entry>-fvia-C</entry>
1066 <entry><option>-fvia-C</option></entry>
1067 <entry>Compile via C</entry>
1068 <entry>dynamic</entry>
1069 <entry>-fasm</entry>
1072 <entry><option>-fno-code</option></entry>
1073 <entry>Omit code generation</entry>
1074 <entry>static</entry>
1083 <title>Linking options (<xref linkend="options-linker">)</title>
1086 <tgroup cols=3 align=left colsep=1 rowsep=1>
1090 <entry>Description</entry>
1091 <entry>Static/Dynamic</entry>
1092 <entry>Reverse</entry>
1097 <entry><option>-dynamic</option></entry>
1098 <entry>Use dynamic Haskell libraries (if available)</entry>
1099 <entry>static</entry>
1103 <entry><option>-framework</option> <replaceable>name</replaceable></entry>
1104 <entry>On Darwin/MacOS X only, link in the framework <replaceable>name</replaceable>.
1105 This option corresponds to the <option>-framework</option> option for Apple's Linker.</entry>
1106 <entry>static</entry>
1110 <entry><option>-framework-path</option> <replaceable>name</replaceable></entry>
1111 <entry>On Darwin/MacOS X only, add <replaceable>dir</replaceable> to the list of
1112 directories searched for frameworks.
1113 This option corresponds to the <option>-F</option> option for Apple's Linker.</entry>
1114 <entry>static</entry>
1118 <entry><option>-l</option><replaceable>lib</replaceable></entry>
1119 <entry>Link in library <replaceable>lib</replaceable></entry>
1120 <entry>static</entry>
1124 <entry><option>-L</option><replaceable>dir</replaceable></entry>
1125 <entry>Add <replaceable>dir</replaceable> to the list of
1126 directories searched for libraries</entry>
1127 <entry>static</entry>
1131 <entry><option>-main-is</option></entry>
1132 <entry>Set main function</entry>
1133 <entry>static</entry>
1137 <entry><option>-no-hs-main</option></entry>
1138 <entry>Don't asssume this program contains <literal>main</literal></entry>
1139 <entry>static</entry>
1143 <entry><option>-no-link</option></entry>
1144 <entry>Omit linking</entry>
1145 <entry>static</entry>
1149 <entry><option>-package</option> <replaceable>name</replaceable></entry>
1150 <entry>Link in package <replaceable>name</replaceable></entry>
1151 <entry>static</entry>
1155 <entry><option>-split-objs</option></entry>
1156 <entry>Split objects (for libraries)</entry>
1157 <entry>static</entry>
1161 <entry><option>-static</option></entry>
1162 <entry>Use static Haskell libraries</entry>
1163 <entry>static</entry>
1172 <title>Replacing phases (<xref linkend="replacing-phases">)</title>
1175 <tgroup cols=3 align=left colsep=1 rowsep=1>
1179 <entry>Description</entry>
1180 <entry>Static/Dynamic</entry>
1181 <entry>Reverse</entry>
1186 <entry><option>-pgmL</option> <replaceable>cmd</replaceable></entry>
1187 <entry>Use <replaceable>cmd</replaceable> as the literate pre-processor</entry>
1188 <entry>static</entry>
1192 <entry><option>-pgmP</option> <replaceable>cmd</replaceable></entry>
1193 <entry>Use <replaceable>cmd</replaceable> as the C
1194 pre-processor (with <option>-cpp</option> only)</entry>
1195 <entry>static</entry> <entry>-</entry>
1198 <entry><option>-pgmc</option> <replaceable>cmd</replaceable></entry>
1199 <entry>Use <replaceable>cmd</replaceable> as the C compiler</entry>
1200 <entry>static</entry>
1204 <entry><option>-pgma</option> <replaceable>cmd</replaceable></entry>
1205 <entry>Use <replaceable>cmd</replaceable> as the assembler</entry>
1206 <entry>static</entry>
1210 <entry><option>-pgml</option> <replaceable>cmd</replaceable></entry>
1211 <entry>Use <replaceable>cmd</replaceable> as the linker</entry>
1212 <entry>static</entry>
1216 <entry><option>-pgmdll</option> <replaceable>cmd</replaceable></entry>
1217 <entry>Use <replaceable>cmd</replaceable> as the DLL generator</entry>
1218 <entry>static</entry>
1222 <entry><option>-pgmdep</option> <replaceable>cmd</replaceable></entry>
1223 <entry>Use <replaceable>cmd</replaceable> as the dependency generator</entry>
1224 <entry>static</entry>
1228 <entry><option>-pgmF</option> <replaceable>cmd</replaceable></entry>
1229 <entry>Use <replaceable>cmd</replaceable> as the pre-processor
1230 (with <option>-F</option> only)</entry>
1231 <entry>static</entry>
1237 <indexterm><primary><option>-pgmL</option></primary></indexterm>
1238 <indexterm><primary><option>-pgmP</option></primary></indexterm>
1239 <indexterm><primary><option>-pgmc</option></primary></indexterm>
1240 <indexterm><primary><option>-pgma</option></primary></indexterm>
1241 <indexterm><primary><option>-pgml</option></primary></indexterm>
1242 <indexterm><primary><option>-pgmdll</option></primary></indexterm>
1243 <indexterm><primary><option>-pgmdep</option></primary></indexterm>
1244 <indexterm><primary><option>-pgmF</option></primary></indexterm>
1249 <title>Forcing options to particular phases (<xref linkend="forcing-options-through">)</title>
1252 <tgroup cols=3 align=left colsep=1 rowsep=1>
1256 <entry>Description</entry>
1257 <entry>Static/Dynamic</entry>
1258 <entry>Reverse</entry>
1263 <entry><option>-optL</option> <replaceable>option</replaceable></entry>
1264 <entry>pass <replaceable>option</replaceable> to the literate pre-processor</entry>
1265 <entry>dynamic</entry>
1269 <entry><option>-optP</option> <replaceable>option</replaceable></entry>
1270 <entry>pass <replaceable>option</replaceable> to cpp (with
1271 <option>-cpp</option> only)</entry>
1272 <entry>dynamic</entry>
1276 <entry><option>-optc</option> <replaceable>option</replaceable></entry>
1277 <entry>pass <replaceable>option</replaceable> to the C compiler</entry>
1278 <entry>dynamic</entry>
1282 <entry><option>-opta</option> <replaceable>option</replaceable></entry>
1283 <entry>pass <replaceable>option</replaceable> to the assembler</entry>
1284 <entry>dynamic</entry>
1288 <entry><option>-optl</option> <replaceable>option</replaceable></entry>
1289 <entry>pass <replaceable>option</replaceable> to the linker</entry>
1290 <entry>static</entry>
1294 <entry><option>-optdll</option> <replaceable>option</replaceable></entry>
1295 <entry>pass <replaceable>option</replaceable> to the DLL generator</entry>
1296 <entry>static</entry>
1300 <entry><option>-optdep</option> <replaceable>option</replaceable></entry>
1301 <entry>pass <replaceable>option</replaceable> to the dependency generator</entry>
1302 <entry>static</entry>
1311 <title>Platform-specific options (<xref linkend="options-platform">)</title>
1314 <tgroup cols=3 align=left colsep=1 rowsep=1>
1318 <entry>Description</entry>
1319 <entry>Static/Dynamic</entry>
1320 <entry>Reverse</entry>
1325 <entry><option>-mv8</option></entry>
1326 <entry>(SPARC only) enable version 8 support</entry>
1327 <entry>static</entry>
1331 <entry><option>-monly-[32]-regs</option></entry>
1332 <entry>(x86 only) give some registers back to the C compiler</entry>
1333 <entry>dynamic</entry>
1343 <title>External core file options (<xref linkend="ext-core">)</title>
1346 <tgroup cols=3 align=left colsep=1 rowsep=1>
1350 <entry>Description</entry>
1351 <entry>Static/Dynamic</entry>
1352 <entry>Reverse</entry>
1357 <entry><option>-fext-core</option></entry>
1358 <entry>Generate <filename>.hcr</filename> external Core files</entry>
1359 <entry>static</entry>
1369 <title>Compiler debugging options (<xref linkend="options-debugging">)</title>
1372 <tgroup cols=3 align=left colsep=1 rowsep=1>
1376 <entry>Description</entry>
1377 <entry>Static/Dynamic</entry>
1378 <entry>Reverse</entry>
1383 <entry><option>-dcore-lint</option></entry>
1384 <entry>Turn on internal sanity checking</entry>
1385 <entry>dynamic</entry>
1389 <entry><option>-ddump-absC</option></entry>
1390 <entry>Dump abstract C</entry>
1391 <entry>dynamic</entry>
1395 <entry><option>-ddump-asm</option></entry>
1396 <entry>Dump assembly</entry>
1397 <entry>dynamic</entry>
1401 <entry><option>-ddump-bcos</option></entry>
1402 <entry>Dump interpreter byte code</entry>
1403 <entry>dynamic</entry>
1407 <entry><option>-ddump-cpranal</option></entry>
1408 <entry>Dump output from CPR analysis</entry>
1409 <entry>dynamic</entry>
1413 <entry><option>-ddump-cse</option></entry>
1414 <entry>Dump CSE output</entry>
1415 <entry>dynamic</entry>
1419 <entry><option>-ddump-deriv</option></entry>
1420 <entry>Dump deriving output</entry>
1421 <entry>dynamic</entry>
1425 <entry><option>-ddump-ds</option></entry>
1426 <entry>Dump desugarer output</entry>
1427 <entry>dynamic</entry>
1431 <entry><option>-ddump-flatC</option></entry>
1432 <entry>Dump “flat” C</entry>
1433 <entry>dynamic</entry>
1437 <entry><option>-ddump-foreign</option></entry>
1438 <entry>Dump <literal>foreign export</literal> stubs</entry>
1439 <entry>dynamic</entry>
1443 <entry><option>-ddump-inlinings</option></entry>
1444 <entry>Dump inlining info</entry>
1445 <entry>dynamic</entry>
1449 <entry><option>-ddump-occur-anal</option></entry>
1450 <entry>Dump occurrence analysis output</entry>
1451 <entry>dynamic</entry>
1455 <entry><option>-ddump-parsed</option></entry>
1456 <entry>Dump parse tree</entry>
1457 <entry>dynamic</entry>
1461 <entry><option>-ddump-realC</option></entry>
1462 <entry>Dump “real” C</entry>
1463 <entry>dynamic</entry>
1467 <entry><option>-ddump-rn</option></entry>
1468 <entry>Dump renamer output</entry>
1469 <entry>dynamic</entry>
1473 <entry><option>-ddump-rules</option></entry>
1474 <entry>Dump rules</entry>
1475 <entry>dynamic</entry>
1479 <entry><option>-ddump-sat</option></entry>
1480 <entry>Dump saturated output</entry>
1481 <entry>dynamic</entry>
1485 <entry><option>-ddump-simpl</option></entry>
1486 <entry>Dump final simplifier output</entry>
1487 <entry>dynamic</entry>
1491 <entry><option>-ddump-simpl-iterations</option></entry>
1492 <entry>Dump output from each simplifier iteration</entry>
1493 <entry>dynamic</entry>
1497 <entry><option>-ddump-spec</option></entry>
1498 <entry>Dump specialiser output</entry>
1499 <entry>dynamic</entry>
1503 <entry><option>-ddump-stg</option></entry>
1504 <entry>Dump final STG</entry>
1505 <entry>dynamic</entry>
1509 <entry><option>-ddump-stranal</option></entry>
1510 <entry>Dump strictness analyser output</entry>
1511 <entry>dynamic</entry>
1515 <entry><option>-ddump-tc</option></entry>
1516 <entry>Dump typechecker output</entry>
1517 <entry>dynamic</entry>
1521 <entry><option>-ddump-types</option></entry>
1522 <entry>Dump type signatures</entry>
1523 <entry>dynamic</entry>
1527 <entry><option>-ddump-usagesp</option></entry>
1528 <entry>Dump UsageSP analysis output</entry>
1529 <entry>dynamic</entry>
1533 <entry><option>-ddump-worker-wrapper</option></entry>
1534 <entry>Dump worker-wrapper output</entry>
1535 <entry>dynamic</entry>
1539 <entry><option>-ddump-rn-trace</option></entry>
1540 <entry>Trace renamer</entry>
1541 <entry>dynamic</entry>
1545 <entry><option>-ddump-rn-stats</option></entry>
1546 <entry>Renamer stats</entry>
1547 <entry>dynamic</entry>
1551 <entry><option>-ddump-stix</option></entry>
1552 <entry>Native code generator intermediate form</entry>
1553 <entry>dynamic</entry>
1557 <entry><option>-ddump-simpl-stats</option></entry>
1558 <entry>Dump simplifier stats</entry>
1559 <entry>dynamic</entry>
1563 <entry><option>-dppr-debug</option></entry>
1564 <entry>Turn on debug printing (more verbose)</entry>
1565 <entry>static</entry>
1569 <entry><option>-dppr-noprags</option></entry>
1570 <entry>Don't output pragma info in dumps</entry>
1571 <entry>static</entry>
1575 <entry><option>-dppr-user-length</option></entry>
1576 <entry>Set the depth for printing expressions in error msgs</entry>
1577 <entry>static</entry>
1581 <entry><option>-dsource-stats</option></entry>
1582 <entry>Dump haskell source stats</entry>
1583 <entry>dynamic</entry>
1587 <entry><option>-dstg-lint</option></entry>
1588 <entry>STG pass sanity checking</entry>
1589 <entry>dynamic</entry>
1593 <entry><option>-dstg-stats</option></entry>
1594 <entry>Dump STG stats</entry>
1595 <entry>dynamic</entry>
1599 <entry><option>-dusagesp-lint</option></entry>
1600 <entry>UsageSP sanity checker</entry>
1601 <entry>dynamic</entry>
1605 <entry><option>-dverbose-core2core</option></entry>
1606 <entry>Show output from each core-to-core pass</entry>
1607 <entry>dynamic</entry>
1611 <entry><option>-dverbose-stg2stg</option></entry>
1612 <entry>Show output from each STG-to-STG pass</entry>
1613 <entry>dynamic</entry>
1617 <entry><option>-unreg</option></entry>
1618 <entry>Enable unregisterised compilation</entry>
1619 <entry>static</entry>
1628 <title>Misc compiler options</title>
1631 <tgroup cols=3 align=left colsep=1 rowsep=1>
1635 <entry>Description</entry>
1636 <entry>Static/Dynamic</entry>
1637 <entry>Reverse</entry>
1642 <entry><option>-funfold-casms-in-hi-file</option></entry>
1643 <entry>Allow casms in unfoldings</entry>
1644 <entry>static</entry>
1648 <entry><option>-femit-extern-decls</option></entry>
1650 <entry>static</entry>
1654 <entry><option>-fglobalise-toplev-names</option></entry>
1655 <entry>Make all top-level names global (for <option>-split-objs</option>)</entry>
1656 <entry>static</entry>
1660 <entry><option>-fno-hi-version-check</option></entry>
1661 <entry>Don't complain about <literal>.hi</literal> file mismatches</entry>
1662 <entry>static</entry>
1666 <entry><option>-dno-black-holing</option></entry>
1667 <entry>Turn off black holing (probably doesn't work)</entry>
1668 <entry>static</entry>
1672 <entry><option>-fno-method-sharing</option></entry>
1673 <entry>Don't share specialisations of overloaded functions</entry>
1674 <entry>static</entry>
1678 <entry><option>-fno-prune-decls</option></entry>
1679 <entry>Renamer: don't prune declarations</entry>
1680 <entry>static</entry>
1684 <entry><option>-fno-prune-tydecls</option></entry>
1685 <entry>Renamer: don't prune type declarations</entry>
1686 <entry>static</entry>
1690 <entry><option>-fhistory-size</option></entry>
1691 <entry>Set simplification history size</entry>
1692 <entry>static</entry>
1696 <entry><option>-funregisterised</option></entry>
1697 <entry>Unregisterised compilation (use <option>-unreg</option> instead)</entry>
1698 <entry>static</entry>
1702 <entry><option>-fno-asm-mangling</option></entry>
1703 <entry>Turn off assembly mangling (use <option>-unreg</option> instead)</entry>
1704 <entry>static</entry>
1718 , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) )
1719 , ( "Rghc-timing" , NoArg (enableTimingStats) )
1725 ;;; Local Variables: ***
1727 ;;; sgml-parent-document: ("users_guide.sgml" "book" "chapter") ***