| mpi.probe {Rmpi} | R Documentation |
MPI_Probe and MPI_Iprobe APIs
Description
mpi.probe uses the source and tag of incoming message to set a
status. mpi.iprobe does the same except it is a nonblocking call,
i.e., returns immediately.
Usage
mpi.probe(source, tag, comm = 1, status = 0)
mpi.iprobe(source, tag, comm = 1, status = 0)
Arguments
source |
the source of incoming message or mpi.any.source() for any source. |
tag |
a tag number or mpi.any.tag() for any tag. |
comm |
a communicator number |
status |
a status number |
Details
When mpi.send or other nonblocking sends are used to send
a message, the receiver may not know the exact length before receiving
it. mpi.probe is used to probe the incoming message and put some
information into a status. Then the exact length can be found by using
mpi.get.count to such a status. If the wild card
mpi.any.source or mpi.any.tag are used, then one
can use mpi.get.sourcetag to find the exact source or tag of
a sender.
Value
mpi.probe returns 1 only after a matching message has been found.
mpi.iproble returns TRUE if there is a message that can be
received; FALSE otherwise.
Author(s)
Hao Yu
References
See Also
mpi.send, mpi.recv,
mpi.get.count