<?xml version="1.0"?>
<!DOCTYPE flagsdescription
   SYSTEM "http://www.spec.org/dtd/cpuflags1.dtd"
>
<flagsdescription>
<filename>ic100.xml</filename>
<title>SPEC CPU2006 Flags Description for the Intel(R) Compiler v10.0</title>
<header><![CDATA[
<p>HITACHI Flags Description.</p>
]]></header>

<flag name="F-icl"
      class="compiler"
      regexp="(?:/\S+/)?icl\b">
<example>icl</example>
      <![CDATA[
      <p>Invoke the Intel C++ compiler for 32 bit applications</p>
      ]]>
</flag>

<flag name="F-ifort"
      class="compiler"
      regexp="(?:/\S+/)?ifort\b">
<example>ifort</example>
      <![CDATA[
      <p>Invoke the Intel Fortran compiler for 32 bit applications</p>
      ]]>
</flag>

<flag name="F-Qvc7.1"
      class="compiler">
<example>-Qvc7.1</example>
      <![CDATA[
      <p>Invoke the Intel C++ compiler in .NET 2003 compatibility mode</p>
      ]]>
</flag>

<flag name="F-Qc99"
      class="compiler">
<example>-Qc99</example>
      <![CDATA[
      <p>Invoke the Intel C++ compiler in C99 mode</p>
      ]]>
</flag>

<flag name="link_force_multiple1"
      class="optimization"
      regexp="\b\-Fe\$\@\-link\b">
      <![CDATA[ 
      <p>enable SmartHeap library usage by forcing the linker to ignore multiple definitions</p> 
      ]]> 
</flag>

<flag name="link_force_multiple2"
      class="optimization"
      regexp=".*FORCE.*MULTIPLE\b">
      <![CDATA[ 
      <p>enable SmartHeap library usage by forcing the linker to ignore multiple definitions</p>
      ]]> 
</flag>

<flag name="F-F512000000"
      class="optimization"
      regexp="(?:/\S+/)?/F\d*">
      <![CDATA[ 
      <p>set the stack reserve amount specified to the linker</p>
      ]]> 
</flag>

<flag name="F-shlw32m.lib"
      class="optimization"
      regexp="shlw32m.lib\b">
<example>shlw32m.lib</example> 
      <![CDATA[ 
      <p>MicroQuill SmartHeap library 8.0 for Windows</p>
      ]]> 
</flag>

<flag name="F-Qcxx_features"
      class="optimization">
<example>-Qcxx_features</example> 
      <![CDATA[ 
      <p>enable standard C++ features (-GX -GR)</p>
      ]]> 
<include flag="F-GX" /> 
<include flag="F-GR" /> 
</flag>

<flag name="F-fast"
      class="optimization">
<example>-fast</example>
      <![CDATA[
      <p>The -fast option enhances execution speed across the entire program by including the following options that can improve run-time performance:</p>
      <p>/O3&nbsp;&nbsp;&nbsp;(maximum speed and high-level optimizations)</p>
      <p>/Qipo&nbsp;(enables interprocedural optimizations across files)</p>
      <p>/QxT&nbsp;&nbsp;(generate code specialized for Intel(R) Core(TM)2 Duo processors, Intel(R) Core(TM)2 Quad processors and Intel(R) Xeon(R) processors with SSSE3)</p>
      <p>/Qprec-div-&nbsp;(disable /Qprec-div) where /Qprec-div improves precision of FP divides (some speed impact)</p>
      <p>To override one of the options set by /fast, specify that option after the -fast option on the command line. The exception is the xT or QxT option which can't be overridden. The options set by /fast may change from release to release.</p>
      ]]>
<include flag="F-O3" />
<include flag="F-Qipo" />
<include flag="F-QxT" />
<include flag="F-Qprec-div-" />
</flag>

<flag name="F-Qprof_gen"
      class="optimization">
<example>-Qprof_gen</example>
      <![CDATA[
      <p>Instrument program for profiling for the first phase of two-phase profile guided otimization. This instrumentation gathers information about a program's execution paths and data values but does not gather information from hardware performance counters. The profile instrumentation also gathers data for optimizations which are unique to profile-feedback optimization.</p>
      ]]>
</flag>

<flag name="F-Qprof_use"
      class="optimization">
