@@ -10515,9 +10515,10 @@ Atomic loads produce :ref:`defined <memmodel>` results when they may see
10515
10515
multiple atomic stores. The type of the pointee must be an integer, pointer, or
10516
10516
floating-point type whose bit width is a power of two greater than or equal to
10517
10517
eight and less than or equal to a target-specific size limit. ``align`` must be
10518
- explicitly specified on atomic loads, and the load has undefined behavior if the
10519
- alignment is not set to a value which is at least the size in bytes of the
10520
- pointee. ``!nontemporal`` does not have any defined semantics for atomic loads.
10518
+ explicitly specified on atomic loads. Note: if the alignment is not greater or
10519
+ equal to the size of the `<value>` type, the atomic operation is likely to
10520
+ require a lock and have poor performance. ``!nontemporal`` does not have any
10521
+ defined semantics for atomic loads.
10521
10522
10522
10523
The optional constant ``align`` argument specifies the alignment of the
10523
10524
operation (that is, the alignment of the memory address). It is the
@@ -10655,9 +10656,10 @@ Atomic loads produce :ref:`defined <memmodel>` results when they may see
10655
10656
multiple atomic stores. The type of the pointee must be an integer, pointer, or
10656
10657
floating-point type whose bit width is a power of two greater than or equal to
10657
10658
eight and less than or equal to a target-specific size limit. ``align`` must be
10658
- explicitly specified on atomic stores, and the store has undefined behavior if
10659
- the alignment is not set to a value which is at least the size in bytes of the
10660
- pointee. ``!nontemporal`` does not have any defined semantics for atomic stores.
10659
+ explicitly specified on atomic stores. Note: if the alignment is not greater or
10660
+ equal to the size of the `<value>` type, the atomic operation is likely to
10661
+ require a lock and have poor performance. ``!nontemporal`` does not have any
10662
+ defined semantics for atomic stores.
10661
10663
10662
10664
The optional constant ``align`` argument specifies the alignment of the
10663
10665
operation (that is, the alignment of the memory address). It is the
@@ -10807,8 +10809,9 @@ must be at least ``monotonic``, the failure ordering cannot be either
10807
10809
A ``cmpxchg`` instruction can also take an optional
10808
10810
":ref:`syncscope <syncscope>`" argument.
10809
10811
10810
- The alignment must be a power of two greater or equal to the size of the
10811
- `<value>` type.
10812
+ Note: if the alignment is not greater or equal to the size of the `<value>`
10813
+ type, the atomic operation is likely to require a lock and have poor
10814
+ performance.
10812
10815
10813
10816
The alignment is only optional when parsing textual IR; for in-memory IR, it is
10814
10817
always present. If unspecified, the alignment is assumed to be equal to the
@@ -10910,8 +10913,9 @@ the ``atomicrmw`` is marked as ``volatile``, then the optimizer is not
10910
10913
allowed to modify the number or order of execution of this
10911
10914
``atomicrmw`` with other :ref:`volatile operations <volatile>`.
10912
10915
10913
- The alignment must be a power of two greater or equal to the size of the
10914
- `<value>` type.
10916
+ Note: if the alignment is not greater or equal to the size of the `<value>`
10917
+ type, the atomic operation is likely to require a lock and have poor
10918
+ performance.
10915
10919
10916
10920
The alignment is only optional when parsing textual IR; for in-memory IR, it is
10917
10921
always present. If unspecified, the alignment is assumed to be equal to the
0 commit comments