ompi-main/ompi/mpi/java/java/Comm.java
/*
 * Copyright (c) 2004-2007 The Trustees of Indiana University and Indiana
 *                         University Research and Technology
 *                         Corporation.  All rights reserved.
 * Copyright (c) 2004-2005 The University of Tennessee and The University
 *                         of Tennessee Research Foundation.  All rights
 *                         reserved.
 * Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,
 *                         University of Stuttgart.  All rights reserved.
 * Copyright (c) 2004-2005 The Regents of the University of California.
 *                         All rights reserved.
 * Copyright (c) 2015      Research Organization for Information Science
 *                         and Technology (RIST). All rights reserved.
 * Copyright (c) 2015      Los Alamos National Security, LLC. All rights
 *                         reserved.
 * Copyright (c) 2017-2019 FUJITSU LIMITED.  All rights reserved.
 * Copyright (c) 2022      Cisco Systems, Inc.  All rights reserved
 * $COPYRIGHT$
 *
 * Additional copyrights may follow
 *
 * $HEADER$
 *
 *
 * This file is almost a complete re-write for Open MPI compared to the
 * original mpiJava package. Its license and copyright are listed below.
 * See <path to ompi/mpi/java/README> for more information.
 *
 *
 *  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
 *
 *     https://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         : Comm.java
 * Author       : Sang Lim, Sung-Hoon Ko, Xinying Li, Bryan Carpenter
 * Created      : Thu Apr  9 12:22:15 1998
 * Revision     : $Revision: 1.20 $
 * Updated      : $Date: 2001/08/07 16:36:25 $
 * Copyright: Northeast Parallel Architectures Center
 *            at Syracuse University 1998
 *
 *
 *
 * IMPLEMENTATION DETAILS
 *
 * All methods with buffers that can be direct or non direct have
 * a companion argument 'db' which is true if the buffer is direct.
 * For example, if the buffer argument is recvBuf, the companion
 * argument will be 'rdb', meaning if the receive buffer is direct.
 *
 * Checking if a buffer is direct is faster in Java than C.
 */
package mpi;

import java.nio.*;
import static mpi.MPI.assertDirectBuffer;

/**
 * The {@code Comm} class represents communicators.
 */
public class Comm implements Freeable, Cloneable
{
	public final static int TYPE_SHARED = 0;
	protected final static int SELF  = 1;
	protected final static int WORLD = 2;
	protected long handle;
	private Request request;

	private static long nullHandle;

	static
	{
		init();
	}

	private static native void init();

	protected Comm()
	{
	}

	protected Comm(long handle)
	{
		this.handle = handle;
	}

	protected Comm(long[] commRequest)
	{
		handle  = commRequest[0];
		request = new Request(commRequest[1]);
	}

	protected final void setType(int type)
	{
		getComm(type);
	}

	private native void getComm(int type);

	/**
	 * Duplicates this communicator.
	 * <p>Java binding of {@code MPI_COMM_DUP}.
	 * <p>It is recommended to use {@link #dup} instead of {@link #clone}
	 * because the last can't throw an {@link mpi.MPIException}.
	 * @return copy of this communicator
	 */
	@Override public Comm clone()
	{
		try
		{
			return dup();
		}
		catch(MPIException e)
		{
			throw new RuntimeException(e.getMessage());
		}
	}

	/**
	 * Duplicates this communicator.
	 * <p>Java binding of {@code MPI_COMM_DUP}.
	 * @return copy of this communicator
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public Comm dup() throws MPIException
	{
		MPI.check();
		return new Comm(dup(handle));
	}

	protected final native long dup(long comm) throws MPIException;

	/**
	 * Duplicates this communicator.
	 * <p>Java binding of {@code MPI_COMM_IDUP}.
	 * <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 error of some sort has occurred.
	 */
	public Comm iDup() throws MPIException
	{
		MPI.check();
		return new Comm(iDup(handle));
	}

	protected final native long[] iDup(long comm) throws MPIException;

	/**
	 * Duplicates this communicator with the info object used in the call.
	 * <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 error of some sort has occurred.
	 */
	public Comm dupWithInfo(Info info) throws MPIException
	{
		MPI.check();
		return new Comm(dupWithInfo(handle, info.handle));
	}

	protected final native long dupWithInfo(long comm, long info) throws MPIException;

	/**
	 * Returns the associated request to this communicator if it was
	 * created using {@link #iDup}.
	 * @return associated request if this communicator was created
	 *         using {@link #iDup}, or null otherwise.
	 */
	public final Request getRequest()
	{
		return request;
	}

	/**
	 * 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 error of some sort has occurred.
	 */
	public final int getSize() throws MPIException
	{
		MPI.check();
		return getSize(handle);
	}

	private native int getSize(long comm) throws MPIException;

	/**
	 * 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 error of some sort has occurred.
	 */
	public final int getRank() throws MPIException
	{
		MPI.check();
		return getRank(handle);
	}

	private native int getRank(long comm) throws MPIException;

	/**
	 * Compare two communicators.
	 * <p>Java binding of the MPI operation {@code MPI_COMM_COMPARE}.
	 * @param comm1 first communicator
	 * @param comm2 second communicator
	 * @return
	 * {@code MPI.IDENT} results if the {@code comm1} and {@code comm2}
	 * are references to the same object (ie, if {@code comm1 == comm2}).<br>
	 * {@code MPI.CONGRUENT} results if the underlying groups are identical
	 * but the communicators differ by context.<br>
	 * {@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 error of some sort has occurred.
	 */
	public static int compare(Comm comm1, Comm comm2) throws MPIException
	{
		MPI.check();
		return compare(comm1.handle, comm2.handle);
	}

	private static native int compare(long comm1, long comm2) throws MPIException;

	/**
	 * Java binding of the MPI operation {@code MPI_COMM_FREE}.
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	@Override final public void free() throws MPIException
	{
		MPI.check();
		handle = free(handle);
	}

	private native long free(long comm) throws MPIException;

	/**
	 * Test if communicator object is null (has been freed).
	 * Java binding of {@code MPI_COMM_NULL}.
	 * @return true if the comm object is null, false otherwise
	 */
	public final boolean isNull()
	{
		return handle == nullHandle;
	}

	/**
	 * Java binding of {@code MPI_COMM_SET_INFO}.
	 * @param info info object
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final void setInfo(Info info) throws MPIException
	{
		MPI.check();
		setInfo(handle, info.handle);
	}

	private native void setInfo(long comm, long info) throws MPIException;

	/**
	 * Java binding of {@code MPI_COMM_GET_INFO}.
	 * @return new info object
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Info getInfo() throws MPIException
	{
		MPI.check();
		return new Info(getInfo(handle));
	}

	private native long getInfo(long comm) throws MPIException;

	/**
	 * Java binding of the MPI operation {@code MPI_COMM_DISCONNECT}.
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final void disconnect() throws MPIException
	{
		MPI.check();
		handle = disconnect(handle);
	}

	private native long disconnect(long comm) throws MPIException;

	/**
	 * 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 error of some sort has occurred.
	 */
	public final Group getGroup() throws MPIException
	{
		MPI.check();
		return new Group(getGroup(handle));
	}

	private native long getGroup(long comm);

	// Inter-communication

	/**
	 * Test if this communicator is an inter-communicator.
	 * <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 error of some sort has occurred.
	 */
	public final boolean isInter() throws MPIException
	{
		MPI.check();
		return isInter(handle);
	}

	private native boolean isInter(long comm) throws MPIException;

