Variables de entorno de OpenMP
Proporciona vínculos a variables de entorno usadas en la API de OpenMP.
La implementación de Visual C++ del estándar OpenMP incluye las siguientes variables de entorno. Estas variables de entorno se leen en el inicio del programa y las modificaciones en sus valores se omiten en tiempo de ejecución (por ejemplo, mediante _putenv, _wputenv).
| Variable de entorno | Descripción |
|---|---|
| OMP_SCHEDULE | Modifica el comportamiento de la cláusula schedule cuando schedule(runtime) se especifica en una directiva for o parallel for. |
| OMP_NUM_THREADS | Establece el número máximo de subprocesos en la región paralela, a menos que omp_set_num_threads o num_threads invaliden. |
| OMP_DYNAMIC | Especifica si el tiempo de ejecución de OpenMP puede ajustar el número de subprocesos en una región paralela. |
| OMP_NESTED | Especifica si el paralelismo anidado está habilitado, a menos que el paralelismo anidado esté habilitado o deshabilitado con omp_set_nested. |
OMP_DYNAMIC
Especifica si el tiempo de ejecución de OpenMP puede ajustar el número de subprocesos en una región paralela.
set OMP_DYNAMIC[=TRUE | =FALSE]
Comentarios
La OMP_DYNAMIC función omp_set_dynamic puede invalidar la variable de entorno.
El valor predeterminado de la implementación de Visual C++ del estándar OpenMP es OMP_DYNAMIC=FALSE.
Para obtener más información, vea 4.3 OMP_DYNAMIC.
Ejemplo
El siguiente comando establece la OMP_DYNAMIC variable de entorno en TRUE:
set OMP_DYNAMIC=TRUE
El siguiente comando muestra la configuración actual de la OMP_DYNAMIC variable de entorno:
set OMP_DYNAMIC
OMP_NESTED
Especifica si el paralelismo anidado está habilitado, a menos que el paralelismo anidado esté habilitado o deshabilitado con omp_set_nested.
set OMP_NESTED[=TRUE | =FALSE]
Comentarios
La OMP_NESTED función omp_set_nested puede invalidar la variable de entorno.
El valor predeterminado de la implementación de Visual C++ del estándar OpenMP es OMP_NESTED=FALSE.
Para obtener más información, vea 4.4 OMP_NESTED.
Ejemplo
El siguiente comando establece la OMP_NESTED variable de entorno en TRUE:
set OMP_NESTED=TRUE
El siguiente comando muestra la configuración actual de la OMP_NESTED variable de entorno:
set OMP_NESTED
OMP_NUM_THREADS
Establece el número máximo de subprocesos en la región paralela, a menos que omp_set_num_threads o num_threads invaliden.
set OMP_NUM_THREADS[=num]
Parámetros
num
Número máximo de subprocesos que desea en la región paralela, hasta 64 en la implementación de Visual C++.
Comentarios
La OMP_NUM_THREADS variable de entorno se puede invalidar mediante la función omp_set_num_threads o por num_threads.
El valor predeterminado de num en la implementación de Visual C++ del estándar OpenMP es el número de procesadores virtuales, incluidas las CPU de hyperthreading.
Para obtener más información, vea 4.2 OMP_NUM_THREADS.
Ejemplo
El siguiente comando establece la OMP_NUM_THREADS variable de entorno en 16:
set OMP_NUM_THREADS=16
El siguiente comando muestra la configuración actual de la OMP_NUM_THREADS variable de entorno:
set OMP_NUM_THREADS
OMP_SCHEDULE
Modifica el comportamiento de la cláusula schedule cuando schedule(runtime) se especifica en una directiva for o parallel for.
set OMP_SCHEDULE[=type[,size]]
Parámetros
size
(Opcional) Especifica el tamaño de las iteraciones. size debe ser un entero positivo. El valor predeterminado es 1, excepto cuando el tipo es estático. No es válido cuando type es runtime.
type
El tipo de programación, dynamic, guided, runtime, o static.
Comentarios
El valor predeterminado de la implementación de Visual C++ del estándar OpenMP es OMP_SCHEDULE=static,0.
Para obtener más información, vea 4.1 OMP_SCHEDULE.
Ejemplo
El siguiente comando establece la OMP_SCHEDULE variable de entorno:
set OMP_SCHEDULE="guided,2"
El siguiente comando muestra la configuración actual de la OMP_SCHEDULE variable de entorno:
set OMP_SCHEDULE