NAME
icetCopyState -- copy state machine of one context to another.
Synopsis
#include <GL/ice-t.h>
void icetCopyState( IceTContext dest,
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, there is a non-exclusive
license for use of this work by or on behalf of the U.S. Government.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that this Notice and any statement
of authorship are reproduced on all copies.
See Also
icetCreateContext(3), icetGetContext(3), icetSetContext(3)
IceT Reference April 12, 2006 icetCopyState(3)