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.

       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.


Man(1) output converted with man2html