6.62.40 x86 Встроенные функции транзакционной памяти
Эти встроенные функции транзакционной памяти x86 позволяют использовать транзакции памяти с RTM (ограниченной транзакционной памятью). Эта поддержка включена с опцией -mrtm. Для использования HLE (Hardware Lock Elision) см. x86-специфические расширения модели памяти для транзакционной памяти вместо этого.
Транзакция памяти атомарно записывает все изменения в память, как видно другим потокам. Если транзакция завершается неудачно, она отменяется, и все побочные эффекты игнорируются.
В общем случае нет гарантии, что транзакция памяти всегда будет успешной, и всегда необходимо предоставить соответствующий код отката.
-
Функция RTM:
unsigned_xbegin() -
Начало транзакции RTM (ограниченная транзакционная память). Возвращает
_XBEGIN_STARTEDпри успешном начале транзакции (обратите внимание, что это не 0, поэтому константу необходимо явно проверить).Если транзакция прерывается, все побочные эффекты отменяются, и возвращается код прерывания, закодированный как битовая маска. Определены следующие макросы:
- Макрос: _XABORT_EXPLICIT
Транзакция была явно прервана с помощью
_xabort. Переданный параметр_xabortдоступен с помощью_XABORT_CODE(status).
- Макрос: _XABORT_RETRY
Возможен повтор транзакции.
- Макрос: _XABORT_CONFLICT
Прерывание транзакции из-за конфликта памяти с другим потоком.
- Макрос: _XABORT_CAPACITY
Прерывание транзакции из-за того, что транзакция использует слишком много памяти.
- Макрос: _XABORT_DEBUG
Прерывание транзакции из-за отладки.
- Макрос: _XABORT_NESTED
Прерывание транзакции во внутренней вложенной транзакции.
Нет гарантии, что какая-либо транзакция будет успешной, поэтому всегда нужен действительный путь отката.
-
Функция RTM:
void_xend() Подтверждение текущей транзакции. При отсутствии активной транзакции происходит ошибка. Все побочные эффекты памяти транзакции становятся видимыми для других потоков атомарным образом.
-
Функция RTM:
int_xtest() Возвращает ненулевое значение, если активна транзакция, иначе 0.
-
Функция RTM:
void_xabort(status) Прерывание текущей транзакции. При отсутствии активной транзакции это ничего не делает. status — 8-битная константа; её значение закодировано в возвращаемом значении из
_xbegin.
Вот пример обработки _XABORT_RETRY и пути отката для других ошибок:
#include <immintrin.h>
int n_tries, max_tries;
unsigned status = _XABORT_EXPLICIT;
...
for (n_tries = 0; n_tries < max_tries; n_tries++)
{
status = _xbegin ();
if (status == _XBEGIN_STARTED || !(status & _XABORT_RETRY))
break;
}
if (status == _XBEGIN_STARTED)
{
... transaction code...
_xend ();
}
else
{
... non-transactional fallback path...
}
Обратите внимание, что в большинстве случаев транзакционный и не транзакционный код должны синхронизироваться вместе для обеспечения согласованности.
© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-14.2.0/gcc/x86-transactional-memory-intrinsics.html