MPI Subroutine Reference

MPI_ERRHANDLER_FREE, MPI_Errhandler_free

Purpose

Marks an error handler for deallocation.

C synopsis

#include <mpi.h>
int MPI_Errhandler_free(MPI_Errhandler *errhandler);

C++ synopsis

#include mpi.h
void MPI::Errhandler::Free();

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_ERRHANDLER_FREE(INTEGER ERRHANDLER,INTEGER IERROR)

Parameters

errhandler

is an MPI error handler (handle) (INOUT)

IERROR

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

Description

This subroutine marks errhandler for deallocation and sets it (errhandler) to MPI_ERRHANDLER_NULL. Actual deallocation occurs when all communicators associated with the error handler have been deallocated or have had new error handlers attached.

Errors

Invalid error handler

MPI not initialized

MPI already finalized

Related information

MPI_ERRHANDLER_CREATE