| armlink使用方法详解 |
一、基本术语
在介绍armlink的使用方法之前，先介绍要涉及到的一些术语。
1) 映像文件(image)：
是指一个可执行文件，在执行的时候被加载到处理器中。一个映像文件有多个线程。它是ELF(Executable and linking format)格式的。 段(Section)：描述映像文件的代码或数据块。
2) RO
是Read-only的简写形式。
3) RW
是Read-write.的简写形式。
4) ZI
是Zero-initialized的简写形式。
5) 输入段(input section)
它包含着代码，初始化数据或描述了在应用程序运行之前必须要初始化为0的一段内存。
6) 输出段(output section)
它包含了一系列具有相同的RO，RW或ZI属性的输入段。
7) 域(Regions)
在一个映像文件中，一个域包含了1至3个输出段。多个域组织在一起，就构成了最终的映像文件。
8) Read Only Position Independent(ROPI)
它是指一个段，在这个段中代码和只读数据的地址在运行时候可以改变。
9) Read Write Position Independent(RWPI)
它是指一个段，在该段中的可读/写的数据地址在运行期间可以改变。
10) 加载时地址
是指映像文件位于存储器(在该映像文件没有运行时)中的地址。
11) 运行时地址
是指映像文件在运行时的地址。
二、命令语法
armlink [-help] [-vsn] [-partial] [-output file] [-elf] [-reloc][-ro-base address] [-ropi] [-rw-base address] [-rwpi] [-split] [-scatter file][-debug|-nodebug][-remove?RO/RW/ZI/DBG]|-noremove] [-entry location ] [-keep section-id] [-first section-id] [-last section-id] [-libpath pathlist] [-scanlib|-noscanlib] [-locals|-nolocals] [-callgraph] [-info topics] [-map] [-symbols] [-symdefs file] [-edit file] [-xref] [-xreffrom object(section)] [-xrefto object(section)] [-errors file] [-list file] [-verbose] [-unmangled |-mangled] [-match crossmangled][-via file] [-strict] [-unresolved symbol][-MI|-LI|-BI] [input-file-list]
上面各选项的含义分别为：
1) -help 这个选项会列出在命令行中常用的一些选项操作。
2) -vsn 这个选项显示出所用的armlink的版本信息。
3) -partial 用这个选项创建的是部分链接的目标文件而不是可执行映像文件。
4) -output file 这个选项指定了输出文件名，该文件可能是部分链接的目标文件，也可能是可执行映像文件。如果输出文件名没有特别指定的话，armlink将使用下面的默认： 如果输出是一个可执行映像文件，则生成的输出文件名为__image.axf； 如果输出是一个部分链接的目标文件，在生成的文件名为__object.o； 如果没有指定输出文件的路径信息，则输出文件就在当前目录下生成。如果指定了路径信息，则所指定的路径成为输出文件的当前路径。
5) -elf 这个选项生成ELF格式的映像文件，这也是armlink所支持的唯一的一种输出格式，这是默认选项。
6) -reloc 这个选项生成可重定址的映像。一个可重定址的映像具有动态的段，这个段中包含可重定址信息，利用这些信息可以在链接后，进行映像文件的重新定址； -reloc，-rw-base 一起使用，但是如果没有-split选项，链接时会产生错误。
7) -ro-base address 这个选项将包含有RO(Read-Only属性)输出段的加载地址和运行地址设置为address，该地址必须是字对齐的，如果没有指定这个选项，则默认的RO基地址值为0x8000。
8) -ropi 这个选项使得包含有RO输出段的加载域和运行域是位置无关的。如果该选项没有使用，则相应的域被标记为绝对的。通常每一个只读属性的输入段必须是只读位置无关的。如果使用了这个选项，armlink将会进行以下操作： 检查各段之间的重定址是否有效； 确保任何由armlink自身生成的代码是只读位置无关的。 这里希望读者注意的是，ARM工具直到armlink完成了对输入段的处理后，才能够决定最终的生成映像是否为只读位置无关的。这就意味着 ，即使为编译器和汇编器指定了ROPI选项，armlink也可能会产生ROPI错误信息。 -
9) rw-base address 这个选项设置包含RW(Read/Write属性)输出段的域的运行时地址，该地址必须是字对齐的。 如果这个选项和-split选项一起使用，将设置包含RW输出段的域的加载和运行时地址都设置在address处。
10) -rwpi 这个选项使得包含有RW和ZI(Zero Initialization，初始化为0)属性的输出段的加载和运行时域为位置无关的。如果该选项没有使用，相应域标记为绝对的。这个选项要求-rw-base选项后有值，如果-rw-base没有指定的话，默认其值为0，即相当于-rw-base 0。通常每一个可写的输入段必须是可读/ 可写的位置无关的。 如果使用了该选项，armlink会进行以下的操作： 检查可读/可写属性的运行域的输入段是否设置了位置无关属性； 检查在各段之间的重定址是否有效； 生成基于静态寄存器sb的条目，这些在RO和RW域被拷贝和初始化的时候会用到。 编译器并不会强制可写的数据一定要为位置无关的，这就是说，即使在为编译器和汇编器指定了RWPI选项，armlink也可能生成数据不是RWPI的信息。
11) -split 这个选项将包含RO和RW属性的输出段的加载域，分割成2个加载域。一个是包含RO输出段的加载域，默认的加载地址为0x8000，但是可以用-ro-base选项设置其他的地址值，另一个加载域包含RW属性的输出段，由-rw-base选项指定加载地址，如果没有使用-rw-base选项的话，默认使用的是-rw-base 0。
12) -scatter file 这个选项使用在file中包含的分组和定位信息来创建映像内存映射。 注意，如果使用了该选项的话，必须要重新实现堆栈初始化函数__user_initial_stackheap()。
13) -debug 这个选项使输出文件包含调试信息，调试信息包括，调试输入段，符号和字符串表。这是默认的选项。
14) -nodebug 这个选项使得在输出文件中不包含调试信息。生成的映像文件短小，但是不能进行源码级的调试。armlink对在输入的目标文件和库函数中发现的任何调试输入段都不予处理，当加载映像文件到调试器中的时候，也不包含符号和字符串信息表。这个选项仅仅是对装载到调试器的映像文件的大小有影响，但是对要下载到目标板上的二进制代码的大小没有任何影响。 如果用armlink进行部分链接生成目标文件而不是映像文件，则虽然在生成的目标文件中不含有调试输入段，但是会包含符号和字符串信息表。 这里特别请读者注意的是： 如果要在链接完成后使用fromELF工具的话，不可使用-nodebug选项，这是因为如果生成的映像文件中不包含调试信息的话，则有下面的影响： fromELF不能将映像文件转换成其他格式的文件； fromELF不能生成有意义的反汇编列表。
|
15) -remove (RO/RW/ZI/DBG) 使用这个选项会将在输入段未使用的段从映像文件中删除。如果输入段中含有映像文件入口点或者该输入段被一个使用的段所引用，则这样的输入段会当作已使用的段。
在使用这个选项时候要注意，不要删除异常处理函数。使用-keep选项来标识异常处理函数，或用ENTRY伪指令标明是入口点。为了更精确的控制删除未使用的段，可以使用段属性限制符。可以使用以下的段属性限制符：
RO 删除所有未使用的RO属性的段；
RW 删除所有未使用的RW属性的段；
ZI 删除所有未使用的ZI属性的段；
DBG 删除所有未使用的DEBUG属性的段。
这些限制符出现的顺序是任意的，但是它们必须要有”( )”括住，多个限制符之间要用符号”/”进行间隔。ADS软件中默认选项是-remove (RO/RW/ZI/DBG)。 如果没有指定段属性限制符，则所有未使用的段都会被删除。因为-remove就等价于-remove(RO/RW/ZI/DBG)选项。
16) -noremove 这个选项保留映像文件中所有未被使用的段。
17) -entry location 这个选项指定映像文件中唯一的初始化入口点。一个映像文件可以包含多个入口点，使用这个命令定义的初始化入口点是存放在可执行文件的头部，以供加载程序加载时使用。当一个映像文件被装载时，ARM调试器使用这个入口点地址来初始化PC指针。初始化入口点必须满足下面的条件： 映像文件的入口点必须位于运行域内； 运行域必须是非覆盖的，并且必须是固定域(就是说，加载域和运行域的地址相同)。
在这里可以用以下的参数代替location参数：
1. 入口点地址：这是一个数值，例如-entry 0x0；
2. 符号：该选项指定映像文件的入口点为该符号所代表的地址处，比如：
-entry int_handler 表示程序入口点在符号int_handler所在处。 如果该符号有多处定义存在，armlink将产生出错信息。
-entry offset+object(section)：该选项指定在某个目标文件的段的内部的某个偏移量处为映像文件的入口地址，例如： -entry 8+startup(startupseg) 如果偏移量值为0，可以简写成object(section)，如果输入段只有一个，则可以简化为object。
18) -keep section-id 使用该选项，可以指定保留一个输入段，这样的话，即使该输入段没有在映像文件中使用，也不会被删除。
参数section-id取下面一些格式：
1． symbol 该选项指定定义symbol的输入段不会在删除未使用的段时被删除。如果映像文件中有多处symbol定义存在，则所有包含symbol定义的输入段都不会被删除。例如： -keep int_handler则所有定义int_handler的符号的段都会保留，而不被删除。 为了保留所有含有以_handler结尾的符号的段，可以使用如下的选项： -keep *_handler
2． object(section) 这个选项指定了在删除未使用段时，保留目标文件中的section段。输入段和目标名是不区分大小写的，例如，为了在目标文件vectors.o中保留vect段，使用： -keep vectors.o(vect) 为了保留vectors.o中的所有以vec开头的段名，可以使用选项： -keep vectors.o(vec*)
3． object 这个选项指定在删除未使用段时，保留该目标文件唯一的输入段。目标名是不区分大小写的，如果使用这个选项的时候，目标文件中所含的输入段不止一个的话，armlink会给出出错信息。比如，为了保留每一个以dsp开头的只含有唯一输入段的目标文件，可以使用如下的选项： -keep dsp*.o
19) -first section-id 这个选项将被选择的输入段放在运行域的开始。通过该选项，将包含复位和中断向量地址的段放置在映像文件的开始，可以用下面的参数代替section-id:
1．symbol 选择定义symbol的段。禁止指定在多处定义的symbol，因为多个段不能同时放在映像文件的开始。
2．object(section) 从目标文件中选择段放在映像文件的开始位置。在目标文件和括号之间不允许存在空格，例如 -first init.o(init)
3．object 选择只有一个输入段的目标文件。如果这个目标文件包含多个输入段，armlink会产生错误信息。用这个选项的例子如下： -first init.o 这里希望读者注意的是： 使用-first不能改变在域中按照RO段放在开始，接着放置RW段，最后放置ZI段的基本属性排放顺序。如果一个域含有RO段，则RW或ZI段就不能放在映像文件的开头。类似地，如果一个域有RO或RW段，则ZI段就不能放在文件开头。 两个不同的段不能放在同一个运行时域的开头，所以使用该选项的时候只允许将一个段放在映像文件的开头。
20) -last section-id 这个选项将所选择的输入段放在运行域的最后。例如，用这个选项能够强制性的将包含校验和的输入段放置在RW段的最后。使用下面的参数可以替换section-id。
1. symbol 选择定义symbol的段放置在运行域的最后。不能指定一个有多处定义的symbol。使用该参数的例子如下： -last checksum
2. object(section) 从目标文件中选择section段。在目标文件和后面的括号间不能有空格，用该参数的例子为： -last checksum.o(check)
3. object 选择只有一个输入段的目标，如果该目标文件中有多个输入段，armlink会给出出错信息。 和-first选项一样，需要读者注意的是; 使用-last选项不能改变在域中将RO段放在开始，接着放置RW段，最后放置ZI段的输出段基本的排放顺序。如果一个域含有ZI段，则RW段不能放在最后，如果一个域含有RW或ZI段，则RO段不能放在最后。 在同一个运行域中，两个不同的段不能同时放在域的最后位置。
21) -libpath pathlist 这个选项为ARM标准的C和C++库指定了搜索路径列表。 注意，这个选项不会影响对用户库的搜索路径。 这个选项覆盖了环境变量ARMLIB所指定的路径。参数pathlist是一个以逗号分开的多个路径列表，即为path1, path2,... pathn，这个路径列表只是用来搜索要用到的ARM库函数。默认的，对于包含ARM库函数的默认路径是由环境变量ARMLIB所指定的。
22) -scanlib 这个选项启动对默认库(标准ARM C和C++库)的扫描以解析引用的符号。这个选项是默认的设置。
23) -noscanlib 该选项禁止在链接时候扫描默认的库。
24) -locals 这个选项指导链接器在生成一个可执行映像文件的时候，将本地符号添加到输出符号信息表中。该选项是默认设置。
25) -nolocals 这个选项指导链接器在生成一个可执行映像文件的时候，不要将本地符号添加到输出符号信息表中。如果想减小输出符号表的大小，可以使用该选项。
26) -callgraph 该选项创建一个HTML格式的静态函数调用图。这个调用图给出了映像文件中所有函数的定义和引用信息。对于每一个函数它列出了：
1. 函数编译时候的处理器状态(ARM状态还是Thumb状态)；
2. 调用func函数的集合；
3. 被func调用的函数的集合；
4. 在映像文件中使用的func寻址的次数。
此外，调用图还标识了下面的函数：
1. 被interworking veneers所调用的函数；
2. 在映像文件外部定义的函数；
3. 允许未被定义的函数(以weak方式的引用)；
静态调用图还提供了堆栈使用信息，它显示出了：
1. 每个函数所使用的堆栈大小；
2. 在全部的函数调用中，所用到的最大堆栈大小。
27) -info topics 这个选项打印出关于指定种类的信息，这里的参数topics是指用逗号间隔的类型标识符列表。类型标识符列表可以是下面所列出的任意一个：
1. sizes 为在映像文件中的每一个输入对象和库成员列出了代码和数据(这里的数据包括，RO数据，RW数据，ZI 数据和Debug 数据)的大小；
2. totals 为输入对象文件和库，列出代码和数据(这里的数据包括，RO数据，RW数据，ZI 数据和Debug 数据) 总的大小；
3. veneers 给出由armlink生成的veneers的详细信息；
4. unused 列出由于使用-remove选项而从映像文件中被删除的所有未使用段。 注意：在信息类型标识符列表之间不能存在空格，比如可以输入 -info sizes,totals 但是不能是 -info sizes, totals(即在逗号和totals之间有空格是不允许的)
28) -map 这个选项创建映像文件的信息图。映像文件信息图包括映像文件中的每个加载域，运行域和输入段的大小和地址，这里的输入段还包括调试信息和链接器产生的输入段。
29) -symbols 这个选项列出了链接的时候使用的每一个局部和全局符号。该符号还包括链接生成的符号。
30) -symdefs file 这个选项创建一个包含来自输出映像文件的全局符号定义的符号定义文件。 默认的，所有的全局符号都写入到符号定义文件中。如果文件file已经存在，链接器将限制生成在已存在的symdefs文件中已列出的符号。 如果文件file没有指明路径信息，链接器将在输出映像文件的路径搜索文件。如果文件没有找到，就会在该目录下面创建文件。 在链接另一个映像文件的时候，可以将符号定义文件作为链接的输入文件。
31) -edit file 这个选项指定一个steering 类型的文件，该文件包含用于修改输出文件中的符号信息表的命令。可以在steering文件中指定具有以下功能的命令： 隐藏全局符号。使用该选项可以在目标文件中隐藏指定的全局符号。 重命名全局符号。使用这个选项可以解决符号命名冲突的现象。
32) -xref 该选项列出了在输入段间的所有交叉引用。
33) -xreffrom object(section) 这个选项列出了从目标文件中的输入段对其他输入段的交叉引用。如果想知道某个指定的输入段中的引用情况，就可以使用该选项。
34) -xrefto object(section) 该选项列出了从其他输入段到目标文件输入段的引用。
35) -errors file 使用该选项会将诊断信息从标准输出流重定向到文件file中。
36) -list file 该选项将-info，-map，-symbols，-xref，-xreffrom和 –xrefto这几个选项的输出重新定向到文件file中。如果文件file没有指定路径信息，就会在输出路径创建该文件，该路径是输出映像文件所在的路径。
37) -verbose 这个选项将有关链接操作的细节打印出来，包括所包括的目标文件和要用到的库。
38) -unmangled 该选项指定链接器在由xref，-xreffrom，-xrefto，和-symbols所生成的诊断信息中显示出unmangled C++符号名。 如果使用了这个选项，链接器将unmangle C++符号名以源码的形式显示出来。这个选项是默认的。
39) -mangled 这个选项指定链接器显示由-xref，-xreffrom，-xrefto，和-symbols所产生的诊断信息中的mangled C++符号名。如果使用了该选项，链接器就不会unmangle C++符号名了。符号名是按照它们在目标符号表中显示的格式显示的。
40) -via file 该选项表示从文件file中读取输入文件名列表和链接器选项。 在armlink命令行可以输入多个-via选项，当然，-via选项也能够不含在一个via文件中。
41) -strict 这个选项告诉链接器报告可能导致错误而不是警告的条件。
42) -unresolved symbol 这个选项将未被解析的符号指向全局符号symbol。Symbol必须是已定义的全局符号，否则，symbol会当作一个未解析的符号，链接将以失败告终。这个选项在自上而下的开发中尤为有用，在这种情况下，通过将无法指向相应函数的引用指向一个伪函数的方法，可以测试一个部分实现的系统。 该选项不会显示任何警告信息。
43) input-file-list 这是一个以空格作为间隔符的目标或库的列表。 有一类特殊的目标文件，即symdef文件，也可以包含在文件列表中，为生成的映像文件提供全局的symbol值。 在输入文件列表中有两种使用库的方法。
1. 指定要从库中提取并作为目标文件添加到映像文件中的特定的成员。
2. 指定某库文件，链接器根据需要从其中提取成员。
armlink按照以下的顺序处理输入文件列表：
1. 无条件的添加目标文件
2. 使用匹配模式从库中选择成员加载到映像文件中去。例如使用下面的命令： armlink main.o mylib(stdio.o) mylib(a*.o). 将会无条件的把mylib库中所有的以字母a开头的目标文件和stdio.o在链接的时候链接到生成的映像文件中去。
3. 添加为解析尚未解析的引用的库到库文件列表。
