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)

IceT Reference                           August  9, 2010                         icetCopyState(3)