SAM function SAM-Memory-region-unregister()

From SoOS

Jump to: navigation, search

Contents

[edit] Name

SAM_Memory_region_unregister - Unregister a memory address within a SAM context

[edit] Synopsis

#include <sam.h>
 
void SAM_Memory_region_unregister(SAM_t sam, void *addr);

[edit] Description

The SAM_Memory_region_unregister() function is used to make the SAM Structure object sam to stop watching at reads and writes of the region that starts in the address addr. Making use of speculative memory calls to an unregistered region result in undefined behavior. A region can be registered again using SAM_Memory_address_register() or SAM_Memory_region_register().

[edit] Return value

None.

[edit] Errors

None, assumes correct input parameters.

[edit] Examples

Example 3 A - Executing speculatively and flashing back a worker thread (inefficient version)
Example 3 B - Executing speculatively and flashing back a worker thread (efficient version)
Example 4 - Executing speculatively, flashing back, and speculative writing
Example 5 - Using multiple protected memory regions within the same SAM context

[edit] See also

SAM_Memory_address_register(), SAM_Memory_region_register(), SAM_Memory_region_protect(), SAM_Memory_region_release(), SAM_Memory_region_is_protected(), <sam.h>.