icetcreatempicommunicator(3) [debian man page]
icetCreateMPICommunicator(3) IceT Reference icetCreateMPICommunicator(3) NAME
icetCreateMPICommunicator -- Converts an MPI communicator to an IceT communicator. Synopsis #include <IceTMPI.h> IceTCommunicator icetCreateMPICommunicator( MPI_Comm mpi_comm ); Description IceT requires a communicator in order to perform correctly. An application is free to build its own communicator, but many will simply pre- fer to use MPI, which is a well established parallel communication tool. Thus, IceT comes with an implementation of IceTCommunicator that uses the MPI communication layer underneath. icetCreateMPICommunicator is used to create an IceTCommunicator that uses the mpi_comm MPI communication object. The resulting IceTCommuni- cator shares the same process group and process rank as the original MPI_Comm communicator. mpi_comm is duplicated, which has two consiquences. First, all process in mpi_comm's group may need to call icetCreateMPICommunicator in order for any of them to proceed (depending on the MPI implementation). Second, mpi_comm and the resulting IceTCommunicator are decoupled from each other. Communications in one cannot affect another. Also, one communicator may be destroyed without affecting the other. Return Value An IceTCommunicator with the same process group and rank as mpi_comm. The communicator may be destroyed with a call to icetDestroyMPICom- municator. Errors None. Warnings None. Bugs All MPI errors are ignored. 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 icetDestroyMPICommunicator(3), icetCreateContext(3) IceT Reference August 9, 2010 icetCreateMPICommunicator(3)
Check Out this Related Man Page
MPI_Comm_rank(3) MPI MPI_Comm_rank(3) NAME
MPI_Comm_rank - Determines the rank of the calling process in the communicator SYNOPSIS
int MPI_Comm_rank( MPI_Comm comm, int *rank ) INPUT ARGUMENT
comm - communicator (handle) OUTPUT ARGUMENT
rank - rank of the calling process in the group of comm (integer) THREAD AND INTERRUPT SAFETY
This routine is both thread- and interrupt-safe. This means that this routine may safely be used by multiple threads and from within a signal handler. NOTES FOR FORTRAN
All MPI routines in Fortran (except for MPI_WTIME and MPI_WTICK ) have an additional argument ierr at the end of the argument list. ierr is an integer and has the same meaning as the return value of the routine in C. In Fortran, MPI routines are subroutines, and are invoked with the call statement. All MPI objects (e.g., MPI_Datatype , MPI_Comm ) are of type INTEGER in Fortran. ERRORS
All MPI routines (except MPI_Wtime and MPI_Wtick ) return an error value; C routines as the value of the function and Fortran routines in the last argument. Before the value is returned, the current MPI error handler is called. By default, this error handler aborts the MPI job. The error handler may be changed with MPI_Comm_set_errhandler (for communicators), MPI_File_set_errhandler (for files), and MPI_Win_set_errhandler (for RMA windows). The MPI-1 routine MPI_Errhandler_set may be used but its use is deprecated. The predefined error handler MPI_ERRORS_RETURN may be used to cause error values to be returned. Note that MPI does not guarentee that an MPI program can continue past an error; however, MPI implementations will attempt to continue whenever possible. MPI_SUCCESS - No error; MPI routine completed successfully. MPI_ERR_COMM - Invalid communicator. A common error is to use a null communicator in a call (not even allowed in MPI_Comm_rank ). LOCATION
comm_rank.c 7/28/2010 MPI_Comm_rank(3)