function::vm_fault_contains - Linux


Overview

function::vm_fault_contains is used to verify whether a virtual memory fault occurs at a given virtual address.

Syntax

bool vm_fault_contains(const function::VmFault &fault, const void *virtual_address);

Options/Flags

None.

Examples

  // A call to vm_fault_contains for a virtual address that is
  // missing from an instruction block.
  bool missing_execute_access = vm_fault_contains(fault, bad_pc);  

Common Issues

If the virtual_address is outside the range of any mapped memory for the process, the results of this function are undefined.

Integration

function::vm_fault_contains can be used with other functions in the function namespace to analyze and handle virtual memory faults. For example, it can be used with function::VmFault::fault_address() to get the virtual address of a fault.

Related Commands

  • function::VmFault
  • function::VmFault::fault_address()