ZHCUAU3J January   2018  – March 2024

 

  1.   1
  2.   请先阅读
    1.     关于本手册
    2.     标记规则
    3.     相关文档
    4.     米6体育平台手机版_好二三四 (TI) 提供的相关文档
    5.     商标
  3. 软件开发工具简介
    1. 1.1 软件开发工具概述
    2. 1.2 编译器接口
    3. 1.3 ANSI/ISO 标准
    4. 1.4 输出文件
  4. 开始使用代码生成工具
    1. 2.1 Code Composer Studio 项目如何使用编译器
    2. 2.2 从命令行编译
  5. 使用 C/C++ 编译器
    1. 3.1  关于编译器
    2. 3.2  调用 C/C++ 编译器
    3. 3.3  使用选项更改编译器的行为
      1. 3.3.1  链接器选项
      2. 3.3.2  常用选项
      3. 3.3.3  其他有用的选项
      4. 3.3.4  运行时模型选项
      5. 3.3.5  选择目标 CPU 版本(--silicon_version 选项)
      6. 3.3.6  符号调试和分析选项
      7. 3.3.7  指定文件名
      8. 3.3.8  更改编译器解释文件名的方式
      9. 3.3.9  更改编译器处理 C 文件的方式
      10. 3.3.10 更改编译器解释和命名扩展名的方式
      11. 3.3.11 指定目录
    4. 3.4  通过环境变量控制编译器
      1. 3.4.1 设置默认编译器选项 (C7X_C_OPTION)
      2. 3.4.2 命名一个或多个备用目录 (C7X_C_DIR)
    5. 3.5  控制预处理器
      1. 3.5.1  预先定义的宏名称
      2. 3.5.2  #include 文件的搜索路径
        1. 3.5.2.1 在 #include 文件搜索路径(--include_path 选项)中新增目录
      3. 3.5.3  支持#warning 和 #warn 指令
      4. 3.5.4  生成预处理列表文件(--preproc_only 选项)
      5. 3.5.5  预处理后继续编译(--preproc_with_compile 选项)
      6. 3.5.6  生成带有注释的预处理列表文件(--preproc_with_comment 选项)
      7. 3.5.7  生成带有行控制详细信息的预处理列表(--preproc_with_line 选项)
      8. 3.5.8  为 Make 实用程序生成预处理输出(--preproc_dependency 选项)
      9. 3.5.9  生成包含#include在内的文件列表(--preproc_includes 选项)
      10. 3.5.10 在文件中生成宏列表(--preproc_macros 选项)
    6. 3.6  将参数传递给 main()
    7. 3.7  了解诊断消息
      1. 3.7.1 控制诊断消息
      2. 3.7.2 如何使用诊断抑制选项
    8. 3.8  其他消息
    9. 3.9  生成原始列表文件(--gen_preprocessor_listing 选项)
    10. 3.10 使用内联函数扩展
      1. 3.10.1 内联内在函数运算符
      2. 3.10.2 内联限制
      3. 3.10.3 不受保护定义控制的内联
        1. 3.10.3.1 使用内联关键字
      4. 3.10.4 保护内联和 _INLINE 预处理器符号
        1. 3.10.4.1 头文件 string.h
        2. 3.10.4.2 库定义文件
    11. 3.11 使用交叉列出功能
    12. 3.12 关于应用程序二进制接口
    13. 3.13 启用入口挂钩和出口挂钩函数
  6. 优化您的代码
    1. 4.1  调用优化
    2. 4.2  控制代码大小与速度
    3. 4.3  执行文件级优化(--opt_level=3 选项)
      1. 4.3.1 创建优化信息文件(--gen_opt_info 选项)
    4. 4.4  程序级优化(--program_level_compile 和 --opt_level=3 选项)
      1. 4.4.1 控制程序级优化(--call_assumptions 选项)
    5. 4.5  自动内联扩展(--auto_inline 选项)
    6. 4.6  链接时优化(--opt_level=4 选项)
      1. 4.6.1 选项处理
      2. 4.6.2 不兼容的类型
    7. 4.7  优化软件流水线
      1. 4.7.1 关闭软件流水线(--disable_software_pipeline 选项)
      2. 4.7.2 软件流水线信息
        1. 4.7.2.1 软件流水线信息
        2. 4.7.2.2 软件流水线信息术语
        3. 4.7.2.3 不符合软件流水线的循环的消息循环
        4. 4.7.2.4 流水线故障消息
        5. 4.7.2.5 由 --debug_software_pipeline 选项生成寄存器使用表
      3. 4.7.3 折叠逻辑程序和收尾程序以改善性能和代码大小
        1. 4.7.3.1 推测执行
    8. 4.8  冗余循环
    9. 4.9  指示是否使用了某些别名技术
      1. 4.9.1 采用某些别名时使用 --aliased_variables 选项
    10. 4.10 防止重新排列关联浮点运算
    11. 4.11 使用性能建议优化代码
      1. 4.11.1 建议 #35000:使用 restrict 提高循环性能
    12. 4.12 通过优化使用交叉列出特性
    13. 4.13 调试和分析优化代码
      1. 4.13.1 分析优化的代码
    14. 4.14 正在执行什么类型的优化?
      1. 4.14.1  基于成本的寄存器分配
      2. 4.14.2  别名消歧
      3. 4.14.3  分支优化和控制流简化
      4. 4.14.4  数据流优化
      5. 4.14.5  表达式简化
      6. 4.14.6  函数的内联扩展
      7. 4.14.7  函数符号别名
      8. 4.14.8  归纳变量和强度降低
      9. 4.14.9  循环不变量代码运动
      10. 4.14.10 循环旋转
      11. 4.14.11 循环折叠和循环合并
      12. 4.14.12 展开和阻塞
      13. 4.14.13 向量化 (SIMD)
      14. 4.14.14 指令排程
      15. 4.14.15 寄存器变量
      16. 4.14.16 寄存器跟踪/定位
      17. 4.14.17 软件流水线
    15. 4.15 流引擎和流地址生成器
      1. 4.15.1 流引擎概述
      2. 4.15.2 流引擎和流地址生成器的工作原理
      3. 4.15.3 流地址生成器概述
      4. 4.15.4 使用流引擎和流地址生成器的优点
      5. 4.15.5 用于流引擎和流地址生成器的接口
      6. 4.15.6 参数模板配置
      7. 4.15.7 使用流引擎
        1. 4.15.7.1 使用流引擎时进行硬编码的内在函数操作数
      8. 4.15.8 使用流地址生成器
        1. 4.15.8.1 流地址生成器的矢量谓词
        2. 4.15.8.2 断言与非断言的流地址存储和加载
      9. 4.15.9 自动使用流引擎和流地址生成器(--auto_stream 选项)
        1. 4.15.9.1 自动使用 SE 和 SA 的正确性
        2. 4.15.9.2 对 SE 和 SA 的自动使用进行调优
    16. 4.16 嵌套循环控制器 (NLC)
      1. 4.16.1 可能限制使用 NLC 的障碍
  7. C/C++ 语言实现
    1. 5.1  C7000 C 的特征
      1. 5.1.1 实现定义的行为
    2. 5.2  C7000 C++ 的特性
    3. 5.3  数据类型
      1. 5.3.1 枚举类型大小
      2. 5.3.2 矢量数据类型
    4. 5.4  文件编码和字符集
    5. 5.5  关键字
      1. 5.5.1 complex 关键字
      2. 5.5.2 const 关键字
      3. 5.5.3 __cregister 关键字
        1. 5.5.3.1 定义和使用控制寄存器
        2. 5.5.3.2 在进行浮点运算后评估标志状态寄存器 (FSR) 中的标志
      4. 5.5.4 restrict 关键字
      5. 5.5.5 volatile 关键字
    6. 5.6  C++ 异常处理
    7. 5.7  寄存器变量和参数
    8. 5.8  pragma 指令
      1. 5.8.1  CALLS Pragma
      2. 5.8.2  CLINK Pragma
      3. 5.8.3  COALESCE_LOOP Pragma
      4. 5.8.4  CODE_ALIGN Pragma
      5. 5.8.5  CODE_SECTION Pragma
      6. 5.8.6  DATA_ALIGN Pragma
      7. 5.8.7  DATA_MEM_BANK Pragma
        1. 5.8.7.1 使用 DATA_MEM_BANK Pragma
      8. 5.8.8  DATA_SECTION Pragma
        1. 5.8.8.1 使用 DATA_SECTION Pragma C 源文件
        2. 5.8.8.2 使用 DATA_SECTION Pragma C++ 源文件
      9. 5.8.9  诊断消息 Pragma
      10. 5.8.10 FORCEINLINE Pragma
      11. 5.8.11 FORCEINLINE_RECURSIVE Pragma
      12. 5.8.12 FUNC_ALWAYS_INLINE Pragma
      13. 5.8.13 FUNC_CANNOT_INLINE Pragma
      14. 5.8.14 FUNC_EXT_CALLED Pragma
      15. 5.8.15 FUNC_IS_PURE Pragma
      16. 5.8.16 FUNC_IS_SYSTEM Pragma
      17. 5.8.17 FUNC_NEVER_RETURNS Pragma
      18. 5.8.18 FUNC_NO_GLOBAL_ASG Pragma
      19. 5.8.19 FUNC_NO_IND_ASG Pragma
      20. 5.8.20 FUNCTION_OPTIONS Pragma
      21. 5.8.21 INTERRUPT Pragma
      22. 5.8.22 LOCATION Pragma
      23. 5.8.23 MUST_ITERATE Pragma
        1. 5.8.23.1 MUST_ITERATE Pragma 语法
        2. 5.8.23.2 使用 MUST_ITERATE 扩展编译器对循环的了解
      24. 5.8.24 NOINIT 和 PERSISTENT Pragma
      25. 5.8.25 NOINLINE Pragma
      26. 5.8.26 NO_COALESCE_LOOP Pragma
      27. 5.8.27 NO_HOOKS Pragma
      28. 5.8.28 once Pragma
      29. 5.8.29 pack Pragma
      30. 5.8.30 PROB_ITERATE Pragma
      31. 5.8.31 RETAIN Pragma
      32. 5.8.32 SET_CODE_SECTION 和 SET_DATA_SECTION Pragma
      33. 5.8.33 STRUCT_ALIGN Pragma
      34. 5.8.34 UNROLL Pragma
      35. 5.8.35 WEAK Pragma
    9. 5.9  _Pragma 运算符
    10. 5.10 应用程序二进制接口
    11. 5.11 目标文件符号命名规则(链接名)
    12. 5.12 更改 ANSI/ISO C/C++ 语言模式
      1. 5.12.1 C99 支持 (--c99)
      2. 5.12.2 C11 支持 (--c11)
      3. 5.12.3 严格 ANSI 模式和宽松 ANSI 模式(--strict_ansi 和 --relaxed_ansi)
    13. 5.13 GNU 和 Clang 语言扩展
      1. 5.13.1 扩展
      2. 5.13.2 函数属性
      3. 5.13.3 For 循环属性
      4. 5.13.4 变量属性
      5. 5.13.5 类型属性
      6. 5.13.6 内置函数
    14. 5.14 向量数据类型的运算和函数
      1. 5.14.1 向量字面量和串联
      2. 5.14.2 向量的一元和二进制运算符
      3. 5.14.3 向量的三态运算符 (?:)
      4. 5.14.4 矢量的混合运算符
      5. 5.14.5 不受支持的矢量比较运算符
      6. 5.14.6 向量的转换函数
      7. 5.14.7 矢量的重新解释函数
      8. 5.14.8 矢量谓词类型
        1. 5.14.8.1 构造向量谓词类型
        2. 5.14.8.2 使用向量谓词类型
        3. 5.14.8.3 布尔向量类型
    15. 5.15 C7000 内在函数
      1. 5.15.1 高级别过载内在函数
      2. 5.15.2 为特殊加载和存储指令定义的内在函数
      3. 5.15.3 直接映射的内在函数
      4. 5.15.4 查找表和直方图内在函数
      5. 5.15.5 矩阵乘法加速器 (MMA) 内在函数
      6. 5.15.6 传统内在函数
    16. 5.16 C7000 可扩展矢量编程
  8. 运行时环境
    1. 6.1 存储器
      1. 6.1.1
      2. 6.1.2 C/C++ 系统堆栈
      3. 6.1.3 动态存储器分配
    2. 6.2 对象表示
      1. 6.2.1 数据类型存储
        1. 6.2.1.1 char 和 short 数据类型(有符号和无符号)
        2. 6.2.1.2 enum、int 和 long 数据类型(有符号和无符号)
        3. 6.2.1.3 长数据类型(有符号和无符号)
        4. 6.2.1.4 浮点数据类型
        5. 6.2.1.5 double 和 long double 数据类型
        6. 6.2.1.6 指向数据成员类型的指针
        7. 6.2.1.7 指向成员函数类型的指针
        8. 6.2.1.8 结构和数组
      2. 6.2.2 位字段
      3. 6.2.3 字符串常量
    3. 6.3 寄存器惯例
    4. 6.4 函数结构和调用惯例
      1. 6.4.1 函数如何进行调用
      2. 6.4.2 被调用函数如何响应
      3. 6.4.3 访问参数和局部变量
    5. 6.5 访问 C 和 C++ 中的链接器符号
    6. 6.6 运行时支持算术例程
    7. 6.7 系统初始化
      1. 6.7.1 用于系统预初始化的引导挂钩函数
      2. 6.7.2 变量的自动初始化
        1. 6.7.2.1 零初始化变量
        2. 6.7.2.2 的直接初始化
        3. 6.7.2.3 运行时变量自动初始化
        4. 6.7.2.4 的自动初始化表
          1. 6.7.2.4.1 数据格式遵循的长度
          2. 6.7.2.4.2 零初始化格式
          3. 6.7.2.4.3 行程编码 (RLE) 格式
          4. 6.7.2.4.4 Lempel-Ziv-Storer-Szymanski 压缩 (LZSS) 格式
        5. 6.7.2.5 在加载时初始化变量
        6. 6.7.2.6 全局构造函数
  9. 使用运行时支持函数并构建库
    1. 7.1 C 和 C++ 运行时支持库
      1. 7.1.1 将代码与对象库链接
      2. 7.1.2 头文件
      3. 7.1.3 修改库函数
      4. 7.1.4 支持字符串处理
      5. 7.1.5 极少支持国际化
      6. 7.1.6 时间和时钟函数支持
      7. 7.1.7 允许打开的文件数量
      8. 7.1.8 库命名规则
    2. 7.2 C I/O 函数
      1. 7.2.1 高级别 I/O 函数
        1. 7.2.1.1 格式化和格式转换缓冲区
      2. 7.2.2 低级 I/O 实现概述
        1.       open
        2.       close
        3.       read
        4.       write
        5.       lseek
        6.       unlink
        7.       rename
      3. 7.2.3 器件驱动程序级别 I/O 函数
        1.       DEV_open
        2.       DEV_close
        3.       DEV_read
        4.       DEV_write
        5.       DEV_lseek
        6.       DEV_unlink
        7.       DEV_rename
      4. 7.2.4 为 C I/O 添加用户定义的器件驱动程序
        1. 7.2.4.1 将默认流映射到器件
      5. 7.2.5 器件前缀
        1.       add_device
        2.       291
        3. 7.2.5.1 为 C I/O 器件编程
    3. 7.3 处理可重入性(_register_lock() 和 _register_unlock() 函数)
    4. 7.4 库构建流程
      1. 7.4.1 所需的非米6体育平台手机版_好二三四 (TI) 软件
      2. 7.4.2 使用库构建流程
        1. 7.4.2.1 通过链接器自动重建标准库
        2. 7.4.2.2 手动调用 mklib
          1. 7.4.2.2.1 构建标准库
          2. 7.4.2.2.2 共享或只读库目录
          3. 7.4.2.2.3 使用自定义选项构建库
          4. 7.4.2.2.4 mklib 程序选项摘要
      3. 7.4.3 扩展 mklib
        1. 7.4.3.1 底层机制
        2. 7.4.3.2 来自其他供应商的库
  10. 目标模块简介
    1. 8.1 目标文件格式规范
    2. 8.2 可执行目标文件
    3. 8.3 段简介
      1. 8.3.1 特殊段名
    4. 8.4 链接器如何处理段
      1. 8.4.1 合并输入段
      2. 8.4.2 放置段
    5. 8.5 符号
      1. 8.5.1 局部符号
      2. 8.5.2 弱符号
    6. 8.6 加载程序
  11. 程序加载和运行
    1. 9.1 负载
    2. 9.2 入口点
    3. 9.3 运行时初始化
      1. 9.3.1 _c_int00 函数
      2. 9.3.2 RAM 模型与 ROM 模型
        1. 9.3.2.1 在运行时自动初始化变量 (--rom_model)
        2. 9.3.2.2 在加载时初始化变量 (--ram_model)
        3. 9.3.2.3 --rom_model 和 --ram_model 链接器选项
      3. 9.3.3 关于链接器生成的复制表
        1. 9.3.3.1 BINIT
        2. 9.3.3.2 CINIT
    4. 9.4 main 的参数
    5. 9.5 运行时重定位
    6. 9.6 其他信息
  12. 10归档器说明
    1. 10.1 归档器概述
    2. 10.2 归档器在软件开发流程中的作用
    3. 10.3 调用归档器
    4. 10.4 归档器示例
    5. 10.5 库信息归档器说明
      1. 10.5.1 调用库信息归档器
      2. 10.5.2 库信息归档器示例
      3. 10.5.3 列出索引库的内容
      4. 10.5.4 要求
  13. 11链接 C/C++ 代码
    1. 11.1 通过编译器调用链接器(-z 选项)
      1. 11.1.1 单独调用链接器
      2. 11.1.2 调用链接器作为编译步骤的一部分
      3. 11.1.3 禁用链接器(--compile_only 编译器选项)
    2. 11.2 链接器代码优化
      1. 11.2.1 条件链接
      2. 11.2.2 生成函数子段(--gen_func_subsections 编译器选项)
      3. 11.2.3 生成聚合数据子段(--gen_data_subsections 编译器选项)
    3. 11.3 控制链接过程
      1. 11.3.1 包含运行时支持库
        1. 11.3.1.1 自动选择运行时支持库
          1. 11.3.1.1.1 使用 --issue_remarks 选项
        2. 11.3.1.2 手动选择运行时支持库
        3. 11.3.1.3 用于搜索符号的库顺序
      2. 11.3.2 运行时初始化
      3. 11.3.3 全局对象构造函数
      4. 11.3.4 指定全局变量初始化类型
      5. 11.3.5 指定在内存中分配段的位置
      6. 11.3.6 链接器命令文件示例
  14. 12链接器说明
    1. 12.1  链接器概述
    2. 12.2  链接器在软件开发流程中的作用
    3. 12.3  调用链接器
    4. 12.4  链接器选项
      1. 12.4.1  文件、段和符号模式中的通配符
      2. 12.4.2  通过链接器选项指定 C/C++ 符号
      3. 12.4.3  重定位功能(--absolute_exe 和 --relocatable 选项)
        1. 12.4.3.1 生成绝对输出模块(--absolute_exe 选项)
        2. 12.4.3.2 生成可重定位输出模块(--relocatable 选项)
      4. 12.4.4  分配存储器供加载器使用以传递参数(--arg_size 选项)
      5. 12.4.5  压缩(--cinit_compression 和 --copy_compression 选项)
      6. 12.4.6  压缩 DWARF 信息(--compress_dwarf 选项)
      7. 12.4.7  控制链接器诊断
      8. 12.4.8  自动选择库(--disable_auto_rts 选项)
      9. 12.4.9  不要删除未使用的段(--unused_section_elimination 选项)
      10. 12.4.10 链接器命令文件预处理(--disable_pp、--define 和 --undefine 选项)
      11. 12.4.11 定义入口点(--entry_point 选项)
      12. 12.4.12 设置默认填充值(--fill_value 选项)
      13. 12.4.13 定义堆大小(--heap_size 选项)
      14. 12.4.14 隐藏符号
      15. 12.4.15 改变库搜索算法(--library、--search_path 和 C7X_C_DIR)
        1. 12.4.15.1 指定备用库目录(--search_path 选项)
        2. 12.4.15.2 指定备用库目录(C7X_C_DIR 环境变量)
        3. 12.4.15.3 详尽读取和搜索库(--reread_libs 和 --priority 选项)
      16. 12.4.16 更改符号局部化
        1. 12.4.16.1 将所有全局符号设为静态(--make_static 选项)
      17. 12.4.17 创建映射文件(--map_file 选项)
      18. 12.4.18 管理映射文件内容(--mapfile_contents 选项)
      19. 12.4.19 禁用名称还原 (--no_demangle)
      20. 12.4.20 合并符号调试信息
      21. 12.4.21 去除符号信息(--no_symtable 选项)
      22. 12.4.22 指定输出模块(--output_file 选项)
      23. 12.4.23 确定函数放置优先级(--preferred_order 选项)
      24. 12.4.24 C 语言选项(--ram_model 和 --rom_model 选项)
      25. 12.4.25 保留丢弃的段(--retain 选项)
      26. 12.4.26 扫描所有库中的重复符号定义(--scan_libraries)
      27. 12.4.27 定义栈大小(--stack_size 选项)
      28. 12.4.28 符号映射(--symbol_map 选项)
      29. 12.4.29 生成 Far 调用 Trampoline(--trampolines 选项)
        1. 12.4.29.1 使用 Trampoline 的优缺点
        2. 12.4.29.2 尽量减少所需的 Trampoline 数量(--minimize_trampolines 选项)
        3. 12.4.29.3 将 Trampoline 从加载空间传送到运行空间
      30. 12.4.30 引入未解析的符号(--undef_sym 选项)
      31. 12.4.31 创建未定义的输出段时显示一条消息 (--warn_sections)
      32. 12.4.32 生成 XML 链接信息文件(--xml_link_info 选项)
      33. 12.4.33 零初始化(--zero_init 选项)
    5. 12.5  链接器命令文件
      1. 12.5.1  链接器命令文件中的保留名称
      2. 12.5.2  链接器命令文件中的常量
      3. 12.5.3  从链接器命令文件访问文件和库
      4. 12.5.4  MEMORY 指令
        1. 12.5.4.1 默认存储器型号
        2. 12.5.4.2 MEMORY 指令语法
        3. 12.5.4.3 表达式和地址运算符
      5. 12.5.5  SECTIONS 指令
        1. 12.5.5.1 SECTIONS 指令语法
        2. 12.5.5.2 段分配和放置
          1. 12.5.5.2.1 绑定
          2. 12.5.5.2.2 指定的存储器
          3. 12.5.5.2.3 使用 HIGH 位置说明符来控制放置
            1. 12.5.5.2.3.1 使用 HIGH 说明符进行链接器放置
            2.         425
            3. 12.5.5.2.3.2 在没有 HIGH 说明符的情况下进行链接器放置
          4. 12.5.5.2.4 对齐和分块
          5. 12.5.5.2.5 对齐和填充
        3. 12.5.5.3 指定输入段
          1. 12.5.5.3.1 指定段内容的最常用方法
          2.        431
        4. 12.5.5.4 使用多级子段
        5. 12.5.5.5 指定库或存档成员作为输出段的输入
          1. 12.5.5.5.1 将成员存档至输出段
          2.        435
        6. 12.5.5.6 使用多个存储器范围进行分配
        7. 12.5.5.7 在非连续存储器范围之间自动拆分输出段
      6. 12.5.6  在不同的加载和运行地址放置段
        1. 12.5.6.1 指定加载和运行地址
        2.       440
      7. 12.5.7  使用 GROUP 和 UNION 语句
        1. 12.5.7.1 将输出段一同进行分组
        2. 12.5.7.2 利用 UNION 语句叠加段
        3. 12.5.7.3 将存储器用于多种用途
        4. 12.5.7.4 嵌套 UNION 和 GROUP
        5. 12.5.7.5 检查分配器的一致性
        6. 12.5.7.6 为 UNION 和 GROUP 命名
      8. 12.5.8  特殊段类型(DSECT、COPY、NOLOAD 和 NOINIT)
      9. 12.5.9  在链接时分配符号
        1. 12.5.9.1 赋值语句的语法
        2. 12.5.9.2 向符号分配 SPC
        3. 12.5.9.3 赋值表达式
        4. 12.5.9.4 由链接器自动定义的符号
        5. 12.5.9.5 向符号分配一个段的确切开始值、结束值和大小值
        6. 12.5.9.6 为什么点运算符有时不起作用
        7. 12.5.9.7 地址和维度运算符
          1. 12.5.9.7.1 输入项
          2. 12.5.9.7.2 输出段
          3. 12.5.9.7.3 GROUP
          4. 12.5.9.7.4 UNION
        8. 12.5.9.8 LAST 运算符
      10. 12.5.10 创建和填充孔洞
        1. 12.5.10.1 已初始化和未初始化的段
        2. 12.5.10.2 创建空洞
        3. 12.5.10.3 填充孔洞
        4. 12.5.10.4 对未初始化的段进行显式初始化
    6. 12.6  链接器符号
      1. 12.6.1 链接器定义的函数和数组
      2. 12.6.2 链接器定义的整数值
      3. 12.6.3 链接器定义的地址
      4. 12.6.4 有关 _symval 运算符的更多信息
      5. 12.6.5 使用 _symval、PC 相对寻址和远数据
      6. 12.6.6 弱符号
        1. 12.6.6.1 弱符号引用
        2. 12.6.6.2 弱符号定义
      7. 12.6.7 利用对象库解析符号
    7. 12.7  默认放置算法
      1. 12.7.1 分配算法如何创建输出段
      2. 12.7.2 减少存储器碎片
    8. 12.8  使用由链接器生成的复制表
      1. 12.8.1 使用复制表进行引导加载
      2. 12.8.2 在复制表中使用内置链接运算符
      3. 12.8.3 重叠管理示例
      4. 12.8.4 使用 table() 运算符生成复制表
        1. 12.8.4.1 table() 操作符
        2. 12.8.4.2 启动时复制表
        3. 12.8.4.3 使用 table() 操作符管理目标组件
        4. 12.8.4.4 由链接器生成的复制表段和符号
        5. 12.8.4.5 拆分对象组件和重叠管理
      5. 12.8.5 压缩
        1. 12.8.5.1 压缩的复制表格式
        2. 12.8.5.2 目标文件中的压缩段表示
        3. 12.8.5.3 压缩的数据布局
        4. 12.8.5.4 运行时解压缩
        5. 12.8.5.5 压缩算法
        6.       496
      6. 12.8.6 复制表内容
      7. 12.8.7 通用复制例程
    9. 12.9  部分(增量)链接
    10. 12.10 链接 C/C++ 代码
      1. 12.10.1 运行时初始化
      2. 12.10.2 对象库和运行时支持
      3. 12.10.3 设置堆栈段的大小
      4. 12.10.4 在运行时初始化和自动初始化变量
      5. 12.10.5 CMMU 配置产生的约束
    11. 12.11 链接器示例
  15. 13目标文件实用程序
    1. 13.1 调用目标文件显示实用程序
    2. 13.2 调用反汇编器
    3. 13.3 调用名称实用程序
    4. 13.4 调用符号去除实用程序
  16. 14C++ 名称还原器
    1. 14.1 调用 C++ 名称还原器
    2. 14.2 C++ 名称还原器的示例用法
  17.   A XML 链接信息文件说明
    1.     A.1 XML 信息文件元素类型
    2.     A.2 文档元素
      1.      A.2.1 标头元素
      2.      A.2.2 输入文件列表
      3.      A.2.3 对象组件列表
      4.      A.2.4 逻辑组列表
      5.      A.2.5 放置映射
      6.      A.2.6 Far Call Trampoline 列表
      7.      A.2.7 符号表
  18.   B 不受支持的工具和功能
    1.     B.1 不受支持的工具和功能列表
  19.   C 术语表
    1.     528
  20.   D 修订历史记录

