MPI_Bsend - Performs a basic send with user-specified
buffering
SYNOPSIS
C:
#include <mpi.h>
int MPI_Bsend( buf, count, datatype, dest, tag, comm )
void *buf;
int count, dest, tag;
MPI_Datatype datatype;
MPI_Comm comm;
C++:
#include <mpi.h>
void Comm::Bsend(
const void* buf,
int count,
const Datatype& datatype,
int dest,
int tag) const
Fortran:
INCLUDE "mpif.h" (or USE MPI)
<type> BUF(*)
INTEGER count, datatype, dest, tag, comm,
ierror
CALL MPI_BSEND(buf, count, datatype, dest,
tag, 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_Bsend routine performs a basic send operation with
user-specified buffering. This routine accepts the
following parameters:
buf Specifies the initial address of the send
buffer (choice)
count Specifies the number of elements in the send
datatype Specifies the data type of each send buffer
element (handle)
dest Specifies the rank of the destination
(integer)
tag Specifies the message tag (integer)
comm Specifies the communicator (handle)
ierror Specifies the return code value for successful
completion, which is in MPI_SUCCESS.
MPI_SUCCESS is defined in the mpif.h file.
NOTES
This send operation is provided as a convenience function;
it allows the user to send messages without worrying about
where the messages are buffered (of course, the user must
have provided buffer space by using the
MPI_Buffer_attach(3) routine).
The buffer space cannot be reused unless you are certain
that the message has been received (not just that it
should have been received). In C, you can force the
messages to be deliverd by using the following routines:
MPI_Buffer_detach( &b, &n );
MPI_Buffer_attach( b, n );
(The MPI_Buffer_detach(3) routine will not complete until
all buffered messages are delivered.)
SEE ALSO
MPI_Bsend_init(3),MPI_Buffer_attach(3),
MPI_Buffer_detach(3), MPI_Ibsend(3)
Man(1) output converted with
man2html