MPI_ATTR_PUT(3)MPI_ATTR_PUT(3)NAMEMPI_Attr_put - Stores the attribute value associated with a key
SYNOPSIS
C:
#include <mpi.h>
int MPI_Attr_put ( comm, keyval, attr_value )
MPI_Comm comm;
int keyval;
void *attr_value;
C++:
#include <mpi.h>
void Comm::Set_attr(
int comm_keyval,
const void* attribute_val) const
Fortran:
INCLUDE "mpif.h" (or USE MPI)
INTEGER comm, keyval, attr_value, ierror
CALL MPI_ATTR_PUT(comm, keyval, attr_value,
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_Attr_put routine stores the attribute value associated with a
key. This routine accepts the following parameters:
comm Specifies the communicator to which the attribute will be
attached (handle)
keyval Specifies the key value, as returned by
MPI_Keyval_create(3) (integer)
attribute_val Specifies the attribute value
Page 1
MPI_ATTR_PUT(3)MPI_ATTR_PUT(3)
ierror Specifies the return code value for successful completion,
which is in MPI_SUCCESS. MPI_SUCCESS is defined in the
mpif.h file.
NOTES
Values of the permanent attributes MPI_TAG_UB, MPI_HOST, and MPI_IO
cannot be changed.
The type of the attribute value depends on whether C or Fortran is being
used. In C, an attribute value is a pointer (void *). In Fortran, it is
a single integer, .ft3 not a pointer, because Fortran has no pointers and
there are systems for which a pointer does not fit in an integer (for
example, any address system greater than 32 bits that uses 64 bits for
Fortran double precision).
If an attribute is already present, the MPI_Attr_delete(3) function
(specified when the corresponding keyval was created) will be called.
SEE ALSOMPI_Attr_delete(3), MPI_Attr_get(3), MPI_Keyval_create(3)
Page 2