MPI_Comm_set_attr - Stores the communicator attribute
value associated with a key
SYNOPSIS
C:
#include <mpi.h>
int MPI_Comm_set_attr ( comm, comm_keyval, attribute_val )
MPI_Comm comm;
int comm_keyval;
void *attribute_val;
Fortran:
INCLUDE "mpif.h" (or USE MPI)
INTEGER comm, comm_keyval, ierror
INTEGER(KIND=MPI_ADDRESS_KIND) attribute_val
CALL MPI_COMM_SET_ATTR(comm, comm_keyval, attribute_val,
ierror)
STANDARDS
This function is defined in the MPI-2 standard.
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_Comm_set_attr routine stores the communicator
attribute value associated with a key. This function
replaces MPI_Attr_put, whose use is deprecated.
This routine accepts the following parameters:
comm Specifies the communicator to which the
attribute will be attached (handle)
comm_keyval Specifies the key value, as returned by
MPI_Comm_create_keyval(3) (integer)
attribute_val Specifies the attribute value
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,
MPI_APPNUM 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 of
kind MPI_ADDRESS_KIND. Note this is different from the
kind of the attribute value used in the deprecated
MPI_Attr_put routine.
If an attribute is already present, the
MPI_Comm_delete_attr(3) function (specified when the
corresponding keyval was created) will be called.
SEE ALSO
MPI_Comm_delete_attr(3), MPI_Comm_get_attr(3),
MPI_Comm_create_keyval(3)
Man(1) output converted with
man2html