米6体育平台手机版

ZHCU876Z July 2001 – October 2023 SM320F28335-EP

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

表 2-20 链接器基本选项

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

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

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

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

表 2-23 诊断消息选项

选项	别名	说明
--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		提供详细的诊断消息，以换行方式显示原始源代码。

表 2-24 链接器输出选项

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

表 2-25 符号管理选项

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

表 2-26 运行时环境选项

选项	别名	说明
--arg_size=size	--args	为 argc/argv 存储器区域保存 size 个字节。
--cinit_compression[=type]		指定应用于 C 自动初始化数据的压缩类型。如果此选项没有指定 type，则默认为 lzss，表示 Lempel-Ziv-Storer-Szymanski 压缩。（仅限 EABI）
--copy_compression[=type]		压缩由链接器复制表复制的数据。如果此选项没有指定 type，则默认为 lzss，表示 Lempel-Ziv-Storer-Szymanski 压缩。（仅限 EABI）
--fill_value=value	-f	为输出段中的空穴设置默认填充值
--ram_model	-cr	在加载时初始化变量。有关详细信息，请参阅节 4.3.5。
--rom_model	-c	在运行时自动初始化变量。有关详细信息，请参阅节 4.3.5。

表 2-27 链接时优化选项

选项⁽¹⁾	别名	说明
--keep_asm		保留任何由 -plink 选项生成的链接后文件 (.pl) 和 .absolute 列表文件 (.abs)。这样用户便可查看链接后优化器所做的任何更改。（需要使用 -plink）
--no_postlink_across_calls	-nf	禁用跨函数的链接后优化。（需要使用 -plink）
--plink_advice_only		如果出于流水线方面的考虑而无法安全地进行更改（例如启用浮动支持或 VCU 支持时），则使用注释功能对汇编代码进行评注。（需要使用 -plink）
--postlink_exclude	-ex	从链接后传递中排除文件。（需要使用 -plink）
--postlink_opt	-plink	链接后优化（仅在 -z 后）。

(1) 有关详细信息，请参阅节 5.6。

表 2-28 其他选项

选项	别名	说明
--compress_dwarf[=off\|on]		积极减少输入目标文件中 DWARF 信息的大小。默认为 off。
--disable_clink	-j	禁止对 COFF 目标文件进行条件链接。（仅限 COFF）
--linker_help	[-]-help	显示有关语法和可用选项的信息。
--preferred_order=function		为函数放置设定优先级。
--unused_section_elimination[=off\|on]		消除可执行模块中不需要的段。默认为 on。（仅限 EABI）
--zero_init=[off\|on]		控制对未初始化的变量的预初始化。默认为 on。如果使用了 --ram_model，则始终为 off。（仅限 EABI）