ZHCUAU3J January 2018 – March 2024
要使用由链接器生成的复制表,用户必须知道复制表的内容。此信息包含在一个运行时支持库头文件 cpy_tbl.h 中。该文件包含由链接器生成的复制表数据结构的 C 源代码表示。
/*****************************************************************************/
/* cpy_tbl.h */
/* */
/* Copyright (c) 2003 Texas Instruments Incorporated http://www.ti.com/ */
/* */
/* Specification of copy table data structures which can be automatically */
/* generated by the linker (using the table() operator in the LCF). */
/*****************************************************************************/
#ifndef _CPY_TBL
#define _CPY_TBL
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/*****************************************************************************/
/* 复制记录数据结构 */
/*****************************************************************************/
typedef struct copy_record
{
uint64_t load_addr;
uint64_t run_addr;
uint32_t size;
} __attribute((__packed__)) COPY_RECORD;
/*****************************************************************************/
/* 复制表数据结构 */
/*****************************************************************************/
typedef struct copy_table
{
uint16_t rec_size;
uint16_t num_recs;
COPY_RECORD recs[1];
} COPY_TABLE;
/*****************************************************************************/
/* 通用复制例程原型。 */
/*****************************************************************************/
extern void copy_in(COPY_TABLE *tp);
#ifdef __cplusplus
} /* extern "C" */
#endif /* __cplusplus */
#endif /* !_CPY_TBL */
对于已标记要进行复制的每个对象组件,链接器会为其创建一个 COPY_RECORD 对象。每个 COPY_RECORD 至少包含对象组件的以下信息:
链接器会将与同一复制表关联的所有 COPY_RECORD 收集到一个 COPY_TABLE 对象中。COPY_TABLE 对象包含给定 COPY_RECORD 的大小、表中 COPY_RECORD 的数量以及表中 COPY_RECORD 的数组。例如,在节 12.8.4.2的 BINIT 示例中,各输出段 .first 和 .extra 将在 BINIT 复制表中拥有各自的 COPY_RECORD 条目。BINIT 复制表将如下所示:
COPY_TABLE __binit__ = { 12, 2,
{ <load address of .first>,
<run address of .first>,
<size of .first> },
{ <load address of .extra>,
<run address of .extra>,
<size of .extra> } };