next up previous contents
Next: 7.10 fluke_pset_set_state: set the Up: 7 Port Sets Previous: 7.8 fluke_pset_move: move a

7.9 fluke_pset_reference: associates a reference with a port set

SYNOPSIS

void fluke_pset_reference(fluke_pset_t *pset, fluke_ref_t *new_pset_ref);

DESCRIPTION

This function associates an active reference object with the specified active port set object. The resulting reference can be used for insertion into port set reference slots of various other objects.

PARAMETERS

pset
The port set object to which the new reference will refer.
new_pset_ref
A pointer to a valid reference 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
pset or new_pset_ref does not point to an active object.
NOT_PORT
The object pointed to by pset is not a port set object.
INVALID_OBJECT
The state of the port set or reference object has become invalid.
NOT_REF
new_pset_ref does not point to a valid reference object.



Utah Flux Research Group