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

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

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

Макросы для возможных кодов возврата tbegin определены в заголовочном файле htmintrin.h:

_HTM_TBEGIN_STARTED

tbegin выполнена как часть нормальной обработки. Тело транзакции должно быть выполнено.

_HTM_TBEGIN_INDETERMINATE

Транзакция была прервана из-за неопределенного условия, которое может быть постоянным.

_HTM_TBEGIN_TRANSIENT

Транзакция прервана из-за временного сбоя. В этом случае транзакцию следует повторно выполнить.

_HTM_TBEGIN_PERSISTENT

Транзакция прервана из-за постоянного сбоя. Повторное выполнение в тех же обстоятельствах не будет эффективным.

Макрос: _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 машинного кода. Второй аргумент записывается в местоположение первого аргумента. Операция сохранения не будет отменена в случае прерывания транзакции.

Далее: Встроенные функции SH, Предыдущая: Встроенные функции RX, Наверх: Встроенные функции целевых платформ [Оглавление][Индекс]