next up previous contents
Next: 6.5 fluke_port_create_hash: create a Up: 6 Ports Previous: 6.3 References

6.4 fluke_port_create: create a new port

SYNOPSIS

fluke_error_t fluke_port_create( fluke_port_t *new_port);

DESCRIPTION

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

The port's hash value will be set to an implementation-specific value. To set a specific hash value use fluke_port_create_hash.

PARAMETERS

new_port
A pointer to the address in the current task's address space at which to create the new port object.

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, fluke_port_create_hash



Utah Flux Research Group