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

<!-- =====================================================================
  Information about the meaning of boot-time settings, BIOS options,
  kernel tuning, and so forth go in this separate 'platform_settings' file.

  They'll be appended to the end of both the flags dump and per-result flag report.

  As the contents should be HTML, it will save lots of time to just enclose
  the whole thing in a CDATA section.  Section 2.3.1 again.

  NOTE that these should be vendor, or platform, specific and thus the file
  should be named in a way to identify which platform was used.  For example,
  one could replace the string Example with the vendor name in the filename,
  i.e. ACME-linux-platform-revA.xml.
     ===================================================================-->

<!-- This file defines platform settings -->
<flagsdescription>

<filename>GIGA-BYTE-Platform-SPECcpu2017-Flags-V1.2-Milan.xml</filename>

<title>SPEC CPU2017 Platform Settings for GIGA-BYTE</title>

<!-- Platform Settings -->
<os_tuning>
<![CDATA[
<dl>
  <dt><b>kernel.randomize_va_space</b> (ASLR)</dt>
  <dd>
    This setting can be used to select the type of process address space
    randomization. Defaults differ based on whether the architecture supports
    ASLR, whether the kernel was built with the CONFIG_COMPAT_BRK
    option or not, or the kernel boot options used.<br />
    Possible settings:
    <ul>
      <li>0: Turn process address space randomization off.</li>
      <li>1: Randomize addresses of mmap base, stack, and VDSO pages.</li>
      <li>2: Additionally randomize the heap. (This is probably the default.)</li>
    </ul>
    Disabling ASLR can make process execution more deterministic and runtimes more consistent.
    For more information see the <tt>randomize_va_space</tt> entry in the
    <a href="https://www.kernel.org/doc/Documentation/sysctl/kernel.txt">Linux sysctl
    documentation</a>.
  </dd>
  <dt><b>Transparent Hugepages (THP)</b></dt>
  <dd>
    THP is an abstraction layer that automates most aspects of creating, managing,
    and using huge pages. It is designed to hide much of the complexity in using
    huge pages from system administrators and developers.  Huge pages
    increase the memory page size from 4 kilobytes to 2 megabytes. This provides
    significant performance advantages on systems with highly contended resources
    and large memory workloads. If memory utilization is too high or memory is badly
    fragmented which prevents hugepages being allocated, the kernel will assign
    smaller 4k pages instead. Most recent Linux OS releases have THP enabled by default.<br />
    THP usage is controlled by the sysfs setting <tt>/sys/kernel/mm/transparent_hugepage/enabled</tt>.
    Possible values:
    <ul>
      <li>never: entirely disable THP usage.</li>
      <li>madvise: enable THP usage only inside regions marked MADV_HUGEPAGE using madvise(3).</li>
      <li>always: enable THP usage system-wide. This is the default.</li>
    </ul>
    THP creation is controlled by the sysfs setting <tt>/sys/kernel/mm/transparent_hugepage/defrag</tt>.
    Possible values:
    <ul>
      <li>never: if no THP are available to satisfy a request, do not attempt to make any.</li>
      <li>defer: an allocation requesting THP when none are available get normal pages while requesting THP creation in the background.</li>
      <li>defer+madvise: acts like "always", but only for allocations in regions marked MADV_HUGEPAGE using madvise(3); for all other regions it's like "defer".</li>
      <li>madvise: acts like "always", but only for allocations in regions marked MADV_HUGEPAGE using madvise(3).  This is the default.</li>
      <li>always: an allocation requesting THP when none are available will stall until some are made.</li>
    </ul>
    An application that "always" requests THP often can benefit from waiting for an allocation until those huge pages can be assembled.<br/>
    For more information see the <a href="https://www.kernel.org/doc/Documentation/vm/transhuge.txt">Linux transparent hugepage documentation</a>.
  </dd>
</dl>
]]>
</os_tuning>

