derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
50 lines
1.5 KiB
ReStructuredText
50 lines
1.5 KiB
ReStructuredText
.. title:: clang-tidy - portability-simd-intrinsics
|
|
|
|
portability-simd-intrinsics
|
|
===========================
|
|
|
|
Finds SIMD intrinsics calls and suggests ``std::experimental::simd`` (`P0214`_)
|
|
alternatives.
|
|
|
|
If the option :option:`Suggest` is set to `true`, for
|
|
|
|
.. code-block:: c++
|
|
|
|
_mm_add_epi32(a, b); // x86
|
|
vec_add(a, b); // Power
|
|
|
|
the check suggests an alternative: ``operator+`` on ``std::experimental::simd``
|
|
objects.
|
|
|
|
Otherwise, it just complains the intrinsics are non-portable (and there are
|
|
`P0214`_ alternatives).
|
|
|
|
Many architectures provide SIMD operations (e.g. x86 SSE/AVX, Power
|
|
AltiVec/VSX, ARM NEON). It is common that SIMD code implementing the same
|
|
algorithm, is written in multiple target-dispatching pieces to optimize for
|
|
different architectures or micro-architectures.
|
|
|
|
The C++ standard proposal `P0214`_ and its extensions cover many common SIMD
|
|
operations. By migrating from target-dependent intrinsics to `P0214`_
|
|
operations, the SIMD code can be simplified and pieces for different targets
|
|
can be unified.
|
|
|
|
Refer to `P0214`_ for introduction and motivation for the data-parallel
|
|
standard library.
|
|
|
|
Options
|
|
-------
|
|
|
|
.. option:: Suggest
|
|
|
|
If this option is set to `true` (default is `false`), the check will suggest
|
|
`P0214`_ alternatives, otherwise it only points out the intrinsic function is
|
|
non-portable.
|
|
|
|
.. option:: Std
|
|
|
|
The namespace used to suggest `P0214`_ alternatives. If not specified, `std::`
|
|
for `-std=c++20` and `std::experimental::` for `-std=c++11`.
|
|
|
|
.. _P0214: https://wg21.link/p0214
|