next up previous contents
Next: 6.6 fluke_port_destroy: destroy a Up: 6 Ports Previous: 6.4 fluke_port_create: create a

6.5 fluke_port_create_hash: create a new port with a given hash value

SYNOPSIS

fluke_error_t fluke_port_create_hash( fluke_port_t *new_port, integer_t *hash);

DESCRIPTION

Creates a new port object with the specified hash value. Until the port is associated with a port set via fluke_port_set_state, no messages can be received on it.

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.

PARAMETERS

new_port
A pointer to the address in the current task's address space at which to create the new port object.
hash
On entry, a pointer to the desired hash value to set. On return, the hash value used.

ERRORS

If any of the following errors is detected, the appropriate error code is returned: All of these have an implicit FLUKE_ prefix.
NO_MEMORY
Insufficient resources were available.

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.
OBJECT_EXISTS
An object already exists at the location pointed to by new_port.
NOT_ALIGNED
new_port is not properly aligned for a port object.

RELATED INFORMATION

fluke_port_set_state



Utah Flux Research Group