gcc/doc/gcc/gcc-command-options/machine-dependent-options/amd-gcn-options.rst

   1 ..
   2   Copyright 1988-2022 Free Software Foundation, Inc.
   3   This is part of the GCC manual.
   4   For copying conditions, see the copyright.rst file.
   5
   6 .. program:: AMD GCN
   7
   8 .. index:: AMD GCN Options
   9
  10 .. _amd-gcn-options:
  11
  12 AMD GCN Options
  13 ^^^^^^^^^^^^^^^
  14
  15 These options are defined specifically for the AMD GCN port.
  16
  17 .. option:: -march={gpu}
  18
  19   Set architecture type or tuning for :samp:`{gpu}`. Supported values for :samp:`{gpu}`
  20   are
  21
  22   :samp:`fiji`
  23     Compile for GCN3 Fiji devices (gfx803).
  24
  25   :samp:`gfx900`
  26     Compile for GCN5 Vega 10 devices (gfx900).
  27
  28   :samp:`gfx906`
  29     Compile for GCN5 Vega 20 devices (gfx906).
  30
  31   :samp:`gfx908`
  32     Compile for CDNA1 Instinct MI100 series devices (gfx908).
  33
  34   :samp:`gfx90a`
  35     Compile for CDNA2 Instinct MI200 series devices (gfx90a).
  36
  37 .. option:: -msram-ecc=on
  38
  39   Compile binaries suitable for devices with the SRAM-ECC feature enabled,
  40   disabled, or either mode.  This feature can be enabled per-process on some
  41   devices.  The compiled code must match the device mode. The default is
  42   :samp:`any`, for devices that support it.
  43
  44 .. option:: -mstack-size={bytes}
  45
  46   Specify how many :samp:`{bytes}` of stack space will be requested for each GPU
  47   thread (wave-front).  Beware that there may be many threads and limited memory
  48   available.  The size of the stack allocation may also have an impact on
  49   run-time performance.  The default is 32KB when using OpenACC or OpenMP, and
  50   1MB otherwise.
  51
  52 .. option:: -mxnack
  53
  54   Compile binaries suitable for devices with the XNACK feature enabled.  Some
  55   devices always require XNACK and some allow the user to configure XNACK.  The
  56   compiled code must match the device mode.  The default is :samp:`-mno-xnack`.
  57   At present this option is a placeholder for support that is not yet
  58   implemented.