summaryrefslogtreecommitdiff
path: root/Help/prop_tgt/HIP_ARCHITECTURES.rst
blob: 06f956b18e603ee4a29bdfb495ea75f378c93b47 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
HIP_ARCHITECTURES
-----------------

.. versionadded:: 3.21

List of AMD GPU architectures to generate device code for.

A non-empty false value (e.g. ``OFF``) disables adding architectures.
This is intended to support packagers and rare cases where full control
over the passed flags is required.

This property is initialized by the value of the :variable:`CMAKE_HIP_ARCHITECTURES`
variable if it is set when a target is created.

The HIP compilation model has two modes: whole and separable. Whole compilation
generates device code at compile time. Separable compilation generates device
code at link time. Therefore the ``HIP_ARCHITECTURES`` target property should
be set on targets that compile or link with any HIP sources.

Examples
^^^^^^^^

.. code-block:: cmake

  set_property(TARGET tgt PROPERTY HIP_ARCHITECTURES gfx801 gfx900)

Generates code for both ``gfx801`` and ``gfx900``.