Spec-Zone.ru › GCC 9

6.33.20 Атрибуты функций MIPS

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

interrupt

Используйте этот атрибут, чтобы указать, что указанная функция является обработчиком прерываний. Компилятор генерирует последовательности входа и выхода функции, подходящие для использования в обработчике прерываний, когда этот атрибут присутствует. Поддерживается необязательный аргумент для атрибута прерывания, который позволяет описать режим прерывания. По умолчанию GCC предполагает использование режима внешнего контроллера прерываний (EIC), это можно явно установить, используя eic. Когда прерывания не замаскированы, запрашиваемый уровень приоритета прерывания (IPL) копируется в текущий IPL, что приводит к активации только прерываний более высокого приоритета. Для использования векторизованного режима прерываний используйте аргумент vector=[sw0|sw1|hw0|hw1|hw2|hw3|hw4|hw5], это изменит поведение поддержки незамаскированных прерываний, и GCC организует маскирование всех прерываний от sw0 до указанного вектора прерывания включительно.

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

use_shadow_register_set

Предполагается, что обработчик использует набор теней регистров, а не основные регистры общего назначения. Поддерживается необязательный аргумент intstack для указания того, что набор теней регистров содержит допустимый указатель стека.

keep_interrupts_masked

Удерживать прерывания замаскированными для всей функции. Без этого атрибута GCC пытается повторно активировать прерывания для большей части функции, насколько это возможно.

use_debug_exception_return

Возвращение с использованием инструкции deret. Обработчики прерываний, у которых нет этого атрибута, возвращаются с помощью eret вместо этого.

Вы можете использовать любую комбинацию этих атрибутов, как показано ниже:

void __attribute__ ((interrupt)) v0 ();
void __attribute__ ((interrupt, use_shadow_register_set)) v1 ();
void __attribute__ ((interrupt, keep_interrupts_masked)) v2 ();
void __attribute__ ((interrupt, use_debug_exception_return)) v3 ();
void __attribute__ ((interrupt, use_shadow_register_set,
                     keep_interrupts_masked)) v4 ();
void __attribute__ ((interrupt, use_shadow_register_set,
                     use_debug_exception_return)) v5 ();
void __attribute__ ((interrupt, keep_interrupts_masked,
                     use_debug_exception_return)) v6 ();
void __attribute__ ((interrupt, use_shadow_register_set,
                     keep_interrupts_masked,
                     use_debug_exception_return)) v7 ();
void __attribute__ ((interrupt("eic"))) v8 ();
void __attribute__ ((interrupt("vector=hw3"))) v9 ();
long_call
short_call
near
far

Эти атрибуты определяют, как конкретная функция вызывается на MIPS. Атрибуты переопределяют переключатель командной строки -mlong-calls (см. Опции MIPS). Атрибуты long_call и far являются синонимами и заставляют компилятор всегда вызывать функцию, сначала загрузив ее адрес в регистр, а затем используя содержимое этого регистра. Атрибуты short_call и near являются синонимами и имеют обратный эффект; они указывают, что вызовы, не использующие PIC, должны выполняться с помощью более эффективной инструкции jal.

mips16
nomips16

В целях MIPS, вы можете использовать атрибуты функций mips16 и nomips16 для локального выбора или отключения генерации кода MIPS16. Функция с атрибутом mips16 генерируется как код MIPS16, а генерация кода MIPS16 отключается для функций с атрибутом nomips16. Эти атрибуты переопределяют параметры -mips16 и -mno-mips16 в командной строке (см. Опции MIPS).

При компиляции файлов, содержащих смешанный код MIPS16 и не-MIPS16, препроцессорная переменная __mips16 отражает установку в командной строке, а не в отдельных функциях. Смешанный код MIPS16 и не-MIPS16 может плохо взаимодействовать с некоторыми расширениями GCC, такими как __builtin_apply (см. Создание вызовов).

micromips, MIPS
nomicromips, MIPS

В целях MIPS, вы можете использовать атрибуты функций micromips и nomicromips для локального выбора или отключения генерации кода microMIPS. Функция с атрибутом micromips генерируется как код microMIPS, а генерация кода microMIPS отключается для функций с атрибутом nomicromips. Эти атрибуты переопределяют параметры -mmicromips и -mno-micromips в командной строке (см. Опции MIPS).

При компиляции файлов, содержащих смешанный код microMIPS и не-microMIPS, препроцессорная переменная __mips_micromips отражает установку в командной строке, а не в отдельных функциях. Смешанный код microMIPS и не-microMIPS может плохо взаимодействовать с некоторыми расширениями GCC, такими как __builtin_apply (см. Создание вызовов).

nocompression

В целях MIPS, вы можете использовать атрибут функции nocompression для локального отключения генерации кода MIPS16 и microMIPS. Этот атрибут переопределяет параметры -mips16 и -mmicromips в командной строке (см. Опции MIPS).

Далее: Атрибуты функций MSP430, Предыдущее: Атрибуты функций Microsoft Windows, Вверх: Атрибуты функций [Содержание][Индекс]

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-9.5.0/gcc/MIPS-Function-Attributes.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API