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