erlc
ERLC
命令
ERLC
命令摘要
编译器
描述
该erlc程序提供了在Erlang系统中运行所有编译器的常用方法。根据每个输入文件的扩展名，erlc调用相应的编译器。无论使用哪种编译器，都使用相同的标志来提供参数，例如包含路径和输出目录。
"."运行编译器时，当前工作目录，不包含在代码路径中。这样可避免从当前工作目录加载Beam文件，这些文件可能与编译器或编译器使用的Erlang / OTP系统有冲突。
输出
erlc flags file1.ext file2.ext...
编译一个或多个文件。这些文件必须包含扩展名，例如.erlErlang源代码或.yrlYecc源代码。Erlc使用扩展来调用正确的编译器。
一般有用的标志
支持下列标志：
-I <Directory>
命令编译器搜索Directory.遇到-include或-include_lib指令时，编译器将在以下目录中搜索头文件：
"."文件服务器的当前工作目录。
- 已编译文件的基本名称。
- 使用选项指定的目录。
-I；首先搜索最后指定的目录。
-o <Directory>
编译器放置输出文件的目录。默认为当前工作目录。
-D<Name>
定义一个宏。
-D<Name>=<Value>
定义具有指定值的宏。值可以是任何Erlang项。根据平台的不同，如果shell本身解释某些字符，则可能需要引用该值。在Unix上，必须引用包含元组和列表的术语。包含空格的术语必须在所有平台上引用。
-W<Error>
将所有警告都变成错误。
-W<Number>
将警告级别设置为Number.默认为1.若要关闭警告，请使用-W0...
-W
同-W1...。默认。
-v
启用详细输出。
-b <Output_type>
指定输出文件的类型。Output_type与输出文件的文件扩展名相同，但没有句号。此选项被具有单一输出格式的编译器忽略。
-smp
使用SMP仿真器进行编译。这对于编译本机代码是非常有用的，它必须使用与要运行的相同的运行时系统进行编译。
-M
生成Makefile规则以跟踪标头依赖关系。规则被发送到stdout。没有生成目标文件。
-MF <Makefile>
作为选项-M，除了写入Makefile Makefile。没有生成目标文件。
-MD
同-M -MF <File>.Pbeam...
-MT <Target>
结合选项-M或-MF，将发出的规则的名称更改为Target...
-MQ <Target>
作为选项-MT，除了特殊的字符make/1被引用。
-MP
结合选项-M或-MF，为每个依赖项添加一个假目标。
-MG
结合选项-M或-MF，将丢失的标头视为生成的文件，并将它们添加到依赖项中。
--
信号表明不会有更多的选择。其余的参数被视为文件名，即使它们以连字符开头。
+<Term>
一个以plus（+）而不是连字符开头的标志被转换成Erlang术语并且不变地传递给编译器。例如，export_allErlang编译器的选项可以如下指定：
erlc +export_all file.erl
根据平台的不同，如果shell本身解释某些字符，则可能需要引用该值。在Unix上，必须引用包含元组和列表的术语。包含空格的术语必须在所有平台上引用。
特殊标志
下列标志在特殊情况下非常有用，例如重建OTP系统：
-pa <Directory>
附加Directory到被调用的Erlang模拟器的代码路径前面。这可以用于调用另一个编译器，而不是默认编译器。
-pz <Directory>
附加Directory被调用的Erlang模拟器中的代码路径。
支持的编译器
支持下列编译器：
.erl
Erlang源代码。它生成一个.beam档案。
选项-P，-E和-S等同于+'P'，+'E'和+'S'，除了没有必要包含单引号来保护它们不受shell限制。
支持的选项：-I，-o，-D，-v，-W，-b。
.S
Erlang汇编程序源代码。它生成一个.beam档案。
支持的选项：与.erl...
.core
Erlang核心源代码。它生成一个.beam档案。
支持的选项：与.erl...
.yrl
YECC源代码。它生成一个.erl档案。
使用-I带有文件名称的选项将该文件用作自定义序言文件（选项includefile）。
支持的选项：-o，-v，-I，-W。
.mib
用于SNMP的MIB。它生成一个.bin档案。
支持的选项：-I，-o，-W。
.bin
为SNMP编译的MIB。它生成一个.hrl档案。
支持的选项：-o，-v。
.rel
脚本文件。它生成一个引导文件。
使用选项-I命名要搜索应用程序文件的目录（相当于path选项列表中的systools:make_script/2）。
支持的备选方案：-o...
.asn1
ASN1文件。它从文件创建一个.erl，.hrl和文件。还编译使用Erlang编译器，除非指定了选项。.asn1db.asn1.erl+noobj
支持的选项：-I，-o，-b，-W。
.idl
IC文件。它运行IDL编译器。
支持的选项：-I，-o。
环境变量
ERLC_EMULATOR用于启动模拟器的命令。默认erl与erlc程序本身在同一目录中，或者如果它不存在，erl则在环境变量中指定的任何目录中PATH。
另见
erl(1)，compile(3)，yecc(3)，snmp(3)
