<?xml version="1.0"?>
<!DOCTYPE flagsdescription
    SYSTEM "http://www.spec.org/dtd/cpuflags1.dtd"
>

<flagsdescription>

<!-- filename to begin with "hp-20060621-ic91-flags" -->
<filename>hp-20060621-ic91-flags</filename>

<title>SPEC CPU2006 Flag Description for the Intel(R) C++ Compiler 9.1
for 32-bit applications and Intel(R) Fortran Compiler 9.1 for 32-bit
applications</title>


   <header>
      <![CDATA[
         <div style="font-weight: bold; font-size: larger; margin-left: 2em"> <h3 style="text-indent: -2em">Compilers:</h3>
         <p>Intel Compilers for C++ and Fortran, Version 9.1; Copyright &copy; 2006 Intel Corporation. All Rights Reserved.</p>
         </div>
         
         <hr />

      ]]>
   </header>

<!--
******************************************************************************************************
* Compilers
******************************************************************************************************
-->

<flag name="intel_icl" class="compiler" regexp="(?:/\S+/)?icl\b">

   <![CDATA[
      <p>Invoke the Intel C/C++ compiler for 32 bit applications in MS VC 
      .Net 2003 compatibility mode</p>
   ]]>

</flag>

<flag name="intel_ifort" class="compiler" regexp="(?:/\S+/)?ifort\b">
      Invoke the Intel Fortran compiler for 32 bit applications
</flag>


<flag name="intel_compiler_c99_mode" class="compiler" regexp="(?:/\S+/)?-Qc99\b">
      Invoke the Intel C compiler in C99 mode
</flag>


<flag name="intel_ms.net2003_compatibility" class="compiler" regexp="(?:/\S+/)?-Qvc7.1\b">
      Invoke the Intel C and C++ compilers in .Net 2003 compatibility mode
</flag>

<!--
******************************************************************************************************
* Portability
******************************************************************************************************
-->
<flag name="lowercase_routine_name" class="portability" regexp="(?:/\S+/)?-Qlowercase\b">

   <![CDATA[
      <p>For mixed-language benchmarks, tell the compiler to convert routine names to 
      lowercase for compatibility</p>
   ]]>

</flag>

<flag name="add-underscore_to_routine_name" class="portability" regexp="(?:/\S+/)?\/assume\:underscore\b">

   <![CDATA[
      <p>For mixed-language benchmarks, tell the compiler to assume that routine 
      name end with an underscore</p>
   ]]>

</flag>

<flag name="assume_cplusplus_sources" class="portability" regexp="(?:/\S+/)?-TP\b">
      Tell the compiler to treat source files as C++
</flag>

