next up previous contents
Next: 6.8 fluke_port_move: move a Up: 6 Ports Previous: 6.6 fluke_port_destroy: destroy a

6.7 fluke_port_get_state: retrieve the current state of a port

SYNOPSIS

void fluke_port_get_state(fluke_port_t *port, fluke_port_state *state, fluke_ref_t *pset_ref);

DESCRIPTION

This operation retrieves the application-visible state of a port. The port itself is unaffected by the operation.

PARAMETERS

port
The port whose state is to be retrieved.
state
If non-null, the structure to fill in with the simple (non-reference) port state.
pset_ref
If non-null, the address of a reference object to associate with the port's port set object.

ERRORS

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 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
pset_ref is not a pointer to a reference object.

RELATED INFORMATION

fluke_port_set_state



Utah Flux Research Group