zx_cache_flush

Summary

Flush CPU data and/or instruction caches.

Declaration

#include <zircon/syscalls.h>

zx_status_t zx_cache_flush(const void* addr, size_t size, uint32_t options);

Description

zx_cache_flush() flushes CPU caches covering memory in the given virtual address range. If that range of memory is not readable, then the thread may fault as it would for a data read.

options is a bitwise OR of:

  • ZX_CACHE_FLUSH_DATA

    Clean (write back) data caches, so previous writes on this CPU are visible in main memory.

  • ZX_CACHE_FLUSH_INVALIDATE (valid only when combined with ZX_CACHE_FLUSH_DATA)

    Clean (write back) data caches and then invalidate data caches, so previous writes on this CPU are visible in main memory and future reads on this CPU see external changes to main memory.

  • ZX_CACHE_FLUSH_INSN

    Synchronize instruction caches with data caches, so previous writes on this CPU are visible to instruction fetches. If this is combined with ZX_CACHE_FLUSH_DATA, then previous writes will be visible to main memory as well as to instruction fetches.

At least one of ZX_CACHE_FLUSH_DATA and ZX_CACHE_FLUSH_INSN must be included in options.

Rights

TODO(https://fxbug.dev/42107318)

Return value

zx_cache_flush() returns ZX_OK on success, or an error code on failure.

Errors

ZX_ERR_INVALID_ARGS options is invalid.