icetCopyState -- copy state machine of one context to another.

       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.

       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.

       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.

       None.

icetCopyState--copystatemachineofonecontexttoanother.

       Behavior is undefined if dest or src has never been created or has already been destroyed.

icetCreateContext(3), icetGetContext(3), icetSetContext(3)

IceT Reference                                   August  9, 2010                                icetCopyState(3)

       #include <IceT.h>

       void icetCopyState(   IceTContextdest,
                             const IceTContextsrc  );

       None.