6.57.24 S/390 System z Встроенные функции

— Встроенная функция: int __builtin_tbegin (void*)

Генерирует tbegin машинную инструкцию, начинающую транзакцию аппаратного обеспечения без ограничений. Если параметр не равен NULL, область памяти используется для хранения буфера диагностики транзакции и будет передана в качестве первого операнда в tbegin. Этот буфер можно определить, используя struct __htm_tdb структуру C, определённую в htmintrin.h, и он должен располагаться на границе двойного слова. Второй операнд tbegin устанавливается в 0xff0c. Это позволяет сохранять/восстанавливать все регистры общего назначения (GPR) и отключает прерывания для операций с регистрами плавающей запятой (FPR) и регистрами адресов (AR) внутри тела транзакции. Код состояния, установленный инструкцией tbegin, возвращается как целое значение. Инструкция tbegin по определению перезаписывает содержимое всех регистров FPR. Компилятор сгенерирует код, который сохранит и восстановит регистры FPR. Для кода с программной поддержкой плавающей запятой рекомендуется использовать *_nofloat вариант. Чтобы предотвратить запись TDB, необходимо передать постоянное нулевое значение в качестве параметра. Передача нулевого значения через переменную недостаточно. Хотя изменения регистров доступа внутри транзакции не приведут к прерыванию транзакции, их фактическое изменение не поддерживается. Регистры доступа не сохраняются при входе в транзакцию. У них будет неопределённое состояние при достижении кода прерывания.

— Макрос: _HTM_FIRST_USER_ABORT_CODE

_HTM_FIRST_USER_ABORT_CODE, определённый в htmintrin.h, указывает первый код прерывания, который можно использовать для __builtin_tabort. Значения ниже этого порога зарезервированы для использования машиной.

— Тип данных: struct __htm_tdb

struct __htm_tdb, определённый в htmintrin.h, описывает структуру блока диагностики транзакции, как указано в руководстве по принципам работы в главе 5-91.

— Встроенная функция: int __builtin_tbegin_nofloat (void*)

То же, что и __builtin_tbegin, но без сохранения и восстановления регистров FPR. Использование этого варианта в коде, использующем регистры FPR, оставит регистры FPR в неопределённом состоянии при входе в обработчик прерывания транзакции.

— Встроенная функция: int __builtin_tbegin_retry (void*, int)

В дополнение к __builtin_tbegin генерируется цикл для временных сбоев. Если tbegin возвращает код состояния 2, транзакция будет повторно выполняться столько раз, сколько указано во втором аргументе. Инструкция ассиста процессора используется, чтобы сообщить процессору о количестве сбоев до сих пор.

— Встроенная функция: int __builtin_tbegin_retry_nofloat (void*, int)

То же, что и __builtin_tbegin_retry, но без сохранения и восстановления регистров FPR. Использование этого варианта в коде, использующем регистры FPR, оставит регистры FPR в неопределённом состоянии при входе в обработчик прерывания транзакции.

— Встроенная функция: void __builtin_tbeginc (void)

Генерирует tbeginc машинную инструкцию, начинающую ограниченную транзакцию аппаратного обеспечения. Второй операнд устанавливается в 0xff08.

— Встроенная функция: int __builtin_tend (void)

Генерирует tend машинную инструкцию, завершающую транзакцию и делающую изменения видимыми для других потоков. Код состояния, сгенерированный инструкцией tend, возвращается как целое значение.

— Встроенная функция: void __builtin_tabort (int)

Генерирует tabort машинную инструкцию с указанным кодом прерывания. Коды прерывания от 0 до 255 зарезервированы и приведут к сообщению об ошибке.

— Встроенная функция: void __builtin_tx_assist (int)

Генерирует ppa rX,rY,1 машинную инструкцию. Где целочисленный параметр загружается в rX, а значение ноль загружается в rY. Целочисленный параметр указывает количество раз, когда транзакция неоднократно прерывалась.

— Встроенная функция: int __builtin_tx_nesting_depth (void)

Генерирует etnd машинную инструкцию. Текущая глубина вложенности возвращается как целое значение. При глубине вложенности 0 код не выполняется как часть транзакции.

— Встроенная функция: void __builtin_non_tx_store (uint64_t *, uint64_t)

Генерирует ntstg машинную инструкцию. Второй аргумент записывается в местоположение первого аргумента. Операция сохранения не будет отменена в случае прерывания транзакции.