MPI Subroutine Reference

MPI_COMM_DELETE_ATTR, MPI_Comm_delete_attr

Purpose

Removes an attribute value from a communicator.

C synopsis

#include <mpi.h>
int MPI_Comm_delete_attr (MPI_Comm comm, int comm_keyval);

C++ synopsis

#include mpi.h
void MPI::Comm::Delete_attr(int comm_keyval);

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_COMM_DELETE_ATTR(INTEGER COMM, INTEGER COMM_KEYVAL, INTEGER IERROR)

Parameters

comm

is the communicator from which the attribute is deleted (handle) (INOUT)

comm_keyval

is the key value (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_COMM_DELETE_ATTR does not interoperate with MPI_ATTR_DELETE. 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

Fatal errors:

MPI not initialized

MPI already finalized

Wrong keytype (MPI_ERR_ARG) attribute key is not a communicator key

Related information

MPI_ATTR_DELETE

MPI_COMM_CREATE_KEYVAL

MPI_COMM_GET_ATTR

MPI_COMM_SET_ATTR