ARM汇编编译器的使用

10.4 ARM汇编编译器的使用
　　armasm是ARM汇编语言的交叉编译器，本节将详细介绍它的使用方法。
　　armasm命令行语法格式如下。
　　armasm options inputfile
　　在armasm命令中，除了文件名区分大小写之外，其他的参数都不区分大小写。option可是汇编器规定选项中的一个或多个的组合，多个选项用空格分开。下面详细介绍armasm的各参数。
　　· --16：告诉汇编器当前程序是Thumb指令程序，使用旧的Thumb语法，与在源程序开头使用伪操作CODE16意义相同。使用--thumb选项指定当前程序是使用ARM语法的Thumb或Thumb-2源程序。
　　· --32：告诉汇编器所处理的源程序是ARM指令的程序。此选项为汇编器的默认选项。
　　· --apcs ［qualifiers］：该选项告诉汇编器是否使用AAPCS标准编译源程序。详见AAPCS一节。
　　· --arm：同--32选项。
　　· --bigend：告诉汇编器将源程序按大端模式编译。汇编器默认为小端模式（littleend）。
　　· --brief_diagnostics：控制输出诊断信息。详见控制诊断信息输出一节。
　　· --littleend：告诉编译器将源程序按小端模式编译。这是汇编器的默认选项。
　　· --checkreglist：告诉汇编器检测RLIST、LDM、STM指令的寄存器列表是否按升序排列。使用此选项后，如果源程序中寄存器没有按升序排列，汇编器将给出警告信息。
　　· --cpu name：告诉汇编器允许程序所使用的CPU型号，详见CPU名一节。
　　· --debug：告诉编译器编译时产生DWARF格式的调试信息表。
　　· --depend dependfile：告诉编译器将程序的依赖关系列表输出到指定的dependfile文件中。当使用makefile文件对程序进行编译时，该选项十分有用。
　　· --diag_［error | remark | warning | suppress | style］：详见控制诊断信息输出一节。
　　· --dllexport_all：告诉编译器产生全局变量的动态可见列表（dynamic visibility），在将源程序编译成DLL文件时使用该选项。
　　· --dwarf2：和--debug选项配合使用。告诉编译器编译时产生DWARF2格式的调试信息表，当使用了--debug选项时，该选项为默认选项。
　　· --dwarf3：和--debug选项配合使用。告诉编译器编译时产生DWARF3格式的调试信息表。
　　· -m：告诉编译器将源文件的依赖关系列表输出到标准输出设备上。
　　· --md：告诉编译器将源文件的依赖关系列表输出到inputfile.d文件中。
　　· --errors errorfile：告诉编译器将编译的错误信息输出到errorfile文件中。
　　· --exceptions：详见指示编译器产生异常向量表一节。
　　· --exceptions_unwind：详见指示编译器产生anwind异常向量表一节。
　　· --fpmode model：详见10.4.3。
　　· --fpu name：选择指定目标系统中浮点运算单元的体系结构。
　　· -i dir ［，dir］…：为源文件搜索增加路径，如果要搜索的源文件路径已被此选项指定，那么在使用伪操作GET、INCLUDE、INCBIN包含源文件时，将不必指定搜索路径。
　　· --keep：指定汇编器将局部符号保留在目标文件的符号表中，供调试器进行调试时使用。
　　· --list ［listingfile］：告诉汇编器将汇编过程中产生的汇编程序列表保存到列表文件listingfile文件中。
　　· --maxcache n：指定最大的源程序cache大小，默认为8MB。
　　· --memaccess attributes：确定目标系统的内存属性。详见内存访问属性一节。
　　· --no_cache：禁止源程序cache。默认情况下源程序cache是打开的。
　　· --no_esc：禁止C风格的特殊符号，如“\n”、“\t”。
　　· --no_exceptions：详见异常向量表产生一节。
　　· --no_exceptions_unwind：详见异常向量表产生一节。
　　· --no_hide_all：控制符号的可见性。
　　· --no_regs：告诉编译器不使用汇编器预定义的寄存器名。
　　· --no_warn：禁止警告信息。
　　· -o filename：给输出的目标文件命名。
　　· --predefine“directive”：告诉编译器预执行SET伪操作。详见预执行SET伪操作一节。
　　· --split_ldm：详见LDM和STM指令。
　　· --thumb：告诉编译器将源文件编译为符合ARM语法的Thumb指令。此编译选项和在源文件头使用THUMB伪操作效果相同。
　　· --unsafe：降低汇编器的警告级别。详见控制针对信息输出一节。
　　· --via file：指示汇编器从指定文件file中读取各选项信息。
　　· inputfile：为输入的源程序，必须是ARM或Thumb汇编源程序。
　　下面各节详细介绍以上选项中常用到的选项。
　　10.4.1 选项说明列表
　　在命令行输入下面的汇编命令，可使汇编器输出所有可用选项类别。
　　armasm –help
　　10.4.2 过程调用标准AAPCS
　　为了使不同编译器编译的程序之间能够相互调用，必须为子程序间的调用规定一定的规则。AAPCS就是这样一个标准。所谓AAPCS，其英文全称为Procedure Call Standard for the ARM Architecture （AAPCS），即ARM体系结构过程调用标准。它是ABI（Application Binary Interface （ABI） for the ARM Architecture （base standard） ［BSABI］）标准的一部分。
　　可以使用“--apcs”选项告诉编译器将源代码编译成符号AAPCS调用标准的目标代码。
　　注意使用“--apcs”选项并不影响代码的产生，编译器只是在各段中放置相应的属性，标识用户选定的AAPCS属性。
　　与AAPCS相关的编译/汇编选项有以下几种。
　　· none：指定输入文件不使用AAPCS规则。
　　· /interwork：指定输入文件符合ARM/Thumb交互标准。
　　· /nointerwork：指定输入文件不能使用ARM/Thumb交互。这是编译器默认选项。
　　· /ropi：指定输入文件是位置无关只读文件。
　　· /noropi：指定输入文件是非位置无关只读文件。这是编译器默认选项。
　　· /pic：同/ropi。
　　· /nopic：同/noropi。
　　· /rwpi：指定输入文件是位置无关可读可写文件。
　　· /norwpi：指定输入文件是非位置无关可读可写文件。
　　· /pid：同/rwpi。
　　· /nopid：同/norwpi。
　　· /fpic：指定输入文件编译成位置无关只读代码。代码中地址是FPIC地址。
　　· /swstackcheck：编译过程中对输入文件使用堆栈检测。
　　· /noswstackcheck：编译过程中对输入文件不使用堆栈检测。这是编译器默认选项。
　　· /swstna：如果汇编程序对于是否进行数据栈检查无所谓，而与该汇编程序连接的其他程序指定了选项/swst或选项/noswst，这时该汇编程序使用选项/swstna。
　　10.4.3 浮点模式选项
　　“--fpmode model”选项指定所选的浮点模式。可使用的浮点模式有以下几种。
　　· ieee_full：所有的浮点操作符号IEEE标准，其中包括单精度浮点操作和双精度浮点操作。浮点模式可以在使用时动态选择。使用该选项，编译器将使用下面的预定义符号。
　　__FP_IEEE；
　　__FP_FENV_EXCEPTIONS；
　　__FP_FENV_ROUNDING；
　　__FP_INEXACT_EXCEPTION。
　　· ieee_fixed：符合IEEE标准的浮点运算异常处理规则。使用该选项，编译器将使用下面的预定义符号。
　　__FP_IEEE；
　　__FP_FENV_EXCEPTIONS。
　　· ieee_no_fenv：和JAVA兼容的浮点运算算法选择。预定义的符号为__FP_IEEE。
　　· std：和C和C++兼容的浮点运算算法选择。这是编译器默认选项。
　　· fast：快速浮点运算选项。使用该选项将影响浮点运算的精度。
　　10.4.4 为CPU命名选项
　　使用“--cpu name”选项为目标程序使用的CPU命名。其中name的取值为4T、5TE或6T2。编译器的默认值为ARM7TDMI。
　　下面的选项使编译器列出所有当前可使用的CPU名。
　　armasm --cpu list
　　10.4.5 为FPU命名选项
　　选项“--FPU”指定所使用的浮点运算单元的结构。