	/**
	 * Create an inter-communicator.
	 * <p>
	 * Java binding of the MPI operation {@code MPI_INTERCOMM_CREATE}.
	 * <p>
	 * This operation is defined as a method on the "peer communicator",
	 * making it analogous to a {@code send} or {@code recv} communication
	 * with the remote group leader.
	 * @param localComm    local intra-communicator
	 * @param localLeader  rank of local group leader in {@code localComm}
	 * @param remoteLeader rank of remote group leader in this communicator
	 * @param tag          "safe" tag
	 * @return new inter-communicator
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Intercomm createIntercomm(Comm localComm, int localLeader,
			int remoteLeader, int tag)
					throws MPIException
	{
		MPI.check();

		return new Intercomm(createIntercomm(handle, localComm.handle,
				localLeader, remoteLeader, tag));
	}

	private native long createIntercomm(
			long comm, long localComm, int localLeader,
			int remoteLeader, int tag) throws MPIException;

	// Blocking Send and Recv

	/**
	 * Blocking send operation.
	 * <p>Java binding of the MPI operation {@code MPI_SEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @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
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		send(handle, buf, db, off, count, type.handle, type.baseType, dest, tag);
	}

	private native void send(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int baseType, int dest, int tag) throws MPIException;

	/**
	 * Blocking receive operation.
	 * <p>Java binding of the MPI operation {@code MPI_RECV}.
	 * @param buf    receive buffer
	 * @param count  number of items in receive buffer
	 * @param type   datatype of each item in receive buffer
	 * @param source rank of source
	 * @param tag    message tag
	 * @return status object
	 * @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)
					throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		Status status = new Status();

		recv(handle, buf, db, off, count,
				type.handle, type.baseType, source, tag, status.data);

		return status;
	}

	private native void recv(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int basetype, int source, int tag, long[] stat)
					throws MPIException;

	// Send-Recv

	/**
	 * Execute a blocking send and receive operation.
	 * <p>Java binding of the MPI operation {@code MPI_SENDRECV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param dest      rank of destination
	 * @param sendtag   send tag
	 * @param recvbuf   receive buffer
	 * @param recvcount number of items in receive buffer
	 * @param recvtype  datatype of each item in receive buffer
	 * @param source    rank of source
	 * @param recvtag   receive tag
	 * @return status object
	 * @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)
	 */
	public final Status sendRecv(
			Object sendbuf, int sendcount, Datatype sendtype, int dest,   int sendtag,
			Object recvbuf, int recvcount, Datatype recvtype, int source, int recvtag)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		Status status = new Status();

		sendRecv(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType, dest, sendtag,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType, source, recvtag, status.data);