常用选项

以下是对可能会经常使用的选项的详细说明:

--c_src_interlist 调用交叉列出功能,该功能使原始 C/C++ 源代码与编译器生成的汇编语言交织在一起。交叉列出的 C 语句可能看起来是乱序的。可通过组合 --optimizer_interlist 和 --c_src_interlist 选项,将 交叉列出功能与优化器结合使用。请参阅节 4.12。--c_src_interlist 选项可能会对性能和/或代码大小产生负面影响。
--cmd_file=filename 将文件的内容附加到选项集。使用此选项可避免操作系统对命令行长度或 C 样式注释的限制。使用# 或;在命令文件中的一行的开头包含注释。可以用 /* 和 */ 括起来添加注释。如需指定选项,请用引号将连字符括起来。例如,"--"quiet。可以多次使用 --cmd_file 选项来指定多个文件。例如,以下代码表示 file3 应编译为源文件,而 file1 和 file2 是 --cmd_file 文件:
cl7x --cmd_file=file1 --cmd_file=file2 file3
--compile_only 抑制链接器并覆盖用于指定链接的 --run_linker 选项。--compile_only 选项的缩写形式为 -c。在 C7X_C_OPTION 环境变量中指定了 --run_linker 但又不希望链接时,请使用此选项。请参阅节 11.1.3
--define=name[=def] 预定义预处理器的常量 name。这相当于在每个 C 源文件的顶部插入 #define name def。如果省略可选的 [=def],则 name 设置为 1。此选项的缩写形式是 -D。

