Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

blacs_freebuff

Frees BLACS buffer.

Syntax

call blacs_freebuff( icontxt, wait )

Input Parameters

icontxt

INTEGER. Integer handle that indicates the BLACS context.

wait

INTEGER. Parameter indicating whether to wait for non-blocking operations or not. If equals 0, the operations should not be waited for; free only unused buffers. Otherwise, wait in order to free all buffers.

Description

This routine releases the BLACS buffer.

The BLACS have at least one internal buffer that is used for packing messages. The number of internal buffers depends on what platform you are running the BLACS on. On systems where memory is tight, keeping this buffer or buffers may become expensive. Call freebuff to release the buffer. However, the next call of a communication routine that requires packing reallocates the buffer.

The wait parameter determines whether the BLACS should wait for any non-blocking operations to be completed or not. If wait = 0, the BLACS free any buffers that can be freed without waiting. If wait is not 0, the BLACS free all internal buffers, even if non-blocking operations must be completed first.