<firmware>
<![CDATA[
<dl>

  <dt><b>Determinism Slider: (Default = Power)</b></dt>
  <dd>
      Selects the determinism mode for the CPU:
    <ul>
      <li>Power: Maximizes performance within the power limits defined by cTDP and PPT.</li>
      <li>Performance: Provides predictable performance across all processors of the same type.</li>
    </ul>
  </dd>

  <dt><b>cTDP Control:(Default = 280)</b></dt>
  <dd>
      Configures the maximum power that the CPU will consume, up to the
      platform power limit (PPT).  Valid values vary by CPU model.  If value
      outside the valid range is set, the CPU will automatically adjust the
      value so that it does fall within the valid range.  When increasing cTDP,
      additional power will only be consumed up to the Package Power Limit
      (PPT), which may be less than the cTDP setting.<br />
      <table>
        <tr><th>Model</th><th>Minimum cTDP</th><th>Maximum cTDP</th></tr>
        <tr><td>EPYC 7763</td><td>225</td><td>280</td></tr>
        <tr><td>EPYC 7713</td><td>225</td><td>240</td></tr>
      </table>
  </dd>

  <dt><b>Package Power Limit (PPT) Control:(Default = 280)</b></dt>
  <dd>
      Specifies the maximum power that each CPU package may consume in the system.  The actual power limit is the maximum of the Package Power Limit and cTDP.
      <table>
        <tr><th>Model</th><th>Minimum cTDP</th><th>Maximum cTDP</th></tr>
        <tr><td>EPYC 7763</td><td>225</td><td>280</td></tr>
        <tr><td>EPYC 7713</td><td>225</td><td>240</td></tr>
      </table>
  </dd>

  <dt><b>NUMA nodes per socket:(Default = NPS4)</b></dt>
  <dd>
      Specifies the number of desired NUMA nodes per populated socket in the system:
    <ul>
      <li>NPS1: Each physical processor is a NUMA node, and memory accesses are interleaved across all memory channels directly connected to the physical processor.</li>
      <li>NPS2: Each physical processor is two NUMA nodes, and memory accesses are interleaved across 4 memory channels.</li>
      <li>NPS4: Each physical processor is four NUMA nodes, and memory accesses are interleaved across 2 memory channels.</li>
    </ul>
  </dd>

  <dt><b>SMT Mode: (Default = Enabled)</b></dt>
  <dd>
    Can be used to disable symmetric multithreading. To re-enable SMT, a POWER CYCLE is needed after selecting the 'Auto' option. WARNING - S3 is NOT SUPPORTED on systems where SMT is disabled.
  </dd>

  <dt><b>IOMMU: (Default = Enabled)</b></dt>
  <dd>
    Enable: Enables the I/O Memory Management Unit (IOMMU), which extends the AMD64 system architecture by adding support for address translation and system memory access protection on DMA transfers from peripheral devices.
  </dd>

  <dt><b>4-link xGMI max speed:(Default = 16Gbps)</b></dt>
  <dd>
      xGMI (Global Memory Interface) is the Socket SP3 processor socket-to-socket interconnection topology comprised of four x16 links.
      Each x16 link is comprised of 16 lanes. Each lane is comprised of two unidirectional differential signals.
      Since xGMI is the interconnection between processor sockets, these xGMI settings are not applicable for 1S platforms.
      NUMA-unaware workloads may need maximum xGMI bandwidth/speed while other compute efficient platforms may need to minimize xGMI power.
      The xGMI speed can be lowered, lane width can be reduced from x16 to x8 (or x2), or an xGMI link can be disabled if power consumption is too high.
    <br />
      The default value for this option on Milan platforms is "Auto" which corresponds to "16Gbps".  On platforms that support higher speeds, it can be raised to increase performance on workloads that benefit from higher cross-socket bandwidth at the cost of some additional power consumption.
  </dd>


</dl>

]]>
</firmware>

</flagsdescription>