		return status;
	}

	private native void sendRecv(
			long comm, Object sbuf, boolean sdb, int soffset, int scount,
			long sType, int sBaseType, int dest, int stag,
			Object rbuf, boolean rdb, int roffset, int rcount,
			long rType, int rBaseType, int source, int rtag,
			long[] stat) throws MPIException;

	/**
	 * Execute a blocking send and receive operation,
	 * receiving message into send buffer.
	 * <p>Java binding of the MPI operation {@code MPI_SENDRECV_REPLACE}.
	 * @param buf     buffer
	 * @param count   number of items to send
	 * @param type    datatype of each item in buffer
	 * @param dest    rank of destination
	 * @param sendtag send tag
	 * @param source  rank of source
	 * @param recvtag receive tag
	 * @return status object
	 * @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)
	 */
	public final Status sendRecvReplace(
			Object buf, int count, Datatype type,
			int dest, int sendtag, int source, int recvtag)
					throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		Status status = new Status();

		sendRecvReplace(handle, buf, db, off, count, type.handle, type.baseType,
				dest, sendtag, source, recvtag, status.data);

		return status;
	}

	private native void sendRecvReplace(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int baseType, int dest, int stag,
			int source, int rtag, long[] stat) throws MPIException;

	// Communication Modes

	/**
	 * Send in buffered mode.
	 * <p>Java binding of the MPI operation {@code MPI_BSEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @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)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		bSend(handle, buf, db, off, count, type.handle, type.baseType, dest, tag);
	}

	private native void bSend(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int baseType, int dest, int tag) throws MPIException;

	/**
	 * Send in synchronous mode.
	 * <p>Java binding of the MPI operation {@code MPI_SSEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @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)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		sSend(handle, buf, db, off, count, type.handle, type.baseType, dest, tag);
	}

	private native void sSend(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int baseType, int dest, int tag) throws MPIException;

	/**
	 * Send in ready mode.
	 * <p>Java binding of the MPI operation {@code MPI_RSEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @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)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		rSend(handle, buf, db, off, count, type.handle, type.baseType, dest, tag);
	}

	private native void rSend(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int baseType, int dest, int tag) throws MPIException;

	// Nonblocking communication

	/**
	 * Start a standard mode, nonblocking send.
	 * <p>Java binding of the MPI operation {@code MPI_ISEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iSend(handle, buf, count, type.handle, dest, tag));
		req.addSendBufRef(buf);
		return req;
	}

	private native long iSend(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Start a buffered mode, nonblocking send.
	 * <p>Java binding of the MPI operation {@code MPI_IBSEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(ibSend(handle, buf, count, type.handle, dest, tag));
		req.addSendBufRef(buf);
		return req;
	}

	private native long ibSend(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Start a synchronous mode, nonblocking send.
	 * <p>Java binding of the MPI operation {@code MPI_ISSEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(isSend(handle, buf, count, type.handle, dest, tag));
		req.addSendBufRef(buf);
		return req;
	}

	private native long isSend(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Start a ready mode, nonblocking send.
	 * <p>Java binding of the MPI operation {@code MPI_IRSEND}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(irSend(handle, buf, count, type.handle, dest, tag));
		req.addSendBufRef(buf);
		return req;
	}

	private native long irSend(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Start a nonblocking receive.
	 * <p>Java binding of the MPI operation {@code MPI_IRECV}.
	 * @param buf    receive buffer
	 * @param count  number of items in receive buffer
	 * @param type   datatype of each item in receive buffer
	 * @param source rank of source
	 * @param tag    message tag
	 * @return communication request
	 * @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,
			Datatype type, int source, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iRecv(handle, buf, count, type.handle, source, tag));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iRecv(
			long comm, Buffer buf, int count, long type, int source, int tag)
					throws MPIException;


	// Persistent communication  requests

	/**
	 * Creates a persistent communication request for a standard mode send.
	 * <p>Java binding of the MPI operation {@code MPI_SEND_INIT}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return persistent communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Prequest preq = new Prequest(sendInit(handle, buf, count, type.handle, dest, tag));
		preq.addSendBufRef(buf);
		return preq;
	}

	private native long sendInit(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Creates a persistent communication request for a buffered mode send.
	 * <p>Java binding of the MPI operation {@code MPI_BSEND_INIT}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return persistent communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Prequest preq = new Prequest(bSendInit(handle, buf, count, type.handle, dest, tag));
		preq.addSendBufRef(buf);
		return preq;
	}

	private native long bSendInit(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Creates a persistent communication request for a synchronous mode send.
	 * <p>Java binding of the MPI operation {@code MPI_SSEND_INIT}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return persistent communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Prequest preq = new Prequest(sSendInit(handle, buf, count, type.handle, dest, tag));
		preq.addSendBufRef(buf);
		return preq;
	}

	private native long sSendInit(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Creates a persistent communication request for a ready mode send.
	 * <p>Java binding of the MPI operation {@code MPI_RSEND_INIT}.
	 * @param buf   send buffer
	 * @param count number of items to send
	 * @param type  datatype of each item in send buffer
	 * @param dest  rank of destination
	 * @param tag   message tag
	 * @return persistent communication request
	 * @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,
			Datatype type, int dest, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Prequest preq = new Prequest(rSendInit(handle, buf, count, type.handle, dest, tag));
		preq.addSendBufRef(buf);
		return preq;
	}

	private native long rSendInit(
			long comm, Buffer buf, int count, long type, int dest, int tag)
					throws MPIException;

	/**
	 * Creates a persistent communication request for a receive operation.
	 * <p>Java binding of the MPI operation {@code MPI_RECV_INIT}.
	 * @param buf    receive buffer
	 * @param count  number of items in receive buffer
	 * @param type   datatype of each item in receive buffer
	 * @param source rank of source
	 * @param tag    message tag
	 * @return communication request
	 * @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,
			Datatype type, int source, int tag)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Prequest preq = new Prequest(recvInit(handle, buf, count, type.handle, source, tag));
		preq.addRecvBufRef(buf);
		return preq;
	}

	private native long recvInit(
			long comm, Buffer buf, int count, long type, int source, int tag)
					throws MPIException;

	// Pack and Unpack

	/**
	 * Packs message in send buffer {@code inbuf} into space specified in
	 * {@code outbuf}.
	 * <p>
	 * Java binding of the MPI operation {@code MPI_PACK}.
	 * <p>
	 * The return value is the output value of {@code position} - the
	 * initial value incremented by the number of bytes written.
	 * @param inbuf    input buffer
	 * @param incount  number of items in input buffer
	 * @param type     datatype of each item in input buffer
	 * @param outbuf   output buffer
	 * @param position initial position in output buffer
	 * @return final position in output buffer
	 * @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)
					throws MPIException
	{
		MPI.check();
		int offset = 0;
		boolean indb = false;

		if(inbuf instanceof Buffer && !(indb = ((Buffer)inbuf).isDirect()))
		{
			offset = type.getOffset(inbuf);
			inbuf  = ((Buffer)inbuf).array();
		}

		return pack(handle, inbuf, indb, offset, incount,
				type.handle, outbuf, position);
	}

	private native int pack(
			long comm, Object inbuf, boolean indb, int offset, int incount,
			long type, byte[] outbuf, int position) throws MPIException;

	/**
	 * Unpacks message in receive buffer {@code outbuf} into space specified in
	 * {@code inbuf}.
	 * <p>
	 * Java binding of the MPI operation {@code MPI_UNPACK}.
	 * <p>
	 * The return value is the output value of {@code position} - the
	 * initial value incremented by the number of bytes read.
	 * @param inbuf    input buffer
	 * @param position initial position in input buffer
	 * @param outbuf   output buffer
	 * @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 error of some sort has occurred.
	 */
	public final int unpack(byte[] inbuf, int position,
			Object outbuf, int outcount, Datatype type)
					throws MPIException
	{
		MPI.check();
		int offset = 0;
		boolean outdb = false;

		if(outbuf instanceof Buffer && !(outdb = ((Buffer)outbuf).isDirect()))
		{
			offset = type.getOffset(outbuf);
			outbuf = ((Buffer)outbuf).array();
		}

		return unpack(handle, inbuf, position, outbuf, outdb,
				offset, outcount, type.handle);
	}

	private native int unpack(
			long comm, byte[] inbuf, int position, Object outbuf, boolean outdb,
			int offset, int outcount, long type) throws MPIException;

	/**
	 * Returns an upper bound on the increment of {@code position} effected
	 * by {@code pack}.
	 * <p>Java binding of the MPI operation {@code MPI_PACK_SIZE}.
	 * @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 error of some sort has occurred.
	 */
	public final int packSize(int incount, Datatype type) throws MPIException
	{
		MPI.check();
		return packSize(handle, incount, type.handle);
	}

	private native int packSize(long comm, int incount, long type)
			throws MPIException;

	// Probe and Cancel

	/**
	 * Check if there is an incoming message matching the pattern specified.
	 * <p>Java binding of the MPI operation {@code MPI_IPROBE}.
	 * <p>If such a message is currently available, a status object similar
	 * to the return value of a matching {@code recv} operation is returned.
	 * @param source rank of source
	 * @param tag    message tag
	 * @return status object if such a message is currently available,
	 *         {@code null} otherwise.
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Status iProbe(int source, int tag) throws MPIException
	{
		MPI.check();
		return iProbe(handle, source, tag);
	}

	private native Status iProbe(long comm, int source, int tag)
			throws MPIException;

	/**
	 * Wait until there is an incoming message matching the pattern specified.
	 * <p>Java binding of the MPI operation {@code MPI_PROBE}.
	 * <p>Returns a status object similar to the return value of a matching
	 * {@code recv} operation.
	 * @param source rank of source
	 * @param tag    message tag
	 * @return status object
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Status probe(int source, int tag) throws MPIException
	{
		MPI.check();
		Status status = new Status();
		probe(handle, source, tag, status.data);
		return status;
	}

	private native void probe(long comm, int source, int tag, long[] stat)
			throws MPIException;

	// Caching

	/**
	 * 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 error of some sort has occurred.
	 */
	public static int createKeyval() throws MPIException
	{
		MPI.check();
		return createKeyval_jni();
	}

	private static native int createKeyval_jni() throws MPIException;

	/**
	 * 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 error of some sort has occurred.
	 */
	public static void freeKeyval(int keyval) throws MPIException
	{
		MPI.check();
		freeKeyval_jni(keyval);
	}

	private static native void freeKeyval_jni(int keyval) throws MPIException;

	/**
	 * Stores attribute value associated with a key.
	 * <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 error of some sort has occurred.
	 */
	public final void setAttr(int keyval, Object value) throws MPIException
	{
		MPI.check();
		setAttr(handle, keyval, MPI.attrSet(value));
	}

	private native void setAttr(long comm, int keyval, byte[] value)
			throws MPIException;

	/**
	 * Retrieves attribute value by key.
	 * <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 error of some sort has occurred.
	 */
	public final Object getAttr(int keyval) throws MPIException
	{
		MPI.check();

		if( keyval == MPI.TAG_UB       ||
				keyval == MPI.HOST         ||
				keyval == MPI.IO           ||
				keyval == MPI.APPNUM       ||
				keyval == MPI.LASTUSEDCODE ||
				keyval == MPI.UNIVERSE_SIZE)
		{
			return getAttr_predefined(handle, keyval);
		}
		else if(keyval == MPI.WTIME_IS_GLOBAL)
		{
			Integer value = (Integer)getAttr_predefined(handle, keyval);
			return value==null ? null : value.intValue() != 0;
		}
		else
		{
			return MPI.attrGet(getAttr(handle, keyval));
		}
	}

	private native Object getAttr_predefined(long comm, int keyval)
			throws MPIException;

	private native byte[] getAttr(long comm, int keyval) throws MPIException;

	/**
	 * 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 error of some sort has occurred.
	 */
	public final void deleteAttr(int keyval) throws MPIException
	{
		MPI.check();
		deleteAttr(handle, keyval);
	}

	private native void deleteAttr(long comm, int keyval) throws MPIException;

	// Process Topologies

	/**
	 * Returns the type of topology associated with the communicator.
	 * <p>Java binding of the MPI operation {@code MPI_TOPO_TEST}.
	 * <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 error of some sort has occurred.
	 */
	public final int getTopology() throws MPIException
	{
		MPI.check();
		return getTopology(handle);
	}

	private native int getTopology(long comm) throws MPIException;

	// Environmental Management

	/**
	 * 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 error of some sort has occurred.
	 */
	public final void abort(int errorcode) throws MPIException
	{
		MPI.check();
		abort(handle, errorcode);
	}

	private native void abort(long comm, int errorcode) throws MPIException;

	// Error handler

	/**
	 * 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 error of some sort has occurred.
	 */
	public final void setErrhandler(Errhandler errhandler) throws MPIException
	{
		MPI.check();
		setErrhandler(handle, errhandler.handle);
	}

	private native void setErrhandler(long comm, long errhandler)
			throws MPIException;

	/**
	 * 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 error of some sort has occurred.
	 */
	public final Errhandler getErrhandler() throws MPIException
	{
		MPI.check();
		return new Errhandler(getErrhandler(handle));
	}

	private native long getErrhandler(long comm);

	/**
	 * 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 error of some sort has occurred.
	 */
	public void callErrhandler(int errorCode) throws MPIException
	{
		callErrhandler(handle, errorCode);
	}

	private native void callErrhandler(long handle, int errorCode)
			throws MPIException;

	// Collective Communication

	/**
	 * 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 error of some sort has occurred.
	 */
	public final void barrier() throws MPIException
	{
		MPI.check();
		barrier(handle);
	}

	private native void barrier(long comm) throws MPIException;

	/**
	 * Nonblocking barrier synchronization.
	 * <p>Java binding of the MPI operation {@code MPI_IBARRIER}.
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iBarrier() throws MPIException
	{
		MPI.check();
		return new Request(iBarrier(handle));
	}

	private native long iBarrier(long comm) throws MPIException;

	/**
	 * Broadcast a message from the process with rank {@code root}
	 * to all processes of the group.
	 * <p>Java binding of the MPI operation {@code MPI_BCAST}.
	 * @param buf   buffer
	 * @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 error of some sort has occurred.
	 */
	public final void bcast(Object buf, int count, Datatype type, int root)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		bcast(handle, buf, db, off, count, type.handle, type.baseType, root);
	}

	private native void bcast(
			long comm, Object buf, boolean db, int offset, int count,
			long type, int basetype, int root) throws MPIException;

	/**
	 * Broadcast a message from the process with rank {@code root}
	 * to all processes of the group.
	 * <p>Java binding of the MPI operation {@code MPI_IBCAST}.
	 * @param buf   buffer
	 * @param count number of items in buffer
	 * @param type  datatype of each item in buffer
	 * @param root  rank of broadcast root
	 * @return communication request
	 * @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
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iBcast(handle, buf, count, type.handle, root));
		req.addSendBufRef(buf);
		return req;
	}

	private native long iBcast(
			long comm, Buffer buf, int count, long type, int root)
					throws MPIException;

	/**
	 * Each process sends the contents of its send buffer to the root process.
	 * <p>Java binding of the MPI operation {@code MPI_GATHER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void gather(
			Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		gather(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType, root);
	}

	/**
	 * Each process sends the contents of its send buffer to the root process.
	 * <p>Java binding of the MPI operation {@code MPI_GATHER}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * The buffer is used by the root process to receive data,
	 * and it is used by the non-root processes to send data.
	 * @param buf   buffer
	 * @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 error of some sort has occurred.
	 */
	public final void gather(Object buf, int count, Datatype type, int root)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		gather(handle, null, false, 0, 0, 0, 0,
				buf, db, off, count, type.handle, type.baseType, root);
	}

	private native void gather(
			long comm, Object sendBuf, boolean sdb, int sendOff, int sendCount,
			long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOff, int recvCount,
			long recvType, int recvBaseType, int root)
					throws MPIException;

	/**
	 * Each process sends the contents of its send buffer to the root process.
	 * <p>Java binding of the MPI operation {@code MPI_IGATHER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @param recvcount number of items to receive
	 * @param recvtype  datatype of each item in receive buffer
	 * @param root      rank of receiving process
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iGather(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iGather(handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, recvtype.handle, root));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Each process sends the contents of its send buffer to the root process.
	 * <p>Java binding of the MPI operation {@code MPI_IGATHER}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * The buffer is used by the root process to receive data,
	 * and it is used by the non-root processes to send data.
	 * @param buf   buffer
	 * @param count number of items to send/receive
	 * @param type  datatype of each item in buffer
	 * @param root  rank of receiving process
	 * @return communication request
	 * @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
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iGather(handle, null, 0, 0,
				buf, count, type.handle, root));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iGather(
			long comm, Buffer sendbuf, int sendcount, long sendtype,
			Buffer recvbuf, int recvcount, long recvtype,
			int root) throws MPIException;

	/**
	 * Extends functionality of {@code gather} by allowing varying
	 * counts of data from each process.
	 * <p>Java binding of the MPI operation {@code MPI_GATHERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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
	 * @param root      rank of receiving process
	 * @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,
			Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		gatherv(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount, displs,
				recvtype.handle, recvtype.baseType, root);
	}

	/**
	 * Extends functionality of {@code gather} by allowing varying
	 * counts of data from each process.
	 * <p>Java binding of the MPI operation {@code MPI_GATHERV} using
	 * {@code MPI_IN_PLACE} instead of the send buffer in the root process.
	 * This method must be used in the root process.
	 * @param recvbuf   receive buffer
	 * @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
	 * @param root      rank of receiving process
	 * @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)
					throws MPIException
	{
		MPI.check();
		int recvoff = 0;
		boolean rdb = false;

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		gatherv(handle, null, false, 0, 0, 0, 0, recvbuf, rdb, recvoff, recvcount,
				displs, recvtype.handle, recvtype.baseType, root);
	}

	/**
	 * Extends functionality of {@code gather} by allowing varying
	 * counts of data from each process.
	 * <p>Java binding of the MPI operation {@code MPI_GATHERV} using
	 * {@code MPI_IN_PLACE} instead of the send buffer in the root process.
	 * This method must be used in the non-root processes.
	 * @param sendbuf   send buffer
	 * @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 error of some sort has occurred.
	 */
	public final void gatherv(Object sendbuf, int sendcount,
			Datatype sendtype, int root)
					throws MPIException
	{
		MPI.check();
		int sendoff = 0;
		boolean sdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		gatherv(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				null, false, 0, null, null, 0, 0, root);
	}

	private native void gatherv(
			long comm, Object sendBuf, boolean sdb, int sendOffset,
			int sendCount, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset,
			int[] recvCount, int[] displs, long recvType, int recvBaseType,
			int root) throws MPIException;

	/**
	 * Extends functionality of {@code gather} by allowing varying
	 * counts of data from each process.
	 * <p>Java binding of the MPI operation {@code MPI_IGATHERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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
	 * @param root      rank of receiving process
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iGatherv(
			Buffer sendbuf, int sendcount, Datatype sendtype, Buffer recvbuf,
			int[] recvcount, int[] displs, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iGatherv(
				handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, displs, recvtype.handle, root));
		req.addSendBufRef(sendbuf);
		return req;
	}

	/**
	 * Extends functionality of {@code gather} by allowing varying
	 * counts of data from each process.
	 * <p>Java binding of the MPI operation {@code MPI_IGATHERV} using
	 * {@code MPI_IN_PLACE} instead of the send buffer in the root process.
	 * This method must be used in the root process.
	 * @param recvbuf   receive buffer
	 * @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
	 * @param root      rank of receiving process
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(recvbuf);
		Request req = new Request(iGatherv(handle, null, 0, 0,
				recvbuf, recvcount, displs, recvtype.handle, root));
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Extends functionality of {@code gather} by allowing varying
	 * counts of data from each process.
	 * <p>Java binding of the MPI operation {@code MPI_IGATHERV} using
	 * {@code MPI_IN_PLACE} instead of the send buffer in the root process.
	 * This method must be used in the non-root processes.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param root      rank of receiving process
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iGatherv(Buffer sendbuf, int sendcount,
			Datatype sendtype, int root)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf);
		Request req = new Request(iGatherv(handle, sendbuf, sendcount, sendtype.handle,
				null, null, null, 0, root));
		req.addSendBufRef(sendbuf);
		return req;
	}

	private native long iGatherv(
			long handle, Buffer sendbuf, int sendcount, long sendtype,
			Buffer recvbuf, int[] recvcount, int[] displs,
			long recvtype, int root)
					throws MPIException;

	/**
	 * Inverse of the operation {@code gather}.
	 * <p>Java binding of the MPI operation {@code MPI_SCATTER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void scatter(
			Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		scatter(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType, root);
	}

	/**
	 * Inverse of the operation {@code gather}.
	 * <p>Java binding of the MPI operation {@code MPI_SCATTER}
	 * using {@code MPI_IN_PLACE} instead of the receive buffer.
	 * The buffer is used by the root process to send data,
	 * and it is used by the non-root processes to receive data.
	 * @param buf   send/receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void scatter(Object buf, int count, Datatype type, int root)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		scatter(handle, buf, db, off, count, type.handle, type.baseType,
				null, false, 0, 0, 0, 0, root);
	}

	private native void scatter(
			long comm, Object sendBuf, boolean sdb, int sendOffset, int sendCount,
			long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset, int recvCount,
			long recvType, int recvBaseType, int root) throws MPIException;

	/**
	 * Inverse of the operation {@code gather}.
	 * <p>Java binding of the MPI operation {@code MPI_ISCATTER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @param recvcount number of items to receive
	 * @param recvtype  datatype of each item in receive buffer
	 * @param root      rank of sending process
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iScatter(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iScatter(handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, recvtype.handle, root));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Inverse of the operation {@code gather}.
	 * <p>Java binding of the MPI operation {@code MPI_ISCATTER}
	 * using {@code MPI_IN_PLACE} instead of the receive buffer.
	 * The buffer is used by the root process to send data,
	 * and it is used by the non-root processes to receive data.
	 * @param buf   send/receive buffer
	 * @param count number of items to send/receive
	 * @param type  datatype of each item in buffer
	 * @param root  rank of sending process
	 * @return communication request
	 * @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
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iScatter(handle, buf, count, type.handle,
				null, 0, 0, root));
		req.addSendBufRef(buf);
		return req;
	}

	private native long iScatter(
			long comm, Buffer sendbuf, int sendcount, long sendtype,
			Buffer recvbuf, int recvcount, long recvtype, int root)
					throws MPIException;

	/**
	 * Inverse of the operation {@code gatherv}.
	 * <p>Java binding of the MPI operation {@code MPI_SCATTERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each process
	 * @param displs    displacements from which to take outgoing data
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void scatterv(
			Object sendbuf, int[] sendcount, int[] displs, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		scatterv(handle, sendbuf, sdb, sendoff, sendcount, displs,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType, root);
	}

	/**
	 * Inverse of the operation {@code gatherv}.
	 * <p>Java binding of the MPI operation {@code MPI_SCATTERV} using
	 * {@code MPI_IN_PLACE} instead of the receive buffer in the root process.
	 * This method must be used in the root process.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each process
	 * @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 error of some sort has occurred.
	 */
	public final void scatterv(Object sendbuf, int[] sendcount, int[] displs,
			Datatype sendtype, int root)
					throws MPIException
	{
		MPI.check();
		int sendoff = 0;
		boolean sdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		scatterv(handle, sendbuf, sdb, sendoff, sendcount, displs,
				sendtype.handle, sendtype.baseType,
				null, false, 0, 0, 0, 0, root);
	}

	/**
	 * Inverse of the operation {@code gatherv}.
	 * <p>Java binding of the MPI operation {@code MPI_SCATTERV} using
	 * {@code MPI_IN_PLACE} instead of the receive buffer in the root process.
	 * This method must be used in the non-root processes.
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void scatterv(Object recvbuf, int recvcount,
			Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();
		int recvoff = 0;
		boolean rdb = false;

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		scatterv(handle, null, false, 0, null, null, 0, 0,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType, root);
	}

	private native void scatterv(
			long comm, Object sendBuf, boolean sdb, int sendOffset,
			int[] sendCount, int[] displs, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset, int recvCount,
			long recvType, int recvBaseType, int root)
					throws MPIException;

	/**
	 * Inverse of the operation {@code gatherv}.
	 * <p>Java binding of the MPI operation {@code MPI_ISCATTERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each process
	 * @param displs    displacements from which to take outgoing data
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @param recvcount number of items to receive
	 * @param recvtype  datatype of each item in receive buffer
	 * @param root      rank of sending process
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iScatterv(
			Buffer sendbuf, int[] sendcount, int[] displs,  Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iScatterv(
				handle, sendbuf, sendcount, displs, sendtype.handle,
				recvbuf, recvcount, recvtype.handle, root));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Inverse of the operation {@code gatherv}.
	 * <p>Java binding of the MPI operation {@code MPI_ISCATTERV} using
	 * {@code MPI_IN_PLACE} instead of the receive buffer in the root process.
	 * This method must be used in the root process.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each process
	 * @param displs    displacements from which to take outgoing data
	 * @param sendtype  datatype of each item in send buffer
	 * @param root      rank of sending process
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf);
		Request req = new Request(iScatterv(handle, sendbuf, sendcount, displs,
				sendtype.handle, null, 0, 0, root));
		req.addSendBufRef(sendbuf);
		return req;
	}

	/**
	 * Inverse of the operation {@code gatherv}.
	 * <p>Java binding of the MPI operation {@code MPI_ISCATTERV} using
	 * {@code MPI_IN_PLACE} instead of the receive buffer in the root process.
	 * This method must be used in the non-root processes.
	 * @param recvbuf   receive buffer
	 * @param recvcount number of items to receive
	 * @param recvtype  datatype of each item in receive buffer
	 * @param root      rank of sending process
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iScatterv(Buffer recvbuf, int recvcount,
			Datatype recvtype, int root)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(recvbuf);
		Request req = new Request(iScatterv(handle, null, null, null, 0,
				recvbuf, recvcount, recvtype.handle, root));
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iScatterv(
			long comm, Buffer sendbuf, int[] sendcount, int[] displs, long sendtype,
			Buffer recvbuf, int recvcount, long recvtype, int root)
					throws MPIException;

	/**
	 * Similar to {@code gather}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_ALLGATHER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allGather(Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		allGather(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType);
	}

	/**
	 * Similar to {@code gather}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_ALLGATHER}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @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 error of some sort has occurred.
	 */
	public final void allGather(Object buf, int count, Datatype type)
			throws MPIException
	{
		MPI.check();
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		allGather(handle, null, false, 0, 0, 0, 0,
				buf, db, off, count, type.handle, type.baseType);
	}

	private native void allGather(
			long comm, Object sendBuf, boolean sdb, int sendOffset, int sendCount,
			long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset, int recvCount,
			long recvType, int recvBaseType) throws MPIException;

	/**
	 * Similar to {@code gather}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_IALLGATHER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final Request iAllGather(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iAllGather(handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Similar to {@code gather}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_IALLGATHER}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final Request iAllGather(Buffer buf, int count, Datatype type)
			throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iAllGather(handle, null, 0, 0, buf, count, type.handle));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iAllGather(
			long comm, Buffer sendbuf, int sendcount, long sendtype,
			Buffer recvbuf, int recvcount, long recvtype) throws MPIException;

	/**
	 * Similar to {@code gatherv}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_ALLGATHERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allGatherv(
			Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int[] recvcount, int[] displs, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		allGatherv(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount, displs,
				recvtype.handle, recvtype.baseType);
	}

	/**
	 * Similar to {@code gatherv}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_ALLGATHERV}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allGatherv(Object recvbuf, int[] recvcount,
			int[] displs, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		int recvoff = 0;
		boolean rdb = false;

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		allGatherv(handle, null, false, 0, 0, 0, 0,
				recvbuf, rdb, recvoff, recvcount,
				displs, recvtype.handle, recvtype.baseType);
	}

	private native void allGatherv(
			long comm, Object sendBuf, boolean sdb, int sendOffset, int sendCount,
			long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset, int[] recvCount,
			int[] displs, long recvType, int recvBasetype) throws MPIException;

	/**
	 * Similar to {@code gatherv}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_IALLGATHERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iAllGatherv(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int[] recvcount, int[] displs, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iAllGatherv(
				handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, displs, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Similar to {@code gatherv}, but all processes receive the result.
	 * <p>Java binding of the MPI operation {@code MPI_IALLGATHERV}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf    receive buffer
	 * @param count  number of elements received from each process
	 * @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 error of some sort has occurred.
	 */
	public final Request iAllGatherv(
			Buffer buf, int[] count, int[] displs, Datatype type)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		Request req = new Request(iAllGatherv(
				handle, null, 0, 0, buf, count, displs, type.handle));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iAllGatherv(
			long handle, Buffer sendbuf, int sendcount, long sendtype,
			Buffer recvbuf, int[] recvcount, int[] displs, long recvtype)
					throws MPIException;

	/**
	 * Extension of {@code allGather} to the case where each process sends
	 * distinct data to each of the receivers.
	 * <p>Java binding of the MPI operation {@code MPI_ALLTOALL}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each process
	 * @param sendtype  datatype send buffer items
	 * @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 error of some sort has occurred.
	 */
	public final void allToAll(Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		allToAll(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType);
	}

	private native void allToAll(
			long comm, Object sendBuf, boolean sdb, int sendOffset, int sendCount,
			long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset, int recvCount,
			long recvType, int recvBaseType) throws MPIException;

	/**
	 * Extension of {@code allGather} to the case where each process sends
	 * distinct data to each of the receivers.
	 * <p>Java binding of the MPI operation {@code MPI_IALLTOALL}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each process
	 * @param sendtype  datatype send buffer items
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final Request iAllToAll(Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iAllToAll(handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iAllToAll(
			long comm, Buffer sendbuf, int sendcount, long sendtype,
			Buffer recvbuf, int recvcount, long recvtype) throws MPIException;

	/**
	 * Adds flexibility to {@code allToAll}: location of data for send is
	 * specified by {@code sdispls} and location to place data on receive
	 * side is specified by {@code rdispls}.
	 * <p>Java binding of the MPI operation {@code MPI_ALLTOALLV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each buffer
	 * @param sdispls   displacements from which to take outgoing data
	 * @param sendtype  datatype send buffer items
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allToAllv(
			Object sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
			Object recvbuf, int[] recvcount, int[] rdispls, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		allToAllv(handle, sendbuf, sdb, sendoff, sendcount, sdispls,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount, rdispls,
				recvtype.handle, recvtype.baseType);
	}

	private native void allToAllv(
			long comm, Object sendBuf, boolean sdb, int sendOffset,
			int[] sendCount, int[] sdispls, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset,
			int[] recvCount, int[] rdispls, long recvType, int recvBaseType)
					throws MPIException;

	/**
	 * Adds flexibility to {@code allToAll}: location of data for send is
	 * specified by {@code sdispls} and location to place data on receive
	 * side is specified by {@code rdispls}.
	 * <p>Java binding of the MPI operation {@code MPI_IALLTOALLV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each buffer
	 * @param sdispls   displacements from which to take outgoing data
	 * @param sendtype  datatype send buffer items
	 * @param recvbuf   receive buffer
	 * @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
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iAllToAllv(
			Buffer sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
			Buffer recvbuf, int[] recvcount, int[] rdispls, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iAllToAllv(
				handle, sendbuf, sendcount, sdispls, sendtype.handle,
				recvbuf, recvcount, rdispls, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iAllToAllv(long comm,
			Buffer sendbuf, int[] sendcount, int[] sdispls, long sendtype,
			Buffer recvbuf, int[] recvcount, int[] rdispls, long recvtype)
					throws MPIException;

	/**
	 * Adds more flexibility to {@code allToAllv}: datatypes for send are
	 * specified by {@code sendTypes} and datatypes for receive are specified
	 * by {@code recvTypes} per process.
	 * <p>Java binding of the MPI operation {@code MPI_ALLTOALLW}.
	 * @param sendBuf   send buffer
	 * @param sendCount number of items sent to each buffer
	 * @param sDispls   displacements from which to take outgoing data
	 * @param sendTypes datatypes of send buffer items
	 * @param recvBuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allToAllw(
			Object sendBuf, int[] sendCount, int[] sDispls, Datatype[] sendTypes,
			Object recvBuf, int[] recvCount, int[] rDispls, Datatype[] recvTypes)
					throws MPIException
	{
		MPI.check();

		int[] sendoffs = new int[sendTypes.length];
		int[] recvoffs = new int[recvTypes.length];

		boolean sdb = false,
				rdb = false;

		if(sendBuf instanceof Buffer && !(sdb = ((Buffer)sendBuf).isDirect()))
		{

			for (int i = 0; i < sendTypes.length; i++){
				sendoffs[i] = sendTypes[i].getOffset(sendBuf);
			}
			sendBuf = ((Buffer)sendBuf).array();
		}

		if(recvBuf instanceof Buffer && !(rdb = ((Buffer)recvBuf).isDirect()))
		{
			for (int i = 0; i < recvTypes.length; i++){
				recvoffs[i] = recvTypes[i].getOffset(recvBuf);
			}
			recvBuf = ((Buffer)recvBuf).array();
		}

		long[] sendHandles = convertTypeArray(sendTypes);
		long[] recvHandles = convertTypeArray(recvTypes);
		int[]  sendHandles_btypes = convertTypeArrayBtype(sendTypes);
		int[]  recvHandles_btypes = convertTypeArrayBtype(recvTypes);

		allToAllw(handle, sendBuf, sdb, sendoffs, sendCount, sDispls,
				sendHandles, sendHandles_btypes,
				recvBuf, rdb, recvoffs, recvCount, rDispls,
				recvHandles, recvHandles_btypes);
	}

	private native void allToAllw(long comm,
			Object sendBuf, boolean sdb, int[] sendOffsets,
			int[] sendCount, int[] sDispls, long[] sendTypes, int[] sendBaseTypes,
			Object recvBuf, boolean rdb, int[] recvOffsets,
			int[] recvCount, int[] rDispls, long[] recvTypes, int[] recvBaseTypes)
					throws MPIException;

	/**
	 * Adds more flexibility to {@code iAllToAllv}: datatypes for send are
	 * specified by {@code sendTypes} and datatypes for receive are specified
	 * by {@code recvTypes} per process.
	 * <p>Java binding of the MPI operation {@code MPI_IALLTOALLW}.
	 * @param sendBuf   send buffer
	 * @param sendCount number of items sent to each buffer
	 * @param sDispls   displacements from which to take outgoing data
	 * @param sendTypes datatype send buffer items
	 * @param recvBuf   receive buffer
	 * @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
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iAllToAllw(
			Buffer sendBuf, int[] sendCount, int[] sDispls, Datatype[] sendTypes,
			Buffer recvBuf, int[] recvCount, int[] rDispls, Datatype[] recvTypes)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendBuf, recvBuf);

		long[] sendHandles = convertTypeArray(sendTypes);
		long[] recvHandles = convertTypeArray(recvTypes);
		Request req = new Request(iAllToAllw(
				handle, sendBuf, sendCount, sDispls, sendHandles,
				recvBuf, recvCount, rDispls, recvHandles));
		req.addSendBufRef(sendBuf);
		req.addRecvBufRef(recvBuf);
		return req;
	}

	private native long iAllToAllw(long comm,
			Buffer sendBuf, int[] sendCount, int[] sDispls, long[] sendTypes,
			Buffer recvBuf, int[] recvCount, int[] rDispls, long[] recvTypes)
					throws MPIException;

	/**
	 * Java binding of {@code MPI_NEIGHBOR_ALLGATHER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @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 error of some sort has occurred.
	 */
	public final void neighborAllGather(
			Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		neighborAllGather(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType);
	}

	private native void neighborAllGather(
			long comm, Object sendBuf, boolean sdb, int sendOffset,
			int sendCount, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOffset,
			int recvCount, long recvType, int recvBaseType)
					throws MPIException;

	/**
	 * Java binding of {@code MPI_INEIGHBOR_ALLGATHER}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final Request iNeighborAllGather(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iNeighborAllGather(
				handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iNeighborAllGather(
			long comm, Buffer sendBuf, int sendCount, long sendType,
			Buffer recvBuf, int recvCount, long recvType)
					throws MPIException;

	/**
	 * Java binding of {@code MPI_NEIGHBOR_ALLGATHERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void neighborAllGatherv(
			Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int[] recvcount, int[] displs, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		neighborAllGatherv(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount, displs,
				recvtype.handle, recvtype.baseType);
	}

	private native void neighborAllGatherv(
			long comm, Object sendBuf, boolean sdb, int sendOff,
			int sendCount, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOff,
			int[] recvCount, int[] displs, long recvType, int recvBaseType);

	/**
	 * Java binding of {@code MPI_INEIGHBOR_ALLGATHERV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iNeighborAllGatherv(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int[] recvcount, int[] displs, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iNeighborAllGatherv(
				handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, displs, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iNeighborAllGatherv(
			long comm, Buffer sendBuf, int sendCount, long sendType,
			Buffer recvBuf, int[] recvCount, int[] displs, long recvType)
					throws MPIException;

	/**
	 * Java binding of {@code MPI_NEIGHBOR_ALLTOALL}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @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 error of some sort has occurred.
	 */
	public final void neighborAllToAll(
			Object sendbuf, int sendcount, Datatype sendtype,
			Object recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		neighborAllToAll(handle, sendbuf, sdb, sendoff, sendcount,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount,
				recvtype.handle, recvtype.baseType);
	}

	private native void neighborAllToAll(
			long comm, Object sendBuf, boolean sdb, int sendOff,
			int sendCount, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOff,
			int recvCount, long recvType, int recvBaseType)
					throws MPIException;

	/**
	 * Java binding of {@code MPI_INEIGHBOR_ALLTOALL}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items to send
	 * @param sendtype  datatype of each item in send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final Request iNeighborAllToAll(
			Buffer sendbuf, int sendcount, Datatype sendtype,
			Buffer recvbuf, int recvcount, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iNeighborAllToAll(
				handle, sendbuf, sendcount, sendtype.handle,
				recvbuf, recvcount, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iNeighborAllToAll(
			long comm, Buffer sendBuf, int sendCount, long sendType,
			Buffer recvBuf, int recvCount, long recvType);

	/**
	 * Java binding of {@code MPI_NEIGHBOR_ALLTOALLV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each buffer
	 * @param sdispls   displacements from which to take outgoing data
	 * @param sendtype  datatype send buffer items
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void neighborAllToAllv(
			Object sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
			Object recvbuf, int[] recvcount, int[] rdispls, Datatype recvtype)
					throws MPIException
	{
		MPI.check();

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = sendtype.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = recvtype.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		neighborAllToAllv(handle,
				sendbuf, sdb, sendoff, sendcount, sdispls,
				sendtype.handle, sendtype.baseType,
				recvbuf, rdb, recvoff, recvcount, rdispls,
				recvtype.handle, recvtype.baseType);
	}

	private native void neighborAllToAllv(
			long comm, Object sendBuf, boolean sdb, int sendOff,
			int[] sendCount, int[] sdispls, long sendType, int sendBaseType,
			Object recvBuf, boolean rdb, int recvOff,
			int[] recvCount, int[] rdispls, long recvType, int recvBaseType)
					throws MPIException;

	/**
	 * Java binding of {@code MPI_INEIGHBOR_ALLTOALLV}.
	 * @param sendbuf   send buffer
	 * @param sendcount number of items sent to each buffer
	 * @param sdispls   displacements from which to take outgoing data
	 * @param sendtype  datatype send buffer items
	 * @param recvbuf   receive buffer
	 * @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
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iNeighborAllToAllv(
			Buffer sendbuf, int[] sendcount, int[] sdispls, Datatype sendtype,
			Buffer recvbuf, int[] recvcount, int[] rdispls, Datatype recvtype)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iNeighborAllToAllv(
				handle, sendbuf, sendcount, sdispls, sendtype.handle,
				recvbuf, recvcount, rdispls, recvtype.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	private native long iNeighborAllToAllv(
			long comm, Buffer sendBuf, int[] sendCount, int[] sdispls, long sType,
			Buffer recvBuf, int[] recvCount, int[] rdispls, long rType)
					throws MPIException;

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and return the combined value in the output buffer of the
	 * root process.
	 * <p>
	 * Java binding of the MPI operation {@code MPI_REDUCE}.
	 * <p>
	 * The predefined operations are available in Java as {@code MPI.MAX},
	 * {@code MPI.MIN}, {@code MPI.SUM}, {@code MPI.PROD}, {@code MPI.LAND},
	 * {@code MPI.BAND}, {@code MPI.LOR}, {@code MPI.BOR}, {@code MPI.LXOR},
	 * {@code MPI.BXOR}, {@code MPI.MINLOC} and {@code MPI.MAXLOC}.
	 * @param sendbuf send buffer
	 * @param recvbuf receive buffer
	 * @param count   number of items in send buffer
	 * @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 error of some sort has occurred.
	 */
	public final void reduce(Object sendbuf, Object recvbuf, int count,
			Datatype type, Op op, int root)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = type.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = type.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		reduce(handle, sendbuf, sdb, sendoff, recvbuf, rdb, recvoff,
				count, type.handle, type.baseType, op, op.handle, root);
	}

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and return the combined value in the output buffer of the
	 * root process.
	 * <p>Java binding of the MPI operation {@code MPI_REDUCE}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   send/receive buffer
	 * @param count number of items in buffer
	 * @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 error of some sort has occurred.
	 */
	public final void reduce(Object buf, int count, Datatype type, Op op, int root)
			throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		reduce(handle, null, false, 0, buf, db, off, count,
				type.handle, type.baseType, op, op.handle, root);
	}

	private native void reduce(
			long comm, Object sendbuf, boolean sdb, int sendoff,
			Object recvbuf, boolean rdb, int recvoff, int count,
			long type, int baseType, Op jOp, long hOp, int root)
					throws MPIException;

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and return the combined value in the output buffer of the
	 * root process.
	 * <p>Java binding of the MPI operation {@code MPI_IREDUCE}.
	 * @param sendbuf send buffer
	 * @param recvbuf receive buffer
	 * @param count   number of items in send buffer
	 * @param type    data type of each item in send buffer
	 * @param op      reduce operation
	 * @param root    rank of root process
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		op.setDatatype(type);
		Request req = new Request(iReduce(
				handle, sendbuf, recvbuf, count,
				type.handle, type.baseType, op, op.handle, root));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and return the combined value in the output buffer of the
	 * root process.
	 * <p>Java binding of the MPI operation {@code MPI_IREDUCE}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   send/receive buffer
	 * @param count number of items in buffer
	 * @param type  data type of each item in buffer
	 * @param op    reduce operation
	 * @param root  rank of root process
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(buf);
		op.setDatatype(type);
		Request req = new Request(iReduce(
				handle, null, buf, count,
				type.handle, type.baseType, op, op.handle, root));
		req.addSendBufRef(buf);
		return req;
	}

	private native long iReduce(
			long comm, Buffer sendbuf, Buffer recvbuf, int count,
			long type, int baseType, Op jOp, long hOp, int root)
					throws MPIException;

	/**
	 * Same as {@code reduce} except that the result appears in receive
	 * buffer of all process in the group.
	 * <p>Java binding of the MPI operation {@code MPI_ALLREDUCE}.
	 * @param sendbuf send buffer
	 * @param recvbuf receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allReduce(Object sendbuf, Object recvbuf,
			int count, Datatype type, Op op)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = type.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = type.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		allReduce(handle, sendbuf, sdb, sendoff, recvbuf, rdb, recvoff,
				count, type.handle, type.baseType, op, op.handle);
	}

	/**
	 * Same as {@code reduce} except that the result appears in receive
	 * buffer of all process in the group.
	 * <p>Java binding of the MPI operation {@code MPI_ALLREDUCE}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void allReduce(Object buf, int count, Datatype type, Op op)
			throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		allReduce(handle, null, false, 0, buf, db, off, count,
				type.handle, type.baseType, op, op.handle);
	}

	private native void allReduce(
			long comm, Object sendbuf, boolean sdb, int sendoff,
			Object recvbuf, boolean rdb, int recvoff, int count,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Same as {@code reduce} except that the result appears in receive
	 * buffer of all process in the group.
	 * <p>Java binding of the MPI operation {@code MPI_IALLREDUCE}.
	 * @param sendbuf send buffer
	 * @param recvbuf receive buffer
	 * @param count   number of items in send buffer
	 * @param type    data type of each item in send buffer
	 * @param op      reduce operation
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		assertDirectBuffer(sendbuf, recvbuf);
		op.setDatatype(type);
		Request req = new Request(iAllReduce(handle, sendbuf, recvbuf, count,
				type.handle, type.baseType, op, op.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Same as {@code reduce} except that the result appears in receive
	 * buffer of all process in the group.
	 * <p>Java binding of the MPI operation {@code MPI_IALLREDUCE}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   receive buffer
	 * @param count number of items in send buffer
	 * @param type  data type of each item in send buffer
	 * @param op    reduce operation
	 * @return communication request
	 * @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
	{
		MPI.check();
		op.setDatatype(type);
		assertDirectBuffer(buf);
		Request req = new Request(iAllReduce(
				handle, null, buf, count,
				type.handle, type.baseType, op, op.handle));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iAllReduce(
			long comm, Buffer sendbuf, Buffer recvbuf, int count,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and scatter the combined values over the output buffers
	 * of the processes.
	 * <p>Java binding of the MPI operation {@code MPI_REDUCE_SCATTER}.
	 * @param sendbuf    send buffer
	 * @param recvbuf    receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void reduceScatter(Object sendbuf, Object recvbuf,
			int[] recvcounts, Datatype type, Op op)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = type.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = type.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		reduceScatter(handle, sendbuf, sdb, sendoff, recvbuf, rdb, recvoff,
				recvcounts, type.handle, type.baseType, op, op.handle);
	}

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and scatter the combined values over the output buffers
	 * of the processes.
	 * <p>Java binding of the MPI operation {@code MPI_REDUCE_SCATTER}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf    receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void reduceScatter(Object buf, int[] counts, Datatype type, Op op)
			throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		reduceScatter(handle, null, false, 0, buf, db, off, counts,
				type.handle, type.baseType, op, op.handle);
	}

	private native void reduceScatter(
			long comm, Object sendbuf, boolean sdb, int sendoff,
			Object recvbuf, boolean rdb, int recvoff, int[] recvcounts,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and scatter the combined values over the output buffers
	 * of the processes.
	 * <p>Java binding of the MPI operation {@code MPI_IREDUCE_SCATTER}.
	 * @param sendbuf    send buffer
	 * @param recvbuf    receive buffer
	 * @param recvcounts numbers of result elements distributed to each process
	 * @param type       data type of each item in send buffer
	 * @param op         reduce operation
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iReduceScatter(
				handle, sendbuf, recvbuf, recvcounts,
				type.handle, type.baseType, op, op.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Combine elements in input buffer of each process using the reduce
	 * operation, and scatter the combined values over the output buffers
	 * of the processes.
	 * <p>Java binding of the MPI operation {@code MPI_IREDUCE_SCATTER}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf    receive buffer
	 * @param counts numbers of result elements distributed to each process
	 * @param type   data type of each item in send buffer
	 * @param op     reduce operation
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iReduceScatter(
			Buffer buf, int[] counts, Datatype type, Op op)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		assertDirectBuffer(buf);
		Request req = new Request(iReduceScatter(
				handle, null, buf, counts,
				type.handle, type.baseType, op, op.handle));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iReduceScatter(
			long handle, Buffer sendbuf, Object recvbuf, int[] recvcounts,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Combine values and scatter the results.
	 * <p>Java binding of the MPI operation {@code MPI_REDUCE_SCATTER_BLOCK}.
	 * @param sendbuf   send buffer
	 * @param recvbuf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void reduceScatterBlock(Object sendbuf, Object recvbuf,
			int recvcount, Datatype type, Op op)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);

		int sendoff = 0,
				recvoff = 0;

		boolean sdb = false,
				rdb = false;

		if(sendbuf instanceof Buffer && !(sdb = ((Buffer)sendbuf).isDirect()))
		{
			sendoff = type.getOffset(sendbuf);
			sendbuf = ((Buffer)sendbuf).array();
		}

		if(recvbuf instanceof Buffer && !(rdb = ((Buffer)recvbuf).isDirect()))
		{
			recvoff = type.getOffset(recvbuf);
			recvbuf = ((Buffer)recvbuf).array();
		}

		reduceScatterBlock(handle, sendbuf, sdb, sendoff, recvbuf, rdb, recvoff,
				recvcount, type.handle, type.baseType, op, op.handle);
	}

	/**
	 * Combine values and scatter the results.
	 * <p>Java binding of the MPI operation {@code MPI_REDUCE_SCATTER_BLOCK}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   receive buffer
	 * @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 error of some sort has occurred.
	 */
	public final void reduceScatterBlock(
			Object buf, int count, Datatype type, Op op)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		int off = 0;
		boolean db = false;

		if(buf instanceof Buffer && !(db = ((Buffer)buf).isDirect()))
		{
			off = type.getOffset(buf);
			buf = ((Buffer)buf).array();
		}

		reduceScatterBlock(handle, null, false, 0, buf, db, off, count,
				type.handle, type.baseType, op, op.handle);
	}

	private native void reduceScatterBlock(
			long comm, Object sendBuf, boolean sdb, int sOffset,
			Object recvBuf, boolean rdb, int rOffset, int rCount,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Combine values and scatter the results.
	 * <p>Java binding of the MPI operation {@code MPI_IREDUCE_SCATTER_BLOCK}.
	 * @param sendbuf   send buffer
	 * @param recvbuf   receive buffer
	 * @param recvcount element count per block
	 * @param type      data type of each item in send buffer
	 * @param op        reduce operation
	 * @return communication request
	 * @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)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		assertDirectBuffer(sendbuf, recvbuf);
		Request req = new Request(iReduceScatterBlock(
				handle, sendbuf, recvbuf, recvcount,
				type.handle, type.baseType, op, op.handle));
		req.addSendBufRef(sendbuf);
		req.addRecvBufRef(recvbuf);
		return req;
	}

	/**
	 * Combine values and scatter the results.
	 * <p>Java binding of the MPI operation {@code MPI_IREDUCE_SCATTER_BLOCK}
	 * using {@code MPI_IN_PLACE} instead of the send buffer.
	 * @param buf   receive buffer
	 * @param count element count per block
	 * @param type  data type of each item in send buffer
	 * @param op    reduce operation
	 * @return communication request
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final Request iReduceScatterBlock(
			Buffer buf, int count, Datatype type, Op op)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);
		assertDirectBuffer(buf);
		Request req = new Request(iReduceScatterBlock(
				handle, null, buf, count, type.handle,
				type.baseType, op, op.handle));
		req.addRecvBufRef(buf);
		return req;
	}

	private native long iReduceScatterBlock(
			long handle, Buffer sendbuf, Buffer recvbuf, int recvcount,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Apply the operation given by {@code op} element-wise to the
	 * elements of {@code inBuf} and {@code inOutBuf} with the result
	 * stored element-wise in {@code inOutBuf}.
	 * <p>Java binding of the MPI operation {@code MPI_REDUCE_LOCAL}.
	 * @param inBuf    input buffer
	 * @param inOutBuf input buffer, will contain combined output
	 * @param count    number of elements
	 * @param type     data type of each item
	 * @param op       reduce operation
	 * @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)
					throws MPIException
	{
		MPI.check();
		op.setDatatype(type);

		int inOff    = 0,
				inOutOff = 0;

		boolean idb  = false,
				iodb = false;

		if(inBuf instanceof Buffer && !(idb = ((Buffer)inBuf).isDirect()))
		{
			inOff = type.getOffset(inBuf);
			inBuf = ((Buffer)inBuf).array();
		}

		if(inOutBuf instanceof Buffer && !(iodb = ((Buffer)inOutBuf).isDirect()))
		{
			inOutOff = type.getOffset(inOutBuf);
			inOutBuf = ((Buffer)inOutBuf).array();
		}

		if(op.uf == null)
		{
			reduceLocal(inBuf, idb, inOff, inOutBuf, iodb, inOutOff,
					count, type.handle, op.handle);
		}
		else
		{
			reduceLocalUf(inBuf, idb, inOff, inOutBuf, iodb, inOutOff,
					count, type.handle, type.baseType, op, op.handle);
		}
	}

	private static native void reduceLocal(
			Object inBuf, boolean idb, int inOff,
			Object inOutBuf, boolean iodb, int inOutOff, int count,
			long type, long op) throws MPIException;

	private static native void reduceLocalUf(
			Object inBuf, boolean idb, int inOff,
			Object inOutBuf, boolean iodb, int inOutOff, int count,
			long type, int baseType, Op jOp, long hOp) throws MPIException;

	/**
	 * Sets the print name for the communicator.
	 * @param name name for the communicator
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final void setName(String name) throws MPIException
	{
		MPI.check();
		setName(handle, name);
	}

	private native void setName(long handle, String name) throws MPIException;

	/**
	 * Return the print name from the communicator.
	 * @return name of the communicator
	 * @throws MPIException Signals that an MPI error of some sort has occurred.
	 */
	public final String getName() throws MPIException
	{
		MPI.check();
		return getName(handle);
	}

	private native String getName(long handle) throws MPIException;

	/**
	 * A helper method to convert an array of Datatypes to
	 * an array of longs (handles).
	 * @param dArray	Array of Datatypes
	 * @return converted Datatypes
	 */
	private long[] convertTypeArray(Datatype[] dArray) {
		long[] lArray = new long[dArray.length];

		for(int i = 0; i < lArray.length; i++) {
			if(dArray[i] != null) {
				lArray[i] = dArray[i].handle;
			}
		}
		return lArray;
	}

	/**
	 * A helper method to convert an array of Datatypes to
	 * an array of ints (basetypes).
	 * @param dArray	Array of Datatypes
	 * @return converted basetypes
	 */
	private int[] convertTypeArrayBtype(Datatype[] dArray) {
		int[] lArray = new int[dArray.length];

		for(int i = 0; i < lArray.length; i++) {
			if(dArray[i] != null) {
				lArray[i] = dArray[i].baseType;
			}
		}
		return lArray;
	}

} // Comm
