2.2 OpenMP 環境変数

OMP_SCHEDULE

スケジュール型が RUNTIME として指定された DO、PARALLEL DO、for、parallel for の指令またはプラグマのスケジュール型を指定します。

定義しない場合は、デフォルト値の STATIC が使用されます。value は "type[,chunk]" という書式で指定します。

例: setenv OMP_SCHEDULE 'GUIDED,4'

OMP_NUM_THREADS

並列領域の実行中に使うスレッドの数を設定します。

この数は NUM_THREADS 節または OMP_SET_NUM_THREADS() への呼び出しによって上書きできます。

設定しない場合は、デフォルト値の 1 が使用されます。value には必ず正の整数を指定します。

例: setenv OMP_NUM_THREADS 16

OMP_DYNAMIC

並列領域の実行で使用可能なスレッド数の動的調整を有効ま たは無効にします。

設定しない場合は、デフォルト値の TRUE が使用されます。value には、TRUE または FALSE を指定します。

例: setenv OMP_DYNAMIC FALSE

OMP_NESTED

入れ子並列処理を有効または無効にします。

value には、TRUE または FALSE を指定します。

デフォルトは FALSE です。

例: setenv OMP_NESTED FALSE

OMP_STACKSIZE

OpenMP により作成されたスレッドのスタックサイズを設定します。 

サイズは 通常 K バイト単位の正の整数で指定されます。また、B、K、M、または G を付けて、それぞれバイト、K バイト、M バイト、または G バイト単位で指定することもあります。

例: setenv OMP_STACKSIZE 10M

OMP_WAIT_POLICY

スレッドの待機に関する目的のポリシーとして、ACTIVE または PASSIVE のいずれかを設定します。

ACTIVE を指定すると、スレッドは待機中にも CPU 時間を消費します。 PASSIVE を指定すると、スレッドは CPU 時間を消費しないか、スリープ状態に入ります。

OMP_MAX_ACTIVE_LEVELS

入れ子になったアクティブな並列領域のレベルの最大数に非負の整数値を設定します。 

OMP_THREAD_LIMIT

OpenMP プログラム全体で使用するスレッド数に正の整数を設定します。 

PARALLEL

従来のプログラムとの互換性のため、PARALLEL 環境変数を設定すると、OMP_NUM_THREADS を設定したのと同じ効果が得られます。ただし、PARALLEL と OMP_NUM_THREADS の両方に設定する場合は、同じ値を設定する必要があります。

SUNW_MP_WARN

OpenMP の実行時ライブラリで出力される警告メッセージを制御します。TRUE に設定した場合は、実行時ライブラリの警告メッセージが stderr に出力されます。FALSE に設定した場合は、警告メッセージが無効になります。デフォルトは FALSE です。

OpenMP 実行時ライブラリは、不正な入れ子やデッドロックなど、共通の OpenMP 違反を調べることができます。ただし、実行時チェックを使用するとプログラムの実行時にオーバーヘッドが加わります。第 3 章実装によって定義される動作を参照してください。

SUNW_MP_WARN を TRUE に設定している場合、実行時ライブラリは stderr に警告メッセージを出力します。また、警告メッセージを認証するためにプログラムでコールバック関数が登録されている場合も、実行時ライブラリは警告メッセージを出力します。次の関数を呼び出すことにより、プログラムでユーザーコールバック関数を登録できます。

   int sunw_mp_register_warn (void (*func)(void *));

コールバック関数のアドレスは、sunw_mp_register_warn() に引数として渡されます。この関数は、コールバック関数の登録に成功した場合 0 を、失敗した場合 1 を返します。

プログラムでコールバック関数が登録されている場合、libmtsk はエラーメッセージを含むローカライズされた文字列にポインタを渡し、登録済みの関数を呼び出します。メモリーの割り当て先は、コールバック関数から戻ると無効になります。

次に例を示します。 

setenv SUNW_MP_WARN TRUE

SUNW_MP_THR_IDLE

OpenMP プログラムのバリアで待ち状態または新しい並列領域の実行待ち状態のアイドルスレッドの状態を制御します。次のいずれかの値を設定できます。SPIN、SLEEP、SLEEP(times)、SLEEP(timems)、または SLEEP(timemc)。time には時間を整数で指定し、s、ms、および mc には時間の単位 (それぞれ、秒、ミリ秒、マクロ秒) を指定します。

