ZHCUAV8W 用户指南 | 德州仪器 TI.com.cn

ZHCUAV8W january 1998 – march 2023 66AK2E05 , 66AK2H06 , 66AK2H12 , 66AK2H14 , AM1705 , AM1707 , AM1802 , AM1806 , AM1808 , AM1810 , AM5K2E04 , C346BA02 , C348A01 , CS241C01-Q1 , CS241C05-Q1 , CS246C01-Q1 , CS348C02-Q1 , OMAP-L132 , OMAP-L137 , OMAP-L138 , S470AV336LYSQRB , TMS470R1A288 , TMS470R1A384 , TMS470R1A64 , TMS470R1B1M , TMS470R1B512 , TMS470R1B768

2.3.1 链接器选项

以下各表列出了链接器选项。有关这些选项的详细信息，请参阅本文档的Chapter121以及《ARM 汇编语言工具用户指南》。

表 2-22 链接器基本选项

选项	别名	说明
--run_linker	-z	启用链接。
--output_file=file	-o	为可执行输出文件命名。默认文件名为 .out file。
--map_file=file	-m	生成输入和输出段（包括空位）的映射或列表，并将列表放置在 file 中。
--stack_size=size	[-]-stack	将 C 系统栈大小设为 size 字节，并定义全局符号来指定栈大小。默认值 = 2K 字节。
--heap_size=size	[-]-heap	将堆大小（对于 C 中的动态存储器分配）设为 size字节，并定义全局符号来指定栈大小。默认值 = 2K 字节。

表 2-23 文件搜索路径选项

选项	别名	说明
--library=file	-l	将存档库或链接命令 file 命名为链接器输入。
--disable_auto_rts		禁止自动选择运行时支持库。请参阅节 4.3.1.1。
--priority	-priority	满足由包含该符号定义的第一个库实现的未解析引用。
--reread_libs	-x	强制重新读取库，以解析反向引用。
--search_path=pathname	`-I`	在查找默认位置之前，更改库搜索算法以查找用 pathname 命名的目录。此选项必须出现在 --library 选项之前。

表 2-24 命令文件预处理选项

选项	别名	说明
--define=name=value		将 name 预定义为预处理器宏命令。
--undefine=name		删除预处理器宏命令 name。
--disable_pp		禁用命令文件预处理。

表 2-25 诊断消息选项

选项	别名	说明
--diag_error=num		将由 num 标识的诊断分类为错误。
--diag_remark=num		将由 num 标识的诊断分类为备注。
--diag_suppress=num		抑制由 num 标识的诊断。
--diag_warning=num		将由 num 标识的诊断分类为警告。
--display_error_number		显示诊断的标识符及其文本。
--emit_references:file[=file]		发出包含段信息的文件。这些信息包括段大小、定义的符号和对符号的引用。
--emit_warnings_as_errors	-pdew	将警告视为错误。
--issue_remarks		发出备注（非严重警告）。
--no_demangle		禁止解码诊断消息中的符号名称。
--no_warnings		抑制诊断警告（仍会发出错误）。
--set_error_limit=count		将错误限制设置为 count。在达到此错误数量后，链接器将放弃链接。（默认为 100。）
--verbose_diagnostics		提供详细的诊断消息，以换行方式显示原始源代码。
--warn_sections	-w	创建未定义的输出段时显示一条消息。

表 2-26 链接器输出选项

选项	别名	说明
--absolute_exe	-a	生成绝对可执行目标文件。这是默认设置；如果 --absolute_exe 和 --relocatable 均未指定，链接器的行为就像指定了 --absolute_exe 一样。
--ecc={ on \| off }		启用由链接器生成的错误校正码 (ECC)。默认关闭。
--ecc:data_error		将指定的错误注入到输出文件中进行测试。
--ecc:ecc_error		将指定的错误注入到错误校正码 (ECC) 中进行测试。
--generate_dead_funcs_list		将链接器删除的死函数列表写入文件 fname。
--mapfile_contents=attribute		控制映射文件中包含的信息。
--relocatable	-r	生成不可执行的、可重定位输出目标文件。
--run_abs	-abs	生成绝对列表文件。
--xml_link_info=file		生成结构良好的 XML file，其中包含有关链接结果的详细信息。

表 2-27 符号管理选项

选项	别名	说明
--entry_point=symbol	-e	定义一个全局符号，用于指定可执行目标文件的主要入口点。
--globalize=pattern		将与 pattern 匹配的符号的符号链接更改为全局型。
--hide=pattern		隐藏与指定 pattern 匹配的符号。
--localize=pattern		将与指定 pattern 匹配的符号设为局部型。
--make_global=symbol	-g	将 symbol 设为全局型（覆盖 -h）。
--make_static	-h	将所有全局符号设为静态型。
--no_symtable	-s	从可执行目标文件中去除符号表信息和行号条目。
--retain		保存原本会被丢弃的段列表。
--scan_libraries	-scanlibs	扫描所有库中的重复符号定义。
--symbol_map=refname=defname		指定符号映射；对 refname 符号的引用被替换为对 defname 符号的引用。与 --opt_level=4 一同使用时，支持 --symbol_map 选项。
--undef_sym=symbol	-u	将 symbol 作为未解析符号添加到符号表中。
--unhide=pattern		排除与指定 pattern 匹配的符号，使其不被隐藏。

表 2-28 运行时环境选项

选项	别名	说明
--arg_size=size	--args	为 argc/argv 存储器区域保存 size 个字节。
--cinit_hold_wdt={on\|off}		RTS 自动初始化例程中的链接，该例程在 cinit 自动初始化期间保持（开启）或不保持（关闭）看门狗计时器。请参阅节 4.3.3。
-be32		强制链接器生成 BE-32 目标代码。
-be8		强制链接器生成 BE-8 目标代码。
--cinit_compression[=type]		指定应用于 C 自动初始化数据的压缩类型。如果此选项没有指定 type，则默认为 lzss，表示 Lempel-Ziv-Storer-Szymanski 压缩。
--copy_compression[=type]		压缩由链接器复制表复制的数据。如果此选项没有指定 type，则默认为 lzss，表示 Lempel-Ziv-Storer-Szymanski 压缩。
--fill_value=value	-f	为输出段中的空穴设置默认填充值
--ram_model	-cr	在加载时初始化变量。有关详细信息，请参阅节 4.3.5。
--rom_model	-c	在运行时自动初始化变量。有关详细信息，请参阅节 4.3.5。
--trampolines[=off\|on]		生成 far call trampolines（参数是可选的，默认为“on”）。

表 2-29 其他选项

选项	别名	说明
--compress_dwarf[=off\|on]		积极减少输入目标文件中 DWARF 信息的大小。默认为 on。
--linker_help	[-]-help	显示有关语法和可用选项的信息。
--minimize_trampolines		放置段以最大限度地减少所需的 far trampolines 数量。
--preferred_order=function		为函数放置设定优先级。
--trampoline_min_spacing		当 trampoline 预留的间隔比指定的限值更近时，尝试使它们相邻。
--unused_section_elimination[=off\|on]		消除可执行模块中不需要的段。默认为 on。
--zero_init=[off\|on]		控制对未初始化的变量的预初始化。默认为 on。如果使用了 --ram_model，则始终为 off。