NAME¶
icetCopyState -- copy state machine of one context to another.
Synopsis¶
#include <IceT.h>
void icetCopyState( |
IceTContext |
dest, |
|
const IceTContext |
src ); |
Description¶
The
icetCopyState function replaces the state of
dest with the
current state of
src. This function can be used to quickly duplicate a
context.
The
IceTCommunicator object associated with
dest is
not
changed (nor can it ever be). Consequently, the following state values are not
copied either, since they refer to process ids that are directly tied to the
IceTCommunicator object:
ICET_RANK,
ICET_NUM_PROCESSES,
ICET_DATA_REPLICATION_GROUP,
ICET_DATA_REPLICATION_GROUP_SIZE,
ICET_COMPOSITE_ORDER, and
ICET_PROCESS_ORDERS. However, every
other state parameter is copied.
Errors¶
None.
Warnings¶
None.
Bugs¶
The state is copied blindly. It is therefore possible to copy states that are
invalid for a context's communicator. For example, a display rank may not
refer to a valid process id.
Notes¶
Behavior is undefined if
dest or
src has never been created or has
already been destroyed.
Copyright¶
Copyright (C)2003 Sandia Corporation
Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S.
Government retains certain rights in this software.
This source code is released under the New BSD License.
See Also¶
icetCreateContext(3),
icetGetContext(3),
icetSetContext(3)