Cleanup language about MPI exceptions --> errors
MPI-4 is finally cleaning up its language: an MPI "exception" does not actually exist. The only thing that exists is an MPI "error" (and associated handlers). This commit replaces all relevant uses of the word "exception" with "error". Note that this is still applicable in versions of the MPI standard less than MPI-4.0 (indeed, nearly all the cases fixed in this commit are just changes to comments, anyway). One exception to this is the Java bindings, where there's an MPIException class. In hindsight, it probably should have been named MPIError, but changing it now would break anyone who is using the Java bindings. Signed-off-by: Jeff Squyres <jsquyres@cisco.com>
Этот коммит содержится в:
Jeff Squyres
родитель
1e11933660
Коммит
20c772e733
@ -419,7 +419,7 @@ static void ompi_comm_destruct(ompi_communicator_t* comm)
|
||||
from one communicator to another and we end up destroying the
|
||||
new communication while propagating the error up the stack. We
|
||||
want to make it all the way up the stack to invoke the MPI
|
||||
exception, not cause a seg fault in pml_del_comm because it was
|
||||
error, not cause a seg fault in pml_del_comm because it was
|
||||
never pml_add_com'ed. */
|
||||
|
||||
if ( MPI_COMM_NULL != comm && OMPI_COMM_IS_PML_ADDED(comm) ) {
|
||||
|
||||
@ -381,7 +381,7 @@ struct ompi_request_t;
|
||||
*
|
||||
* @returns err_code The same value as the parameter
|
||||
*
|
||||
* This function invokes the MPI exception function on the error
|
||||
* This function invokes the MPI error function on the error
|
||||
* handler. If the errhandler was created from fortran, the error
|
||||
* handler will be invoked with fortran linkage. Otherwise, it is
|
||||
* invoked with C linkage.
|
||||
@ -394,7 +394,7 @@ struct ompi_request_t;
|
||||
|
||||
|
||||
/**
|
||||
* Invoke an MPI exception on the first request found in the array
|
||||
* Invoke an MPI error on the first request found in the array
|
||||
* that has a non-MPI_SUCCESS value for MPI_ERROR in its status. It
|
||||
* is safe to invoke this function if none of the requests have an
|
||||
* outstanding error; MPI_SUCCESS will be returned.
|
||||
|
||||
@ -141,7 +141,7 @@ int ompi_errhandler_request_invoke(int count,
|
||||
ompi_mpi_object_t mpi_object;
|
||||
|
||||
/* Find the *first* request that has an error -- that's the one
|
||||
that we'll invoke the exception on. In an error condition, the
|
||||
that we'll invoke the error on. In an error condition, the
|
||||
request will not have been reset back to MPI_REQUEST_NULL, so
|
||||
there's no need to cache values from before we call
|
||||
ompi_request_test(). */
|
||||
@ -162,18 +162,18 @@ int ompi_errhandler_request_invoke(int count,
|
||||
|
||||
/* Since errors on requests cause them to not be freed (until we
|
||||
can examine them here), go through and free all requests with
|
||||
errors. We only invoke the exception on the *first* request
|
||||
errors. We only invoke the error on the *first* request
|
||||
that had an error. */
|
||||
for (; i < count; ++i) {
|
||||
if (MPI_REQUEST_NULL != requests[i] &&
|
||||
MPI_SUCCESS != requests[i]->req_status.MPI_ERROR) {
|
||||
/* Ignore the error -- what are we going to do? We're
|
||||
already going to invoke an exception */
|
||||
already going to invoke an error */
|
||||
ompi_request_free(&(requests[i]));
|
||||
}
|
||||
}
|
||||
|
||||
/* Invoke the exception */
|
||||
/* Invoke the error */
|
||||
switch (type) {
|
||||
case OMPI_REQUEST_PML:
|
||||
case OMPI_REQUEST_COLL:
|
||||
|
||||
@ -53,7 +53,7 @@ static int init_query_2_0_0(const mca_base_component_t *ls,
|
||||
* and destroy the opened list.
|
||||
*
|
||||
* It is *not* an error if there are no io components available.
|
||||
* Appropriate run-time MPI exceptions will be invoked during
|
||||
* Appropriate run-time MPI errors will be invoked during
|
||||
* MPI_FILE_OPEN and MPI_FILE_DELETE.
|
||||
*/
|
||||
int mca_io_base_find_available(bool enable_progress_threads,
|
||||
|
||||
@ -44,7 +44,7 @@ int MPI_Errhandler_free(MPI_Errhandler *errhandler)
|
||||
|
||||
if (MPI_PARAM_CHECK) {
|
||||
OMPI_ERR_INIT_FINALIZE(FUNC_NAME);
|
||||
/* Raise an MPI exception if we got NULL or if we got an intrinsic
|
||||
/* Raise an MPI error if we got NULL or if we got an intrinsic
|
||||
*and* the reference count is 1 (meaning that this FREE would
|
||||
actually free the underlying intrinsic object). This is ugly
|
||||
but necessary -- see below. */
|
||||
|
||||
@ -92,7 +92,7 @@ public final class CartComm extends Intracomm
|
||||
* Duplicates this communicator.
|
||||
* <p>Java binding of {@code MPI_COMM_DUP}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public CartComm dup() throws MPIException
|
||||
{
|
||||
@ -106,7 +106,7 @@ public final class CartComm extends Intracomm
|
||||
* <p>The new communicator can't be used before the operation completes.
|
||||
* The request object must be obtained calling {@link #getRequest}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred. Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred. Signals that an MPI exception of some sort has occurred.
|
||||
*/
|
||||
@Override public CartComm iDup() throws MPIException
|
||||
{
|
||||
@ -119,7 +119,7 @@ public final class CartComm extends Intracomm
|
||||
* <p>Java binding of {@code MPI_COMM_DUP_WITH_INFO}.
|
||||
* @param info info object to associate with the new communicator
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public CartComm dupWithInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -134,7 +134,7 @@ public final class CartComm extends Intracomm
|
||||
* <p>The number of dimensions can be obtained from the size of (eg)
|
||||
* {@code dims} field of the returned object.
|
||||
* @return object containing dimensions, periods and local coordinates
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public CartParms getTopo() throws MPIException
|
||||
{
|
||||
@ -149,7 +149,7 @@ public final class CartComm extends Intracomm
|
||||
* <p>Java binding of the MPI operation {@code MPI_CART_RANK}.
|
||||
* @param coords Cartesian coordinates of a process
|
||||
* @return rank of the specified process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getRank(int[] coords) throws MPIException
|
||||
{
|
||||
@ -164,7 +164,7 @@ public final class CartComm extends Intracomm
|
||||
* <p>Java binding of the MPI operation {@code MPI_CART_COORDS}.
|
||||
* @param rank rank of a process
|
||||
* @return Cartesian coordinates of the specified process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int[] getCoords(int rank) throws MPIException
|
||||
{
|
||||
@ -180,7 +180,7 @@ public final class CartComm extends Intracomm
|
||||
* @param direction coordinate dimension of shift
|
||||
* @param disp displacement
|
||||
* @return object containing ranks of source and destination processes
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public ShiftParms shift(int direction, int disp) throws MPIException
|
||||
{
|
||||
@ -197,7 +197,7 @@ public final class CartComm extends Intracomm
|
||||
* @param remainDims by dimension, {@code true} if dimension is to be kept,
|
||||
* {@code false} otherwise
|
||||
* @return communicator containing subgrid including this process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public CartComm sub(boolean[] remainDims) throws MPIException
|
||||
{
|
||||
@ -215,7 +215,7 @@ public final class CartComm extends Intracomm
|
||||
* @param periods {@code true} if grid is periodic,
|
||||
* {@code false} if not, in each dimension
|
||||
* @return reordered rank of calling process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int map(int[] dims, boolean[] periods) throws MPIException
|
||||
{
|
||||
@ -231,7 +231,7 @@ public final class CartComm extends Intracomm
|
||||
* <p>Java binding of the MPI operation {@code MPI_DIMS_CREATE}.
|
||||
* @param nnodes number of nodes in a grid
|
||||
* @param dims array specifying the number of nodes in each dimension
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void createDims(int nnodes, int[] dims) throws MPIException
|
||||
{
|
||||
|
||||
@ -128,7 +128,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Duplicates this communicator.
|
||||
* <p>Java binding of {@code MPI_COMM_DUP}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Comm dup() throws MPIException
|
||||
{
|
||||
@ -144,7 +144,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* <p>The new communicator can't be used before the operation completes.
|
||||
* The request object must be obtained calling {@link #getRequest}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Comm iDup() throws MPIException
|
||||
{
|
||||
@ -159,7 +159,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* <p>Java binding of {@code MPI_COMM_DUP_WITH_INFO}.
|
||||
* @param info info object to associate with the new communicator
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Comm dupWithInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -184,7 +184,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Size of group of this communicator.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_SIZE}.
|
||||
* @return number of processors in the group of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int getSize() throws MPIException
|
||||
{
|
||||
@ -198,7 +198,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Rank of this process in group of this communicator.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_RANK}.
|
||||
* @return rank of the calling process in the group of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int getRank() throws MPIException
|
||||
{
|
||||
@ -221,7 +221,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* {@code MPI.SIMILAR} results if the underlying groups are similar
|
||||
* but the communicators differ by context.<br>
|
||||
* {@code MPI.UNEQUAL} results otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int compare(Comm comm1, Comm comm2) throws MPIException
|
||||
{
|
||||
@ -233,7 +233,7 @@ public class Comm implements Freeable, Cloneable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_COMM_FREE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override final public void free() throws MPIException
|
||||
{
|
||||
@ -256,7 +256,7 @@ public class Comm implements Freeable, Cloneable
|
||||
/**
|
||||
* Java binding of {@code MPI_COMM_SET_INFO}.
|
||||
* @param info info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void setInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -269,7 +269,7 @@ public class Comm implements Freeable, Cloneable
|
||||
/**
|
||||
* Java binding of {@code MPI_COMM_GET_INFO}.
|
||||
* @return new info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Info getInfo() throws MPIException
|
||||
{
|
||||
@ -281,7 +281,7 @@ public class Comm implements Freeable, Cloneable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_COMM_DISCONNECT}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void disconnect() throws MPIException
|
||||
{
|
||||
@ -295,7 +295,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Return group associated with a communicator.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_GROUP}.
|
||||
* @return group corresponding to this communicator group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Group getGroup() throws MPIException
|
||||
{
|
||||
@ -312,7 +312,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_TEST_INTER}.
|
||||
* @return {@code true} if this is an inter-communicator,
|
||||
* {@code false} otherwise
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final boolean isInter() throws MPIException
|
||||
{
|
||||
@ -335,7 +335,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param remoteLeader rank of remote group leader in this communicator
|
||||
* @param tag "safe" tag
|
||||
* @return new inter-communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm createIntercomm(Comm localComm, int localLeader,
|
||||
int remoteLeader, int tag)
|
||||
@ -361,7 +361,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in send buffer
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void send(Object buf, int count, Datatype type, int dest, int tag)
|
||||
throws MPIException
|
||||
@ -392,7 +392,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param source rank of source
|
||||
* @param tag message tag
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Status recv(Object buf, int count,
|
||||
Datatype type, int source, int tag)
|
||||
@ -437,7 +437,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param source rank of source
|
||||
* @param recvtag receive tag
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
* @see mpi.Comm#recv(Object, int, Datatype, int, int)
|
||||
*/
|
||||
@ -495,7 +495,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param source rank of source
|
||||
* @param recvtag receive tag
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
* @see mpi.Comm#recv(Object, int, Datatype, int, int)
|
||||
*/
|
||||
@ -537,7 +537,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in send buffer
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final void bSend(Object buf, int count, Datatype type, int dest, int tag)
|
||||
@ -568,7 +568,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in send buffer
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final void sSend(Object buf, int count, Datatype type, int dest, int tag)
|
||||
@ -599,7 +599,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in send buffer
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final void rSend(Object buf, int count, Datatype type, int dest, int tag)
|
||||
@ -633,7 +633,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Request iSend(Buffer buf, int count,
|
||||
@ -660,7 +660,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Request ibSend(Buffer buf, int count,
|
||||
@ -687,7 +687,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Request isSend(Buffer buf, int count,
|
||||
@ -714,7 +714,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Request irSend(Buffer buf, int count,
|
||||
@ -741,7 +741,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param source rank of source
|
||||
* @param tag message tag
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#recv(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Request iRecv(Buffer buf, int count,
|
||||
@ -771,7 +771,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return persistent communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Prequest sendInit(Buffer buf, int count,
|
||||
@ -798,7 +798,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return persistent communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Prequest bSendInit(Buffer buf, int count,
|
||||
@ -825,7 +825,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return persistent communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Prequest sSendInit(Buffer buf, int count,
|
||||
@ -852,7 +852,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param dest rank of destination
|
||||
* @param tag message tag
|
||||
* @return persistent communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#send(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Prequest rSendInit(Buffer buf, int count,
|
||||
@ -879,7 +879,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param source rank of source
|
||||
* @param tag message tag
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
* @see mpi.Comm#recv(Object, int, Datatype, int, int)
|
||||
*/
|
||||
public final Prequest recvInit(Buffer buf, int count,
|
||||
@ -913,7 +913,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param outbuf output buffer
|
||||
* @param position initial position in output buffer
|
||||
* @return final position in output buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int pack(Object inbuf, int incount, Datatype type,
|
||||
byte[] outbuf, int position)
|
||||
@ -951,7 +951,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param outcount number of items in output buffer
|
||||
* @param type datatype of each item in output buffer
|
||||
* @return final position in input buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int unpack(byte[] inbuf, int position,
|
||||
Object outbuf, int outcount, Datatype type)
|
||||
@ -982,7 +982,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param incount number of items in input buffer
|
||||
* @param type datatype of each item in input buffer
|
||||
* @return upper bound on size of packed message
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int packSize(int incount, Datatype type) throws MPIException
|
||||
{
|
||||
@ -1004,7 +1004,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param tag message tag
|
||||
* @return status object if such a message is currently available,
|
||||
* {@code null} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Status iProbe(int source, int tag) throws MPIException
|
||||
{
|
||||
@ -1023,7 +1023,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param source rank of source
|
||||
* @param tag message tag
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Status probe(int source, int tag) throws MPIException
|
||||
{
|
||||
@ -1042,7 +1042,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Create a new attribute key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_CREATE_KEYVAL}.
|
||||
* @return attribute key for future access
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int createKeyval() throws MPIException
|
||||
{
|
||||
@ -1056,7 +1056,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Frees an attribute key for communicators.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_FREE_KEYVAL}.
|
||||
* @param keyval attribute key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void freeKeyval(int keyval) throws MPIException
|
||||
{
|
||||
@ -1071,7 +1071,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_SET_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @param value attribute value
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void setAttr(int keyval, Object value) throws MPIException
|
||||
{
|
||||
@ -1087,7 +1087,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_GET_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @return attribute value or null if no attribute is associated with the key.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Object getAttr(int keyval) throws MPIException
|
||||
{
|
||||
@ -1122,7 +1122,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Deletes an attribute value associated with a key on a communicator.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_DELETE_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void deleteAttr(int keyval) throws MPIException
|
||||
{
|
||||
@ -1140,7 +1140,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* <p>The return value will be one of {@code MPI.GRAPH}, {@code MPI.CART},
|
||||
* {@code MPI.DIST_GRAPH} or {@code MPI.UNDEFINED}.
|
||||
* @return topology type of communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int getTopology() throws MPIException
|
||||
{
|
||||
@ -1156,7 +1156,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Abort MPI.
|
||||
* <p>Java binding of the MPI operation {@code MPI_ABORT}.
|
||||
* @param errorcode error code for Unix or POSIX environments
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void abort(int errorcode) throws MPIException
|
||||
{
|
||||
@ -1172,7 +1172,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Associates a new error handler with communicator at the calling process.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_SET_ERRHANDLER}.
|
||||
* @param errhandler new MPI error handler for communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void setErrhandler(Errhandler errhandler) throws MPIException
|
||||
{
|
||||
@ -1187,7 +1187,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Returns the error handler currently associated with the communicator.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_GET_ERRHANDLER}.
|
||||
* @return MPI error handler currently associated with communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Errhandler getErrhandler() throws MPIException
|
||||
{
|
||||
@ -1201,7 +1201,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Calls the error handler currently associated with the communicator.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_CALL_ERRHANDLER}.
|
||||
* @param errorCode error code
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void callErrhandler(int errorCode) throws MPIException
|
||||
{
|
||||
@ -1217,7 +1217,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* A call to {@code barrier} blocks the caller until all process
|
||||
* in the group have called it.
|
||||
* <p>Java binding of the MPI operation {@code MPI_BARRIER}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void barrier() throws MPIException
|
||||
{
|
||||
@ -1231,7 +1231,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* Nonblocking barrier synchronization.
|
||||
* <p>Java binding of the MPI operation {@code MPI_IBARRIER}.
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iBarrier() throws MPIException
|
||||
{
|
||||
@ -1249,7 +1249,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each item in buffer
|
||||
* @param root rank of broadcast root
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void bcast(Object buf, int count, Datatype type, int root)
|
||||
throws MPIException
|
||||
@ -1280,7 +1280,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in buffer
|
||||
* @param root rank of broadcast root
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iBcast(Buffer buf, int count, Datatype type, int root)
|
||||
throws MPIException
|
||||
@ -1306,7 +1306,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of receiving process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void gather(
|
||||
Object sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -1349,7 +1349,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of items to send/receive
|
||||
* @param type datatype of each item in buffer
|
||||
* @param root rank of receiving process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void gather(Object buf, int count, Datatype type, int root)
|
||||
throws MPIException
|
||||
@ -1386,7 +1386,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of receiving process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iGather(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -1413,7 +1413,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in buffer
|
||||
* @param root rank of receiving process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iGather(Buffer buf, int count, Datatype type, int root)
|
||||
throws MPIException
|
||||
@ -1443,7 +1443,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of receiving process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void gatherv(Object sendbuf, int sendcount, Datatype sendtype,
|
||||
Object recvbuf, int[] recvcount, int[] displs,
|
||||
@ -1487,7 +1487,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of receiving process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void gatherv(Object recvbuf, int[] recvcount, int[] displs,
|
||||
Datatype recvtype, int root)
|
||||
@ -1517,7 +1517,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param sendcount number of items to send
|
||||
* @param sendtype datatype of each item in send buffer
|
||||
* @param root rank of receiving process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void gatherv(Object sendbuf, int sendcount,
|
||||
Datatype sendtype, int root)
|
||||
@ -1558,7 +1558,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of receiving process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iGatherv(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype, Buffer recvbuf,
|
||||
@ -1586,7 +1586,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of receiving process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iGatherv(Buffer recvbuf, int[] recvcount, int[] displs,
|
||||
Datatype recvtype, int root)
|
||||
@ -1611,7 +1611,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param sendtype datatype of each item in send buffer
|
||||
* @param root rank of receiving process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iGatherv(Buffer sendbuf, int sendcount,
|
||||
Datatype sendtype, int root)
|
||||
@ -1641,7 +1641,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of sending process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scatter(
|
||||
Object sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -1684,7 +1684,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of items to send/receive
|
||||
* @param type datatype of each item in buffer
|
||||
* @param root rank of sending process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scatter(Object buf, int count, Datatype type, int root)
|
||||
throws MPIException
|
||||
@ -1720,7 +1720,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of sending process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScatter(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -1747,7 +1747,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type datatype of each item in buffer
|
||||
* @param root rank of sending process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScatter(Buffer buf, int count, Datatype type, int root)
|
||||
throws MPIException
|
||||
@ -1776,7 +1776,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of sending process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scatterv(
|
||||
Object sendbuf, int[] sendcount, int[] displs, Datatype sendtype,
|
||||
@ -1819,7 +1819,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param displs displacements from which to take outgoing data
|
||||
* @param sendtype datatype of each item in send buffer
|
||||
* @param root rank of sending process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scatterv(Object sendbuf, int[] sendcount, int[] displs,
|
||||
Datatype sendtype, int root)
|
||||
@ -1849,7 +1849,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of sending process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scatterv(Object recvbuf, int recvcount,
|
||||
Datatype recvtype, int root)
|
||||
@ -1889,7 +1889,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of sending process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScatterv(
|
||||
Buffer sendbuf, int[] sendcount, int[] displs, Datatype sendtype,
|
||||
@ -1917,7 +1917,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param sendtype datatype of each item in send buffer
|
||||
* @param root rank of sending process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScatterv(Buffer sendbuf, int[] sendcount, int[] displs,
|
||||
Datatype sendtype, int root)
|
||||
@ -1941,7 +1941,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @param root rank of sending process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScatterv(Buffer recvbuf, int recvcount,
|
||||
Datatype recvtype, int root)
|
||||
@ -1969,7 +1969,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvbuf receive buffer
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allGather(Object sendbuf, int sendcount, Datatype sendtype,
|
||||
Object recvbuf, int recvcount, Datatype recvtype)
|
||||
@ -2008,7 +2008,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param buf receive buffer
|
||||
* @param count number of items to receive
|
||||
* @param type datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allGather(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -2043,7 +2043,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllGather(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2067,7 +2067,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of items to receive
|
||||
* @param type datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllGather(Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -2093,7 +2093,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of elements received from each process
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allGatherv(
|
||||
Object sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2134,7 +2134,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of elements received from each process
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allGatherv(Object recvbuf, int[] recvcount,
|
||||
int[] displs, Datatype recvtype)
|
||||
@ -2172,7 +2172,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllGatherv(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2198,7 +2198,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param type datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllGatherv(
|
||||
Buffer buf, int[] count, int[] displs, Datatype type)
|
||||
@ -2227,7 +2227,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvbuf receive buffer
|
||||
* @param recvcount number of items received from any process
|
||||
* @param recvtype datatype of receive buffer items
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allToAll(Object sendbuf, int sendcount, Datatype sendtype,
|
||||
Object recvbuf, int recvcount, Datatype recvtype)
|
||||
@ -2276,7 +2276,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items received from any process
|
||||
* @param recvtype datatype of receive buffer items
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllToAll(Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
Buffer recvbuf, int recvcount, Datatype recvtype)
|
||||
@ -2308,7 +2308,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of elements received from each process
|
||||
* @param rdispls displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allToAllv(
|
||||
Object sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
|
||||
@ -2362,7 +2362,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param rdispls displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllToAllv(
|
||||
Buffer sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
|
||||
@ -2397,7 +2397,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvCount number of elements received from each process
|
||||
* @param rDispls displacements at which to place incoming data
|
||||
* @param recvTypes datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allToAllw(
|
||||
Object sendBuf, int[] sendCount, int[] sDispls, Datatype[] sendTypes,
|
||||
@ -2461,7 +2461,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param rDispls displacements at which to place incoming data
|
||||
* @param recvTypes datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllToAllw(
|
||||
Buffer sendBuf, int[] sendCount, int[] sDispls, Datatype[] sendTypes,
|
||||
@ -2494,7 +2494,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvbuf receive buffer
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void neighborAllGather(
|
||||
Object sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2543,7 +2543,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iNeighborAllGather(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2574,7 +2574,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of elements that are received from each neighbor
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of receive buffer elements
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void neighborAllGatherv(
|
||||
Object sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2623,7 +2623,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param displs displacements at which to place incoming data
|
||||
* @param recvtype datatype of receive buffer elements
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iNeighborAllGatherv(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2653,7 +2653,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvbuf receive buffer
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void neighborAllToAll(
|
||||
Object sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2702,7 +2702,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of items to receive
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iNeighborAllToAll(
|
||||
Buffer sendbuf, int sendcount, Datatype sendtype,
|
||||
@ -2733,7 +2733,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount number of elements received from each process
|
||||
* @param rdispls displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void neighborAllToAllv(
|
||||
Object sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
|
||||
@ -2785,7 +2785,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param rdispls displacements at which to place incoming data
|
||||
* @param recvtype datatype of each item in receive buffer
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iNeighborAllToAllv(
|
||||
Buffer sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
|
||||
@ -2824,7 +2824,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @param root rank of root process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void reduce(Object sendbuf, Object recvbuf, int count,
|
||||
Datatype type, Op op, int root)
|
||||
@ -2866,7 +2866,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in buffer
|
||||
* @param op reduce operation
|
||||
* @param root rank of root process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void reduce(Object buf, int count, Datatype type, Op op, int root)
|
||||
throws MPIException
|
||||
@ -2904,7 +2904,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param op reduce operation
|
||||
* @param root rank of root process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iReduce(Buffer sendbuf, Buffer recvbuf,
|
||||
int count, Datatype type, Op op, int root)
|
||||
@ -2933,7 +2933,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param op reduce operation
|
||||
* @param root rank of root process
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iReduce(Buffer buf, int count,
|
||||
Datatype type, Op op, int root)
|
||||
@ -2963,7 +2963,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of items in send buffer
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allReduce(Object sendbuf, Object recvbuf,
|
||||
int count, Datatype type, Op op)
|
||||
@ -3003,7 +3003,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of items in send buffer
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void allReduce(Object buf, int count, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -3038,7 +3038,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllReduce(Buffer sendbuf, Buffer recvbuf,
|
||||
int count, Datatype type, Op op)
|
||||
@ -3064,7 +3064,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iAllReduce(Buffer buf, int count, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -3093,7 +3093,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcounts numbers of result elements distributed to each process
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void reduceScatter(Object sendbuf, Object recvbuf,
|
||||
int[] recvcounts, Datatype type, Op op)
|
||||
@ -3134,7 +3134,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param counts numbers of result elements distributed to each process
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void reduceScatter(Object buf, int[] counts, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -3170,7 +3170,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iReduceScatter(Buffer sendbuf, Buffer recvbuf,
|
||||
int[] recvcounts, Datatype type, Op op)
|
||||
@ -3198,7 +3198,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iReduceScatter(
|
||||
Buffer buf, int[] counts, Datatype type, Op op)
|
||||
@ -3226,7 +3226,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param recvcount element count per block
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void reduceScatterBlock(Object sendbuf, Object recvbuf,
|
||||
int recvcount, Datatype type, Op op)
|
||||
@ -3265,7 +3265,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count element count per block
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void reduceScatterBlock(
|
||||
Object buf, int count, Datatype type, Op op)
|
||||
@ -3300,7 +3300,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iReduceScatterBlock(
|
||||
Buffer sendbuf, Buffer recvbuf, int recvcount, Datatype type, Op op)
|
||||
@ -3326,7 +3326,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param type data type of each item in send buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iReduceScatterBlock(
|
||||
Buffer buf, int count, Datatype type, Op op)
|
||||
@ -3356,7 +3356,7 @@ public class Comm implements Freeable, Cloneable
|
||||
* @param count number of elements
|
||||
* @param type data type of each item
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void reduceLocal(
|
||||
Object inBuf, Object inOutBuf, int count, Datatype type, Op op)
|
||||
@ -3408,7 +3408,7 @@ public class Comm implements Freeable, Cloneable
|
||||
/**
|
||||
* Sets the print name for the communicator.
|
||||
* @param name name for the communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void setName(String name) throws MPIException
|
||||
{
|
||||
@ -3421,7 +3421,7 @@ public class Comm implements Freeable, Cloneable
|
||||
/**
|
||||
* Return the print name from the communicator.
|
||||
* @return name of the communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final String getName() throws MPIException
|
||||
{
|
||||
|
||||
@ -140,7 +140,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Returns the lower bound of a datatype.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_GET_EXTENT}.
|
||||
* @return lower bound of datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getLb() throws MPIException
|
||||
{
|
||||
@ -154,7 +154,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Returns the extent of a datatype.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_GET_EXTENT}.
|
||||
* @return datatype extent
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getExtent() throws MPIException
|
||||
{
|
||||
@ -179,7 +179,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Returns the true lower bound of a datatype.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_GET_TRUE_EXTENT}.
|
||||
* @return lower bound of datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getTrueLb() throws MPIException
|
||||
{
|
||||
@ -193,7 +193,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Returns the true extent of a datatype.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_GET_TRUE_EXTENT}.
|
||||
* @return datatype true extent
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getTrueExtent() throws MPIException
|
||||
{
|
||||
@ -219,7 +219,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* elements it represents.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_SIZE}.
|
||||
* @return datatype size
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getSize() throws MPIException
|
||||
{
|
||||
@ -232,7 +232,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
/**
|
||||
* Commits a derived datatype.
|
||||
* Java binding of the MPI operation {@code MPI_TYPE_COMMIT}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void commit() throws MPIException
|
||||
{
|
||||
@ -245,7 +245,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
/**
|
||||
* Frees the datatype.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_FREE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public void free() throws MPIException
|
||||
{
|
||||
@ -285,7 +285,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
/**
|
||||
* Java binding of {@code MPI_TYPE_DUP}.
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Datatype dup() throws MPIException
|
||||
{
|
||||
@ -304,7 +304,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param count replication count
|
||||
* @param oldType old datatype
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createContiguous(int count, Datatype oldType)
|
||||
throws MPIException
|
||||
@ -326,7 +326,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param stride number of elements between start of each block
|
||||
* @param oldType old datatype
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createVector(int count, int blockLength,
|
||||
int stride, Datatype oldType)
|
||||
@ -351,7 +351,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param stride number of bytes between start of each block
|
||||
* @param oldType old datatype
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createHVector(int count, int blockLength,
|
||||
int stride, Datatype oldType)
|
||||
@ -379,7 +379,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param displacements displacement of each block in units of old type
|
||||
* @param oldType old datatype
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createIndexed(int[] blockLengths,
|
||||
int[] displacements, Datatype oldType)
|
||||
@ -403,7 +403,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param displacements byte displacement in buffer for each block
|
||||
* @param oldType old datatype
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createHIndexed(int[] blockLengths,
|
||||
int[] displacements, Datatype oldType)
|
||||
@ -428,7 +428,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param displacements byte displacement of each block
|
||||
* @param types type of elements in each block
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createStruct(int[] blockLengths,
|
||||
int[] displacements, Datatype[] types)
|
||||
@ -455,7 +455,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* @param lb new lower bound of datatype (address integer)
|
||||
* @param extent new extent of datatype (address integer)
|
||||
* @return new datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Datatype createResized(Datatype oldType, int lb, int extent)
|
||||
throws MPIException
|
||||
@ -470,7 +470,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
/**
|
||||
* Sets the print name for the datatype.
|
||||
* @param name name for the datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setName(String name) throws MPIException
|
||||
{
|
||||
@ -483,7 +483,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
/**
|
||||
* Return the print name from the datatype.
|
||||
* @return name of the datatype
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public String getName() throws MPIException
|
||||
{
|
||||
@ -497,7 +497,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Create a new attribute key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_CREATE_KEYVAL}.
|
||||
* @return attribute key for future access
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int createKeyval() throws MPIException
|
||||
{
|
||||
@ -511,7 +511,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Frees an attribute key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_FREE_KEYVAL}.
|
||||
* @param keyval attribute key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void freeKeyval(int keyval) throws MPIException
|
||||
{
|
||||
@ -526,7 +526,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_SET_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @param value attribute value
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setAttr(int keyval, Object value) throws MPIException
|
||||
{
|
||||
@ -542,7 +542,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_GET_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @return attribute value or null if no attribute is associated with the key.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Object getAttr(int keyval) throws MPIException
|
||||
{
|
||||
@ -557,7 +557,7 @@ public final class Datatype implements Freeable, Cloneable
|
||||
* Deletes an attribute value associated with a key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TYPE_DELETE_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void deleteAttr(int keyval) throws MPIException
|
||||
{
|
||||
|
||||
@ -48,7 +48,7 @@ public final class File
|
||||
* @param comm communicator
|
||||
* @param filename name of the file to open
|
||||
* @param amode file access mode
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public File(Comm comm, String filename, int amode) throws MPIException
|
||||
{
|
||||
@ -62,7 +62,7 @@ public final class File
|
||||
* @param filename name of the file to open
|
||||
* @param amode file access mode
|
||||
* @param info info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public File(Comm comm, String filename, int amode, Info info)
|
||||
throws MPIException
|
||||
@ -76,7 +76,7 @@ public final class File
|
||||
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_CLOSE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void close() throws MPIException
|
||||
{
|
||||
@ -89,7 +89,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_DELETE} using {@code MPI_INFO_NULL}.
|
||||
* @param filename name of the file to delete
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void delete(String filename) throws MPIException
|
||||
{
|
||||
@ -101,7 +101,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_DELETE}.
|
||||
* @param filename name of the file to delete
|
||||
* @param info info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void delete(String filename, Info info) throws MPIException
|
||||
{
|
||||
@ -115,7 +115,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_SET_SIZE}.
|
||||
* @param size size to truncate or expand file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setSize(long size) throws MPIException
|
||||
{
|
||||
@ -128,7 +128,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_PREALLOCATE}.
|
||||
* @param size size to preallocate file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void preallocate(long size) throws MPIException
|
||||
{
|
||||
@ -141,7 +141,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_SIZE}.
|
||||
* @return size of file in bytes
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public long getSize() throws MPIException
|
||||
{
|
||||
@ -154,7 +154,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_GROUP}.
|
||||
* @return group which opened the file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group getGroup() throws MPIException
|
||||
{
|
||||
@ -167,7 +167,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_AMODE}.
|
||||
* @return file access mode to open the file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getAMode() throws MPIException
|
||||
{
|
||||
@ -180,7 +180,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_SET_INFO}.
|
||||
* @param info info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -193,7 +193,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_INFO}.
|
||||
* @return new info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Info getInfo() throws MPIException
|
||||
{
|
||||
@ -209,7 +209,7 @@ public final class File
|
||||
* @param etype elementary datatype
|
||||
* @param filetype filetype
|
||||
* @param datarep data representation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setView(long disp, Datatype etype,
|
||||
Datatype filetype, String datarep)
|
||||
@ -227,7 +227,7 @@ public final class File
|
||||
* @param filetype filetype
|
||||
* @param datarep data representation
|
||||
* @param info info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setView(long disp, Datatype etype,
|
||||
Datatype filetype, String datarep, Info info)
|
||||
@ -258,7 +258,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readAt(long offset, Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -291,7 +291,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readAtAll(long offset, Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -324,7 +324,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeAt(long offset, Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -357,7 +357,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeAtAll(long offset, Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -390,7 +390,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iReadAt(long offset, Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -413,7 +413,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iReadAtAll(long offset, Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -436,7 +436,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iWriteAt(long offset, Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -459,7 +459,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iWriteAtAll(long offset, Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -481,7 +481,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status read(Object buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -510,7 +510,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readAll(Object buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -539,7 +539,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status write(Object buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -568,7 +568,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeAll(Object buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -597,7 +597,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iRead(Buffer buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -617,7 +617,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iReadAll(Buffer buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -637,7 +637,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iWrite(Buffer buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -657,7 +657,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iWriteAll(Buffer buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -675,7 +675,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_SEEK}.
|
||||
* @param offset file offset
|
||||
* @param whence update mode
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void seek(long offset, int whence) throws MPIException
|
||||
{
|
||||
@ -688,7 +688,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_POSITION}.
|
||||
* @return offset of individual pointer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public long getPosition() throws MPIException
|
||||
{
|
||||
@ -702,7 +702,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_GET_BYTE_OFFSET}.
|
||||
* @param offset offset
|
||||
* @return absolute byte position of offset
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public long getByteOffset(long offset) throws MPIException
|
||||
{
|
||||
@ -718,7 +718,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readShared(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -750,7 +750,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeShared(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -782,7 +782,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iReadShared(Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -803,7 +803,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request iWriteShared(Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -824,7 +824,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readOrdered(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -856,7 +856,7 @@ public final class File
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeOrdered(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -886,7 +886,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_SEEK_SHARED}.
|
||||
* @param offset file offset
|
||||
* @param whence update mode
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void seekShared(long offset, int whence) throws MPIException
|
||||
{
|
||||
@ -900,7 +900,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_POSITION_SHARED}.
|
||||
* @return offset of individual pointer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public long getPositionShared() throws MPIException
|
||||
{
|
||||
@ -916,7 +916,7 @@ public final class File
|
||||
* @param buf buffer
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void readAtAllBegin(long offset, Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -953,7 +953,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_READ_AT_ALL_END}.
|
||||
* @param buf buffer
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readAtAllEnd(Object buf) throws MPIException
|
||||
{
|
||||
@ -980,7 +980,7 @@ public final class File
|
||||
* @param buf buffer
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void writeAtAllBegin(long offset, Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -1017,7 +1017,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_WRITE_AT_ALL_END}.
|
||||
* @param buf buffer
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeAtAllEnd(Object buf) throws MPIException
|
||||
{
|
||||
@ -1043,7 +1043,7 @@ public final class File
|
||||
* @param buf buffer
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void readAllBegin(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -1079,7 +1079,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_READ_ALL_END}.
|
||||
* @param buf buffer
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readAllEnd(Object buf) throws MPIException
|
||||
{
|
||||
@ -1105,7 +1105,7 @@ public final class File
|
||||
* @param buf buffer
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void writeAllBegin(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -1141,7 +1141,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_WRITE_ALL_END}.
|
||||
* @param buf buffer
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeAllEnd(Object buf) throws MPIException
|
||||
{
|
||||
@ -1167,7 +1167,7 @@ public final class File
|
||||
* @param buf buffer
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void readOrderedBegin(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -1203,7 +1203,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_READ_ORDERED_END}.
|
||||
* @param buf buffer
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status readOrderedEnd(Object buf) throws MPIException
|
||||
{
|
||||
@ -1229,7 +1229,7 @@ public final class File
|
||||
* @param buf buffer
|
||||
* @param count number of items in buffer
|
||||
* @param type datatype of each buffer element
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void writeOrderedBegin(Object buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
@ -1265,7 +1265,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_WRITE_ORDERED_END}.
|
||||
* @param buf buffer
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status writeOrderedEnd(Object buf) throws MPIException
|
||||
{
|
||||
@ -1297,7 +1297,7 @@ public final class File
|
||||
* Java binding of {@code MPI_FILE_GET_TYPE_EXTENT}.
|
||||
* @param type type of data
|
||||
* @return datatype extent
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getTypeExtent(Datatype type) throws MPIException
|
||||
{
|
||||
@ -1310,7 +1310,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_SET_ATOMICITY}.
|
||||
* @param atomicity true to set atomic mode, false to set nonatomic mode
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setAtomicity(boolean atomicity) throws MPIException
|
||||
{
|
||||
@ -1324,7 +1324,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_GET_ATOMICITY}.
|
||||
* @return current consistency of the file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public boolean getAtomicity() throws MPIException
|
||||
{
|
||||
@ -1336,7 +1336,7 @@ public final class File
|
||||
|
||||
/**
|
||||
* Java binding of {@code MPI_FILE_SYNC}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void sync() throws MPIException
|
||||
{
|
||||
@ -1349,7 +1349,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_FILE_SET_ERRHANDLER}.
|
||||
* @param errhandler new MPI error handler for file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setErrhandler(Errhandler errhandler) throws MPIException
|
||||
{
|
||||
@ -1363,7 +1363,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_FILE_GET_ERRHANDLER}.
|
||||
* @return MPI error handler currently associated with file
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Errhandler getErrhandler() throws MPIException
|
||||
{
|
||||
@ -1376,7 +1376,7 @@ public final class File
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_FILE_CALL_ERRHANDLER}.
|
||||
* @param errorCode error code
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void callErrhandler(int errorCode) throws MPIException
|
||||
{
|
||||
|
||||
@ -52,7 +52,7 @@ public interface Freeable
|
||||
{
|
||||
/**
|
||||
* Frees a freeable object.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
void free() throws MPIException;
|
||||
}
|
||||
|
||||
@ -93,7 +93,7 @@ public final class GraphComm extends Intracomm
|
||||
* Duplicates this communicator.
|
||||
* <p>Java binding of {@code MPI_COMM_DUP}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public GraphComm dup() throws MPIException
|
||||
{
|
||||
@ -107,7 +107,7 @@ public final class GraphComm extends Intracomm
|
||||
* The request object must be obtained calling {@link #getRequest}.
|
||||
* <p>Java binding of {@code MPI_COMM_IDUP}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public GraphComm iDup() throws MPIException
|
||||
{
|
||||
@ -120,7 +120,7 @@ public final class GraphComm extends Intracomm
|
||||
* <p>Java binding of {@code MPI_COMM_DUP_WITH_INFO}.
|
||||
* @param info info object to associate with the new communicator
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public GraphComm dupWithInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -136,7 +136,7 @@ public final class GraphComm extends Intracomm
|
||||
* from the sizes of the {@code index} and {@code edges} fields
|
||||
* of the returned object.
|
||||
* @return object defining node degress and edges of graph
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public GraphParms getDims() throws MPIException
|
||||
{
|
||||
@ -153,7 +153,7 @@ public final class GraphComm extends Intracomm
|
||||
* <p>The number of neighbors can be extracted from the size of the result.
|
||||
* @param rank rank of a process in the group of this communicator
|
||||
* @return array of ranks of neighboring processes to one specified
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int[] getNeighbors(int rank) throws MPIException
|
||||
{
|
||||
@ -166,7 +166,7 @@ public final class GraphComm extends Intracomm
|
||||
/**
|
||||
* Gets the adjacency information for a distributed graph topology.
|
||||
* @return adjacency information for a distributed graph topology
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public DistGraphNeighbors getDistGraphNeighbors() throws MPIException
|
||||
{
|
||||
@ -184,7 +184,7 @@ public final class GraphComm extends Intracomm
|
||||
* @param index node degrees
|
||||
* @param edges graph edges
|
||||
* @return reordered rank of calling process
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int map(int[] index, int[] edges) throws MPIException
|
||||
{
|
||||
|
||||
@ -72,7 +72,7 @@ public final class Group implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_GROUP_SIZE}.
|
||||
* @return number of processes in the group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getSize() throws MPIException
|
||||
{
|
||||
@ -87,7 +87,7 @@ public final class Group implements Freeable
|
||||
* <p>Java binding of the MPI operation {@code MPI_GROUP_RANK}.
|
||||
* @return rank of this process in the group, or {@code MPI.UNDEFINED}
|
||||
* if this process is not a member of the group.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getRank() throws MPIException
|
||||
{
|
||||
@ -125,7 +125,7 @@ public final class Group implements Freeable
|
||||
* @param ranks1 array of valid ranks in group1
|
||||
* @param group2 another group
|
||||
* @return array of corresponding ranks in group2
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int[] translateRanks(Group group1, int[] ranks1, Group group2)
|
||||
throws MPIException
|
||||
@ -145,7 +145,7 @@ public final class Group implements Freeable
|
||||
* @return {@code MPI.IDENT} if the group members and group order are exactly
|
||||
* the same in both groups, {@code MPI.SIMILAR} if the group members are
|
||||
* the same but the order is different, {@code MPI.UNEQUAL} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int compare(Group group1, Group group2) throws MPIException
|
||||
{
|
||||
@ -161,7 +161,7 @@ public final class Group implements Freeable
|
||||
* @param group1 first group
|
||||
* @param group2 second group
|
||||
* @return union group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Group union(Group group1, Group group2) throws MPIException
|
||||
{
|
||||
@ -177,7 +177,7 @@ public final class Group implements Freeable
|
||||
* @param group1 first group
|
||||
* @param group2 second group
|
||||
* @return intersection group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Group intersection(Group group1, Group group2) throws MPIException
|
||||
{
|
||||
@ -193,7 +193,7 @@ public final class Group implements Freeable
|
||||
* @param group1 first group
|
||||
* @param group2 second group
|
||||
* @return difference group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Group difference(Group group1, Group group2) throws MPIException
|
||||
{
|
||||
@ -208,7 +208,7 @@ public final class Group implements Freeable
|
||||
* <p>Java binding of the MPI operation {@code MPI_GROUP_INCL}.
|
||||
* @param ranks ranks from this group to appear in new group
|
||||
* @return new group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group incl(int[] ranks) throws MPIException
|
||||
{
|
||||
@ -223,7 +223,7 @@ public final class Group implements Freeable
|
||||
* <p>Java binding of the MPI operation {@code MPI_GROUP_EXCL}.
|
||||
* @param ranks ranks from this group <em>not</em> to appear in new group
|
||||
* @return new group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group excl(int[] ranks) throws MPIException
|
||||
{
|
||||
@ -243,7 +243,7 @@ public final class Group implements Freeable
|
||||
* of triplets. The size of the second dimension is 3.
|
||||
* @param ranges array of integer triplets
|
||||
* @return new group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group rangeIncl(int[][] ranges) throws MPIException
|
||||
{
|
||||
@ -261,7 +261,7 @@ public final class Group implements Freeable
|
||||
* indicating ranks in this group to be excluded from the new group.
|
||||
* @param ranges array of integer triplets
|
||||
* @return new group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group rangeExcl(int[][] ranges) throws MPIException
|
||||
{
|
||||
|
||||
@ -31,7 +31,7 @@ public final class Info implements Freeable, Cloneable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_INFO_CREATE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Info() throws MPIException
|
||||
{
|
||||
@ -58,7 +58,7 @@ public final class Info implements Freeable, Cloneable
|
||||
* Java binding of the MPI operation {@code MPI_INFO_SET}.
|
||||
* @param key key
|
||||
* @param value value
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void set(String key, String value) throws MPIException
|
||||
{
|
||||
@ -73,7 +73,7 @@ public final class Info implements Freeable, Cloneable
|
||||
* Java binding of the MPI operation {@code MPI_INFO_GET}.
|
||||
* @param key key
|
||||
* @return value or {@code null} if key is not defined
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public String get(String key) throws MPIException
|
||||
{
|
||||
@ -86,7 +86,7 @@ public final class Info implements Freeable, Cloneable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_INFO_DELETE}.
|
||||
* @param key key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void delete(String key) throws MPIException
|
||||
{
|
||||
@ -99,7 +99,7 @@ public final class Info implements Freeable, Cloneable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_INFO_GET_NKEYS}.
|
||||
* @return number of defined keys
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int size() throws MPIException
|
||||
{
|
||||
@ -113,7 +113,7 @@ public final class Info implements Freeable, Cloneable
|
||||
* Java binding of the MPI operation {@code MPI_INFO_GET_NTHKEY}.
|
||||
* @param i key number
|
||||
* @return key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public String getKey(int i) throws MPIException
|
||||
{
|
||||
@ -144,7 +144,7 @@ public final class Info implements Freeable, Cloneable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_INFO_DUP}.
|
||||
* @return info object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Info dup() throws MPIException
|
||||
{
|
||||
@ -156,7 +156,7 @@ public final class Info implements Freeable, Cloneable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_INFO_FREE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public void free() throws MPIException
|
||||
{
|
||||
|
||||
@ -85,7 +85,7 @@ public final class Intercomm extends Comm
|
||||
* Duplicates this communicator.
|
||||
* <p>Java binding of {@code MPI_COMM_DUP}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public Intercomm dup() throws MPIException
|
||||
{
|
||||
@ -99,7 +99,7 @@ public final class Intercomm extends Comm
|
||||
* <p>The new communicator can't be used before the operation completes.
|
||||
* The request object must be obtained calling {@link #getRequest}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public Intercomm iDup() throws MPIException
|
||||
{
|
||||
@ -112,7 +112,7 @@ public final class Intercomm extends Comm
|
||||
* <p>Java binding of {@code MPI_COMM_DUP_WITH_INFO}.
|
||||
* @param info info object to associate with the new communicator
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public Intercomm dupWithInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -126,7 +126,7 @@ public final class Intercomm extends Comm
|
||||
* Size of remote group.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_REMOTE_SIZE}.
|
||||
* @return number of process in remote group of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getRemoteSize() throws MPIException
|
||||
{
|
||||
@ -140,7 +140,7 @@ public final class Intercomm extends Comm
|
||||
* Return the remote group.
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_REMOTE_GROUP}.
|
||||
* @return remote group of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group getRemoteGroup() throws MPIException
|
||||
{
|
||||
@ -155,7 +155,7 @@ public final class Intercomm extends Comm
|
||||
* <p>Java binding of the MPI operation {@code MPI_INTERCOMM_MERGE}.
|
||||
* @param high true if the local group has higher ranks in combined group
|
||||
* @return new intra-communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Intracomm merge(boolean high) throws MPIException
|
||||
{
|
||||
@ -168,7 +168,7 @@ public final class Intercomm extends Comm
|
||||
/**
|
||||
* Java binding of {@code MPI_COMM_GET_PARENT}.
|
||||
* @return the parent communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Intercomm getParent() throws MPIException
|
||||
{
|
||||
|
||||
@ -103,7 +103,7 @@ public class Intracomm extends Comm
|
||||
* Duplicates this communicator.
|
||||
* <p>Java binding of {@code MPI_COMM_DUP}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public Intracomm dup() throws MPIException
|
||||
{
|
||||
@ -117,7 +117,7 @@ public class Intracomm extends Comm
|
||||
* <p>The new communicator can't be used before the operation completes.
|
||||
* The request object must be obtained calling {@link #getRequest}.
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public Intracomm iDup() throws MPIException
|
||||
{
|
||||
@ -130,7 +130,7 @@ public class Intracomm extends Comm
|
||||
* <p>Java binding of {@code MPI_COMM_DUP_WITH_INFO}.
|
||||
* @param info info object to associate with the new communicator
|
||||
* @return copy of this communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public Intracomm dupWithInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -145,7 +145,7 @@ public class Intracomm extends Comm
|
||||
* @param colour control of subset assignment
|
||||
* @param key control of rank assignment
|
||||
* @return new communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intracomm split(int colour, int key) throws MPIException
|
||||
{
|
||||
@ -163,7 +163,7 @@ public class Intracomm extends Comm
|
||||
* @param key control of rank assignment
|
||||
* @param info info argument
|
||||
* @return new communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intracomm splitType(int splitType, int key, Info info) throws MPIException
|
||||
{
|
||||
@ -178,7 +178,7 @@ public class Intracomm extends Comm
|
||||
* <p>Java binding of the MPI operation {@code MPI_COMM_CREATE}.
|
||||
* @param group group which is a subset of the group of this communicator
|
||||
* @return new communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intracomm create(Group group) throws MPIException
|
||||
{
|
||||
@ -194,7 +194,7 @@ public class Intracomm extends Comm
|
||||
* @param group group which is a subset of the group of this communicator
|
||||
* @param tag an integer tag
|
||||
* @return new communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intracomm createGroup(Group group, int tag) throws MPIException
|
||||
{
|
||||
@ -221,7 +221,7 @@ public class Intracomm extends Comm
|
||||
* @param reorder {@code true} if ranking may be reordered,
|
||||
* {@code false} if not
|
||||
* @return new cartesian topology communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final CartComm createCart(int[] dims, boolean[] periods, boolean reorder)
|
||||
throws MPIException
|
||||
@ -244,7 +244,7 @@ public class Intracomm extends Comm
|
||||
* @param reorder {@code true} if ranking may be reordered,
|
||||
* {@code false} if not
|
||||
* @return new graph topology communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final GraphComm createGraph(int[] index, int[] edges, boolean reorder)
|
||||
throws MPIException
|
||||
@ -269,7 +269,7 @@ public class Intracomm extends Comm
|
||||
* @param info hints on optimization and interpretation of weights
|
||||
* @param reorder the process may be reordered (true) or not (false)
|
||||
* @return communicator with distributed graph topology
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final GraphComm createDistGraph(
|
||||
int[] sources, int[] degrees, int[] destinations,
|
||||
@ -295,7 +295,7 @@ public class Intracomm extends Comm
|
||||
* @param info hints on optimization and interpretation of weights
|
||||
* @param reorder the process may be reordered (true) or not (false)
|
||||
* @return communicator with distributed graph topology
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final GraphComm createDistGraph(
|
||||
int[] sources, int[] degrees, int[] destinations,
|
||||
@ -330,7 +330,7 @@ public class Intracomm extends Comm
|
||||
* @param info hints on optimization and interpretation of weights
|
||||
* @param reorder the process may be reordered (true) or not (false)
|
||||
* @return communicator with distributed graph topology
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final GraphComm createDistGraphAdjacent(
|
||||
int[] sources, int[] sourceWeights,
|
||||
@ -358,7 +358,7 @@ public class Intracomm extends Comm
|
||||
* @param info hints on optimization and interpretation of weights
|
||||
* @param reorder the process may be reordered (true) or not (false)
|
||||
* @return communicator with distributed graph topology
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final GraphComm createDistGraphAdjacent(
|
||||
int[] sources, int[] destinations, Info info, boolean reorder)
|
||||
@ -385,7 +385,7 @@ public class Intracomm extends Comm
|
||||
* @param count number of items in input buffer
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scan(Object sendbuf, Object recvbuf,
|
||||
int count, Datatype type, Op op)
|
||||
@ -425,7 +425,7 @@ public class Intracomm extends Comm
|
||||
* @param count number of items in input buffer
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void scan(Object recvbuf, int count, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -460,7 +460,7 @@ public class Intracomm extends Comm
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScan(Buffer sendbuf, Buffer recvbuf,
|
||||
int count, Datatype type, Op op)
|
||||
@ -485,7 +485,7 @@ public class Intracomm extends Comm
|
||||
* @param type data type of each item in buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iScan(Buffer buf, int count, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -512,7 +512,7 @@ public class Intracomm extends Comm
|
||||
* @param count number of items in input buffer
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void exScan(Object sendbuf, Object recvbuf,
|
||||
int count, Datatype type, Op op)
|
||||
@ -552,7 +552,7 @@ public class Intracomm extends Comm
|
||||
* @param count number of items in input buffer
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void exScan(Object buf, int count, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -587,7 +587,7 @@ public class Intracomm extends Comm
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iExScan(Buffer sendbuf, Buffer recvbuf,
|
||||
int count, Datatype type, Op op)
|
||||
@ -612,7 +612,7 @@ public class Intracomm extends Comm
|
||||
* @param type data type of each item in input buffer
|
||||
* @param op reduce operation
|
||||
* @return communication request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request iExScan(Buffer buf, int count, Datatype type, Op op)
|
||||
throws MPIException
|
||||
@ -634,7 +634,7 @@ public class Intracomm extends Comm
|
||||
/**
|
||||
* Java binding of {@code MPI_OPEN_PORT} using {@code MPI_INFO_NULL}.
|
||||
* @return port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static String openPort() throws MPIException
|
||||
{
|
||||
@ -646,7 +646,7 @@ public class Intracomm extends Comm
|
||||
* Java binding of {@code MPI_OPEN_PORT}.
|
||||
* @param info implementation-specific information
|
||||
* @return port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static String openPort(Info info) throws MPIException
|
||||
{
|
||||
@ -659,7 +659,7 @@ public class Intracomm extends Comm
|
||||
/**
|
||||
* Java binding of {@code MPI_CLOSE_PORT}.
|
||||
* @param name port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void closePort(String name) throws MPIException
|
||||
{
|
||||
@ -674,7 +674,7 @@ public class Intracomm extends Comm
|
||||
* @param port port name
|
||||
* @param root rank in comm of root node
|
||||
* @return intercommunicator with client as remote group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm accept(String port, int root) throws MPIException
|
||||
{
|
||||
@ -688,7 +688,7 @@ public class Intracomm extends Comm
|
||||
* @param info implementation-specific information
|
||||
* @param root rank in comm of root node
|
||||
* @return intercommunicator with client as remote group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm accept(String port, Info info, int root)
|
||||
throws MPIException
|
||||
@ -705,7 +705,7 @@ public class Intracomm extends Comm
|
||||
* @param port port name
|
||||
* @param root rank in comm of root node
|
||||
* @return intercommunicator with server as remote group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm connect(String port, int root) throws MPIException
|
||||
{
|
||||
@ -719,7 +719,7 @@ public class Intracomm extends Comm
|
||||
* @param info implementation-specific information
|
||||
* @param root rank in comm of root node
|
||||
* @return intercommunicator with server as remote group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm connect(String port, Info info, int root)
|
||||
throws MPIException
|
||||
@ -735,7 +735,7 @@ public class Intracomm extends Comm
|
||||
* Java binding of {@code MPI_PUBLISH_NAME} using {@code MPI_INFO_NULL}.
|
||||
* @param service service name
|
||||
* @param port port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void publishName(String service, String port)
|
||||
throws MPIException
|
||||
@ -749,7 +749,7 @@ public class Intracomm extends Comm
|
||||
* @param service service name
|
||||
* @param info implementation-specific information
|
||||
* @param port port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void publishName(String service, Info info, String port)
|
||||
throws MPIException
|
||||
@ -765,7 +765,7 @@ public class Intracomm extends Comm
|
||||
* Java binding of {@code MPI_UNPUBLISH_NAME} using {@code MPI_INFO_NULL}.
|
||||
* @param service service name
|
||||
* @param port port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void unpublishName(String service, String port)
|
||||
throws MPIException
|
||||
@ -779,7 +779,7 @@ public class Intracomm extends Comm
|
||||
* @param service service name
|
||||
* @param info implementation-specific information
|
||||
* @param port port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void unpublishName(String service, Info info, String port)
|
||||
throws MPIException
|
||||
@ -795,7 +795,7 @@ public class Intracomm extends Comm
|
||||
* Java binding of {@code MPI_LOOKUP_NAME} using {@code MPI_INFO_NULL}.
|
||||
* @param service service name
|
||||
* @return port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static String lookupName(String service) throws MPIException
|
||||
{
|
||||
@ -808,7 +808,7 @@ public class Intracomm extends Comm
|
||||
* @param service service name
|
||||
* @param info implementation-specific information
|
||||
* @return port name
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static String lookupName(String service, Info info) throws MPIException
|
||||
{
|
||||
@ -832,7 +832,7 @@ public class Intracomm extends Comm
|
||||
* @param errcodes one code per process; if this parameter is null,
|
||||
* {@code MPI_ERRCODES_IGNORE} will be used.
|
||||
* @return intercommunicator between original group and the newly spawned group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm spawn(String command, String[] argv, int maxprocs,
|
||||
Info info, int root, int[] errcodes)
|
||||
@ -861,7 +861,7 @@ public class Intracomm extends Comm
|
||||
* @param errcodes one code per process; if this parameter is null,
|
||||
* {@code MPI_ERRCODES_IGNORE} will be used.
|
||||
* @return intercommunicator between original group and the newly spawned group
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Intercomm spawnMultiple(
|
||||
String[] commands, String[][] argv, int[] maxprocs,
|
||||
|
||||
@ -441,7 +441,7 @@ public final class MPI
|
||||
* <p>Java binding of the MPI operation {@code MPI_INIT}.
|
||||
* @param args arguments to the {@code main} method.
|
||||
* @return arguments
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static String[] Init(String[] args) throws MPIException
|
||||
{
|
||||
@ -461,7 +461,7 @@ public final class MPI
|
||||
* @param args arguments to the {@code main} method.
|
||||
* @param required desired level of thread support
|
||||
* @return provided level of thread support
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int InitThread(String[] args, int required) throws MPIException
|
||||
{
|
||||
@ -479,7 +479,7 @@ public final class MPI
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_QUERY_THREAD}.
|
||||
* @return provided level of thread support
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int queryThread() throws MPIException
|
||||
{
|
||||
@ -492,7 +492,7 @@ public final class MPI
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_IS_THREAD_MAIN}.
|
||||
* @return true if it is the main thread
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static boolean isThreadMain() throws MPIException
|
||||
{
|
||||
@ -505,7 +505,7 @@ public final class MPI
|
||||
/**
|
||||
* Finalize MPI.
|
||||
* <p>Java binding of the MPI operation {@code MPI_FINALIZE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void Finalize() throws MPIException
|
||||
{
|
||||
@ -520,7 +520,7 @@ public final class MPI
|
||||
* Returns an elapsed time on the calling processor.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WTIME}.
|
||||
* @return time in seconds since an arbitrary time in the past.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static double wtime() throws MPIException
|
||||
{
|
||||
@ -534,7 +534,7 @@ public final class MPI
|
||||
* Returns resolution of timer.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WTICK}.
|
||||
* @return resolution of {@code wtime} in seconds.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static double wtick() throws MPIException
|
||||
{
|
||||
@ -570,7 +570,7 @@ public final class MPI
|
||||
* Returns the name of the processor on which it is called.
|
||||
* <p>Java binding of the MPI operation {@code MPI_GET_PROCESSOR_NAME}.
|
||||
* @return A unique specifier for the actual node.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
static public String getProcessorName() throws MPIException
|
||||
{
|
||||
@ -587,7 +587,7 @@ public final class MPI
|
||||
* <p>Java binding of the MPI operation {@code MPI_INITIALIZED}.
|
||||
* @return {@code true} if {@code Init} has been called,
|
||||
* {@code false} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
static public native boolean isInitialized() throws MPIException;
|
||||
|
||||
@ -596,7 +596,7 @@ public final class MPI
|
||||
* <p>Java binding of the MPI operation {@code MPI_FINALIZED}.
|
||||
* @return {@code true} if {@code Finalize} has been called,
|
||||
* {@code false} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
static public native boolean isFinalized() throws MPIException;
|
||||
|
||||
@ -604,7 +604,7 @@ public final class MPI
|
||||
* Attaches a user-provided buffer for sending.
|
||||
* <p>Java binding of the MPI operation {@code MPI_BUFFER_ATTACH}.
|
||||
* @param buffer initial buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
static public void attachBuffer(byte[] buffer) throws MPIException
|
||||
{
|
||||
@ -619,7 +619,7 @@ public final class MPI
|
||||
* Removes an existing buffer (for use in sending).
|
||||
* <p>Java binding of the MPI operation {@code MPI_BUFFER_DETACH}.
|
||||
* @return initial buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
static public byte[] detachBuffer() throws MPIException
|
||||
{
|
||||
@ -646,7 +646,7 @@ public final class MPI
|
||||
|
||||
/**
|
||||
* Check if MPI has been initialized and hasn't been finalized.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
protected static void check() throws MPIException
|
||||
{
|
||||
|
||||
@ -43,12 +43,15 @@
|
||||
* Updated : $Date: 1999/09/14 22:01:52 $
|
||||
* Copyright: Northeast Parallel Architectures Center
|
||||
* at Syracuse University 1999
|
||||
*
|
||||
* Sidenote from August 2020: this class probably should have been
|
||||
* called MPIError, not MPIException.
|
||||
*/
|
||||
|
||||
package mpi;
|
||||
|
||||
/**
|
||||
* Signals that an MPI exception of some sort has occurred.
|
||||
* Signals that an MPI error of some sort has occurred.
|
||||
* <p>The Java binding of the MPI operation {@code MPI_Error_string} is the
|
||||
* method {@code getMessage}, which is inherited from the class Exception.
|
||||
*/
|
||||
@ -65,7 +68,7 @@ public final class MPIException extends Exception
|
||||
|
||||
/**
|
||||
* Creates an exception.
|
||||
* @param message message associated to the exception
|
||||
* @param message message associated to the error
|
||||
*/
|
||||
public MPIException(String message)
|
||||
{
|
||||
@ -74,7 +77,7 @@ public final class MPIException extends Exception
|
||||
|
||||
/**
|
||||
* Creates an exception:
|
||||
* @param cause cause associated to the exception
|
||||
* @param cause cause associated to the error
|
||||
*/
|
||||
public MPIException(Throwable cause)
|
||||
{
|
||||
|
||||
@ -78,7 +78,7 @@ public final class Message
|
||||
* @param tag message tag
|
||||
* @param comm communicator
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status mProbe(int source, int tag, Comm comm) throws MPIException
|
||||
{
|
||||
@ -97,7 +97,7 @@ public final class Message
|
||||
* @param tag message tag
|
||||
* @param comm communicator
|
||||
* @return status object if there is a message, {@code null} otherwise
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status imProbe(int source, int tag, Comm comm) throws MPIException
|
||||
{
|
||||
@ -114,7 +114,7 @@ public final class Message
|
||||
* @param count number of elements in receve buffer
|
||||
* @param type datatype of each receive buffer element
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Status mRecv(Object buf, int count, Datatype type) throws MPIException
|
||||
{
|
||||
@ -145,7 +145,7 @@ public final class Message
|
||||
* @param count number of elements in receve buffer
|
||||
* @param type datatype of each receive buffer element
|
||||
* @return request object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request imRecv(Buffer buf, int count, Datatype type)
|
||||
throws MPIException
|
||||
|
||||
@ -121,7 +121,7 @@ public final class Op implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_OP_FREE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public native void free() throws MPIException;
|
||||
|
||||
|
||||
@ -68,7 +68,7 @@ public final class Prequest extends Request
|
||||
* one of the {@code wait} or {@code test} operations.
|
||||
* On successful completion the request becomes inactive again.
|
||||
* It can be reactivated by a further call to {@code Start}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void start() throws MPIException
|
||||
{
|
||||
@ -81,7 +81,7 @@ public final class Prequest extends Request
|
||||
* Activate a list of communication requests.
|
||||
* <p>Java binding of the MPI operation {@code MPI_STARTALL}.
|
||||
* @param requests array of requests
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void startAll(Prequest[] requests) throws MPIException
|
||||
{
|
||||
|
||||
@ -107,7 +107,7 @@ public class Request implements Freeable
|
||||
/**
|
||||
* Mark a pending nonblocking communication for cancellation.
|
||||
* Java binding of the MPI operation {@code MPI_CANCEL}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void cancel() throws MPIException
|
||||
{
|
||||
@ -157,7 +157,7 @@ public class Request implements Freeable
|
||||
* <p>Java binding of the MPI operation {@code MPI_WAIT}.
|
||||
* <p>After the call returns, the request object becomes inactive.
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Status waitStatus() throws MPIException
|
||||
{
|
||||
@ -173,7 +173,7 @@ public class Request implements Freeable
|
||||
* Blocks until the operation identified by the request is complete.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WAIT}.
|
||||
* <p>After the call returns, the request object becomes inactive.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final void waitFor() throws MPIException
|
||||
{
|
||||
@ -190,7 +190,7 @@ public class Request implements Freeable
|
||||
* <p>After the call, if the operation is complete (ie, if the return
|
||||
* value is non-null), the request object becomes inactive.
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Status testStatus() throws MPIException
|
||||
{
|
||||
@ -207,7 +207,7 @@ public class Request implements Freeable
|
||||
* <p>After the call, if the operation is complete (ie, if the return
|
||||
* value is non-null), the request object remains active.
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Status getStatus() throws MPIException
|
||||
{
|
||||
@ -224,7 +224,7 @@ public class Request implements Freeable
|
||||
* <p>After the call, if the operation is complete (ie, if the return
|
||||
* value is true), the request object becomes inactive.
|
||||
* @return true if the operation identified by the request, false otherwise
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final boolean test() throws MPIException
|
||||
{
|
||||
@ -244,7 +244,7 @@ public class Request implements Freeable
|
||||
* of array of {@code requests} becomes inactive.
|
||||
* @param requests array of requests
|
||||
* @return status object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Status waitAnyStatus(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -268,7 +268,7 @@ public class Request implements Freeable
|
||||
* @return The index in array of {@code requests} for the request that
|
||||
* completed. If all of the requests are MPI_REQUEST_NULL, then index
|
||||
* is returned as {@code MPI.UNDEFINED}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int waitAny(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -291,7 +291,7 @@ public class Request implements Freeable
|
||||
* If no request completed, {@code testAnyStatus} returns {@code null}.
|
||||
* @param requests array of requests
|
||||
* @return status object if one request completed, {@code null} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Status testAnyStatus(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -312,7 +312,7 @@ public class Request implements Freeable
|
||||
* @param requests array of requests
|
||||
* @return index of operation that completed, or {@code MPI.UNDEFINED}
|
||||
* if none completed.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int testAny(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -334,7 +334,7 @@ public class Request implements Freeable
|
||||
* elements of the status array will contain null status references.
|
||||
* @param requests array of requests
|
||||
* @return array of statuses
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Status[] waitAllStatus(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -353,7 +353,7 @@ public class Request implements Freeable
|
||||
* requests in the array have completed.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WAITALL}.
|
||||
* @param requests array of requests
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void waitAll(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -374,7 +374,7 @@ public class Request implements Freeable
|
||||
* @param requests array of requests
|
||||
* @return array of statuses if all operations have completed,
|
||||
* {@code null} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Status[] testAllStatus(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -395,7 +395,7 @@ public class Request implements Freeable
|
||||
* @param requests array of requests
|
||||
* @return {@code true} if all operations have completed,
|
||||
* {@code false} otherwise.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static boolean testAll(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -420,7 +420,7 @@ public class Request implements Freeable
|
||||
* @param requests array of requests
|
||||
* @return array of statuses or {@code null} if the number of operations
|
||||
* completed is {@code MPI_UNDEFINED}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Status[] waitSomeStatus(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -444,7 +444,7 @@ public class Request implements Freeable
|
||||
* @param requests array of requests
|
||||
* @return array of indexes of {@code requests} that completed or {@code null}
|
||||
* if the number of operations completed is {@code MPI_UNDEFINED}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int[] waitSome(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -464,7 +464,7 @@ public class Request implements Freeable
|
||||
* length zero, otherwise the return value are as for {@code waitSome}.
|
||||
* @param requests array of requests
|
||||
* @return array of statuses
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static Status[] testSomeStatus(Request[] requests) throws MPIException
|
||||
{
|
||||
@ -485,7 +485,7 @@ public class Request implements Freeable
|
||||
* length zero, otherwise the return value are as for {@code waitSome}.
|
||||
* @param requests array of requests
|
||||
* @return array of indexes of {@code requests} that completed.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int[] testSome(Request[] requests) throws MPIException
|
||||
{
|
||||
|
||||
@ -74,7 +74,7 @@ public final class Status
|
||||
* <p>Java binding of the MPI operation {@code MPI_GET_COUNT}.
|
||||
* @param datatype datatype of each item in receive buffer
|
||||
* @return number of received entries
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getCount(Datatype datatype) throws MPIException
|
||||
{
|
||||
@ -96,7 +96,7 @@ public final class Status
|
||||
* Tests if the communication was cancelled.
|
||||
* <p>Java binding of the MPI operation {@code MPI_TEST_CANCELLED}.
|
||||
* @return true if the operation was succesfully cancelled, false otherwise
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public boolean isCancelled() throws MPIException
|
||||
{
|
||||
@ -119,7 +119,7 @@ public final class Status
|
||||
* <p>Java binding of the MPI operation {@code MPI_GET_ELEMENTS}.
|
||||
* @param datatype datatype used by receive operation
|
||||
* @return number of received basic elements
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public int getElements(Datatype datatype) throws MPIException
|
||||
{
|
||||
@ -142,7 +142,7 @@ public final class Status
|
||||
* <p>Java binding of the MPI operation {@code MPI_GET_ELEMENTS_X}.
|
||||
* @param datatype datatype used by receive operation
|
||||
* @return number of received basic elements
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Count getElementsX(Datatype datatype) throws MPIException
|
||||
{
|
||||
@ -165,7 +165,7 @@ public final class Status
|
||||
* <p>Java binding of the MPI operation {@code MPI_STATUS_SET_ELEMENTS}.
|
||||
* @param datatype datatype used by receive operation
|
||||
* @param count number of elements to associate with the status
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setElements(Datatype datatype, int count) throws MPIException
|
||||
{
|
||||
@ -188,7 +188,7 @@ public final class Status
|
||||
* <p>Java binding of the MPI operation {@code MPI_STATUS_SET_ELEMENTS_X}.
|
||||
* @param datatype datatype used by receive operation
|
||||
* @param count number of elements to associate with the status
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setElementsX(Datatype datatype, Count count) throws MPIException
|
||||
{
|
||||
@ -210,7 +210,7 @@ public final class Status
|
||||
* Sets the cancelled flag.
|
||||
* <p>Java binding of the MPI operation {@code MPI_STATUS_SET_CANCELLED}.
|
||||
* @param flag if true indicates request was cancelled
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setCancelled(boolean flag) throws MPIException
|
||||
{
|
||||
|
||||
@ -66,7 +66,7 @@ public abstract class Struct
|
||||
/**
|
||||
* Returns the extent of the struct data type.
|
||||
* @return Extent of the struct data type.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int getExtent() throws MPIException
|
||||
{
|
||||
@ -77,7 +77,7 @@ public abstract class Struct
|
||||
/**
|
||||
* Returns the data type of the struct.
|
||||
* @return The data type of the struct.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Datatype getType() throws MPIException
|
||||
{
|
||||
@ -105,7 +105,7 @@ public abstract class Struct
|
||||
* Gets a Data object in order to access to the buffer.
|
||||
* @param buffer the Data object will read/write on this buffer.
|
||||
* @return Data object
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final <T extends Data> T getData(ByteBuffer buffer) throws MPIException
|
||||
{
|
||||
@ -120,7 +120,7 @@ public abstract class Struct
|
||||
* @param buffer The Data object will read/write on this buffer.
|
||||
* @param index Index of the struct in the buffer.
|
||||
* @return Data object.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final <T extends Data> T getData(ByteBuffer buffer, int index)
|
||||
throws MPIException
|
||||
@ -134,7 +134,7 @@ public abstract class Struct
|
||||
* Gets a Data object in order to access to the byte array.
|
||||
* @param array The Data object will read/write on this byte array.
|
||||
* @return Data object.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final <T extends Data> T getData(byte[] array) throws MPIException
|
||||
{
|
||||
@ -150,7 +150,7 @@ public abstract class Struct
|
||||
* @param array The Data object will read/write on this byte array.
|
||||
* @param index Index of the struct in the array.
|
||||
* @return Data object.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final <T extends Data> T getData(byte[] array, int index)
|
||||
throws MPIException
|
||||
@ -329,7 +329,7 @@ public abstract class Struct
|
||||
* Adds a struct field to this struct.
|
||||
* @param struct Type of the field.
|
||||
* @return Offset of the new field.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int addStruct(Struct struct) throws MPIException
|
||||
{
|
||||
@ -341,7 +341,7 @@ public abstract class Struct
|
||||
* @param struct Type of the array.
|
||||
* @param length Length of the array.
|
||||
* @return Offset of the new field.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int addStruct(Struct struct, int length) throws MPIException
|
||||
{
|
||||
@ -353,7 +353,7 @@ public abstract class Struct
|
||||
* Adds a field of the specified data type.
|
||||
* @param type Data type.
|
||||
* @return Offset of the new field.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int addData(Datatype type) throws MPIException
|
||||
{
|
||||
@ -365,7 +365,7 @@ public abstract class Struct
|
||||
* @param type Data type.
|
||||
* @param length Length of the array.
|
||||
* @return Offset of the new field.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final int addData(Datatype type, int length) throws MPIException
|
||||
{
|
||||
@ -784,7 +784,7 @@ public abstract class Struct
|
||||
* @param field Offset of the buffer array.
|
||||
* @param index Index of the buffer in the array.
|
||||
* @return Buffer object.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
protected final ByteBuffer getBuffer(Datatype type, int field, int index)
|
||||
throws MPIException
|
||||
|
||||
@ -60,7 +60,7 @@ public abstract class UserFunction
|
||||
* @param inOutVec in-out array of accumulator locations
|
||||
* @param count number of items in arrays
|
||||
* @param datatype type of each item
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void call(Object inVec, Object inOutVec, int count, Datatype datatype)
|
||||
throws MPIException
|
||||
@ -74,7 +74,7 @@ public abstract class UserFunction
|
||||
* @param inOut in-out direct byte buffer of accumulator locations
|
||||
* @param count number of items in buffers
|
||||
* @param datatype type of each item
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void call(ByteBuffer in, ByteBuffer inOut, int count, Datatype datatype)
|
||||
throws MPIException
|
||||
|
||||
@ -42,7 +42,7 @@ public final class Win implements Freeable
|
||||
* @param dispUnit local unit size for displacements (buffer elements)
|
||||
* @param info info object
|
||||
* @param comm communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Win(Buffer base, int size, int dispUnit, Info info, Comm comm)
|
||||
throws MPIException
|
||||
@ -81,7 +81,7 @@ public final class Win implements Freeable
|
||||
* @param comm communicator
|
||||
* @param base initial address of window
|
||||
* @param flavor FLAVOR_PRIVATE or FLAVOR_SHARED
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Win(int size, int dispUnit, Info info, Comm comm, Buffer base, int flavor)
|
||||
throws MPIException
|
||||
@ -124,7 +124,7 @@ public final class Win implements Freeable
|
||||
* Java binding of {@code MPI_WIN_CREATE_DYNAMIC}.
|
||||
* @param info info object
|
||||
* @param comm communicator
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Win(Info info, Comm comm)
|
||||
throws MPIException
|
||||
@ -154,7 +154,7 @@ public final class Win implements Freeable
|
||||
* Java binding of {@code MPI_WIN_ATTACH}.
|
||||
* @param base initial address of window
|
||||
* @param size size of window (buffer elements)
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void attach(Buffer base, int size) throws MPIException
|
||||
{
|
||||
@ -185,7 +185,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of {@code MPI_WIN_DETACH}.
|
||||
* @param base initial address of window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void detach(Buffer base) throws MPIException
|
||||
{
|
||||
@ -201,7 +201,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_GET_GROUP}.
|
||||
* @return group of processes which share access to the window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Group getGroup() throws MPIException
|
||||
{
|
||||
@ -220,7 +220,7 @@ public final class Win implements Freeable
|
||||
* @param targetDisp displacement from start of window to target buffer
|
||||
* @param targetCount number of entries in target buffer
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void put(Buffer origin, int orgCount, Datatype orgType,
|
||||
int targetRank, int targetDisp, int targetCount,
|
||||
@ -251,7 +251,7 @@ public final class Win implements Freeable
|
||||
* @param targetDisp displacement from start of window to target buffer
|
||||
* @param targetCount number of entries in target buffer
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void get(Buffer origin, int orgCount, Datatype orgType,
|
||||
int targetRank, int targetDisp, int targetCount,
|
||||
@ -283,7 +283,7 @@ public final class Win implements Freeable
|
||||
* @param targetCount number of entries in target buffer
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void accumulate(Buffer origin, int orgCount, Datatype orgType,
|
||||
int targetRank, int targetDisp, int targetCount,
|
||||
@ -308,7 +308,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of {@code MPI_WIN_FENCE}.
|
||||
* @param assertion program assertion
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void fence(int assertion) throws MPIException
|
||||
{
|
||||
@ -322,7 +322,7 @@ public final class Win implements Freeable
|
||||
* Java binding of the MPI operation {@code MPI_WIN_START}.
|
||||
* @param group group of target processes
|
||||
* @param assertion program assertion
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void start(Group group, int assertion) throws MPIException
|
||||
{
|
||||
@ -335,7 +335,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_COMPLETE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void complete() throws MPIException
|
||||
{
|
||||
@ -349,7 +349,7 @@ public final class Win implements Freeable
|
||||
* Java binding of the MPI operation {@code MPI_WIN_POST}.
|
||||
* @param group group of origin processes
|
||||
* @param assertion program assertion
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void post(Group group, int assertion) throws MPIException
|
||||
{
|
||||
@ -362,7 +362,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_WAIT}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void waitFor() throws MPIException
|
||||
{
|
||||
@ -375,7 +375,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_TEST}.
|
||||
* @return true if success
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public boolean test() throws MPIException
|
||||
{
|
||||
@ -390,7 +390,7 @@ public final class Win implements Freeable
|
||||
* @param lockType either MPI.LOCK_EXCLUSIVE or MPI.LOCK_SHARED
|
||||
* @param rank rank of locked window
|
||||
* @param assertion program assertion
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void lock(int lockType, int rank, int assertion) throws MPIException
|
||||
{
|
||||
@ -404,7 +404,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_UNLOCK}.
|
||||
* @param rank rank of window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void unlock(int rank) throws MPIException
|
||||
{
|
||||
@ -417,7 +417,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_SET_ERRHANDLER}.
|
||||
* @param errhandler new MPI error handler for window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setErrhandler(Errhandler errhandler) throws MPIException
|
||||
{
|
||||
@ -431,7 +431,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_GET_ERRHANDLER}.
|
||||
* @return MPI error handler currently associated with window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Errhandler getErrhandler() throws MPIException
|
||||
{
|
||||
@ -444,7 +444,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_CALL_ERRHANDLER}.
|
||||
* @param errorCode error code
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void callErrhandler(int errorCode) throws MPIException
|
||||
{
|
||||
@ -458,7 +458,7 @@ public final class Win implements Freeable
|
||||
* Create a new attribute key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WIN_CREATE_KEYVAL}.
|
||||
* @return attribute key for future access
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static int createKeyval() throws MPIException
|
||||
{
|
||||
@ -472,7 +472,7 @@ public final class Win implements Freeable
|
||||
* Frees an attribute key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WIN_FREE_KEYVAL}.
|
||||
* @param keyval attribute key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public static void freeKeyval(int keyval) throws MPIException
|
||||
{
|
||||
@ -487,7 +487,7 @@ public final class Win implements Freeable
|
||||
* <p>Java binding of the MPI operation {@code MPI_WIN_SET_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @param value attribute value
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setAttr(int keyval, Object value) throws MPIException
|
||||
{
|
||||
@ -503,7 +503,7 @@ public final class Win implements Freeable
|
||||
* <p>Java binding of the MPI operation {@code MPI_WIN_GET_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @return attribute value or null if no attribute is associated with the key.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Object getAttr(int keyval) throws MPIException
|
||||
{
|
||||
@ -518,7 +518,7 @@ public final class Win implements Freeable
|
||||
* Deletes an attribute value associated with a key.
|
||||
* <p>Java binding of the MPI operation {@code MPI_WIN_DELETE_ATTR}.
|
||||
* @param keyval attribute key
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void deleteAttr(int keyval) throws MPIException
|
||||
{
|
||||
@ -530,7 +530,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of {@code MPI_WIN_FREE}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
@Override public void free() throws MPIException
|
||||
{
|
||||
@ -543,7 +543,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_GET_INFO}.
|
||||
* @return Info Info object associated with this window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Info getInfo() throws MPIException
|
||||
{
|
||||
@ -557,7 +557,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_SET_INFO}.
|
||||
* @param info the new info
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setInfo(Info info) throws MPIException
|
||||
{
|
||||
@ -578,7 +578,7 @@ public final class Win implements Freeable
|
||||
* @param target_count number of entries in target buffer
|
||||
* @param target_datatype datatype of each entry in target buffer
|
||||
* @return RMA request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request rPut(Buffer origin_addr, int origin_count,
|
||||
Datatype origin_datatype, int target_rank, int target_disp,
|
||||
@ -609,7 +609,7 @@ public final class Win implements Freeable
|
||||
* @param targetCount number of entries in target buffer
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @return RMA request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public final Request rGet(Buffer origin, int orgCount, Datatype orgType,
|
||||
int targetRank, int targetDisp, int targetCount,
|
||||
@ -643,7 +643,7 @@ public final class Win implements Freeable
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @param op reduce operation
|
||||
* @return RMA request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public Request rAccumulate(Buffer origin, int orgCount, Datatype orgType,
|
||||
int targetRank, int targetDisp, int targetCount,
|
||||
@ -679,7 +679,7 @@ public final class Win implements Freeable
|
||||
* @param targetCount number of entries in target buffer
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
|
||||
public void getAccumulate(Buffer origin, int orgCount, Datatype orgType,
|
||||
@ -719,7 +719,7 @@ public final class Win implements Freeable
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @param op reduce operation
|
||||
* @return RMA request
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
|
||||
public Request rGetAccumulate(Buffer origin, int orgCount, Datatype orgType,
|
||||
@ -749,7 +749,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_LOCK_ALL}.
|
||||
* @param assertion program assertion
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void lockAll(int assertion) throws MPIException
|
||||
{
|
||||
@ -762,7 +762,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_UNLOCK_ALL}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void unlockAll() throws MPIException
|
||||
{
|
||||
@ -774,7 +774,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_SYNC}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void sync() throws MPIException
|
||||
{
|
||||
@ -787,7 +787,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_FLUSH}.
|
||||
* @param targetRank rank of target window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void flush(int targetRank) throws MPIException
|
||||
{
|
||||
@ -799,7 +799,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_FLUSH_ALL}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void flushAll() throws MPIException
|
||||
{
|
||||
@ -817,7 +817,7 @@ public final class Win implements Freeable
|
||||
* @param targetType datatype of each entry in target buffer
|
||||
* @param targetRank rank of target
|
||||
* @param targetDisp displacement from start of window to target buffer
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
|
||||
public void compareAndSwap(Buffer origin, Buffer compareAddr, Buffer resultAddr,
|
||||
@ -845,7 +845,7 @@ public final class Win implements Freeable
|
||||
* @param targetRank rank of target
|
||||
* @param targetDisp displacement from start of window to target buffer
|
||||
* @param op reduce operation
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
|
||||
public void fetchAndOp(Buffer origin, Buffer resultAddr, Datatype dataType,
|
||||
@ -868,7 +868,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_FLUSH_LOCAL}.
|
||||
* @param targetRank rank of target window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
|
||||
public void flushLocal(int targetRank) throws MPIException
|
||||
@ -881,7 +881,7 @@ public final class Win implements Freeable
|
||||
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_FLUSH_LOCAL_ALL}.
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
|
||||
public void flushLocalAll() throws MPIException
|
||||
@ -895,7 +895,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_GET_NAME}.
|
||||
* @return the name associated with this window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public String getName() throws MPIException
|
||||
{
|
||||
@ -908,7 +908,7 @@ public final class Win implements Freeable
|
||||
/**
|
||||
* Java binding of the MPI operation {@code MPI_WIN_SET_NAME}.
|
||||
* @param name the name to associate with this window
|
||||
* @throws MPIException Signals that an MPI exception of some sort has occurred.
|
||||
* @throws MPIException Signals that an MPI error of some sort has occurred.
|
||||
*/
|
||||
public void setName(String name) throws MPIException
|
||||
{
|
||||
|
||||
@ -46,7 +46,7 @@ Fortran only: Error status (integer).
|
||||
.ft R
|
||||
Note that use of this routine is \fIdeprecated\fP as of MPI-2. Please use MPI_Comm_create_errhandler instead.
|
||||
.sp
|
||||
Registers the user routine function for use as an MPI exception handler. Returns in errhandler a handle to the registered exception handler.
|
||||
Registers the user routine function for use as an MPI error handler. Returns in errhandler a handle to the registered error handler.
|
||||
.sp
|
||||
In the C language, the user routine should be a C function of type MPI_Handler_function, which is defined as
|
||||
.sp
|
||||
|
||||
@ -61,7 +61,7 @@ Fortran only: Error status (integer).
|
||||
|
||||
.SH DESCRIPTION
|
||||
.ft R
|
||||
Registers the user routine \fIfunction\fP for use as an MPI exception handler. Returns in errhandler a handle to the registered exception handler.
|
||||
Registers the user routine \fIfunction\fP for use as an MPI error handler. Returns in errhandler a handle to the registered error handler.
|
||||
.sp
|
||||
In the C language, the user routine \fIfunction\fP should be a C function of type MPI_File_errhandler_function, which is defined as
|
||||
.sp
|
||||
|
||||
@ -80,7 +80,7 @@ is returned instead.
|
||||
.SH ERRORS
|
||||
If the value to be returned is larger than can fit into the
|
||||
.I count
|
||||
parameter, an MPI_ERR_TRUNCATE exception is invoked.
|
||||
parameter, an MPI_ERR_TRUNCATE error is raised.
|
||||
.sp
|
||||
Almost all MPI routines return an error value; C routines as the value of the function and Fortran routines in the last argument.
|
||||
.sp
|
||||
|
||||
@ -51,7 +51,7 @@ Fortran only: Error status (integer).
|
||||
.SH DESCRIPTION
|
||||
.ft R
|
||||
This routine, or MPI_Init_thread, must be called before most other MPI
|
||||
routines are called. There are a small number of exceptions, such as
|
||||
routines are called. There are a small number of errors, such as
|
||||
MPI_Initialized and MPI_Finalized. MPI can be initialized at most
|
||||
once; subsequent calls to MPI_Init or MPI_Init_thread are erroneous.
|
||||
.sp
|
||||
|
||||
@ -82,7 +82,7 @@ generated the request); the predefined error handler MPI_ERRORS_RETURN
|
||||
may be used to cause error values to be returned. Note that MPI does
|
||||
not guarantee that an MPI program can continue past an error.
|
||||
.sp
|
||||
Note that per MPI-1 section 3.2.5, MPI exceptions on requests passed
|
||||
Note that per MPI-1 section 3.2.5, MPI errors on requests passed
|
||||
to MPI_TEST do not set the status.MPI_ERROR field in the returned
|
||||
status. The error code is passed to the back-end error handler
|
||||
and may be passed back to the caller through the return value of
|
||||
|
||||
@ -78,10 +78,10 @@ and neither \fIarray_of_requests\fP nor \fIarray_of_statuses\fP is modified.
|
||||
|
||||
.SH ERRORS
|
||||
For each invocation of MPI_Testall, if one or more requests generate
|
||||
an MPI exception, only the \fIfirst\fP MPI request that caused an
|
||||
exception will be passed to its corresponding error handler. No other
|
||||
an MPI error, only the \fIfirst\fP MPI request that caused an
|
||||
error will be passed to its corresponding error handler. No other
|
||||
error handlers will be invoked (even if multiple requests generated
|
||||
exceptions). However, \fIall\fP requests that generate an exception
|
||||
errors). However, \fIall\fP requests that generate an error
|
||||
will have a relevant error code set in the corresponding
|
||||
status.MPI_ERROR field (unless MPI_STATUSES_IGNORE was used).
|
||||
.sp
|
||||
|
||||
@ -87,7 +87,7 @@ generated the request); the predefined error handler MPI_ERRORS_RETURN
|
||||
may be used to cause error values to be returned. Note that MPI does
|
||||
not guarantee that an MPI program can continue past an error.
|
||||
.sp
|
||||
Note that per MPI-1 section 3.2.5, MPI exceptions on requests passed
|
||||
Note that per MPI-1 section 3.2.5, MPI errors on requests passed
|
||||
to MPI_TESTANY do not set the status.MPI_ERROR field in the returned
|
||||
status. The error code is passed to the back-end error handler and
|
||||
may be passed back to the caller through the return value of
|
||||
|
||||
@ -98,10 +98,10 @@ A server with multiple clients can use MPI_Waitsome so as not to starve any clie
|
||||
|
||||
.SH ERRORS
|
||||
For each invocation of MPI_Testsome, if one or more requests generate
|
||||
an MPI exception, only the \fIfirst\fP MPI request that caused an
|
||||
exception will be passed to its corresponding error handler. No other
|
||||
an MPI error, only the \fIfirst\fP MPI request that caused an
|
||||
error will be passed to its corresponding error handler. No other
|
||||
error handlers will be invoked (even if multiple requests generated
|
||||
exceptions). However, \fIall\fP requests that generate an exception
|
||||
errors). However, \fIall\fP requests that generate an error
|
||||
will have a relevant error code set in the corresponding
|
||||
status.MPI_ERROR field (unless MPI_STATUSES_IGNORE was used).
|
||||
.sp
|
||||
|
||||
@ -88,7 +88,7 @@ generated the request); the predefined error handler MPI_ERRORS_RETURN
|
||||
may be used to cause error values to be returned. Note that MPI does
|
||||
not guarantee that an MPI program can continue past an error.
|
||||
.sp
|
||||
Note that per MPI-1 section 3.2.5, MPI exceptions on requests passed
|
||||
Note that per MPI-1 section 3.2.5, MPI errors on requests passed
|
||||
to MPI_WAIT do not set the status.MPI_ERROR field in the returned
|
||||
status. The error code is passed to the back-end error handler
|
||||
and may be passed back to the caller through the return value of
|
||||
|
||||
@ -67,10 +67,10 @@ If your application does not need to examine the \fIarray_of_statuses\fP field,
|
||||
|
||||
.SH ERRORS
|
||||
For each invocation of MPI_Waitall, if one or more requests generate
|
||||
an MPI exception, only the \fIfirst\fP MPI request that caused an
|
||||
exception will be passed to its corresponding error handler. No other
|
||||
an MPI error, only the \fIfirst\fP MPI request that caused an
|
||||
error will be passed to its corresponding error handler. No other
|
||||
error handlers will be invoked (even if multiple requests generated
|
||||
exceptions). However, \fIall\fP requests that generate an exception
|
||||
errors). However, \fIall\fP requests that generate an error
|
||||
will have a relevant error code set in the corresponding
|
||||
status.MPI_ERROR field (unless MPI_STATUSES_IGNORE was used).
|
||||
.sp
|
||||
|
||||
@ -108,7 +108,7 @@ generated the request); the predefined error handler MPI_ERRORS_RETURN
|
||||
may be used to cause error values to be returned. Note that MPI does
|
||||
not guarantee that an MPI program can continue past an error.
|
||||
.sp
|
||||
Note that per MPI-1 section 3.2.5, MPI exceptions on requests passed
|
||||
Note that per MPI-1 section 3.2.5, MPI errors on requests passed
|
||||
to MPI_WAITANY do not set the status.MPI_ERROR field in the returned
|
||||
status. The error code is passed to the back-end error handler and
|
||||
may be passed back to the caller through the return value of
|
||||
|
||||
@ -110,10 +110,10 @@ The array of indices are in the range 0 to incount-1 for C and in the range 1 to
|
||||
|
||||
.SH ERRORS
|
||||
For each invocation of MPI_Waitsome, if one or more requests generate
|
||||
an MPI exception, only the \fIfirst\fP MPI request that caused an
|
||||
exception will be passed to its corresponding error handler. No other
|
||||
an MPI error, only the \fIfirst\fP MPI request that caused an
|
||||
error will be passed to its corresponding error handler. No other
|
||||
error handlers will be invoked (even if multiple requests generated
|
||||
exceptions). However, \fIall\fP requests that generate an exception
|
||||
errors). However, \fIall\fP requests that generate an error
|
||||
will have a relevant error code set in the corresponding
|
||||
status.MPI_ERROR field (unless MPI_STATUSES_IGNORE was used).
|
||||
.sp
|
||||
|
||||
@ -119,7 +119,7 @@ int ompi_mpi_finalize(void)
|
||||
if (state < OMPI_MPI_STATE_INIT_COMPLETED ||
|
||||
state >= OMPI_MPI_STATE_FINALIZE_STARTED) {
|
||||
/* Note that if we're not initialized or already finalized, we
|
||||
cannot raise an MPI exception. The best that we can do is
|
||||
cannot raise an MPI error. The best that we can do is
|
||||
write something to stderr. */
|
||||
const char *hostname;
|
||||
pid_t pid = getpid();
|
||||
|
||||
@ -75,7 +75,7 @@ OMPI_DECLSPEC extern int ompi_debug_show_mpi_alloc_mem_leaks;
|
||||
* Whether or not to actually free MPI handles when their
|
||||
* corresponding destructor is invoked. If enabled, Open MPI will not
|
||||
* free handles, but will rather simply mark them as "freed". Any
|
||||
* attempt to use them will result in an MPI exception.
|
||||
* attempt to use them will result in an MPI error.
|
||||
*
|
||||
* This is good debugging for user applications to find out if they
|
||||
* are inadvertantly using MPI handles after they have been freed.
|
||||
|
||||
Загрузка…
Ссылка в новой задаче
Block a user