next up previous contents
Next: 7.9 fluke_pset_reference: associates a Up: 7 Port Sets Previous: 7.7 fluke_pset_get_state: retrieve the

7.8 fluke_pset_move: move a port set object from one location to another

SYNOPSIS

void fluke_pset_move(fluke_pset_t *old_addr, fluke_pset_t *new_addr);

DESCRIPTION

Moves the specified active port set object from one location in the caller's address space to another. The memory addressed by new_addr must not already contain any active Fluke objects. On return, the port set object will reside at new_addr and the memory left behind at old_addr will have undefined contents.

PARAMETERS

old_addr
The address of the port set object to move.
new_addr
The location in memory to which the port set is to be moved.

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
old_addr does not point to an active object.
NOT_PSET
The object pointed to by old_addr is not a port set object.
INVALID_OBJECT
The state of the port set object has become invalid.
OBJECT_EXISTS
An object already exists at the location pointed to by new_addr.
NOT_ALIGNED
new_addr is not properly aligned for a port set object.



Utah Flux Research Group