gasp_region_set_soft()

Set address-space regions in the guest system that need to be added, modified, or deleted

Synopsis:

#include <qvm/gasp.h>
unsigned gasp_region_set_soft(struct guest_system *gsp,
                              unsigned num_regions,
                              const struct gasp_region *rgn)

Arguments:

gsp
A pointer to the guest system.
num_regions
The number of regions to set.
rgn
A pointer to an array of region structures.

Library:

Provided by qvm; no external library is required.

Description:

This function is primarily used to:

  • add, remove or modify your own regions in the guest address space
  • modify guest RAM page permissions

You must call gasp_lock() before using this function.

For more information, see the Virtual Device Developer's Guide. If you are unsure about how to use this function, contact your QNX representative.

Returns:

On success, a number indicating how many regions were set successfully; this number is the same as the num_regions passed in. If the call wasn't successful, errno is set and the value returned is an index to the location of the first failure.