[ English | Japanese ]

コンパイルとリンク (C用)

このページでは、Vector Engine 向けのNEC Numeric Library Collectionを使ったユーザプログラムのコンパイル方法およびライブラリとのリンク方法を説明します。

必要となるコンパイラオプションは次の条件により変わってきます。

使用するライブラリ
分散メモリ並列の有無
共有メモリ並列の有無
デフォルト整数型のサイズ

事前準備

コンパイルとリンクを行う前に、コンパイル環境設定スクリプトnlcvars.sh または nlcvars.cshを一度実行する必要があります。

sh系：

 $ source /opt/nec/ve/bin/nlcvars.sh  [引数...]

csh系：

 % source /opt/nec/ve/bin/nlcvars.csh [引数...]

指定するべき引数は表1の通りです。

**表1:** コンパイル環境設定スクリプトの引数
分散メモリ並列	デフォルト整数型	引数
なし	32bit	なし
なし	64bit	`i64`
MPI	32bit	`mpi`
MPI	64bit	`mpi i64`

注意事項

注意事項
NEC C/C++コンパイラ(ncc/nc++)のVersion 5.0.0以降を使用してください。また、分散メモリ並列の機能を使用する場合にのみ、NEC MPIが必要です。Mellanox OFED (MOFED) 5.x環境ではNEC MPI 3.3.0以降、MOFED 4.x 環境ではNEC MPI 2.24.0以降かつ3.0.0未満が必要です。 32bit整数版ライブラリは、関数の整数型の引数が32bit整数型のライブラリです。同様に、64bit整数版ライブラリは、関数の整数型の引数が64bit整数型のライブラリです。コンパイラの精度拡張オプションを使用する場合は、引数拡張後のサイズに対応したライブラリをリンクしてください。実行ファイルは、リンクオプション `-static` により静的リンクで作成することを推奨します。デフォルトの動的リンクでは性能が低下する傾向があります。ライブラリ関数やルーチンを呼び出す共有オブジェクトを作成する際、リンクオプション `-static` を指定してはなりません。さもなくば、共有オブジェクトを使用するプログラムが、ライブラリの動的ロードのエラーで実行に失敗します。動的リンクで作成したプログラムを実行する際は、事前に環境変数 `VE_LD_LIBRARY_PATH` を適切に設定しなければなりません。 NEC Numeric Library Collection のライブラリパスが含まれている必要があります。 ASLの逐次版およびMPI並列版はスレッドセーフではありません。つまり、OpenMP並列またはハイブリッド並列プログラムでは、それぞれOpenMP並列版またはハイブリッド並列版を使用してください。 HeteroSolverとリンクしたプログラムを実行する場合は、実行する前に環境変数 `LD_LIBRARY_PATH`の設定も必要です。 "実行時の注意"を参照してください。

NEC C/C++コンパイラ(ncc/nc++)のVersion 5.0.0以降を使用してください。また、分散メモリ並列の機能を使用する場合にのみ、NEC MPIが必要です。Mellanox OFED (MOFED) 5.x環境ではNEC MPI 3.3.0以降、MOFED 4.x 環境ではNEC MPI 2.24.0以降かつ3.0.0未満が必要です。
32bit整数版ライブラリは、関数の整数型の引数が32bit整数型のライブラリです。
同様に、64bit整数版ライブラリは、関数の整数型の引数が64bit整数型のライブラリです。
コンパイラの精度拡張オプションを使用する場合は、引数拡張後のサイズに対応したライブラリをリンクしてください。
実行ファイルは、リンクオプション -static により静的リンクで作成することを推奨します。デフォルトの動的リンクでは性能が低下する傾向があります。
ライブラリ関数やルーチンを呼び出す共有オブジェクトを作成する際、リンクオプション -static を指定してはなりません。さもなくば、共有オブジェクトを使用するプログラムが、ライブラリの動的ロードのエラーで実行に失敗します。
動的リンクで作成したプログラムを実行する際は、事前に環境変数 VE_LD_LIBRARY_PATH を適切に設定しなければなりません。 NEC Numeric Library Collection のライブラリパスが含まれている必要があります。
ASLの逐次版およびMPI並列版はスレッドセーフではありません。つまり、OpenMP並列またはハイブリッド並列プログラムでは、それぞれOpenMP並列版またはハイブリッド並列版を使用してください。
HeteroSolverとリンクしたプログラムを実行する場合は、実行する前に環境変数 LD_LIBRARY_PATHの設定も必要です。 "実行時の注意"を参照してください。

