Key values for attributes are system-allocated, by
MPI_{TYPE,COMM,WIN}_CREATE_KEYVAL. Only such values can be passed to the
functions that use key values as input arguments. In order to signal that
an erroneous key value has been passed to one of these functions,
there is a new MPI error class: MPI_ERR_KEYVAL. It can be
returned by MPI_ATTR_PUT, MPI_ATTR_GET,
MPI_ATTR_DELETE, MPI_KEYVAL_FREE,
MPI_{TYPE,COMM,WIN}_DELETE_ATTR,
MPI_{TYPE,COMM,WIN}_SET_ATTR,
MPI_{TYPE,COMM,WIN}_GET_ATTR,
MPI_{TYPE,COMM,WIN}_FREE_KEYVAL,
MPI_COMM_DUP, MPI_COMM_DISCONNECT, and MPI_COMM_FREE. The last three are included
because keyval is an argument to the copy and delete functions for
attributes.
Up: Caching
Next: Attributes Example
Previous: Datatypes
Return to MPI-2.1 Standard Index
Return to MPI Forum Home Page
MPI-2.0 of July 1, 2008
HTML Generated on July 6, 2008