fluke_error_t fluke_mapping_create_hash( fluke_mapping_t *new_mapping, integer_t *hash);
Creates a new empty mapping with the specified hash value. The created mapping has 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.On a call, hash is a pointer to the hash value to set. If the pointer or the value is zero, the implementation will choose a default value. On a successful return, a non-zero pointer will contain the hash value set.
- 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.
- hash
- On entry, a pointer to the desired hash value to set. On return, the hash value used.
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