如需定义带引号的字符串并保留引号,请执行以下操作之一:

  • 对于 Windows,请使用 --define=name="\"string def\""。例如,--define=car="\"sedan\""
  • 对于 UNIX,请使用 --define=name='"string def"'。例如,--define=car='"sedan"'
  • 对于 CCS,请在文件中输入定义并使用 --cmd_file 选项包含该文件。

--help 显示调用编译器的语法并列出可用选项。如果 --help 选项后跟另一个选项或词组,则显示有关该选项或词组的详细信息。例如,要查看有关调试选项的信息,请使用 --help debug。
--include_path=directory directory 添加到编译器搜索 #include 文件的目录列表中。--include_path 选项的缩写形式为 -I。可以多次使用此选项来定义几个目录;请确保用空格分隔 --include_path 选项。如果未指定目录名称,预处理器将忽略 --include_path 选项。请参阅节 3.5.2.1
--keep_asm 保留编译器或汇编优化器的汇编语言输出。通常,编译器在汇编完成后会删除输出的汇编语言文件。此选项的缩写形式是 -k。
--quiet 抑制来自所有工具的横幅和进度信息。仅输出源文件名和错误消息。--quiet 选项的缩写形式为 -q。
--run_linker 在指定的目标文件上运行链接器。--run_linker 选项及其参数跟随命令行上的所有其他选项。--run_linker 后面的所有参数都传递给链接器。--run_linker 选项的缩写形式为 -z。请参阅节 11.1
--skip_assembler 仅编译。指定的源文件已被编译但不会被汇编或链接。此选项的缩写形式为 -n。此选项将覆盖 --run_linker。输出为编译器的汇编语言输出。
--src_interlist 调用 交叉列出功能,该功能使优化器注释 C/C++ 源代码与汇编源代码交织在一起。如果调用优化器(--opt_level=n 选项),优化器注释将与编译器的汇编语言输出交织在一起,这可能会明显地重新排列代码。如果未调用优化器,C/C++ 源代码语句将与编译器的汇编语言输出交织在一起,这样就可以检查为每条 C/C++ 语句生成的代码。--src_interlist 选项意味着 --keep_asm 选项。--src_interlist 选项的缩写形式为 -s。
--tool_version 打印编译器中每个工具的版本号。未发生编译。
--undefine=name 不对预定义的常量 name 进行定义。此选项覆盖指定常量的任何 --define 选项。--undefine 选项的缩写形式为 -U。
--verbose 编译时显示进度信息和工具集版本。重置 --quiet 选项。