Poster of Linux kernelThe best gift for a Linux geek
icetCopyState

icetCopyState

Section: IceT Reference (3) Updated: April 12, 2006
Local index Up
 

NAME

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

 

Synopsis

#include <GL/ice-t.h>

void icetCopyState(IceTContextdest,
IceTContextsrc );

 

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)


 

Index

NAME
Synopsis
Description
Errors
Warnings
Bugs
Notes
Copyright
See Also

This document was created by man2html, using the manual pages.
Time: 21:48:06 GMT, April 16, 2011