NEC Numeric Library Collectionのバージョンを指定する場合

NEC Numeric Library Collection 3.0.0以降は、VE30用と
VE20およびVE10/VE10E用のライブラリおよびインクルードファイル等を提供しています。

VE30用

 /opt/nec/ve3/nlc/X.X.X/{include/, lib/, bin/}

VE20用およびVE10/VE10E用

 /opt/nec/ve/nlc/X.X.X/{include/, lib/, bin/}

NEC Numeric Library Collectionのバージョンを指定する場合は、
コンパイルとリンクを行う前に、以下の方法でバージョンを指定してください。

VE30用
sh系：
```
 $ source /opt/nec/ve3/nlc/X.X.X/bin/nlcvars.sh  [引数...] 
```
csh系：
```
 % source /opt/nec/ve3/nlc/X.X.X/bin/nlcvars.csh [引数...] 
```
ここで、X.X.X は NEC Numeric Library Collection のバージョン番号を表します。引数は表1を参照してください。
VE20用およびVE10/VE10E用
sh系：
```
 $ source /opt/nec/ve/nlc/X.X.X/bin/nlcvars.sh  [引数...] 
```
csh系：
```
 % source /opt/nec/ve/nlc/X.X.X/bin/nlcvars.csh [引数...] 
```
ここで、X.X.X は NEC Numeric Library Collection のバージョン番号を表します。引数は表1を参照してください。

コンパイル方法

コンパイルに用いるコマンドは、逐次またはOpenMP並列のライブラリを利用する場合ncc、 MPI並列またはハイブリッド並列のライブラリを利用する場合mpinccです。 32bit整数版ライブラリを利用する場合は、表2のコンパイルオプションを指定してコンパイルします。 64bit整数版ライブラリを利用する場合は、表3のオプションを指定してコンパイルします。

**表2:** 32bit整数版ライブラリを使用する場合
ライブラリ名		コンパイルオプション
ASL ネイティブインタフェース	逐次	なし
ASL ネイティブインタフェース	OpenMP並列	`-fopenmp`
ASL統合インタフェース	逐次	なし
	OpenMP並列	`-fopenmp`
	MPI並列	なし
	ハイブリッド並列	`-fopenmp`
FFTW3インタフェース	逐次	なし
	OpenMP並列	`-fopenmp`
	MPI並列	なし
	ハイブリッド並列	`-fopenmp`
CBLAS	逐次	なし
CBLAS	OpenMP並列	`-fopenmp`
SBLAS	逐次	なし
SBLAS	OpenMP並列	`-fopenmp`
HeteroSolver	OpenMP並列	`-fopenmp`
HeteroSolver	ハイブリッド並列	`-fopenmp`
Stencil Code Accelerator	逐次	なし
Stencil Code Accelerator	OpenMP並列	`-fopenmp`

**表3:** 64bit整数版ライブラリを使用する場合
ライブラリ名		コンパイルオプション
ASL ネイティブインタフェース	逐次	なし
ASL ネイティブインタフェース	OpenMP並列	`-fopenmp`
ASL統合インタフェース	逐次	なし
	OpenMP並列	`-fopenmp`
	MPI並列	なし
	ハイブリッド並列	`-fopenmp`
FFTW3インタフェース	逐次	なし
	OpenMP並列	`-fopenmp`
	MPI並列	なし
	ハイブリッド並列	`-fopenmp`
CBLAS	逐次	なし
CBLAS	OpenMP並列	`-fopenmp`
SBLAS	逐次	なし
SBLAS	OpenMP並列	`-fopenmp`
HeteroSolver	OpenMP並列	`-fopenmp`
HeteroSolver	ハイブリッド並列	サポートなし
Stencil Code Accelerator	逐次	なし
Stencil Code Accelerator	OpenMP並列	`-fopenmp`

