MPI_Gatherv(3)

NAME
     MPI_Gatherv - Gathers values into specified locations from all processes
     in a group

SYNOPSIS
     C:

          #include <mpi.h>

          int MPI_Gatherv ( sendbuf, sendcnt,  sendtype, recvbuf,
          recvcnts, displs, recvtype, root, comm )
          void             *sendbuf;
          int               sendcnt;
          MPI_Datatype      sendtype;
          void             *recvbuf;
          int              *recvcnts;
          int              *displs;
          MPI_Datatype      recvtype;
          int               root;
          MPI_Comm          comm;


     C++:

          #include <mpi.h>

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


     Fortran:

          INCLUDE "mpif.h" (or USE MPI)

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

          CALL MPI_GATHERV(sendbuf, sendcount, sendtype,
          recvbuf, recvcounts(*), displs(*), recvtype, root, 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_Gatherv routine gathers values into specified locations from all
     processes in a group.  This routine accepts the following parameters:

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

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

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

     recvcnts       Specifies an integer array (of length group size,
                    specified in comm) containing the number of elements that
                    are received from each process (significant only at root).

     displs         Specifies an 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 (significant only at root).

     recvtype       Specifies the data type of the receive buffer elements
                    (handle; significant only at root).

     root           Specifies the rank of the receiving process (integer).

     comm           Specifies the communicator (handle).

     recvbuf        Returns the address of the receive buffer (choice;
                    significant only at root).

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