6.60.31 Функции 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, транзакция будет повторно выполняться столько раз, сколько указано во втором аргументе. Инструкция assist процессора используется, чтобы сообщить ЦП о количестве сбоев до настоящего момента.

Функция по умолчанию: 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, а значение 0 загружается в rY. Целое значение указывает количество раз, когда транзакция прерывалась.

Функция по умолчанию: int __builtin_tx_nesting_depth (void)

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

Функция по умолчанию: void __builtin_non_tx_store (uint64_t *, uint64_t)

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