noble (3) icetCopyState.3.gz

Provided by: paraview_5.11.2+dfsg-6build5_amd64 bug

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 (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)