CACHE_INVAL()

Обозначить недействительными строки кэша, связанные с буфером данных

Прототип:

#include <sys/cache.h>
CACHE_INVAL( struct cache_ctrl *cinfo,
void *vaddr,
uint64_t paddr,
size_t len );

Аргументы:

cinfo
Указатель на структуру cache_ctrl, которая была изначально передана в функцию cache_init().
vaddr
Виртуальный адрес буфера; это указатель на данные в виртуальном адресном пространстве драйвера.
paddr
Физический адрес буфера: обычно он находится в том же адресном пространстве, которое внешнее устройство будет использовать для ссылки на данные. Физический адрес получается путем вызова mem_offset64(). Поскольку эта функция довольно дорогостоящая, драйверы обычно выделяют пул буферов данных при инициализации (например, путем вызова mmap() с помощью MAP_PHYS и @ c MAP_ANON flags) и предварительно определяют физические адреса данных.
len
Число байтов в буфере, для которых соответствующие строки кэша должны быть аннулированы.

Библиотека:

libcache

Описание:

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

Перед использованием макросов CACHE_*() на платформах ARM и MIPS, вызывающий поток должен получить права на запись и чтение путем вызова ThreadCtl(), с указанием флага _NTO_TCTL_IO:

ThreadCtl( _NTO_TCTL_IO, 0 );

Не выполнение данной операции влечет появление сигнала SIGILL (недопустимая инструкция).

Переменные окружения:

Следующие переменные окружения, если они существуют, влияют на поведение данной функции:

CACHE_NOP
Указывает библиотеке, что макросы CACHE_FLUSH() и CACHE_INVAL() не должны действовать.
CACHE_MSYNC
Указывает библиотеке, что макросы CACHE_FLUSH() и CACHE_INVAL() должны использовать вызов msync() библиотеки С для выполнения синхронизации кэша.

Классификация:

ЗОСРВ «Нейтрино»

Точка остановки потока
Нет
Обработчик прерываний
Да
Обработчик сигналов
Да
В потоке
Да

Предостережения:

CACHE_INVAL() является макросом.

Тематические ссылки:

struct cache_ctrl, cache_fini(), CACHE_FLUSH(), cache_init()




Предыдущий раздел: Описание API библиотеки cache