fluke_error_t fluke_mapping_create( fluke_mapping_t *new_mapping);
Creates a new empty mapping, with no memory region or task association. In order for the mapping to be useful, it must be associated with a memory region and task address space using fluke_mapping_set_state.The mapping's hash value will be set to an implementation-specific value. To set a specific hash value use fluke_mapping_create_hash.
- new_mapping
- A pointer to the address in the current task's address space at which to create the new mapping object. There must be no existing Fluke objects at this location; otherwise the results are undefined.
If any of the following errors is detected, the appropriate error code is returned: All of these have an implicit FLUKE_ prefix.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_MEMORY
- Insufficient resources were available.
- OBJECT_EXISTS
- An object already exists at the location pointed to by new_mapping.
- NOT_ALIGNED
- new_mapping is not properly aligned for a mapping object.
fluke_mapping_set_state, fluke_mapping_create_hash