mkl_set

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

mkl_set_mpi

Sets the implementation of the message-passing interface to be used by Intel® oneAPI Math Kernel Library (oneMKL) .

Syntax

intmkl_set_mpi ( intvendor , const char*custom_library_name );

Include Files

mkl.h

Input Parameters

Name	Type	Description
`vendor`	int	Specifies the implementation of the message-passing interface (MPI) to use: Possible values: MKL_BLACS_CUSTOM - a custom MPI library. Requires a prebuilt custom MPI BLACS library. MKL_BLACS_MSMPI - Microsoft MPI library. MKL_BLACS_INTELMPI - Intel® MPI library. MKL_BLACS_MPICH - MPICH MPI library.
`custom_library_namevendor`	const char *	The filename (without a directory name) of the custom BLACS dynamic library to use. This library must be located in the directory with your application executable or with Intel® oneMKL dynamic libraries. Can be NULL or an empty string.

Name

Type

Description

vendor

int

Specifies the implementation of the message-passing interface (MPI) to use:

Possible values:

MKL_BLACS_CUSTOM - a custom MPI library. Requires a prebuilt custom MPI BLACS library.
MKL_BLACS_MSMPI - Microsoft MPI library.
MKL_BLACS_INTELMPI - Intel® MPI library.
MKL_BLACS_MPICH - MPICH MPI library.

custom_library_namevendor

const char *

The filename (without a directory name) of the custom BLACS dynamic library to use. This library must be located in the directory with your application executable or with Intel® oneMKL dynamic libraries. Can be NULL or an empty string.

Description

Call this function to set the MPI implementation to be used by Intel® oneMKL on Windows* OS when dynamic Intel® oneMKL libraries are used. For all other configurations, the function returns an error indicating that you cannot set the MPI implementation. You can specify your own prebuilt dynamic BLACS library for a custom MPI by setting vendor to MKL_BLACS_CUSTOM and optionally passing the name of the custom BLACS dynamic library. If the custom_library_path parameter is NULL or an empty string, Intel® oneMKL uses the default platform-specific library name: mkl_blacs_custom_lp64.dll or mkl_blacs_custom_ilp64.dll , depending on whether the BLACS interface linked against your application is LP64 or ILP64.

Return Values

Name	Type	Description
`status`	int	The return status: 0 - The function completed successfully. -1 - The `vendor` parameter is invalid. -2 - The `custom_library_name` parameter is invalid. -3 - The MPI library cannot be set at this point.

Name

Type

Description

status

int

The return status:

0 - The function completed successfully.
-1 - The vendor parameter is invalid.
-2 - The custom_library_name parameter is invalid.
-3 - The MPI library cannot be set at this point.

Product and Performance Information
Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex . Notice revision #20201201

Product and Performance Information

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex .

Notice revision #20201201

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

mkl_set_mpi

Syntax

Include Files

Input Parameters

Description

Return Values