6.33.2 Атрибуты функций AArch64 ¶
Для целевой архитектуры AArch64 доступны следующие атрибуты функций. В основном, эти параметры дублируют поведение подобных командной строки (см. Параметры AArch64), но на основе каждой функции.
general-regs-only-
Указывает, что при генерации кода для этой функции не следует использовать регистры с плавающей запятой или Advanced 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-alignno-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.
6.33.2.1 Правила встраивания ¶
Указание целевых атрибутов для отдельных функций или выполнение оптимизации на этапе компоновки через модули трансляции, скомпилированные с различными целевыми параметрами, может повлиять на правила встраивания функций:
В частности, вызывающая функция может встроить функцию-приёмник только в том случае, если доступные архитектурные возможности для функции-приёмника являются подмножеством возможностей, доступных вызывающей функции. Например: функция foo, скомпилированная с -march=armv8-a+crc, или помеченная эквивалентным атрибутом arch=armv8-a+crc, может встроить функцию bar скомпилированную с -march=armv8-a+nocrc, потому что все архитектурные особенности, требуемые для функции bar, доступны функции foo. Обратно, функция bar не может встроить функцию foo.
Кроме того, встраивание функции, скомпилированной с -mstrict-align, в функцию, скомпилированную без -mstrict-align, не допускается. Однако, встраивание функции, скомпилированной без -mstrict-align, в функцию, скомпилированную с -mstrict-align, разрешено.
Обратите внимание, что параметры настройки процессора и атрибуты, такие как -mcpu=, -mtune=, не препятствуют встраиванию, если процессор, указанный параметром -mcpu= или атрибутом cpu=, не конфликтует с правилами архитектурных возможностей, указанных выше.
© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-10.5.0/gcc/AArch64-Function-Attributes.html