https://gcc.gnu.org/onlinedocs/libgomp/GOMP_005fCPU_005fAFFINITY.html
-
Description:
-
Binds threads to specific CPUs. The variable should contain a space-separatedor comma-separated list of CPUs. This list may contain different kinds ofentries: either single CPU numbers in any order, a range of CPUs (M-N)or a range with some stride (M-N:S). CPU numbers are zero based. For example,
GOMP_CPU_AFFINITY="0 3 1-2 4-15:2"
will bind the initial threadto CPU 0, the second to CPU 3, the third to CPU 1, the fourth toCPU 2, the fifth to CPU 4, the sixth through tenth to CPUs 6, 8, 10, 12,and 14 respectively and then start assigning back from the beginning ofthe list.GOMP_CPU_AFFINITY=0
binds all threads to CPU 0.There is no libgomp library routine to determine whether a CPU affinityspecification is in effect. As a workaround, language-specific libraryfunctions, e.g.,
getenv
in C orGET_ENVIRONMENT_VARIABLE
inFortran, may be used to query the setting of theGOMP_CPU_AFFINITY
environment variable. A defined CPU affinity on startup cannot be changedor disabled during the runtime of the application.If both GOMP_CPU_AFFINITY and OMP_PROC_BIND are set,OMP_PROC_BIND has a higher precedence. If neither has been set andOMP_PROC_BIND is unset, or when OMP_PROC_BIND is set to
FALSE
, the host system will handle the assignment of threads to CPUs.
See also:
- OMP_PLACES, OMP_PROC_BIND