リンク方法

リンクに用いるコマンドは、逐次またはOpenMP並列のライブラリを利用する場合ncc、 MPI並列またはハイブリッド並列のライブラリを利用する場合mpinccです。 32bit整数版ライブラリを利用する場合は、表4のリンクオプションを指定してリンクします。 64bit整数版ライブラリを利用する場合は、表5のリンクオプションを指定してリンクします。静的リンクで実行ファイルを作成する場合は、追加で-staticオプションを指定してください。動的リンクで実行ファイルを作成する場合は、追加でオプションを指定する必要はありませんが、 MPI を使用する場合は、 -shared-mpi オプションを指定しなければなりません。

**表4:** 32bit整数版ライブラリのリンクオプション
ライブラリ名		リンクオプション
ASL ネイティブインタフェース	逐次	`-lasl_sequential`
ASL ネイティブインタフェース	OpenMP並列	`-lasl_openmp -fopenmp`
ASL統合インタフェース	逐次	`-lasl_sequential`
	OpenMP並列	`-lasl_openmp -fopenmp`
	MPI並列	`-lasl_mpi_sequential`
	ハイブリッド並列	`-lasl_mpi_openmp -fopenmp`
FFTW3インタフェース	逐次	`-laslfftw3 -lasl_sequential`
	OpenMP並列	`-laslfftw3 -lasl_openmp -fopenmp`
	MPI並列	`-laslfftw3_mpi -lasl_mpi_sequential`
	ハイブリッド並列	`-laslfftw3_mpi -lasl_mpi_openmp -fopenmp`
CBLAS	逐次	`-lcblas -lblas_sequential`
CBLAS	OpenMP並列	`-lcblas -lblas_openmp -fopenmp`
SBLAS	逐次	`-lsblas_sequential`
SBLAS	OpenMP並列	`-lsblas_openmp -fopenmp`
HeteroSolver	OpenMP並列	`-lheterosolver_openmp -lblas_sequential -fopenmp`
HeteroSolver	ハイブリッド並列	`-lheterosolver_mpi_openmp -lblas_sequential -fopenmp`
Stencil Code Accelerator	逐次	`-lsca_sequential`
Stencil Code Accelerator	OpenMP並列	`-lsca_openmp -fopenmp`

**表5:** 64bit整数版ライブラリのリンクオプション
ライブラリ名		リンクオプション
ASL ネイティブインタフェース	逐次	`-lasl_sequential_i64`
ASL ネイティブインタフェース	OpenMP並列	`-lasl_openmp_i64 -fopenmp`
ASL統合インタフェース	逐次	`-lasl_sequential_i64`
	OpenMP並列	`-lasl_openmp_i64 -fopenmp`
	MPI並列	`-lasl_mpi_sequential_i64c`
	ハイブリッド並列	`-lasl_mpi_openmp_i64c -fopenmp`
FFTW3インタフェース	逐次	`-laslfftw3_i64 -lasl_sequential_i64`
	OpenMP並列	`-laslfftw3_i64 -lasl_openmp_i64 -fopenmp`
	MPI並列	`-laslfftw3_mpi_i64c -lasl_mpi_sequential_i64c`
	ハイブリッド並列	`-laslfftw3_mpi_i64c -lasl_mpi_openmp_i64c -fopenmp`
CBLAS	逐次	`-lcblas_i64 -lblas_sequential_i64`
CBLAS	OpenMP並列	`-lcblas_i64 -lblas_openmp_i64 -fopenmp`
SBLAS	逐次	`-lsblas_sequential_i64`
SBLAS	OpenMP並列	`-lsblas_openmp_i64 -fopenmp`
HeteroSolver	OpenMP並列	`-lheterosolver_openmp_i64 -lblas_sequential_i64 -fopenmp`
HeteroSolver	ハイブリッド並列	サポートなし
Stencil Code Accelerator	逐次	`-lsca_sequential_i64`
Stencil Code Accelerator	OpenMP並列	`-lsca_openmp_i64 -fopenmp`