next up previous contents
Next: 4.11 fluke_region_search: search for Up: 4 Regions Previous: 4.9 fluke_region_protect: change the

4.10 fluke_region_reference: associates a reference with a memory region

SYNOPSIS

void fluke_region_reference(fluke_region_t *region, fluke_ref_t *new_region_ref);

DESCRIPTION

This function associates an active reference object with the specified active region object. Region references are used to associate mapping objects with regions.

PARAMETERS

region
The active region object to which the new reference will refer.
new_region_ref
A pointer to a valid reference object.

ERRORS

If any of the following errors is detected by the Fluke implementation, it causes the current thread to take a synchronous exception with one of the following codes. All of these have an implicit FLUKE_INSANITY_ prefix.
NO_OBJECT
region or new_region_ref does not point to an active object.
NOT_REGION
The object pointed to by region is not a region object.
INVALID_OBJECT
The state of the region or reference object has become invalid.
NOT_REF
new_region_ref does not point to a valid reference object.

RELATED INFORMATION

fluke_mapping_set_state



Utah Flux Research Group