MPI_REQUEST_FREE, MPI_Request_free

Purpose

Marks a request for deallocation.

C synopsis

#include <mpi.h>
int MPI_Request_free(int MPI_Request *request);

C++ synopsis

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

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_REQUEST_FREE(INTEGER REQUEST,INTEGER IERROR)

Parameters

request
     is a communication request (handle) (INOUT)

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

Description

This subroutine marks a request object for deallocation and sets request to
MPI_REQUEST_NULL. An ongoing communication associated with the request is
allowed to complete before deallocation occurs.

Notes

This function marks a communication request as free. Actual deallocation
occurs when the request is complete. Active receive requests and collective
communication requests cannot be freed.

Errors

Invalid request

Attempt to free receive request

Attempt to free CCL request

A Grequest free function returned an error

MPI not initialized

MPI already finalized

Related information