Intel® C++ Compiler Classic Developer Guide and Reference

ID 767249
Date 7/13/2023
Public
Document Table of Contents

Enable Auto-Parallelization

To enable the auto-parallelizer, use the [Q]parallel option. This option detects parallel loops capable of being executed safely in parallel, and automatically generates multi-threaded code for these loops.

NOTE:
You may need to set the KMP_STACKSIZE environment variable to an appropriately large size to enable parallelization with this option.

NOTE:

Using this option enables parallelization for both Intel® microprocessors and non-Intel microprocessors. The resulting executable may get additional performance gain on Intel® microprocessors than on non-Intel microprocessors. The parallelization can also be affected by certain options, such as /arch (Windows), -m (Linux and macOS), or [Q]x.

An example of the command using auto-parallelization is as follows:

Linux

icc -c -parallel prog.cpp

macOS

icc -c -parallel prog.cpp

Windows

icl /c /Qparallel prog.cpp

Auto-parallelization uses two specific pragmas: #pragma parallel and #pragma noparallel.

The format of an auto-parallelization compiler pragma is below:

<prefix> <pragma>

where <prefix> indicates #pragma, the <prefix> is followed by the pragma name, as in:

#pragma parallel

The #pragma parallel pragma instructs the compiler to ignore dependencies that it assumes may exist and that would prevent correct parallelization in the immediately following loop. However, if dependencies are proven, they are not ignored. In addition, parallel [always] overrides the compiler heuristics that estimate the likelihood that parallelization of a loop increases performance. It allows a loop to be parallelized even if the compiler thinks parallelization may not improve performance. If the ASSERT keyword is added, as in #pragma parallel [always [assert]], the compiler generates an error-level assertion message saying that the compiler analysis and cost model indicate that the loop cannot be parallelized.

The #pragma noparallel pragma disables auto-parallelization.

See Also