Skip to content

[RISCV][doc] Document profiles in RISCVUsage #98326

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 10, 2024
Merged

[RISCV][doc] Document profiles in RISCVUsage #98326

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d704447
[RISCV][doc] Document profiles in RISCVUsage
asb Jul 10, 2024
8784306
Add note about appending extension names
asb Jul 10, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions llvm/docs/RISCVUsage.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,33 @@ To specify the target triple:
To select an E variant ISA (e.g. RV32E instead of RV32I), use the base
architecture string (e.g. ``riscv32``) with the extension ``e``.

Profiles
========

Supported profile names can be passed using ``-march`` instead of a standard
ISA naming string. Currently supported profiles:

* ``rvi20u32``
* ``rvi20u64``
* ``rva20u64``
* ``rva20s64``
* ``rva22u64``
* ``rva22s64``

Note that you can also append additional extension names to be enable, e.g.
``rva20u64_zicond`` will enable the ``zicond`` extension in addition to those
in the ``rva20u64`` profile.

Profiles that are not yet ratified cannot be used unless
``-menable-experimental-extensions`` (or equivalent for other tools) is
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are there tools that accept ISA strings rather than target feature lists but don't call their options -march and -menable-experimental-extensions? I'm drawing a blank but maybe I'm missing something obvious...

specified. This applies to the following profiles:

* ``rva23u64``
* ``rva23s64``
* ``rvb23u64``
* ``rvb23s64``
* ``rvm23u32``

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add a note about how to add additional extensions? e.g. rvi20u32_zicond

.. _riscv-extensions:

Extensions
Expand Down
Loading