void fluke_port_reference(fluke_port_t *port, fluke_ref_t *new_port_ref);
This function associates an active reference object with the specified active port object. The resulting reference can be used in IPC operations and for insertion into port reference slots of various other objects (e.g., threads).
- port
- The port object to which the new reference will refer.
- new_port_ref
- A pointer to a valid reference object.
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_OBJECT
- port or new_port_ref does not point to an active object.
- NOT_PORT
- The object pointed to by port is not a port object.
- INVALID_OBJECT
- The state of the port or reference object has become invalid.
- NOT_REF
- new_port_ref does not point to a valid reference object.