icetCopyState(3)						  IceT Reference						  icetCopyState(3)

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 con-
       text.

       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)

IceT Reference							  August  9, 2010						  icetCopyState(3)