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

<!--  flags file for Intel 9.1 compilers on IPF/Linux -->
<!--  last modified 1/19/2007                         -->

<flagsdescription>

<!-- filename to begin with "Intel-ic91-flags-file" -->
<filename>IPF_intel91_flags</filename>

<title>SPEC CPU2006 Flag Description for the Intel(R) C++ Compiler 9.1
and the Intel(R) Fortran Compiler 9.1 for IPF Linux64 </title>

<header>
<![CDATA[
<p style="text-align: left; color: red; font-size: larger; background-color: black">
 Copyright &copy; 2006 Intel Corporation.  All Rights Reserved.</p>
]]>
</header>

<platform_settings>
<![CDATA[
<p>maxcpus=0 
<br>
Linux boot-time kernel parameter.  A command-line option of nosmp or maxcpus=0 will 
disable SMP activation entirely; maxcpus=N limits the maximum number of CPUs activated in SMP mode to 
N.  See bootparam(7).
</p>
<p>Additional Notes on partitions and local memory:
<br>
The HP Integrity rx7640, rx8640, and Superdome systems
may be configured as one large system or as multiple independent smaller systems via hard parititions 
(nPars).  Each hard partition consists of one or more cells with their associated processors, memory, 
and I/O chassis, and is isolated from events in other partitions.  The memory within a partition can 
either be assigned to local memory pools for each cell,  or assigned to an interleaved pool that is
distributed by cache line across the cells.  Partitions and their attributes can be created and 
modified via the support management station, or via the nPartition (par*) commands running on an 
os instance in a system partition.
</p>
]]>
</platform_settings>

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

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

   <![CDATA[
      <p>Invoke the Intel C++ compiler for IPF Linux64 to compile C applications</p>
   ]]>

</flag>

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

   <![CDATA[
      <p>Invoke the Intel C++ compiler for IPF Linux64 to compiler C++ applications</p>
   ]]>

</flag>

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


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


<!--

******************************************************************************************************
* Other (diagnostic message control)
******************************************************************************************************
-->
<flag name="f-w" class="other" regexp="-w\b">

Disable all warnings. Display error messages only. 

</flag>


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

   <![CDATA[
      <p>For mixed-language benchmarks, tell the compiler that the main program is not written in Fortran </p>
   ]]>

</flag>

<!--
******************************************************************************************************
* Optimizations
******************************************************************************************************
-->
<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 IPF Linux64 platforms, -O1 disable software pipelining and global code scheduling.

         On Intel Itanium processors, this option also enables optimizations for server applications <br />
         (straight-line and branch-like code with a flat profile). 
</p>
         <p style="margin-left: 25px">
         -unroll0, -fbuiltin, -mno-ieee-fp, -fomit-frame-pointer (same as -fp), -ffunction-sections </p>
   ]]>

   <include flag="f-unrolln"/>
   <include flag="f-builtin"/>
   <include flag="f-mno-ieee-fp"/>
   <include flag="f-fomit-frame-pointer"/>
   <include flag="f-ffunction-sections"/>
   
</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>
   ]]> 

   <include flag="f-O1"/>

</flag>

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

   <![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 Intel Itanium processors, the O3 option enables optimizations 
         for technical computing applications (loop-intensive code): <br />
         loop optimizations and data prefetch.

         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. 
         </p>
   ]]> 
 
   <include flag="f-O2"/>

</flag>

<flag name="f-ip" class="optimization" regexp="-ip\b">
This option enables additional interprocedural optimizations for single 
file compilation. These optimizations are a subset of full intra-file 
interprocedural optimizations. One of these optimizations enables the 
compiler to perform inline function expansion for calls to functions 
defined within the current source file.
</flag>

<flag name="f-ipo" class="optimization" regexp="-ipo\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"> 
      -ipo&nbsp;(enables interprocedural optimizations across files)</p>
      <p style="text-indent: -45px;margin-left: 45px"> 
      -static&nbsp;(link libraries statically)</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-ipo"/>
   <include flag="f-static"/>   
</flag>

<flag name="f-prof_gen" class="optimization" regexp="-prof_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="f-prof_use" class="optimization" regexp="-prof_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-unrolln" class="optimization" regexp="-unroll\d+\b">
      Tells the compiler the maximum number of times (n) to unroll loops. 
</flag>

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

<flag name="f-mno-ieee-fp" 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-fomit-frame-pointer" class="optimization" regexp="-Oy\b">
      Allows use of EBP as a general-purpose register in optimizations.  
</flag>

