erlc

名前

説明

この erlc プログラムは Erlang システムですべてのコンパイラを実行する共通の方法を提供します。各入力ファイルの拡張次第で、erlc は適切なコンパイラを呼び出します。どのコンパイラが使用されるかに関係なく、インクルードパスや出力ディレクトリなどのパラメータが同じフラグで提供されます。

使い方

erlc flags file1.ext file2.ext...

Erlc は1つかそれ以上のファイルをコンパイルします。そのファイルは拡張子を含まなければなりません、たとえば .erl は Erlang のソースコードであり、.yrl は Yecc のソースコードです。Erlc は 適切なコンパイラを呼び出すために拡張子を使用します。

一般的なフラグ

以下のフラグがサポートされています:

-I directory:

指定したディレクトリのインクルードファイルを検索するように指示します。-include や -include_dir ディレクティブに遭遇したとき、コンパイラは以下のディレクトリからヘッダーファイルを検索します:

1.

"."、これはファイルサーバーのカレントディレクトリです;

2.

コンパイルしたファイルの base name(訳注: ベースディレクトリ?)

3.

-I オプションを使用して指定されたディレクトリ。最後に指定されたディレクトリが最初に検索されます。

-o directory:

このディレクトリはコンパイラがファイルを出力すべきディレクトリです。もし指定しなかった場合、ファイルはカレントディレクトリに出力されるでしょう。

-Dname:

マクロの定義。

-Dname=value:

与えられた値と共にマクロを定義します。この値はあらゆる Erlang の term から成ります。機種依存により、シェル自身が解釈する特定の文字をクオートする必要があるかもしれません。Unix では、タプルやリストを含む terms はクオートされなければ成りません。すべてのプラッフォームでスペースを含む terms はクオートされなければ成りません。

-Wnumber:

警告レベルを number に設定します。デフォルトは 1 です。-W0 を使用することで警告を切ることが出来ます。

-W:

-W1 と同じです。これはデフォルトです。

-v:

詳細な出力を有効にします。

-b output-type:

出力ファイルの種類を指定します。一般に output-type はピリオドを除いた出力ファイルの拡張子と同じです。このオプションはコンパイラが単一の出力フォーマットしか持たない場合は無視されます。

-hybrid:

コンパイラは hybrid-heap エミュレータを使用します。これは主にネイティブコードをコンパイルする際に役立ちます、このコードは実行するシステムと同じシステムでコンパイルされる必要があります。

-smp:

SMP エミュレータを使用してコンパイルします。これは主にネイティブコードをコンパイルする際に役立ちます、このコードは実行するシステムと同じシステムでコンパイルされる必要があります。

--:

これ以降はオプションが続かないというシグナルです。残りの引数はハイフンから始まったとしてファイル名として扱われるでしょう。

+term:

ハイフンでなくプラス ('+') で始まるフラグは Erlang term に変換され、そのままコンパイラに渡ります。実例として、以下の用に export_all オプションを Erlang コンパイラに指定することが出来ます:

erlc +export_all file.erl

機種依存により、シェル自身が解釈する特定の文字をクオートする必要があるかもしれません。Unix では、タプルやリストを含む terms はクオートされなければ成りません。すべてのプラッフォームでスペースを含む terms はクオートされなければ成りません。

特別フラグ

このセクションのフラグは OTP システムのリビルドなど、特別な状況で役立ちます。

-pa directory:

呼び出された Erlang エミュレータのコードパスの先頭に directory を追加します。デフォルトのコンパイラから別のコンパイラを呼び出す事に使用できます。

-pz directory:

呼び出された Erlang エミュレータのコードパスの最後に directory を追加します。

サポートするコンパイラ

.erl:

Erlang ソースコード。これは .beam ファイルを生成します。

このオプション -P, -E, -S は, シェルから保護するためにシングルクォートが必要で無いことを除き、+'P', +'E', +'S' と同等です。
 +'P', +'E', +'S' 

サポートされるオプション: -I, -o, -D, -v, -W, -b

.yrl:

Yecc ソースコード。これは .erl ファイルを生成します。

カスタマイズしたプロローグファイルを使用するには、-I オプションにファイル名を指定してください(includefile オプション)。

サポートされるオプション: -o, -v, -I, -W (上記を参照)。

.mib:

SNMP の為の MIB です。これは .bin ファイルを生成します。

サポートされるオプション: -I, -o, -W

.bin:

SNMP の為のコンパイル済み MIB です。これは .hrl ファイルを生成します。

サポートされるオプション: -o, -v

.rel:

スクリプトファイル。これはブートファイルを生成します。

-I オプションで指定したディレクトリ名を使用してアプリケーションファイルを検索します(systools:make_script/2 のオプションリストの path と同等です)。

サポートされるオプション: -o

.asn1:

ASN1 ファイル。

.asn1 ファイルから.erl, .hrl, .asn1db ファイルを生成します。また、Erlang コンパイラに +noobj オプションを与えた場合を除き .erl のコンパイルと同様です。

サポートされるオプション: -I, -o, -b, -W。

.idl:

IC ファイル。

IDL コンパイラを実行します。

サポートされるオプション: -I, -o

環境変数

ERLC_EMULATOR:

エミュレータを開始する為のコマンド。erl コマンドが PATH で与えられた環境変数に存在しない場合、erlc　プログラムと同じディレクトリの erl がデフォルトになります。

関連項目

erl(1), compile(3), yecc(3), snmp(3)

Index

名前

説明

使い方

一般的なフラグ

特別フラグ

サポートするコンパイラ

環境変数

関連項目