Freigeben über


OpenMP-Umgebungsvariablen

Stellt Links zu Umgebungsvariablen bereit, die in der OpenMP-API verwendet werden.

Die Visual C++-Implementierung des OpenMP-Standards enthält die folgenden Umgebungsvariablen. Diese Umgebungsvariablen werden beim Programmstart gelesen und Änderungen an ihren Werten werden zur Laufzeit ignoriert (z. B. mithilfe von _putenv, _wputenv).

Umgebungsvariable Beschreibung
OMP_SCHEDULE Ändert das Verhalten der Zeitplanklausel , wenn schedule(runtime) sie in einer for Oder parallel for Direktive angegeben ist.
OMP_NUM_THREADS Legt die maximale Anzahl von Threads im parallelen Bereich fest, es sei denn, sie werden durch omp_set_num_threads oder num_threads außer Kraft gesetzt.
OMP_DYNAMIC Gibt an, ob die OpenMP-Laufzeit die Anzahl der Threads in einem parallelen Bereich anpassen kann.
OMP_NESTED Gibt an, ob geschachtelte Parallelität aktiviert ist, es sei denn, geschachtelte Parallelität ist aktiviert oder deaktiviert mit omp_set_nested.

OMP_DYNAMIC

Gibt an, ob die OpenMP-Laufzeit die Anzahl der Threads in einem parallelen Bereich anpassen kann.

set OMP_DYNAMIC[=TRUE | =FALSE]

Hinweise

Die OMP_DYNAMIC Umgebungsvariable kann von der omp_set_dynamic-Funktion überschrieben werden.

Der Standardwert in der Visual C++-Implementierung des OpenMP-Standards lautet OMP_DYNAMIC=FALSE.

Weitere Informationen finden Sie unter 4.3 OMP_DYNAMIC.

Beispiel

Mit dem folgenden Befehl wird die OMP_DYNAMIC Umgebungsvariable auf TRUE festgelegt:

set OMP_DYNAMIC=TRUE

Der folgende Befehl zeigt die aktuelle Einstellung der OMP_DYNAMIC Umgebungsvariable an:

set OMP_DYNAMIC

OMP_NESTED

Gibt an, ob geschachtelte Parallelität aktiviert ist, es sei denn, geschachtelte Parallelität ist aktiviert oder deaktiviert mit omp_set_nested.

set OMP_NESTED[=TRUE | =FALSE]

Hinweise

Die Umgebungsvariable OMP_NESTED kann von der omp_set_nested-Funktion überschrieben werden.

Der Standardwert in der Visual C++-Implementierung des OpenMP-Standards lautet OMP_NESTED=FALSE.

Weitere Informationen finden Sie unter 4.4 OMP_NESTED.

Beispiel

Mit dem folgenden Befehl wird die OMP_NESTED Umgebungsvariable auf TRUE festgelegt:

set OMP_NESTED=TRUE

Der folgende Befehl zeigt die aktuelle Einstellung der OMP_NESTED Umgebungsvariable an:

set OMP_NESTED

OMP_NUM_THREADS

Legt die maximale Anzahl von Threads im parallelen Bereich fest, es sei denn, sie werden durch omp_set_num_threads oder num_threads außer Kraft gesetzt.

set OMP_NUM_THREADS[=num]

Parameter

num
Die maximale Anzahl von Threads, die sie im parallelen Bereich benötigen, bis zu 64 in der Visual C++-Implementierung.

Hinweise

Die OMP_NUM_THREADS Umgebungsvariable kann von der omp_set_num_threads-Funktion oder von num_threads überschrieben werden.

Der Standardwert num in der Visual C++-Implementierung des OpenMP-Standards ist die Anzahl der virtuellen Prozessoren, einschließlich Hyperthreading-CPUs.

Weitere Informationen finden Sie unter 4.2 OMP_NUM_THREADS.

Beispiel

Mit dem folgenden Befehl wird die OMP_NUM_THREADS Umgebungsvariable auf :16

set OMP_NUM_THREADS=16

Der folgende Befehl zeigt die aktuelle Einstellung der OMP_NUM_THREADS Umgebungsvariable an:

set OMP_NUM_THREADS

OMP_SCHEDULE

Ändert das Verhalten der Zeitplanklausel , wenn schedule(runtime) sie in einer for Oder parallel for Direktive angegeben ist.

set OMP_SCHEDULE[=type[,size]]

Parameter

size
(Optional) Gibt die Größe der Iterationen an. Die Größe muss eine positive ganze Zahl sein. Der Standardwert ist 1, außer wenn der Typ statisch ist. Ungültig, wenn der Typ ist runtime.

type
Die Art der Planung, entweder dynamic, , guided, runtimeoder static.

Hinweise

Der Standardwert in der Visual C++-Implementierung des OpenMP-Standards lautet OMP_SCHEDULE=static,0.

Weitere Informationen finden Sie unter 4.1 OMP_SCHEDULE.

Beispiel

Mit dem folgenden Befehl wird die OMP_SCHEDULE Umgebungsvariable festgelegt:

set OMP_SCHEDULE="guided,2"

Der folgende Befehl zeigt die aktuelle Einstellung der OMP_SCHEDULE Umgebungsvariable an:

set OMP_SCHEDULE