SPIN を指定すると、アイドルスレッドは、バリアで待機中または新しい並列領域の実行待ちの間スピンをします。時間引数なしで SLEEP を指定すると、アイドルスレッドはすぐにスリープ状態になります。時間引数付きで SLEEP を指定すると、スレッドは指定した時間スピンを継続し、そのあとスリープ状態になります。

デフォルトのアイドルスレッド状態は、スリープ状態ですが、ある程度の時間スピンして待機したあとスリープ状態になることがあります。SLEEP、SLEEP(0)、SLEEP(0s)、SLEEP(0ms)、および SLEEP(0mc) はすべて同じです。

SUNW_MP_THR_IDLE および OMP_WAIT_POLICY の両方が設定されている場合、両方の値の間に一貫性が保たれている必要があります。

次に例を示します。  

setenv SUNW_MP_THR_IDLE SPIN 
setenv SUNW_MP_THR_IDLE SLEEP 
setenv SUNW_MP_THR_IDLE SLEEP(2s) 
setenv SUNW_MP_THR_IDLE SLEEP(20ms) 
setenv SUNW_MP_THR_IDLE SLEEP(150mc)

SUNW_MP_PROCBIND

この環境変数は、Solaris および Linux システムの両方で使用されます。SUNW_MP_PROCBIND 環境変数を使用して OpenMP プログラムのスレッドを実行中のシステムの仮想プロセッサに結合できます。プロセッサに結合することでパフォーマンスを向上することができますが、同じ仮想プロセッサに複数のスレッドが結合されると、パフォーマンスが低下します。詳細は、「2.3 プロセッサ結合」を参照してください。

SUNW_MP_MAX_POOL_THREADS

スレッドプールの最大数を指定します。プールにあるのは、OpenMP ライブラリが作成した非ユーザースレッドだけです。マスタースレッドやユーザーのプログラムが明示的に作成したスレッドは含まれません。この環境変数をゼロに設定すると、スレッドのプールは空になり、すべての並列領域は 1 つのスレッドによって実行されます。指定しない場合のデフォルトは、1023 です。詳細は、「「4.2 入れ子並列処理の制御」」を参照してください。

SUNW_MP_MAX_POOL_THREADS はプログラム全体で使用される非ユーザーの OpenMP スレッドの最大数を指定し、OMP_THREAD_LIMIT はプログラム全体で使用されるユーザーおよび非ユーザーの OpenMP スレッドの最大数を指定するものである点に留意してください。SUNW_MP_MAX_POOL_THREADS と OMP_THREAD_LIMIT の両方が設定されている場合は、両社の値の間に一貫性が保たれている必要があります。たとえば、OMP_THREAD_LIMIT の値は SUNW_MP_MAX_POOL_THREADS の値よりも 1 だけ大きい数値に設定します。

SUNW_MP_MAX_NESTED_LEVELS

有効な入れ子になった並列領域の深さの最大数を指定します。この環境変数で指定した数を超える有効な入れ子を持つ並列領域は、1 つのスレッドによって実行されます。IF 節が False になっている OpenMP 並列領域の場合は、その並列領域は無効であると見なされます。指定しない場合のデフォルトは、4 です。詳細は、「4.2 入れ子並列処理の制御」を参照してください。

SUNW_MP_MAX_NESTED_LEVELS と OMP_MAX_ACTIVE_LEVELS の両方を設定する場合は、両者は同じ値に設定される必要がある点に留意してください。

STACKSIZE

各スレッドのスタックサイズを設定します。値はキロバイト単位で指定します。デフォルトのスレッドスタックサイズは、32 ビット SPARC V8 および x86 プラットフォームで 4M バイト、64 ビット SPARC V9 および x86 プラットフォームで 8M バイトです。

次に例を示します。 

setenv STACKSIZE 8192 スレッドのスタックサイズを 8M バイトに設定します。

STACKSIZE 環境変数は、接尾辞 B、K、M、または G の付いた数値も受け付けます。これらの接尾辞はそれぞれ、バイト、キロバイト、メガバイト、ギガバイトを表します。デフォルトはキロバイトです。

STACKSIZE と OMP_STACKSIZE の両方を設定する場合は、両者は同じ値に設定される必要がある点に留意してください。

SUNW_MP_GUIDED_WEIGHT

チャンクのサイズを決定する重み係数を設定します。このチャンクサイズは、GUIDED スケジューリングによってループ中のスレッドに割り当てられます。値には、正の浮動小数点数を指定します。この値は、同一プログラム中で GUIDED スケジューリングが設定されたループすべてに適用されます。指定がない場合のデフォルト値は 2.0 です。