<flag name="f-ffunction-sections" class="optimization" regexp="-Os\b">

   <![CDATA[
      <p>Places each function in its own COMDAT section.</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 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-static" class="optimization" regexp="-static\b">

   <![CDATA[
      <p>-static prevents linking with shared libraries. </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>

<flag name="link_force_multiple1" class="optimization" regexp="\b\-Fe\$\@\-link\b">

      Enable SmartHeap library usage by forcing the linker to 
      ignore multiple definitions 
</flag>

<flag name="link_force_multiple2" class="optimization" regexp=".*FORCE.*MULTIPLE\b">

      Enable SmartHeap library usage by forcing the linker to 
      ignore multiple definitions 
</flag>

<flag name="inline-factor" class="optimization" regexp="-inline-factor=(\S+)\b">
<example>-inline-factor=n </example>
      Specifies  the  percentage multiplier that should be applied to all inlining 
      options that define upper limits: -inline-max-size, -inline-max-total-size, 
      -inline-max-per-routine,  and   -inline-max-per-compile.

      This  option  takes  the  default  value  for each of the above options 
      and multiplies it by n divided by 100. For example, if 200 is specified, 
      all inlining options that define upper  limits are multiplied by a factor of 2.

      n is a positive integer specifying the percentage value. The default value 
      is 100 (a factor of 1).

</flag>


<flag name="no-prefetch" class="optimization" regexp="-no-prefetch\b">

      Disables the insertion of software prefetching by the compiler.

</flag>

<flag name="IPF_fp_relaxed" class="optimization" regexp="-IPF_fp_relaxed\b">
<![CDATA[
<p>
      Enables use of faster but slightly less accurate code sequences for math functions, 
      including sqrt, reciprocal sqrt, divide and reciprocal. When compared to strict IEEE* 
      precision, this option slightly reduces the accuracy of floating-point calculations 
      performed by these functions, usually limited to the least significant digit.
</p>
<p>
      This option also performs reassociation transformations, which can alter the order of 
      operations, over a larger scope.  The increased reasssociation enables generation of 
      more optimal sequences of Floating point Multiply Add instructions than not using 
      this option.  Note that use of Floating point Multiply Add can cause programs to 
      produce different numerical results due to changes in rounding. 
</p>
]]> 

</flag>

<flag name="ftn-ansi-alias" class="optimization" regexp="-ansi-alias\b" compilers="intel_ifort">

      Tells the compiler to assume the program does adhere to 
      to the Fortran  95  Standard  type
      aliasability rules (default).
      
</flag>

<flag name="fno-alias" class="optimization" regexp="-fno-alias\b">

       Specifies  that  aliasing  should  not be assumed in the program.

</flag>

<flag name="no-alias-args" class="optimization" regexp="-no-alias-args\b" compilers="intel_icc,intel_icpc">

       Do not assume arguments may be aliased.

</flag>

<flag name="ansi-alias" class="optimization" regexp="-ansi-alias\b" compilers="intel_icc,intel_icpc">

      Tells the compiler to assume the program does adhere to 
      the rules  defined  in the  ISO  C  Standard. The default is to not assume such
      adherence.   If your C/C++ program adheres to these
      rules, then -ansi-alias will allow the compiler to  optimize  
      more  aggressively.   If it doesn't adhere to these
      rules, then assuming so  can cause the compiler to generate  
      incorrect code.
</flag>

<flag name="linker_muldefs" class="optimization" regexp="-Wl,-z,muldefs\b">

       The -Wl option directs the compiler to pass a list of arguments
       to the linker.  In this case, "-z muldefs" is passed to the 
       linker.  For the Gnu linker (ld), the  "-z keyword" option accepts
       several recognized keywords. Keyword "muldefs" allows multiple 
       definitions.   The muldefs keyword will enable, for example, 
       linking with third party libraries like SmartHeap from
       Microquill.
</flag>

<flag name="SmartHeap" class="optimization" regexp="/opt/SmartHeap_8/lib/libsmartheap64.a\b">

      MicroQuill SmartHeap Library available from http://www.microquill.com/
</flag>

<flag name="SmartHeapC" class="optimization" regexp="/opt/SmartHeap_8/lib/libsmartheapC64.a\b">

      MicroQuill SmartHeap Library for C++ (must be linked with libsmartheap64.a).  
      available from http://www.microquill.com/
</flag>

<flag name="auto_ilp32" class="optimization" regexp="-auto_ilp32\b|-auto-ilp32\b" compilers="intel_icc,intel_icpc">

      Specifies that the application should run within a 32-bit address space.  
      Also  tells the compiler to use 32-bit pointers whenever possible. To use 
      this option, you must specify -ipo.
</flag>

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

      Enable the auto-parallelizer to generate multi-threaded code for loops 
      that can be safely executed  in  parallel. The -parallel option enables 
      the auto-parallelizer if  either the -O2 or -O3 optimization option is 
      also on (the default is -O2).

</flag>

<flag name="opt-mem-bandwidth" class="optimization" regexp="-opt-mem-bandwidth (\S+)\b">
<example>-opt-mem-bandwidth n</example>

      Enables  or  disables  performance tuning and heuristics that control memory
      bandwidth use among processors.  It allows the compiler to be  less  aggres-
      sive with optimizations that might consume more bandwidth, so that the band-
      width can be well-shared among multiple processors for a  parallel  program.
      For  values of n greater than 0, the option tells the compiler to enable a
      set of performance tuning and heuristics in compiler optimizations  such  as
      prefetching, privatization, aggressive code motion, and so forth, for reduc-
      ing memory bandwidth pressure and balancing memory bandwidth  traffic  among
      threads.   The  n  value  is  the level of optimizing for memory bandwidth
      usage. You can specify one of the following values for n:

      0 -- Disables a set of performance tuning and heuristics in  compiler  opti-
      mizations for parallel code.  This is the default for serial code.

      1  --  Enables  a set of performance tuning and heuristics in compiler opti-
      mizations for multithreaded code generated by the  compiler.   This  is  the
      default  if  compiler  option  -parallel or -openmp is specified, or Cluster
      OpenMP option -cluster-openmp is specified (see the Cluster OpenMP  documen-
      tation).

      2  --  Enables  a set of performance tuning and heuristics in compiler opti-
      mizations for parallel code such as Windows Threads, pthreads, and MPI code,
      besides multithreaded code generated by the compiler.

</flag>
</flagsdescription>

