accel/tcg: Add block comment for probe_access

Backports commit 857129b34190a4c2e782006dc255352a6cd3934b from qemu
This commit is contained in:
Richard Henderson 2020-05-11 16:42:01 -04:00 committed by Lioncash
parent 91dbd53f77
commit 4016b667f3

View file

@ -212,7 +212,23 @@ static inline void tb_invalidate_phys_addr(AddressSpace *as, hwaddr addr)
{
}
#endif
/**
* probe_access:
* @env: CPUArchState
* @addr: guest virtual address to look up
* @size: size of the access
* @access_type: read, write or execute permission
* @mmu_idx: MMU index to use for lookup
* @retaddr: return address for unwinding
*
* Look up the guest virtual address @addr. Raise an exception if the
* page does not satisfy @access_type. Raise an exception if the
* access (@addr, @size) hits a watchpoint. For writes, mark a clean
* page as dirty.
*
* Finally, return the host address for a page that is backed by RAM,
* or NULL if the page requires I/O.
*/
void *probe_access(CPUArchState *env, target_ulong addr, int size,
MMUAccessType access_type, int mmu_idx, uintptr_t retaddr);