<!--
******************************************************************************************************
* Optimizations
******************************************************************************************************
-->
<flag name="f-O1" class="optimization" regexp="-O1\b">
      
   <![CDATA[
      <p>optimize for speed, but disable some optimizations which increase 
      code size for a small speed benefit. Includes inline expansion 
      except for intrinsic functions, global optimizations, string 
      pooling optimizations.  On IA-32 Windows platforms, -O1 sets the 
      following:</p>
         <p style="margin-left: 25px">
         /Qunroll0, /Oi-, /Op-, /Oy, /Gy, /Os, /GF (/Qvc7 and above), 
         /Gf (/Qvc6 and below), /Ob2, and /Og</p>
   ]]>

   <include flag="f-Qunroll_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-O2" class="optimization" regexp="-O2\b">

   <![CDATA[
      <p>This is the default level of optimization.  
      Optimizes for speed. The -O2 option includes O1 optimizations 
      and in addition enables inlining of intrinsics and more speed 
      optimizations. On IA-32 Windows platforms, -O2 sets the 
      following:</p>
         <p style="margin-left: 25px">
         /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-O3" class="optimization" regexp="-O3\b">

   <![CDATA[
      <p>Builds on -01 and -02 optimizations by enabling high-level 
      optimization. This level does not guarantee higher performance 
      unless loop and memory access transformation take place. In 
      conjunction with -QaxK/-QxK and QaxW/QxW, this switch causes the 
      compiler to perform more aggressive data dependency analysis than 
      for -O2. This may result in longer compilation times. On IA-32 
      Windows platforms, -O3 sets the following:</p>
         <p style="margin-left: 25px">
         /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-Qip" class="optimization" regexp="-Qip\b">
enable single-file IP optimizations 
           (within files, same as -Ob2)
</flag>

<flag name="f-Qipo" class="optimization" regexp="-Qipo\b">
   <![CDATA[
      <p>Multi-file ip optimizations that includes:<br />
       - inline function expansion<br />
       - interprocedural constant propogation<br />
       - dead code elimination<br />
       - propagation of function characteristics<br />
       - passing arguments in registers<br />
       - loop-invariant code motion</p>
   ]]> 
</flag>

<flag name="f-fast" class="optimization" regexp="-fast\b">

   <![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 style="text-indent: -45px;margin-left: 45px">
      -O3&nbsp;&nbsp;&nbsp;(maximum speed and high-level optimizations)</p>
      <p style="text-indent: -45px;margin-left: 45px"> 
      -Qipo&nbsp;(enables interprocedural optimizations across files)</p>
      <p style="text-indent: -45px;margin-left: 45px">  
      -QxP&nbsp;&nbsp;(generate code specialized for Intel Pentium 4 processor 
             and compatible Intel processors with Streaming SIMD Extensions 3)</p>
      <p style="text-indent: -45px;margin-left: 45px"> 
      -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 options set by /fast may change from 
      release to release.</p>
   ]]> 

   <include flag="f-O3" />
   <include flag="f-Qipo"  />
   <include flag="f-QxP"  />
   <include flag="f-Qprec-div-"  />
</flag>

<flag name="f-QxP" class="optimization" regexp="-Qx[PN]\b">

   <![CDATA[
      <p>The -QxN and -QxP options target your program to run on Intel Pentium 4
      and compatible Intel processors.  The resulting code might contain 
      unconditional use of features that are not supported on other processors. 
      Programs, where the function main() is compiled with this option, will 
      detect non compatible processors and generate an error message during 
      execution. This option also enables new optimizations in addition to Intel 
      processor specific optimizations.</p>

      <p>These options also enable advanced data layout and code restructuring 
      optimizations to improve memory accesses for Intel processors.</p>
   ]]> 

</flag>

<flag name="f-Qprec-div-" class="optimization" regexp="-Qprec-div-\b">
(disable -Qprec-div)
                
   <![CDATA[
      <p>Allows the compiler to perform optimizations in FP divides that may 
      impact precision while improving speed.</p>
   ]]> 

</flag>

<flag name="prof_gen" class="optimization" regexp="-Qprof_gen\b">

   <![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="prof_use" class="optimization" regexp="-Qprof_use\b">

   <![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, -Qprof_use merges 
      the dynamic information files again and overwrites the 
      previous pgopti.dpi file.<br />
      Without any other options, the current directory is 
      searched for .dyn files</p>
   ]]> 
      
</flag>

<flag name="f-Qcxx_features" class="optimization" regexp="-Qcxx_features\b">

   <![CDATA[
      <p>Enable C++ Exception Handling and RTTI<br />
      This option has the same effect as specifying /GX /GR.</p>
   ]]> 

<include flag="f-GX" />
<include flag="f-GR" />
 
</flag>

<flag name="f-GX" class="optimization" regexp="-GX\b">
      This option enables C++ exception handling.    
</flag>

<flag name="f-GR" class="optimization" regexp="-GR\b">
      Enables C++ Run Time Type Information (RTTI).    
</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="SmartHeap" class="optimization" regexp="shlw32m.lib\b">

   <![CDATA[
      <p>MicroQuill SmartHeap Library 7.4 available from http://www.microquill.com/</p>
   ]]> 

</flag>

<flag name="set_stack_space" class="optimization" regexp="(?:/\S+/)?/F\d*">
      set the stack reserve amount specified to the linker 
</flag>

<flag name="f-Qunroll_n" class="optimization" regexp="-Qunroll\d+\b">
      Tells the compiler the maximum number of times to unroll loops. 
</flag>

<flag name="f-Oi-" class="optimization" regexp="-Oi-\b">
      Disables inline expansion of all intrinsic functions. 
</flag>

<flag name="f-Op-" class="optimization" regexp="-Oi-\b">

   <![CDATA[
      <p>Disables conformance to the ANSI C and IEEE 754 standards for 
      floating-point arithmetic.</p>
   ]]> 
 
</flag>

<flag name="f-Oy" class="optimization" regexp="-Oy\b">
      Allows use of EBP as a general-purpose register in optimizations.  
</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">
      This option enables global optimizations.  
</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 style="text-indent: -45px;margin-left: 45px">
         Ob0 - Disables inlining of user-defined functions. Note that 
               statement functions are always inlined.</p>
         <p style="text-indent: -45px;margin-left: 45px">
         Ob1 - Enables inlining when an inline keyword or an inline 
               attribute is specified. Also enables inlining according 
               to the C++ language.</p>
         <p style="text-indent: -45px;margin-left: 45px">
         Ob2 - Enables inlining of any function at the compiler's 
               discretion. </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-GF" class="optimization" regexp="-GF\b">
      This option enables read only string-pooling optimization.   
</flag>

<flag name="f-Gf" class="optimization" regexp="-Gf\b">
      This option enables read/write string-pooling optimization.    
</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>

</flagsdescription>

