6.33.2 Атрибуты функций AArch64 ¶

Для целевой архитектуры AArch64 доступны следующие атрибуты функций. В основном, эти опции отражают поведение аналогичных командной строки (см. Опции AArch64), но на основе каждой функции.

general-regs-only

Указывает, что при генерации кода для этой функции не должны использоваться регистры с плавающей запятой или расширенного SIMD. Если функция явно использует код с плавающей запятой, компилятор выдаст ошибку. Это поведение аналогично опции командной строки -mgeneral-regs-only.

fix-cortex-a53-835769

Указывает, что для этой функции должен быть применён обходной путь для исправления ошибки Cortex-A53 835769. Чтобы явно отключить обходной путь для этой функции, укажите отрицающую форму: no-fix-cortex-a53-835769. Это соответствует поведению опций командной строки -mfix-cortex-a53-835769 и -mno-fix-cortex-a53-835769.

cmodel=

Указывает, что для этой функции должен быть сгенерирован код для определённой модели кода. Поведение и допустимые аргументы такие же, как и для опции командной строки -mcmodel=.

strict-align

no-strict-align

strict-align указывает, что компилятор не должен предполагать, что ссылки на невыровненную память обрабатываются системой. Чтобы разрешить компилятору предположить, что ссылки на выровненную память обрабатываются системой, можно указать обратный атрибут no-strict-align. Поведение аналогично опциям командной строки -mstrict-align и -mno-strict-align.

omit-leaf-frame-pointer

Указывает, что для вызова функции-листа указатель фрейма должен быть опущен. Чтобы сохранить указатель фрейма, можно указать обратный атрибут no-omit-leaf-frame-pointer. Эти атрибуты имеют такое же поведение, как опции командной строки -momit-leaf-frame-pointer и -mno-omit-leaf-frame-pointer.

tls-dialect=

Указывает диалект TLS, который следует использовать для этой функции. Поведение и допустимые аргументы такие же, как и для опции командной строки -mtls-dialect=.

arch=

Указывает версию архитектуры и архитектурные расширения, которые следует использовать для этой функции. Поведение и допустимые аргументы такие же, как и для опции командной строки -march=.

tune=

Указывает ядро, для которого нужно настроить производительность этой функции. Поведение и допустимые аргументы такие же, как и для опции командной строки -mtune=.

cpu=

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

sign-return-address

Выбирает область действия функции, к которой будет применено подписание адреса возврата. Поведение и допустимые аргументы такие же, как и для опции командной строки -msign-return-address=. Значение по умолчанию равно none. Этот атрибут устарел. Вместо него следует использовать атрибут branch-protection.

branch-protection

Выбирает область действия функции, к которой будет применена защита ветвления. Поведение и допустимые аргументы такие же, как и для опции командной строки -mbranch-protection=. Значение по умолчанию равно none.

outline-atomics

Включает или отключает вызовы вспомогательных функций вне строки для реализации атомарных операций. Это соответствует поведению опций командной строки -moutline-atomics и -mno-outline-atomics.

Вышеперечисленные целевые атрибуты могут быть указаны следующим образом:

__attribute__((target("attr-string")))
int
f (int a)
{
  return a + 5;
}

где attr-string — одна из строк атрибутов, указанных выше.

Кроме того, строка архитектурного расширения может быть указана отдельно. Это можно использовать для включения и отключения определённых архитектурных расширений без указания конкретной версии архитектуры или ядра. Пример:

__attribute__((target("+crc+nocrypto")))
int
foo (int a)
{
  return a + 5;
}

В этом примере target("+crc+nocrypto") включает расширение crc и отключает расширение crypto для функции foo без изменения существующей опции -march= или -mcpu.

Можно указать несколько целевых атрибутов функций, разделив их запятыми. Например:

__attribute__((target("arch=armv8-a+crc+crypto,tune=cortex-a53")))
int
foo (int a)
{
  return a + 5;
}

является допустимым и компилирует функцию foo для ARMv8-A с расширениями crc и crypto и настраивает её для cortex-a53.

• Правила встраивания