Use this feature to pin a particular MPI thread to a corresponding set of CPUs within a node and avoid undesired thread migration. This feature is available on operating systems that provide the necessary kernel interfaces.
The following schemes are used to identify logical processors in a system:
The number of a logical CPU is defined as the corresponding position of this CPU bit in the kernel affinity bit-mask. Use the cpuinfo utility, provided with your Intel MPI Library installation
The three-level hierarchical identification uses triplets that provide information about processor location and their order. The triplets are hierarchically ordered (package, core, and thread).
See the example for one possible processor numbering where there are two sockets, four cores (two cores per socket), and eight logical processors (two processors per core).
0 | 4 | 1 | 5 | 2 | 6 | 3 | 7 |
Socket | 0 | 0 | 0 | 0 | 1 | 1 | 1 | 1 |
Core | 0 | 0 | 1 | 1 | 0 | 0 | 1 | 1 |
Thread | 0 | 1 | 0 | 1 | 0 | 1 | 0 | 1 |
0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
Use the cpuinfo utility to identify the correspondence between the logical and topological enumerations. See Processor Information Utility for more details.
If you do not specify values for any main thread pinning environment variables, the default settings below are used. For details about these settings, see Environment Variables and Interoperability with OpenMP API.