e4e3e411fc
Includes all MPI functions supported by Open MPI, including MPI-3 functions (as of about 2 weeks ago). Many changes compared to the prior generation of Java bindings; not much is left from the prior generation, actually. The changes include (but are not limited to): * Add support for more than just a subset of MPI-1 functions * Use typical Java case for symbol names * Support Java Direct buffers (giving darn-near "native C" performance) * Support "type struct" better than the prior generation * Make more of an effort for the Java bindings to be a thin layer over the back-end C bindings * ...and more A proper README with more information about what is supported, how to use these bindings, etc. will be committed shortly. This commit was SVN r29263.
115 строки
2.9 KiB
Java
115 строки
2.9 KiB
Java
/*
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
/*
|
|
* File : Intercomm.java
|
|
* Author : Xinying Li
|
|
* Created : Thu Apr 9 12:22:15 1998
|
|
* Revision : $Revision: 1.5 $
|
|
* Updated : $Date: 1999/09/14 20:50:11 $
|
|
* Copyright: Northeast Parallel Architectures Center
|
|
* at Syracuse University 1998
|
|
*/
|
|
|
|
package mpi;
|
|
|
|
/**
|
|
* This class represents intercommunicators.
|
|
*/
|
|
public final class Intercomm extends Comm
|
|
{
|
|
protected Intercomm(long handle)
|
|
{
|
|
super(handle);
|
|
}
|
|
|
|
/**
|
|
* Duplicate this communicator.
|
|
* <p>Java binding of the MPI operation {@code MPI_COMM_DUP}.
|
|
* <p>The new communicator is "congruent" to the old one,
|
|
* but has a different context.
|
|
* @return copy of this communicator
|
|
*/
|
|
@Override public Intercomm clone()
|
|
{
|
|
try
|
|
{
|
|
MPI.check();
|
|
return new Intercomm(dup());
|
|
}
|
|
catch(MPIException e)
|
|
{
|
|
throw new RuntimeException(e.getMessage());
|
|
}
|
|
}
|
|
|
|
// Inter-Communication
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
public int getRemoteSize() throws MPIException
|
|
{
|
|
MPI.check();
|
|
return getRemoteSize_jni();
|
|
}
|
|
|
|
private native int getRemoteSize_jni() throws MPIException;
|
|
|
|
/**
|
|
* Return the remote group.
|
|
* <p>Java binding of the MPI operation {@code MPI_COMM_REMOTE_GROUP}.
|
|
* @return remote group of this communicator
|
|
* @throws MPIException
|
|
*/
|
|
public Group getRemoteGroup() throws MPIException
|
|
{
|
|
MPI.check();
|
|
return new Group(getRemoteGroup_jni());
|
|
}
|
|
|
|
private native long getRemoteGroup_jni();
|
|
|
|
/**
|
|
* Creates an intracommuncator from an intercommunicator
|
|
* <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
|
|
*/
|
|
public Intracomm merge(boolean high) throws MPIException
|
|
{
|
|
MPI.check();
|
|
return new Intracomm(merge_jni(high));
|
|
}
|
|
|
|
private native long merge_jni(boolean high);
|
|
|
|
/**
|
|
* Java binding of {@code MPI_COMM_GET_PARENT}.
|
|
* @return the parent communicator
|
|
* @throws MPIException
|
|
*/
|
|
public static Intercomm getParent() throws MPIException
|
|
{
|
|
MPI.check();
|
|
return new Intercomm(getParent_jni());
|
|
}
|
|
|
|
private native static long getParent_jni() throws MPIException;
|
|
|
|
} // Intercomm
|