CACHE_FLUSH()

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

Прототип:

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

Аргументы:

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

Библиотека:

libcache

Описание:

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

До использования макроса 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() должны использовать вызов библиотеки C msync() для выполнения синхронизации кеша.

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

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

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

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

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

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

struct cache_ctrl, cache_fini(), cache_init(), CACHE_INVAL()




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