6.31.4 Атрибуты функций ARM

Эти атрибуты функций поддерживаются для целей ARM:

interrupt

Используйте этот атрибут, чтобы указать, что указанная функция является обработчиком прерывания. Компилятор генерирует последовательности входа и выхода функции, подходящие для использования в обработчике прерывания, когда этот атрибут присутствует.

Вы можете указать тип прерывания, которое должно обрабатываться, добавив необязательный параметр к атрибуту прерывания, например:

void f () __attribute__ ((interrupt ("IRQ")));

Допустимые значения для этого параметра: IRQ, FIQ, SWI, ABORT и UNDEF.

В ARMv7-M тип прерывания игнорируется, и этот атрибут означает, что функция может быть вызвана со значением указателя стека, выровненного по слову.

isr

Используйте этот атрибут в ARM для записи обработчиков прерываний. Это псевдоним для атрибута interrupt выше.

long_call

short_call

Эти атрибуты определяют, как вызывается конкретная функция. Эти атрибуты переопределяют переключатель командной строки -mlong-calls (см. Опции ARM) и настройки #pragma long_calls. Для ARM атрибут long_call указывает, что функция может находиться далеко от места вызова и требует другой (более дорогой) последовательности вызова. Атрибут short_call всегда помещает смещение функции от места вызова в инструкцию «BL» непосредственно.

naked

Этот атрибут позволяет компилятору создавать необходимое объявление функции, одновременно позволяя телу функции быть кодом ассемблера. Указанная функция не будет иметь пролога/эпилога, сгенерированных компилятором. В оголённых функциях могут безопасно содержаться только базовые asm инструкции (см. Базовый ассемблер). Хотя использование расширенных asm или комбинации базовых asm инструкций и кода C может показаться работающим, нельзя полагаться на их надёжную работу, и они не поддерживаются.

pcs

Атрибут pcs может быть использован для управления соглашением вызова для функции в ARM. Атрибут принимает аргумент, который определяет соглашение вызова для использования.

При компиляции с использованием ABI AAPCS (или его варианта) допустимые значения для аргумента — "aapcs" и "aapcs-vfp". Для использования варианта, отличного от "aapcs", компилятору необходимо разрешение на использование соответствующих регистров сопроцессора (т. е. регистры VFP должны быть доступны для использования "aapcs-vfp"). Например,

/* Argument passed in r0, and result returned in r0+r1.  */
double f2d (float) __attribute__((pcs("aapcs")));

Функции с переменным числом аргументов всегда используют соглашение вызова "aapcs" и компилятор отклоняет попытки указать альтернативу.

target (options)

Как обсуждалось в Общие атрибуты функций, этот атрибут позволяет указывать опции компиляции, специфичные для целевой платформы.

В ARM разрешены следующие опции:

‘thumb’

Вынужденная генерация кода в ISA Thumb (T16/T32), в зависимости от уровня архитектуры.

‘arm’

Вынужденная генерация кода в ISA ARM (A32).

Функции из различных режимов могут быть встроены в режим вызывающей функции.

‘fpu=’

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

‘arch=’

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

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

__attribute__((target("arch=armv8-a+crc")))
int
f (int a)
{
  return a + 5;
}

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

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

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

Далее: Атрибуты функций AVR, Предыдущее: Атрибуты функций ARC, Наверх: Атрибуты функций [Оглавление][Индекс]