SAM function SAM-Memory-region-release()

From SoOS

Jump to: navigation, search

Contents

[edit] Name

SAM_Memory_region_release - Release a protected memory region within a SAM context

[edit] Synopsis

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

[edit] Description

The SAM_Memory_region_release() function is used to make the SAM Structure object sam release the protection of a region of memory that has been previously protected. This means that workers will not be flashed back for reading or speculatively writing to this memory region. A released region can be protected again by calling the function SAM_Memory_region_protect()).

[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_unregister(), SAM_Memory_region_protect(), SAM_Memory_region_is_protected(), <sam.h>.