MPI_Allgatherv(3)

NAME
     MPI_Allgatherv - Gathers data from all tasks and delivers it

SYNOPSIS
     C:

          #include <mpi.h>

          int MPI_Allgatherv ( sendbuf, sendcount,  sendtype,
          recvbuf, recvcounts, displs,
          recvtype, comm )
          void             *sendbuf;
          int               sendcount;
          MPI_Datatype      sendtype;
          void             *recvbuf;
          int              *recvcounts;
          int              *displs;
          MPI_Datatype      recvtype;
          MPI_Comm          comm;


     C++:

          #include <mpi.h>

          void Intracomm::Allgatherv(
          const void*       sendbuf,
          int               sendcount,
          const Datatype&   sendtype,
          void*             recvbuf,
          const int         recvcounts[],
          const int         displs[],
          const Datatype&   recvtype) const


     Fortran:

          INCLUDE "mpif.h" (or USE MPI)

          <type> SENDBUF(*), RECVBUF(*)
          INTEGER sendcount, sendtype, recvcounts(*), displs(*),
          recvtype, comm, ierror

          CALL MPI_ALLGATHERV(sendbuf, sendcount, sendtype,
          recvbuf, recvcounts(*), displs(*), recvtype,
          comm, ierror)


STANDARDS
     This release implements the MPI 1.2 standard, as documented by the MPI
     Forum in the spring 1997 release of MPI:  A Message Passing Interface
     Standard.
DESCRIPTION
     The MPI_Allgatherv routine gathers data from all tasks and delivers it to
     all.  This routine accepts the following parameters:

     sendbuf        Specifies the starting address of the send buffer
                    (choice).

     sendcount      Specifies the number of elements in the send buffer
                    (integer).

     sendtype       Specifies the data type of the send buffer elements
                    (handle).

     recvcounts     Specifies the integer array (of length group size,
                    specified in comm) containing the number of elements that
                    are received from each process.

     displs         Specifies the integer array (of length group size,
                    specified in comm). Entry i specifies the displacement
                    (relative to recvbuf ) at which to place the incoming data
                    from process i.

     recvtype       Specifies the data type of the receive buffer elements
                    (handle).

     comm           Specifies the communicator (handle).

     recvbuf        Returns the address of the receive buffer (choice).

     ierror         Specifies the return code value for successful completion,
                    which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the
                    mpif.h file.