Developer Guide and Reference

Contents

par-affinity, Qpar-affinity

Specifies thread affinity.

Syntax

Linux:
-par-affinity
=
[
modifier
,...]
type
[,
permute
][,
offset
]
macOS:
None
Windows:
/Qpar-affinity
:
[
modifier
,...]
type
[,
permute
][,
offset
]
Arguments
modifier
Is one of the following values:
granularity={fine|thread|core|tile}
,
[no]respect
,
[no]verbose
,
[no]warnings
,
proclist=proc_list
. The default is
granularity=core, respect, and noverbose
.
For information on value
proclist
, see Thread Affinity Interface .
type
Indicates the thread affinity. This argument is required and must be one of the following values:
compact
,
disabled
,
explicit
,
none
,
scatter
,
logical
,
physical
. The default is
none
. Values
logical
and
physical
are deprecated. Use
compact
and
scatter
, respectively, with no
permute
value.
permute
Is a positive integer. You cannot use this argument with
type
setting
explicit
,
none
, or
disabled
. The default is 0.
offset
Is a positive integer. You cannot use this argument with
type
setting
explicit
,
none
, or
disabled
. The default is 0.
Default
OFF
The thread affinity is determined by the run-time environment.
Description
This option specifies thread affinity, which binds threads to physical processing units. It has the same effect as environment variable KMP_AFFINITY.
This option overrides the environment variable when both are specified.
This option only has an effect if the following is true:
  • You have specified option
    [Q]parallel
    or option
    [q or Q]openmp
    (or both)
    .
  • You are compiling the main program.
This option may behave differently on Intel® microprocessors than on non-Intel microprocessors.
Alternate Options
None

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804