<example>-Qprof_use</example>
      <![CDATA[
      <p>Instructs the compiler to produce a profile-optimized executable and merges available dynamic information (.dyn) files into a pgopti.dpi file. If you perform multiple executions of the instrumented program, -prof-use merges the dynamic information files again and overwrites the previous pgopti.dpi file.
Without any other options, the current directory is searched for .dyn files</p>
      ]]>
</flag>

<flag name="F-O3"
      class="optimization">
<example>/O3</example>
      <![CDATA[
      <p>Enables O2 optimizations plus more aggressive optimizations, 
         such as prefetching, scalar replacement, and loop and memory 
         access transformations. Enables optimizations for maximum speed,   
         such as: <br />
         - Loop unrolling, including instruction scheduling<br />
         - Code replication to eliminate branches<br />
         - Padding the size of certain power-of-two arrays to allow 
           more efficient cache use.<br />
         On IA-32 and Intel EM64T processors, when O3 is used with options 
         -ax or -x (Linux) or with options /Qax or /Qx (Windows), the compiler 
         performs more aggressive data dependency analysis than for O2, which 
         may result in longer compilation times. <br />
         The O3 optimizations may not cause higher performance unless loop and 
         memory access transformations take place. The optimizations may slow 
         down code in some cases compared to O2 optimizations.  <br />
         The O3 option is recommended for applications that have loops that heavily 
         use floating-point calculations and process large data sets. On IA-32 
         Windows platforms, -O3 sets the following:</p>
         <p>/GF (/Qvc7 and above), /Gf (/Qvc6 and below), and /Ob2</p>
      ]]>
<include flag="f-GF" />
<include flag="f-Gf" />
<include flag="f-Ob_n" />
<include flag="f-O2" />
</flag>

<flag name="F-QxT"
      class="optimization">
<example>/QxT</example>
      <![CDATA[
      <p>Code is optimized for Intel(R) Core(TM)2 Duo processors, Intel(R) Core(TM)2 Quad processors and Intel(R) Xeon(R) processors with SSSE3. The resulting code may contain unconditional use of features that are not supported on other processors. This option also enables new optimizations in addition to Intel processor-specific optimizations including advanced data layout and code restructuring optimizations to improve memory accesses for Intel processors.</p>
      <p>Do not use this option if you are executing a program on a processor that is not an Intel processor. If you use this option on a non-compatible processor to compile the main program (in Fortran) or the function main() in C/C++, the program will display a fatal run-time error if they are executed on unsupported processors.</p>
      ]]>
</flag>

<flag name="F-Qipo"
      class="optimization">
<example>/Qipo</example>
      <![CDATA[
      <p>enable multi-file Interprocedural Optimizations (between files)</p>
      ]]>
</flag>

<flag name="F-Qprec-div-"
      class="optimization">
<example>/Qprec-div-</example>
      <![CDATA[
      <p>improve speed of floating-point divides and disable improved precision of floating-point divides</p>
      ]]>
</flag>

<flag name="F-GX"
      class="optimization">
<example>-GX</example>
      <![CDATA[
      <p>enables C++ exception handling</p>
      ]]>
</flag>

<flag name="F-GR"
      class="optimization">
<example>-GR</example>
      <![CDATA[
      <p>enable C++ Run Time Type Information</p>
      ]]>
</flag>

<flag name="f-Ob_n"
      class="optimization"
      regexp="-Ob(0|1|2)\b">
      <![CDATA[
      <p>Specifies the level of inline function expansion.</p>
      <p>Ob0 - Disables inlining of user-defined functions. Note that 
               statement functions are always inlined.</p>
      <p>Ob1 - Enables inlining when an inline keyword or an inline 
               attribute is specified. Also enables inlining according 
               to the C++ language.</p>
      <p>Ob2 - Enables inlining of any function at the compiler's 
               discretion. </p>
      ]]>
</flag>

<flag name="f-GF"
      class="optimization"
      regexp="-GF\b">
      <![CDATA[
      <p>This option enables read only string-pooling optimization.</p>
      ]]>
</flag>

<flag name="f-Gf"
      class="optimization"
      regexp="-Gf\b">
      <![CDATA[
      <p>This option enables read/write string-pooling optimization.</p>
      ]]>
</flag>

