MPI Subroutine Reference

MPI_ATTR_DELETE, MPI_Attr_delete

Purpose

Removes an attribute value from a communicator.

C synopsis

#include <mpi.h>
int MPI_Attr_delete(MPI_Comm comm,int keyval);

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_ATTR_DELETE(INTEGER COMM,INTEGER KEYVAL,INTEGER IERROR)

Parameters

comm

is the communicator that the attribute is attached (handle) (IN)

keyval

is the key value of the deleted attribute (integer) (IN)

IERROR

is the FORTRAN return code. It is always the last argument.

Description

This subroutine deletes an attribute from cache by key and invokes the attribute delete function delete_fn specified when the keyval is created.

Notes

MPI_COMM_DELETE_ATTR supersedes MPI_ATTR_DELETE.

MPI_ATTR_DELETE does not interoperate with MPI_COMM_DELETE_ATTR. The FORTRAN bindings for MPI-1 caching functions presume that an attribute is an INTEGER. The MPI-2 caching bindings use INTEGER (KIND=MPI_ADDRESS_KIND). In an MPI implementation that uses 64-bit addresses and 32-bit INTEGERS, the two formats would be incompatible.

Errors

A delete_fn did not return MPI_SUCCESS

Invalid communicator

Invalid keyval

keyval is undefined

Invalid keyval

keyval is predefined

MPI not initialized

MPI already finalized

Related information

MPI_KEYVAL_CREATE