Invalidate cache lines associated with a data buffer
#include <sys/cache.h> CACHE_INVAL(struct cache_ctrl *cinfo, void *vaddr, uint64_t paddr, size_t len);
libcache
Use the -l cache option to qcc to link against this library.
This macro is used to invalidate any cache lines associated with a data buffer. This routine ensures that any subsequent modifications that are made to the data by an external device will be not be corrupted by the CPU writing back cached data to the memory, and ensures that once the data has been modified, the CPU will fetch the updated data from memory, instead of retrieving stale data from the cache.
This macro was added in QNX Momentics 6.3.0 SP2. |
Before using the CACHE_*() macros on ARM and MIPS platforms, the calling thread must obtain I/O privileges by calling ThreadCtl(), specifying the _NTO_TCTL_IO flag:
ThreadCtl( _NTO_TCTL_IO, 0 );
Failing to do so may result in a SIGILL (illegal instruction) signal.
The following environment variables, if they exist, affect the behavior of this function:
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | Yes |
Signal handler | Yes |
Thread | Yes |
CACHE_INVAL() is implemented as a macro.
cache_fini(), CACHE_FLUSH(), cache_init()