<flag name="f-O2"
      class="optimization"
      regexp="/O2\b">
      <![CDATA[
      <p>Enables optimizations for speed. This is the generally recommended 
      optimization level. This option also enables: <br />
      - Inlining of intrinsics<br />
      - Intra-file interprocedural optimizations, which include: <br />
        - inlining<br />
        - constant propagation<br />
        - forward substitution<br />
        - routine attribute propagation<br />
        - variable address-taken analysis<br />
        - dead static function elimination<br />
        - removal of unreferenced variables<br />
      - The following capabilities for performance gain: <br /> 
        - constant propagation<br />
        - copy propagation<br />
        - dead-code elimination<br />
        - global register allocation<br />
        - global instruction scheduling and control speculation<br />
        - loop unrolling<br />
        - optimized code selection<br />
        - partial redundancy elimination<br />
        - strength reduction/induction variable simplification<br />
        - variable renaming<br />
        - exception handling optimizations<br />
        - tail recursions<br />
        - peephole optimizations<br />
        - structure assignment lowering and optimizations<br />
        - dead store elimination<br />
      </p>
      <p>On IA-32 Windows platforms, -O2 sets the following:</p>
      <p>/Og, /Oi-, /Os, /Oy, /Ob2, /GF (/Qvc7 and above), /Gf (/Qvc6 and below), /Gs, and /Gy.</p>
      ]]>
<include flag="f-Oi-" /> 
<include flag="f-Gs" /> 
<include flag="f-Oy" /> 
<include flag="f-Gy" /> 
<include flag="f-Os" /> 
<include flag="f-GF" /> 
<include flag="f-Gf" /> 
<include flag="f-Ob_n" /> 
<include flag="f-Og" /> 
<include flag="f-O1" /> 
</flag>

<flag name="f-Oi-"
      class="optimization"
      regexp="-Oi-">
      <![CDATA[
      <p>Disables inline expansion of all intrinsic functions.</p>
      ]]>
</flag>

<flag name="f-Gs"
      class="optimization"
      regexp="-Gs\b">
      <![CDATA[
      <p>This option disables stack-checking for routines with 4096 bytes of local variables and compiler temporaries.</p>
      ]]> 
</flag>

<flag name="f-Oy"
      class="optimization"
      regexp="-Oy\b">
      <![CDATA[
      <p>Allows use of EBP as a general-purpose register in optimizations.</p>
      ]]>
</flag>

<flag name="f-Gy"
      class="optimization"
      regexp="-Gy\b">
      <![CDATA[
      <p>This option tells the compiler to separate functions into COMDATs for the linker.</p>
      ]]> 
</flag>

<flag name="f-Os"
      class="optimization"
      regexp="-Os\b">
      <![CDATA[
      <p>This option enables most speed optimizations, but disables some that increase code size for a small speed benefit.</p>
      ]]> 
</flag>

<flag name="f-Og"
      class="optimization"
      regexp="-Og\b">
      <![CDATA[
      <p>This option enables global optimizations.</p>
      ]]>
</flag>

<flag name="f-O1"
      class="optimization"
      regexp="/O1\b">
      <![CDATA[
      <p>Enables optimizations for speed and disables some optimizations that <br />
         increase code size and affect speed. <br />
         To limit code size, this option: <br />
         - Enables global optimization; this includes data-flow analysis, 
           code motion, strength reduction and test replacement, split-lifetime
           analysis, and instruction scheduling. <br />
         - Disables intrinsic recognition and intrinsics inlining. <br />

         The O1 option may improve performance for applications with very large 
         code size, many branches, and execution time not dominated by code within loops. <br />
         
         On IA-32 Windows platforms, -O1 sets the following:</p>
         <p>/Qunroll0, /Oi-, /Op-, /Oy, /Gy, /Os, /GF (/Qvc7 and above), /Gf (/Qvc6 and below), /Ob2, and /Og</p>
         ]]>
<include flag="f-unroll_n" /> 
<include flag="f-Oi-" /> 
<include flag="f-Op-" /> 
<include flag="f-Oy" /> 
<include flag="f-Gy" /> 
<include flag="f-Os" /> 
<include flag="f-GF" /> 
<include flag="f-Gf" /> 
<include flag="f-Ob_n" /> 
<include flag="f-Og" /> 
</flag>

<flag name="f-unroll_n"
      class="optimization"
      regexp="-unroll\d+\b">
      <![CDATA[
      <p>Tells the compiler the maximum number of times to unroll loops.</p>
      ]]>
</flag>

<flag name="f-Op-"
      class="optimization"
      regexp="-Op-\b">
      <![CDATA[
      <p>Disables conformance to the ANSI C and IEEE 754 standards for floating-point arithmetic.</p>
      ]]> 
</flag>

</flagsdescription>

