ARM コンパイラツールチェーン リンカの使用 - ARM Information Center

®
ARM
コンパイラツールチェーン
バージ ョ ン 5.0
リ ン カの 使 用
Copyright © 2010-2011 ARM. All rights reserved.
ARM DUI 0474FJ (ID 111311)

ARM コンパイラツールチェーン
リ ン カの 使 用
Copyright © 2010-2011 ARM. All rights reserved.
リリース 情 報
本 書 には 以 下 の 変 更 が 加 え ら れています。
変 更 履 歴
日 付 発 行 機 密 保 持 ステー タ ス 変 更 点
2010 年 5 月 28 日 A 非 機 密 扱 い ARM コンパイラツールチェーン v4.1 リリース
2010 年 9 月 30 日 B 非 機 密 扱 い ARM コンパイラツールチェーン v4.1 のアップ
デー ト 1
2011 年 1 月 28 日 C 非 機 密 扱 い ARM コンパイラツールチェーン v4.1 パッチ 3 の
アップデート 2
2011 年 4 月 30 日 D 非 機 密 扱 い ARM コンパイラツールチェーン v5.0 リリース
2011 年 7 月 29 日 E 非 機 密 扱 い ARM コンパイラツールチェーン v5.0 のアップ
デー ト 1
2011 年 9 月 30 日 F 非 機 密 扱 い ARM コンパイラツールチェーン v5.01 リリース
著 作 権
®
または のマー ク が 付 いた 言 葉 およびロ ゴは、 こ の 著 作 権 情 報 で 別 段 に 規 定 さ れてい る 場 合 を 除 き、
ARM の EU ま たはその 他 の 国 におけ る 登 録 商 標 および 商 標 です。 本 書 に 記 載 さ れてい る 他 の 製 品 名 は、 各
社 の 所 有 する 商 標 です。
本 書 に 記 載 さ れてい る 情 報 の 全 部 ま たは 一 部 、 な らびに 本 書 で 紹 介 する 製 品 は、 著 作 権 所 有 者 の 文 書 に よ
る 事 前 の 許 可 を 得 ない 限 り 、 転 用 ・ 複 製 る こ と を 禁 じ ます。
本 書 に 記 載 さ れてい る 製 品 は、 今 後 も 継 続 的 に 開 発 ・ 改 良 の 対 象 と な り ます。 本 書 に 含 まれる 製 品 および
その 利 用 方 法 についての 情 報 は、 ARM が 利 用 者 の 利 益 のために 提 供 する ものです。 し たがって 当 社 では、
製 品 の 市 販 性 ま たは 利 用 の 適 切 性 を 含 め、 暗 示 的 ・ 明 示 的 に 関 係 な く 一 切 の 責 任 を 負 いません。
本 書 は、 本 製 品 の 利 用 者 をサポー ト する こ と だけを 目 的 と し ています。 本 書 に 記 載 さ れてい る 情 報 の 使
用 、 情 報 の 誤 り ま たは 省 略 、 あ るいは 本 製 の 誤 使 用 に よ って 発 生 し たいかな る 損 失 ・ 損 傷 について も、
ARM は 一 切 責 任 を 負 いません。
ARM と い う 用 語 が 使 用 さ れてい る 場 合 、 “ARM または 必 要 に 応 じてその 子 会 社 ” を 指 し ます。
機 密 保 持 ステー タ ス
本 書 は 非 機 密 扱 いであ り 、 本 書 を 使 用 、 複 製 、 および 開 示 する 権 利 は、 ARM および ARM が 本 書 を 提 供 し
た 当 事 者 と の 間 で 締 結 し た 契 約 の 条 項 に 基 づいた ラ イ セン スの 制 限 に よ り 異 な り ます。
製 品 ステー タ ス
本 書 の 情 報 は 最 終 版 であ り 、 開 発 済 み 製 品 に 対 応 し ています。
Web アドレス
http://www.arm.com
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. ii
ID 111311
Non-Confidential

目 次
ARM コンパイラツールチェーン リ ン カの 使 用
第 1 章
第 2 章
第 3 章
第 4 章
表 記 規 則 と フ ィ ー ド バ ッ ク
リ ン カの 概 要
2.1 リンカについて ....................................................................................................... 2-2
2.2 リンカのコマンドライン 構 文 .................................................................................. 2-4
2.3 リ ン カ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一 覧 ..................................................... 2-5
2.4 リ ン カ で 使 用 でき る 入 力 ....................................................................................... 2-10
2.5 リ ン カからの 出 力 .................................................................................................. 2-11
2.6 実 行 可 能 イ メ ージを 作 成 する と きに リ ン カによ っ て 実 行 される 処 理 ................... 2-12
armlink でサポー ト されている リ ンクモデル
3.1 リ ン ク モデルの 概 要 ................................................................................................ 3-2
3.2 ベアメ タルリンクモデル ......................................................................................... 3-3
3.3 部 分 リ ン ク モデル .................................................................................................... 3-5
3.4 ベースプラ ッ ト フ ォームアプリケーシ ョ ンバイナリ インタ フ ェース
(BPABI) リンクモデル ........................................................................................... 3-6
3.5 ベースプラ ッ ト フ ォームリ ンクモデル ................................................................... 3-8
3.6 SysV リンクモデル ................................................................................................ 3-10
3.7 BPABI リンクモデルと SysV リ ン ク モデルの 両 方 に 共 通 する 概 念 ...................... 3-11
イメージの 構 造 と 生 成
4.1 イ メ ージの 構 造 ....................................................................................................... 4-3
4.2 入 力 セ ク シ ョ ン、 出 力 セ ク シ ョ ン、 領 域 、 およびプ ログ ラムセグ メ ン ト ............. 4-5
4.3 イ メ ージのロー ド ビ ュー と 実 行 ビ ュー ................................................................... 4-6
4.4 リ ン カ で イ メ ージの メ モ リ マ ッ プ を 指 定 する 方 法 ................................................. 4-8
4.5 単 純 イ メ ージのタ イ プ ........................................................................................... 4-10
4.6 タイプ 1 のイ メージ : 1 つのロー ド 領 域 と 連 続 する 実 行 領 域 .............................. 4-12
4.7 タイプ 2 のイ メージ : 1 つのロー ド 領 域 と 連 続 し ない 実 行 領 域 .......................... 4-14
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. iii
ID 111311
Non-Confidential

目 次
4.8 タイプ 3 のイ メージ : 2 つのロー ド 領 域 と 連 続 し ない 実 行 領 域 .......................... 4-16
4.9 イメージのエントリポイント ................................................................................ 4-18
4.10 初 期 エン ト リ ポイ ン ト の 指 定 について ................................................................. 4-19
4.11 リ ン カによ るセ ク シ ョ ンの 配 置 ............................................................................ 4-20
4.12 FIRST 属 性 と LAST 属 性 を 使 用 し たセ ク シ ョ ンの 配 置 ....................................... 4-22
4.13 リ ン カによ るセ ク シ ョ ンの 境 界 調 整 ..................................................................... 4-23
4.14 デマン ドページング .............................................................................................. 4-24
4.15 Thumb コー ド を 含 む 実 行 領 域 の 順 序 付 けについて .............................................. 4-26
4.16 ベニアの 概 要 ......................................................................................................... 4-27
4.17 ベニアの 共 有 ......................................................................................................... 4-28
4.18 ベニアのタ イプ ..................................................................................................... 4-29
4.19 位 置 非 依 存 から 絶 対 ベニアへの 生 成 ..................................................................... 4-31
4.20 スキャ ッ タ ロー ド 時 のベニアの 再 利 用 ................................................................. 4-32
4.21 コマンドラインオプションを 使 用 した C++ 例 外 テーブルの 生 成 の 制 御 ............. 4-33
4.22 弱 参 照 と 定 義 について ........................................................................................... 4-35
4.23 リ ン カによ る ラ イ ブ ラ リ の 検 索 、 選 択 、 およびスキャ ンの 実 行 方 法 ................... 4-38
4.24 リンカによる ARM 標 準 ラ イ ブ ラ リ の 検 索 方 法 の 制 御 ......................................... 4-39
4.25 リ ン ク 時 のユーザラ イ ブ ラ リ の 指 定 ..................................................................... 4-41
4.26 リ ン カによ る 参 照 の 解 決 方 法 ................................................................................ 4-43
4.27 リ ン カにおける 厳 格 なオプシ ョ ン フ ァ ミ リ の 使 用 ............................................... 4-45
第 5 章
第 6 章
第 7 章
リ ン カの 最 適 化 の 使 用
5.1 共 通 デバ ッ グセ ク シ ョ ンの 削 除 .............................................................................. 5-3
5.2 共 通 グループまたは 共 通 セ ク シ ョ ンの 削 除 ............................................................ 5-4
5.3 未 使 用 セ ク シ ョ ンの 削 除 ......................................................................................... 5-6
5.4 未 使 用 仮 想 関 数 の 削 除 ............................................................................................. 5-8
5.5 リンカフィードバックについて .............................................................................. 5-9
5.6 リ ン カ フ ィ ー ド バ ッ クの 使 用 例 ............................................................................ 5-11
5.7 リンク 時 コード 生 成 について ................................................................................ 5-13
5.8 RW デー タ 圧 縮 を 使 用 し た 最 適 化 ......................................................................... 5-16
5.9 リ ン カによ る コ ン プ レ ッ サの 選 択 方 法 ................................................................. 5-17
5.10 リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド .......................... 5-18
5.11 圧 縮 の 適 用 方 法 ..................................................................................................... 5-20
5.12 RW デー タ 圧 縮 の 使 用 ........................................................................................... 5-21
5.13 リ ン カによ る 関 数 のイ ン ラ イ ン 化 ......................................................................... 5-22
5.14 関 数 のイ ン ラ イ ン 化 に 影 響 を 与 える 要 因 .............................................................. 5-23
5.15 NOP に 最 適 化 される 分 岐 の 処 理 ........................................................................... 5-25
5.16 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けについて ................................................... 5-26
5.17 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けに 関 する 制 限 ............................................ 5-27
5.18 コメントセクションのマージについて ................................................................. 5-28
イ メ ージに 関 する 情 報 の 取 得
6.1 イメージに 関 する 情 報 を 取 得 するためのリンカオプション ................................... 6-2
6.2 一 部 の リ ン ク エ ラーの 原 因 の 特 定 ........................................................................... 6-3
6.3 --info リ ン カオプシ ョ ンの 使 用 例 ....................................................................... 6-4
6.4 リ ン ク 時 のシンボルの 場 所 を 調 べる 方 法 ................................................................ 6-6
armlink によ るシンボルのア ク セス と 管 理
7.1 マッピングシンボルについて .................................................................................. 7-3
7.2 リ ン カ 定 義 シンボルへのア ク セス ........................................................................... 7-4
7.3 領 域 関 連 シンボル .................................................................................................... 7-5
7.4 Image$$ 実 行 領 域 シンボル ..................................................................................... 7-6
7.5 Load$$ 実 行 領 域 シンボル ....................................................................................... 7-7
7.6 Load$$LR$$ ロード 領 域 シンボル ........................................................................... 7-9
7.7 スキャ ッ タ ロー ド 時 以 外 の 領 域 名 の 値 ................................................................. 7-10
7.8 スキャ ッ タ フ ァ イルの 使 用 ................................................................................... 7-11
7.9 C および C++ での リ ン カ 定 義 シンボルのイ ンポー ト .......................................... 7-12
7.10 ARM アセンブラでのリンカ 定 義 シンボルのインポート ...................................... 7-13
7.11 セクション 関 連 シンボル ....................................................................................... 7-14
7.12 イメージシンボル .................................................................................................. 7-15
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. iv
ID 111311
Non-Confidential

目 次
7.13 入 力 セ ク シ ョ ンのシンボル ................................................................................... 7-17
7.14 別 のイ メ ージに 含 まれているシンボルへのア ク セス ............................................ 7-18
7.15 symdefs フ ァ イルの 作 成 ....................................................................................... 7-19
7.16 グローバルシンボルのサブセ ッ ト の 出 力 .............................................................. 7-20
7.17 symdefs フ ァ イルの 読 み 出 し ................................................................................ 7-21
7.18 symdefs フ ァ イルの 形 式 ....................................................................................... 7-22
7.19 ステアリングファイルとは ................................................................................... 7-24
7.20 リ ン カ コ マン ド ラ イ ンでのステア リ ング フ ァ イルの 指 定 ..................................... 7-25
7.21 ステア リ ング フ ァ イルコ マン ド の 概 要 ................................................................. 7-26
7.22 ステア リ ング フ ァ イルの 形 式 ................................................................................ 7-27
7.23 ステア リ ング フ ァ イルを 使 用 し たグローバルシンボルの 非 表 示 お
よび 名 前 の 変 更 ..................................................................................................... 7-29
7.24 $Super$$ と $Sub$$ を 使 用 し たシンボル 定 義 へのパ ッ チの 適 用 ........................ 7-30
第 8 章
第 9 章
スキャ ッ タ フ ァ イルの 使 用
8.1 スキャ ッ タロードについて ..................................................................................... 8-3
8.2 スキャ ッ タ ロー ド が 使 用 される 状 況 ....................................................................... 8-4
8.3 スキャ ッ タロードのコマン ド ラインオプシ ョ ン ..................................................... 8-5
8.4 メ モ リ マ ッ プが 単 純 な イ メ ージ .............................................................................. 8-7
8.5 メ モ リ マ ッ プが 複 雑 な イ メ ージ .............................................................................. 8-9
8.6 スキャ ッ タ ロー ド 時 に 定 義 されない リ ン カ 定 義 シンボル ..................................... 8-11
8.7 スキャ ッ タ フ ァ イルを 使 用 し たス タ ッ ク と ヒ ープの 指 定 ..................................... 8-12
8.8 ルー ト 領 域 とは ..................................................................................................... 8-13
8.9 ルー ト 実 行 領 域 の 作 成 ........................................................................................... 8-14
8.10 FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 ............................................................. 8-17
8.11 特 定 ア ド レ スへの 関 数 と デー タの 配 置 ................................................................. 8-18
8.12 スキャ ッ タ ロー ド を 使 用 し た 名 前 付 きセ ク シ ョ ンの 明 示 的 な 配 置 ...................... 8-23
8.13 .ANY モジ ュールセレ ク タ によ る 未 割 り 当 てセ ク シ ョ ンの 配 置 ........................... 8-25
8.14 .ANY セ ク シ ョ ンの 配 置 アルゴ リ ズムの 使 用 例 .................................................... 8-29
8.15 領 域 の 割 り 当 て、 セレ ク タ、 および 優 先 度 の 動 作 を 示 す next_fit
アルゴ リズムの 例 .................................................................................................. 8-32
8.16 .ANY セ ク シ ョ ンのソー ト アルゴ リ ズムの 使 用 例 ................................................. 8-34
8.17 スキャ ッ タ ロー ド の 記 述 におけるベニア 入 力 セ ク シ ョ ンの 選 択 .......................... 8-36
8.18 __attribute__((section("name"))) を 使 用 し た コー ド と デー タの 配 置 ..................... 8-37
8.19 __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する .................. 8-39
8.20 __at セ ク シ ョ ンの 配 置 に 関 する 制 限 .................................................................... 8-41
8.21 __at セ ク シ ョ ンの 自 動 配 置 ................................................................................... 8-42
8.22 __at セ ク シ ョ ンの 手 動 配 置 ................................................................................... 8-44
8.23 __at を 使 用 し た フ ラ ッ シ ュ メ モ リ でのキーの 配 置 ............................................... 8-46
8.24 __at を 使 用 し たペ リ フ ェ ラルレ ジス タ に 対 する 構 造 の 配 置 ................................ 8-48
8.25 オーバーレ イ を 使 用 し たセ ク シ ョ ンの 配 置 .......................................................... 8-49
8.26 ARM C および C++ ラ イ ブ ラ リ コー ド の 配 置 について 8-52
8.27 ルー ト 領 域 へのコー ド の 配 置 例 ............................................................................ 8-53
8.28 ARM C ラ イ ブ ラ リ コー ド の 配 置 例 ....................................................................... 8-54
8.29 ARM C++ ラ イ ブ ラ リ コー ド の 配 置 例 ................................................................... 8-55
8.30 ARM ラ イ ブ ラ リ ヘルパ 関 数 の 配 置 例 ................................................................... 8-56
8.31 空 き 領 域 の 予 約 ..................................................................................................... 8-57
8.32 ページ 境 界 での 領 域 の 作 成 について ..................................................................... 8-59
8.33 実 行 領 域 と 入 力 セ ク シ ョ ンのオーバーア ラ イ メ ン ト ............................................ 8-61
8.34 スキャ ッ タ フ ァ イルでのプ リ プ ロセ ッ シング コ マン ド の 使 用 ............................. 8-62
8.35 スキャ ッ タ フ ァ イル 内 の 式 の 評 価 ......................................................................... 8-63
8.36 スキャ ッ タ フ ァ イル 内 の 式 の 評 価 を 使 用 し たパデ ィ ングの 回 避 .......................... 8-64
8.37 等 価 なスキャ ッ タ ロー ド 記 述 を 使 用 し た 単 純 イ メ ージの 生 成 ............................. 8-65
8.38 タイプ 1 のイ メージ : 1 つのロー ド 領 域 と 連 続 する 実 行 領 域 .............................. 8-66
8.39 タイプ 2 のイ メージ : 1 つのロー ド 領 域 と 連 続 し ない 実 行 領 域 .......................... 8-68
8.40 タイプ 3 のイ メージ : 2 つのロー ド 領 域 と 連 続 し ない 実 行 領 域 .......................... 8-70
8.41 スキャ ッ タ フ ァ イルを 使 用 した ELF のマッ ピング .............................................. 8-73
armlink における GNU ld スクリプトのサポート
9.1 GNU ld スクリプトのサポート と 制 限 について ....................................................... 9-2
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. v
ID 111311
Non-Confidential

目 次
9.2 armlink での ld ス ク リ プ ト の 一 般 的 な 使 用 事 例 ...................................................... 9-4
9.3 Armlink に 実 装 されている 重 要 な ld スクリプト コマンド ....................................... 9-6
9.4 armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限 ...................................................... 9-8
9.5 armlink での ld ス ク リ プ ト の 使 用 に 関 する 推 奨 事 項 .............................................. 9-9
9.6 armlink によ っ て 使 用 されるデフ ォル ト の GNU ld スクリプト ............................ 9-10
9.7 ARM Linux 実 行 可 能 フ ァ イルを リ ン クするための GNU ld スクリプトの 例 ........ 9-14
9.8 ARM Linux 共 有 オブジ ェ ク ト を リ ン クするための GNU ld スクリプトの 例 ........ 9-16
9.9 ld --ldpartial オブジェ ク ト をリンクするための GNU ld スクリプトの 例 .. 9-18
第 10 章
第 11 章
Appendix A
BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.1 ベースプラ ッ ト フ ォームアプリケーシ ョ ンバイナリ インタ フ ェース (BPABI) につい
て ........................................................................................................................... 10-3
10.2 BPABI がサポー ト し ている プ ラ ッ ト フ ォーム 10-4
10.3 すべての BPABI モデルに 共 通 する 概 念 ................................................................ 10-5
10.4 BPABI モデルのシンボルのイ ンポー ト と エ ク スポー ト について ......................... 10-6
10.5 BPABI モデルのシンボルの 可 視 性 ........................................................................ 10-7
10.6 BPABI モデルの 自 動 的 な イ ンポー ト と エ ク スポー ト ........................................... 10-9
10.7 BPABI モデルの 手 動 のイ ンポー ト と エ ク スポー ト ............................................. 10-10
10.8 BPABI モデルのシンボルバージ ョ ン 管 理 ........................................................... 10-11
10.9 BPABI モデルの RW 圧 縮 .................................................................................... 10-12
10.10 SysV モデルのリ ンカオプシ ョ ン ........................................................................ 10-13
10.11 SysV メモリモデル .............................................................................................. 10-14
10.12 SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則 ........... 10-15
10.13 SysV メモリモデルのアドレシングモード .......................................................... 10-17
10.14 SysV メモリモデルのスレッドローカルストレージ ........................................... 10-18
10.15 SysV メモリモデルに 関 連 するリンカコマンドラインオプション ...................... 10-19
10.16 SysV メ モ リ モデルでのコ マン ド ラ イ ンデフ ォル ト への 変 更 ............................. 10-20
10.17 ベアメ タルモデルと DLL 類 似 モデルの リ ン カオプシ ョ ン ................................. 10-21
10.18 ベアメ タルメモリモデルと DLL 類 似 メ モ リ モデル ............................................ 10-22
10.19 BPABI DLL 類 似 モデルでの 必 須 のシンボルバージ ョ ン 管 理 .............................. 10-23
10.20 BPABI DLL 類 似 モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則 ..... 10-24
10.21 BPABI DLL 類 似 モデルのア ド レシングモー ド ................................................... 10-25
10.22 BPABI DLL 類 似 モデルでの C++ の 初 期 化 ......................................................... 10-26
10.23 シンボルバージョ ン 管 理 について ....................................................................... 10-27
10.24 シンボルバージ ョ ン 管 理 のス ク リ プ ト フ ァ イル ................................................. 10-28
10.25 バージ ョ ン 管 理 シンボルの 作 成 例 ....................................................................... 10-29
10.26 組 み 込 みシンボルについて ................................................................................. 10-30
10.27 暗 黙 のシンボルバージ ョ ン 管 理 を 有 効 にする リ ン カオプシ ョ ン ........................ 10-31
10.28 BPABI DLL 類 似 モデルに 関 連 する リ ン カ コ マン ド ラ イ ンオプシ ョ ン ............... 10-32
ベースプラッ ト フォームリンクモデルの 機 能
11.1 ベースプ ラ ッ ト フ ォームモデルでのスキャ ッ タ フ ァ イルの 使 用 に 関 する 制 限 .... 11-2
11.2 ベースプ ラ ッ ト フ ォーム リ ン ク モデルのスキャ ッ タ フ ァ イルの 例 ...................... 11-5
11.3 ベースプラ ッ ト フ ォームモデルを 使 用 した PLT シーケンスの 配 置 ..................... 11-7
『 リ ン カの 使 用 』 に 対 する 改 訂
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. vi
ID 111311
Non-Confidential

第 1 章
表 記 規 則 と フ ィ ー ド バ ッ ク
以 下 では、 表 記 規 則 と フ ィ ー ド バ ッ ク の 方 法 について 説 明 し ます。
表 記 規 則
以 下 の 表 記 規 則 を 使 用 し ています。
monospace コマンド、 ファイル 名 、 プログラム 名 、 ソースコードなど、 キー
ボード から 入 力 可 能 なテキス ト を 示 しています。
monospace コ マン ド ま たはオプシ ョ ンに 使 用 可 能 な 略 語 を 示 し ます。 コ マン
ド 名 またはオプシ ョ ン 名 をすべて 入 力 する 代 わ り に、 下 線 部 分 の
文 字 だけを 入 力 する こ と がで き ます。
monospace italic
コ マン ド ま たは 関 数 の 引 数 で、 特 定 の 値 に 置 き 換 え る こ と が 可 能
なものを 示 しています。
monospace bold
サンプルコード 以 外 に 使 用 される 言 語 キーワードを 示 していま
す。
italic 重 要 事 項 、 重 要 用 語 、 相 互 参 照 、 引 用 箇 所 を 斜 体 で 記 載 し ていま
す。
bold メ ニ ュー 名 な どのユーザ イ ン タ フ ェース 要 素 を 太 字 で 記 載 し てい
ます。 ま た、 適 宜 記 述 リ ス ト 内 の 重 要 箇 所 と ARM ® プロセッサの
信 号 名 にも 太 字 を 用 いています。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 1-1
ID 111311
Non-Confidential

表 記 規 則 と フ ィ ー ド バ ッ ク
本 製 品 に 関 する フ ィ ー ド バ ッ ク
本 製 品 についてのご 意 見 やご 提 案 がご ざいま し た ら、 以 下 の 情 報 を 添 え
て 購 入 元 までお 寄 せ 下 さ い。
• お 名 前 と 会 社 名
• 製 品 のシ リ アル 番 号
• 製 品 の リ リ ース 情 報
• ご 使 用 のプラッ ト フォームの 詳 細 (ハードウェアプラッ ト フォー
ム、 オペレーテ ィ ングシステムの 種 類 とバージ ョ ンなど)
• 問 題 を 再 現 するサ イ ズの 小 さ な 独 立 し たサンプルコー ド
• 操 作 の 目 的 と 実 際 の 動 作 に 関 する 詳 し い 説 明
• 使 用 し た コ マン ド (コ マン ド ラ イ ンオプシ ョ ン を 含 む)
• 問 題 を 例 示 するサンプル 出 力
• ツールのバージ ョ ン 情 報 (バージ ョ ン 番 号 、 ビル ド 番 号 を 含 む)
内 容 に 関 する フ ィ ー ド バ ッ ク
内 容 に 関 するご 意 見 につきましては、 電 子 メールを errata@arm.com まで
送 信 し て 下 さ い。 その 際 には、 以 下 の 内 容 を 記 載 し て 下 さ い。
• タイトル
• 文 書 番 号 (ARM DUI 0474FJ)
• オン ラ イ ンでご 覧 の 場 合 は、 該 当 する ト ピ ッ ク 名
• PDF 版 の 文 書 を ご 覧 の 場 合 は、 問 題 のあ るページ 番 号
• 問 題 点 の 簡 潔 な 説 明
ま た、 補 足 すべき 点 や 改 善 すべき 点 についての 全 般 的 なご 提 案 もお 待 ち
しております。
ARM では、 技 術 情 報 記 事 や FAQ の 拡 充 と 共 に、 ドキュメントに 対 する 更 新 と 訂 正 を
ARM Information Center にて 定 期 的 に 行 ってお り ます。
その 他 の 情 報
• ARM Information Center, http://infocenter.arm.com/help/index.jsp
• ARM Technical Support Knowledge Articles,
http://infocenter.arm.com/help/topic/com.arm.doc.faqs/index.html
• ARM サポー ト およびメ ンテナンス , http://www.arm.com/support/services/support-maintenance.php
• ARM 用 語 集 , http://infocenter.arm.com/help/topic/com.arm.doc.aeg0014-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 1-2
ID 111311
Non-Confidential

第 2 章
リ ン カの 概 要
以 下 の 各 ト ピ ッ ク では、 ARM リンカ armlink の 概 要 について 説 明 し ます。
概 念
• リンカについて (2-2 ページ)
• リ ン カで 使 用 で き る 入 力 (2-10 ページ)
• リンカからの 出 力 (2-11 ページ)
• 実 行 可 能 イ メ ージを 作 成 する と きに リ ンカに よ って 実 行 さ れる 処 理 (2-12 ページ)
.
参 照
• リンカのコマンドライン 構 文 (2-4 ページ)
• リ ンカ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一 覧 (2-5 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-1
ID 111311
Non-Confidential

リンカの 概 要
2.1 リンカについて
リンカ armlink は、 1 つ 以 上 のオブジ ェ ク ト フ ァ イルの 内 容 と 、 1 つ 以 上 のオブジ ェ ク
ト ラ イ ブ ラ リ か ら 選 択 さ れた 部 分 と を 結 合 し て、 以 下 を 生 成 し ます。
• ARM ELF イメージ
• 次 の リ ン ク 手 順 で 入 力 と し て 使 用 でき る 部 分 的 に リ ン ク された ELF オブジェ ク
ト
• 効 率 的 にデマン ド ページングを 行 う こ と がで き る ELF ファイル
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI)
または System V リリース 4 (SysV) 仕 様 と 互 換 性 のあ る 共 有 オブジ ェ ク ト か、
BPABI または SysV の 実 行 可 能 フ ァ イル
リンカは 以 下 を 実 行 できます。
• ARM コードおよび 16 ビッ ト Thumb ® コード と 32 ビッ ト Thumb コードを リ ンク
します。
• 必 要 に 応 じ てプ ロ セ ッ サ 状 態 を 切 り 替 え る ための イ ン ターワーキ ン グベニア を
生 成 し ます。
• 分 岐 命 令 の 範 囲 を 拡 張 する ために、 必 要 に 応 じ て、 イ ン ラ イ ンベニア ま たは 長
分 岐 ベニア を 生 成 し ます。
• リ ン ク 対 象 のオブジェ ク ト のビル ド 属 性 に 基 づいて、 リ ン ク に 適 し た 標 準 C ラ
イブラ リ または C++ ラ イ ブ ラ リ のバ リ ア ン ト を 自 動 的 に 選 択 し ます
• コマンド ラインオプショ ンまたはスキャッタファイルを 使 用 して、 システムメ
モ リ マップ 内 のコード とデータの 位 置 を 指 定 でき る よ う にします。
• 読 み 出 し / 書 き 込 みデータ 圧 縮 を 実 行 し て、 ROM サ イ ズを 最 小 化 し ます。
• 未 使 用 セ ク シ ョ ン を 削 除 し て、 出 力 イ メ ージのサ イ ズ を 小 さ く し ます。
• 出 力 フ ァ イ ルのデバ ッ グ 情 報 の 生 成 を 制 御 し ます。
• 静 的 コールグ ラ フの 生 成 と そのス タ ッ ク 使 用 量 の 一 覧 の 出 力 を 行 います。
• 出 力 イ メ ージにあ る シンボルテーブルの 内 容 を 制 御 し ます。
• 出 力 に 含 まれる コー ド と データ のサ イ ズ を 表 示 し ます。
• リ ンカ フ ィ ー ド バ ッ ク を 使 用 し て、 個 々の 未 使 用 の 関 数 を 削 除 し ます。
• 制 限 付 き で GNU ld スクリプトを 受 け 入 れます。
注
64 ビ ッ ト オペレーテ ィ ングシ ス テム 上 のプ ロ セスが よ り 大 容 量 の メ モ リ を 使 用 可 能
な armlink の 64 ビット 版 が 用 意 されています。 64 ビッ ト 版 は、 このリ リースの
armlink の 32 ビ ッ ト 版 でサポー ト されているすべての 機 能 をサポー ト し ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-2
ID 111311
Non-Confidential

リンカの 概 要
2.1.1 関 連 項 目
タスク
『ARM コンパイラツールチェーンの 概 要 』:
• 64 ビットのリンカへの 変 更 (2-8 ページ) .
概 念
• デマン ドページング (4-24 ページ)
• リンカフィードバックについて (5-9 ページ)
• 第 3 章 armlink でサポー ト されている リ ン クモデル
• 第 4 章 イ メージの 構 造 と 生 成
• 第 5 章 リンカの 最 適 化 の 使 用
• 第 6 章 イ メ ージに 関 する 情 報 の 取 得
• 第 7 章 armlink によるシンボルのアクセスと 管 理
• 第 8 章 スキャッタファイルの 使 用
• 第 9 章 armlink における GNU ld スクリプトのサポート
• 第 10 章 BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
• 第 11 章 ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能 .
その 他 の 情 報
Base Platform ABI for the ARM Architecture,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0037-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-3
ID 111311
Non-Confidential

リンカの 概 要
2.2 リンカのコマンドライン 構 文
リ ンカ を 起 動 する コ マン ド は 以 下 の と お り です。
armlink [options] [input-file-list]
options
リンカコマンドラインオプション
input-file-list
オブジェ ク ト 、 ラ イブラ リ 、 またはシンボル 定 義 (symdefs) ファイル
の 空 白 で 区 切 られた リ ス ト
2.2.1 関 連 項 目
参 照
• リ ンカ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一 覧 (2-5 ページ) .
『リンカリファレンス』:
• input-file-list (2-87 ページ)
• 第 2 章 リンカコマンドラインオプション.
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-4
ID 111311
Non-Confidential

リンカの 概 要
2.3 リ ン カ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一 覧
『リンカリファレンス』 の 以 下 のコマン ド ラ イ ンオプシ ョ ンを 参 照 し て 下 さい。
ライブラリファイルとパスの 制 御
• --add_needed、 --no_add_needed (2-6 ページ)
• --add_shared_references、 --no_add_shared_references (2-7 ペー
ジ)
• --libpath=pathlist (2-97 ページ)
• --library=name (2-98 ページ)
• --library_type=lib (2-99 ページ)
• --reduce_paths、 --no_reduce_paths (2-131 ページ)
• --runpath=pathlist (2-140 ページ)
• --scanlib、 --no_scanlib (2-143 ページ)
• --search_dynamic_libraries、 --no_search_dynamic_libraries
(2-146 ページ)
• --thumb2_library、 --no_thumb2_library (2-174 ページ)
• --userlibpath=pathlist (2-182 ページ) .
オブジェ ク ト フ ァ イルの リ ン クの 制 御
• --match=crossmangled (2-110 ページ)
• --strict (2-158 ページ)
• --strict_ph、 --no_strict_ph (2-161 ページ)
• --strict_relocations、 --no_strict_relocations (2-162 ページ)
• --sysroot=path (2-171 ページ)
• --unresolved=symbol (2-179 ページ) .
出 力 の 制 御
• --base_platform (2-18 ページ)
• --bpabi (2-24 ページ)
• --combreloc、 --no_combreloc (2-33 ページ)
• --dll (2-49 ページ)
• --ldpartial (2-95 ページ)
• --output=file (2-115 ページ)
• --partial (2-120 ページ)
• --prelink_support、 --no_prelink_support (2-127 ページ)
• --reloc (2-134 ページ)
• --shared (2-148 ページ)
• --sysv (2-172 ページ) .
イメージのメモリマップの 指 定
• --autoat、 --no_autoat (2-17 ページ)
• --fpic (2-74 ページ)
• --linker_script=ld_script (2-101 ページ)
• --predefine="string" (2-125 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-5
ID 111311
Non-Confidential

リンカの 概 要
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• --scatter=file (2-144 ページ)
• --split (2-156 ページ)
• --use_sysv_default_script、 --no_use_sysv_default_script
(2-181 ページ)
• --zi_base=address (2-197 ページ) .
イメージ 内 のデバッグ 情 報 の 制 御
• --bestdebug、 --no_bestdebug (2-21 ページ)
• --compress_debug、 --no_compress_debug (2-35 ページ)
• --debug、 --no_debug (2-41 ページ)
• --dynamic_debug (2-50 ページ)
• --emit_debug_overlay_relocs (2-54 ページ)
• --emit_debug_overlay_section (2-55 ページ)
• --emit_non_debug_relocs (2-56 ページ)
イメージの 内 容 の 制 御
• --any_contingency (2-8 ページ)
• --any_placement=algorithm (2-9 ページ)
• --any_sort_order=order (2-11 ページ)
• --api、 --no_api (2-12 ページ)
• --arm_linux (2-13 ページ)
• --arm_only (2-15 ページ)
• --as_needed、 --no_as_needed (2-16 ページ)
• --blx_arm_thumb、 --no_blx_arm_thumb (2-22 ページ)
• --blx_thumb_arm、 --no_blx_thumb_arm (2-23 ページ)
• --branchnop、 --no_branchnop (2-25 ページ)
• --comment_section、 --no_comment_section (2-34 ページ)
• --cppinit、 --no_cppinit (2-36 ページ)
• --cpu=name (2-38 ページ)
• --datacompressor=opt (2-40 ページ)
• --device=list (2-42 ページ)
• --device=name (2-43 ページ)
• --dynamic_linker=name (2-51 ページ)
• --edit=file_list (2-53 ページ)
• --emit_relocs (2-57 ページ)
• --entry=location (2-58 ページ)
• --exceptions、 --no_exceptions (2-61 ページ)
• --exceptions_tables=action (2-62 ページ)
• --execstack、 --no_execstack (2-63 ページ)
• --export_all、 --no_export_all (2-64 ページ)
• --export_dynamic、 --no_export_dynamic (2-65 ページ)
• --filtercomment、 --no_filtercomment (2-69 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-6
ID 111311
Non-Confidential

リンカの 概 要
• --fini=symbol (2-70 ページ)
• --first=section_id (2-71 ページ)
• --force_explicit_attr (2-72 ページ)
• --force_so_throw、 --no_force_so_throw (2-73 ページ)
• --fpu=name (2-76 ページ)
• --gnu_linker_defined_syms (2-77 ページ)
• --import_unresolved、 --no_import_unresolved (2-79 ページ)
• --init=symbol (2-84 ページ)
• --inline、 --no_inline (2-85 ページ)
• --keep=section_id (2-89 ページ)
• --keep_protected_symbols (2-91 ページ)
• --largeregions、 --no_largeregions (2-92 ページ)
• --last=section_id (2-94 ページ)
• --linux_abitag=version_id (2-102 ページ)
• --locals、 --no_locals (2-106 ページ)
• --ltcg (2-107 ページ)
• --max_visibility=type (2-112 ページ)
• --merge、 --no_merge (2-113 ページ)
• --muldefweak、 --no_muldefweak (2-114 ページ)
• --override_visibility (2-116 ページ)
• --pad=num (2-117 ページ)
• --paged (2-118 ページ)
• --pagesize=pagesize (2-119 ページ)
• --pltgot=type (2-122 ページ)
• --pltgot_opts=mode (2-124 ページ)
• --privacy (2-128 ページ)
• --ref_cpp_init、 --no_ref_cpp_init (2-132 ページ)
• --remove、 --no_remove (2-136 ページ)
• --soname=name (2-153 ページ)
• --sort=algorithm (2-154 ページ)
• --startup=symbol、 --no_startup (2-157 ページ)
• --strict_flags、 --no_strict_flags (2-160 ページ)
• --symbolic (2-166 ページ)
• --symver_script=file (2-169 ページ)
• --symver_soname (2-170 ページ)
• --tailreorder、 --no_tailreorder (2-173 ページ)
• --tiebreaker=option (2-175 ページ)
• --undefined=symbol (2-177 ページ)
• --undefined_and_export=symbol (2-178 ページ)
• --use_definition_visibility (2-180 ページ)
• --vfemode=mode (2-189 ページ) .
ベニア 生 成 の 制 御
• --crosser_veneershare、 --no_crosser_veneershare (2-39 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-7
ID 111311
Non-Confidential

リンカの 概 要
• --inlineveneer、 --no_inlineveneer (2-86 ページ)
• --max_veneer_passess=value (2-111 ページ)
• --piveneer、 --no_piveneer (2-121 ページ)
• --veneerinject、 --no_veneerinject (2-183 ページ)
• --veneer_inject_type=type (2-184 ページ)
• --veneer_pool_size=size (2-185 ページ)
• --veneershare、 --no_veneershare (2-186 ページ) .
バイ ト アドレシングモードの 制 御
• --be8 (2-19 ページ)
• --be32 (2-20 ページ) .
イ メ ージ 情 報 の 抽 出 および 表 示 の 制 御
• --callgraph、 --no_callgraph (2-26 ページ)
• --callgraph_file=filename (2-28 ページ)
• --callgraph_output=fmt (2-29 ページ)
• --cgfile=type (2-30 ページ)
• --cgsymbol=type (2-31 ページ)
• --cgundefined=type (2-32 ページ)
• --feedback=file (2-66 ページ)
• --feedback_image=option (2-67 ページ)
• --feedback_type=type (2-68 ページ)
• --info=topic[,topic,...] (2-80 ページ)
• --info_lib_prefix=opt (2-83 ページ)
• --list_mapping_symbols、 --no_list_mapping_symbols (2-104 ペー
ジ)
• --load_addr_map_info、 --no_load_addr_map_info (2-105 ページ)
• --mangled、 --unmangled (2-108 ページ)
• --map、 --no_map (2-109 ページ)
• --section_index_display=type (2-147 ページ)
• --symbols、 --no_symbols (2-167 ページ)
• --symdefs=file (2-168 ページ)
• --xref、 --no_xref (2-194 ページ)
• --xrefdbg、 --no_xrefdbg (2-195 ページ)
• --xref{from|to}=object(section) (2-196 ページ) .
注
--callgraph を 指 定 した 場 合 を 除 き、 リ ンカでは 要 求 された 情 報 がデフォル ト では 標
準 出 力 ス ト リ ーム stdout に 出 力 されます。 --list コマンドラインオプショ ンを 使 用 す
ると、 この 情 報 をテキストファイルに 転 送 できます。
診 断 メ ッ セージの 制 御
• --diag_error=tag[,tag,...] (2-44 ページ)
• --diag_remark=tag[,tag,...] (2-45 ページ)
• --diag_style=arm|ide|gnu (2-46 ページ)
• --diag_suppress=tag[,tag,...] (2-47 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-8
ID 111311
Non-Confidential

リンカの 概 要
• --diag_warning=tag[,tag,...] (2-48 ページ)
• --errors=file (2-60 ページ)
• --list=file (2-103 ページ)
• --remarks (2-135 ページ)
• --show_full_path (2-150 ページ)
• --show_parent_lib (2-151 ページ)
• --show_sec_idx (2-152 ページ)
• --strict_enum_size、 --no_strict_enum_size (2-159 ページ)
• --strict_symbols、 --no_strict_symbols (2-163 ページ)
• --strict_visibility、 --no_strict_visibility (2-164 ページ)
• --strict_wchar_size、 --no_strict_wchar_size (2-165 ページ)
• --verbose (2-187 ページ) .
従 来 の イ メ ージの 境 界 整 列 の 制 御
• --legacyalign、 --no_legacyalign (2-96 ページ) .
その 他
• --cpu=list (2-37 ページ)
• --eager_load_debug、 --no_eager_load_debug (2-52 ページ)
• --fpu=list (2-75 ページ)
• --licretry (2-100 ページ)
• --project=filename、 --no_project (2-129 ページ)
• --reinitialize_workdir (2-133 ページ)
• --show_cmdline (2-149 ページ)
• --version_number (2-188 ページ)
• --via=file (2-191 ページ)
• --vsn (2-192 ページ)
• --workdir=directory (2-193 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-9
ID 111311
Non-Confidential

リンカの 概 要
2.4 リ ン カ で 使 用 で き る 入 力
armlink への 入 力 は、 ARM ELF の 1 つ 以 上 のオブジ ェ ク ト フ ァ イルで 構 成 さ れます。
この 形 式 は、 『ELF for the ARM Architecture (ARM IHI 0044)』 に 記 載 されています。
armlink への 入 力 と し て 以 下 のフ ァ イルをオプシ ョ ンで 使 用 でき ます。
• ライブラリアン armar によって 作 成 された 1 つ 以 上 の ラ イ ブ ラ リ
• シンボル 定 義 ファイル
• スキャッタファイル
• ステアリ ングファイル
2.4.1 関 連 項 目
タスク
• 第 8 章 スキャッタファイルの 使 用 .
『armar での 静 的 ソ フ ト ウ ェ ア ラ イ ブ ラ リ の 作 成 』 :
• 新 しいオブジェク ト ライブラ リの 作 成 (3-2 ページ) .
参 照
• 別 のイ メ ージに 含 まれている シンボルへのア ク セス (7-18 ページ) .
『リンカリファレンス』:
• 第 3 章 リンカステアリングファイルコマンドリファレンス
• 第 4 章 スキャッタファイルの 正 式 な 構 文 .
その 他 の 情 報
• 『ELF for the ARM Architecture (ARM IHI 0044)』 ,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-10
ID 111311
Non-Confidential

リンカの 概 要
2.5 リ ン カからの 出 力
armlink からは 以 下 が 出 力 されます。
• ELF 実 行 可 能 イ メ ージ
• ELF 共 有 オブジ ェ ク ト
• 部 分 的 に リ ン ク さ れた ELF オブジェ ク ト
• 再 配 置 可 能 な ELF オブジェ ク ト
fromelf を 使 用 する と、 ELF 実 行 可 能 イ メ ージを 他 のフ ァ イル 形 式 に 変 換 し た り 、
ELF 実 行 可 能 イ メ ージの 内 容 を 表 示 、 処 理 、 保 護 し た り する こ と がで き ます。
2.5.1 関 連 項 目
概 念
• 部 分 リ ン ク モデル (3-5 ページ)
• リンカによるセクションの 配 置 (4-20 ページ)
• イメージの 構 造 (4-3 ページ) .
『fromelf イ メ ージ 変 換 ユーテ ィ リ テ ィ の 使 用 』 :
• 第 2 章 fromelf イメージ 変 換 ユーティリティの 概 要 .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-11
ID 111311
Non-Confidential

リンカの 概 要
2.6 実 行 可 能 イ メ ージ を 作 成 する と きに リ ン カによ っ て 実 行 される 処 理
リ ンカ を 使 用 し て 実 行 可 能 イ メ ージを 作 成 する と きは、 以 下 の 処 理 が 行 われます。
• 複 数 の 入 力 オブジ ェ ク ト フ ァ イ ル 間 のシンボ リ ッ ク 参 照 を 解 決 し ます。
• そのま までは 不 完 全 なシンボ リ ッ ク 参 照 を 解 決 する ために、 ラ イ ブ ラ リ か ら オ
ブジェ ク ト モジュールを 抽 出 し ます。
• 入 力 セ ク シ ョ ン を 属 性 と 名 前 で ソ ー ト し、 類 似 する 属 性 と 名 前 の 付 いたセ ク
シ ョ ン を 連 続 するチャ ン ク にマージ し ます。
• 未 使 用 セ ク シ ョ ン を 削 除 し ます。
• 重 複 する 共 通 グループ、 共 通 コードセクシ ョ ン、 データセクシ ョ ン、 およびデ
バッグセクショ ンを 削 除 します。
• 指 定 されたグループ 化 と 配 置 の 情 報 に 基 づいて、 オブジェ ク ト の 断 片 を メ モ リ
領 域 内 に 配 置 し ます。
• 再 配 置 可 能 な 値 にア ド レ ス を 割 り 当 て ます。
• 実 行 可 能 イ メ ージを 生 成 し ます。
2.6.1 関 連 項 目
タスク
• 共 通 デバ ッ グセ ク シ ョ ンの 削 除 (5-3 ページ)
• 未 使 用 セ ク シ ョ ンの 削 除 (5-6 ページ) .
概 念
• イメージの 構 造 (4-3 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 2-12
ID 111311
Non-Confidential

第 3 章
armlink でサポートされているリンクモデル
以 下 の 各 ト ピ ッ ク では、 ARM リンカ armlink でサポー ト されている リ ン クモデルについ
て 説 明 し ます。
概 念
• リンクモデルの 概 要 (3-2 ページ)
• ベア メ タル リ ン クモデル (3-3 ページ)
• 部 分 リ ン ク モデル (3-5 ページ)
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバイナ リ イ ン タ フ ェース (BPABI) リ ン
クモデル (3-6 ページ)
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• SysV リンクモデル (3-10 ページ)
• BPABI リンクモデルと SysV リ ン ク モデルの 両 方 に 共 通 する 概 念 (3-11 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-1
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.1 リ ン ク モデルの 概 要
リ ン ク モデル と は、 リ ンカの 動 作 を 制 御 する、 コ マン ド ラ イ ンオプシ ョ ン と メ モ リ
マップの 集 まりです。
ベア メ タル このモデルの 対 象 は 特 定 のプラッ ト フォームではありません。 このモデ
ルを 使 用 する と 、 独 自 のカ ス タ ムオペレーテ ィ ン グシ ス テム、 メ モ リ
マ ッ 、 および 必 要 に 応 じ てアプ リ ケーシ ョ ン コー ド を 使 用 し て イ メ ージ
を 作 成 できます。 一 部 の 制 限 されたダイナ ミ ッ ク リ ン ク もサポー ト され
ています。 追 加 のオプシ ョ ンを 指 定 でき るかど う かは、 スキャ ッ タフ ァ
イルが 使 用 されているかど うかによって 異 なり ます。
部 分 リ ン ク
BPABI
このモデルは、 後 続 の リ ン ク 手 順 での リ ンカへの 入 力 に 適 し た、 プラ ッ
ト フ ォームに 依 存 し ないオブジ ェ ク ト を 生 成 し ます。 こ のモデルを 開 発
プセスの 中 間 手 順 と し て 使 用 し て、 入 力 オブジ ェ ク ト の 制 限 付 き 処 理 を
実 行 し、 単 一 の 出 力 オブジ ェ ク ト を 生 成 で き ます。
このモデルでは、 DLL 類 似 ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ
イナリ インタフェース (BPABI) をサポー ト し ています。 複 雑 性 の 異 な
るプラッ ト フォーム OS で 動 作 可 能 なアプ リ ケーシ ョ ン と DLL を 生 成 す
るためのモデルです。 メモリデルは BPABI 仕 様 に 従 って 制 限 さ れます。
ベースプ ラ ッ ト フ ォーム
これは、 スキャッタロードをサポートするための BPABI モデルの 拡 張
です。
SysV
このモデルでは、 ARM Linux が 使 用 する ELF で 指 定 される System V
(SysV) モデルをサポート しています。 メモリモデルは ELF 仕 様 に 従 っ
て 制 限 されます。
各 モデルの 関 連 するオプシ ョ ンを 組 み 合 わせて 出 力 を 厳 密 に 制 御 できます。
3.1.1 関 連 項 目
概 念
• ベア メ タル リ ン クモデル (3-3 ページ)
• 部 分 リ ン ク モデル (3-5 ページ)
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI)
リンクモデル (3-6 ページ)
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• SysV リンクモデル (3-10 ページ)
• BPABI リンクモデルと SysV リンクモデルの 両 方 に 共 通 する 概 念 (3-11 ページ)
.
参 照
• 第 10 章 BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル .
その 他 の 情 報
• 『ARM アーキテクチャ 用 ベースプラ ッ ト フォーム ABI』 ,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0037-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-2
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.2 ベアメ タルリ ンクモデル
ベア メ タルモデルは、 プログ ラ ム 全 体 ( リアルタイムオペレーティングシステム
(RTOS) を 含 む 場 合 あ り ) がワ ンパスで リ ン ク さ れてい る 従 来 の 組 み 込 み 市 場 に 向
けたモデルです。 ベア メ タルシステムの メ モ リ マ ッ プに 関 し て、 リ ンカで 想 定 でき
る 内 容 はほ と んど あ り ません。 そのため、 厳 密 に 制 御 する 必 要 があ る 場 合 は、 ス
キ ャ ッ タ ロー ド メ カニズム を 使 用 する 必 要 があ ます。
デフ ォル ト では、 リ ンカはすべての 再 配 置 を 静 的 に 解 決 し よ う と し ます。 ただ し、
位 置 非 依 存 イ メ ージ ま たは 再 配 置 可 能 な イ メ ージを 作 成 する こ も で き ます。 そ う し
た イ メ ージは、 異 な る ア ド レ スか ら 実 行 し、 ロー ド 時 ま たは 実 行 時 に 再 配 置 を 解 決
できます。 これは、 ダイナミ ッ クモデル 使 用 して 実 現 できます。
こ の タ イ プのモデルでは、 以 下 の こ と がで き ます。
• ス キ ャ ッ タ フ ァ イルま たはコ マン ド ラ イ ンオプシ ョ ン を 使 用 し て 再 配 置 可 能 な
領 域 ま たは 位 置 非 依 存 の 領 域 を 識 別 し ます。
• ステア リ ングファ イルを 使 用 してインポートおよびエクスポートできるシンボ
ルを 識 別 します。
• ステアリ ングファイルを 使 用 して ELF ファイルに 必 要 な 共 有 ライブラリを 識 別
します。
こ のモデルでは、 以 下 のオプシ ョ ン を 使 用 で き ます。
• --edit=file_list
• --scatter=file
スキャ ッ タ ロード を 使 用 しない 場 合 は、 以 下 のオプシ ョ ンを 使 用 できます。
• --reloc
• --ro_base=address
• --ropi
• --rosplit
• --rw_base=address
• --rwpi
• --split
• --zi_base
3.2.1 関 連 項 目
概 念
• リ ンカで イ メ ージの メ モ リ マ ッ プを 指 定 する 方 法 (4-8 ページ) .
参 照
『リンカリファレンス』:
• --edit=file_list (2-53 ページ)
• --reloc (2-134 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-3
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
• --scatter=file (2-144 ページ)
• --split (2-156 ページ)
• --zi_base=address (2-197 ページ)
• 第 3 章 リンカステアリングファイルコマンドリファレンス.
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-4
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.3 部 分 リ ン ク モデル
部 分 リ ン ク では、 以 下 の 処 理 が 行 われます。
• デバ ッ グセ ク シ ョ ンの 重 複 する コ ピーを 削 除 し ます。
• シンボルテーブルを 1 つにマージ し ます。
• 未 解 決 の 参 照 を 未 解 決 のま まに し ます。
• 共 通 データ (COMDAT) グループをマージします。
• 次 の リ ン ク 手 順 への 入 力 と し て 使 用 可 能 なオブジ ェ ク ト を 生 成 し ます。
こ れに よ り 、 次 の リ ン ク 手 順 への 入 力 と し て 使 用 可 能 な 1 つの 出 力 フ ァ イルが 生 成
さ れます。 リ ンカが 入 力 フ ァ イル 内 に 複 数 のエン ト リ ポ イ ン ト 検 出 し た 場 合 、 出 力
ファイルに 含 めることができるエント リポイントは 1 つのみであ るため、 エラーが
生 成 さ れます。
このモデルを 使 用 してリンクするには、--partial コマンド ラインオプショ ンを 使 用
し ます。 こ のモデルでは、 以 下 の リ ン カ コ マン ド ラ イ ンオプシ ョ ン も サポー ト さ れ
ています。
• --edit=file_list
• --exceptions_tables=action
注
部 分 リ ン ク を 使 用 する 場 合 、 ス キ ャ ッ タ フ ァ イルでは、 コ ンポーネン ト オブジ ェ ク
ト を 名 前 で 参 照 する こ と はでき ません。 そのため、 スキ ャ ッ タ ァ イルのア ッ プデー
トが 必 要 になる 場 合 があります。
3.3.1 関 連 項 目
概 念
• ステアリ ングファイルとは (7-24 ページ) .
参 照
• ステアリ ングファイルの 形 式 (7-27 ページ) .
『リンカリファレンス』:
• --edit=file_list (2-53 ページ)
• --exceptions_tables=action (2-62 ページ)
• --partial (2-120 ページ)
• 第 3 章 リンカステアリングファイルコマンドリファレンス.
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-5
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.4 ベースプラ ッ ト フ ォームアプ リケーシ ョ ンバイナリ イン タ フ ェース (BPABI) リン
クモデル
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) は、
独 自 のプラ ッ ト フ ォーム 固 有 のイ メ ージ 形 式 を 生 成 するサード パーテ ィ 用 の メ タ 標
準 です。 つま り 、 BPABI モデルはプ ラ ッ ト フ ォーム 特 定 せずにで き る だけ 多 く の 情
報 を 生 成 し ます。
以 下 の 点 に 注 意 し て 下 さい。
• スキャッタロードを 使 用 できません。 ただし、 ベースプラッ ト フォームリンク
モデルは、 スキ ャ ッ タ ロード をサポー ト する BPABI モデルの 拡 張 です。
• このモデルは、 共 有 オブジェク トが C++ 例 外 を ス ローで き ない こ と を 前 提 と し
ています。
• --pltgot オプシ ョ ンのデフォル ト 値 は direct です。
• 必 要 なすべてのシンボルが ロー ド 時 に 利 用 可 能 にな る よ う に、 シンボルバー
ジ ョ ン 管 理 を 使 用 する 必 要 があ り ます。
このモデルを 使 用 してリンクするには、--bpabi コマンド ラインオプショ ンを 使 用 し
ます。 このモデルでは、 以 下 の リ ンカコマンド ラ インオプシ ョ ンもサポート されて
います。
• --dll
• --force_so_throw、 --no_force_so_throw
• --pltgot=type
• --ro_base=address
• --rosplit
• --rw_base=address
• --rwpi
3.4.1 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• BPABI リンクモデルと SysV リンクモデルの 両 方 に 共 通 する 概 念 (3-11 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ) .
参 照
『リンカリファレンス』:
• --bpabi (2-24 ページ)
• --dll (2-49 ページ)
• --force_so_throw、 --no_force_so_throw (2-73 ページ)
• --pltgot=type (2-122 ページ)
• --ro_base=address (2-137 ページ)
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-6
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
その 他 の 情 報
• 『ARM アーキテクチャ 用 ベースプラ ッ ト フォーム ABI』 ,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0037-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-7
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.5 ベースプラ ッ ト フ ォームリ ンクモデル
ベースプ ラ ッ ト フ ォームでは、 System V (SysV) リ ンクモデルまたはベースプ ラ ッ ト
フォームアプリケーションバイナリ インタフェイス (BPABI) リ ンクモデルで 強 制
さ れる メ モ リ マ ッ プを 持 たない 動 的 に リ ン ク 可 能 な イ メ ージを 作 成 で き ます。 こ の
モデルでは 以 下 を 実 行 でき ます。
• ス キ ャ ッ タ フ ァ イ ルに 記 述 さ れてい る メ モ リ マ ッ プを 持 つイ メ ージ を 作 成 し ま
す。
• ダ イナ ミ ッ ク な 再 配 置 に よ って、 イ メ ージを 動 的 に リ ン ク で き る よ う に し ま
す。 ダ イ ナ ミ ッ ク な 再 配 置 は、 同 じ イ メ ージ 内 を ターゲ ッ ト にする こ も で き ま
す。
注
BPABI 仕 様 には、 ス キ ャ ッ タ ロー ド の 使 用 を 妨 げる 可 能 性 があ る、 メ モ リ モデルに
対 する 制 約 があ り ます。 ただ し、 ベースプ ラ ッ ト フ ォームは BPABI のスーパーセッ
トであるため、ベースプラットフォームを 使 用 して BPABI に 準 拠 し た イ メ ージを 作
成 でき ます。
ベースプ ラ ッ ト フ ォームモデルを 使 用 し て リ ン ク する には、 --base_platform コマンド
ラインオプションを 使 用 します。
こ のオプシ ョ ン を 指 定 する と 、 以 下 の 点 を 除 き、 リ ン カは --bpabi を 指 定 した 場 合 と
同 様 に 動 作 し ます。
• 以 下 のオプシ ョ ンに 加 え、 --scatter と 共 にス キ ャ ッ タ ロー ド を 利 用 で き ます。
— --dll
— --force_so_throw、 --no_force_so_throw
— --pltgot=type (タイプは none または direct に 制 限 されます)
— --ro_base=address
— --rosplit
— --rw_base=address
— --rwpi
• --pltgot オプシ ョ ンのデフォル ト 値 は、 --bpabi のデフ ォル ト 値 と は 異 な り ます。
— --base_platform の 場 合 、 デフ ォル ト は --pltgot=none です。
— --bpabi を 使 用 している 場 合 、 デフォル ト は --pltgot=direct です。
• ス キ ャ ッ タ フ ァ イルを 使 用 し ない 場 合 、 リ ンカでは、 プロシージャ リ ンクテー
ブル (PLT) セクシ ョ ンを 正 し く 配 置 し、 そこにインポート したシンボルのみ
を 呼 び 出 すためのエン ト リ を 含 め る こ と がで き ます。 ス キ ャ ッ タ フ ァ イル 指 定
した 場 合 、 リンカは PLT の 配 置 に 適 し た 場 所 を 見 つける こ と ができ ないこ と が
あります。
コー ド を 含 む 各 ロー ド 領 域 では、 静 的 リ ン ク 時 にア ド レ スが 不 明 な 場 合 に ロー
ド 領 域 か ら 関 数 への 間 接 的 な 呼 び 出 し を 行 う ために、 PLT セクションが 必 要 な
こ と があ り ます。 ロー ド 領 域 LR の PLT セクションは LR に 配 置 し、 LR 内 のコー
ド か ら いつで も ア ク セスで き る 必 要 があ り ます。
実 行 時 に 再 配 置 可 能 な ロー ド 領 域 間 で 確 実 に 呼 び 出 し を 行 う には、 以 下 の 操 作
を 実 行 し ます。
— --pltgot=direct オプシ ョ ン を 使 用 し て、 PLT の 生 成 を 有 効 にし ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-8
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
— --pltgot_opts=crosslr オプシ ョ ンを 使 用 して、 RELOC ロー ド 領 域 間 での 呼 び
出 しを 行 う ためのエン ト リ を PLT に 追 加 し ます。 リ ンカによ って ロード
領 域 ご と に PLT が 生 成 されるため、 離 れている PLT にアクセスするのに
呼 び 出 し を 拡 張 する 必 要 があ り ません。
以 下 の 点 に 注 意 し て 下 さい。
• このモデルは、 共 有 オブジェク トが C++ 例 外 を ス ローで き ない こ と を 前 提 と し
ています。
• 必 要 なすべてのシンボルが ロー ド 時 に 利 用 可 能 にな る よ う に、 シンボルバー
ジ ョ ン 管 理 を 使 用 する 必 要 があ り ます。
• 使 用 で き る ス キ ャ ッ タ フ ァ イルの タ イ プには 制 限 があ り ます。
3.5.1 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI)
リンクモデル (3-6 ページ)
• BPABI リンクモデルと SysV リンクモデルの 両 方 に 共 通 する 概 念 (3-11 ページ)
• リ ンカで イ メ ージの メ モ リ マ ッ プを 指 定 する 方 法 (4-8 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ)
• ベースプ ラ ッ ト フ ォームモデルでのス キ ャ ッ タ フ ァ イルの 使 用 に 関 する 制 限
(11-2 ページ)
• ベースプラ ッ ト フ ォーム リ ン ク モデルのスキ ャ ッ タ フ ァ イルの 例 (11-5 ペー
ジ) .
参 照
『リンカリファレンス』:
• --base_platform (2-18 ページ)
• --dll (2-49 ページ)
• --force_so_throw、 --no_force_so_throw (2-73 ページ)
• --pltgot=type (2-122 ページ)
• --pltgot_opts=mode (2-124 ページ)
• --ro_base=address (2-137 ページ)
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• --scatter=file (2-144 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-9
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.6 SysV リンクモデル
System V (SysV) モデルでは、 SysV の 共 有 オブジ ェ ク ト および 実 行 可 能 フ ァ イルが
生 成 さ れます。 こ のモデルを 使 用 し て、 ARM Linux と 互 換 性 のある 共 有 オブジェク
ト や 実 行 可 能 フ ァ イルを 生 成 する こ と も で き ます。
以 下 の 点 に 注 意 し て 下 さい。
• スキャッタロードを 使 用 できません。
• こ のモデルは、 共 有 オブジ ェ ク ト が 例 外 を ス ローで き る こ と を 前 提 と し ていま
す。
• スレ ッ ド ローカルス ト レージがサポー ト されています。
このモデルを 使 用 してリンクするには、--sysv コマンド ラインオプショ ンを 使 用 しま
す。 こ のモデルでは、 以 下 の リ ン カ コ マン ド ラ イ ンオプシ ョ ン も サポー ト さ れてい
ます。
• --force_so_throw、 --no_force_so_throw
• --fpic
• --linux_abitag=version_id
• --shared
3.6.1 関 連 項 目
概 念
• BPABI リンクモデルと SysV リンクモデルの 両 方 に 共 通 する 概 念 (3-11 ページ)
.
参 照
『リンカリファレンス』:
• --force_so_throw、 --no_force_so_throw (2-73 ページ)
• --fpic (2-74 ページ)
• --linux_abitag=version_id (2-102 ページ)
• --shared (2-148 ページ)
• --sysv (2-172 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-10
ID 111311
Non-Confidential

armlink でサポー ト されている リ ンクモデル
3.7 BPABI リンクモデルと SysV リ ン ク モデルの 両 方 に 共 通 する 概 念
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) リ ン
クモデルと System V (SysV) リ ンクモデルのどちらも、 イ メージと 共 有 オブジェク
トは 通 常 は 既 存 のオペレーティングプラットフォームで 実 行 されます。
BPABI モデル と SysV モデルには 多 く の 類 似 点 があ り ます。 例 えば、 どち らのモデル
も 例 外 テーブルをマ ッ プする プ ロ グ ラ ムヘ ッ ダを 生 成 し ます。 主 違 いは、 メ モ リ モ
デル と 、 プロシージャ リ ンクテーブル (PLT) およびグローバルオフセッ トテーブル
(GOT) 構 造 にあり ます。 これらはまとめて 「PLTGOT」 と 呼 ばれます。 両 方 のモデ
ルに 共 通 する 多 く のオプシ ョ ンが 存 在 し ます。
3.7.1 BPABI と SysV の 制 限
BPABI と SysV の 両 方 のモデルには 以 下 の 制 限 があ り ます。
• 共 有 ラ イ ブ ラ リ と DLL に 対 する 未 使 用 セ ク シ ョ ンの 削 除 は 無 効 になっていま
す。
• 仮 想 関 数 の 削 除 は 無 効 になっています。
• 読 み 出 し / 書 き 込 みデータ 圧 縮 は 使 用 で き ません。
• スキャッタロードは 使 用 できません。
• __AT セクションは 使 用 できません。
注
スキャッタロードは、 ベースプラッ ト フォームリンクモデルではサポート されてい
ます。
3.7.2 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI)
リンクモデル (3-6 ページ)
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• SysV リンクモデル (3-10 ページ) .
参 照
『リンカリファレンス』:
• --base_platform (2-18 ページ)
• --bpabi (2-24 ページ)
• --dynamic_debug (2-50 ページ)
• --force_so_throw、 --no_force_so_throw (2-73 ページ)
• --runpath=pathlist (2-140 ページ)
• --soname=name (2-153 ページ)
• --symver_script=file (2-169 ページ)
• --symver_soname (2-170 ページ)
• --sysv (2-172 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 3-11
ID 111311
Non-Confidential

第 4 章
イメージの 構 造 と 生 成
以 下 の 各 ト ピ ッ ク では、 イ メ ージの 構 造 と 、 イ メ ージを 生 成 する ために ARM リンカ
armlink で 使 用 で き る 機 能 について 説 明 し ます。
タスク
• コマンド ラインオプショ ンを 使 用 した C++ 例 外 テーブルの 生 成 の 制 御 (4-33 ペー
ジ)
• リンカによる ARM 標 準 ラ イ ブ ラ リ の 検 索 方 法 の 制 御 (4-39 ページ)
• リンク 時 のユーザライブラリの 指 定 (4-41 ページ) .
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セ ク シ ョ ン、 出 力 セ ク シ ョ ン、 領 域 、 およびプ ロ グ ラ ムセグ メ ン ト (4-5 ペー
ジ)
• イ メージのロードビューと 実 行 ビュー (4-6 ページ)
• リンカでイメージのメモリマップを 指 定 する 方 法 (4-8 ページ)
• 単 純 イ メ ージの タ イ プ (4-10 ページ)
• タイプ 1 のイ メージ :1 つの ロー ド 領 域 と 連 続 する 実 行 領 域 (4-12 ページ)
• タイプ 2 のイ メージ :1 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (4-14 ページ)
• タイプ 3 のイ メージ :2 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (4-16 ページ)
• イメージのエントリポイント (4-18 ページ)
• 初 期 エン ト リ ポ イ ン ト の 指 定 について (4-19 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-1
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
• リンカによるセクションの 配 置 (4-20 ページ)
• FIRST 属 性 と LAST 属 性 を 使 用 したセクシ ョ ンの 配 置 (4-22 ページ)
• リ ンカに よ る セ ク シ ョ ンの 境 界 調 整 (4-23 ページ)
• デマン ドページング (4-24 ページ)
• Thumb コー ド を 含 む 実 行 領 域 の 順 序 付 けについて (4-26 ページ)
• ベニアの 概 要 (4-27 ページ)
• ベニアの 共 有 (4-28 ページ)
• ベニアのタ イプ (4-29 ページ)
• 位 置 非 依 存 か ら 絶 対 ベニアへの 生 成 (4-31 ページ)
• スキャッタロード 時 のベニアの 再 利 用 (4-32 ページ)
• 弱 参 照 と 定 義 について (4-35 ページ)
• リ ンカに よ る ラ イ ブ ラ リ の 検 索 、 選 択 、 およびス キ ャ ンの 実 行 方 法 (4-38 ペー
ジ)
• リ ンカに よ る 参 照 の 解 決 方 法 (4-43 ページ)
• リンカにおける 厳 格 なオプションファミリの 使 用 (4-45 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-2
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.1 イ メ ージの 構 造
イ メ ージの 構 造 は 以 下 に よ って 定 義 さ れます。
• イ メ ージを 構 成 する 領 域 と 出 力 セ ク シ ョ ンの 数
• イ メ ージが ロー ド さ れる と き の、 上 記 領 域 と セ ク シ ョ ンの メ モ リ 内 におけ る 位
置
• イ メ ージが 実 行 さ れる と き の、 上 記 領 域 と セ ク シ ョ ンの メ モ リ 内 におけ る 位 置
各 リ ン ク ステージには、 以 下 のさ まざまな イ メ ージのビ ューがあ り ます。
ELF オブジ ェ ク ト フ ァ イルビ ュー ( リ ンカの 入 力 )
ELF オブジェ ク ト フ ァ イルビューは、 入 力 セクシ ョ ンで 構 成 されます。
ELF オブジェク トファイルには、 以 下 のファイルがあります。
• 他 のオブジ ェ ク ト フ ァ イル と リ ン ク し て、 実 行 可 能 フ ァ イルま た
は 共 有 オブジ ェ ク ト フ ァ イルを 作 成 するのに 適 し た コー ド と デー
タ を 保 持 する 再 置 可 能 フ ァ イ ル
• 実 行 に 適 し たプ ロ グ ラ ム を 保 持 する 実 行 可 能 フ ァ イル
• 以 下 の 場 合 に コー ド およびデータ を 保 持 する 共 有 オブジ ェ ク ト
ファイル
— リ ンカが、 他 の 再 配 置 可 能 フ ァ イルおよび 共 有 オブジ ェ ク ト
ファイルを 使 用 してファイルを 処 理 し、 別 のオブジェクト
ファイルを 作 成 する。
— ダイナミックリンカが、 ファイルを 実 行 可 能 ファイルおよび
他 の 共 有 オブジェ ク ト フ ァ イル と 結 合 し て、 プロセス イ メ ー
ジを 作 成 する。
リンカビュー リ ン カには、 オーバーレ イ、 位 置 非 依 存 、 および 再 配 置 可 能 なプ ロ グ
ラム 要 素 (コード またはデータ) の 有 無 が 異 なる、 プログラムのアドレ
ス 空 のビューが 2 つあ り ます。
• プログラム 要 素 のロードアドレスは、 プログラムローダ、 ダイナ
ミックリンカ、デバッガなどの 外 部 エージェントによって ELF
ファイルのプログム 要 素 がコピーされるときに、 そのコピー 先 と
し て 想 定 さ れる ターゲ ッ ト ア ド レ スです。 こ れは、 そのプ ロ グ ラ
ム 要 素 の 実 行 ア ド レ ス と 異 な る 場 合 があ り ます。
• プログラム 要 素 の 実 行 アドレスは、 リ ンカがプログラムの 実 行 に
参 加 する と き にそのプ ロ グ ラ ム 要 素 が 存 在 する と 想 定 さ れる ター
ゲッ トアドレスす。
プ ロ グ ラ ム 要 素 が 位 置 非 依 存 ま たは 再 配 置 可 能 であ る 場 合 、 実 行 ア ド レ
スが 実 行 中 に 変 更 さ れる 可 能 性 があ り ます。
ELF イメージファイルビュー (リンカの 出 力 )
ELF イメージファイルビューは、 プログラムセグメント と 出 力 セクショ
ンで 構 成 さ れます。
• プ ロ グ ラ ムセグ メ ン ト に 対 応 する ロー ド 領 域
• 最 大 で 3 つの 出 力 セ ク シ ョ ンに 対 応 する 実 行 領 域
— RO セクション
— RW セクション
— ZI セクション
ロード 領 域 は、 1 つ 以 上 の 実 行 領 域 で 構 成 さ れます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-3
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
注
armlink では、 プロ グ ラ ムセグ メ ン ト の 最 大 サイズは 2GB です。
メ モ リ ビ ューの 説 明 では、 以 下 の 用 語 に 注 意 し て 下 さ い。
• ルー ト 領 域 と は、 ロー ド ア ド レ ス と 実 行 ア ド レ スが 同 一 の 領 域 を 意 味 し ます。
• ロード 領 域 と ELF セグ メ ン ト は 同 じ ものです。
以 下 の 図 には、 各 リ ン ク ス テージにおけ る ビ ューの 関 係 を 示 し ています。
ELF
ELF
ELF
ELF
ELF
1 ( 1)
1.1
1.2
1.3
2 ( 2)
2.1
...
()
1
1
2
2
...
()
()
1.1.1
1.1.2
...
1.2.1
...
1.3.1
1.3.2
...
2.1.1
2.1.2
2.1.3
...
n
図 4-1 セ ク シ ョ ン、 領 域 、 およびセグ メ ン ト の 関 係
4.1.1 関 連 項 目
タスク
『ARM コンパイラツールチェーンの 概 要 』:
• 64 ビットのリンカへの 変 更 (2-8 ページ) .
概 念
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-4
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.2 入 力 セ ク シ ョ ン、 出 力 セ ク シ ョ ン、 領 域 、 およびプ ログラムセグ メ ン ト
オブジェ ク ト フ ァ イルまたはイ メージフ ァ イルは、 入 力 セクシ ョ ン、 出 力 セクシ ョ
ン、 領 域 、 およびプログラムセグ メ ン ト の 階 層 から 構 成 されてます。
入 力 セ ク シ ョ ン
入 力 セ ク シ ョ ンは、 入 力 オブジ ェ ク ト フ ァ イルの 個 々のセ ク シ ョ ンで
す。 入 力 セ ク シ ョ ンには、 コー ド や 初 期 化 さ れたデータ が 保 持 さ れてい
た り 初 期 化 さ れていない メ モ リ 部 分 やイ メ ージ 実 行 前 にゼ ロ にする 必 要
のあ る メ モ リ 部 分 の 情 報 が 記 述 さ れていた り し ます。 こ れら の 属 性 は、
RO、 RWZI などの 属 性 によって 表 されます。armlink はこれらの 属 性 を 使
用 し て 入 力 セ ク シ ョ ン を グループ 化 し、 出 力 セ ク シ ョ ン ま たは 出 力 領 域
と 呼 ばれる 大 き な 構 成 要 素 を 作 成 し ます。
出 力 セ ク シ ョ ン
出 力 セ ク シ ョ ンは、 同 じ RO、 RW、 ZI 属 性 を 持 つ 入 力 セ ク シ ョ ンのグ
ループで、 リ ンカによってメモリ 内 に 連 続 して 配 置 されます。 出 力 セク
シ ョ ン、 それを 構 成 する 入 力 セ ク シ ョ ン と 同 じ 属 性 を 持 ち ます。 出 力 セ
クションでは、 セクション 配 置 規 則 に 基 づいて 入 力 セクションがソート
されます。
領 域
領 域 は、 異 な る 属 性 を 持 つセ ク シ ョ ン 数 の 内 訳 に 応 じ て 1 ~ 3 個 の 連 続
する 出 力 セ ク シ ョ ンか ら 構 成 さ れます。 領 域 内 の 出 力 セ ク シ ョ ンは、 属
性 ソート されます。 最 初 に RO 出 力 セ ク シ ョ ン、 次 に RW 出 力 セ ク シ ョ
ン、 最 後 に ZI 出 力 セ ク シ ョ ンが 配 置 さ れます。 通 常 、 ROM、 RAM、 ペ
リフェラルなどの 物 理 メモリデバイスにマップされます。
プログラムセグメン ト
プログラムセグメン トはロード 領 域 に 対 応 し、 出 力 セクショ ンで 構 成 さ
れます。 プ ロ グ ラ ムセグ メ ン ト には、 テキ ス ト 、 データ な どの 情 報 が 保
持 れます。
注
armlink では、 プロ グ ラ ムセグ メ ン ト の 最 大 サイズは 2GB です。
4.2.1 関 連 項 目
タスク
『ARM コンパイラツールチェーンの 概 要 』:
• 64 ビットのリンカへの 変 更 (2-8 ページ) .
概 念
• イメージの 構 造 (4-3 ページ)
• リ ンカで イ メ ージの メ モ リ マ ッ プを 指 定 する 方 法 (4-8 ページ)
• リンカによるセクションの 配 置 (4-20 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-5
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.3 イメージのロードビューと 実 行 ビュー
イ メ ージの 領 域 は、 ロード 時 にシステムの メ モ リ マ ッ プ 内 に 配 置 されます。 イ メ ー
ジを 実 行 する には、 その 前 にい く つかの 領 域 を 実 行 ア ド レ スへ 移 動 し、 ZI 属 性 を 持
つ 出 力 セ ク シ ョ ン を 作 成 し なければな ら ない 場 合 があ り ます。 例 えば、 初 期 化 さ れ
た RW データ を、 ROM 内 のロード ア ド レ スから RAM 内 の 実 行 ア ド レ スに コ ピーし
なければな ら ない 場 合 があ り ます。
イメージのメモリマップには、 以 下 の 2 つの 異 な る ビ ューがあ り ます。
ロードビュー
実 行 ビ ュー
このビューは、 イメージがメモリにロードされるときの 各 領 域 と
各 セ ク シ ョ ンのア ド レ ス、 つま り 、 イ メ ージの 実 行 が 開 始 される
前 の 位 置 を 示 し ます。
こ のビ ューは、 イ メ ージの 実 行 中 におけ る 各 領 域 と 各 セ ク シ ョ ン
のアド レスを 示 します。
以 下 の 図 に、 これらのビ ューを 示 し ます。
0x0FFFF
RAM
0x0A000
0x08000
ZI
RW
ROM
RW
0x06000
RO
0x00000
RO
図 4-2 ロード メモリマップと 実 行 メモリマップ
以 下 の 表 では、 ロー ド ビ ュー と 実 行 ビ ューを 比 較 説 明 し ています。
表 4-1 ロードビューと 実 行 ビューの 比 較
ロード
ビュー
説 明 実 行 ビ ュー 説 明
ロードア
ドレス
イ メ ージの 実 行 開 始 前 まで、 その イ
メージ 内 のセクションまたは 領 域 が
ロード されている メモリ 内 のアドレ
ス。 セクシ ョ ンまたは 非 ルート 領 域
のードアドレスは、 実 行 アドレスと
異 なっていても 構 いません。
実 行 ア ド レ
ス
イメージの 実 行 中 に、そのイメージ 内
のセ ク シ ョ ン ま たは 領 域 が 位 置 する ア
ドレス。
ロード 領
域
ロー ド ア ド レ ス 空 間 内 の 領 域 実 行 領 域 実 行 ア ド レ ス 空 間 内 の 領 域
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-6
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.3.1 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• リ ンカで イ メ ージの メ モ リ マ ッ プを 指 定 する 方 法 (4-8 ページ)
• リンカによるセクションの 配 置 (4-20 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-7
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.4 リ ン カ で イ メ ージの メ モ リ マ ッ プ を 指 定 する 方 法
1 つの イ メ ージを 構 成 する 領 域 の 数 と 出 力 セ ク シ ョ ンの 数 に 制 限 はあ り ません。 領 域
には、 異 なるロードアドレスと 実 行 アドレスを 割 り 当 てることができます。 イメー
ジの メ モ リ マ ッ プを 作 成 する には、 以 下 に 関 する 情 報 を armlink に 渡 す 必 要 があ り ま
す。
• 入 力 セ ク シ ョ ン を 出 力 セ ク シ ョ ン と 領 域 にグループ 化 する 方 法
• メ モ リ マ ッ プ 内 における 領 域 の 位 置
イ メ ージの メ モ リ マ ッ プの 複 雑 度 に 応 じ て、 こ の 情 報 は 以 下 の 2 つの 方 法 で armlink
に 渡 すこ と ができ ます。
コマンド ラインオプショ ンの 使 用
イ メ ージ 内 のロード 領 域 が 1 つか 2 つで、 実 行 領 域 が 最 高 でも 3 つしか
ない よ う な 単 純 な 場 合 は、 以 下 のオプシ ョ ン を 使 用 で き ます。
• --first
• --last
• --ro_base
• --rw_base
• --ropi
• --rwpi
• --split
• --rosplit
• --zi_base
単 純 イ メ ージについては、 こ れら のオプシ ョ ン を 使 用 し た 簡 単 な 表 記 に
よ っ て、 ス キ ャ ッ タ ロー ド 記 述 と 同 じ 設 定 が 可 能 です。
スキャッタファイルの 使 用
スキャッタファイルは、 メモリ レイアウ トおよびコード とデータの 配 置
を 記 述 したテキストです。 イメージコンポーネントのグループ 化 と 位 置
を 密 に 制 御 する 必 要 があ る 複 雑 な 場 合 に、 スキ ャ ッ タ フ ァ イルを 使 用 し
ます。 ス キ ャ ッ タ フ ァ イルを 使 用 する には、 コ マン ド ラ イ ンで
--scatter=filename と 指 定 します。
注
--scatter は、 他 の メ モ リ マ ッ プ 関 連 の コ マン ド ラ イ ンオプシ ョ ン と 共 に 使 用 する こ
とはできません。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-8
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
表 4-2 スキャ ッ タ フ ァ イルおよび 対 応 する コ マン ド ラ イ ンオプシ ョ ンの 比 較
スキャ ッ タ フ ァ イル
LR1 0x0000 0x20000
{
ER1 0x0 0x2000
{
init.o (INIT, +FIRST)
*(+RO)
}
RAM 0x400000
{
*(+RW)
}
RAM 0x405000
{
*(+ZI)
}
}
対 応 するコマン ド ラインオプシ ョ ン
--ro_base=0x0
--first=init.o(init)
--rw_base=0x400000
--zi_base=0x405000
4.4.1 関 連 項 目
タスク
• 第 8 章 スキャッタファイルの 使 用 .
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ)
• 単 純 イ メ ージの タ イ プ (4-10 ページ) .
参 照
『リンカリファレンス』:
• --first=section_id (2-71 ページ)
• --last=section_id (2-94 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• --scatter=file (2-144 ページ)
• --split (2-156 ページ)
• --zi_base=address (2-197 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-9
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.5 単 純 イ メ ージのタ イ プ
単 純 イ メ ージは、 RO、 RW、 および ZI の 属 性 を 持 つ 数 多 く の 入 力 セ ク シ ョ ンか ら 構
成 さ れます。 こ れら の 入 力 セ ク シ ョ ンが 照 合 さ れる こ と に よ り 、 RO、 RW、 および
ZI の 各 出 力 セ ク シ ョ ンが 形 成 さ れます。 ロー ド 領 域 と 実 行 領 域 におけ る 出 力 セ ク
シ ョ ンの 配 置 に よ り 、 単 純 イ メ ージは 以 下 の 3 つの 本 タ イプに 分 類 されます。
タイプ 1
タイプ 2
タイプ 3
ロードビューには 1 つの 領 域 、 実 行 ビ ューには 連 続 する 3 つの 領 域 が 存
在 し ます。 こ の タ イ プの イ メ ージを 作 成 する 場 合 は、 --ro_base オプシ ョ
ン を 使 用 し ます。
ロードビューには 1 つの 領 域 、 実 行 ビ ューには 連 続 し ない 3 つの 領 域 が
存 在 し ます。 こ の タ イ プの イ メ ージを 作 成 する 場 合 は、 --ro_base オプ
ションおよび --rw_base オプシ ョ ン を 使 用 し ます。
ロードビューには 2 つの 領 域 、 実 行 ビ ューには 連 続 し ない 3 つの 領 域 が
存 在 し ます。 こ の タ イ プの イ メ ージを 作 成 する 場 合 は、 --ro_base オプ
ション、--rw_base オプシ ョ ン、 および --split オプシ ョ ンを 使 用 し ます。
どの タ イ プの 単 純 イ メ ージで も 、 以 下 の 構 成 にな り ます。
• 最 初 の 実 行 領 域 には RO 出 力 セ ク シ ョ ンが 含 まれます。
• 2 番 目 の 実 行 領 域 には RW 出 力 セ ク シ ョ ンが 含 まれます ( 存 在 する 場 合 )。
• 3 番 目 の 実 行 領 域 には ZI 出 力 セ ク シ ョ ンが 含 まれます ( 存 在 する 場 合 )。
こ れら の 実 行 領 域 は、 それぞれ RO 実 行 領 域 、 RW 実 行 領 域 、 ZI 実 行 領 域 と 呼 ばれま
す。
ただし、 タ イプ 3 のイ メージでは、--rosplit オプシ ョ ンを 使 用 する こ と もでき ます。
このオプシ ョ ンは、 デフォル ト のロード 領 域 を、 コードに 1 つ、 データ に 1 つ、 合 計
2 つの RO 出 力 セ ク シ ョ ンに 分 割 し ます。
また、 タイプ 1 とタイプ 2 のイ メージでは、--zi_base コマンド ラインオプショ ンを 使
用 して、 ZI 実 行 領 域 のベース ア ド レ ス を 指 定 で き ます。 タ イ プ 3 のイ メージに 必 要
な --split コ マン ド ラ イ ンオプシ ョ ン も 使 用 し た 場 合 、 こ のオプシ ョ ンは 無 視 さ れま
す。
単 純 イ メ ージはス キ ャ ッ タ フ ァ イルを 使 用 し て 作 成 する こ と も で き ます。
4.5.1 関 連 項 目
概 念
• タイプ 1 のイ メージ :1 つの ロー ド 領 域 と 連 続 する 実 行 領 域 (4-12 ページ)
• タイプ 2 のイ メージ :1 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (4-14 ページ)
• タイプ 3 のイ メージ :2 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (4-16 ページ)
• 等 価 な ス キ ャ ッ タ ロー ド 記 述 を 使 用 し た 単 純 イ メ ージの 生 成 (8-65 ページ) .
参 照
『リンカリファレンス』:
• --ro_base=address (2-137 ページ)
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --scatter=file (2-144 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-10
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
• --split (2-156 ページ)
• --zi_base=address (2-197 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-11
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.6 タイプ 1 のイ メージ : 1 つのロー ド 領 域 と 連 続 する 実 行 領 域
タイプ 1 のイ メージは、 ロードビュー 内 の 1 つのロード 領 域 と メ モ リ マ ッ プ 内 で 連 続
して 配 置 されている 3 つの 実 行 領 域 か ら 構 成 さ れます。 こ の 手 法 は、 OS のブー ト
ローダやデスク ト ップシステムなど、 RAM にプログラ ムを ロードするシステムに 適
しています。
ZI
ZI
RAM
RW
RW
RW
--ro-base
RO
0x8000
RO
RO
0x0000
こ の タ イ プの イ メ ージを 作 成 する には 以 下 の コ マン ド を 使 用 し ます。
armlink --ro_base 0x8000
図 4-3 単 純 タ イ プ 1 のイ メージ
注
0x8000 はデフ ォル ト のア ド レ スであ る ため、 こ の 場 合 は --ro_base を 指 定 しな く ても
かまいません。
4.6.1 ロードビュー
単 一 の ロー ド 領 域 は、 連 続 し て 配 置 さ れた RO 出 力 セ ク シ ョ ンおよび RW 出 力 セ ク
ションから 構 成 されます。RO 実 行 領 域 と RW 実 行 領 域 はど ち ら も ル ト 領 域 と な り ま
す。 ロー ド 時 には ZI 出 力 セ ク シ ョ ンは 存 在 し ません。 ZI 出 力 セ ク シ ョ ンは、 実 行 前
にイ メ ージフ ァ イル 内 の 出 力 セ ク シ ョ ンの 記 を 使 用 し て 作 成 されます。
4.6.2 実 行 ビ ュー
RO、 RW、 および ZI の 各 出 力 セ ク シ ョ ンを 含 む 3 つの 実 行 領 域 は、 連 続 し て 配 置 さ
れます。 RO 実 行 領 域 と RW 実 行 領 域 の 実 行 ア ド レ スはロー ド ア ド レ と 同 じ であ る た
め、 ロードアドレスから 実 行 アドレスに 移 動 する 必 要 があるものはあり ません。 た
だし、 ZI 出 力 セ ク シ ョ ン を 含 む ZI 実 行 領 域 は 実 行 時 に 作 成 さ れます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-12
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
RO 出 力 を 含 む 領 域 の ロー ド ア ド レ ス と 実 行 ア ド レ ス を 指 定 する には、 armlink オプ
ション --ro_base address を 使 用 します。 デフォル ト のア ド レスは 0x8000 です。
ZI 実 行 領 域 のベース ア ド レ ス を 指 定 する には、 --zi_base コマンド ラインオプショ ン
を 使 用 し ます。
4.6.3 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ) .
参 照
『リンカリファレンス』:
• --ro_base=address (2-137 ページ)
• --zi_base=address (2-197 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-13
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.7 タイプ 2 のイ メージ : 1 つのロー ド 領 域 と 連 続 し ない 実 行 領 域
タイプ 2 のイ メージは、 1 つのロード 領 域 と、 実 行 ビ ュー 内 の 3 つの 実 行 領 域 か ら 構
成 されます。 RW 実 行 領 域 と RO 実 行 領 域 は 隣 接 し ていません。 こ の 方 法 は、 RW
データ が 起 動 時 に ROM から RAM にコピーされる、ROM ベースの 組 み 込 みシ ス テム
などに 使 用 されます。
RAM
ZI
ZI
0xA000
RW
RW
--rw-base
/
RW
ROM
RO
RO
RO
0x0000
--ro-base
こ の タ イ プの イ メ ージを 作 成 する には 以 下 の コ マン ド を 使 用 し ます。
armlink --ro_base 0x0 --rw_base 0xA000
図 4-4 単 純 タ イ プ 2 のイ メージ
4.7.1 ロードビュー
ロードビューでは、 ROM などに 連 続 して 配 置 された RO 出 力 セ ク シ ョ ンおよび RW
出 力 セ ク シ ョ ンに よ って 1 つのロー ド 領 域 が 構 成 されます。 こ の 場 合 、 RO 領 域 は
ルー ト 領 域 と な り ますが、 RW 領 域 はルー ト 領 域 ではあ り ません。 ロー ド 時 には ZI
出 力 セ ク シ ョ ンは 存 在 し ません。 ZI 出 力 セ ク シ ョ ン 実 行 時 に 作 成 さ れます。
4.7.2 実 行 ビ ュー
実 行 ビ ューでは、 最 初 の 実 行 領 域 に RO 出 力 セ ク シ ョ ンが、 2 番 目 の 実 行 領 域 に RW
出 力 セ ク シ ョ ン と ZI 出 力 セ ク シ ョ ンが 含 まれます。
RO 出 力 セ ク シ ョ ン を 含 む 領 域 の 実 行 ア ド レ ス と ロー ド ア ド レ スは 同 じ であ る ため、
RO 出 力 セ ク シ ョ ン を 移 動 する 必 要 はあ り ません。 つま り 、 こ の ク シ ョ ンはルー ト 領
域 にな り ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-14
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
RW 出 力 セ ク シ ョ ン を 含 む 領 域 の 実 行 ア ド レ ス と ロー ド ア ド レ スは 異 な る ため、 RW
出 力 セクシ ョ ンはロードアドレスから 実 行 アドレスに ( 単 一 ロー 領 域 から 2 番 目 の
実 行 領 域 に) 移 動 さ れます。 ZI 実 行 領 域 と その 出 力 セ ク シ ョ ンは、 RW 実 行 領 域 と
隣 接 し て 配 置 さ れます。
RO 出 力 セクシ ョ ンのロードアドレスおよび 実 行 アドレスを 指 定 するには、 armlink オ
プシ ョ ン --ro_base address を 使 用 し ます。 また、 RW 出 力 セ ク シ ョ ンの 実 行 ア ド レ ス
を 指 定 する には、 --rw_base exec_address を 使 用 し ます。 --ro_base オプシ ョ ンでア ド レ
スが 指 定 さ れていない 場 合 、 armlink はデフ ォル ト 値 0x8000 を 使 用 し ます。 組 み 込 み
システムの 場 合 、--ro_base の 値 には 0x0 を 指 定 するのが 一 般 的 です。 --rw_base オプ
ションでアドレスが 指 定 されていない 場 合 、 通 常 は、RW 出 力 セ ク シ ョ ンが RO 出 力
セクションのすぐ 上 に 配 置 されます (タイプ 1 の イ メ ージ 同 様 )。
ZI 実 行 領 域 のベース ア ド レ ス を 指 定 する には、 --zi_base コマンド ラインオプショ ン
を 使 用 し ます。
注
RW 出 力 セ ク シ ョ ン と ZI 出 力 セ ク シ ョ ンの 実 行 領 域 は、 ロー ド 領 域 のどの 部 分 と も
重 ねる こ と はで き ません。
4.7.3 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ)
• タイプ 1 のイ メージ :1 つの ロー ド 領 域 と 連 続 する 実 行 領 域 (4-12 ページ) .
参 照
『リンカリファレンス』:
• --ro_base=address (2-137 ページ)
• --rw_base=address (2-141 ページ)
• --zi_base=address (2-197 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-15
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.8 タイプ 3 のイ メージ : 2 つのロー ド 領 域 と 連 続 し ない 実 行 領 域
タイプ 3 のイ メージはタイプ 2 のイ メージと 似 ていますが、 このイ メージでは 1 つの
ロード 領 域 が 2 つのルー ト ロード 領 域 に 分 割 されます。
ZI
ZI
--rw-base
RAM
RW
2
0xE000
RW
RW
--ro-base
RO
0x8000
0x0000
RO
RO
こ の タ イ プの イ メ ージを 作 成 する には 以 下 の コ マン ド を 使 用 し ます。
armlink --split --ro_base 0x8000 --rw_base 0xE000
図 4-5 単 純 タ イ プ 3 のイ メージ
4.8.1 ロードビュー
ロード ビ ューでは、 最 初 のロード 領 域 が RO 出 力 セ ク シ ョ ンで 構 成 さ れ、 2 番 目 の
ロード 領 域 が RW 出 力 セ ク シ ョ ンで 構 成 さ れます。 ロー ド 時 には ZI 出 力 セ ク シ ョ ン
は 存 在 し ません。 ZI 出 力 セ ク シ ョ ンは、 実 行 前 に イ メ ージ フ ァ イ ル 内 の 出 力 セ ク
シ ョ ンの 記 述 を 使 用 し て 作 成 さ れます。
4.8.2 実 行 ビ ュー
実 行 ビ ューでは、 最 初 の 実 行 領 域 に RO 出 力 セ ク シ ョ ンが、 2 番 目 の 実 行 領 域 に RW
出 力 セ ク シ ョ ン と ZI 出 力 セ ク シ ョ ンが 含 まれます。
RO 領 域 の 実 行 ア ド レ スは ロー ド ア ド レ ス と 同 じ であ る ため、 RO 出 力 セ ク シ ョ ンの
内 容 を ロー ド ア ド レ スか ら 実 行 ア ド レ スに 移 動 ま たはコ ピーする 要 はあ り ません。
RO 領 域 と RW 領 域 はど ち ら も ルー ト 領 域 と な り ます。
また、 RW 領 域 の 実 行 ア ド レ ス も ロー ド ア ド レ ス と 同 じ であ る ため、 RW 出 力 セ ク
シ ョ ンの 内 容 はロー ド ア ド レ スか ら 実 行 ア ド レ スに 移 動 さ れませんただ し、 ZI 出 力
セ ク シ ョ ンは 実 行 時 に 作 成 さ れ、 RW 領 域 と 隣 接 し て 配 置 さ れます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-16
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
ロー ド ア ド レ ス と 実 行 ア ド レ スは、 以 下 の リ ン カオプシ ョ ン を 使 用 し て 指 定 し ます。
--split
RO 出 力 セ ク シ ョ ンおよび RW 出 力 セ ク シ ョ ン を 含 むデフ ォル ト の 1 つ
の ロー ド 領 域 が、 以 下 の 2 つのルー ト ロー ド 領 域 に 分 割 さ れます。
• RO 出 力 セ ク シ ョ ン を 含 む 領 域
• RW 出 力 セ ク シ ョ ン を 含 む 領 域
これらの 領 域 は、--ro_base および --rw_base を 使 用 して 別 々に 配 置 でき
ます。
--ro_base address
--rw_base address
RO セ ク シ ョ ン を 含 む 領 域 の ロー ド ア ド レ ス と 実 行 ア ド レ スに、 4 バイ
ト 境 界 で 整 列 された address ( 例 えば、 ROM の 最 初 の 場 所 のア ド レ ス)
を 設 定 する よ う に armlink に 指 示 し ます。 --ro_base オプシ ョ ンでア ド レ
スが 指 定 されていない 場 合 、 armlink はデフ ォル ト 値 0x8000 を 使 用 し ま
す。
RW 出 力 セ ク シ ョ ン を 含 む 領 域 の 実 行 ア ド レ スに、 4 バイ ト 境 界 で 整 列
された address を 設 定 する よ う に armlink に 指 示 し ます。 --split と 共 にこ
のオプシ ョ ン を 使 用 する と 、 RW 領 域 (ルー ト 領 域 など) の ロー ド ア ド
レスと 実 行 アドレスの 両 方 が 指 定 されます。
4.8.3 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セ ク シ ョ ン、 出 力 セ ク シ ョ ン、 領 域 、 およびプ ロ グ ラ ムセグ メ ン ト
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ)
• タイプ 2 のイ メージ :1 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (4-14 ページ) .
参 照
『リンカリファレンス』:
• --ro_base=address (2-137 ページ)
• --rw_base=address (2-141 ページ)
• --split (2-156 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-17
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.9 イメージのエントリポイント
4.9.1 関 連 項 目
イ メ ージ 内 のエン ト リ ポ イ ン ト は、 プ ロ グ ラ ムの 実 行 開 始 位 置 です。 エン ト リ ポ イ
ントには 以 下 の 2 つの 種 類 があ り ます。
初 期 エン ト リ ポ イ ン ト
イメージの 初 期 エン ト リ ポ イ ン ト は 1 つの 値 で 表 され、 ELF ヘッダファ
イルに 格 納 されています。 オペレーティングシステムまたはブート ロー
ダによって RAM にロード されるプログムの 場 合 、 ローダはイ メージ 内
の 初 期 エン ト リ ポイ ン ト に 制 御 を 渡 すこ と によ って、 イ メ ージの 実 行 を
開 始 し ます。
1 つのイ メ ージ 内 で 使 用 でき る 初 期 エン ト リ ポイ ン ト は 1 つだけです。
初 期 エン ト リ ポ イ ン ト と し て、 ENTRY ディレクティブによって 設 定 され
たエン ト リ ポイン ト の 1 つを 使 用 で き ますが、 必 ずし も そ う する 必 要 は
ありません。
ENTRY ディレクティブによって 設 定 されたエント リポイント
イメージにはエント リポイントに 設 定 できる 箇 所 は 数 多 くありますが、
そこから 1 つを 選 択 し ます。 1 つのイ メ ージ 内 で 使 用 でき るエン ト リ ポ
イントは 1 つだけです。
アセンブラファ イルで ENTRY デ ィ レ ク テ ィ ブを 使 用 し て、 オブジ ェ ク ト
内 にエントリポイントを 作 成 します。 組 み 込 みシステムの 場 合 、 一 般 的
に、 こ のデ ィ レ ク テ ィ ブはプ ロ セ ッ サ 例 外 ベ ク タ (RESET、 IRQ、 FIQ
など) 経 由 で 開 始 されるコードをマークするために 使 用 されます。
このディレクティブでは、ENTRY キーワー ド を 使 用 し て、 リ ン カに よ っ
て 未 使 用 セクションが 削 除 されるときに 残 しておく 出 力 コードセクショ
ンをマークするこ とによ り、 そのセクショ ンを 残 しておく こ とができま
す。
C や C++ で 記 述 さ れたプ ロ グ ラ ムの 場 合 、 C ライブラリの __main() 関 数
もエン ト リポイント となります。
組 み 込 みイメージがローダによって 使 用 される 場 合 には、 そのイメージ
のヘッ ダ 内 に 1 つの 初 期 エン ト リ ポ イ ン ト が 指 定 さ れてい る 必 要 があ り
ます。 エン ト リ ポ イ ン ト を 選 択 する には、 --entry コマンドラインオプ
ションを 使 用 します。
タスク
• 初 期 エン ト リ ポ イ ン ト の 指 定 について (4-19 ページ) .
参 照
『リンカリファレンス』:
• --entry=location (2-58 ページ) .
『アセンブラ リ フ ァ レンス』 :
• ENTRY (6-78 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-18
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.10 初 期 エン ト リ ポイ ン ト の 指 定 について
プログラムには 少 なく と も 1 つの 初 期 エン ト リ ポ イ ン ト を 指 定 する 必 要 があ り ます。
指 定 し ない と 、 リ ン カに よ って 警 告 が 生 成 さ れます。 ま た、 べての ソース フ ァ イル
内 にエン ト リ ポ イ ン ト を 指 定 する 必 要 があ るわけではあ り ません。 1 つのソース フ ァ
イル 内 に 複 数 のエン ト リ ポ イ ン ト を 指 定 する こ と はで き ません。
アドレスのゼロに ROM が 配 置 される 組 み 込 みアプ リ ケーシ ョ ンの 場 合 には、--entry
0x0 を 使 用 します (または 上 位 ベク タを 使 用 する CPU では、 オプシ ョ ン と して
0xFFFF0000 を 使 用 し ます)。
初 期 エン ト リ ポ イ ン ト は、 以 下 の 条 件 を 満 た し てい る 必 要 があ り ます。
• イ メ ージのエン ト リ ポ イ ン ト が 常 に 実 行 領 域 内 に 存 在 し てい る こ と
• 実 行 領 域 が 他 の 実 行 領 域 のオーバーレ イ を 行 っておらず、 ルー ト 実 行 領 域 であ
る (ロードアドレスと 実 行 アドレスが 同 じである) こ と
--entry オプシ ョ ン を 使 用 せずに 初 期 エン ト リ ポ イ ン ト を 指 定 する 場 合 は、 以 下 の よ
うになります。
• 入 力 オブジ ェ ク ト に、 ENTRY ディレクティブによって 設 定 された 1 つのエン ト リ
ポイント しか 含 まれていない 場 合 には、 リンカはそのエント リポイントをイ
メージの 初 期 エント リポイント として 使 用 します。
• リ ンカは 以 下 のいずれかの 場 合 に、 初 期 エン ト リ ポ イ ン ト が 含 まれていない イ
メ ージを 生 成 し ます。
— ENTRY ディレクティブによって 複 数 のエント リポイントが 指 定 されている
場 合
— ENTRY ディレクティブによって 指 定 されているエント リポイントが 存 在 し
ない 場 合
4.10.1 関 連 項 目
概 念
• ルー ト 領 域 と は (8-13 ページ) .
参 照
『リンカリファレンス』:
• --entry=location (2-58 ページ) .
『アセンブラ リ フ ァ レンス』 :
• ENTRY (6-78 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-19
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.11 リ ン カによ るセ ク シ ョ ンの 配 置
デフ ォル ト では、 イ メ ージ を 生 成 する と き、 リ ン カは 以 下 の 順 序 で 入 力 セ ク シ ョ ン
を 配 置 し ます。
1. 属 性 ( 以 下 の 順 序 )
a. 読 み 出 し 専 用 コー ド
b. 読 み 出 し 専 用 データ
c. 読 み 出 し - 書 き 込 みコード
d. 読 み 出 し - 書 き 込 みデータ
e. ゼロで 初 期 化 されたデータ
2. 入 力 セ ク シ ョ ンの 名 前 ( 属 性 が 同 じ 場 合 )。 名 前 は 大 文 字 と 小 文 字 が 区 別 さ れ、
ASCII 文 字 照 合 シーケン ス を 使 用 し てアルフ ァベ ッ ト 順 で 比 較 さ れれます。
3. 入 力 フ ァ イ ル 内 におけ る 各 セ ク シ ョ ンの 相 対 位 置 (FIRST または LAST によって
オーバーラ イ ド さ れてい る 場 合 を 除 き、 属 性 と セ ク シ ョ ン 名 が 同 じ 場 合 )
イ メ ージ 部 分 は、 数 を 最 小 限 に 抑 えた 連 続 領 域 にま と め られます。
注
このソート 順 序 は、 スキャッタファイル 内 またはオブジェク ト ファイル 名 での 順 序
付 けの 影 響 は 受 けません。
し たがって、 ラ イ ブ ラ リ か ら イ ン ク ルー ド さ れる、 同 じ 属 性 と 名 前 を 持 つ 入 力 セ ク
シ ョ ンの 位 置 は 予 測 不 能 です。 厳 密 な 位 置 設 定 を 行 う 必 要 があ 場 合 には、 ス キ ャ ッ
タファイルで 個 別 のモジュールを 明 示 的 に 指 定 して、armlink コマンドの 入 力 ファイ
ル リ ス ト にそのモジ ュールを 組 み 込 みます。
各 入 力 セ ク シ ョ ンのベース ア ド レ スは、 リ ン カに よ っ て 定 義 さ れる ソ ー ト 順 序 に
よ って 決 定 され、 それを 含 む 出 力 セ ク シ ョ ン 内 でも 正 し く 整 列 でき ます。
デフ ォル ト では、 リ ンカによ って 作 成 される イ メ ージは、 RO 出 力 セ ク シ ョ ン と RW
出 力 セクション (オプションで ZI 出 力 セ ク シ ョ ン) か ら 構 成 で き ます。 メ モ リ マ
ネージ メ ン ト ハード ウ ェアを 搭 載 したシステムでは、 実 行 時 に RO 出 力 セ ク シ ョ ン を
保 護 で き ます。 ま た、 RO セクションはターゲッ トの ROM に 配 置 する こ と も 可 能 で
す。
--sort=algorithm コ マン ド ラ イ ンオプシ ョ ン を 使 用 する と 、 他 の ソー ト 順 序 を 使 用 で
き ます。 アルゴ リ ズムが 選 択 さ れていない 場 合 は、 生 成 さ れるベニアの 数 を 最 小 限
に 抑 え る ために、 リ ンカによ って algorithm が 変 更 される こ と があ り ます。
4.11.1 未 割 り 当 てセ ク シ ョ ンの 処 理
リ ン カが、 入 力 セ ク シ ョ ン を 実 行 領 域 に 配 置 で き ない 場 合 があ り ます。 こ の 場 合 は、
リ ンカによってエラーメ ッセージが 生 成 されます。 これは、 定 されるモジュール 選
択 パ ターン と 入 力 セ ク シ ョ ンセレ ク タ の う ち 一 部 が、 現 在 のス キ ャ ッ タ フ ァ イ ルで
許 可 されていないために 起 こ り ます。 題 の 解 決 法 は、 これらのセクショ ンを 正 し く
配 置 する こ と の 重 要 度 に よ って 異 な り ます。
• セ ク シ ョ ン を 特 定 の 場 所 に 配 置 する 必 要 があ る 場 合 は、 特 定 のモジ ュールセレ
ク タおよび 入 力 セ ク シ ョ ンセレ ク タ を 必 要 に 応 じ て 含 め る よ う にス ャ ッ タ フ ァ
イルを 変 更 します。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-20
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
• 未 割 り 当 てセ ク シ ョ ンの 配 置 が 重 要 でない 場 合 は、 1 つま たは 複 数 の .ANY モ
ジュールセレクタを、オプションの 入 力 セクションセレクタと 併 せて 使 用 しま
す。
リンカは、 入 力 オブジェクト 内 の 各 ELF セ ク シ ョ ンの 入 力 セ ク シ ョ ン を 作 成 する 際 、
グローバルカウンタをインク リ メント します。 このカウンタ 値 は、 対 応 するセク
シ ョ ンに 作 成 イ ンデ ッ ク ス と し て 格 納 さ れます。 同 一 のプ ロパテ ィ を 持 った 未 割 り
当 てセ ク シ ョ ン を 配 置 する 際 は、 こ の 作 成 イ ンデ ッ ク スが 使 用 さ れます。
4.11.2 例
以 下 のス キ ャ ッ タ フ ァ イルには、 リ ンカに よ る セ ク シ ョ ンの 配 置 方 法 を 示 し ていま
す。
LoadRegion 0x8000
{
ExecRegion1 0x0000 0x4000
{
*(sections)
*(moresections)
}
ExecRegion2 0x4000 0x2000
{
*(evenmoresections)
}
}
ロー ド 領 域 内 の 実 行 領 域 の 順 序 が リ ンカに よ って 変 更 さ れる こ と はあ り ません。
4.11.3 関 連 項 目
タスク
• FIRST 属 性 と LAST 属 性 を 使 用 したセクシ ョ ンの 配 置 (4-22 ページ)
• 特 定 ア ド レ スへの 関 数 と データ の 配 置 (8-18 ページ)
• ス キ ャ ッ タ ロー ド を 使 用 し た 名 前 付 き セ ク シ ョ ンの 明 示 的 な 配 置 (8-23 ペー
ジ)
• .ANY モジュールセレ ク タによ る 未 割 り 当 てセクシ ョ ンの 配 置 (8-25 ページ) .
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ)
• Thumb コー ド を 含 む 実 行 領 域 の 順 序 付 けについて (4-26 ページ)
• ベニアの 概 要 (4-27 ページ)
• リ ンカに よ る セ ク シ ョ ンの 境 界 調 整 (4-23 ページ) .
参 照
『リンカリファレンス』:
• --sort=algorithm (2-154 ページ)
• 入 力 セ ク シ ョ ン 記 述 の 構 文 (4-24 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-21
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.12 FIRST 属 性 と LAST 属 性 を 使 用 し たセ ク シ ョ ンの 配 置
実 行 領 域 の 最 初 ま たは 最 後 にセ ク シ ョ ン を 確 実 に 配 置 で き ます。 例 えば、 ベ ク タ
テーブルが 含 まれてい る セ ク シ ョ ン を イ メ ージの 最 初 に 配 置 する 要 があ る 場 合 があ
り ます。 そのためには、 以 下 のいずれかの 方 法 を 使 用 し ます。
• スキャッタロードを 使 用 しない 場 合 には、 リンカコマンドラインオプション
--first および --last を 使 用 して 入 力 セクシ ョ ンを 配 置 します。
• スキ ャ ッ タ ロード を 使 用 する と き、 配 置 順 序 が 重 要 な 場 合 には、 フ ァ イル 内 で
属 性 FIRST および LAST を 使 用 し、 実 行 領 域 内 の 最 初 と 最 後 の 入 力 セ ク シ ョ ン を
マーク し ます。
ただし、 FIRST および LAST 属 性 の 用 法 は、 基 本 属 性 ソー ト 順 序 に 違 反 し ない よ う
にする 必 要 があ り ます。 例 えば、 FIRST RW は 読 み 出 し 専 用 コー ド または 読 み 出 し
専 用 データ の 後 に 配 置 し ます。
4.12.1 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ)
• リンカによるセクションの 配 置 (4-20 ページ)
• スキャッタロードについて (8-3 ページ) .
参 照
『リンカリファレンス』:
• --first=section_id (2-71 ページ)
• --last=section_id (2-94 ページ)
• 入 力 セ ク シ ョ ン 記 述 の 構 文 (4-24 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-22
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.13 リ ン カによ るセ ク シ ョ ンの 境 界 調 整
入 力 セ ク シ ョ ンの 順 序 付 けが 行 われた 後 、 armlink はベース ア ド レ スが 固 定 される 前
に 必 要 に 応 じてパディ ングを 挿 入 し、 各 入 力 セクシ ョ ンをその 境 界 調 整 の 倍 数 にな
るアドレスから 開 始 させます。
リ ン カでは、 入 力 セ ク シ ョ ンの 最 大 の 境 界 調 整 に 関 係 な く 、 ELF プログラムのヘッ
ダおよび 出 力 セク シ ョ ンを 4 バイ ト 境 界 で 整 列 させるこ とができます。 これによ り、
armlink は、 イ メ ージに 挿 入 するパデ ィ ングを 最 小 限 に 抑 え る こ と がで き ます。
ELF の 仕 様 に 厳 密 に 適 合 する 必 要 があ る 場 合 は、 --no_legacyalign オプシ ョ ンを 使 用
し ます。 領 域 のベース ア ド レ スが 整 列 さ れていない 場 合 は リ ンカに よ り エ ラーが 発
生 する ため、 ELF の 仕 様 に 準 拠 する ためにパ ィ ングが 挿 入 さ れる こ と があ り ます。
--no_legacyalign が 使 用 さ れてい る 場 合 、 領 域 の 境 界 整 列 はその 領 域 に 含 まれてい る
入 力 セ ク シ ョ ンの 最 大 長 の 境 界 で 整 列 さ れます。
スキャッタロードを 使 用 する 場 合 は、ALIGN 属 性 を 使 用 し て、 ロー ド 領 域 ま たは 実 行
領 域 のア ラ イ ン メ ン ト を 増 やす こ と がで き ます。 例 えば、 通 常 は 4 バイ ト 境 界 で 整
列 さ れる 実 行 領 域 を 8 バイ ト 境 界 で 整 列 させる こ と ができ ます。 ただし、 自 然 のア
ラ イ ン メ ン ト を 縮 小 する こ と はで き ません。 例 えば、 通 常 は 4 バイ ト 境 界 で 整 列 さ
れ 領 域 を 2 バイ ト 境 界 で 整 列 させるこ とはできません。
4.13.1 関 連 項 目
タスク
• ページ 境 界 での 領 域 の 作 成 について (8-59 ページ) .
参 照
『リンカリファレンス』:
• --legacyalign、 --no_legacyalign (2-96 ページ)
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
• ロー ド 領 域 に 厳 密 に 配 置 し た 状 態 で、 実 行 領 域 でベース ア ド レ スに 合 わせる 例
(4-45 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-23
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.14 デマン ドページング
仮 想 メ モ リ をサポー ト する オペレーテ ィ ン グシ ス テムでは、 ELF ファイルをファイ
ルのロード 処 理 を 行 う ア ド レ ス 空 間 にマ ッ プする こ と で、 ELF ファイルをロードで
き ます。 フ ァ イルにマ ッ プ さ れてい るページ 内 の 仮 想 ア ド レ スにア ク セスする と 、
オペレーテ ィ ングシステムによ って、 そのページがデ ィ ス ク から ロード されます。
こ の 方 法 で 使 用 する ELF フ ァ イルは、 特 定 の 形 式 に 準 拠 し てい る 必 要 があ り ます。
デマン ドページングモード を 有 効 にするには、 --paged コマンド ラインオプショ ンを
使 用 し ます。 こ れに よ り 、 効 率 的 にデマン ド ページン グ を 行 う こ と がで き る ELF
ファイルが 生 成 されます。
注
--sysv オプシ ョ ンで 生 成 された ELF フ ァ イルは、 既 にデマン ド ページングに 準 拠 し
ています。 --arm_linux を 使 用 しても、 --sysv を 指 定 したこ とにな り ます。
ELF フ ァ イルの 基 本 的 な 制 約 を 以 下 に 示 し ます。
• 出 力 セ ク シ ョ ンの ロー ド ア ド レ ス と 実 行 ア ド レ スに 違 いがない。
• すべての PT_LOAD プログラムヘッダには、 オペレーティングシステムのペー
ジサ イ ズの 最 小 境 界 整 列 pt_align が 存 在 する。
• すべての PT_LOAD プログラムヘッダには、pt_align を 法 (モジュ ロ) と して 仮
想 ア ド レス (pt_addr) と 合 同 であるファイルオフセッ ト pt_offset が 存 在 する。
--paged をオンにする と、 以 下 のよ うにな り ます。
• リ ンカに よ って、 実 行 領 域 のベース ア ド レ スか ら プ ロ グ ラ ムヘ ッ ダが 自 動 的 に
生 成 さ れる。 1 つのロー ド 領 域 に 1 つのプロ グ ラ ムヘッ ダが 生 成 さ る と い う 通
常 の 状 態 は 維 持 さ れな く な り ます。
• オペレーテ ィ ングシステムのページサイ ズが --pagesize コマンド ラインオプ
ションによって 制 御 される。
• リンカが、 最 初 の PT_LOAD プログラムヘッダに ELF ヘッダとプログラムヘッ
ダを 配 置 し よ う と する ( 空 間 が 使 用 で き る 場 合 )。
4.14.1 例
こ れは、 デマン ド ページングを 行 う ス キ ャ ッ タ フ ァ イルの 例 です。
LR1 GetPageSize() + SizeOfHeaders()
{
ER_RO +0
{
*(+RO)
}
ER_RW +GetPageSize()
{
*(+RW)
}
ER_ZI +0
{
*(+ZI)
}
}
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-24
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.14.2 関 連 項 目
概 念
• スキャッタロードについて (8-3 ページ)
参 照
『リンカリファレンス』:
• --arm_linux (2-13 ページ)
• --paged (2-118 ページ)
• --pagesize=pagesize (2-119 ページ)
• --pagesize=pagesize (2-119 ページ)
• --scatter=file (2-144 ページ)
• --sysv (2-172 ページ)
• GetPageSize() 関 数 (4-47 ページ)
• SizeOfHeaders() 関 数 (4-48 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-25
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.15 Thumb コー ド を 含 む 実 行 領 域 の 順 序 付 けについて
16 ビット Thumb 分 岐 の 範 囲 は 4MB. です。 実 行 領 域 に 4MB を 超 える Thumb コード
が 含 まれている と 、 armlink は、 同 じ よ う な 平 均 コール 深 度 にあ る セ ク シ ョ ンの 順 序
付 けを 行 い、 最 も よ く 呼 び 出 さ れる セ ク シ ョ ン を 中 央 に 配 置 し ます。 こ れに よ り 、
生 成 さ れるベニアの 数 を 最 小 限 に 抑 え る こ と がで き ます。
32 ビット Thumb 分 岐 の 範 囲 は 16MB. です。 こ の 範 囲 を 超 えた 場 合 にのみ、 セ ク シ ョ
ン を 再 度 順 序 付 けする 必 要 があ り ます。
セ ク シ ョ ンの 再 度 順 序 付 けを 無 効 にする には、 --no_largeregions コマンドラインオプ
シ ョ ン を 使 用 し ます。
4.15.1 関 連 項 目
概 念
• リンカによるセクションの 配 置 (4-20 ページ)
• ベニアの 概 要 (4-27 ページ) .
参 照
『リンカリファレンス』:
• --largeregions、 --no_largeregions (2-92 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-26
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.16 ベニアの 概 要
ベニアは、 リ ンカによって 生 成 され、 プログラムに 挿 入 される 小 さなコードセク
ションです。BL 命 令 は PC 相 対 で、 分 岐 範 囲 に 制 限 があ り ます。 そのため、 分 岐 先
が BL 命 令 の 分 岐 範 囲 外 にあ る 場 合 、 armlink はベニア を 生 成 する 必 要 があ り ます。
BL 命 令 の 範 囲 は、 ARM の 場 合 は 32MB、 32 ビット Thumb の 場 合 は 16MB、 16 ビッ ト
Thumb の 場 合 は 4MB です。 ベニアは、 分 岐 命 令 の 中 間 ターゲ ッ ト と な る こ と で、 分
岐 範 囲 を 拡 張 し ます。 ベニアに よ って、 分 岐 先 ア ド レ スが PC に 設 定 されます。 これ
によ り、 ベニアは 4 GB のアドレス 空 間 内 のどこへでも 分 岐 できるようになります。
ARM と Thumb の 混 合 環 境 では、 ベニアはプ ロ セ ッ サ 状 態 の 変 更 も 処 理 し ます。
リ ン カでは、 必 要 に 応 じ て、 以 下 の タ イ プのベニア を 生 成 で き ます。
• インラインベニア
• 短 分 岐 ベニア
• 長 分 岐 ベニア
armlink は、 ベニアご と に Veneer$$Code という 名 前 の 1 つの 入 力 セ ク シ ョ ンを 作 成 し ま
す。 ベニアは、 他 に 要 件 を 満 たす こ と がで き る 既 存 のベニアが 存 在 し ない 場 合 にの
み 生 成 さ れます。 2 つの 入 力 セ ク シ ョ ンに 同 じ 分 岐 先 への 長 分 岐 が 含 まれてい る 場
合 、 生 成 さ れるベニアは 1 つだけで、 そのベニアを 両 方 の 命 令 で 共 有 し ます。 この
よ う にベニアが 共 有 されるのは、 両 方 のセ ク シ ョ ンから 同 じ 分 岐 先 に 到 達 でき る 場
合 のみです。
ARMv4T を 使 用 している 場 合 、 分 岐 によって ARM ステート と Thumb ステートの 切
り 替 えが 発 生 する と 、 armlink はベニアを 生 成 し ます。 ARMv5TE 以 降 で も、 条 件 分 岐
を 使 用 し てい る 場 合 は、 イ ン ターワーキ ン グベニアが 生 成 さ れます。 こ れは、 条 件
付 きの BL 命 令 が 存 在 し ないためです。 ARMv5 以 降 の B 命 令 には、 状 態 変 更 用 のベニ
アも 必 要 です。
4.16.1 関 連 項 目
概 念
• ベニアの 共 有 (4-28 ページ)
• ベニアのタ イプ (4-29 ページ)
• 位 置 非 依 存 か ら 絶 対 ベニアへの 生 成 (4-31 ページ)
• スキャッタロード 時 のベニアの 再 利 用 (4-32 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-27
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.17 ベニアの 共 有
複 数 のオブジ ェ ク ト で 同 じベニアが 作 成 さ れる 場 合 は、 リ ン カに よ っ て、 そのベニ
アのインスタンスが 1 つ 作 成 さ れます。 そのベニアが、 こ れら オブジ ェ ク ト で 共 有
されます。
コマンド ラインオプショ ン --no_veneershare を 使 用 する と、 ベニアが 共 有 されないよ
う に 指 定 で き ます。 こ れに よ り 、 作 成 さ れたベニアセ ク シ ョ ンの 所 有 権 がベニア を
作 成 し たオブジ ェ ク ト に 割 り 当 て ら れる ため、 ス キ ャ ッ タ フ ァ イ ル 内 の 特 定 のオブ
ジェ ク ト からベニアを 選 択 できます。 以 下 に 例 を 示 します。
LR 0x8000
{
ER_ROOT +0
{
object1.o(Veneer$$Code)
}
}
ベニア を 共 有 する と 、 所 有 する オブジ ェ ク ト を 割 り 当 て る こ と がで き な く な り ます。
--no_veneershare を 使 用 する と 、 イ メ ージのレ イ ア ウ ト の 整 合 性 を 高 め る こ と がで き
ます。 ただし、 リ ンカによって 追 加 のベニアが 生 成 されるため、 このオプシ ョ ンに
はコー ド サ イ ズが 大 幅 に 増 加 する と い う 欠 点 があ り ます。
4.17.1 関 連 項 目
概 念
• ベニアの 概 要 (4-27 ページ)
• スキャッタロードについて (8-3 ページ) .
参 照
『リンカリファレンス』:
• --veneershare、 --no_veneershare (2-186 ページ)
• 第 4 章 スキャッタファイルの 正 式 な 構 文 .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-28
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.18 ベニアのタ イプ
ベニアは、 タ イ プご と に 機 能 や 使 用 する コー ド が 異 な り ます。 リ ン カでは、 分 岐 要
件 に 応 じて、 最 も 適 した、 小 さ くて 高 速 なベニアを 選 択 します
• インラインベニア :
— 状 態 の 変 更 の 実 行 のみに 使 用 し ます。
— ベニアは、 範 囲 内 に 収 ま る よ う に ターゲ ッ ト セ ク シ ョ ンの 直 前 に 挿 入 する
必 要 があ り ます。
— ARM から Thumb へのイ ン ターワーキングベニアの 範 囲 は 256 バイ トであ
るため、 関 数 のエン ト リポイントはベニアの 256 バ イ ト の 範 囲 内 に 記 述 す
る 必 要 があ り ます。
— Thumb から ARM へのイ ン ターワーキングベニアの 範 囲 はゼロバイ ト であ
る ため、 関 数 のエン ト リ ポ イ ン ト はベニアの 直 後 に 記 述 する 必 要 があ り ま
す
— イ ン ラ イ ンベニアは 常 に 位 置 非 依 存 です。
• 短 分 岐 ベニア :
— Thumb から ARM への イ ン ターワー ク を 行 う 短 分 岐 ベニアの 範 囲 は 32MB
(ARM 命 令 の 範 囲 ) です。
— 短 分 岐 ベニアは 常 に 位 置 非 依 存 です。
• 長 分 岐 ベニア :
— 4 GB のア ド レ ス 空 間 内 のど こ へで も 分 岐 で き ます。
— すべての 長 分 岐 ベニアは イ ン ターワーキ ングベニアに も な り ます。
— 絶 対 コー ド と 位 置 非 依 存 コー ド の 長 分 岐 ベニアは 異 な り ます。
ベニア を 使 用 する 場 合 は、 以 下 の 点 に 注 意 し て 下 さ い。
• インラインベニアの 制 限 は、 スキャッタファイルを 使 用 してインラインベニア
を 実 行 領 域 の 範 囲 外 に 移 動 で き ない こ と を 意 味 し ます。 コ マン ド ラ イ ンオプ
ション --no_inlineveneer を 使 用 する と、 インラ インベニアが 生 成 されな く な り
ます。
• すべてのベニア を 1 つの 入 力 セ ク シ ョ ンにま と める こ と はでき ません。 これは、
結 果 として 生 じるベニア 入 力 セクションが 他 の 入 力 セクションの 囲 内 に 収 まら
ない 可 能 性 があるためです。 セクシ ョ ンがア ド レス 範 囲 内 に 存 在 しない 場 合 、
長 分 岐 は 不 可 能 です。
• リ ンカに よ り 、 位 置 に 依 存 し ないベニアのバ リ アン ト が 自 動 的 に 生 成 さ れま
す。 ただ し、 こ の よ う なベニアは 位 置 に 依 存 するバ リ ア ン ト よ り も 大 いため、
必 要 な 場 合 ( 分 岐 元 および 分 岐 先 の 実 行 領 域 がど ち ら も 位 置 に 非 依 存 で 密 接 に
関 連 し てい る 場 合 ) にのみ、 リ ン カが こ の 操 作 を 行 います。
ベニアは、 コー ド サ イ ズを 最 適 化 する ために 生 成 さ れます。 そのため、 armlink は 以
下 の 優 先 順 序 でバ リ アン ト を 選 択 し ます。
1. インラインベニア
2. 短 分 岐 ベニア
3. 長 分 岐 ベニア
4.18.1 関 連 項 目
概 念
• ベニアの 概 要 (4-27 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-29
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
参 照
『リンカリファレンス』:
• --inlineveneer、 --no_inlineveneer (2-86 ページ)
• --max_veneer_passess=value (2-111 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-30
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.19 位 置 非 依 存 から 絶 対 ベニアへの 生 成
通 常 の 呼 び 出 し 命 令 では、 呼 び 出 し ア ド レ ス か ら のオフセ ッ ト と し て ターゲ ッ ト の
アドレスがエンコードされます。 位 置 非 依 存 (PI) コー ド か ら 絶 対 コー ド への 呼 び
出 し が 行 われる と リ ン ク 時 にはオフセ ッ ト を 計 算 で き ないため、 リ ンカは 長 分 岐 ベ
ニアを 挿 入 する 必 要 があます。
PI か ら 絶 対 ベニアへの 生 成 は、 --piveneer オプシ ョ ン を 使 用 し て 制 御 で き ます。 こ れ
はデフ ォル ト です。 こ のオプシ ョ ンを --no_piveneer を 使 用 してオフにする と、 PI
コードから 絶 対 コードへの 呼 び 出 しが 検 出 されたと きにリ ンカによってエラーが 生
成 されます。
4.19.1 関 連 項 目
概 念
• ベニアの 概 要 (4-27 ページ) .
参 照
『リンカリファレンス』:
• --max_veneer_passess=value (2-111 ページ)
• --piveneer、 --no_piveneer (2-121 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-31
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.20 スキャ ッ タ ロー ド 時 のベニアの 再 利 用
リ ンカでは 可 能 な 限 り ベニアを 再 利 用 し ますが、 保 護 さ れてい る ロー ド 領 域 および
オーバーレ イ 実 行 領 域 でのベニアの 再 利 用 にはい く つか 制 限 があ り ます。
ス キ ャ ッ タ フ ァ イルを 使 用 する と 、 RAM の 同 じ 領 域 を 共 有 する 領 域 を 作 成 で き ま
す。
• ロード 領 域 に PROTECTED キーワー ド を 使 用 し た 場 合 、 以 下 の こ と がで き な く な り
ます。
— ロード 領 域 の 重 複
— ベニアの 共 有
— --merge オプシ ョ ン を 使 用 し た 文 字 列 の 共 有
• 領 域 に OVERLAY キーワー ド を 使 用 し た 場 合 、 ベニア を 再 利 用 する には、 以 下 の 2
つの 条 件 があ り ます。
— オーバーレ イ 実 行 領 域 では、 他 のオーバーレ イ 実 行 領 域 内 にあ るベニアを
再 利 用 する こ と はで き ません。
— オーバーレ イ 実 行 領 域 内 にあ るベニア を、 他 の 実 行 領 域 内 で 再 利 用 する こ
とはできません。
これらの 条 件 が 満 たされない 場 合 は、 既 存 のベニアが 再 利 用 される 代 わりに、 新 し
いベニアが 作 成 さ れます。 ス キ ャ ッ タ ロー ド を 使 用 し てベニア 特 定 の 位 置 に 配 置 す
る よ う リ ンカに 指 示 する 場 合 を 除 き、 ベニアは 常 に、 ベニア を 必 要 と する 呼 び 出 し
を 含 む 実 行 領 域 内 に 配 置 さ れます。 つま り 、 以 下 を 意 味 し ます。
• オーバーレ イ 実 行 領 域 では、 すべてのベニアがその 実 行 領 域 内 に 配 置 さ れま
す。
• オーバーレ イ 実 行 領 域 では、 他 の 実 行 領 域 内 のベニアが 必 要 にな る こ と はあ り
ません。
4.20.1 関 連 項 目
概 念
• ベニアの 概 要 (4-27 ページ) .
参 照
• ロード 領 域 の 属 性 (4-8 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-32
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.21 コマンドラインオプションを 使 用 した C++ 例 外 テーブルの 生 成 の 制 御
デフォル ト 、 つま り、 オプシ ョ ン --exceptions が 指 定 さ れてい る 場 合 は、 イ メ ージに
例 外 テーブルを 含 め る こ と がで き ます。 コー ド で 例 外 がス ローされない 場 合 、 例 外
テーブルは 自 動 的 に 破 棄 さ れます。 ただ し、 オプシ ョ ン --no_exceptions を 指 定 する
と 、 未 使 用 セ ク シ ョ ンの 削 除 後 に 例 外 セ ク シ ョ ンが 存 在 する 場 合 、 リ ン カに よ っ て
エラーが 生 成 されます。
--no_exceptions オプシ ョ ン を 使 用 する と 、 コー ド で 例 外 が 処 理 さ れない よ う にで き ま
す。 リ ンカは、 エ ラー メ ッ セージを 生 成 し て 例 外 が 検 出 さ れた こ と を 通 知 し、 最 終
イメージを 生 成 しません。
ただし、 --no_exceptions オプシ ョ ンを --diag_warning オプシ ョ ン と 組 み 合 わせて 使 用
する と、 エラーメ ッセージを 警 告 メ ッセージに 降 格 できます。 この 場 合 、 リ ンカは、
最 終 イ メ ージを 生 成 し ますが、 例 外 が 検 出 さ れた こ と を 警 告 する メ ッ セージ も 生 成
します。
リ ンカは、 従 来 のオブジェ ク ト 用 に、 デバッ グフ レーム 情 報 を 含 む 例 外 テーブルを
作 成 で き ます。 こ の 操 作 は、 C 言 語 ま たはアセンブ リ 言 語 のオジ ェ ク ト については
支 障 な く 行 う こ と がで き ます。 デフ ォル ト では、 リ ン カは 例 外 テーブルを 作 成 し ま
せん。 これは、 リ ンカオプシ ョ ン --exceptions_tables=nocreate を 使 用 した 場 合 と 同 じ
です。
リンカオプション --exceptions_tables=unwind を 使 用 する と、 リ ンカは、.debug_frame 情
報 を 使 用 して、 例 外 テーブルを 含 んでいないイ メージのセク シ ョ ンご とに、 レジス
タが 復 元 する unwind テーブルを 作 成 でき ます。 unwind テーブルを 作 成 できない 場
合 、 リ ン カは 代 わ り に nounwind テーブルを 作 成 し ます。
リンカオプション --exceptions_tables=cantunwind を 使 用 する と、 例 外 テーブルを 含 ん
でいないイ メージのセクシ ョ ンご とに nounwind テーブルを 作 成 でき ます。
注
以 下 の 点 に 注 意 し て 下 さい。
• デフォル ト (つま り、 --exceptions --exception_tables=nocreate) では、 C コード
がオプシ ョ ン --exceptions でコンパイルされる 場 合 を 除 き、C コード またはアセ
ンブ リ コー ド で 例 外 を ス ローする こ と は 安 全 ではあ り ません。
• リンカは、.debug_frame 情 報 を 使 用 し て、 オブジ ェ ク ト か ら フ レーム 展 開 命 令 を
生 成 で き ます。 フ レーム 展 開 は、 C およびアセンブラコードには 十 分 です。 し
か し、 展 開 れる ス タ ッ ク 上 のオブジ ェ ク ト のデス ク ト ラ ク タ を 呼 び 出 さ ないた
め、 C++ コー ド には 不 十 分 です。
C++ のク リーンアップコードは、--exceptions オプシ ョ ン を 使 用 し て、 コ ンパ イ
ラ に よ って 生 成 さ れる 必 要 があ り ます。
4.21.1 関 連 項 目
参 照
『リンカリファレンス』:
• --diag_warning=tag[,tag,...] (2-48 ページ)
• --exceptions、 --no_exceptions (2-61 ページ)
• --exceptions_tables=action (2-62 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-33
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
『コンパイ ラ リ ファレンス』 :
• --exceptions、 --no_exceptions (3-94 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-34
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.22 弱 参 照 と 定 義 について
弱 参 照 と 定 義 を 使 用 する こ と で、 リ ンカはよ り 柔 軟 な 方 法 でビル ド に さ ま ざ ま な 関
数 や 変 数 を 含 め る こ と がで き ます。 通 常 、 こ れら は ラ イ ブ ラ リ 数 への 参 照 です。
弱 参 照
weak 定 義
リ ンカでは、 通 常 の 非 弱 参 照 を リ ン ク に 含 まれてい る シンボルに 解 決 で
き ない 場 合 、 ラ イ ブ ラ リ 内 のシンボルを 検 索 し て 解 決 を 試 みます。
• そ う し た 参 照 を 見 つけ る こ と がで き なかった 場 合 、 リ ンカに よ っ
てエラーが 報 告 されます。
• そ う し た 参 照 が 解 決 さ れる と 、 解 決 先 のセ ク シ ョ ンは 使 用 済 み と
マー ク さ れます。 こ う する こ と で、 こ のセ ク シ ョ ンが 未 使 用 のセ
クションとしてンカによって 削 除 されることがなくなります。 各
非 弱 参 照 は、 1 つの 定 義 によ ってのみ 解 決 される 必 要 があ り ます。
複 数 の 定 義 が 存 在 する 場 合 、 リ ン カに よ ってエ ラーが 報 告 さ れま
す。
C ソ ース フ ァ イ ル 内 の 関 数 ま たは 変 数 の 宣 言 は、 __weak 修 飾 子 を 使 用 し
てマークできます。 extern と 同 様 に、 こ の 修 飾 子 は、 関 数 ま たは 変 数 が
別 のソース フ ァ イル 内 で 宣 言 されている こ と を コ ンパイ ラに 通 知 し ま
す。 こ の 関 数 ま たは 変 数 の 定 義 を コ ンパイ ラ が 使 用 で き ない 可 能 性 があ
る ため、 リ ン カに よ って 解 決 さ れる 弱 参 照 が 作 成 さ れます。
弱 参 照 を 解 決 する ために、 リ ンカに よ って ラ イ ブ ラ リ か ら オブジ ェ ク ト
が ロー ド さ れる こ と はあ り ません。 弱 参 照 は、 定 義 が 他 の 理 由 で イ メ ー
ジ 含 まれてい る 場 合 にのみ 解 決 で き ます。 弱 参 照 に よ って、 リ ンカが 定
義 を 含 むセクシ ョ ンを 使 用 済 みとマークする こ とはあ り ません。 そのた
め 未 使 用 のセ ク シ ョ ン と し て リ ン カに よ って 削 除 さ れる 可 能 性 があ り ま
す。 以 下 の さ ま ざ ま な 理 由 で、 定 義 が イ メ ージ 内 に 既 に 存 在 し てい る 場
合 があ り ます。
• シンボルがコード 内 の 他 の 場 所 から 厳 密 に 参 照 されている。
• シンボル 定 義 が、 これらのいずれかの 理 由 で 含 まれているシンボ
ル 定 義 と 同 じ ELF セクション 内 に 存 在 している。
• シンボル 定 義 が、--keep を 使 用 して 指 定 されているセクシ ョ ン、 ま
たは ENTRY ポイント を 含 むセクション 内 に 存 在 している。
• シンボル 定 義 がリ ンクに 含 まれているオブジェク ト ファイル 内 に
存 在 し、 --no_remove オプシ ョ ンが 使 用 されている。 ラ イブラ リ 内
のオブジ ェ ク ト フ ァ イ ルが 明 示 的 に リ ン カ コ マン ド ラ イ ンに 含 ま
れている 場 合 を 除 き、 オブジェ ク ト フ ァ イルはラ イブラ リ から 参
照 されません。
要 約 する と 、 弱 参 照 は 定 義 が イ メ ージに 既 に 含 まれてい る 場 合 に 解 決 さ
れますが、 その 定 義 が 含 まれているかど う かの 確 認 は 行 いません。
未 解 決 の weak 関 数 の 呼 び 出 しは、 以 下 のいずれかに 置 き 換 え られます。
• 非 演 算 命 令 NOP
• リンク 命 令 BL を 使 用 し た、 後 続 の 命 令 への 分 岐 (つま り 、 関 数 呼
び 出 しは 行 われません)
関 数 定 義 、 つま り アセンブ ラ のエ ク ス ポー ト さ れた ラベルは、 変 数 の 定
義 と 同 じよ うに、 weak と し てマー クする こ と も で き ます。 こ の 場 合 、
weak シンボル 定 義 がオブジェク ト ファイル 内 に 作 成 されます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-35
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
通 常 の 定 義 と 同 様 の 方 法 で、 weak 定 義 を 使 用 し て、 そのシンボルへの
参 照 を 解 決 で き ます。 ただ し、 そのシンボルの non-weak 定 義 がビル ド
内 に 存 在 る 場 合 、 リ ン カでは weak 定 義 の 代 わ り に、 その 定 義 を 使 用 し
ます。 複 数 回 定 義 さ れたシンボルが 原 因 で、 エ ラーは 生 成 さ れません。
4.22.1 弱 参 照 の 例
ライブラリには、 関 数 foo() が 含 まれています。 この 関 数 は、 アプ リ ケーシ ョ ンの 一
部 のビルドで 呼 び 出 され、 その 他 のビルドでは 呼 び 出 されません。 この 関 数 を 使 用
する 場 合 は、 init_foo() を 最 初 に 呼 び 出 す 必 要 があ り ます。 弱 参 照 を 使 用 し て、
init_foo() への 呼 び 出 し を 自 動 化 で き ます。
ライブラリでは、init_foo() と foo() を 同 じ ELF セクション 内 に 定 義 できます。 アプ
リ ケーシ ョ ンの 初 期 化 コー ド では、 init_foo() を weak で 呼 び 出 す 必 要 があ り ます。
何 らかの 理 由 でアプリ ケーシ ョ ンに foo() が 含 まれている 場 合 は、 init_foo() も 含 ま
れてお り 、 それが 初 期 化 コー ド か ら 呼 び 出 さ れます。 foo() が 含 まれていないビルド
では、 init_foo() への 呼 び 出 し は リ ン カに よ っ て 削 除 さ れます。
通 常 、 1 つのソース フ ァ イル 内 で 定 義 されている 複 数 の 関 数 のコード は、 コ ンパイ ラ
によって、 1 つの ELF セクションに 配 置 されます。ただし、 特 のビルドオプションに
よ って この 動 作 が 変 更 される 場 合 があ り ます。 そのため、 ビル ド が ELF セクション
へのファ イルのグループ 化 に 依 存 している 場 合 は、 注 意 して 使 用 する 必 要 があ り ま
す。
• コンパイラコマンドラインオプション --split_sections を 指 定 する と 、 各 関 数 は
独 自 のセ ク シ ョ ンに 配 置 さ れます。 こ の 例 では、 こ のオプシ ョ ン を 指 定 し て ラ
イブラ リ をコンパイルすると、foo() と init_foo() は 別 々のセ ク シ ョ ンに 配 置 さ
れます。 そのため、 foo() への 呼 び 出 しが 原 因 で、 init_foo() は 自 動 的 にはビル
ドに 含 まれません。
• リンカフィードバックメカニズム --feedback を 指 定 する と 、 リ ン ク 手 順 で
init_foo() は 未 使 用 と 記 録 さ れます。 そのため、 その 後 のコ ンパ イルで
init_foo() は 独 自 のセ ク シ ョ ンに 配 置 され、 削 除 でき る よ う にな り ます。
• コンパイラディレクティブ #pragma arm section を 指 定 した 場 合 も、コンパイ ラに
よ って、 一 部 の 関 数 に 対 し て 個 別 の ELF セクションが 生 成 されます。
この 例 では、foo() を 含 むビルド と、 foo() を 含 まないビルト とで 初 期 化 コードをビル
ド し 直 す 必 要 はあ り ません。 ま た、 init_foo() を 呼 び 出 さ ないバージ ョ ンの 初 期 化
コード と、 アプ リ ケーシ ョ ンの 他 の 部 分 で foo() を 呼 び 出 すアプ リ ケーシ ョ ンが 誤 っ
てビル ド さ れる 可 能 性 も あ り ません。
通 常 、 ラ イ ブ ラ リ にビル ド さ れる foo.c ソースコードの 例 を 以 下 に 示 し ます。
void init_foo()
{
// 初 期 化 コ ー ド
}
void foo()
{
// 一 部 の ビ ル ド に 含 ま れ
// init_foo() を 最 初 に 呼 び 出 す 必 要 があ る 関 数
}
init.c の 例 を 以 下 に 示 し ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-36
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
__weak void init_foo(void);
int main(void)
{
init_foo();
// foo() を 直 接 ま た は 間 接 的 に 呼 び 出 し た り す る 残 り の コ ー ド
}
アセンブ ラ に よ って 生 成 さ れる 弱 参 照 の 例 を 以 下 に 示 し ます。
init.s:
IMPORT init_foo WEAK
AREA init, CODE, readonly
BL init_foo
; 残 りのコード
END
4.22.2 weak 定 義 の 例
関 数 の 単 純 な 実 装 ま たはダ ミ ーの 実 装 を weak 定 義 と し て 使 用 で き ます。 こ れら を 使
用 する と、 関 数 の 完 全 な 実 装 を 含 める こ と な く 動 作 が 定 義 されソ フ ト ウ ェ アをビル
ド で き ます。 ま た、 必 要 に 応 じ て、 一 部 のビル ド に 完 全 な 実 装 を 含 め る こ と も で き
ます。
4.22.3 関 連 項 目
概 念
• リ ンカに よ る ラ イ ブ ラ リ の 検 索 、 選 択 、 およびス キ ャ ンの 実 行 方 法 (4-38 ペー
ジ)
• リ ンカに よ る 参 照 の 解 決 方 法 (4-43 ページ) .
参 照
『リンカリファレンス』:
• --feedback=file (2-66 ページ)
• --keep=section_id (2-89 ページ)
• --remove、 --no_remove (2-136 ページ) .
『コンパイ ラ リ ファレンス』 :
• --split_sections (3-203 ページ)
• __weak (5-24 ページ)
• __attribute__((weak)) 関 数 属 性 (5-58 ページ)
• __attribute__((weakref("target"))) 関 数 属 性 (5-59 ページ)
• __attribute__((weak)) 変 数 属 性 (5-78 ページ)
• __attribute__((weakref("target"))) 変 数 属 性 (5-79 ページ)
• #pragma arm section [section_type_list] (5-84 ページ) .
『アセンブラ リ フ ァ レンス』 :
• NOP (3-154 ページ)
• B、 BL、 BX、 BLX、 BXJ (3-124 ページ)
• ENTRY (6-78 ページ)
• EXPORT、 GLOBAL (6-80 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-37
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.23 リ ン カによ る ラ イ ブ ラ リの 検 索 、 選 択 、 およびスキャ ンの 実 行 方 法
リンカは、 常 に ARM ライブラリの 前 にユーザライブラリを 検 索 します。--no_scanlib
コマンド ラインオプショ ンを 指 定 した 場 合 、 リンカはデフォルトの ARM ライブラリ
の 検 索 を 行 わず、 入 力 フ ァ イル リ ス ト に 指 定 されている ラ イブラ リ のみを 使 用 して
参 照 を 解 決 し ます。
リ ン カでは、 ラ イ ブ ラ リ の 内 部 リ ス ト を 以 下 の 方 法 で 作 成 し ます。
1. 入 力 フ ァ イ ル リ ス ト 内 に 明 示 的 に 指 定 さ れてい るすべての ラ イ ブ ラ リ を リ ス ト
に 追 加 し ます。
2. 入 力 オブジ ェ ク ト 内 に 指 定 さ れてい る 要 求 を 満 たすために、 ユーザ 指 定 の 検 索
パスを 検 証 し、 ARM 標 準 ラ イ ブ ラ リ を 識 別 し ます。
検 証 し たデ ィ レ ク ト リ およびそのサブデ ィ レ ク ト リ か ら、 最 も 適 切 な ラ イ ブ ラ
リのバリアントが 選 択 されます。ARM が 提 供 する ラ イ ブ ラ リ には、 その メ ン
バの 属 性 に 基 づいて 命 名 さ れてい る 複 数 のバ リ アン ト があ り ます。
リンカがオブジェクトファイルをイメージに 追 加 する 方 法 と、 ライブラリをイメー
ジに 追 加 する 方 法 には、 以 下 の 違 いがあ り ます。
• 入 力 リ ス ト 内 の 各 オブジ ェ ク ト フ ァ イ ルは、 それを 参 照 する も のがあ る かど う
かに 関 係 な く 、 無 条 件 に 出 力 イ メ ージに 追 加 さ れます。 ただ し、 少 く と も 1 つ
のオブジェ ク ト が 指 定 されている 必 要 があ り ます。
• ラ イブラ リ の メ ンバは、 以 下 の 場 合 にのみ 出 力 にイ ン クルード されます。
— オブジェ ク ト フ ァ イルまたは 既 にイン クルード されている ラ イブラ リ メ ン
バから その メ ンバへの 非 弱 参 照 があ る。
— リ ンカが 明 示 的 にその メ ンバを 追 加 する よ う 指 示 さ れてい る。
注
ラ イ ブ ラ リ の メ ンバは、 入 力 フ ァ イル リ ス ト 内 で 明 示 的 に 要 求 さ れる と 、 その
メ ンバに よ って 現 在 の 参 照 が 解 決 さ れない 場 合 で も ロー ド さ れますこ の 場 合 、
明 示 的 に 要 求 さ れた メ ンバは、 通 常 のオブジ ェ ク ト と 同 様 に 処 理 さ れます。
weak 型 シンボルへの 未 解 決 の 参 照 があ る 場 合 、 ラ イ ブ ラ リ の メ ンバはロー ド さ れま
せん。
4.23.1 関 連 項 目
タスク
• 弱 参 照 と 定 義 について (4-35 ページ)
• リンカによる ARM 標 準 ラ イ ブ ラ リ の 検 索 方 法 の 制 御 (4-39 ページ) .
参 照
『リンカリファレンス』:
• --keep=section_id (2-89 ページ)
• --remove、 --no_remove (2-136 ページ)
• --scanlib、 --no_scanlib (2-143 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-38
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.24 リンカによる ARM 標 準 ラ イ ブ ラ リの 検 索 方 法 の 制 御
デフォル ト では、 リ ンカは ARM 標 準 ラ イ ブ ラ リ を ../lib 内 で 検 索 し ます。 こ の 場 所
は armlink 実 行 可 能 フ ァ イルの 場 所 に 対 し て 相 対 的 です。 ま た、 --libpath コマンドラ
インオプションか、 あるいは ARMLIB 環 境 変 数 ま たは ARMCCnLIB 環 境 変 数 のいずれかを
使 用 し て、 リ ン カに よ る ARM 標 準 ラ イ ブ ラ リ の 検 索 方 法 を 制 御 する こ と も で き ま
す。
一 部 の ラ イ ブ ラ リ はサブデ ィ レ ク ト リ に 格 納 さ れます。 コ ンパ イ ラ では、 特 定 のサ
ブデ ィ レ ク ト リ の ラ イ ブ ラ リ が 必 要 な 場 合 、 サブデ ィ レ ク ト リ 識 別 する ための 特 別
なシンボルの イ ンポー ト を リ ンカに 追 加 し ます。 サブデ ィ レ ク ト リ の 名 前 は、
Lib$$Request$$sub_dir_name 形 式 のシンボルを 使 用 し て、 コ ンパイル 済 みの 各 オブジ ェ
クト 内 に 配 置 されます。
4.24.1 --libpath コ マン ド ラ イ ンオプシ ョ ンの 使 用
--libpath コマンド ラインオプショ ンは、 親 ディレク ト リのコンマ 区 切 り リ ス ト と 共
に 使 用 し ます。 この リ ス ト は、 ARM のライブラ リディレク ト リ armlib および cpplib
の 親 デ ィ レ ク ト リ で 終 わ る 必 要 があ り ます。
ラ イ ブ ラ リ パスの 末 尾 に 以 下 のパスの 区 切 り 文 字 を 含 めた 場 合 、 リ ンカでは、 シン
ボル Lib$$Request$$sub_dir_name で 指 定 されたサブデ ィ レ ク ト リ を 検 索 し ます。
• \ (Windows の 場 合 )
• / (Red Hat Linux の 場 合 )
例 えば、 --libpath=mylibs\ とシンボル Lib$$Request$$armlib を 使 用 した 場 合 、 リ ンカで
は 以 下 のデ ィ レ ク ト リ を 検 索 し ます。
mylibs
mylibs\armlib
注
リンカコマンドラインオプション --libpath を 使 用 した 場 合 、 ARMCCnLIB 変 数 で 指 定 さ
れたパスは 検 索 されません。
複 数 の ラ イ ブ ラ リ で 同 じ シンボルが 定 義 さ れてい る 場 合 、 検 索 は 先 頭 か ら 順 番 に 実
行 されるため、 リ ス ト 内 で 最 初 に 出 てく るライブラ リがリ ンカよって 選 択 されます。
4.24.2 ARMCCnLIB または ARMLIB 環 境 変 数 の 使 用
ARMLIB かまたは ARMCCnLIB 環 境 変 数 のいずれかを 使 用 し て、 ラ イ ブ ラ リ のパス を 指 定
する こ とができます。
ARMCCnLIB に 指 定 さ れたパスの 末 尾 に 以 下 のパスの 区 切 り 文 字 を 含 めた 場 合 、 リ ンカ
では、 シンボル Lib$$Request$$sub_dir_name で 指 定 されたサブデ ィ レ ク ト リ を 検 索 し ま
す。
• \ (Windows の 場 合 )
• / (Red Hat Linux の 場 合 )
例 えば、ARMCC5LIB が install_directory\lib\ に 設 定 さ れてい る 場 合 、 リ ンカでは 以 下 の
ディレク ト リを 検 索 します。
lib
lib\armlib
lib\cpplib
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-39
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.24.3 ラ イ ブ ラ リ 検 索 順 序
リ ンカは ラ イ ブ ラ リ を 次 に 示 す 順 序 で 検 索 し ます。
1. 現 在 のパスの 相 対 パス
2. コマンド ラインオプショ ン --libpath で 指 定 された 場 所
3. ARMCCnLIB で 指 定 された 場 所
4. ARMLIB で 指 定 された 場 所
5. ../lib で 指 定 された 場 所
4.24.4 リンカによる ARM ラ イ ブ ラ リのバ リ アン ト の 選 択 方 法
ARM コンパイラツールチェーンには、 さまざまなビルドオプションを 使 用 してビル
ド さ れた、 各 ラ イ ブ ラ リ のバ リ アン ト がい く つか 含 まれています。 例 えば、 アーキ
テクチャバージョン、 エンディアン、 命 令 セッ トがあります。 ARM ライブラリのバ
リ アン ト は、 そのラ イ ブ ラ リ の 名 前 で 符 号 化 されます。 リ ンカは、 ラ イ ブ ラ リ の 検
索 時 に 識 別 さ れた 各 デ ィ レ ク ト リ か ら、 最 も 適 切 なバ リ ア ン ト を 選 択 する 必 要 があ
ります。
リ ンカは、 各 入 力 オブジェク トの 属 性 を 蓄 積 し、 それらの 属 性 に 最 も 適 したライブ
ラ リ のバ リ アン ト を 選 択 し ます。 選 択 さ れた 複 数 の ラ イ ブ ラ リ 同 様 に 適 し てい る 場
合 には、 最 初 に 選 択 さ れた ラ イ ブ ラ リ が 採 用 さ れ、 残 り の ラ イ ブ ラ リ は 採 用 さ れま
せん。
4.24.5 関 連 項 目
概 念
• リ ンカに よ る ラ イ ブ ラ リ の 検 索 、 選 択 、 およびス キ ャ ンの 実 行 方 法 (4-38 ペー
ジ) .
参 照
『リンカリファレンス』:
• --libpath=pathlist (2-97 ページ) .
『ARM ® C および C++ ラ イ ブ ラ リ と 浮 動 小 数 点 サポー ト の 使 用 』 :
• C および C++ ラ イ ブ ラ リ の 命 名 規 則 (2-130 ページ) .
『ARM ® C ライブラリ、C++ ラ イ ブ ラ リ 、 および 浮 動 小 数 点 サポー ト リ フ ァ レ ン ス』 :
• 第 2 章 C ライブラリと C++ ライブラリ .
『ARM コンパイラツールチェーンの 概 要 』:
• ツールチェーンの 環 境 変 数 (2-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-40
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.25 リ ン ク 時 のユーザラ イ ブ ラ リの 指 定
ユーザ ラ イ ブ ラ リ を 指 定 する には、 以 下 の 手 順 を 実 行 し ます。
• パス 情 報 を 使 用 し て、 ユーザ ラ イ ブ ラ リ を 入 力 フ ァ イル リ ス ト に 明 示 的 に 含 め
ます。
• armlink コマンド ラインに --userlibpath オプシ ョ ンを、 ディ レ ク ト リ のコンマ 区
切 り リ ス ト と 共 に 追 加 し、 ラ イブラ リ の 名 前 を 入 力 フ ァ イルと して 指 定 しま
す。
--library=name オプシ ョ ンを 使 用 して、 静 的 ラ イブラ リ libname.a、 ま たは 動 的 共 有 オ
ブジェ ク ト libname.so を 指 定 で き ます。 ダ イ ナ ミ ッ ク 検 索 は
--search_dynamic_libraries オプシ ョ ンに よ っ て 制 御 さ れます。 例 えば、 以 下 の コ マン
ドでは、libfoo.so の 後 に libfoo.a を 検 索 します。
armlink --arm_linux --shared --fpic --search_dynamic_libraries --library=foo
コ マン ド ラ イ ンで ラ イ ブ ラ リ の 完 全 パス 名 を 指 定 し ない 場 合 、 リ ン カでは、
--userlibpath オプシ ョ ンで 指 定 されたディ レ ク ト リ 内 でラ イブラ リ を 検 索 し ます。 例
えば、 ディ レ ク ト リ /mylib に my_lib.a および other_lib.a が 含 まれる 場 合 、
/mylib/my_lib.a を 入 力 フ ァ イル リ ス ト に 追 加 する には、 以 下 の コ マン ド を 使 用 し ま
す。
armlink --userlibpath /mylib my_lib.a *.o
ラ イ ブ ラ リ か ら 特 定 の メ ンバを 追 加 する 場 合 、 こ のコ マン ド では、 リ ンカで 使 用 さ
れる 検 索 可 能 な ラ イ ブ ラ リ の リ ス ト に ラ イ ブ ラ リ が 追 加 さ れまん。 特 定 の メ ンバを
ロードし、 検 索 可 能 なライブラリのリストにライブラリを 追 加 するには、 ライブラ
リ filename を 単 独 でインクルードするだけでな く、 library(member) も 指 定 します。 例
えば、 strcmp.o をロードして、 検 索 可 能 なライブラ リのリストに mystring.lib を 配 置
するには、 入 力 ファ イルリ ス ト に 以 下 の 行 を 追 加 します。
mystring.lib(strcmp.o) mystring.lib
注
リンカコマンドラインオプション --libpath あるいは ARMLIB 環 境 変 数 ま たは ARMCCnLIB
環 境 変 数 のいずれかに よ って 指 定 さ れる ARM 標 準 ラ イ ブ ラ リ に 使 用 さ れる 検 索 パス
では、 ユーザラ イブラ リ は 検 索 されません。
4.25.1 関 連 項 目
タスク
• リンカによる ARM 標 準 ラ イ ブ ラ リ の 検 索 方 法 の 制 御 (4-39 ページ) .
参 照
『リンカリファレンス』:
• --libpath=pathlist (2-97 ページ)
• --library=name (2-98 ページ)
• --search_dynamic_libraries、 --no_search_dynamic_libraries
(2-146 ページ)
• --userlibpath=pathlist (2-182 ページ) .
『ARM ® C ライブラリ、C++ ラ イ ブ ラ リ 、 および 浮 動 小 数 点 サポー ト リ フ ァ レ ン ス』 :
• 第 2 章 C ライブラリと C++ ライブラリ .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-41
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
『ARM コンパイラツールチェーンの 概 要 』:
• ツールチェーンの 環 境 変 数 (2-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-42
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.26 リ ン カによ る 参 照 の 解 決 方 法
リ ンカは、 ラ イブラ リ の リ ス ト を 構 成 する と、 参 照 を 解 決 するために リ ス ト 内 の 各
ライブラリを 繰 り 返 しスキャンします。 保 持 されるファイルの 2 つの 別 々の リ ス ト
があ り ます。 すべての 依 存 関 係 を 解 決 する ために、 その 2 つの リ ス ト は 以 下 の 順 序
でスキャンされます。
1. ../lib にあるシステムラ イブラ リ、 あるいは --libpath、 ARMCCnLIB、 または ARMLIB
によって 指 定 されるディレク ト リにあるシステムライブラ リのリ ス ト。
-Jdir[,dir,...] コ ンパ イ ラ オプシ ョ ンで も 指 定 で き ます。
2. ロード されたその 他 のすべてのファ イルのリ ス ト。-Idir[,dir,...] コンパイラ
オプシ ョ ンでも 指 定 でき ます。
各 リ ス ト は、 以 下 の 手 順 でス キ ャ ン さ れます。
1. 指 定 さ れたすべてのデ ィ レ ク ト リ を 検 索 し て、 最 も 互 換 性 のあ る ラ イ ブ ラ リ の
バリアントを 選 択 します。
2. そのバ リ アン ト を ラ イブラ リ の リ ス ト に 追 加 し ます。
3. 各 ラ イ ブ ラ リ を ス キ ャ ン し て、 必 要 な メ ンバを ロー ド し ます。
a. その 時 点 で 解 決 さ れていない 非 弱 参 照 について、 リ ス ト 内 の ラ イ ブ ラ リ を
順 に 検 索 し て、 一 致 する 定 義 を 探 し ます。 検 出 さ れた 最 初 の 定 義 が 手 順 b
のためにマーク されます。
複 数 の ラ イ ブ ラ リ で 同 じ シンボルが 定 義 さ れてい る 場 合 、 検 索 は 先 頭 か ら
順 番 に 実 行 さ れる ため、 リ ス ト 内 で 最 初 に 出 て く る ラ イ ブ ラ リ が リ ン カ
よって 選 択 されます。 このため、 入 力 ファイルリストにライブラ リを 追 加
する こ とによ り、 ARM C ライブラリなどの 他 のライブラリの 関 数 定 義
をーバーライドできます。 ただし、 ライブラリのメンバのすべてのシンボ
ルを 一 貫 し てオーバーラ イ ド し ない と、 動 作 が 予 測 でき な く な るので 注 意
して 下 さい。
b. 手 順 3a でマーク されたラ イブラ リ のメ ンバをロード し ます。 メ ンバを
ロー ド する と 、 弱 参 照 を 含 む、 未 解 決 の 参 照 が 解 決 さ れる 可 能 性 があ り ま
す。 ま た、 ラ イ ブ ラ リ メ ンバの ロー ド に よ っ て、 新 たに 未 解 決 の 弱 参 照 お
よび 非 弱 参 照 が 生 じ る 可 能 性 も あ り ます。
c. こ れら の 手 順 の 処 理 は、 すべての 非 弱 参 照 が 解 決 さ れる か、 どの ラ イ ブ ラ
リ で も 解 決 で き ない こ と が 判 明 する まで 続 け ら れます。
4. ス キ ャ ン 処 理 が 完 了 し て も 非 弱 参 照 が 解 決 さ れない 場 合 は、 エ ラー メ ッ セージ
が 生 成 されます。
4.26.1 関 連 項 目
概 念
• 弱 参 照 と 定 義 について (4-35 ページ)
• リ ンカに よ る ラ イ ブ ラ リ の 検 索 、 選 択 、 およびス キ ャ ンの 実 行 方 法 (4-38 ペー
ジ)
• リンカによる ARM 標 準 ラ イ ブ ラ リ の 検 索 方 法 の 制 御 (4-39 ページ)
• リンク 時 のユーザライブラリの 指 定 (4-41 ページ) .
参 照
『リンカリファレンス』:
• --libpath=pathlist (2-97 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-43
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
『コンパイ ラ リ ファレンス』 :
• -Idir[,dir,...] (3-121 ページ)
• -Jdir[,dir,...] (3-132 ページ) .
『ARM コンパイラツールチェーンの 概 要 』:
• ツールチェーンの 環 境 変 数 (2-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-44
ID 111311
Non-Confidential

イメージの 構 造 と 生 成
4.27 リ ン カにおける 厳 格 なオプシ ョ ン フ ァ ミ リの 使 用
厳 格 なオプシ ョ ンフ ァ ミ リ は、 エラーの 重 大 度 と 直 接 には 関 係 し ません。 一 般 に、
厳 格 なオプシ ョ ン を 追 加 する のは、 標 準 の リ ン カチェ ッ ク が 十 には 正 確 でないか、
またはレガシーオブジェ ク ト の ノ イ ズを 伴 う 可 能 性 があ るためです。
厳 格 なオプシ ョ ン フ ァ ミ リ は 次 の と お り です。
• --strict
• --[no_]strict_enum_size
• --[no_]strict_flags
• --[no_]strict_ph
• --[no_]strict_relocations
• --[no_]strict_symbols
• --[no_]strict_visibility
• --[no_]strict_wchar_size.
4.27.1 関 連 項 目
参 照
『リンカリファレンス』:
• --strict (2-158 ページ)
• --strict_enum_size、 --no_strict_enum_size (2-159 ページ)
• --strict_flags、 --no_strict_flags (2-160 ページ)
• --strict_ph、 --no_strict_ph (2-161 ページ)
• --strict_relocations、 --no_strict_relocations (2-162 ページ)
• --strict_symbols、 --no_strict_symbols (2-163 ページ)
• --strict_visibility、 --no_strict_visibility (2-164 ページ)
• --strict_wchar_size、 --no_strict_wchar_size (2-165 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 4-45
ID 111311
Non-Confidential

第 5 章
リ ン カの 最 適 化 の 使 用
以 下 の ト ピ ッ ク では、 リ ンカ armlink で 使 用 でき る 最 適 化 について 説 明 し ます。
タスク
• リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド (5-18 ページ)
• RW データ 圧 縮 の 使 用 (5-21 ページ)
• リンカによる 関 数 のインライン 化 (5-22 ページ)
• NOP に 最 適 化 さ れる 分 岐 の 処 理 (5-25 ページ)
概 念
• 共 通 デバ ッ グセ ク シ ョ ンの 削 除 (5-3 ページ)
• 共 通 グループま たは 共 通 セ ク シ ョ ンの 削 除 (5-4 ページ)
• 未 使 用 セ ク シ ョ ンの 削 除 (5-6 ページ)
• 未 使 用 仮 想 関 数 の 削 除 (5-8 ページ)
• リンカフィードバックについて (5-9 ページ)
• リ ンカ フ ィ ー ド バ ッ ク の 使 用 例 (5-11 ページ)
• リンク 時 コード 生 成 について (5-13 ページ)
• RW データ 圧 縮 を 使 用 し た 最 適 化 (5-16 ページ)
• リ ンカに よ る コ ンプレ ッ サの 選 択 方 法 (5-17 ページ)
• 圧 縮 の 適 用 方 法 (5-20 ページ)
• 関 数 のインラ イン 化 に 影 響 を 与 える 要 因 (5-23 ページ)
• 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けについて (5-26 ページ)
• 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けに 関 する 制 限 (5-27 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-1
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
• コメントセクションのマージについて (5-28 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-2
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.1 共 通 デバ ッ グセ ク シ ョ ンの 削 除
DWARF 2 では、 コ ンパイ ラ と アセンブラは、 コ ンパイル 単 位 のソースフ ァ イルご と
にデバッグセクシ ョ ン 群 を 生 成 します。 armlink は、 特 定 の ソ ース フ ァ イルに 関 連 す
る 複 数 のデバッ グセ ク シ ョ ンを 検 出 し、 最 終 イ メ ージ 内 に 残 す 1 つのコ ピーを 除 き、
残 り すべてのデバ ッ グセ ク シ ョ ン を 削 除 し ます。 こ の 結 果 、 イ メ ージのデバ ッ グサ
イ ズが 大 幅 に 縮 小 さ れます。
DWARF 3 では、 共 通 のデバッ グセ ク シ ョ ンは 共 通 グループに 配 置 されます。 armlink
は、 同 一 の 署 名 を 持 つ 各 グループについて、 1 つのコ ピーを 除 き、 残 り すべてを 削 除
します。
5.1.1 関 連 項 目
概 念
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ) .
• 共 通 グループま たは 共 通 セ ク シ ョ ンの 削 除 (5-4 ページ)
• 未 使 用 セ ク シ ョ ンの 削 除 (5-6 ページ)
• 未 使 用 仮 想 関 数 の 削 除 (5-8 ページ) .
参 照
『コンパイ ラ リ ファレンス』 :
• --debug、 --no_debug (3-63 ページ) .
『アセンブラ リ フ ァ レンス』 :
• --debug (2-9 ページ) .
その 他 の 情 報
• The DWARF Debugging Standard web site, http://www.dwarfstd.org/
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-3
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.2 共 通 グループまたは 共 通 セ ク シ ョ ンの 削 除
ARM コ ンパイ ラ は、 リ ン ク 用 の 完 全 なオブジ ェ ク ト を 生 成 し ます。 そのため、
• C および C++ ソースに イ ン ラ イ ン 関 数 が 含 まれてい る 場 合 、 各 オブジ ェ ク ト に
それぞれが 必 要 とする イ ン ラ イ ン 関 数 のア ウ ト オブラ イ ン コ ピーが 保 持 されま
す。
• C++ ソース 内 でテンプレートが 使 用 されている 場 合 、 各 オブジェクトにそれぞ
れが 必 要 と する テンプレー ト 関 数 が 保 持 さ れます。
こ の よ う な 関 数 が 共 通 ヘ ッ ダフ ァ イルで 宣 言 さ れてい る 場 合 、 関 数 は、 その 後 リ ン
ク する 各 オブジ ェ ク ト 内 で 何 度 も 定 義 さ れる 可 能 性 があ り ますコ ンパ イ ラ では、 重
複 を 回 避 する ために、 こ れら の 関 数 を 共 通 コー ド セ ク シ ョ ン ま たは 共 通 グループの
個 々の イ ン ス タ ン スに コ ンパ イ ルし ます
共 通 コー ド セ ク シ ョ ン ま たは 共 通 グループの 個 々の イ ン ス タ ン スが 同 一 でない 場 合
も あ り ます。 例 えば、 コ ピーの 一 部 は、 異 な る (ただ し 互 換 性 あ る) ビル ド オプ
ション、 最 適 化 、 またはデバッグオプションを 使 用 してビルドされたライブラリ 内
で 検 出 さ れる 場 合 があ り ます。
コ ピーが 同 一 でない 場 合 、 armlink は、 入 力 オブジ ェ ク ト の 属 性 に 基 づき、 各 共 通
コード セ ク シ ョ ン または 各 共 通 グループの 最 も 可 用 性 の 高 いバ リ アン ト を 保 持 し、
それ 以 外 のバ リ アン ト を 破 棄 し ます。
コ ピーが 同 一 であ る 場 合 、 armlink は、 最 初 に 検 出 し たセ ク シ ョ ン またはグループを
保 持 し ます。
この 最 適 化 は、 以 下 のリ ンカオプシ ョ ンを 使 用 して 制 御 します。
• --bestdebug オプシ ョ ン を 使 用 する と 、 最 大 の 共 通 データ (COMDAT) グループ
を 使 用 でき ます ( 最 適 なデバッ グビ ューが 提 供 される 可 能 性 が 高 く な り ます)。
• --no_bestdebug オプシ ョ ン を 使 用 する と 、 最 小 の COMDAT グループを 使 用 でき
ます (コードサイズを 最 も 小 さ くできる 可 能 性 が 高 くなり ます)。 これがデ
フォルトす。
--no_bestdebug がデフ ォル ト なので、 --debug を 使 用 してコンパイル 中 にデバッグ
テーブルを 生 成 するかど うかに 関 係 なく、 最 終 イ メージは 同 じになり ます。
5.2.1 関 連 項 目
概 念
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ) .
• 共 通 デバ ッ グセ ク シ ョ ンの 削 除 (5-3 ページ)
• 未 使 用 セ ク シ ョ ンの 削 除 (5-6 ページ)
• 未 使 用 仮 想 関 数 の 削 除 (5-8 ページ) .
『コンパイ ラの 使 用 』 :
• インライン 関 数 (6-31 ページ) .
参 照
『リンカリファレンス』:
• --bestdebug、 --no_bestdebug (2-21 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-4
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
『コンパイ ラ リ ファレンス』 :
• --debug、 --no_debug (3-63 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-5
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.3 未 使 用 セ ク シ ョ ンの 削 除
未 使 用 セ ク シ ョ ンの 削 除 は、 リ ン カに よ って 実 行 さ れる、 イ メ ージサ イ ズに 対 する
最 も 重 要 な 最 適 化 です。 リ ン カに よ っ て、 ア ク セス さ れない コー ド と データ が 最 終
イ メ ージか ら 削 除 さ れます。
未 使 用 セ ク シ ョ ンの 削 除 は、 結 果 と し てすべてのセ ク シ ョ ンが 削 除 さ れる よ う な 場
合 には 実 行 されません。
この 最 適 を 制 御 するには、--remove、 --no_remove、 --first、 --last、 および --keep リン
カオプシ ョ ンを 使 用 します。
未 使 用 セ ク シ ョ ンを 削 除 するには、 エン ト リ ポイ ン ト が 必 要 です。 そのため、 未 使
用 セ ク シ ョ ンの 削 除 が 有 効 な 場 合 に、 イ メ ージにエン ト リ ポイ ン ト が 指 定 されてい
ないと きは、 --entry リ ンカオプシ ョ ンを 使 用 して、 エン ト リ ポイン ト を 指 定 し、 未
使 用 セ ク シ ョ ン を 削 除 で き る よ う に し ます。
注
デフォル ト では、 --dll を 使 用 して DLL を ビル ド する 場 合 、 ま たは --shared を 使 用 し
て 共 有 ラ イ ブ ラ リ を ビル ド する 場 合 、 未 使 用 セ ク シ ョ ンの 削 除 は 無 効 にな り ます。
そのため、 未 使 用 セ ク シ ョ ンの 削 除 を 再 度 有 効 にする には、 --remove を 明 示 的 に 含 め
る 必 要 があ り ます。
--info unused リンカオプションを 使 用 すると、 削 除 された 未 使 用 セクションのリスト
を 生 成 でき ます。
入 力 セ ク シ ョ ンは、 以 下 の 場 合 に 最 終 イ メ ージに 保 持 さ れます。
• エン ト リ ポイン ト が 含 まれている 場 合
• エン ト リ ポ イ ン ト を 含 む 入 力 セ ク シ ョ ンか ら 非 弱 参 照 に よ って、 直 接 的 ま たは
間 接 的 に 参 照 さ れる 場 合
• --first オプシ ョ ンまたは --last オプシ ョ ン (あるいはこれと 同 じ 意 味 を 持 つス
キ ャ ッ タ ロー ド の 記 述 ) を 使 用 し て、 最 初 ま たは 最 後 の 入 力 セ ク シ ョ ン と し て
指 定 さ れてい る 場 合
• --keep オプシ ョ ンによ って 削 除 不 可 と してマーク されている 場 合
注
通 常 、 コ ンパ イ ラ は 関 数 と データ を 一 緒 にま と め、 カテゴ リ ご と に 1 つのセ ク シ ョ
ン を 生 成 し ます。 リ ンカでは、 セ ク シ ョ ン 全 体 が 未 使 用 の 場 合 のみ、 そのセ ク シ ョ
ンを 削 除 できます。
ソースコード 内 の 関 数 または 変 数 は、__attribute__((used)) 属 性 を 使 用 し てマーク で
きます。 そうすると、armcc に よ って 各 関 数 および 変 数 に 対 し てシンボル
__tagsym$$used が 生 成 され、 関 数 や 変 数 がリ ンカによって 削 除 されるこ とがなくなり
ます。
また、--split_sections コンパイラコマンドラインオプションを 使 用 して、 ソース
フ ァ イ ル 内 の 関 数 ご と に 1 つの ELF セ ク シ ョ ン を 生 成 する よ う にコ ンパ イ ラ に 指 示
する と もできます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-6
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.3.1 関 連 項 目
概 念
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• 弱 参 照 と 定 義 について (4-35 ページ)
• 共 通 デバ ッ グセ ク シ ョ ンの 削 除 (5-3 ページ)
• 共 通 グループま たは 共 通 セ ク シ ョ ンの 削 除 (5-4 ページ)
• 未 使 用 仮 想 関 数 の 削 除 (5-8 ページ) .
参 照
『リンカリファレンス』:
• --entry=location (2-58 ページ)
• --first=section_id (2-71 ページ)
• --info=topic[,topic,...] (2-80 ページ)
• --keep=section_id (2-89 ページ)
• --last=section_id (2-94 ページ)
• --remove、 --no_remove (2-136 ページ) .
『コンパイ ラ リ ファレンス』 :
• --split_sections (3-203 ページ)
• __attribute__((used)) 関 数 属 性 (5-56 ページ)
• __attribute__((used)) 変 数 属 性 (5-76 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-7
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.4 未 使 用 仮 想 関 数 の 削 除
未 使 用 セ ク シ ョ ンの 削 除 を 使 用 する と 、 未 使 用 関 数 を 効 率 的 に C コードから 削 除 で
きます。 C++ アプ リ ケーシ ョ ンでは、 仮 想 関 数 やランタイム 型 情 報 (RTTI) オブ
ジェク トが、 vtable と 呼 ばれる ポ イ ン タ テーブルに よ って 参 照 さ れています。 追 加 の
情 報 がない と 、 リ ン カではどの vtable エン ト リ が 実 行 時 にア ク セ ス さ れる のか 判 断 で
き ません。 つま り 、 リ ン カで 使 用 さ れてい る 標 準 の 未 使 用 セ ク シ ョ ン 削 除 アルゴ リ
ズムでは、 未 使 用 の 仮 想 関 数 RTTI オブジ ェ ク ト を 確 実 に 削 除 する こ と を 保 証 で き ま
せん。
仮 想 関 数 の 削 除 (VFE) は、 C++ コードから 生 成 されたイ メージの ROM サイズを 縮
小 するために 未 使 用 セクシ ョ ンの 削 除 を 改 良 したものです。 この 最 適 化 を 使 用 する、
未 使 用 の 仮 想 関 数 および RTTI オブジェ ク ト をコードから 削 除 でき ます。
複 数 の 関 数 が 含 まれる 入 力 セ ク シ ョ ンについては、 すべての 関 数 が 未 使 用 の 場 合 に
のみ 削 除 さ れます。 リ ンカは、 未 使 用 関 数 を 含 むセ ク シ ョ ン 内 ら、 未 使 用 関 数 を 削
除 する こ と はで き ません。
VFE は ARM コ ンパイ ラ と リ ン カに よ る 連 携 です。 コ ンパイ ラ が 未 使 用 の 仮 想 関 数 に
関 する 追 加 情 報 を リ ンカに 提 供 し、 リ ン カがその 情 報 を 使 用 し ます。 コ ンパイ ラ に
よ る 分 析 に 基 づき、 リ ンカは 未 使 用 の 仮 想 関 数 および RTTI オブジェ ク ト を 確 実 に 削
除 でき ます。
注
VFE を 使 用 する 場 合 は、 C++ を 使 用 するすべてのオブジ ェ ク ト に VFE の 注 釈 が 含 ま
れてい る 必 要 があ り ます。 リ ンカがオブジ ェ ク ト のシンボルテーブル 内 で 符 号 化 さ
れた C++ シンボル 名 を 検 出 し、 VFE 情 報 が 存 在 し ない 場 合 、 こ の 最 適 化 は 無 効 にな
ります。
コンパイラは、.arm_vfe と い う 名 前 で 始 ま る セ ク シ ョ ンに 追 加 情 報 を 配 置 し ます。 こ
れらのセクショ ンは VFE に 対 応 し ていない 場 合 、 リ ン カに よ っ て 無 視 さ れます。
5.4.1 関 連 項 目
概 念
• 共 通 デバ ッ グセ ク シ ョ ンの 削 除 (5-3 ページ)
• 共 通 グループま たは 共 通 セ ク シ ョ ンの 削 除 (5-4 ページ)
• 未 使 用 セ ク シ ョ ンの 削 除 (5-6 ページ) .
参 照
『リンカリファレンス』:
• --vfemode=mode (2-189 ページ) .
『コンパイ ラ リ ファレンス』 :
• --rtti、 --no_rtti (3-195 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-8
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.5 リンカフィードバックについて
リンカフィードバックはコンパイラとリンカによる 連 携 です。それによって、ELF
イ メ ージか ら 削 除 で き る 未 使 用 コー ド の 量 を 増 やす こ と がで き ます。
フ ィ ー ド バ ッ ク オプシ ョ ン を 使 用 する と 、 未 使 用 の 関 数 と 、 リ ンカに よ って イ ン ラ
イ ン 化 さ れた 関 数 の リ ス ト を 含 むテキ ス ト フ ァ イ ルが 生 成 さ れます。 こ の 情 報 を コ
ンパイ ラにフ ィ ード バッ ク し て、 これらの 関 数 が 独 自 のセ ク シ ョ ンに 配 置 されたオ
ブジ ェ ク ト を 再 度 ビル ド で き ます。 そ う す と 、 通 常 の 未 使 用 セ ク シ ョ ンの 削 除 中 に、
リンカはこれらのセクションを 削 除 することができます。
フィードバックファイルの 形 式 は 以 下 のとおりです。
;## ARM Linker, RVCTN.n [Build num]:Last Updated:day mmm dd hh:mm:ss yyyy
;VERSION 0.2
;FILE filename.o unused_function

リ ン カの 最 適 化 の 使 用
参 照
『リンカリファレンス』:
• --feedback=file (2-66 ページ)
• --feedback_image=option (2-67 ページ)
• --feedback_type=type (2-68 ページ)
• --inline、 --no_inline (2-85 ページ)
• --scatter=file (2-144 ページ) .
『コンパイ ラ リ ファレンス』 :
• --feedback=filename (3-100 ページ) .
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• 第 5 章 ARM と Thumb のインターワーク .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-10
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.6 リ ン カ フ ィ ー ド バ ッ クの 使 用 例
リンカフィードバックの 動 作 を 確 認 するには
1. こ の 例 に 示 すコー ド を 含 む fb.c という 名 前 のファイルを 作 成 します。
例 5-1 フ ィードバックの 例
#include
void legacy()
{
printf("This is a legacy function that is no longer used.\n");
}
int cubed(int i)
{
return i*i*i;
}
void main()
{
int n = 3;
printf("%d cubed = %d\n",n,cubed(n));
}
2. 以 下 の コ マン ド ラ イ ン を 実 行 し て、 プ ロ グ ラ ム を コ ンパ イ ルし、 フ ィ ー ド バ ッ
ク フ ァ イルが 存 在 し ない こ と を 示 す 警 告 メ ッ セージは 無 視 し ます。
armcc --asm -c --feedback fb.txt fb.c
これによ り、 デフォルトでは cubed() 関 数 が イ ン ラ イ ン 化 さ れます。 ま た、 アセ
ンブラファ イル fb.s とオブジェク トファイル fb.o が 作 成 されます。 アセンブラ
ファイルには、legacy() と cubed() のコードが 残 っていますが、 インライン 化 に
より、main から cubed() を 呼 び 出 すこ と はあ り ません。
cubed() のアウ ト オブラ インコピーは、 static と して 宣 言 されていないため、 保
持 されています。
3. 以 下 の コ マン ド ラ イ ン を 実 行 し て、 オブジ ェ ク ト フ ァ イ ルを リ ン ク し、 リ ン カ
フィードバックファイルを 作 成 します。
armlink --info sizes --list fbout1.txt --feedback fb.txt fb.o -o fb.axf
リ ンカに よ る 診 断 結 果 がフ ァ イル fbout1.txt に 出 力 されます。
リンカフィードバックファイルは、(コンパイラで 使 用 されない) コメントと
し て 未 使 用 の 関 数 を 含 み、 かつ legacy() 関 数 と cubed() 関 数 のエン ト リ を 含 んで
い る ソ ース フ ァ イルを 特 定 し ます。 以 下 に 例 を 示 し ます。
;## ARM Linker, RVCT ver [Build num]:Last Updated:Date
;VERSION 0.2
;FILE fb.o
cubed

リ ン カの 最 適 化 の 使 用
armlink --info sizes --list fbout2.txt fb.o -o fb.axf
5. 2 つの 診 断 フ ァ イル fbout1.txt と fbout2.txt を 比 較 し、 イ メージのコンポーネン
ト ( 例 えば、 Code、 RO Data、 RW Data、 ZI Data) のサ イ ズを 確 認 し ます。 Code
コンポーネントが 小 さ くなります。
アセンブラファ イル fb.s には、 legacy() 関 数 と cubed() 関 数 が メ イ ンの .text 領
域 に 存 在 し ません。 こ れら の 関 数 は 関 数 独 自 の ELF セクションにコンパイルさ
れます。 そのため、armlink は 最 終 イ メ ージか ら legacy() 関 数 と cubed() 関 数 を 削
除 でき ます。
注
リ ンカ フ ィ ー ド バ ッ ク を 最 大 限 に 活 用 する には、 完 全 な コ ンパイル と リ ン ク を 2 回
以 上 実 行 する 必 要 があ り ます。 ただ し、 通 常 は、 前 回 のビル ド フ ィ ー ド バ ッ ク を 使
用 して 1 回 コ ンパ イ ル し て リ ン ク すれば 十 分 です。
5.6.1 関 連 項 目
概 念
• リンカフィードバックについて (5-9 ページ) .
参 照
『リンカリファレンス』:
• --feedback=file (2-66 ページ)
• --feedback_image=option (2-67 ページ)
• --feedback_type=type (2-68 ページ)
• --info=topic[,topic,...] (2-80 ページ)
• --list=file (2-103 ページ)
• --scatter=file (2-144 ページ) .
『コンパイ ラ リ ファレンス』 :
• --asm (3-27 ページ)
• -c (3-36 ページ)
• --feedback=filename (3-100 ページ) .
• --inline、 --no_inline (3-129 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-12
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.7 リンク 時 コード 生 成 について
リンク 時 コード 生 成 (LTCG) を 使 用 する と 、 リ ン ク 段 階 まで コー ド 生 成 を 遅 らせる
こ と で、 ク ロ ス ソース フ ァ イル 最 適 化 を 実 行 で き ます。 こ れに よ り 、 コー ド サ イ ズ
を 大 幅 に 縮 小 でき ます。 LTCG を 有 効 にするには、 -c --ltcg を 使 用 してソースをコン
パ イルし て、 オブジ ェ ク ト を 中 間 形 式 で 作 成 し ます。 コー ド 生 成 を 実 行 する よ う に
リ ンカに 指 示 する には、 --ltcg を 使 用 してこれらのオブジェ ク ト フ ァ イルを リ ンクす
る 必 要 があ り ます。
armcc と armlink のどちらにも、 LTCG を 有 効 にする --ltcg コマンド ラインオプショ ン
が 用 意 されています。
注
LTCG は 廃 止 予 定 の 機 能 です。 代 替 の ARM コマンド として、--multifile コンパイラ
オプシ ョ ンを 使 用 し ます。
5.7.1 LTCG 使 用 時 の 注 意 事 項
LTCG を 使 用 する 際 は、 以 下 の 点 に 注 意 し て 下 さ い。
• 入 力 オブジ ェ ク ト が --ltcg を 使 用 し て コ ンパ イル さ れていない 場 合 、 最 終 オブ
ジェク トは、 LTCG を 使 用 しないで 生 成 された 最 終 オブジェ ク ト と 同 じにな り
ます。
• --ltcg を 使 用 してコンパイルされたオブジェ ク ト ファ イルには、 デバッグ 情 報
は 保 持 されません。 ただし、 --ltcg を 使 用 してコンパイルされていないオブ
ジ ェ ク ト フ ァ イ ルには、 デバ ッ グ 情 報 は 保 持 さ れます。
• LTCG では、 リ ン ク 用 に 一 時 的 なオブジ ェ ク ト フ ァ イルを 作 成 し て 使 用 する た
め、 スキャ ッ タフ ァ イルで 特 定 のオブジェ ク ト フ ァ イル 名 を 使 用 できせん。 ス
キ ャ ッ タ フ ァ イルを 使 用 する 場 合 、 ワ イル ド カー ド * を 使 用 してフ ァ イルを 一
致 させる 必 要 があ り ます。 そ う し ない と 、 一 時 フ ァ イル と 一 致 し ません。
• リ ンカに 渡 す 入 力 オブジ ェ ク ト フ ァ イルに 複 数 のエン ト リ ポ イ ン ト があ る 場
合 、 リ ン カに よ っ てすべてのエン ト リ ポ イ ン ト が ク リ ア さ れます。 そため、 以
下 のオプシ ョ ンを 使 用 し て、 リ ンカ コマン ド ラ イ ンでエン ト リ ポ イ ン ト を 1 つ
指 定 する 必 要 があ り ます。
--entry=symbol
エン ト リ ポ イ ン ト を 含 む 入 力 セ ク シ ョ ンは 削 除 さ れません。 例 えば、 --ltcg を
使 用 し ないでオブジ ェ ク ト を ビル ド し た 場 合 は 削 除 さ れません。
注
リンカオプション --entry=object(symbol) は、 LTCG 使 用 時 はサポー ト さ れませ
ん。
5.7.2 例
以 下 の 例 では、 LTCG の 一 般 的 な 使 用 方 法 を 示 し ています。
1. --ltcg を 使 用 して、ELF オブジェ ク ト フ ァ イル one.o および two.o を 作 成 し ます。
armcc -c --ltcg one.c -o one.o
armcc -c --ltcg two.c -o two.o
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-13
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
コ ンパイ ラ に よ って、 オブジ ェ ク ト フ ァ イルへの 中 間 コー ド が 生 成 さ れます。
2. 以 下 の コ マン ド を 使 用 し て、 フ ァ イ ルを リ ン ク し ます。
armlink --ltcg one.o two.o -o ltcg_image.axf
リ ンカによ って、 以 下 の 処 理 が 行 われます。
1. すべての 中 間 コー ド を 結 合 し ます。 それに よ って、 元 のオブジ ェ ク ト フ ァ イル
名 への リ ン ク が 失 われます。
2. 中 間 コー ド に 対 し て コー ド 生 成 を 実 行 し ます。
3. 出 力 イ メ ージ を 作 成 し ます。
5.7.3 リンク 時 コード 生 成 によって 生 成 される 中 間 オブジェクトファイルについて
リンク 時 コード 生 成 (LTCG) によって 生 成 される 中 間 ELF オブジェ ク ト フ ァ イルに
は、 .il という 名 前 のセクションが 含 まれます。 このセクションは、 フラグ
SHF_EXECINSTR および SHF_ALLOC でマーク されます。
上 記 の 例 の 中 間 オブジェ ク ト フ ァ イル one.o では、 fromelf コマンドを 使 用 して、 これ
らのセクシ ョ ンを 表 示 できます。 以 下 に 例 を 示 します。
fromelf --text -v one.o
...
====================================
** Section #1
Name :.il
Type :SHT_PROGBITS (0x00000001)
Flags :SHF_ALLOC + SHF_EXECINSTR (0x00000006)
...
Link :SHN_UNDEF
...
====================================
** Section #3
Name :.rel.il
Type :SHT_REL (0x00000009)
Flags :None (0x00000000)
...
Link :Section 2 (.symtab)
Info :Section 1 (.il)
...
====================================
...
5.7.4 関 連 項 目
参 照
『リンカリファレンス』:
• --entry=location (2-58 ページ)
• --ltcg (2-107 ページ) .
『コンパイ ラ リ ファレンス』 :
• -c (3-36 ページ)
• --ltcg (3-152 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-14
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
• --multifile, --no_multifile (3-159 ページ) .
『fromelf イ メ ージ 変 換 ユーテ ィ リ テ ィ の 使 用 』 :
• --text (4-76 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-15
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.8 RW デー タ 圧 縮 を 使 用 し た 最 適 化
通 常 、 RW データ 領 域 には、 ゼ ロ な どの 繰 り 返 し の 値 が 多 数 含 まれる ため、 こ の 領 域
は 圧 縮 に 適 し ています。 ROM サイズを 小 さ くするため、 RW データ 圧 縮 はデフ ォル
ト で 有 効 になっています。
データは、 リ ン カに よ っ て 圧 縮 さ れます。 こ のデータ が、 実 行 時 に ターゲ ッ ト 上 で
伸 張 さ れます。
ARM ラ イ ブ ラ リ にはい く つかの 伸 張 アルゴ リ ズムがあ り 、 リ ン カは、 イ メ ージの 実
行 時 にデータ 領 域 を 伸 張 するのに 最 適 なアルゴ リ ズムを 選 択 し て、 イ メ ージに 追 加
します。 リンカによって 選 択 されたアルゴリズムはオーバーライドできます。
5.8.1 関 連 項 目
概 念
• 圧 縮 の 適 用 方 法 (5-20 ページ) .
タスク
• リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド (5-18 ページ)
• RW データ 圧 縮 の 使 用 (5-21 ページ) .
概 念
• リ ンカに よ る コ ンプレ ッ サの 選 択 方 法 (5-17 ページ)
• 圧 縮 の 適 用 方 法 (5-20 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-16
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.9 リ ン カによ る コ ン プ レ ッ サの 選 択 方 法
armlink は、 データ セ ク シ ョ ンの 内 容 に 関 する 情 報 を 収 集 し てか ら、 イ メ ージを 最 も
小 さ く する のに 最 適 な 圧 縮 アルゴ リ ズム を 選 択 し ます。 圧 縮 が 適 し てい る 場 合 、 リ
ンカは、 イ メ ージ 内 の 圧 縮 可 能 なすべてのデータ セ ク シ ョ ンに 対 し て 1 つのデータ
コンプレッサしか 使 用 できません。 そのため、 全 のサイズが 最 適 になるよ うに、 こ
れら のセ ク シ ョ ンに 対 し て さ ま ざ ま な 圧 縮 アルゴ リ ズム を 試 す 場 合 があ り ます。 以
下 の 場 合 は、 圧 縮 が 自 動 的 適 用 さ れます。
圧 縮 さ れ た デ ー タ サ イ ズ + デコンプレッサのサイズ < 未 圧 縮 のデータサイズ
コンプレッサが 選 択 されると、armlink によってイ メージのコード 領 域 にデコンプ
レ ッ サが 追 加 さ れます。 最 終 イ メ ージに 圧 縮 さ れたデータ が 含 まれていない 場 合 、
デコンプレッサは 追 加 されません。
5.9.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ)
• 圧 縮 の 適 用 方 法 (5-20 ページ) .
タスク
• リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド (5-18 ページ)
• RW データ 圧 縮 の 使 用 (5-21 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-17
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.10 リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド
リ ン カに よ っ て 使 用 さ れる 圧 縮 アルゴ リ ズムは、 以 下 のいずれかでオーバーラ イ ド
できます。
• --datacompressor off オプシ ョ ン を 使 用 し て 圧 縮 を 無 効 に し ます。
• 圧 縮 アルゴ リ ズム を 指 定 し ます。
圧 縮 アルゴ リ ズム を 指 定 する には、 リ ン カ コ マン ド ラ イ ンで 必 要 な コ ンプレ ッ サの
数 を 指 定 し ます。 以 下 に 例 を 示 し ます。
armlink --datacompressor 2 ...
リ ンカで 使 用 で き る 圧 縮 アルゴ リ ズムの 一 覧 を 取 得 する には、 コ マン ド ラ イ ンオプ
ション --datacompressor list を 使 用 します。
armlink --datacompressor list
...
Num Compression algorithm
========================================================
0 Run-length encoding
1 Run-length encoding, with LZ77 on small-repeats
2 Complex LZ77 compression
圧 縮 アルゴ リ ズムを 選 択 する と きは、 以 下 の 点 に 注 意 し て 下 さい。
• コンプレッサ 0 は、 値 がゼロの 領 域 が 大 き く 、 値 がゼロ 以 外 のバイ ト が 少 ない
データ に 対 し て う ま く 機 能 し ます。
• コンプレッサ 1 は、 ゼロ 以 外 の 値 が 繰 り 返 されるデータに 対 し て う ま く 機 能 し
ます。
• コンプレッサ 2 は、 同 じ 値 が 繰 り 返 さ れるバ イ ト を 含 むデータ に 対 し て う ま く
機 能 し ます。
リ ンカでは、 データ の 大 部 分 でゼ ロ が 繰 り 返 さ れる 場 合 (75% を 超 え る 場 合 ) は、
コンプレッサ 0 または 1 が 選 択 されます。 ゼロが 繰 り 返 されるバイ ト がほ と んどデー
タに 含 まれない 場 合 (10% 未 満 の 場 合 ) は、 コ ンプレ ッ サ 2 が 選 択 されます。 イ
メージが ARM コードのみで 構 成 されている 場 合 、 ARM デコ ンプレ ッ サが 自 動 的 に
使 用 さ れます。 イ メ ージに Thumb コードが 含 まれる 場 合 は、 Thumb デコンプレッサ
が 使 用 さ れます。 選 択 すべき コ ンプレ ッ サが 明 確 でない 場 合 は、 すべての コ ンプ
レッサをテス ト して、 全 体 のサイズが 最 適 になるものが 選 択 されます。
注
独 自 の コ ンプレ ッ サを リ ン カに 追 加 する こ と はで き ません。 使 用 可 能 なアルゴ リ ズ
ム、 および リ ンカに よ る アルゴ リ ズムの 選 択 方 法 は、 今 後 変 更 れる 可 能 性 があ り ま
す。
5.10.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ)
• リ ンカに よ る コ ンプレ ッ サの 選 択 方 法 (5-17 ページ)
• 圧 縮 の 適 用 方 法 (5-20 ページ) .
タスク
• RW データ 圧 縮 の 使 用 (5-21 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-18
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
参 照
『リンカリファレンス』:
• --datacompressor=opt (2-40 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-19
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.11 圧 縮 の 適 用 方 法
連 長 圧 縮 に よ り 、 データは 同 じ 値 が 繰 り 返 さ れないバイ ト およびゼ ロ が 繰 り 返 さ れ
るバイ ト 数 の 組 み 合 わせ と し てエン コード されます。 同 じ 値 が り 返 されないバイ ト
はそのまま 出 力 され、 その 後 、 ゼロが 繰 り 返 されるバイ ト 数 が 続 きます。 Limpel-Ziv
1977 (LZ77) 圧 縮 では、 読 み 込 まれたデータ 最 後 か ら n バイ トが 追 跡 されます。 既
に 読 み 込 まれたデータ に 存 在 する フ レーズが 検 出 さ れる と 、 既 に 読 み 込 まれたバ ッ
フ ァデータ 内 のフ レーの 位 置 と そのフ レーズの 長 さ と に 相 当 する 値 のペアが 出 力 さ
れます。
5.11.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ)
• リ ンカに よ る コ ンプレ ッ サの 選 択 方 法 (5-17 ページ) .
タスク
• リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド (5-18 ページ)
• RW データ 圧 縮 の 使 用 (5-21 ページ) .
参 照
『リンカリファレンス』:
• --datacompressor=opt (2-40 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-20
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.12 RW デー タ 圧 縮 の 使 用
RW データ 圧 縮 を 使 用 する と きは、 以 下 の 点 に 注 意 し て 下 さ い。
• リンカオプション --map を 使 用 する と 、 コー ド 内 の 領 域 で 圧 縮 が 適 用 さ れてい
る 場 所 を 表 示 できます。
• RealView Compilation Tools (RVCT) v4.0 以 降 の リ ンカでは、 圧 縮 領 域 か ら、
ロー ド 領 域 を 使 用 する リ ン カ 定 義 シンボルへの 参 照 が 存 在 する 場 合 、 RW 圧 縮
は 無 効 にな り ます。
• オンチップキャ ッシュを 搭 載 した ARM プロセッサを 使 用 している 場 合 は、
コー ド コ ヒ ーレ ンシの 問 題 を 回 避 する ために、 伸 張 後 にキ ャ ッ シ ュ を 有 効 に し
ます。
ARM ライブラリのコードを 使 用 して、__main を 実 行 する と 、 圧 縮 さ れたデータ セ ク
シ ョ ンは 実 行 時 に 自 動 的 に 伸 張 さ れます。 こ の コー ド はルー ト 領 域 に 配 置 する 必 要
があ り ます。 これにはスキャ ッ タファ イル 内 で InRoot$$Sections を 使 用 する のが 最 適
です。
ス キ ャ ッ タ フ ァ イルを 使 用 する 場 合 は、 NOCOMPRESS 属 性 を 追 加 し て、 ロー ド 領 域 およ
び 実 行 領 域 を 圧 縮 し ない よ う に 指 定 で き ます。
5.12.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ)
• リ ンカに よ る コ ンプレ ッ サの 選 択 方 法 (5-17 ページ)
• 圧 縮 の 適 用 方 法 (5-20 ページ)
• Load$$ 実 行 領 域 シンボル (7-7 ページ)
• 第 8 章 スキャッタファイルの 使 用 .
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• 第 3 章 組 み 込 みソ フ ト ウ ェ アの 開 発 .
タスク
• リンカによって 使 用 される 圧 縮 アルゴリズムのオーバーライド (5-18 ページ) .
参 照
『リンカリファレンス』:
• --map、 --no_map (2-109 ページ)
• 第 4 章 スキャッタファイルの 正 式 な 構 文 .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-21
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.13 リ ン カによ る 関 数 のイ ン ラ イ ン 化
リ ンカは 関 数 への 分 岐 命 令 を 使 用 する 代 わ り に、 小 さ な 関 数 を イ ン ラ イ ン 化 で き ま
す。 リ ン カが こ れを 行 う には、 関 数 ( 復 帰 命 令 は 含 ま ない) が 岐 命 令 の 4 バイ ト 以
内 に 収 ま る 必 要 があ り ます。
分 岐 の イ ン ラ イ ン 化 を 制 御 するには、 --inline コマンド ラインオプショ ンと
--no_inline コマンド ラインオプショ ンを 使 用 します。
分 岐 の イ ン ラ イ ン 化 の 最 適 化 を 有 効 にする と 、 リ ンカは イ メ ージ 内 の 各 関 数 呼 び 出
しをスキャンして、 必 要 に 応 じてインライン 化 します。 リンカ、 インライン 化 に 適
し た 関 数 を 検 出 する と 、 その 関 数 呼 び 出 し を 呼 び 出 し 先 関 数 の 命 令 に 置 き 換 え ます。
リ ンカは、 未 使 用 セ ク シ ョ ンが 削 除 さ れる 前 に 分 岐 の イ ン ラ イ ン 化 の 最 適 化 を 適 用
する ので、 呼 び 出 さ れな く なった イ ン ラ イ ン 化 セ ク シ ョ ン も 削 で き ます。
注
リンカは 32 ビッ ト Thumb BL 命 令 の 代 わ り に、2 つの 16 ビッ ト 命 令 をインライン 化 で
きます。
インラ イン 化 関 数 をすべて リ ス ト 表 示 するには、 --info=inline コマンド ラインオプ
シ ョ ン を 使 用 し ます。
5.13.1 関 連 項 目
参 照
• 関 数 の イ ン ラ イ ン 化 に 影 響 を 与 え る 要 因 (5-23 ページ)
• 未 使 用 セ ク シ ョ ンの 削 除 (5-6 ページ) .
『リンカリファレンス』:
• --info=topic[,topic,...] (2-80 ページ)
• --inline、 --no_inline (2-85 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-22
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.14 関 数 のインライン 化 に 影 響 を 与 える 要 因
関 数 が イ ン ラ イ ン 化 さ れる 方 法 に 影 響 を 与 え る 要 因 は 以 下 の と お り です。
• リ ン カは、 最 も 単 純 な 命 令 だけを 処 理 し、 PC への 読 み 出 し または 書 き 込 みを 行
う 命 令 をインライン 化 しません。 これは、 PC への 読 み 出 しや 書 き 込 が 関 数 の 位
置 に 依 存 し ている ためです。
• イメージに ARM コード と Thumb コードの 両 方 が 含 まれている 場 合 、 も う 一 方
の 状 態 から 呼 び 出 される 関 数 はインターワーク 用 にビルド される 必 要 があ り ま
す。 リ ン カは 16 ビッ ト Thumb 命 令 を 2 つまで 含 む 関 数 を イ ン ラ イ ン 化 で き ま
すが、ARM の 呼 び 出 し 元 関 数 では、1 つの 16 ビッ ト Thumb 命 令 ま た 32 ビッ ト
Thumb 命 令 を 含 む 関 数 し か イ ン ラ イ ン 化 で き ません。
• リ ンカの 動 作 は、 呼 び 出 し 先 関 数 のサイ ズによ って 異 な り ます。 以 下 の 表 に、
呼 び 出 し 元 関 数 と 呼 び 出 し 先 関 数 の 両 方 の 状 態 を 示 し ます。
表 5-1 小 さ な 関 数 のイ ン ラ イ ン 化
呼 び 出 し 元 関 数
の 状 態
呼 び 出 し 先 関 数 の
状 態
呼 び 出 し 先 関 数 のサ
イズ
ARM ARM 4 ~ 8 バイ ト
ARM Thumb 2 ~ 6 バイ ト
Thumb Thumb 2 ~ 6 バイ ト
等 価 の 命 令 が 存 在 する 場 合 は、 異 な る 状 態 で も イ ン ラ イ ン 化 で き ます。 例 え
ば、 adds r0, r0 という Thumb 命 令 の 場 合 、 等 価 の ARM 命 令 を イ ン ラ イ ン 化 で
きます。ARM 命 令 と 等 価 な Thumb 命 令 はほ と んど ないため、 ARM から Thumb
にインライン 化 るこ とはできません。
• 関 数 を イ ン ラ イ ン 化 するには、 関 数 の 最 後 の 命 令 が 以 下 のいずれかであ る 必 要
があ り ます。
MOV pc, lr
または
BX lr
復 帰 のシーケ ン スだけで 構 成 さ れる 関 数 は、 NOP としてインライン 化 できます。
• 条 件 付 き ARM 命 令 は、 以 下 の 場 合 にのみイ ン ラ イ ン 化 で き ます。
— BL の 条 件 が、 イ ン ラ イ ン 化 する 命 令 の 条 件 と 一 致 する 場 合 。 例 えば、 BLEQ
でインライン 化 できるのは、ADDEQ の よ う な 条 件 が 一 致 する 命 令 だけです。
— BL 命 令 ま たは イ ン ラ イ ン 化 する 命 令 が 無 条 件 の 場 合 。 無 条 件 の ARM BL で
は、 他 のすべての 条 件 を 満 たす 任 意 の 条 件 付 き 命 令 ま たは 無 条 件 命 令 を イ
ンライン 化 できます。BL 命 令 が 条 件 付 きの 場 合 、 条 件 付 き では 実 行 で き な
い 命 令 はイ ン ラ イ ン 化 でき ません。
• 32 ビット Thumb If-Then (IT) ブロッ クの 最 後 の 命 令 である BL では、 16 ビッ ト
Thumb 命 令 、 あ る いは 32 ビッ ト MRS、 MSR、 または CPS 命 令 を イ ン ラ イ ン 化 で き
ません。 これは、 IT ブ ロ ッ ク に よ り その 有 効 範 囲 内 の 命 令 の 動 作 が 変 更 さ れる
ため、 命 令 をインラ イン 化 する と、 プログラムの 動 作 が 変 更 されるからです。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-23
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.14.1 関 連 項 目
概 念
• NOP に 最 適 化 される 分 岐 の 処 理 (5-25 ページ) .
『アセンブラの 使 用 』 :
• 条 件 付 き 命 令 (6-2 ページ) .
参 照
『アセンブラ リ フ ァ レンス』 :
• ADD、 SUB、 RSB、 ADC、 SBC、 RSC (3-55 ページ)
• B、 BL、 BX、 BLX、 BXJ (3-124 ページ)
• CPS (3-151 ページ)
• MOV、 MVN (3-67 ページ)
• MRS (3-146 ページ)
• MSR (3-148 ページ)
• IT (3-128 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-24
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.15 NOP に 最 適 化 される 分 岐 の 処 理
デフ ォル ト では、 リ ンカは 次 の 命 令 に 解 決 する 再 配 置 のあ る 分 岐 を NOP 命 令 に 置 き 換
え ます。 リ ン カが 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けを 行 う 場 合 は、 こ の 最 適 化
も 適 用 できます。
ただ し、 検 証 やパ イ プ ラ イ ンのフ ラ ッ シ ュ を 実 行 する 場 合 な ど、 こ のオプシ ョ ン を
無 効 にする こ と が 必 要 にな る 場 合 も あ り ます。
こ の 最 適 化 を 制 御 する には、 --branchnop コマンドラインオプショ ンと --no_branchnop
コマンド ラインオプショ ンを 使 用 します。
5.15.1 関 連 項 目
概 念
• 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けについて (5-26 ページ) .
参 照
『リンカリファレンス』:
• --branchnop、 --no_branchnop (2-25 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-25
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.16 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けについて
Tail の 呼 び 出 しセクションとは、 セクションの 終 わりに 分 岐 命 令 を 含 むセクションで
す。 分 岐 命 令 に 別 のセ ク シ ョ ンの 先 頭 にあ る 関 数 を ターゲ ッ と する 再 配 置 が 含 まれ
てい る 場 合 、 リ ンカは 呼 び 出 し 先 セ ク シ ョ ンの 直 前 に 末 尾 呼 び 出 し セ ク シ ョ ン を 配
置 で き ます。 そ う する と 、 末 尾 呼 び 出 し セ ク シ ョ ンの 終 わ り にあ る 分 岐 命 令 を NOP 命
令 に 最 適 化 で き ます。
コマンド ラインオプショ ン --tailreorder を 使 用 し て 末 尾 呼 び 出 し セ ク シ ョ ン を ター
ゲ ッ ト の 直 前 に 移 動 する と 、 こ の 動 作 を 利 用 で き ます。
リ ンカに よ って 実 行 さ れる 末 尾 呼 び 出 し の 最 適 化 に 関 する 情 報 を 表 示 する には、
--info=tailreorder コマンド ラインオプショ ンを 使 用 します。
5.16.1 関 連 項 目
概 念
• ベニアのタ イプ (4-29 ページ)
• NOP に 最 適 化 される 分 岐 の 処 理 (5-25 ページ)
• 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けに 関 する 制 限 (5-27 ページ) .
参 照
『リンカリファレンス』:
• --info=topic[,topic,...] (2-80 ページ)
• --tailreorder、 --no_tailreorder (2-173 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-26
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.17 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けに 関 する 制 限
リ ンカによ って、 以 下 の 処 理 が 行 われます。
• 移 動 で き る のは、 末 尾 呼 び 出 し ターゲ ッ ト 1 つにつき 1 つの 末 尾 呼 び 出 し セ ク
ションのみです。1 つのセ ク シ ョ ンに 対 し て 複 数 の Tail 呼 び 出 し があ る 場 合 、
同 じセクシ ョ ン 名 の 付 いた Tail の 呼 び 出 しセ ク シ ョ ンがターゲ ッ ト の 前 に 移 動
さ れます。 末 尾 呼 び 出 し セ ク シ ョ ンで 名 前 が 一 致 する セ ク シ ョ ン 名 が 見 つか ら
ない 場 合 、 リ ンカは、 最 初 に 検 出 し たセ ク シ ョ ン を 移 動 し ます。
• 末 尾 呼 び 出 し セ ク シ ョ ン をその 実 行 領 域 外 に 移 動 で き ません。
• 末 尾 呼 び 出 し セ ク シ ョ ン を イ ン ラ イ ンベニアの 前 には 移 動 し ません。
5.17.1 関 連 項 目
概 念
• 末 尾 呼 び 出 し セ ク シ ョ ンの 再 順 序 付 けについて (5-26 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-27
ID 111311
Non-Confidential

リ ン カの 最 適 化 の 使 用
5.18 コメントセクションのマージについて
入 力 オブジ ェ ク ト フ ァ イ ルに 同 一 の .comment セ ク シ ョ ンが 含 まれてい る 場 合 、 リ ンカ
は 有 益 な 情 報 をすべて 保 持 したまま、 それらのセクシ ョ ンをマージして、 最 も 小 さ
い .common セ ク シ ョ ン を 生 成 し ます。
リンカは 各 .comment 入 力 セ ク シ ョ ン を 対 応 する 入 力 オブジ ェ ク ト のフ ァ イル 名 と 関 連
付 けます。 同 一 の .comment セ ク シ ョ ン をマージ し た 場 合 、 セ ク シ ョ ンの 内 容 の 前 に、
共 通 のセ ク シ ョ ン を 含 むすべてのフ ァ イル 名 が リ ス ト さ れます。 以 下 に 例 を 示 し ま
す。
file1.o
file2.o
.comment セクショ ンの 内 容
デフォル ト では、 リ ンカはこ う したセクシ ョ ンをマージします。 同 一 の .comment セク
ションがマージされないようにするには、--no_filtercomment コマンド ラインオプショ
ンを 使 用 します。
注
.comment セクシ ョ ン 内 の 情 報 を 保 持 する 必 要 がない 場 合 は、 --no_comment_section オプ
ションを 使 用 して、 イメージにこのセクションが 含 まれないようにできます。
5.18.1 関 連 項 目
参 照
『リンカリファレンス』:
• --comment_section、 --no_comment_section (2-34 ページ)
• --filtercomment、 --no_filtercomment (2-69 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 5-28
ID 111311
Non-Confidential

第 6 章
イ メ ージに 関 する 情 報 の 取 得
以 下 の 各 ト ピ ッ ク では、 armlink か ら イ メ ージ 情 報 を 取 得 する 方 法 について 説 明 し ます。
タスク
• 一 部 の リ ン ク エ ラーの 原 因 の 特 定 (6-3 ページ)
• リ ンク 時 のシンボルの 場 所 を 調 べる 方 法 (6-6 ページ) .
概 念
• イ メ ージに 関 する 情 報 を 取 得 する ための リ ンカオプシ ョ ン (6-2 ページ)
• --info リ ン カオプシ ョ ンの 使 用 例 (6-4 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-1
ID 111311
Non-Confidential

イ メ ージに 関 する 情 報 の 取 得
6.1 イメージに 関 する 情 報 を 取 得 するためのリンカオプション
以 下 のオプシ ョ ン を 使 用 し て、 リ ン カで イ メ ージがどの よ う に 生 成 さ れたのかに 関
する 情 報 を 取 得 で き ます。
--info=topic[,topic,...]
さ ま ざ ま な ト ピ ッ ク に 関 する 情 報 が 表 示 さ れます。
--map
イメージのメモリマップを 表 示 します。 このマップには、 イメージの 各
ロー ド 領 域 、 実 行 領 域 、 および 入 力 セ ク シ ョ ン ( リ ン カに よ って 生 成 さ
れ 入 力 セ ク シ ョ ン を 含 む) のア ド レ ス と サ イ ズが 含 まれます。 ま た、
RW データ 圧 縮 の 適 用 方 法 も 表 示 さ れます。
--section_index_display
--map と 組 み 合 わせて 使 用 して、 インデクス 列 の 表 示 を 変 更 します。
--show_cmdline
リンカによって 使 用 されたコマンドラインを 出 力 します。
--symbols
--verbose
--xref
--xrefdbg
リ ンク 手 順 で 使 用 される 各 ローカルシンボルとグローバルシンボル、 お
よびその 値 を 一 覧 表 示 し ます。
含 まれるオブジェ ク トやそれらを 含 むラ イブラ リ など、 リ ンク 操 作 につ
いての 詳 細 情 報 を 表 示 し ます。
入 力 セ ク シ ョ ン 間 のすべての 相 互 参 照 を 一 覧 表 示 し ます。
入 力 デバ ッ グセ ク シ ョ ン 間 のすべての 相 互 参 照 を 一 覧 表 示 し ます。
--list=file オプシ ョ ン を 使 用 する と 、 情 報 を フ ァ イ ルに 書 き 出 す こ と がで き ます。
6.1.1 関 連 項 目
概 念
• リ ンカに よ る セ ク シ ョ ンの 境 界 調 整 (4-23 ページ)
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ) .
• 一 部 の リ ン ク エ ラーの 原 因 の 特 定 (6-3 ページ)
• --info リンカオプションの 使 用 例 (6-4 ページ)
参 照
『リンカリファレンス』:
• --info=topic[,topic,...] (2-80 ページ)
• --list=file (2-103 ページ)
• --map、 --no_map (2-109 ページ)
• --section_index_display=type (2-147 ページ)
• --show_cmdline (2-149 ページ)
• --symbols、 --no_symbols (2-167 ページ)
• --verbose (2-187 ページ)
• --xref、 --no_xref (2-194 ページ)
• --xrefdbg、 --no_xrefdbg (2-195 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-2
ID 111311
Non-Confidential

イ メ ージに 関 する 情 報 の 取 得
6.2 一 部 のリ ン ク エ ラーの 原 因 の 特 定
--info inputs を 使 用 する と 、 い く つかの リ ン ク エ ラーの 原 因 を 特 定 で き ます。 例 え
ば、 出 力 を 検 索 する と 、 ラ イ ブ ラ リ オブジ ェ ク ト か ら 未 定 義 の 参 照 を 探 し た り 、 ラ
イ ブ ラ リ 関 数 を 再 びターゲ ッ ト にする こ と で 定 義 さ れる シンボルやその 他 のシンボ
ルを 増 加 させた り する こ と がで き ます。 リ ン ク エ ラーをつけて 解 決 するには、 こ の
出 力 の 最 後 か ら 逆 方 向 に 検 索 し ます。
--verbose オプシ ョ ン を 使 用 する と 、 同 様 の 内 容 に 加 えて、 リ ンカ 処 理 についての 追
加 情 報 を 出 力 する こ と も で き ます。
6.2.1 関 連 項 目
概 念
• イメージに 関 する 情 報 を 取 得 するためのリンカオプション (6-2 ページ) .
参 照
『リンカリファレンス』:
• --info=topic[,topic,...] (2-80 ページ)
• --verbose (2-187 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-3
ID 111311
Non-Confidential

イ メ ージに 関 する 情 報 の 取 得
6.3 --info リ ン カオプシ ョ ンの 使 用 例
リ ン ク 時 の コ ンポーネン ト サ イ ズを 表 示 するには、 以 下 のコ マン ド を 入 力 し ます。
armlink --info sizes ...
ここでは、sizes によって、 イ メージ 内 の 入 力 オブジェク トおよびライブラ リのメン
バご と にコー ド と データ のサ イ ズが 一 覧 表 示 さ れます。 こ のオプシ ョ ン を 使 用 する
と、--info sizes,totals を 指 定 したこ とにな り ます。
以 下 の 例 では、 出 力 が 表 形 式 で 示 さ れ、 合 計 は 読 みやす く する ために 区 別 さ れてい
ます。
例 6-1 イメージコンポーネントのサイズ 情 報
Code (inc. data) RO Data RW Data ZI Data Debug
3712 1580 19 44 10200 7436 Object Totals
0 0 16 0 0 0 (incl. Generated)
0 0 3 0 0 0 (incl. Padding)
21376 648 805 4 300 10216 Library Totals
0 0 6 0 0 0 (incl. Padding)
===============================================================================
Code (inc. data) RO Data RW Data ZI Data Debug
25088 2228 824 48 10500 17652 Grand Totals
25088 2228 824 48 10500 17652 ELF Image Totals
25088 2228 824 48 0 0 ROM Totals
===============================================================================
Total RO Size (Code + RO Data)
Total RW Size (RW Data + ZI Data)
Total ROM Size (Code + RO Data + RW Data)
25912 ( 25.30kB)
10548 ( 10.30kB)
25960 ( 25.35kB)
こ の 例 では、 以 下 の よ う にな り ます。
Code (inc. Data)
コードで 使 用 されるバイ ト 数 を 示 します。 このイ メージには、 3712 バ
イ ト の コー ド があ り ます。 こ れには、 リ テ ラ ルプールや 短 い 文 字 列 な
ど、 1580 バイ トのインラインデータ (inc. data) が 含 まれています。
RO Data
RW Data
ZI Data
Debug
読 み 出 し 専 用 データ で 使 用 さ れるバ イ ト 数 を 示 し ます。 こ れは、 Code
(inc. data) 列 内 の イ ン ラ イ ンデータ と は 別 です。
読 み 出 し - 書 き 込 みデータ で 使 用 さ れるバイ ト 数 を 示 し ます。
ゼ ロ で 初 期 化 さ れたデータ で 使 用 さ れるバ イ ト 数 を 示 し ます。
デバッ グ 入 力 セク シ ョ ン、 シンボルテーブル、 ス ト リ ングテーブルな
ど、 デバ ッ グデータ で 使 用 さ れるバ イ ト 数 を 示 し ます。
Object Totals
イメージを 生 成 するためにリンクされているオブジェクトで 使 用 される
バイ ト 数 を 示 し ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-4
ID 111311
Non-Confidential

イ メ ージに 関 する 情 報 の 取 得
(incl. Generated)
armlink は、 イ ン ターワーキングベニアな どの イ メ ージの 内 容 や 領 域
テーブルなどの 入 力 セク シ ョ ンを 生 成 する 場 合 があ り ます。 Object
Totals 行 に こ の タ イ プのデータ が 含 まれてい る 場 合 、 こ の 行 にそのデー
タ が 表 示 さ れます。
この 例 では、 RO データ の 合 計 は 19 バイ トで、 そのうち 16 バイ トがリ
ンカで 生 成 された RO データ です。
Library Totals
個 別 のオブジ ェ ク ト と し て 抽 出 さ れ、 イ メ ージに 追 加 さ れた ラ イ ブ ラ リ
のメ ンバで 使 用 されるバイ ト 数 を 示 します。
(incl. Padding)
armlink は、 必 要 に 応 じ てパデ ィ ングを 挿 入 し、 セ ク シ ョ ンの 境 界 調 整
を 強 制 実 行 し ます。 Object Totals 行 に こ の タ イ プのデータ が 含 まれてい
る 場 合 、 関 連 する (incl. Padding) 行 にそのデータ が 表 示 さ れます。 同 様
に、 Library Totals 行 に こ の タ イ プのデータ が 含 まれてい る 場 合 、 その
データは 関 連 する 行 に 示 さ れます。
この 例 では、RO データ のオブジ ェ ク ト の 合 計 は 19 バイ トで、 そのうち
3 バ イ ト が リ ン カで 生 成 さ れたパデ ィ ン グにな り ます。 ま た、 RO デー
タのライブラ リの 合 計 は 805 バイ トで、 そのうち 6 バイ トがパディング
にな り ます。
Grand Totals
イメージの 実 際 のサイズを 示 します。 この 例 では、10200 バイ トの ZI
データ (Object Totals) と 300 バイ トの ZI データ (Library Totals) があ
るため、 合 計 は 10500 バイ トになり ます。
ELF Image Totals
RW データ 圧 縮 (デフ ォル ト ) を 使 用 し て ROM サ イ ズを 最 適 化 する 場
合 、 最 終 イ メ ージのサ イ ズが 変 更 さ れ、 こ のサ イ ズ 変 更 は --info による
出 力 に 反 映 さ れます。 Grand Totals と ELF Image Totals のバイ ト 数 を 比 較
する と 、 圧 縮 の 効 果 を 確 認 で き ます。
この 例 では、 RW データ 圧 縮 が 有 効 になっていません。 データ が 圧 縮 さ
れる と、 RW 値 が 変 更 されます。
ROM Totals
イメージを 含 むために 必 要 な ROM の 最 小 サイ ズを 示 し ます。 ROM に 保
存 されない ZI データやデバ ッ グ 情 報 は 含 まれません。
6.3.1 関 連 項 目
概 念
• イメージに 関 する 情 報 を 取 得 するためのリンカオプション (6-2 ページ) .
参 照
『リンカリファレンス』:
• --info=topic[,topic,...] (2-80 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-5
ID 111311
Non-Confidential

イ メ ージに 関 する 情 報 の 取 得
6.4 リ ン ク 時 のシンボルの 場 所 を 調 べる 方 法
リンク 時 の ELF イ メージフ ァ イル 内 のシンボルの 場 所 を 調 べるには、
--keep=section_id オプシ ョ ン と --map オプシ ョ ン を 使 用 し て、 イ メ ージの メ モ リ マ ッ
プを 表 示 し ます。 例 えば、 object(section) がシンボルを 含 むセ ク シ ョ ンの 場 合 は、 以
下 のコマン ド を 入 力 し ます。
armlink --keep=object(section) --map s.o --output=s.axf
メ モ リ マ ッ プには、 シンボルを 含 むセ ク シ ョ ンの 場 所 が 表 示 さ れます。
6.4.1 例
以 下 の 手 順 に 従 います。
1. 以 下 の ソ ース コー ド を 含 む s.c という 名 前 のファイルを 作 成 します。
long long altstack[10] __attribute__ ((section ("STACK"), zero_init));
int main()
{
return sizeof(altstack);
}
2. ソースをコンパイルします。
armcc -c s.c -o s.o
3. オブジェ ク ト s.o を リンクして、STACK シンボルを 保 持 し、 イ メージのメモリ
マ ッ プを 表 示 し ます。
armlink --keep=s.o(STACK) --map s.o --output=s.axf
4. 出 力 か ら STACK シンボルを 検 索 します。 以 下 に 例 を 示 し ます。
...
Execution Region ER_RW (Base:0x000081c8, Size:0x00000000, Max:0xffffffff, ABSOLUTE)
**** こ の 実 行 領 域 に 割 り 当 て ら れ た セ ク シ ョ ン は あ り ま せ ん ****
Execution Region ER_ZI (Base:0x000081c8, Size:0x000000b0, Max:0xffffffff, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
0x000081c8 0x00000060 Zero RW 42 .bss libspace.o(c_4.l)
0x00008228 0x00000050 Zero RW 2 STACK s.o
以 上 の 結 果 か ら、 ス タ ッ ク が ER_ZI 実 行 領 域 に 存 在 する こ と がわか り ます。
6.4.2 関 連 項 目
タスク
• 実 行 可 能 な ELF イメージ 内 のシンボルの 場 所 を fromelf を 使 用 して 調 べる 方 法
(3-14 ページ) .
参 照
『コンパイ ラ リ ファレンス』 :
• -c (3-36 ページ)
• -o filename (3-163 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-6
ID 111311
Non-Confidential

イ メ ージに 関 する 情 報 の 取 得
『リンカリファレンス』:
• --keep=section_id (2-89 ページ)
• --map、 --no_map (2-109 ページ)
• --output=file (2-115 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 6-7
ID 111311
Non-Confidential

第 7 章
armlink によるシンボルのアクセスと 管 理
以 下 の 各 ト ピ ッ ク では、 リ ン カ armlink でシンボルにア ク セス し、 管 理 する 方 法 につい
て 説 明 し ます。
タスク
• マッピングシンボルについて (7-3 ページ)
• リンカ 定 義 シンボルへのアクセス (7-4 ページ)
• スキャッタファイルの 使 用 (7-11 ページ)
• C および C++ での リ ンカ 定 義 シンボルのインポー ト (7-12 ページ)
• ARM アセンブラでの リ ンカ 定 義 シンボルのインポート (7-13 ページ)
• 別 のイ メ ージに 含 まれている シンボルへのア ク セス (7-18 ページ)
• symdefs ファイルの 作 成 (7-19 ページ)
• グローバルシンボルのサブセッ トの 出 力 (7-20 ページ)
• symdefs フ ァ イルの 読 み 出 し (7-21 ページ)
• リンカコマンドラインでのステアリングファイルの 指 定 (7-25 ページ)
• ステア リ ングフ ァ イルを 使 用 し たグ ローバルシンボルの 非 表 示 および 名 前 の 変 更
(7-29 ページ)
• $Super$$ と $Sub$$ を 使 用 し たシンボル 定 義 へのパ ッ チの 適 用 (7-30 ページ) .
概 念
• 領 域 関 連 シンボル (7-5 ページ)
• ス キ ャ ッ タ ロー ド 時 以 外 の 領 域 名 の 値 (7-10 ページ)
• セクション 関 連 シンボル (7-14 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-1
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
• ステアリ ングファイルとは (7-24 ページ) .
参 照
• Image$$ 実 行 領 域 シンボル (7-6 ページ)
• Load$$ 実 行 領 域 シンボル (7-7 ページ)
• Load$$LR$$ ロード 領 域 シンボル (7-9 ページ)
• イメージシンボル (7-15 ページ)
• 入 力 セ ク シ ョ ンのシンボル (7-17 ページ)
• symdefs ファイルの 形 式 (7-22 ページ)
• ステアリ ングファイルコマンドの 概 要 (7-26 ページ)
• ステアリ ングファイルの 形 式 (7-27 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-2
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.1 マッピングシンボルについて
マ ッ ピングシンボルは、 次 に 示 し た よ う な イ ン ラ イ ンの 遷 移 を 識 別 する ために、
armcc および armasm に よ っ て 生 成 さ れます。
• リ テ ラ ルプールの 境 界 におけ る コー ド と データ
• ARM コード と Thumb コード (ARM/Thumb インターワークベニアなど)
マッピングシンボルを 次 に 示 します。
$a ARM 命 令 シーケ ン スの 開 始
$t Thumb 命 令 シーケン スの 開 始
$t.x ThumbEE 命 令 シーケ ン スの 開 始
$d データ 項 目 ( リ テ ラ ルプールな ど) シーケ ン スの 開 始
armlink は、 $d.realdata マ ッ ピ ン グシンボルを 生 成 する こ と に よ っ て、 そのデータ が
実 行 不 可 能 なセ ク シ ョ ンに 属 し てい る こ と を fromelf に 伝 えます。 し たがって、
fromelf -z によって 出 力 されるコード とデータのサイズは、armlink --info sizes の 出
力 と 同 じです。 その 例 を 次 に 示 します。
Code (inc. data) RO Data
x y z
この 例 で、y は $d でマーク され、 RO Data は $d.realdata でマーク されています。
注
$v で 文 字 で 始 ま るシンボルは、 VFP に 関 連 し たマ ッ ピ ングシンボルです。 通 常 、
VFP を 備 えたターゲッ ト 向 けのビルド 時 に 出 力 されます。 $v で 始 ま るシンボルを
ソース コー ド で 使 用 するのは 避 けて 下 さ い。
fromelf --elf --strip=localsymbols コ マン ド で 実 行 可 能 イ メ ージを 変 更 する と 、 すべて
のマッ ピングシンボルがイ メージから 削 除 されるので 注 意 して 下 さい。
7.1.1 関 連 項 目
概 念
『アセンブラの 使 用 』 :
• シンボルの 命 名 規 則 (8-3 ページ) .
参 照
『リンカリファレンス』:
• --list_mapping_symbols、 --no_list_mapping_symbols (2-104 ペー
ジ)
• --strict_symbols、 --no_strict_symbols (2-163 ページ) .
『fromelf イ メ ージ 変 換 ユーテ ィ リ テ ィ の 使 用 』 :
• --strip=option[,option,...] (4-73 ページ)
• --text (4-76 ページ) .
その 他 の 情 報
• ELF for the ARM Architecture, http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-3
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.2 リ ン カ 定 義 シンボルへのア ク セス
リ ンカで 定 義 さ れる シンボルには、 文 字 シーケン ス $$ が 含 まれている ものがあ り ま
す。 こ の よ う なシンボル と 、 文 字 シーケ ン ス $$ が 含 まれているその 他 の 外 部 名 は、
ARM で 予 約 されている 名 前 です。
このよ うなシンボリ ックアドレスは、 アセンブリ 言 語 で 記 述 されたプログラムでは
再 配 置 可 能 なア ド レ ス と し て イ ンポー ト し て 使 用 で き ます。 ま たは、 C または C++
で 記 述 された ソース コード からは extern シンボルと して 参 照 できます。
以 下 の 点 に 注 意 し て 下 さい。
• --strict コ ンパ イ ラ コ マン ド ラ イ ンオプシ ョ ン を 使 用 する 場 合 、 コ ンパ イ ラ は
ド ル 記 号 を 含 むシンボル 名 を 認 識 し ません。 認 識 さ れる よ う にする には、 コ ン
パイラコマンド ラインに --dollar オプシ ョ ンを 含 めます。
• リ ンカ 定 義 シンボルは、 コー ド か ら 参 照 さ れる 場 合 にのみ 生 成 さ れます。
7.2.1 関 連 項 目
概 念
• C および C++ での リ ンカ 定 義 シンボルのイ ンポー ト (7-12 ページ)
• ARM アセンブラでの リ ンカ 定 義 シンボルのインポート (7-13 ページ) .
参 照
『コンパイ ラ リ ファレンス』 :
• --dollar、 --no_dollar (3-86 ページ)
• --strict、 --no_strict (3-204 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-4
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.3 領 域 関 連 シンボル
リ ンカに よ って、 イ メ ージ 内 の 領 域 ご と に 以 下 の タ イ プの 領 域 関 連 シンボルが 生 成
されます。
• Image$$
• Load$$
• Load$$LR$$
ス キ ャ ッ タ フ ァ イルを 使 用 する 場 合 は、 ス キ ャ ッ タ フ ァ イル 内 の 領 域 ご と に こ れら
のシンボルが 生 成 さ れます。
スキャ ッ タ ロード を 使 用 しない 場 合 は、 デフォル ト の 領 域 名 に 対 してシンボルが 生
成 さ れます。 つま り 、 領 域 名 が 固 定 さ れ、 同 じ タ イ プのシンボが 生 成 さ れます。
7.3.1 関 連 項 目
概 念
• Image$$ 実 行 領 域 シンボル (7-6 ページ)
• Load$$ 実 行 領 域 シンボル (7-7 ページ)
• Load$$LR$$ ロード 領 域 シンボル (7-9 ページ)
• スキ ャ ッ タ ロード 時 以 外 の 領 域 名 の 値 (7-10 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-5
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.4 Image$$ 実 行 領 域 シンボル
以 下 の 表 には、 イ メ ージ 内 に 存 在 する 実 行 領 域 ご と に リ ンカが 生 成 する シンボルを
示 しています。 シンボルはすべて、 C ライブラリが 初 期 化 され 後 の 実 行 アドレスを
参 照 し ます。
表 7-1 Image$$ 実 行 領 域 シンボル
シンボル
Image$$region_name$$Base
Image$$region_name$$Length
Image$$region_name$$Limit
Image$$region_name$$RO$$Base
Image$$region_name$$RO$$Length
Image$$region_name$$RO$$Limit
Image$$region_name$$RW$$Base
Image$$region_name$$RW$$Length
Image$$region_name$$RW$$Limit
Image$$region_name$$ZI$$Base
Image$$region_name$$ZI$$Length
Image$$region_name$$ZI$$Limit
説 明
領 域 の 実 行 ア ド レ ス
ZI の 長 さ を 除 く 、 バイ ト 単 位 の 実 行 領 域 の 長 さ
実 行 領 域 内 の ZI 部 分 以 外 の 出 力 セ ク シ ョ ン 末 尾
の 次 にあ るバイ ト のア ド レ ス
指 定 領 域 内 の RO 出 力 セ ク シ ョ ンの 実 行 ア ド レ
ス
バイ ト 単 位 の RO 出 力 セ ク シ ョ ンの 長 さ
実 行 領 域 内 の RO 出 力 セ ク シ ョ ン 末 尾 の 次 にあ
るバイ トのアドレス
指 定 領 域 内 の RW 出 力 セ ク シ ョ ンの 実 行 ア ド レ
ス
バイ ト 単 位 の RW 出 力 セ ク シ ョ ンの 長 さ
実 行 領 域 内 の RW 出 力 セ ク シ ョ ン 末 尾 の 次 にあ
るバイ トのアドレス
指 定 領 域 内 の ZI 出 力 セ ク シ ョ ンの 実 行 ア ド レ ス
バイ ト 単 位 の ZI 出 力 セ ク シ ョ ンの 長 さ
実 行 領 域 内 の ZI 出 力 セ ク シ ョ ン 末 尾 の 次 にあ る
バイ トのアドレス
7.4.1 関 連 項 目
タスク
• C および C++ での リ ンカ 定 義 シンボルのイ ンポー ト (7-12 ページ)
• ARM アセンブラでの リ ンカ 定 義 シンボルのインポート (7-13 ページ) .
概 念
• 領 域 関 連 シンボル (7-5 ページ)
• スキ ャ ッ タ ロード 時 以 外 の 領 域 名 の 値 (7-10 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-6
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.5 Load$$ 実 行 領 域 シンボル
リンカは、RW 圧 縮 後 にロード ア ド レ ス を 参 照 する 再 配 置 に 対 し、 追 加 のア ド レ ス 割
り 当 て と 再 配 置 パス を 実 行 し ます。 こ の 遅 延 再 配 置 に よ り 、 ロー ド ア ド レ スに 関 す
る よ り 多 く の 情 報 を リ ン カ 定 義 シンボルで 使 用 で き る よ う にな り ます。
注
Load$$region_name シンボルは 実 行 領 域 にのみ 適 用 さ れ、 Load$$LR$$load_region_name シン
ボルはロー ド 領 域 にのみ 適 用 さ れます。
以 下 の 表 には、 イ メ ージ 内 に 存 在 する Load$$ 実 行 領 域 ご と に リ ンカが 生 成 する シン
ボルを 示 しています。 シンボルはすべて、 C ラ イ ブ ラ リ が 初 期 化 さ れた 後 の 実 行 ア
ド レ ス を 参 照 し ます。
表 7-2 Load$$ 実 行 領 域 シンボル
シンボル
Load$$region_name$$Base
Load$$region_name$$Length
Load$$region_name$$Limit
Load$$region_name$$RO$$Base
Load$$region_name$$RO$$Length
Load$$region_name$$RO$$Limit
Load$$region_name$$RW$$Base
Load$$region_name$$RW$$Length
Load$$region_name$$RW$$Limit
Load$$region_name$$ZI$$Base
Load$$region_name$$ZI$$Length
Load$$region_name$$ZI$$Limit
説 明
領 域 の ロー ド ア ド レ ス
バイ ト 単 位 の 領 域 の 長 さ
実 行 領 域 出 力 セ ク シ ョ ン 末 尾 の 次 にあ るバイ ト
のア ド レス
指 定 実 行 領 域 内 の RO 出 力 セ ク シ ョ ンのア ド レ
ス
バイ ト 単 位 の RO 出 力 セ ク シ ョ ンの 長 さ
実 行 領 域 内 の RO 出 力 セ ク シ ョ ン 末 尾 の 次 にあ
るバイ トのアドレス
指 定 実 行 領 域 内 の RW 出 力 セ ク シ ョ ンのア ド レ
ス
バイ ト 単 位 の RW 出 力 セ ク シ ョ ンの 長 さ
実 行 領 域 内 の RW 出 力 セ ク シ ョ ン 末 尾 の 次 にあ
るバイ トのアドレス
指 定 実 行 領 域 内 の ZI 出 力 セ ク シ ョ ンの ロー ド ア
ドレス
バイ ト 単 位 の ZI 出 力 セ ク シ ョ ンの ロー ド 長
region_name に ZEROPAD スキャッタロードキーワー
ド が 設 定 さ れない 限 り 、 ZI のロード 長 はゼロで
す。 ZEROPAD が 設 定 されている 場 合 は、 次 のよ う
にな り ます。
ロード 長 = Image$$region_name$$ZI$$Length
実 行 領 域 内 の ZI 出 力 セ ク シ ョ ン 末 尾 の 次 にあ る
バイ トのロードアドレス
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-7
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
こ の 表 内 のシンボルはすべて、 C ライブラリが 初 期 化 される 前 のロードアドレスを
参 照 し ます。 以 下 の 点 に 注 意 し て 下 さ い。
• セクシ ョ ン 相 対 シンボルは 実 行 ア ド レスのみを 持 つこ とができ るため、 シンボ
ルは 絶 対 シンボルです。
• シンボルでは RW 圧 縮 を 考 慮 し ます。
• ZI 出 力 セ ク シ ョ ンは C ラ イ ブ ラ リ を 初 期 化 する 前 は 存 在 し ないので、 シンボル
には 含 まれません。
• RW 圧 縮 実 行 領 域 か ら のすべての 再 配 置 は 圧 縮 前 に 実 行 する 必 要 があ り ます。
リ ン カでは 圧 縮 データ での 遅 延 再 配 置 を 解 決 で き ないためです。
• リンカによって、RW 圧 縮 領 域 か ら、 RW 圧 縮 に 依 存 する リ ンカ 定 義 シンボル
への 再 配 置 が 検 出 さ れた 場 合 、 その 領 域 の 圧 縮 は 無 効 にな り ます。
• ファイルに 書 き 込 まれるゼロバイトはすべて 認 識 されます。 したがって、 制 限
値 と 長 さの 値 はファ イルに 書 き 込 まれるゼロバイ ト を 考 慮 する 必 要 あ り ます。
7.5.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ)
• 領 域 関 連 シンボル (7-5 ページ)
• Image$$ 実 行 領 域 シンボル (7-6 ページ)
• Load$$LR$$ ロード 領 域 シンボル (7-9 ページ)
• スキ ャ ッ タ ロード 時 以 外 の 領 域 名 の 値 (7-10 ページ) .
参 照 :
『リンカリファレンス』:
• 実 行 領 域 の 属 性 (4-13 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-8
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.6 Load$$LR$$ ロード 領 域 シンボル
Load$$LR$$ ロード 領 域 には 多 く の 実 行 領 域 を 含 める こ とができ るので、 個 別 の $$RO コ
ンポーネン トや $$RW コ ンポーネン ト は 存 在 し ません。
注
Load$$LR$$load_region_name シンボルはロー ド 領 域 にのみ 適 用 さ れ、 Load$$region_name シ
ンボルは 実 行 領 域 にのみ 適 用 さ れます。
以 下 の 表 には、 イ メ ージ 内 に 存 在 する Load$$ ロード 領 域 ごとにリ ンカが 生 成 するシ
ンボルを 示 しています。
表 7-3 Load$$LR$$ ロード 領 域 シンボル
シンボル
Load$$LR$$load_region_name$$Base
Load$$LR$$load_region_name$$Length
Load$$LR$$load_region_name$$Limit
説 明
ロード 領 域 のアドレス
ロード 領 域 の 長 さ
ロー ド 領 域 の 末 尾 の 次 にあ るバイ ト のア ド レ ス
7.6.1 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ)
• イメージのロードビューと 実 行 ビュー (4-6 ページ)
• 領 域 関 連 シンボル (7-5 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-9
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.7 スキャ ッ タ ロー ド 時 以 外 の 領 域 名 の 値
ス キ ャ ッ タ ロー ド を 使 用 し ない 場 合 、 リ ンカでは 以 下 の 領 域 名 の 値 を 使 用 し ます。
• ER_RO ( 読 み 出 し 専 用 の 実 行 領 域 の 場 合 )
• ER_RW ( 読 み 出 し - 書 き 込 み 実 行 領 域 の 場 合 )
• ER_ZI (ゼ ロ で 初 期 化 さ れた 実 行 領 域 の 場 合 )
必 要 なア ド レ ス を 取 得 する ために、 こ れら の 名 前 を 以 下 のシンボルに 挿 入 で き ます。
• Image$$ 実 行 領 域 シンボル
• Load$$ 実 行 領 域 シンボル
例 えば、 Load$$ER_RO$$Base の よ う に 記 述 し ます。
注
• イメージの ZI 出 力 セ ク シ ョ ンは 静 的 に 作 成 さ れるのではな く 、 実 行 時 に 動 的 に
自 動 生 成 さ れます。 そのため、 ZI 出 力 セ ク シ ョ ンにはロー ド ア ド レ ス シンボル
はあ り ません。
• セ ク シ ョ ン 関 連 シンボルよ り も 領 域 関 連 シンボルを 使 用 する こ と を 推 奨 し ま
す。
7.7.1 関 連 項 目
概 念
• 領 域 関 連 シンボル (7-5 ページ)
• Image$$ 実 行 領 域 シンボル (7-6 ページ)
• Load$$ 実 行 領 域 シンボル (7-7 ページ)
• セクション 関 連 シンボル (7-14 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-10
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.8 スキャ ッ タ フ ァ イルの 使 用
ス キ ャ ッ タ ロー ド を 使 用 する 場 合 、 ス キ ャ ッ タ フ ァ イルにあ る 名 前 が リ ンカ 定 義 シ
ンボルに 使 用 されます。 スキャ ッ タファ イルは、 次 のこ と を 行 ます。
• イ メ ージ 内 のすべての 実 行 領 域 を 命 名 し、 各 領 域 の ロー ド ア ド レ ス と 実 行 ア ド
レスを 指 定 する。
• スタックと ヒープの 両 方 を 定 義 する。 また、 リンカによってスタックやヒープ
の 特 殊 なシンボルが 生 成 されます。
7.8.1 関 連 項 目
タスク
• 第 8 章 スキャッタファイルの 使 用 .
参 照
『リンカリファレンス』:
• --scatter=file (2-144 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-11
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.9 C および C++ でのリ ン カ 定 義 シンボルのイ ンポー ト
リンカ 定 義 シンボルを C または C++ のソースコードにインポートするには、 値 また
は 参 照 を 使 用 し ます。
値 でのイ ンポー ト
参 照 での イ ンポー ト
extern unsigned int symbol_name;
extern void *symbol_name;
シンボルを int で 宣 言 する 場 合 は、 こ れ ら の 例 に 示 すよ う に、 ア ド レ ス 演 算 子 (&)
を 使 用 し て 適 切 な 値 を 取 得 する 必 要 があ り ます。
例 7-1 リ ン カ 定 義 シンボルのイ ンポー ト
extern unsigned int Image$$ZI$$Limit;
config.heap_base = (unsigned int) &Image$$ZI$$Limit;
例 7-2 ZI 出 力 セ ク シ ョ ン を 定 義 するシンボルのイ ンポー ト
extern unsigned int Image$$ZI$$Length;
extern char Image$$ZI$$Base[];
memset(Image$$ZI$$Base,0,(unsigned int)&Image$$Length);
7.9.1 関 連 項 目
概 念
• Image$$ 実 行 領 域 シンボル (7-6 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-12
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.10 ARM アセンブラでのリンカ 定 義 シンボルのインポート
アセンブラのソースコードに リ ンカ 定 義 シンボルをインポートするには、 IMPORT ディ
レ ク テ ィ ブを 使 用 し、 シンボルの 値 を 保 持 する 32 ビッ トデータワードを 作 成 しま
す。 その 例 を 次 に 示 し ます。
IMPORT |Image$$ZI$$Limit|
...
zi_limit DCD |Image$$ZI$$Limit|
レジスタ (r1 など) に 値 をロードするには、LDR 命 令 を 使 用 します。
LDR r1, zi_limit
LDR 命 令 は、 32 ビ ッ ト データ ワー ド に 到 達 で き る 必 要 があ り ます。 ア ク セスでき る メ
モリ 範 囲 は、ARM と Thumb 間 、 さ ら には、 使 用 し てい る アーキテ ク チャ に よ って も
異 な り ます。
7.10.1 関 連 項 目
概 念
• Image$$ 実 行 領 域 シンボル (7-6 ページ) .
参 照
『アセンブラ リ フ ァ レンス』 :
• メモリアクセス 命 令 (3-12 ページ)
• IMPORT、 EXTERN (6-84 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-13
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.11 セクション 関 連 シンボル
セ ク シ ョ ン 関 連 シンボルは、 ス キ ャ ッ タ ロー ド を 使 用 し ないで イ メ ージを 作 成 する
ときに、 リンカによって 生 成 されるシンボルです。
リ ンカに よ って、 以 下 の タ イ プのセ ク シ ョ ン 関 連 シンボルが 生 成 さ れます。
• イ メ ージシンボル (コ マン ド ラ イ ンオプシ ョ ン を 使 用 し て 単 純 イ メ ージを 作 成
する 場 合 )。 単 純 イ メ ージには、 3 つの 実 行 領 域 を 生 成 する 3 つの 力 セ ク シ ョ ン
(RO、 RW、 ZI) があり ます。
• 入 力 セ ク シ ョ ンのシンボル (イ メ ージ 内 に 存 在 する 入 力 セ ク シ ョ ン ご と )。
リ ンカでは、 実 行 領 域 内 のセ ク シ ョ ン を まず RO、 RW、 ZI の 属 性 で ソー ト し、 次 に
名 前 で ソ ー ト し ます。 し たがっ て、 例 えば、 .text セクションはすべて 連 続 して 1 つ
のブ ロ ッ ク 内 に 配 置 さ れます。 同 じ 属 性 と 名 前 を 持 つセ ク シ ョ ンが 隣 接 する ブ ロ ッ
クを、 統 合 セ ク シ ョ ン と 呼 びます。
7.11.1 関 連 項 目
概 念
• イメージシンボル (7-15 ページ)
• 入 力 セ ク シ ョ ンのシンボル (7-17 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-14
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.12 イメージシンボル
イ メ ージシンボルは、 コ マン ド ラ イ ンオプシ ョ ン を 使 用 し て 単 純 イ メ ージを 作 成 す
る 場 合 にリ ンカによって 生 成 されます。
以 下 の 表 に イ メ ージシンボルを 示 し ます。
表 7-4 イメージシンボル
シンボル
セクションの
種 類
説 明
Image$$RO$$Base 出 力 RO 出 力 セ ク シ ョ ンの 開 始 ア ド レ ス
Image$$RO$$Limit 出 力 RO 出 力 セ ク シ ョ ン 末 尾 の 次 にあ るバイ ト
のア ド レス
Image$$RW$$Base 出 力 RW 出 力 セ ク シ ョ ンの 開 始 ア ド レ ス
Image$$RW$$Limit 出 力 ZI 出 力 セ ク シ ョ ン 末 尾 の 次 にあ るバイ ト の
アドレス (RW 領 域 の 末 尾 ではな く 、 ZI 領
域 の 末 尾 を 選 択 し てい る のは、 従 来 の コー
ド と の 互 換 性 を 維 持 る ためです)
Image$$ZI$$Base 出 力 ZI 出 力 セ ク シ ョ ンの 開 始 ア ド レ ス
Image$$ZI$$Limit 出 力 ZI 出 力 セ ク シ ョ ン 末 尾 の 次 にあ るバイ ト の
アドレス
ス キ ャ ッ タ フ ァ イルを 使 用 する 場 合 、 イ メ ージシンボルは 定 義 さ れません。 コー ド
か ら こ う し たシンボルのいずれかを 参 照 する 場 合 は、 弱 参 照 と し て 処 理 する 必 要 が
あります。
__user_setup_stackheap() の 標 準 実 装 では、 Image$$ZI$$Limit の 値 が 使 用 されます。 し た
がって、 ス キ ャ ッ タ フ ァ イルを 使 用 する 場 合 は、 ス タ ッ ク と ヒ ープを 手 動 で 配 置 す
る 必 要 があ り ます。 次 のいずれかの 方 法 で 行 います。
• スキャッタファイルで 行 う。 次 のいずれかの 方 法 を 使 用 します。
— 独 立 し た ス タ ッ ク 領 域 と ヒ ープ 領 域 を ARM_LIB_STACK および ARM_LIB_HEAP と
して 定 義 します。
— スタ ッ ク と ヒープの 両 方 を 組 み 合 わせた 領 域 を ARM_LIB_STACKHEAP として 定
義 します。
• __user_setup_stackheap() を 再 実 装 して、 ヒープと スタ ッ クの 境 界 を 設 定 する。
7.12.1 関 連 項 目
タスク
• スキャッタロード 時 に 定 義 されないリンカ 定 義 シンボル (8-11 ページ)
• スキャッタファイルを 使 用 したスタック と ヒープの 指 定 (8-12 ページ) .
概 念
• 単 純 イ メ ージの タ イ プ (4-10 ページ)
• 弱 参 照 と 定 義 について (4-35 ページ) .
『コンパイ ラの 使 用 』 :
• C および C++ のスタ ッ クの 使 用 (6-18 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-15
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
『 移 行 と 互 換 性 』 :
• RVCT v2.2 と RVCT v3.0 の 間 での C および C++ ライブラリの 変 更 点 (9-5 ペー
ジ) .
参 照
『ARM ® C および C++ ラ イ ブ ラ リ と 浮 動 小 数 点 サポー ト の 使 用 』 :
• __user_setup_stackheap() (2-61 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-16
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.13 入 力 セ ク シ ョ ンのシンボル
入 力 セ ク シ ョ ンのシンボルは、 イ メ ージ 内 に 存 在 する 入 力 セ ク シ ョ ン ご と に リ ン カ
によって 生 成 されます。
以 下 の 表 に 入 力 セ ク シ ョ ンのシンボルを 示 し ます。
表 7-5 セクション 関 連 シンボル
シンボル
セクションの
種 類
説 明
SectionName$$Base 入 力 SectionName という 名 前 の 統 合 セクションの
開 始 ア ド レ ス
SectionName$$Length 入 力 SectionName という 名 前 の 統 合 セクションの
長 さ (バイ ト 単 位 )
SectionName$$Limit 入 力 SectionName という 名 前 の 統 合 セクション 末
尾 の 次 にあ るバイ ト のア ド レ ス
コー ド か ら 入 力 セ ク シ ョ ンのシンボルを 参 照 する 場 合 、 イ メ ージ 内 の 同 じ 名 前 のす
べての 入 力 セ ク シ ョ ンは、 イ メ ージ メ モ リ マ ッ プ 内 に 連 続 し て 置 さ れる と 想 定 で き
ます。
ス キ ャ ッ タ フ ァ イルで 入 力 セ ク シ ョ ンが 連 続 し て 配 置 さ れない 場 合 、 リ ンカに よ っ
てエ ラーが 生 成 さ れます。 こ れは、 ベース シンボル と リ ミ ッ ト ンボルが 不 連 続 な メ
モ リ 上 で 使 用 さ れる と 、 通 常 、 不 定 の 望 ま し く ない 結 果 が 生 じ る ためです。
7.13.1 関 連 項 目
タスク
• 第 8 章 スキャッタファイルの 使 用 .
概 念
• 入 力 セクション、 出 力 セクション、 領 域 、 およびプログラムセグメント
(4-5 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-17
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.14 別 のイ メ ージに 含 まれているシンボルへのア ク セス
ある イ メージから 別 のイ メージに 含 まれているグローバルシンボルの 値 を 参 照 する
場 合 は、 シンボル 定 義 (symdefs) ファイルを 使 用 できます。
例 えば、 ROM に 常 駐 する イ メ ージが 1 つ、 RAM に ロー ド さ れる イ メ ージが 複 数 存 在
する 場 合 に、 こ のフ ァ イルを 使 用 で き ます。 こ の 場 合 、 RAM にローされるイ メージ
から、 ROM 内 に 存 在 する イ メ ージのグ ローバル 関 数 やグ ローバルデータ にア ク セス
できます。
7.14.1 関 連 項 目
タスク
• symdefs ファイルの 作 成 (7-19 ページ)
• symdefs フ ァ イルの 読 み 出 し (7-21 ページ) .
参 照
• symdefs ファイルの 形 式 (7-22 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-18
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.15 symdefs フ ァ イルの 作 成
symdefs ファイルを 生 成 するには、armlink オプシ ョ ン --symdefs=filename を 使 用 し ま
す。
リンクの 最 終 段 階 が 正 常 に 処 理 されたときに、 リンカによって symdefs ファイルが 作
成 さ れます。 部 分 的 な リ ン ク の 場 合 、 ま たは リ ン ク の 最 終 段 階 正 常 に 処 理 さ れな
かった 場 合 、 ファ イルは 作 成 されません。
注
filename が 存 在 し ない 場 合 は、 すべてのグ ローバルシンボルを 含 んでいる フ ァ イルが
作 成 さ れます。 filename が 存 在 する 場 合 は、 既 存 の filename の 内 容 を 使 用 して、 リ ン
カか ら のフ ァ イルの 再 書 き 込 み 時 に 出 力 する シンボルを 選 択 し ます。 つま り 、 フ ァ
イル 名 に 既 存 のシンボルのみが 更 新 さ れ、 新 し いシンボル ( 存 在 する 場 合 ) は 追 加
さ れません。 こ の 処 理 が 必 要 ない 場 合 は、 リ ン ク 手 順 の 前 に 既 存 の symdefs ファイル
をすべて 削 除 して く ださい。
7.15.1 関 連 項 目
概 念
• 別 のイ メ ージに 含 まれている シンボルへのア ク セス (7-18 ページ) .
参 照
• symdefs ファイルの 形 式 (7-22 ページ) .
『リンカリファレンス』:
• --symdefs=file (2-168 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-19
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.16 グローバルシンボルのサブセ ッ ト の 出 力
デフォル ト では、 すべてのグローバルシンボルが symdefs ファイルに 書 き 込 まれま
す。 symdefs フ ァ イルが 存 在 する 場 合 、 リ ンカではそのフ ァ イルの 容 を 使 用 し て、 出
力 をグローバルシンボルのサブセッ ト に 限 定 し ます。
symdefs ファイルを 使 用 して、 アプリケーション image1 に 含 まれている シンボルを 別
のアプ リ ケーシ ョ ンに 公 開 するには、 以 下 の 手 順 を 実 行 し ます。
1. image1 の リ ン ク の 最 終 段 階 で --symdefs=filename を 指 定 し ます。 リ ンカによって
symdefs ファイル filename が 作 成 されます。
2. テキス ト エディ タで filename を 開 き、 最 終 リ ス ト に 不 要 なシンボルエン ト リ を
削 除 し てか ら フ ァ イルを 保 存 し ます。
3. image1 の リ ン ク の 最 終 段 階 で --symdefs=filename を 指 定 し ます。
image1 の 作 成 に 使 用 し ていたオブジ ェ ク ト が 1 つ 以 上 変 更 さ れた と き にシンボ
ル 定 義 を 更 新 する 場 合 な ど、 いつで も filename を 編 集 してコ メ ン ト を 追 加 し、
image1 を 再 リ ンクできます。
これで、 symdefs フ ァ イルを 使 用 し て、 追 加 のアプ リ ケーシ ョ ン を リ ン ク で き ます。
7.16.1 関 連 項 目
概 念
• 別 のイ メ ージに 含 まれている シンボルへのア ク セス (7-18 ページ) .
参 照
• symdefs ファイルの 形 式 (7-22 ページ) .
『リンカリファレンス』:
• --symdefs=file (2-168 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-20
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.17 symdefs フ ァ イルの 読 み 出 し
symdefs フ ァ イルは、 コードやデータ を 含 んでいない、 シンボル 情 報 だけを 含 んでい
るオブジェク ト ファイルと 考 えるこ とができます。 symdefs フ ァ イルを 読 み 出 すに
は、 オブジェク トファイルを 追 加 するのと 同 様 にこのファイルをファイルリストに
追 加 し ます。 リ ンカでは、 こ のフ ァ イルを 読 みし、 シンボル と その 値 を 出 力 シンボ
ルテーブルに 追 加 し ます。 追 加 さ れる シンボルには、 ABSOLUTE 属 性 と GLOBAL 属 性 があ
ります。
部 分 的 な リ ン ク が 実 行 さ れる 場 合 、 シンボルは 出 力 オブジ ェ ク ト のシンボルテーブ
ルに 追 加 さ れます。 完 全 な リ ン ク が 実 行 さ れる 場 合 、 シンボルイ メ ージのシンボル
テーブルに 追 加 されます。
フ ァ イル 内 に 無 効 な 行 があ る 場 合 、 リ ン カに よ ってエ ラー メ ッ セージが 生 成 さ れま
す。 行 は、 以 下 の 場 合 に 無 効 にな り ます。
• 不 足 し てい る 列 があ る 場 合
• 無 効 な 値 を 含 んでい る 列 があ る 場 合
symdefs ファイルから 抽 出 されるシンボルは、 オブジェクトのシンボルテーブルから
抽 出 さ れる シンボル と ま った く 同 じ 方 法 で 処 理 さ れます。 複 数 シンボル 定 義 に 関 し
ても、 同 じ 制 限 が 適 用 されます。
注
ARM コード と Thumb コー ド 内 で 同 じ 関 数 名 ま たはシンボル 名 を 定 義 する こ と はで き
ません。
7.17.1 関 連 項 目
参 照
• symdefs ファイルの 形 式 (7-22 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-21
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.18 symdefs フ ァ イルの 形 式
symdefs ファイルにはシンボルとその 値 が 定 義 されています。 ファイルは 以 下 で 構 成
されます。
識 別 行
コメント
symdefs フ ァ イルの 識 別 行 は 以 下 で 構 成 さ れます。
• 識 別 文 字 列 ## (フ ァ イルが symdefs ファイルとしてリンカ
に 認 識 されるには、 そのフ ァ イル 内 の 最 初 の 11 文 字 が こ の 文 字 列
である 必 要 があ り ます)
• 以 下 の 形 式 の リ ンカのバージ ョ ン 情 報
ARM Linker, ARMCCver [Build num]:
• 以 下 の 形 式 の、 symdefs フ ァ イルを 最 後 に 更 新 し た 日 付 と 時 刻
Last Updated:Date
バージ ョ ン 情 報 と 更 新 情 報 は、 識 別 文 字 列 の 一 部 ではあ り ません。
コメントは、テキストエディタを 使 用 して 手 動 で 挿 入 できます。 コメン
トには、 以 下 の 特 性 があります。
• 先 頭 行 は、 特 殊 な 識 別 コ メ ン ト ## で 始 ま る 必 要 があ り ま
す。 こ のコ メ ン ト は、 フ ァ イル 作 成 時 に リ ンカに よ って 挿 入 さ れ
ます。 このコ メ ン ト を 手 動 で 削 除 しないで 下 さい。
• ホ ワ イ ト スペース 以 外 の 最 初 の 文 字 がセ ミ コ ロ ン (;) またはハッ
シュ (#) の 行 は、 すべてコ メン トです。
• ホ ワ イ ト スペース 以 外 の 最 初 の 文 字 の 後 にセ ミ コ ロ ン (;) または
ハッシュ (#) がある 行 は、 コ メン トではあり ません。
• 空 白 行 は 無 視 さ れる ので、 読 みやす く する ために 空 白 行 を 挿 入 で
きます。
シンボル 情 報
シンボル 情 報 は 1 行 に 記 述 さ れ、 以 下 で 構 成 さ れます。
シンボルの 値 リンカでは、シンボルの 絶 対 アドレスを 固 定 長 の 16
進 形 式 ( 例 0x00008000) で 書 き 込 みます。 このファイ
ルを 編 集 する 場 合 、 ア ド レ ス 値 には 16 進 形 式 と 10
進 形 式 のどち ら も 使 用 で き ます。
タイプフラグ シンボルのタイプは 1 文 字 で 以 下 の よ う に 表 さ れま
す。
A ARM コード
T Thumb コード
D データ
N 数 値
シンボル 名 シンボルの 名 前 です。
7.18.1 symdefs フ ァ イルの 例
この 例 では、 一 般 的 な symdefs ファイルの 形 式 を 示 しています。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-22
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
例 7-3 symdefs フ ァ イルの 形 式
## ARM Linker, ARMCC501 [Build num]:Last Updated:Date
; 値 の 型 名 、 こ れは 追 加 さ れ た コ メ ン ト
0x00008000 A __main
0x00008004 A __scatterload
0x000080E0 T main
0x0000814D T _main_arg
0x0000814D T __argv_alloc
0x00008199 T __rt_get_argv
...
# これもまたコメントであり、 空 白 行 は 無 視 される
...
0x0000A4FC D __stdin
0x0000A540 D __stdout
0x0000A584 D __stderr
0xFFFFFFFD N __SIG_IGN
7.18.2 関 連 項 目
概 念
• 別 のイ メ ージに 含 まれている シンボルへのア ク セス (7-18 ページ)
• symdefs ファイルの 作 成 (7-19 ページ)
• グローバルシンボルのサブセッ トの 出 力 (7-20 ページ)
• symdefs フ ァ イルの 読 み 出 し (7-21 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-23
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.19 ステアリングファイルとは
ス テア リ ン グ フ ァ イルは、 出 力 オブジ ェ ク ト のシンボルテーブルおよびイ メ ージの
ダイナミ ックセクションを 編 集 するための 一 連 のコマンドが 含 れているテキス ト
ファイルです。 ステアリングファイルのコマンドでは、 以 下 のことが 可 能 です。
• シンボルテーブル 内 のシンボルを 管 理 する。
• 静 的 シンボルテーブルか ら 動 的 シンボルテーブルへのシンボルの コ ピーを 制 御
する。
• リ ン ク ユニ ッ ト が 依 存 する ラ イ ブ ラ リ に 関 する 情 報 を 保 存 する。
例 えば、 ス テア リ ング フ ァ イルを 使 用 し て、 知 的 所 有 権 を 保 護 し た り 、 ネーム ス
ペースの 衝 突 を 回 避 し た り する こ と がで き ます。
7.19.1 関 連 項 目
タスク
• リンカコマンドラインでのステアリングファイルの 指 定 (7-25 ページ) .
参 照
• ステアリ ングファイルコマンドの 概 要 (7-26 ページ)
• ステアリ ングファイルの 形 式 (7-27 ページ) .
『リンカリファレンス』:
• --edit=file_list (2-53 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-24
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.20 リ ン カ コ マン ド ラ イ ンでのステア リ ング フ ァ イルの 指 定
リンカコマンドラインで 1 つ 以 上 のス テア リ ン グ フ ァ イ ルを 指 定 する には、 オプ
ション --edit file-list を 使 用 し ます。
複 数 のス テア リ ン グ フ ァ イルを 指 定 する 場 合 は、 以 下 のいずれかの コ マン ド ラ イ ン
の 形 式 を 使 用 でき ます。
armlink --edit file1 --edit file2 --edit file3
armlink --edit file1,file2,file3
コ ンマ 区 切 り リ ス ト を 使 用 する 場 合 は、 コ ンマ と フ ァ イル 名 の 間 にスペース を 含 め
ないで 下 さい。
7.20.1 関 連 項 目
概 念
• ステアリ ングファイルとは (7-24 ページ) .
参 照
• ステアリ ングファイルコマンドの 概 要 (7-26 ページ)
• ステアリ ングファイルの 形 式 (7-27 ページ) .
『リンカリファレンス』:
• EXPORT (3-2 ページ)
• HIDE (3-4 ページ)
• IMPORT (3-5 ページ)
• RENAME (3-7 ページ)
• REQUIRE (3-9 ページ)
• RESOLVE (3-10 ページ)
• SHOW (3-12 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-25
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.21 ステア リ ング フ ァ イルコ マン ド の 概 要
以 下 のス テア リ ン グ フ ァ イルコ マン ド があ り ます。
表 7-6 ステア リ ング フ ァ イルコ マン ド の 概 要
コマンド
EXPORT
HIDE
IMPORT
RENAME
REQUIRE
RESOLVE
SHOW
説 明
他 の 共 有 オブジ ェ ク ト ま たは 実 行 可 能 フ ァ イルか ら シン
ボルにア クセスでき る よ う に 指 定 し ます。
シンボルテーブル 内 の 定 義 済 みグ ローバルシンボルを 匿
名 にし ます。
シンボルが 実 行 時 に 共 有 オブジ ェ ク ト で 定 義 さ れる よ う
に 指 定 し ます。
定 義 済 みあ る いは 未 定 義 のグ ローバルシンボルの 名 前 を
変 更 し ます。
動 的 配 列 内 に DT_NEEDED タグを 作 成 します。DT_NEEDED タグ
では、 アプ リ ケーシ ョ ンで 使 用 さ れてい る 共 有 ラ イ ブ ラ
リ などの 他 の 共 有 オブジ ェ ク ト と の 依 存 関 係 を 指 定 し ま
す。
特 定 の 未 定 義 の 参 照 と 、 定 義 済 みのグ ローバルシンボル
とのマッチングを 行 います。
グ ローバルシンボルを 表 示 し ます。 こ のコ マン ド は、 ワ
イルドカードを 指 定 した HIDE コ マン ド を 使 用 し て 非 表 示
に し た 特 定 のシンボルを 表 示 する 場 合 に 便 利 です。
注
ステアリ ングファイルコマンドでは、 グローバルシンボルのみを 制 御 します。 ロー
カルシンボルはどのコマン ドの 影 響 も 受 けません。
7.21.1 関 連 項 目
タスク
• リンカコマンドラインでのステアリングファイルの 指 定 (7-25 ページ) .
概 念
• ステアリ ングファイルとは (7-24 ページ) .
参 照
• ステアリ ングファイルの 形 式 (7-27 ページ) .
『リンカリファレンス』:
• EXPORT (3-2 ページ)
• HIDE (3-4 ページ)
• IMPORT (3-5 ページ)
• RENAME (3-7 ページ)
• REQUIRE (3-9 ページ)
• RESOLVE (3-10 ページ)
• SHOW (3-12 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-26
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.22 ステア リ ング フ ァ イルの 形 式
ス テア リ ン グ フ ァ イルは、 以 下 の 形 式 で 記 述 さ れる プレーンテキ ス ト フ ァ イ ルです。
• ホ ワ イ ト スペース 以 外 の 最 初 の 文 字 がセ ミ コ ロ ン (;) またはハッシュ (#) 文
字 の 行 は、 コメント 行 として 解 釈 されます。 コメントは 空 白 行 として 処 理 され
ます。
• 空 白 行 は 無 視 さ れます。
• 空 白 行 で も コ メ ン ト 行 で も ない 行 は、 コ マン ド か、 連 続 する 空 白 以 外 の 行 に 分
割 されたコマンドの 一 部 です。
• ホ ワ イ ト スペース 以 外 の 最 後 の 文 字 がコ ンマ (,) で 終 わるコマンド ラインは、
次 の 空 白 行 以 外 の 行 に 続 き ます。
各 コ マン ド ラ イ ンは、 コ マン ド と それに 続 く コ ンマで 区 切 ら れたオペラ ン ド グルー
プか ら 構 成 さ れます ( 複 数 可 )。 各 オペラ ン ド グループは、 コ マン ド に よ って 1 つま
たは 2 つのオペランドで 構 成 されます。 コマンドは、 そのコマンドの 各 オペランド
グループに 適 用 されます。 以 下 の 規 則 が 用 されます。
• コ マン ド では 大 文 字 と 小 文 字 が 区 別 さ れませんが、 通 常 は 大 文 字 で 表 記 さ れま
す。
• オペランドは 大 文 字 と 小 文 字 が 区 別 されるシンボル 名 とマッチングする 必 要 が
あ る ため、 大 文 字 と 小 文 字 が 区 別 さ れます。 オペラ ン ド にはワ イ ルカー ド 文 字
を 使 用 でき ます。
コマン ドは、 グローバルシンボルのみに 適 用 されます。 ローカルシンボルなどのそ
の 他 のシンボルは 影 響 を 受 けません。
以 下 の 例 には、 サンプルのス テア リ ン グ フ ァ イルを 示 し ています。
例 7-4 ステア リ ング フ ァ イルの 例
; my_func1 を func1 としてインポートする
IMPORT my_func1 AS func1
# 非 常 に 長 い 関 数 名 を 短 い 名 前 に 変 更 す る
RENAME a_very_long_function_name AS,
short_func_name
7.22.1 関 連 項 目
タスク
• リンカコマンドラインでのステアリングファイルの 指 定 (7-25 ページ) .
概 念
• ステアリ ングファイルとは (7-24 ページ) .
参 照
• ステアリ ングファイルコマンドの 概 要 (7-26 ページ) .
『リンカリファレンス』:
• EXPORT (3-2 ページ)
• HIDE (3-4 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-27
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
• IMPORT (3-5 ページ)
• RENAME (3-7 ページ)
• REQUIRE (3-9 ページ)
• RESOLVE (3-10 ページ)
• SHOW (3-12 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-28
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.23 ステア リ ング フ ァ イルを 使 用 し たグローバルシンボルの 非 表 示 および 名 前 の 変 更
ステアリングファイルを 使 用 して、 出 力 ファイル 内 のグローバルシンボル 名 を 非 表
示 にしたり、 変 更 したりすることができます。 それぞれ、HIDE コマンドおよび RENAME
コマンドを 使 用 します。
例 えば、 ス テア リ ング フ ァ イルを 使 用 し て、 知 的 所 有 権 を 保 護 し た り 、 ネーム ス
ペースの 衝 突 を 回 避 し た り する こ と がで き ます。
シンボルの 名 前 を 変 更 する 例 を 以 下 に 示 し ます。
例 7-5 RENAME ステアリングコマンドの 例
RENAME func1 AS my_func1
シンボルを 非 表 示 にする 例 を 以 下 に 示 し ます。
例 7-6 HIDE ステアリングコマンドの 例
; 接 頭 文 字 ‘internal’ が 付 いてい るすべてのグ ロ ーバルシ ン ボル を 非 表 示 にする
HIDE internal*
7.23.1 関 連 項 目
タスク
• リンカコマンドラインでのステアリングファイルの 指 定 (7-25 ページ) .
概 念
• ステアリ ングファイルとは (7-24 ページ)
• ステアリ ングファイルコマンドの 概 要 (7-26 ページ) .
参 照
• ステアリ ングファイルの 形 式 (7-27 ページ) .
『リンカリファレンス』:
• --edit=file_list (2-53 ページ)
• HIDE (3-4 ページ)
• RENAME (3-7 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-29
ID 111311
Non-Confidential

armlink によ るシンボルのア ク セス と 管 理
7.24 $Super$$ と $Sub$$ を 使 用 し たシンボル 定 義 へのパ ッ チの 適 用
外 部 ラ イ ブ ラ リ や ROM コー ド 内 に 含 まれてい る な どの 理 由 で、 既 存 のシンボルを 変
更 でき ない 場 合 があ り ます。 このよ う な 場 合 は、 $Super$$ パターンと $Sub$$ パターン
を 使 用 し て、 既 存 のシンボルにパ ッ チを 適 用 で き ます。
関 数 foo() の 定 義 にパ ッ チを 適 用 するには、 以 下 を 使 用 し ます。
$Super$$foo パッチを 適 用 していない 元 の 関 数 foo() を 識 別 し ます。 このパターンを
使 用 し て、 元 の 関 数 を 直 接 呼 び 出 し ます。
$Sub$$foo
元 の 関 数 foo() の 代 わ り に 呼 び 出 す 新 し い 関 数 を 識 別 し ます。 こ のパ
ターン を 使 用 し て、 元 の 関 数 の 前 ま たは 後 に 処 理 を 追 加 し ます。
注
$Sub$$ と $Super$$ の メ カニズムは 静 的 な リ ン ク 時 にのみ 機 能 し ます。 $Super$$ の 参 照
をダイナミ ッ クシンボルテーブルにインポート またはエクスポートするこ とはでき
ません。
以 下 の 例 では、 既 存 の 関 数 foo() への 呼 び 出 しの 前 に、 関 数 ExtraFunc() への 呼 び 出 し
を 挿 入 する 方 法 を 示 し ています。
例 7-7 $Super$$ と $Sub$$ の 使 用
extern void ExtraFunc(void); extern void $Super$$foo(void):
/* この 関 数 が 元 の 関 数 foo() の 代 わ り に 呼 び 出 される */
void $Sub$$foo(void)
{
ExtraFunc(); /* 追 加 の セ ッ ト ア ッ プ 作 業 を 行 う */
$Super$$foo(); /* 元 の 関 数 foo() を 呼 び 出 す */
/* 元 の 関 数 foo() の 呼 び 出 し を 回 避 する には
* $Super$$foo(); 関 数 の 呼 び 出 し を 省 略 す る。
*/
}
7.24.1 関 連 項 目
その 他 の 情 報
• ELF for the ARM Architecture, http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 7-30
ID 111311
Non-Confidential

第 8 章
スキャ ッ タ フ ァ イルの 使 用
以 下 の ト ピ ッ ク では、 ス キ ャ ッ タ フ ァ イル と armlink を 使 用 した 複 雑 なイ メージの 作 成
方 法 について 説 明 し ます。
タスク
• ス キ ャ ッ タ フ ァ イ ルを 使 用 し た ス タ ッ ク と ヒ ープの 指 定 (8-12 ページ)
• ルー ト 実 行 領 域 の 作 成 (8-14 ページ)
• FIXED 属 性 を 使 用 したルー ト 領 域 の 作 成 (8-17 ページ)
• 特 定 ア ド レ スへの 関 数 と データ の 配 置 (8-18 ページ)
• ス キ ャ ッ タ ロー ド を 使 用 し た 名 前 付 き セ ク シ ョ ンの 明 示 的 な 配 置 (8-23 ページ)
• .ANY モジ ュールセレ ク タ に よ る 未 割 り 当 てセ ク シ ョ ンの 配 置 (8-25 ページ)
• ス キ ャ ッ タ ロー ド の 記 述 におけ るベニア 入 力 セ ク シ ョ ンの 選 択 (8-36 ページ)
• __attribute__((section("name"))) を 使 用 したコード とデータの 配 置 (8-37 ページ)
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ページ)
• __at を 使 用 したフ ラ ッシュ メ モ リ でのキーの 配 置 (8-46 ページ)
• __at を 使 用 し たペ リ フ ェ ラ ルレ ジ ス タ に 対 する 構 造 の 配 置 (8-48 ページ)
• 空 き 領 域 の 予 約 (8-57 ページ)
• スキャッタファイルでのプリプロセッシングコマンドの 使 用 (8-62 ページ)
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 を 使 用 し たパデ ィ ングの 回 避 (8-64 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-1
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
概 念
• スキャッタロードについて (8-3 ページ)
• スキャッタロードが 使 用 される 状 況 (8-4 ページ)
• スキャッタロードのコマンドラインオプション (8-5 ページ)
• メモリマップが 単 純 なイメージ (8-7 ページ)
• メモリマップが 複 雑 なイメージ (8-9 ページ)
• スキャッタロード 時 に 定 義 されないリンカ 定 義 シンボル (8-11 ページ)
• ルー ト 領 域 と は (8-13 ページ)
• .ANY セ ク シ ョ ンの 配 置 アルゴ リ ズムの 使 用 例 (8-29 ページ)
• 領 域 の 割 り 当 て、 セレ ク タ、 および 優 先 度 の 動 作 を 示 す next_fit アルゴ リ ズ
ムの 例 (8-32 ページ)
• .ANY セクシ ョ ンのソート アルゴ リ ズムの 使 用 例 (8-34 ページ)
• __at セ ク シ ョ ンの 配 置 に 関 する 制 限 (8-41 ページ)
• __at セ ク シ ョ ンの 自 動 配 置 (8-42 ページ)
• __at セ ク シ ョ ンの 手 動 配 置 (8-44 ページ)
• オーバーレ イ を 使 用 し たセ ク シ ョ ンの 配 置 (8-49 ページ)
• ARM C および C++ ライブラリコードの 配 置 について (8-52 ページ)
• ルー ト 領 域 へのコー ド の 配 置 例 (8-53 ページ)
• ARM C ラ イ ブ ラ リ コー ド の 配 置 例 (8-54 ページ)
• ARM C++ ラ イ ブ ラ リ コー ド の 配 置 例 (8-55 ページ)
• ARM ライブラリヘルパ 関 数 の 配 置 例 (8-56 ページ)
• ページ 境 界 での 領 域 の 作 成 について (8-59 ページ)
• 実 行 領 域 と 入 力 セ ク シ ョ ンのオーバーア ラ イ メ ン ト (8-61 ページ)
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 (8-63 ページ)
• 等 価 な ス キ ャ ッ タ ロー ド 記 述 を 使 用 し た 単 純 イ メ ージの 生 成 (8-65 ページ)
• タイプ 1 のイ メージ :1 つの ロー ド 領 域 と 連 続 する 実 行 領 域 (8-66 ページ)
• タイプ 2 のイ メージ :1 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (8-68 ページ)
• タイプ 3 のイ メージ :2 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (8-70 ページ)
• スキャッタファイルを 使 用 した ELF のマッ ピング (8-73 ページ) .
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• ビッ トバンドオブジェク トへのリンクを 含 むスキャッタロードファイル
(3-17 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-2
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.1 スキャ ッ タロードについて
スキャッタロードを 使 用 するこ とで、 リンカに 渡 すイ メージのメモリマップをテキ
ス ト 形 式 の 記 述 フ ァ イルに よ って 指 定 で き ます。 ス キ ャ ッ タ ロー ド では、 イ メ ージ
を 構 成 する コ ンポーネン ト のグループ 化 と 配 置 を 完 全 に 制 御 で き ます。 ス キ ャ ッ タ
ロー ド は 単 純 な イ メ ージの 作 成 に も 使 用 でますが、 一 般 的 には メ モ リ マ ッ プが 複 雑
な イ メ ージ、 つま り ロー ド 時 と 実 行 時 に 複 数 の メ モ リ 領 域 が メ モ リ マ ッ プ 内 に 分 散
したイメージのみに 使 用 します。
イ メ ージの メ モ リ マ ッ プは 領 域 と 出 力 セ ク シ ョ ンか ら 構 成 さ れます。 メ モ リ マ ッ プ
内 の 領 域 ご と に、 ロー ド ア ド レ ス と 実 行 ア ド レ スがあ り ます。
イ メ ージの メ モ リ マ ッ プを 作 成 する には、 以 下 の 情 報 を リ ン カに 渡 す 必 要 があ り ま
す。
• 入 力 セ ク シ ョ ン を 出 力 セ ク シ ョ ン と 領 域 にグループ 化 する 方 法 が 記 述 さ れた、
グループ 化 に 関 する 情 報
• メ モ リ マ ッ プ 内 に 領 域 を 配 置 する ア ド レ スが 記 述 さ れた、 配 置 に 関 する 情 報
リ ン カは、 ス キ ャ ッ タ フ ァ イ ルを 使 用 し て イ メ ージを 作 成 する と き に、 い く つかの
領 域 関 連 シンボルを 作 成 し ます。 これらの 特 殊 なシンボルは、 コード によ って 参 照
さ れる 場 合 にのみ 作 成 さ れます。
8.1.1 関 連 項 目
概 念
• イメージの 構 造 (4-3 ページ)
• 領 域 関 連 シンボル (7-5 ページ)
• スキャッタロードが 使 用 される 状 況 (8-4 ページ)
• スキャッタファイルを 使 用 した ELF のマッ ピング (8-73 ページ) .
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• ビッ トバンドオブジェク トへのリンクを 含 むスキャッタロードファイル
(3-17 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-3
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.2 スキャ ッ タ ロー ド が 使 用 される 状 況
リ ン カへの コ マン ド ラ イ ンオプシ ョ ン を 使 用 する こ と でデータ と コー ド の 配 置 を あ
る 程 度 制 御 で き ますが、 配 置 を 完 全 に 制 御 する には、 コ マン ド ラ イ ンか ら 入 力 可 能
な 指 示 よ り も さ らに 詳 細 な 指 示 を 必 要 と し ます。
以 下 に、 ス キ ャ ッ タ フ ァ イルが 必 要 なケース ま たは 非 常 に 有 効 なケース を 挙 げます。
メモリマップが 複 雑 な 場 合
数 多 くの 異 なるメモリエリアに 配 置 しなければならないコードとデータ
には、 対 応 する セ ク シ ョ ン を どの メ モ リ 空 間 に 配 置 する かについて 詳 細
な 示 が 必 要 と な り ます。
メモリタイプが 異 なる 場 合
多 くのシステムには、 フラッシュ、 ROM、 SDRAM、 高 速 SRAM など、
さまざまな 物 理 メモリデバイスが 組 み 込 まれています。 スキャッタロー
ド 記 述 ファルによって、 コード とデータを 最 も 適 切 なメモリ タイプに 対
応 付 け る こ と がで き ます。 例 えば、 割 り 込 みコー ド を 高 速 SRAM に 配
置 して 割 り 込 み 応 答 時 間 を 向 上 させ、 あまり 使 用 されないコンフィギュ
レーシ ョ ン 情 報 はそれよ り も 遅 いフラ ッシュ メモ リ に 配 置 する といった
ことが 考 えられます
メモリマップされたペリフェラル
ス キ ャ ッ タ ロー ド 記 述 フ ァ イルを 使 用 し て、 データ セ ク シ ョ ン を メ モ リ
マップ 内 の 正 確 なアドレスに 配 置 して、 メモリマップされたペリフェラ
ルアクセスでき ます。
関 数 の 位 置 を 固 定 する 場 合
ある 関 数 を 含 んでいるアプ リ ケーシ ョ ンが 修 正 され、 再 コンパイルされ
た 場 合 でも、 その 関 数 を メ モ リ 内 の 同 じ 位 置 に 配 置 し てお く こ と ができ
ます。 これはジャンプテーブルの 実 装 に 役 立 ちます。
ヒ ープ と ス タ ッ ク の 識 別 にシンボルを 使 用 する 場 合
アプ リ ケーシ ョ ンを リ ンクする と きのヒープと スタ ッ クの 位 置 を 示 すシ
ンボルを 定 義 できます。
組 み 込 みシ ス テムでは ROM、 RAM、 およびメモリマップされたペリフェラルが 使 用
さ れる ため、 通 常 、 組 み 込 みシ ス テムの 実 装 ではス キ ャ ッ タ ロー ド が 必 要 と な り ま
す。
8.2.1 関 連 項 目
概 念
• スキャッタロードについて (8-3 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-4
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.3 スキャ ッ タロードのコマン ド ラインオプシ ョ ン
以 下 に、 ス キ ャ ッ タ ロー ド を 使 用 する ための armlink コマンドラインオプショ ンを 示
します。
--scatter=description_file
このコマンドは、description_file に 記 述 されている とお り にイ メ ージの メ モ リ マ ッ
プを 構 成 するよ うにリ ンカに 指 示 します。
ベースプ ラ ッ ト フ ォーム リ ン ク モデルでは、 ス キ ャ ッ タ ロー ド をサポー ト し ていま
す。 こ のモデルを 有 効 にする には、 --base_platform コマンド ラインオプショ ンを 使 用
します。
--scatter は、 以 下 の メ モ リ マ ッ プ 関 連 のコ マン ド ラ イ ンオプシ ョ ン と 共 に 使 用 する
ことはできません。
• --bpabi
• --dll
• --partial
• --ro_base
• --rw_base
• --ropi
• --rwpi
• --rosplit
• --split
• --reloc
• --shared
• --startup
• --sysv
• --zi_base
8.3.1 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• スキャッタロードについて (8-3 ページ)
• スキャッタロードが 使 用 される 状 況 (8-4 ページ)
• 等 価 な ス キ ャ ッ タ ロー ド 記 述 を 使 用 し た 単 純 イ メ ージの 生 成 (8-65 ページ) .
参 照
『リンカリファレンス』:
• --base_platform (2-18 ページ)
• --bpabi (2-24 ページ)
• --dll (2-49 ページ)
• --partial (2-120 ページ)
• --reloc (2-134 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• --rosplit (2-139 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-5
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• --scatter=file (2-144 ページ)
• --shared (2-148 ページ)
• --split (2-156 ページ)
• --startup=symbol、 --no_startup (2-157 ページ)
• --sysv (2-172 ページ)
• --zi_base=address (2-197 ページ)
• 第 4 章 スキャッタファイルの 正 式 な 構 文 .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-6
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.4 メ モ リ マ ッ プが 単 純 な イ メ ージ
イ メージの メ モ リ マップが 単 純 な 場 合 には、 以 下 のいずれかの 方 法 を 使 用 でき ます。
• ス キ ャ ッ タ フ ァ イルを 使 用 し ます。
• 基 本 的 な リ ン カ コ マン ド ラ イ ンオプシ ョ ン を 使 用 し て、 メ モ リ マ ッ プを 指 定 し
ます。
以 下 の 図 には、 単 純 な メ モ リ マ ッ プを 示 し ています。
0x16000
ZI
RW
SRAM
0x10000
/
0x8000
RW
RO
RO
ROM
0x0000
図 8-1 スキャ ッ タロード を 行 った 単 純 メモリマップ
以 下 の 例 では、 セグ メ ン ト をオブジ ェ ク ト フ ァ イ ルか ら メ モ リ に ロー ド する、 対 応
するスキャ ッ タロード 記 述 を 示 しています。
例 8-1 スキャ ッ タ フ ァ イルにおける 単 純 メモリマップ
LOAD_ROM 0x0000 0x8000
{
EXEC_ROM 0x0000 0x8000
{
}
; ロード 領 域 の 名 前 (LOAD_ROM)、
; ロード 領 域 の 開 始 アドレス (0x0000)、
; ロード 領 域 の 最 大 サイズ (0x8000)
; 最 初 の 実 行 領 域 の 名 前 (EXEC_ROM)、
; 実 行 領 域 の 開 始 ア ド レ ス (0x0000)、
; 最 初 の 実 行 領 域 の 最 大 サ イ ズ (0x8000)
* (+RO) ; すべてのコード と RO データを
; こ の 実 行 領 域 に 配 置 す る
}
SRAM 0x10000 0x6000
{
}
; 2 番 目 の 実 行 領 域 の 名 前 (RAM)、
; 2 番 目 の 実 行 領 域 の 開 始 ア ド レ ス (0x10000)、
; 2 番 目 の 実 行 領 域 の 最 大 サ イ ズ (0x6000)
* (+RW, +ZI) ; すべての RW データ と ZI データを
; こ の 実 行 領 域 に 配 置 す る
領 域 の 最 大 サ イ ズ を 指 定 する かど う かは 任 意 です。 ただ し、 指 定 する こ と に よ っ て、
その 領 域 が 境 界 からオーバーフ ローしないかど う かをチェ ッでき ます。
こ の 例 では、 以 下 の リ ン カ コ マン ド ラ イ ン を 使 用 する こ と に よ り 、 制 限 のチェ ッ ク
以 外 は 同 じ 結 果 を 得 る こ と がで き ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-7
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
armlink --ro_base 0x0 --rw_base 0x10000
8.4.1 関 連 項 目
概 念
• スキャッタロードについて (8-3 ページ)
• スキャッタロードが 使 用 される 状 況 (8-4 ページ)
• スキャッタファイルを 使 用 した ELF のマッ ピング (8-73 ページ) .
参 照
『リンカリファレンス』:
• --ro_base=address (2-137 ページ)
• --rw_base=address (2-141 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-8
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.5 メ モ リ マ ッ プが 複 雑 な イ メ ージ
メ モ リ マップが 複 雑 なイ メージの 場 合 、 基 本 的 な リ ンカコマン ド ラ イ ンオプシ ョ ン
を 使 用 して、 メモ リ マップを 指 定 できません。 そ う したイ メーには、 スキャ ッ タ
フ ァ イ ルを 使 用 する 必 要 があ り ます。
以 下 の 図 には、 複 雑 な メ モ リ マ ッ プを 示 し ています。
0x20000
ZI #2
RW #1
DRAM
0x18000
0x10000
ZI #1
RW #2
SRAM
0x08000
0x4000
RW #2
RO #2
RO #2
ROM2
RW #1
ROM1
0x0000
RO #1
RO #1
0x00000
図 8-2 複 雑 な メ モ リ マ ッ プ
以 下 の 例 では、 セグ メ ン ト を program1.o ファイルおよび program2.o ファイルからメモ
リ に ロー ド する、 対 応 する ス キ ャ ッ タ ロー ド 記 述 を 示 し ています。
例 8-2 スキャ ッ タ フ ァ イルにおける 複 雑 なメモリマップ
LOAD_ROM_1 0x0000
{
EXEC_ROM_1 0x0000
{
program1.o (+RO)
}
; 最 初 のロード 領 域 の 開 始 アドレス (0x0000)
; 最 初 の 実 行 領 域 の 開 始 ア ド レ ス (0x0000)
; program1.o のすべてのコード と
; RO デ ー タ を こ の 実 行 領 域 に 配 置 す る
}
DRAM 0x18000 0x8000
{
}
; こ の 実 行 領 域 の 開 始 ア ド レ ス (0x18000)、
; こ の 実 行 領 域 の 最 大 サ イ ズ (0x8000)
program1.o (+RW, +ZI) ; program1.o のすべての RW データ と
; ZI デ ー タ を こ の 実 行 領 域 に 配 置 す る
LOAD_ROM_2 0x4000
{
EXEC_ROM_2 0x4000
{
; 2 番 目 のロード 領 域 の 開 始 アドレス (0x4000)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-9
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
}
program2.o (+RO)
; program2.o のすべてのコード と
; RO デ ー タ を こ の 実 行 領 域 に 配 置 す る
}
SRAM 0x8000 0x8000
{
program2.o (+RW, +ZI) ; program2.o のすべての RW データ と
; ZI デ ー タ を こ の 実 行 領 域 に 配 置 す る
}
注 意
こ の 例 に 示 すス キ ャ ッ タ ロー ド 記 述 では、 program1.o と program2.o のみのコード およ
びデータ の 位 置 を 指 定 し ています。 し たがって、 例 えば program3.o という 別 のモ
ジュールをリンクさせるときにこの 記 述 ファイルを 使 用 しても、program3.o のコード
とデータの 位 置 は 指 定 されません。
コー ド と データ の 配 置 をかな り 厳 密 に 指 定 する 必 要 があ る 箇 所 を 除 き、 * または .ANY
指 定 子 を 使 用 し て 残 り のコー ド と データ を 配 置 する こ と を 推 奨 し ます。
8.5.1 関 連 項 目
タスク
• ルー ト 実 行 領 域 の 作 成 (8-14 ページ)
• FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 (8-17 ページ) .
概 念
• スキャッタロードについて (8-3 ページ)
• スキャッタロードが 使 用 される 状 況 (8-4 ページ)
• スキャッタファイルを 使 用 した ELF のマッ ピング (8-73 ページ) .
『リンカリファレンス』:
• 相 対 ベース ア ド レ スの ロー ド 領 域 と ZI 実 行 領 域 を 含 んだス キ ャ ッ タ フ ァ イル
(4-40 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-10
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.6 スキャ ッ タ ロー ド 時 に 定 義 されない リ ン カ 定 義 シンボル
ス キ ャ ッ タ フ ァ イルを 使 用 する 場 合 、 以 下 のシンボルは 定 義 さ れません。
• Image$$RW$$Base
• Image$$RW$$Limit
• Image$$RO$$Base
• Image$$RO$$Limit
• Image$$ZI$$Base
• Image$$ZI$$Limit
ス キ ャ ッ タ フ ァ イルを 使 用 するが、 ス タ ッ ク と ヒ ープに 特 別 な 領 域 名 を 使 用 し ない
場 合 、 ま たは __user_setup_stackheap() を 再 実 装 し ない 場 合 、 エ ラー メ ッ セージが 生 成
されます。
8.6.1 関 連 項 目
タスク
• リンカ 定 義 シンボルへのアクセス (7-4 ページ)
• スキャッタファイルを 使 用 したスタック と ヒープの 指 定 (8-12 ページ) .
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• スタックと ヒープの 配 置 (3-14 ページ) .
概 念
『 移 行 と 互 換 性 』 :
• RVCT v2.2 と RVCT v3.0 の 間 での C および C++ ライブラリの 変 更 点 (9-5 ペー
ジ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-11
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.7 スキャ ッ タ フ ァ イルを 使 用 し たス タ ッ ク と ヒ ープの 指 定
ARM C ライブラリには、 関 数 __user_setup_stackheap() の 複 数 の 実 装 があ り 、 ス
キ ャ ッ タ フ ァ イルの 情 報 に 基 づいて 適 切 な 実 装 が 自 動 的 に 選 択 さ れます。
2 つの 領 域 に よ る メ モ リ モデルを 選 択 する には、 ス キ ャ ッ タ フ ァ イ ルに ARM_LIB_HEAP
および ARM_LIB_STACK という 名 前 の 2 つの 特 殊 な 実 行 領 域 を 定 義 し ます。 こ れら の 領
域 には EMPTY 属 性 があ り ます。 そのため、 ラ イ ブ ラ リ では、 以 下 のシンボルの 値 を 使
用 する、 __user_setup_stackheap() のデフ ォル ト ではない 実 装 が 選 択 されます。
• Image$$ARM_LIB_STACK$$Base
• Image$$ARM_LIB_STACK$$ZI$$Limit
• Image$$ARM_LIB_HEAP$$Base
• Image$$ARM_LIB_HEAP$$ZI$$Limit
ARM_LIB_STACK 領 域 と ARM_LIB_HEAP 領 域 のど ち ら か 1 つを 指 定 できます。 その 際 、 サイ
ズを 割 り 当 て る 必 要 があ り ます。 以 下 に 例 を 示 し ます。
ARM_LIB_HEAP 0x20100000 EMPTY 0x100000-0x8000
ARM_LIB_STACK 0x20200000 EMPTY -0x8000
; ヒープは 1 MB の 位 置 か ら
; 上 位 ア ド レ ス に 向 か っ て 展 開 さ れ る
; スタック 空 間 は 2MB の RAM の 末 尾 か ら
; 下 位 ア ド レ ス に 向 か っ て
; 32KB 展 開 さ れ る
EMPTY 属 性 が 定 義 さ れた ARM_LIB_STACKHEAP と い う 単 一 の 実 行 領 域 を 定 義 する こ と に よ
り 、 ス タ ッ ク と ヒ ープの 結 合 領 域 を 使 用 で き ます。 その 結 果 、
__user_setup_stackheap() では、 シンボル Image$$ARM_LIB_STACKHEAP$$Base および
Image$$ARM_LIB_STACKHEAP$$ZI$$Limit の 値 が 使 用 されます。
注
__user_setup_stackheap() を 再 実 装 する と 、 すべての ラ イ ブ ラ リ 実 装 がオーバーラ イ ド
されます。
8.7.1 関 連 項 目
タスク
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• スタックと ヒープの 配 置 (3-14 ページ) .
概 念
『 移 行 と 互 換 性 』 :
• RVCT v2.2 と RVCT v3.0 の 間 での C および C++ ライブラリの 変 更 点 (9-5 ペー
ジ) .
参 照
• 領 域 関 連 シンボル (7-5 ページ) .
『ARM ® C および C++ ラ イ ブ ラ リ と 浮 動 小 数 点 サポー ト の 使 用 』 :
• __user_setup_stackheap() (2-61 ページ)
• 古 い 関 数 __user_initial_stackheap() (2-72 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-12
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.8 ルー ト 領 域 とは
ルー ト 領 域 と は、 ロー ド ア ド レ ス と 実 行 ア ド レ スが 同 一 の 領 域 です。 イ メ ージの 初
期 エン ト リ ポ イ ン ト は、 ルー ト 領 域 に 存 在 する 必 要 があ り ます 初 期 エン ト リ ポ イ ン
ト がルー ト 領 域 内 にない 場 合 、 その リ ン ク は 失 敗 し、 リ ン カに よ っ てエ ラー メ ッ
セージが 生 成 されます。
例 8-3 ロー ド ア ド レス と 実 行 ア ド レスが 同 一 のルー ト 領 域
LR_1 0x040000
; ロード 領 域 を 0x40000 から 開 始 する
{ ; 実 行 領 域 の 開 始 位 置 の 記 述
ER_RO 0x040000 ; load address = execution address
{
* (+RO) ; すべての RO セクショ ン ( 初 期 エントリポイントが 指 定 されている
; セクショ ンが 含 まれている 必 要 がある)
}
... ; 残 りのスキャ ッ タロード 記 述
}
8.8.1 関 連 項 目
タスク
• ルー ト 実 行 領 域 の 作 成 (8-14 ページ)
• FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 (8-17 ページ)
• ARM C および C++ ライブラリコードの 配 置 について (8-52 ページ) .
概 念
• イメージの 構 造 (4-3 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-13
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.9 ルー ト 実 行 領 域 の 作 成
ス キ ャ ッ タ フ ァ イル 内 で、 あ る 領 域 をルー ト 領 域 と し て 指 定 する 場 合 には、 以 下 の
方 法 を 使 用 できます。
• 実 行 領 域 の 属 性 と し て、 明 示 的 にま たはデフ ォル ト のま まで ABSOLUTE を 指 定 し、
最 初 の 実 行 領 域 と それを 含 むロー ド 領 域 に 同 じ ア ド レ ス を 使 用 し ます。 実 行 領
域 のア ド レ スに ロー ド 領 域 と 同 じ ア ド レ ス を 指 定 する には、 以 下 のいずれかの
方 法 を 使 用 し ます。
— 実 行 領 域 と ロー ド 領 域 のベース ア ド レ スに 同 じ 数 値 を 指 定 し ます。
— ロー ド 領 域 内 の 最 初 の 実 行 領 域 のオフセ ッ ト に +0 を 指 定 します。
ロード 領 域 内 の 2 番 目 以 降 のすべての 実 行 領 域 のオフセ ッ ト にゼ ロ (+0)
が 指 定 されている 場 合 には、 ZI を 含 む 実 行 領 域 の 後 に 続 かないすべての
実 行 領 域 も ルー ト 領 域 にな り ます。
以 下 の 例 では、 暗 黙 的 に 定 義 さ れたルー ト 領 域 を 示 し ています。
例 8-4 ロー ド ア ド レス と 実 行 ア ド レスが 同 一 の 暗 黙 的 なルー ト 領 域
LR_1 0x040000
; ロード 領 域 を 0x40000 から 開 始 する
{ ; 実 行 領 域 の 開 始 位 置 の 記 述
ER_RO 0x040000 ; load address = execution address
{
* (+RO) ; すべての RO セクショ ン ( 初 期 エントリポイントが 指 定 されている
; セクショ ンが 含 まれている 必 要 がある)
}
... ; 残 りのスキャ ッ タロード 記 述
}
• FIXED 実 行 領 域 属 性 を 使 用 し て、 特 定 の 領 域 の ロー ド ア ド レ ス と 実 行 ア ド レ スに
同 じアドレスを 指 定 します。
FIXED 属 性 を 使 用 し て、 ROM 内 の 特 定 のア ド レ スに 任 意 の 実 行 領 域 を 配 置 で き
ます。
例 えば、 以 下 の メ モ リ マ ッ プは 固 定 実 行 領 域 を 示 し ています。
–pad
init.o
init.o
0x80000
()
()
*(RO)
0x4000
*(RO)
図 8-3 固 定 実 行 領 域 の メ モ リ マ ッ プ
以 下 の 例 では、 対 応 する ス キ ャ ッ タ ロー ド 記 述 を 示 し ています。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-14
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
例 8-5 FIXED 属 性 の 使 用
LR_1 0x040000
; ロード 領 域 を 0x40000 から 開 始 する
{ ; 実 行 領 域 の 開 始 位 置 の 記 述
ER_RO 0x040000
; load address = execution address
{
* (+RO) ; init.o 以 外 の RO セクショ ン
}
ER_INIT 0x080000 FIXED ; こ の 実 行 領 域 の ロ ー ド ア ド レ ス と
; 実 行 ア ド レ ス が 0x80000 に 固 定 される
{
init.o(+RO) ; init.o のすべての RO セクション
}
... ; 残 りのスキャ ッ タロード 記 述
}
8.9.1 FIXED 属 性 の 誤 っ た 使 用 例
以 下 の 例 では、 FIXED 実 行 領 域 属 性 の 誤 った 使 用 の 一 般 的 な 事 例 を 示 し ています。
例 8-6 FIXED 属 性 の 誤 っ た 使 用
LR1 0x8000
{
ER_LOW +0 0x1000
{
*(+RO)
}
; こ の 時 点 で、 次 の 使 用 可 能 な ロ ー ド ア ド レ ス と 実 行 ア ド レ ス が 0x8000 +
; ER_LOW の 内 容 のサ イ ズにな り ます。 最 大 サ イ ズは 0x1000 に 制 限 さ れ て い る た め、 次 の 使 用 可 能 な ロ ー ド ア ド
レスと
; 実 行 ア ド レ ス は 最 大 で 0x9000 になります。
ER_HIGH 0xF0000000 FIXED
{
*(+RW+ZI)
}
; 必 要 な 実 行 アドレスとロードアドレスは 0xF0000000 です。 ロードアドレス と
; 実 行 ア ド レ ス が 一 致 す る よ う に、 リ ン カ に よ っ て 0xF0000000 - (0x8000 + (ER_LOW) のサイズ ) バイトの
; パデ ィ ングが 挿 入 されます。
}
; その 他 の FIXED の 誤 っ た 使 用 の 一 般 的 な 事 例 と し て、 次 の 使 用 可 能 なロ ー ド ア ド レ ス よ り も
; 下 位 の 実 行 ア ド レ ス を 指 定 す る こ と が あ り ま す。
LR_HIGH 0x100000000
{
ER_LOW 0x1000 FIXED
{
*(+RO)
}
; LR_HIGH の 次 の 使 用 可 能 なロードアドレスは 0x10000000 です。 必 要 な 実 行
; アドレスは 0x1000 です。 LR_HIGH の 次 の 使 用 可 能 な ロ ー ド ア ド レ ス は 単 調 に
; 増 加 さ せ る 必 要 が あ る た め、 リ ン カ は ER_LOW に 0x10000000 よりも 下 位 のロードアドレスを 指 定 できませ
ん。
}
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-15
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.9.2 関 連 項 目
タスク
• FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 (8-17 ページ) .
概 念
• ルー ト 領 域 と は (8-13 ページ) .
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ)
• 実 行 領 域 の 記 述 について (4-10 ページ)
• ロード 領 域 に 相 対 アドレス +offset を 使 用 する 際 の 注 意 事 項 (4-18 ページ)
• 実 行 領 域 に 相 対 ア ド レ ス +offset を 使 用 する 際 の 注 意 事 項 (4-19 ページ) .
参 照
『リンカリファレンス』:
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ) .
『アセンブラ リ フ ァ レンス』 :
• ENTRY (6-78 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-16
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.10 FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成
実 行 領 域 のス キ ャ ッ タ フ ァ イルで FIXED 属 性 を 使 用 して、 ロードア ド レス と 実 行 ア ド
レスを 固 定 したルート 領 域 を 作 成 できます。
FIXED 属 性 は、 1 つのロード 領 域 内 に 複 数 のルー ト 領 域 を 作 成 する 場 合 に 使 用 され、
通 常 は 1 つの ROM デバイ スに 使 用 さ れます。 例 えば、 こ の 属 性 を 使 し て、 関 数 ま た
は 定 数 テーブルやチェ ッ ク サムなどのデータブロ ッ ク を ROM 内 の 固 定 ア ド レ スに 配
置 する こ と で、 ポ イ ン タ を 使 用 し て 容 易 にア ク スで き ます。
初 期 化 コー ド を ROM の 最 初 に 配 置 し、 チェ ッ ク サム を ROM の 最 後 に 配 置 する よ う
な 場 合 には、 メ モ リ の 一 部 が 使 用 さ れない 可 能 性 があ り ます。 * または .ANY モジュー
ルセレ ク タ を 使 用 する こ と で、 初 期 化 ブ ロ ッ ク の 最 後 と データ ブ ロ ッ ク の 最 初 の 間
にある 領 域 を 充 填 できます。
コー ド の 保 守 と デバ ッ グ を 容 易 にするには、 ス キ ャ ッ タ フ ァ イル 内 での 配 置 に 関 す
る 指 定 を 最 小 限 に 抑 え、 関 数 と データ の 詳 細 な 配 置 は リ ンカにねる こ と を 推 奨 し ま
す。
部 分 的 に リ ン ク さ れた コ ンポーネン ト オブジ ェ ク ト は 指 定 で き ません。 例 えば、
obj1.o、 obj2.o、 および obj3.o の 3 つのオブジ ェ ク ト を 部 分 的 に リ ン ク し て obj_all.o
を 生 成 する 場 合 、 結 果 と し て 得 ら れたオブジ ェ ク ト 内 ではコ ンポーネン ト オブジ ェ
クトの 名 前 は 破 棄 されます。したがって、いずれのオブジェクトも obj1.o などの 名
前 で 参 照 する こ と はでき ません。 参 照 でき るのは、 結 合 されたオブジェ ク ト
obj_all.o のみです。
注
FIXED 属 性 と 1 つのロード 領 域 を 使 用 する こ と が 適 切 ではない 場 合 があ り ます。 固 定
位 置 の 指 定 に 関 し ては 以 下 の よ う な 方 法 も あ り ます。
• ローダで 複 数 の ロー ド 領 域 を 処 理 で き る 場 合 には、 RO コード またはデータを
専 用 の ロー ド 領 域 内 に 配 置 し ます。
• 関 数 ま たはデータ を ROM 内 の 固 定 位 置 に 配 置 する 必 要 がない 場 合 には、 FIXED
属 性 の 代 わ り に ABSOLUTE 属 性 を 使 用 し ます。 こ の 属 性 を 使 用 する と 、 ローダは
ロード 領 域 から RAM 内 の 指 定 さ れたア ド レ スにデータ を コ ピーし ます。
ABSOLUTE がデフ ォル ト の 属 性 です。
• メモリマップされた I/O の 位 置 にデータ 構 造 を 配 置 するには、2 つのロード 領 域
を 使 用 して UNINIT 属 性 を 指 定 し ます。 UNINIT を 指 定 する と 、 その メ モ リ 位 置 は
ゼロで 初 期 化 されません。
8.10.1 関 連 項 目
概 念
『リンカリファレンス』:
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
『リンカリファレンス』:
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-17
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.11 特 定 ア ド レスへの 関 数 と デー タの 配 置
通 常 、 コ ンパ イ ラ は 1 つのソース フ ァ イルから RO、 RW、 ZI の 3 つのセ ク シ ョ ンを
生 成 し ます。 こ れら の 領 域 には、 ソース フ ァ イルのすべての コー と データ が 保 持 さ
れます。 1 つの 関 数 項 目 ま たはデータ 項 目 を 固 定 ア ド レ スに 配 置 する には、 その 関 数
ま たはデータ を、 入 力 フ ァ イルの 他 の 部 分 は 別 に リ ン カに 処 理 させる 必 要 があ り ま
す。
リンカでセクションを 特 定 のアドレスに 配 置 できるようにするには、 方 法 が 2 つあ
ります。
• 目 的 のア ド レ スに 実 行 領 域 を 定 義 する ス キ ャ ッ タ フ ァ イルは、 1 つのセ ク シ ョ
ンだけを 選 択 する セ ク シ ョ ン 記 述 を 使 用 し て 作 成 で き ます。
• 特 別 な 名 前 付 き セ ク シ ョ ンの 場 合 、 リ ン カはセ ク シ ョ ン 名 か ら 配 置 ア ド レ ス を
取 得 で き ます。 こ れ ら の 特 別 な 名 前 付 き セ ク シ ョ ンは、 __at セクションと 呼 ば
れます。
関 数 ま たは 変 数 を 特 定 のア ド レ スに 配 置 するには、 その 固 有 のセ ク シ ョ ンに 配 置 す
る 必 要 があ り ます。 それを 実 行 するには、 方 法 がい く つかあ り ます。
• 関 数 ま たはデータ 項 目 を、 その 関 数 やデータ 項 目 し かない 個 別 の ソース フ ァ イ
ル 内 に 配 置 する。
• __attribute__((at(address))) を 使 用 して、 別 個 のセクシ ョ ンの 特 定 のア ド レスに
変 数 を 配 置 する。
• __attribute__((section("name"))) を 使 用 し て、 名 前 付 き セ ク シ ョ ンに 関 数 や 変 数
を 配 置 する。
• アセンブ リ 言 語 から AREA ディレクティブを 使 用 します。 アセンブリ コードで 配
置 可 能 な 最 小 単 位 は AREA です。
• --split_sections コンパイラオプションを 使 用 して、 ソースファイルの 関 数 ごと
に 1 つの ELF セクションを 生 成 します。
こ のオプシ ョ ン を 指 定 する と 、 関 数 間 でア ド レ ス、 データ、 および 文 字 列 リ テ
ラ ルを 共 有 する 可 能 性 が 減 る ため、 一 部 の 関 数 で コー ド のサ イ ズがずかに 増 加
します。 ただし、armlink --remove を 指 定 する こ とによって、 リ ンカは 使 用 され
ていない 関 数 を 削 除 でき るため、 最 終 イ メージの 合 計 サイズを 小 さ くする こ と
ができ ます。
8.11.1 スキャ ッ タ ロー ド を 使 用 せずに 特 定 のア ド レスに 変 数 を 配 置 する 例
こ の 例 では、 コー ド と データ を 特 定 のア ド レ スに 配 置 する よ う に ソース コー ド を 変
更 する 方 法 を 紹 介 し ています。 なお、 ス キ ャ ッ タ フ ァ イ ルは 必 と し ません。
1. 以 下 の コー ド を 含 む main.c という 名 前 のソースファイルを 作 成 します。
#include
extern int sqr(int n1);
int gSquared __attribute__((at(0x5000))); // 0x5000 に 配 置
int main()
{
gSquared=sqr(3);
printf("Value squared is:%d\n", gSquared);
}
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-18
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
2. 以 下 の コー ド を 含 む function.c という 名 前 のソースファイルを 作 成 します。
int sqr(int n1)
{
return n1*n1;
}
3. ソースをコンパイルし、 リ ンクします。
armcc -c -g function.c
armcc -c -g main.c
armlink --map function.o main.o -o squared.axf
--map オプシ ョ ン を 指 定 する と 、 イ メ ージの メ モ リ マ ッ プが 表 示 さ れます。 ま
た、 --autoat はデフ ォル ト です。
この 例 では、__attribute__((at(0x5000))) によって、 グローバル 変 数 gSquared が 絶 対 ア
ドレス 0x20000 に 配 置 されます。 gSquared は、 実 行 領 域 ER$$.ARM.__AT_0x00005000 および
ロード 領 域 LR$$.ARM.__AT_0x00005000 に 配 置 されます。
メ モ リ マ ッ プは 次 の よ う に 表 示 さ れます。
...
Load Region LR$$.ARM.__AT_0x00005000 (Base:0x00005000, Size:0x00000000, Max:0x00000004, ABSOLUTE)
Execution Region ER$$.ARM.__AT_0x00005000 (Base:0x00005000, Size:0x00000004, Max:0x00000004, ABSOLUTE,
UNINIT)
Base Addr Size Type Attr Idx E Section Name Object
0x00005000 0x00000004 Zero RW 15 .ARM.__AT_0x00005000 main.o
8.11.2 スキャ ッ タロード を 使 用 して 名 前 付 きセクシ ョ ンに 変 数 を 配 置 する 例
この 例 では、 スキ ャ ッ タ フ ァ イルを 使 用 し て、 コード とデータ を 特 定 のセ ク シ ョ ン
に 配 置 する よ う に ソ ース コー ド を 変 更 する 方 法 を 紹 介 し ています。
1. 以 下 の コー ド を 含 む main.c という 名 前 のソースファイルを 作 成 します。
#include
extern int sqr(int n1);
int gSquared __attribute__((section("foo"))); // セクショ ン foo に 配 置
int main()
{
gSquared=sqr(3);
printf("Value squared is:%d\n", gSquared);
}
2. 以 下 の コー ド を 含 む function.c という 名 前 のソースファイルを 作 成 します。
int sqr(int n1)
{
return n1*n1;
}
3. 以 下 の ロー ド 領 域 を 含 んだ scatter.scat という 名 前 のスキャッタファイルを 作
成 します。
LR1 0x0000 0x20000
{
ER1 0x0 0x2000
{
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-19
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
}
*(+RO)
; 残 りのコード と 読 み 出 し 専 用 データ
}
ER2 0x8000 0x2000
{
main.o
}
ER3 0x10000 0x2000
{
function.o
*(foo)
; gSquared を ER3 に 配 置 する
}
RAM 0x200000 (0x1FF00-0x2000) ; RW データ と ZI データを 0x200000 に 配 置 する
{
*(+RW, +ZI)
}
ARM_LIB_STACK 0x800000 EMPTY -0x10000
{
}
ARM_LIB_HEAP +0 EMPTY 0x10000
{
}
このプログラムは、 セミホスティングライブラ リ と リンクされるため、
ARM_LIB_STACK 領 域 と ARM_LIB_HEAP 領 域 が 必 要 です。
4. ソースをコンパイルし、 リ ンクします。
armcc -c -g function.c
armcc -c -g main.c
aarmlink --map --scatter=scatter.scat function.o main.o -o squared.axf
--map オプシ ョ ン を 指 定 する と 、 イ メ ージの メ モ リ マ ッ プが 表 示 さ れます。 ま
た、 --autoat はデフ ォル ト です。
この 例 では、__attribute__((section("foo"))) によって、グローバル 変 数 gSquared が foo
というセクションに 配 置 されます。 セクション foo は、 ER3 実 行 領 域 に 配 置 さ れます。
メ モ リ マ ッ プは 次 の よ う に 表 示 さ れます。
Load Region LR1 (Base:0x00000000, Size:0x00001778, Max:0x00020000, ABSOLUTE)
...
Execution Region ER3 (Base:0x00010000, Size:0x00000004, Max:0x00002000, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
...
0x00010000 0x00000004 Data RW 15 foo main.o
注
スキャッタファイルから *(foo) を 省 略 した 場 合 、 セクシ ョ ンは 同 じ 種 類 の 領 域 に 配
置 されます。 この 例 では RAM という ことになります。
8.11.3 スキャ ッ タ ロー ド を 使 用 し て 特 定 のア ド レスに 変 数 を 配 置 する 例
この 例 では、 スキ ャ ッ タ フ ァ イルを 使 用 し て、 コード とデータ を 特 定 のア ド レ スに
配 置 するよ うにソースコードを 変 更 する 方 法 を 紹 介 しています
1. 以 下 の コー ド を 含 む main.c という 名 前 のソースファイルを 作 成 します。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-20
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
#include
extern int sqr(int n1);
// アドレス 0x10000 に 配 置 する
const int gValue __attribute__((section(".ARM.__at_0x10000"))) = 3;
int main()
{
int squared;
squared=sqr(gValue);
printf("Value squared is:%d\n", squared);
}
2. 以 下 の コー ド を 含 む function.c という 名 前 のソースファイルを 作 成 します。
int sqr(int n1)
{
return n1*n1;
}
3. 以 下 の ロー ド 領 域 を 含 んだ scatter.scat という 名 前 のスキャッタファイルを 作
成 します。
LR1 0x0
{
ER1 0x0
{
*(+RO)
; 残 りのコード と 読 み 出 し 専 用 データ
}
ER2 +0
{
function.o
*(.ARM.__at_0x10000)
; gValue を 0x10000 に 配 置 する
}
RAM 0x200000 (0x1FF00-0x2000) ; RW データ と ZI データを 0x200000 に 配 置 する
{
*(+RW, +ZI)
}
ARM_LIB_STACK 0x800000 EMPTY -0x10000
{
}
ARM_LIB_HEAP +0 EMPTY 0x10000
{
}
}
このプログラムは、 セミホスティングライブラ リ と リンクされるため、
ARM_LIB_STACK 領 域 と ARM_LIB_HEAP 領 域 が 必 要 です。
4. ソースをコンパイルし、 リ ンクします。
armcc -c -g function.c
armcc -c -g main.c
armlink --no_autoat --scatter=scatter.scat --map function.o main.o -o squared.axf
--map オプシ ョ ン を 指 定 する と 、 イ メ ージの メ モ リ マ ッ プが 表 示 さ れます。
メモリマップを 見 ると、 アドレス 0x11000 の ER2 実 行 領 域 に 変 数 が 配 置 さ れてい る こ
とがわかります。
...
Execution Region ER2 (Base:0x00001598, Size:0x0000ea6c, Max:0xffffffff, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-21
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
0x00001598 0x0000000c Code RO 3 .text function.o
0x000015a4 0x0000ea5c PAD
0x00010000 0x00000004 Data RO 15 .ARM.__at_0x10000 main.o...
この 例 では、ER1 のサイズが 不 明 です。 そのため、 gValue は、 ER1 または ER2 に 配 置 さ
れる 可 能 性 があ り ます。 gValue を 確 実 に ER2 へ と 配 置 する には、 対 応 する セレ ク タ を
ER2 に 含 めた う えで、 --no_autoat コマンドラインオプショ ンでリンクする 必 要 があり
ます。 --no_autoat を 省 略 した 場 合 、 gValue は、 実 行 領 域 ER$$.ARM.__AT_0x00020000 を 含
んだ 別 個 の ロー ド 領 域 LR$$.ARM.__AT_0x00010000 に 配 置 されます。
8.11.4 関 連 項 目
タスク
• ス キ ャ ッ タ ロー ド を 使 用 し た 名 前 付 き セ ク シ ョ ンの 明 示 的 な 配 置 (8-23 ペー
ジ)
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ) .
概 念
• __at セ ク シ ョ ンの 配 置 に 関 する 制 限 (8-41 ページ) .
参 照
『コンパイ ラ リ ファレンス』 :
• --split_sections (3-203 ページ)
• __attribute__((section("name"))) 関 数 属 性 (5-54 ページ)
• __attribute__((at(address))) 変 数 属 性 (5-68 ページ)
• __attribute__((section("name"))) 変 数 属 性 (5-73 ページ)
• #pragma arm section [section_type_list] (5-84 ページ) .
『リンカリファレンス』:
• --autoat、 --no_autoat (2-17 ページ)
• --map、 --no_map (2-109 ページ)
• --scatter=file (2-144 ページ) .
『アセンブラ リ フ ァ レンス』 :
• AREA (6-72 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-22
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.12 スキャ ッ タ ロー ド を 使 用 し た 名 前 付 きセ ク シ ョ ンの 明 示 的 な 配 置
以 下 の 例 では、 ス キ ャ ッ タ ロー ド を 使 用 し て 名 前 付 き セ ク シ ョ ン を 明 示 的 に 配 置 す
る 方 法 を 示 しています。
例 8-7 セ ク シ ョ ンの 明 示 的 な 配 置
LR1 0x0 0x10000
{
ER1 0x0 0x2000
; 初 期 化 コ ー ド を 含 む ル ー ト 領 域
{
init.o (INIT, +FIRST) ; 初 期 化 コ ー ド を 0x0 に 正 確 に 配 置 する
*(+RO)
; 残 りのコード と 読 み 出 し 専 用 データ
}
RAM_RW 0x400000 (0x1FF00-0x2000) ; RW データ と ZI データを 0x400000 に 配 置 する
{
*(+RW)
}
RAM_ZI +0
{
*(+ZI)
}
DATABLOCK 0x1FF00 0xFF
; 0x1FF00 の 実 行 領 域
{ ; テ ー ブ ル に 使 用 可 能 な 最 大 空 間 は 0xFF
data.o(+RO-DATA)
; RO データを 0x1FF00 と 0x1FFFF の 間 に 配 置 する
}
}
この 例 では、 スキ ャ ッ タ ロード 記 述 によ って、 以 下 のよ う に 配 置 が 行 われます。
• 初 期 化 コー ド は、 init.o ファイルの INIT セクションに 配 置 されます。 この 例 で
は、 INIT セ ク シ ョ ンの コー ド が 最 初 にア ド レ ス 0x0 に 配 置 され、 その 後 に、 RO
コードの 残 り と、 オブジェ ク ト data.o 内 の RO データ を 除 く すべての RO デー
タが 配 置 されます。
• すべてのグ ローバル RW 変 数 は RAM 内 の 0x400000 に 配 置 されます。
• data.o 内 の RO-DATA テーブルはア ド レス 0x1FF00 に 配 置 されます。
8.12.1 関 連 項 目
タスク
• FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 (8-17 ページ) .
概 念
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ)
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
『リンカリファレンス』:
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-23
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
『アセンブラ リ フ ァ レンス』 :
• ENTRY (6-78 ページ) .
『ARM ® プ ロ セ ッ サを ターゲ ッ ト と し た ソ フ ト ウ ェ ア 開 発 』 :
• ビッ トバンドオブジェク トへのリンクを 含 むスキャッタロードファイル
(3-17 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-24
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.13 .ANY モジ ュールセレ ク タ によ る 未 割 り 当 てセ ク シ ョ ンの 配 置
リ ンカは、 特 定 の 実 行 領 域 に 対 し て 入 力 セ ク シ ョ ンの 配 置 を 試 みます。 解 決 で き な
い 入 力 セクションが 存 在 し、そうしたセクションの 配 置 が 重 要 ない 場 合 は、 ス
キャッタファイルで .ANY モジュールセレ ク タを 使 用 できます。
ほとんどの 場 合 、 1 つの .ANY セレクタを 使 用 しても、* モジ ュールセレ ク タ を 使 用 し
ても、 同 じ 結 果 が 得 られます。 ただし、 * とは 異 なり、.ANY は 複 数 の 実 行 領 域 に 指 定
できます。
8.13.1 未 割 り 当 てセ ク シ ョ ンのデフ ォル ト の 配 置 規 則
リンカが 未 割 り 当 てセクションを 割 り 当 てる 際 のデフォルトの 規 則 を 次 に 示 します。
• 現 在 最 も 空 き スペースのあ る 実 行 領 域 に 未 割 り 当 てセ ク シ ョ ン を 配 置 し ます。
未 割 り 当 てセ ク シ ョ ンに 使 用 する 最 大 スペースサ イ ズ を 実 行 領 域 属 ANY_SIZE で
指 定 で き ます。
• セクションをサイズの 降 順 にソート します。
8.13.2 複 数 の .ANY セレ ク タ を 使 用 し た 場 合 の 配 置 規 則
スキャッタファイルに 複 数 の .ANY セレクタが 存 在 している 場 合 、 リ ンカは、 未 割 り
当 てセクションのうち、 サイズが 最 大 のセクションを 取 得 し、 それを 最 も 限 定 的 で
空 きスペースが 十 分 ある .ANY 実 行 領 域 に 割 り 当 て ます。 例 えば、 .ANY(.text) は、
.ANY(+RO) よ り も 限 定 的 だ と 判 断 さ れます。
複 数 の 実 行 領 域 が 等 し く 限 定 的 であ る 場 合 、 空 き スペースが 最 も 大 きい 実 行 領 域 に
セクションが 割 り 当 てられます。
以 下 に 例 を 示 し ます。
• 2 つの 実 行 領 域 が 同 じ く ら い 限 定 的 であ り 、 1 つはサ イ ズ 制 限 が 0x2000 で、 も う
1 つは 制 限 がない 場 合 、 後 者 の 無 制 限 の .ANY 領 域 にすべてのセ ク シ ョ ンが 割 り
当 てられます。
• 2 つの 実 行 領 域 が 同 じ く ら い 限 定 的 であ り 、 1 つはサ イ ズ 制 限 が 0x2000 で、 も う
1 つはサイ ズ 制 限 が 0x3000 であ る 場 合 、 配 置 さ れる セ ク シ ョ ンはまず、 サ イ ズ
制 限 が 0x3000 である 後 者 の .ANY 領 域 に、 .ANY の 残 り サイ ズが 0x2000 になるまで
割 り 当 てられていきます。 その 後 は、 両 方 の .ANY 実 行 領 域 に 交 互 にセ ク シ ョ ン
が 割 り 当 て られます。
8.13.3 .ANY セ ク シ ョ ンの 優 先 順 位
複 数 の .ANY セクションがある 場 合 は、.ANYnum セレクタ (num は、 ゼロ またはそれよ り
大 き い 正 の 整 数 ) で 優 先 順 位 を 指 定 で き ます。 最 も 大 きい 整 数 を 持 ったセレ ク タ に、
最 も 高 い 優 先 順 位 が 設 定 さ れます。
以 下 に、 .ANYnum の 使 用 例 を 示 し ます。
lr1 0x8000 1024
{
er1 +0 512
{
.ANY1(+RO) ; er3 と 均 等 に 分 散
}
er2 +0 256
{
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-25
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
}
.ANY2(+RO) ; 最 も 優 先 順 位 が 高 い た め、 最 初 に 処 理 さ れ る
}
er3 +0 256
{
.ANY1(+RO) ; er1 と 均 等 に 分 散
}
8.13.4 複 数 の .ANY セレ ク タがある 場 合 の 入 力 セ ク シ ョ ン 配 置 の 制 御
複 数 の .ANY セレク タを 使 用 している 場 合 、 リ ンカによる 未 割 り 当 て 入 力 セクシ ョ ン
の 配 置 動 作 は、 配 置 アルゴ リ ズム ま たは ソー ト 順 序 を 変 え る こ と に よ って 制 御 で き
ます。 以 下 のコマン ド ラ インオプシ ョ ンが 利 用 できます。
• --any_placement=algorithm。 algorithm には、 first_fit、 worst_fit、 best_fit、
next_fit のいずれかを 指 定 し ます。
• --any_sort_order=order。 order には、 cmdline または descending_size を 指 定 し ます。
領 域 を 順 に 埋 めてい く には、 first_fit を 使 用 します。
領 域 をその 上 限 まで 埋 め る には、 best_fit を 使 用 し ます。
領 域 を 均 等 に 埋 めるには、 worst_fit を 使 用 し ます。 同 じ サ イ ズの 領 域 およびセ ク
シ ョ ンの 場 合 、 worst_fit は、 領 域 を 循 環 的 に 埋 めてい き ます。
よ り 確 定 的 なパターンで 埋 めてい く 必 要 があ る 場 合 は、 next_fit を 使 用 し ます。
first_fit や best_fit で、 領 域 の 上 限 まで 埋 めてい く と、 領 域 が 一 杯 になって し ま う
可 能 性 があ り ます。 こ れは、 リ ン カに よ って 生 成 さ れる コ ンテン ツ (パデ ィ ン グ、
ベニアなど) は、 セク シ ョ ンが .ANY セレ ク タ に 割 り 当 て ら れる まで 判 明 し ないため
です。 その 場 合 は、 次 のエラーが 表 示 されます。
エラー:L6220E: 実 行 領 域 regionname のサイズ (size バイト ) が 制 限 (limit バイト ) を 超 えています。
--any_contingency は、 領 域 が 埋 め 尽 く されるのを 防 ぐ ためのオプシ ョ ンです。 リ ンカ
に よ って 生 成 さ れる コ ンテン ツのために、 領 域 の 全 体 の う ち 一 部 のサ イ ズが 確 保 さ
れます。 この 非 常 用 (contingency) のエリ アは、 他 に 空 きのある 領 域 がない 場 合 に
しか 使 用 されません。 この 動 作 が 最 も 起 きやすい first_fit および best_fit のアルゴ
リ ズムでは、 このオプシ ョ ンがデフォルト で 有 効 になっています。
8.13.5 未 割 り 当 てセ ク シ ョ ンの 配 置 に 使 用 で き る 最 大 サイズの 指 定
実 行 領 域 属 性 ANY_SIZE max_size を 使 用 する と 、armlink が 未 割 り 当 てセ ク シ ョ ンで 満 た
すこ と がで き る 領 域 の 最 大 サ イ ズを 指 定 で き ます。
こ のキーワー ド を 使 用 する 場 合 は、 以 下 の 制 限 事 項 に 注 意 し て 下 さ い。
• max_size は、 領 域 サ イ ズ 以 下 であ る 必 要 があ り ます。
• .ANY セレクタなしで ANY_SIZE を 領 域 上 で 使 用 でき ますが、 これは armlink によっ
て 無 視 されます。
ANY_SIZE が 存 在 する 場 合 、 armlink は 以 下 のよ う にな り ます。
• 所 定 の .ANY サ イ ズをオーバーラ イ ド し ません。 つま り 、 優 先 順 位 を 下 げずに、
後 でよ り 多 く のセ ク シ ョ ンをフ ィ ッ ト させよ う と し ます。
• コ ンテ ィ ンジ ェ ンシーを 再 計 算 し ません。
• コンティンジェンシースペースにセクションを 割 り 当 てません。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-26
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
ANY_SIZE では、 --any_contingency の 指 定 は 必 要 あ り ません。 ただし、 --any_contingency
が 指 定 されて も ANY_SIZE は 指 定 されない 場 合 、 armlink はコンティンジェンシーを 調
整 し よ う と し ます。 目 的 は 以 下 の と お り です。
• .ANY 領 域 をオーバーフ ローし ない
• セ ク シ ョ ン を コ ンテ ィ ンジ ェ ンシー 予 約 済 みスペースに 配 置 する こ と を 拒 否 し
ない
コマンド ラインで --any_contingency を 指 定 しても、 ANY_SIZE を 指 定 した 領 域 では 無 視
されます。ANY_SIZE が 指 定 されていない 領 域 では、 通 常 どおり 使 用 されます。
以 下 に、 ANY_SIZE の 使 用 例 を 示 し ます。
LOAD_REGION 0x0 0x3000
{
ER_1 0x0 ANY_SIZE 0xF00 0x1000
{
.ANY
}
ER_2 0x0 ANY_SIZE 0xFB0 0x1000
{
.ANY
}
ER_3 0x0 ANY_SIZE 0x1000 0x1000
{
.ANY
}
}
こ の 例 では、 以 下 の よ う にな り ます。
• ER_1 には、 リ ンカ 生 成 コ ンテンツのために 予 約 された 0x100 があ り ます。
• ER_2 には、 リ ンカ 生 成 コ ンテンツのために 予 約 された 0x50 があ り ます。 これ
は、 --any_contingency の 自 動 コ ンテ ィ ンジ ェ ンシー と ほ と んど 同 じです。
• ER_3 には、 予 約 済 みスペースはあ り ません。 し たがって、 領 域 は 100% 満 たさ
れ、 ベニア 用 のコンティンジェンシーは 残 り ません。ANY_SIZE パラ メーターを
省 略 する と 、 領 域 の 98% が 満 た され、 2% はベニア 用 コンティンジェンシーと
なります。
8.13.6 関 連 項 目
概 念
• .ANY セ ク シ ョ ンの 配 置 アルゴ リ ズムの 使 用 例 (8-29 ページ)
• 領 域 の 割 り 当 て、 セレ ク タ、 および 優 先 度 の 動 作 を 示 す next_fit アルゴ リ ズ
ムの 例 (8-32 ページ)
• .ANY セクシ ョ ンのソート アルゴ リ ズムの 使 用 例 (8-34 ページ) .
『リンカリファレンス』:
• ス キ ャ ッ タ フ ァ イルの 処 理 時 の 複 数 のマ ッ チングを リ ンカが 解 決 する 方 法
(4-28 ページ)
• リンカによって 生 成 されたコンテンツによって .ANY セクションがオーバーフ
ローしたと きの 動 作 (4-31 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-27
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
参 照
『リンカリファレンス』:
• --any_contingency (2-8 ページ)
• --any_placement=algorithm (2-9 ページ)
• --any_sort_order=order (2-11 ページ)
• --info=topic[,topic,...] (2-80 ページ)
• --map、 --no_map (2-109 ページ)
• --section_index_display=type (2-147 ページ)
• --tiebreaker=option (2-175 ページ)
• 入 力 セ ク シ ョ ン 記 述 の 構 文 (4-24 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-28
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.14 .ANY セ ク シ ョ ンの 配 置 アルゴ リ ズムの 使 用 例
ここでは、sections.o の RO-CODE セクションを 例 に、 配 置 アルゴリズムの 動 作 を 説 明 し
ます。
入 力 セ ク シ ョ ンのプロパテ ィ と 順 序 を 以 下 の 表 に 示 し ます。
表 8-1 入 力 セ ク シ ョ ンのプロパテ ィ
名 前
sec1
sec2
sec3
sec4
sec5
sec6
サイ
ズ
0x4
0x4
0x4
0x4
0x4
0x4
こ の 例 で 使 用 する ス キ ャ ッ タ フ ァ イルは 次 の と お り です。
LR 0x100
{
ER_1 0x100 0x10
{
.ANY
}
ER_2 0x200 0x10
{
.ANY
}
}
注
例 では、 --any_contingency を 無 効 にしています。
8.14.1 first_fit、 next_fit、 best_fit の 例
こ の 例 では、 同 じ サ イ ズの 複 数 のセ ク シ ョ ン を、 同 じ セレ ク タ で 2 つの 領 域 に 割 り
当 てる 状 況 を 考 えます。 セレ ク タは 等 し く 限 定 的 で、 .ANY(+R0) に 相 当 し ます。 優 先
順 位 は 設 定 さ れていません。
Execution Region ER_1 (Base:0x00000100, Size:0x00000010, Max:0x00000010, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
0x00000100 0x00000004 Code RO 1 sec1 sections.o
0x00000104 0x00000004 Code RO 2 sec2 sections.o
0x00000108 0x00000004 Code RO 3 sec3 sections.o
0x0000010c 0x00000004 Code RO 4 sec4 sections.o
Execution Region ER_2 (Base:0x00000200, Size:0x00000008, Max:0x00000010, ABSOLUTE)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-29
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
Base Addr Size Type Attr Idx E Section Name Object
0x00000200 0x00000004 Code RO 5 sec5 sections.o
0x00000204 0x00000004 Code RO 6 sec6 sections.o
こ の 例 では、 以 下 の よ う にな り ます。
• first_fit の 場 合 、 リ ンカはまず、 すべてのセ ク シ ョ ン を ER_1 に 割 り 当 ててか
ら、 次 に 利 用 可 能 な 領 域 であ る ER_2 に 移 り ます。
• next_fit の 場 合 も、 リ ンカの 動 作 は 基 本 的 には first_fit と 同 じです。 ただし、
ER_1 が 一 杯 にな る と 、 こ の 実 行 領 域 は FULL としてマークされ、それ 以 降 、 考 慮
されるこ とはあり ません。 この 例 では、ER_1 は 一 杯 です。 そのため、 ER_2 が 考
慮 されます。
• best_fit の 場 合 、 リ ンカは、 sec1 を ER_1 に 割 り 当 て ます。 こ の 時 点 で 優 先 順 位
も 限 定 性 も 等 し い 2 つの 領 域 が 存 在 し ますが、 残 っている スペースは ER_1 の 方
が 少 な く な り ま し た。 この と き、 リ ンカは、 sec2 を ER_1 に 割 り 当 て、 ER_1 が 一
杯 にな る までセ ク シ ョ ンを 割 り 当 て 続 けます。
8.14.2 worst_fit の 例
この 例 は、worst_fit アルゴ リ ズムを 使 用 した 場 合 のイ メージのメモリマップを 示 し
ています。
Execution Region ER_1 (Base:0x00000100, Size:0x0000000c, Max:0x00000010, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
0x00000100 0x00000004 Code RO 1 sec1 sections.o
0x00000104 0x00000004 Code RO 3 sec3 sections.o
0x00000108 0x00000004 Code RO 5 sec5 sections.o
Execution Region ER_2 (Base:0x00000200, Size:0x0000000c, Max:0x00000010, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
0x00000200 0x00000004 Code RO 2 sec2 sections.o
0x00000204 0x00000004 Code RO 4 sec4 sections.o
0x00000208 0x00000004 Code RO 6 sec6 sections.o
リンカはまず、sec1 を ER_1 に 割 り 当 て ます。 こ の 時 点 で、 優 先 順 位 も 限 定 性 も 等 し
い 2 つの 領 域 が 存 在 し ます。 リ ンカは、 空 き スペースに 最 も 余 裕 のあ る 領 域 (この
例 では ER_2) に sec2 を 割 り 当 てます。 今 度 は、 2 つの 領 域 の 空 き スペースが 等 し く な
り ま し た。 こ の と き、 リ ンカは、 スキ ャ ッ タ フ ァ イル 内 で 先 に 出 現 する 領 域 (ER_1)
に sec3 を 割 り 当 てます。
注
worst_fit の 動 作 は、 現 バージ ョ ンの リ ン カのデフ ォル ト の 動 作 であ り 、 以 前 のバー
ジ ョ ンの リ ン カで 唯 一 利 用 で き る アルゴ リ ズムです。
8.14.3 関 連 項 目
概 念
• .ANY モジュールセレ ク タによ る 未 割 り 当 てセクシ ョ ンの 配 置 (8-25 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-30
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• 領 域 の 割 り 当 て、 セレ ク タ、 および 優 先 度 の 動 作 を 示 す next_fit アルゴ リ ズ
ムの 例 (8-32 ページ) .
参 照
『リンカリファレンス』:
• --any_placement=algorithm (2-9 ページ)
• --scatter=file (2-144 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-31
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.15 領 域 の 割 り 当 て、 セレ ク タ、 および 優 先 度 の 動 作 を 示 す next_fit アルゴ リズムの 例
ここでは、sections.o の RO-CODE セクションを 例 に、next_fit の 配 置 アルゴ リ ズムを 説
明 します。
入 力 セ ク シ ョ ンのプロパテ ィ と 順 序 を 以 下 の 表 に 示 し ます。
表 8-2 入 力 セ ク シ ョ ンのプロパテ ィ
名 前
sec1
sec2
sec3
sec4
sec5
sec6
サイ
ズ
0x4
0x4
0x4
0x4
0x4
0x4
こ の 例 で 使 用 する ス キ ャ ッ タ フ ァ イルは 次 の と お り です。
LR 0x100
{
ER_1 0x100 0x20
{
.ANY1(+RO-CODE)
}
ER_2 0x200 0x20
{
.ANY2(+RO)
}
ER_3 0x300 0x20
{
.ANY3(+RO)
}
}
注
この 例 では、--any_contingency を 無 効 にしています。
next_fit が 他 のアルゴ リ ズム と 異 な る のは、 一 杯 であ る と 見 な さ れた 領 域 が 再 度 考 慮
されない と い う 点 です。 こ の 例 からは、 セレ ク タの 優 先 順 位 と 限 定 性 の 相 互 作 用 も
確 認 で き ます。 こ の 点 はすべてのアルゴ リ ズムに 共 通 です。
Execution Region ER_1 (Base:0x00000100, Size:0x00000014, Max:0x00000020, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
0x00000100 0x00000014 Code RO 1 sec1 sections.o
Execution Region ER_2 (Base:0x00000200, Size:0x0000001c, Max:0x00000020, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-32
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
0x00000200 0x00000010 Code RO 3 sec3 sections.o
0x00000210 0x00000004 Code RO 4 sec4 sections.o
0x00000214 0x00000004 Code RO 5 sec5 sections.o
0x00000218 0x00000004 Code RO 6 sec6 sections.o
Execution Region ER_3 (Base:0x00000300, Size:0x00000014, Max:0x00000020, ABSOLUTE)
Base Addr Size Type Attr Idx E Section Name Object
0x00000300 0x00000014 Code RO 2 sec2 sections.o
こ の 例 では、 以 下 の よ う にな り ます。
• ER_1 には、 最 も 限 定 的 なセレ ク タ が 存 在 する ため、 リ ン カは、 sec1 を ER_1 に 配
置 します。 これで、 ER_1 に 残 っている スペースは 0x6 バイ トです。
• 次 に、 リ ンカは、 最 も 限 定 的 なセレ ク タ を 持 ってい る ER_1 に sec2 を 配 置 し よ う
と 試 みますが、 そこには 十 分 なスペースが 存 在 しません。 したがって、ER_1 は
一 杯 であ る と マーク され、 その 後 の 配 置 手 順 では 考 慮 されません。 sec2 の 配 置
先 として、 リンカは、ER_2 よ り も 優 先 順 位 の 高 い ER_3 を 選 択 します。
• 次 に、 リ ンカは、 sec3 を ER_3 に 配 置 し よ う と 試 みます。 十 分 な スペースがない
ので、 ER_3 は 一 杯 であ る と し てマーク されます。 リ ンカは、 sec3 を ER_2 に 配 置
します。
• 次 の 処 理 対 象 は、 sec4 です。 これは 0x4 バイ トのセクシ ョ ンなので、ER_1 と ER_3
のどちらにでも 収 まります。 しかし、 どちらも 既 に 一 杯 としてマークされてい
る ため、 こ れら は 考 慮 か ら 外 さ れます。 リ ンカは、 残 ってい るすべてのセ ク
ションを ER_2 に 配 置 し ます。
• さらにもう 1 つ、 0x8 というサイズのセクション sec7 が 存 在 し、 sec6 の 後 に 処 理
さ れた 場 合 、 リ ン ク は 失 敗 し ます。 既 に ER_1 と ER_3 は 一 杯 と し てマーク されて
い る ので、 こ のアルゴ リ ズムでは、 こ れら の 領 域 にセ ク シ ョ ンの 配 置 が 試 みら
れるこ とはあ り ません。
8.15.1 関 連 項 目
概 念
• .ANY モジュールセレ ク タによ る 未 割 り 当 てセクシ ョ ンの 配 置 (8-25 ページ)
• .ANY セ ク シ ョ ンの 配 置 アルゴ リ ズムの 使 用 例 (8-29 ページ) .
『リンカリファレンス』:
• ス キ ャ ッ タ フ ァ イルの 処 理 時 の 複 数 のマ ッ チングを リ ンカが 解 決 する 方 法
(4-28 ページ)
• リンカによって 生 成 されたコンテンツによって .ANY セクションがオーバーフ
ローしたと きの 動 作 (4-31 ページ) .
参 照
『リンカリファレンス』:
• --any_placement=algorithm (2-9 ページ)
• --scatter=file (2-144 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-33
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.16 .ANY セ ク シ ョ ンのソー ト アルゴ リ ズムの 使 用 例
ここでは、sections_a.o および sections_b.o の RO-CODE セクションを 例 に、 ソートアル
ゴリズムの 動 作 を 説 明 します。
入 力 セ ク シ ョ ンのプロパテ ィ と 順 序 を 以 下 の 表 に 示 し ます。
表 8-3 入 力 セ ク シ ョ ンのプ ロパテ ィ (sections_a.o)
名 前
seca_1
seca_2
seca_3
seca_4
サイ
ズ
0x4
0x4
0x10
0x14
表 8-4 入 力 セ ク シ ョ ンのプ ロパテ ィ (sections_b.o)
名 前
secb_1
secb_2
secb_3
secb_4
サイ
ズ
0x4
0x4
0x10
0x14
8.16.1 サイズの 降 順 の 例
この 例 では、 次 の リ ンカ コマン ド ラ イ ンオプシ ョ ンが 使 用 されています。
--any_sort_order=descending_size sections_a.o sections_b.o --scatter scatter.txt
.ANY の 割 り 当 てアルゴリズムによって、 セクションが 次 の 順 序 で 処 理 されます。
表 8-5 descending_size アルゴ リズムのソー ト 順 序
名 前
seca_4
secb_4
seca_3
secb_3
seca_1
seca_2
secb_1
secb_2
サイ
ズ
0x14
0x14
0x10
0x10
0x4
0x4
0x4
0x4
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-34
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
同 じサイズのセクシ ョ ンには、 --tiebreaker で 指 定 さ れた 序 列 決 定 基 準 が 使 用 さ れま
す。
8.16.2 コマンドラインの 例
この 例 では、 次 の リ ンカ コマン ド ラ イ ンオプシ ョ ンが 使 用 されています。
--any_sort_order=cmdline sections_a.o sections_b.o --scatter scatter.txt
.ANY の 割 り 当 てアルゴリズムによって、 セクションが 次 の 順 序 で 処 理 されます。
表 8-6 cmdline アルゴ リズムのソー ト 順 序
名 前
seca_1
secb_1
seca_2
secb_2
seca_3
secb_3
seca_4
secb_4
サイ
ズ
0x4
0x4
0x4
0x4
0x10
0x10
0x14
0x14
同 じコマンド ラインインデッ クスのセクシ ョ ンには、--tiebreaker で 指 定 された 序 列
決 定 基 準 が 使 用 さ れます。
8.16.3 関 連 項 目
概 念
• .ANY モジュールセレ ク タによ る 未 割 り 当 てセクシ ョ ンの 配 置 (8-25 ページ) .
参 照
『リンカリファレンス』:
• --any_sort_order=order (2-11 ページ)
• --scatter=file (2-144 ページ)
• --tiebreaker=option (2-175 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-35
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.17 スキャ ッ タ ロー ド の 記 述 におけるベニア 入 力 セ ク シ ョ ンの 選 択
ベニアは、 ARM コード と Thumb コードの 切 り 替 えや、 1 つの 命 令 で 指 定 でき る ジ ャ
ンプ よ り も 長 いジ ャ ンプを 実 行 する 場 合 に 使 用 し ます。 ス キ ャ ッ タ フ ァ イルに リ ン
カで 生 成 されたシンボル Veneer$$Code を 含 め る こ と で、 ベニア を 指 定 し た 位 置 に 配 置
できます。 スキャッタファイル 内 で *(Veneer$$Code) セクションセレクタを 使 用 でき
る 実 行 領 域 は 1 つだけです。
リンカにより、*(Veneer$$Code) セクションセレクタによって 識 別 される 領 域 にベニア
入 力 セ ク シ ョ ン を 配 置 する のが 安 全 だ と 判 断 さ れた 場 合 、 その 配 置 が 実 行 さ れます。
ただ し、 ア ド レ ス 範 囲 の 問 題 や、 実 行 領 域 のサ イ ズ 制 限 などに よ り 、 ベニア 入 力 セ
ク シ ョ ンがその 領 域 に 割 り 当 て ら れない 場 合 も あ り ます。 指 定 し た 領 にベニア を 追
加 で き ない 場 合 は、 ベニア を 生 成 し た、 再 配 置 さ れた 入 力 セ ク シ ョ ン を 含 んでい る
実 行 領 域 にそのベニアが 追 加 さ れます。
注
旧 バージ ョ ンの ARM ツールで 作 成 さ れた ス キ ャ ッ タ フ ァ イル 内 に 登 場 する
*(IWV$$Code) のインスタンスは、*(Veneer$$Code) に 自 動 的 に 変 換 されます。 新 しい 記
述 フ ァ イルでは *(Veneer$$Code) を 使 用 して 下 さい。
実 行 領 域 内 のコード の 量 が、 Thumb コードの 場 合 は 4Mb、 32 ビッ ト Thumb コードの
場 合 は 16Mb、 ARM コー ド の 場 合 は 32Mb を 超 える と、 *(Veneer$$Code) は 無 視 されま
す。
8.17.1 関 連 項 目
概 念
• ベニアの 概 要 (4-27 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-36
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.18 __attribute__((section("name"))) を 使 用 し た コー ド と デー タの 配 置
コー ド およびデータは、 ツールチェーン 固 有 のプ ラ グマや 属 性 を 使 用 し な く て も 、
独 自 のオブジ ェ ク ト に 別 々に 配 置 で き ます。 ただ し、 __attribute__((section("name")))
を 使 用 して、 項 目 を 別 の ELF セ ク シ ョ ンに 配 置 する こ と も で き ます。 その 場 合 、 ス
キ ャ ッ タ フ ァ イルを 使 用 し て、 名 前 付 き セ ク シ ョ ン を 特 定 の 位 に 配 置 で き ます。
__attribute__((section("name"))) を 使 用 し て、 変 数 を 別 のセ ク シ ョ ンに 配 置 するには、
以 下 の 手 順 を 実 行 します。
1. __attribute__((section("name"))) を 使 用 し て、 変 数 の 配 置 先 の 名 前 付 き セ ク シ ョ
ン を 指 定 し ます。 以 下 に 例 を 示 し ます。
例 8-8 セ ク シ ョ ンの 命 名
int variable __attribute__((section("foo"))) = 10;
2. ス キ ャ ッ タ フ ァ イルを 使 用 し て、 名 前 付 き セ ク シ ョ ン を 配 置 し ます。 以 下 に 例
を 示 し ます。
例 8-9 セ ク シ ョ ンの 配 置
FLASH 0x24000000 0x4000000
{
... ; 残 りのコード
}
ADDER 0x08000000
{
file.o (foo)
}
; file.o からセクショ ン foo を 選 択 する
以 下 の 点 に 注 意 し て 下 さい。
• --autoat または --no_autoat によ る リ ン クは 配 置 に 影 響 し ません。
• ス キ ャ ッ タ ロー ド が 使 用 さ れなかった 場 合 、 セ ク シ ョ ンは、 LR_1 ロード 領 域 の
デフォル ト の ER_RW 実 行 領 域 に 配 置 さ れます。
• スキャッタファイルはあるが、foo セレクタは 含 まれないという 場 合 、 セクシ ョ
ンは、 定 義 されている RW 実 行 領 域 に 配 置 さ れます。
セクション 名 に .ARM.__at_address を 使 用 する こ と で、 特 定 のア ド レ スに 関 数 を 配 置 す
ることもできます。 例 えば、 関 数 sqr を 0x20000 に 配 置 する には、 次 の よ う に 指 定 し
ます。
int sqr(int n1) __attribute__((section(".ARM.__at_0x20000")));
int sqr(int n1)
{
return n1*n1;
}
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-37
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.18.1 関 連 項 目
参 照
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ)
• __at セ ク シ ョ ンの 配 置 に 関 する 制 限 (8-41 ページ) .
『コンパイ ラ リ ファレンス』 :
• __attribute__((section("name"))) 関 数 属 性 (5-54 ページ)
• __attribute__((section("name"))) 変 数 属 性 (5-73 ページ)
• #pragma arm section [section_type_list] (5-84 ページ) .
『リンカリファレンス』:
• --autoat、 --no_autoat (2-17 ページ)
• --scatter=file (2-144 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-38
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.19 __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レスにセ ク シ ョ ン を 配 置 する
セ ク シ ョ ン を 配 置 する 必 要 があ る ア ド レ ス をエン コー ド し た 特 別 な 名 前 をセ ク シ ョ
ンに 付 け る こ と がで き ます。 名 前 は 以 下 の よ う に 指 定 で き ます
.ARM.__at_address
各 パラ メ ータには 以 下 の 意 味 があ り ます。
address
セクションの 必 要 なアドレス。 16 進 数 値 ま たは 10 進 数 値 で 指 定 する こ
とができます。.ARM.__at_address の 形 式 のセ ク シ ョ ンは、 省 略 形 __at で
表 します。
コ ンパ イ ラ で 変 数 を __at セ ク シ ョ ンに 割 り 当 て るには、 以 下 の 方 法 を 使 用 し ます。
• __attribute__((section(”name”))) を 使 用 し てセ ク シ ョ ンに 明 示 的 に 名 前 を 付 け ま
す。
• 属 性 __at を 使 用 してセクシ ョ ン 名 を 自 動 的 に 設 定 します。
例 8-10 C または C++ コードでの __at セ ク シ ョ ンへの 変 数 の 割 り 当 て
// variable1 を .ARM.__at_0x00008000 という 名 前 のセクションに 配 置 する
int variable1 __attribute__((at(0x8000))) = 10;
// variable2 を .ARM.__at_0x8000 という 名 前 のセクションに 配 置 する
int variable2 __attribute__((section(".ARM.__at_0x8000"))) = 10;
注
__attribute__((at(address))) を 使 用 する 場 合 、 address を 表 す __at セクション 名 の 部 分
は、 8 桁 の 16 進 数 値 に 正 規 化 さ れます。 セ ク シ ョ ン 名 は、 ス キ ャ ッ タ フ ァ イ ル 内 で
名 前 を 使 用 し てセ ク シ ョ ン を 照 合 する 場 合 にのみ 有 意 です。 --autoat コマンド ライン
オプシ ョ ン を 使 用 する と 、 リ ン カに よ っ て __at セクションが 自 動 的 に 割 り 当 てられ
ます。 このオプシ ョ ンはデフォル ト です。
8.19.1 関 連 項 目
概 念
• 特 定 ア ド レ スへの 関 数 と データ の 配 置 (8-18 ページ)
• __attribute__((section("name"))) を 使 用 したコード とデータの 配 置 (8-37 ページ)
• __at セ ク シ ョ ンの 配 置 に 関 する 制 限 (8-41 ページ)
• __at セ ク シ ョ ンの 自 動 配 置 (8-42 ページ)
• __at セ ク シ ョ ンの 手 動 配 置 (8-44 ページ)
• __at を 使 用 したフラ ッシュ メモ リ でのキーの 配 置 (8-46 ページ)
• __at を 使 用 し たペ リ フ ェ ラ ルレ ジ ス タ に 対 する 構 造 の 配 置 (8-48 ページ) .
参 照
『リンカリファレンス』:
• --autoat、 --no_autoat (2-17 ページ) .
『コンパイ ラ リ ファレンス』 :
• __attribute__((section("name"))) 関 数 属 性 (5-54 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-39
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• __attribute__((at(address))) 変 数 属 性 (5-68 ページ)
• __attribute__((section("name"))) 変 数 属 性 (5-73 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-40
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.20 __at セ ク シ ョ ンの 配 置 に 関 する 制 限
以 下 の 制 限 は、 __at セ ク シ ョ ン を 特 定 のア ド レ スに 配 置 する 場 合 に 適 用 さ れます。
• __at セ ク シ ョ ンのア ド レ ス 範 囲 は、 重 複 する セ ク シ ョ ンが 別 々のオーバーレ イ
領 域 に 配 置 さ れていない 限 り 、 重 複 し てはな り ません。
• __at セ ク シ ョ ンは、 位 置 非 依 存 の 実 行 領 域 では 使 用 で き ません。
• __at セクションのリンカ 定 義 シンボル $$Base、 $$Limit、 および $$Length は、 参 照
しないで 下 さい。
• __at セクションは、 System V (SysV) とベースプ ラ ッ ト フ ォームアプ リ ケー
ションバイナリインタフェース (BPABI) の 実 行 可 能 フ ァ イルおよび BPABI の
ダイナミ ック リンクライブラ リ (DLL) では 使 用 しないで 下 さい。
• __at セ ク シ ョ ンのア ド レ スは、 境 界 整 列 値 の 倍 数 にする 必 要 があ り ます。
• __at セクションでは、+FIRST または +LAST 順 序 付 け 制 約 のいずれも 無 視 さ れま
す。
8.20.1 関 連 項 目
概 念
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ) .
その 他 の 情 報
• 『Base Platform ABI for the ARM Architecture』 ,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0037-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-41
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.21 __at セ ク シ ョ ンの 自 動 配 置
__at セ ク シ ョ ンの 自 動 配 置 はデフ ォル ト で 有 効 になっています。 こ の 機 能 を 制 御 す
るには、 リ ンカコマンド ラインオプシ ョ ン --autoat を 使 用 し ます。
注
__at セ ク シ ョ ンは、 位 置 非 依 存 の 実 行 領 域 では 使 用 で き ません。
--autoat オプシ ョ ンを 使 用 して リ ン クする と き、 __at セクションはスキャッタロード
セレクタによって 配 置 されません。 代 わりに、 リ ンカによって __at セクションは 互
換 領 域 に 配 置 さ れます。 互 換 領 域 が 見 つか ら ない 場 合 は、 __at セクションのロード 領
域 と 実 行 領 域 が 作 成 さ れます。
リンカの --autoat オプシ ョ ンに よ って 作 成 さ れた 実 行 領 域 はすべて UNINIT スキャッタ
ロード 属 性 を 持 ちます。 ZI __at セ ク シ ョ ン をゼ ロ で 初 期 化 する 必 要 があ る 場 合 、 こ
のセ ク シ ョ ンは 互 換 領 域 内 に 配 置 する 必 要 があ り ます。 リ ンカの --autoat オプシ ョ ン
に よ って 作 成 さ れた 実 行 領 域 のベース ア ド レ スは 少 な く と も 4 バイ ト 境 界 で 整 列 さ
れてい る 必 要 があ り ます。 領 域 が 正 し く 整 列 さ れていない 場 合 は、 リ ンカのエ ラー
メ ッ セージが 生 成 さ れます。
互 換 領 域 と は、 以 下 の よ う な 領 域 です。
• __at のア ド レ スが 実 行 可 能 領 域 のベースおよび リ ミ ッ ト の 範 囲 内 にあ る。 こ こ
で、 リ ミ ッ ト はベース ア ド レ スに 実 行 領 域 の 最 大 サ イ ズを 加 えた 値 です。 最 大
サイズが 設 定 されていない 場 合 、 __at セ ク シ ョ ンの 配 置 リ ミ ッ ト は __at セク
シ ョ ン を 含 ま ない 実 行 領 域 の 現 在 のサ イ ズに 定 数 10240 バイ ト を 加 えた 値 に 設
定 されます。
• 実 行 領 域 は、 以 下 の 条 件 を 少 な く と も 1 つ 満 た し ます。
— 標 準 的 な ス キ ャ ッ タ ロー ド 規 則 に よ っ て __at セクションを 一 致 させるセ
レクタがある。
— __at セクションと 同 じ 種 類 (RO、 RW、 または ZI) のセクシ ョ ンが 少 なく
とも 1 つある。
— EMPTY 属 性 がない。
注
リ ン カでは、 種 類 が RW の __at セクションは、 RO と 互 換 性 があ る と 見 な
されます。
以 下 の 例 には、 種 類 が RO のセクシ ョ ン .ARM.__at_0x0、 種 類 が RW のセクシ ョ ン
.ARM.__at_0x2000、 種 類 が ZI のセクシ ョ ン .ARM.__at_0x4000、 および 種 類 が ZI のセク
ション .ARM.__at_0x8000 を 示 しています。
例 8-11 C または C++ コー ド での 変 数 の 配 置
// RW 変 数 を .ARM.__at_0x2000 という 名 前 のセクションに 配 置 する
int foo __attribute__((section(".ARM.__at_0x2000"))) = 100;
// ZI 変 数 を .ARM.__at_0x4000 という 名 前 のセクションに 配 置 する
int bar __attribute__((section(".ARM.__at_0x4000"), zero_init));
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-42
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
// ZI 変 数 を .ARM.__at_0x8000 という 名 前 のセクションに 配 置 する
int variable __attribute__((section(".ARM.__at_0x8000"), zero_init));
例 8-12 __at セ ク シ ョ ンの 自 動 配 置
LR1 0x0
{
ER_RO 0x0 0x2000
{
*(+RO) ; .ARM.__at_0x0 は ER_RO の 範 囲 内 に あ る
}
ER_RW 0x2000 0x2000
{
*(+RW) ; .ARM.__at_0x2000 は ER_RW の 範 囲 内 に あ る
}
ER_ZI 0x4000 0x2000
{
*(+ZI) ; .ARM.__at_0x4000 は ER_ZI の 範 囲 内 に あ る
}
}
; __at セクショ ン .ARM.__at_0x8000 は 対 象 と な る す べ て の 領 域 の 範 囲 外 に あ る た め
; そ の ロ ー ド 領 域 と 実 行 領 域 が リ ン カ に よ っ て 作 成 さ れ る。
8.21.1 関 連 項 目
概 念
• __attribute__((section("name"))) を 使 用 したコード とデータの 配 置 (8-37 ページ)
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ)
• __at セ ク シ ョ ンの 配 置 に 関 する 制 限 (8-41 ページ)
• __at セ ク シ ョ ンの 手 動 配 置 (8-44 ページ)
• __at を 使 用 したフラ ッシュ メモ リ でのキーの 配 置 (8-46 ページ)
• __at を 使 用 し たペ リ フ ェ ラ ルレ ジ ス タ に 対 する 構 造 の 配 置 (8-48 ページ) .
『リンカリファレンス』:
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
『リ ンカ リ フ ァレンス』:
• --autoat、 --no_autoat (2-17 ページ)
• --ro_base=address (2-137 ページ)
• --rw_base=address (2-141 ページ)
• --zi_base=address (2-197 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-43
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.22 __at セ ク シ ョ ンの 手 動 配 置
--no_autoat コ マン ド ラ イ ンオプシ ョ ン を 使 用 する 場 合 は、 標 準 的 なセ ク シ ョ ン 配 置
規 則 を 使 用 して、 __at セクションを 配 置 できます。
注
__at セ ク シ ョ ンは、 位 置 非 依 存 の 実 行 領 域 では 使 用 で き ません。
以 下 の 例 には、 読 み 出 し 専 用 セ ク シ ョ ン .ARM.__at_0x2000 と 読 み 出 し - 書 き 込 みセク
ション .ARM.__at_0x4000 の 配 置 を 示 しています。 手 動 モードでは、 ロード 領 域 と 実 行
領 域 は 自 動 的 に 作 成 さ れません。 __at セ ク シ ョ ン を 実 行 領 域 に 配 置 で き ない 場 合 、 エ
ラーが 生 成 されます。
例 8-13 C または C++ コー ド での 変 数 の 配 置
// RO 変 数 を .ARM.__at_0x2000 という 名 前 のセクションに 配 置 する
const int FOO __attribute__((section(".ARM.__at_0x2000"))) = 100;
// RW 変 数 を .ARM.__at_0x4000 という 名 前 のセクションに 配 置 する
int bar __attribute__((section(".ARM.__at_0x4000")));
例 8-14 __at セ ク シ ョ ンの 手 動 配 置
LR1 0x0
{
ER_RO 0x0 0x2000
{
*(+RO)
}
ER_RO2 0x2000
{
*(.ARM.__at_0x2000)
}
ER2 0x4000
{
*(+RW +ZI)
}
}
; +RO によって .ARM.__at_0x0 が 選 択 される
; .ARM.__at_0x2000 によって .ARM.__at_0x2000 が 選 択 さ れる
; +RW によって .ARM.__at_0x4000 が 選 択 される
8.22.1 関 連 項 目
概 念
• __attribute__((section("name"))) を 使 用 したコード とデータの 配 置 (8-37 ページ)
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ)
• __at セ ク シ ョ ンの 配 置 に 関 する 制 限 (8-41 ページ)
• __at セ ク シ ョ ンの 自 動 配 置 (8-42 ページ)
• __at を 使 用 したフラ ッシュ メモ リ でのキーの 配 置 (8-46 ページ)
• __at を 使 用 し たペ リ フ ェ ラ ルレ ジ ス タ に 対 する 構 造 の 配 置 (8-48 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-44
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
『リンカリファレンス』:
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
『リ ンカ リ フ ァレンス』:
• --autoat、 --no_autoat (2-17 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-45
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.23 __at を 使 用 し た フ ラ ッ シ ュ メ モ リ でのキーの 配 置
一 部 のフ ラ ッ シ ュ メ モ リ デバ イ ス では、 特 定 の 機 能 を ア ク テ ィ ブにする ためにキー
をア ド レ スに 書 き 込 む 必 要 があ り ます。 __at セクションを 使 用 すると、 値 を 特 定 のア
ドレスに 簡 単 に 書 き 込 むことができます。
デバイ スに 0x8000 ~ 0x10000 のフラ ッシュ メモ リが 搭 載 されており、 アド レス 0x8000
でキーが 必 要 であ る と 仮 定 し ます。 __at セクションを 使 用 してキーをアドレスに 書 き
込 むには、 変 数 を 宣 言 し、 コ ンパ イ ラ が .ARM.__at_0x8000 というセクションを 生 成 で
きるようにする 必 要 があります。
例 8-15 C または C++ コー ド でのフ ラ ッ シ ュキー 変 数 の 配 置
// flash_key を .ARM.__at_0x8000 という 名 前 のセクションに 配 置 する
long flash_key __attribute__((section(".ARM.__at_0x8000")));
以 下 の 例 では、 フ ラ ッ シ ュ メ モ リ の 実 行 領 域 の 手 動 配 置 を 記 述 し た ス キ ャ ッ タ フ ァ
イルを 示 しています。
例 8-16 フ ラ ッ シ ュ メ モ リ の 実 行 領 域 の 手 動 配 置
ER_FLASH 0x8000 0x2000
{
*(+RO)
*(.ARM.__at_0x8000) ; キー
}
リンカのコマンドラインオプション --no_autoat を 使 用 して、 手 動 配 置 を 有 効 にし ま
す。
以 下 の 例 では、 フ ラ ッ シ ュ メ モ リ の 実 行 領 域 の 自 動 配 置 を 記 述 し た ス キ ャ ッ タ フ ァ
イルを 示 しています。 リ ンカのコマンド ラインオプシ ョ ン --autoat を 使 用 して、 自 動
配 置 を 有 効 にし ます。
例 8-17 フ ラ ッ シ ュ メ モ リ の 実 行 領 域 の 自 動 配 置
ER_FLASH 0x8000 0x2000
{
*(+RO)
}
; 他 の コ ー ド と 読 み 出 し 専 用 デー タ
; __at セクショ ンが 自 動 的 に 選 択 される
8.23.1 関 連 項 目
タスク
• FIRST 属 性 と LAST 属 性 を 使 用 したセクシ ョ ンの 配 置 (4-22 ページ)
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-46
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
概 念
• __at セ ク シ ョ ンの 自 動 配 置 (8-42 ページ)
• __at セ ク シ ョ ンの 手 動 配 置 (8-44 ページ) .
『リンカリファレンス』:
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
『リンカリファレンス』:
• --autoat、 --no_autoat (2-17 ページ) .
『コンパイ ラ リ ファレンス』 :
• __attribute__((section("name"))) 変 数 属 性 (5-73 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-47
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.24 __at を 使 用 し たペ リ フ ェ ラルレジス タ に 対 する 構 造 の 配 置
初 期 化 されていない 変 数 をペリ フェ ラルレジス タに 配 置 するには、 ZI __at セクショ
ン を 使 用 し ます。 レ ジ ス タ が 0x10000000 で 使 用 でき る と 仮 定 し て、
.ARM.__at_0x10000000 という ZI __at セ ク シ ョ ン を 定 義 し ます。 以 下 に 例 を 示 し ます。
int foo __attribute__((section( ・ ARM.__at_0x10000000 ・ , zero_init));
以 下 の 例 には、 ZI __at セ ク シ ョ ンの 手 動 配 置 を 記 述 し た ス キ ャ ッ タ フ ァ イルを 示 し
ています。
例 8-18 ZI __at セ ク シ ョ ンの 手 動 配 置
ER_PERIPHERAL 0x10000000 UNINIT
{
*(.ARM.__at_0x10000000)
}
自 動 配 置 を 使 用 する 場 合 、 0x10000000 付 近 の 実 行 領 域 が 他 にない と い う 想 定 で、 リ ン
カによって UNINIT 属 性 の 領 域 が 0x10000000 に 自 動 的 に 作 成 されます。 UNINIT 属 性 に
よ って、 初 期 化 さ れていないデータ ま たは メ モ リ マ ッ プ さ れた I/O を 含 む 実 行 領 域 が
作 成 さ れます。
8.24.1 関 連 項 目
概 念
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ) .
『リンカリファレンス』:
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
『リンカリファレンス』:
• 実 行 領 域 の 属 性 (4-13 ページ) .
『コンパイ ラ リ ファレンス』 :
• __attribute__((section("name"))) 変 数 属 性 (5-73 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-48
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.25 オーバーレ イ を 使 用 し たセ ク シ ョ ンの 配 置
スキャッタファイル 内 で OVERLAY 属 性 を 使 用 する と 、 複 数 の 実 行 領 域 を 同 じ ア ド レ ス
に 配 置 で き ます。 実 行 領 域 を 一 度 に 1 つだけ イ ン ス タ ン ス 化 するには、 オーバーレ
イマネージャが 必 要 です。 ARM コンパイラツールチェーンにはオーバーレイマネー
ジャは 付 属 していません。
以 下 の 例 では、 RAM 内 のス タ テ ィ ッ ク セ ク シ ョ ン と、 その 後 に 続 く 一 連 のオーバー
レ イ の 定 義 を 示 し ています。 こ の 例 では、 一 度 に こ れら のセ ク シ ョ ンの 1 つのみを
インスタンス 化 しています。
例 8-19 ルー ト 領 域 の 指 定
EMB_APP 0x8000
{
.
.
STATIC_RAM 0x0
; RW と ZI のコード / データのほとんどを 含 む
{
* (+RW,+ZI)
}
OVERLAY_A_RAM 0x1000 OVERLAY ; オーバーレイの 開 始 アドレス ...
{
module1.o (+RW,+ZI)
}
OVERLAY_B_RAM 0x1000 OVERLAY
{
module2.o (+RW,+ZI)
}
... ; 残 りのスキャ ッ タロード 記 述 ...
}
OVERLAY と し てマー ク さ れてい る 領 域 は、 起 動 時 に C ライブラリによって 初 期 化 され
ません。 オーバーレ イ 領 域 が 使 用 する メ モ リ の 内 容 は、 オーバーレ イ マネージ ャ が
管 理 し ます。 ま た、 領 域 に 初 期 化 さ れたデータ が 含 まれてい る 場 合 は、 NOCOMPRESS 属
性 を 使 用 して RW データ が 圧 縮 さ れない よ う に し ます。
リ ンカ 定 義 シンボルを 使 用 する と、 コード とデータのコ ピーに 必 要 なア ド レスを 取
得 でき ます。
OVERLAY 属 性 は、 別 の 領 域 と は 異 な る ア ド レ ス を 持 つ 単 一 の 領 域 で 使 用 で き ます。 し
たがって、 C ラ イ ブ ラ リ ス ター ト ア ッ プ コー ド に よ る 特 定 の 領 域 の 初 化 を 避 け る 方
法 と して、 オーバーレイ 領 域 を 使 用 できます。 他 のオーバーレイ 領 域 と 同 様 に、 こ
れら の 領 域 はコー ド 内 で 手 動 で 初 期 化 する 必 要 あ り ます。
オーバーレ イ 領 域 は 相 対 ベース を 持 つこ と がで き ます。 +offset ベース ア ド レ ス を 持
つオーバーレ イ 領 域 の 動 作 は、 その 前 の 領 域 と +offset の 値 に 依 存 し ます。 連 続 する
+offset 領 域 の +offset の 値 が 同 じ 場 合 、 それら の 領 域 は リ ンカに よ って 同 じベース ア
ドレスに 配 置 されます。
+offset の 実 行 領 域 ER が、 オーバーレ イ 実 行 領 域 の 連 続 する 重 複 ブ ロ ッ ク に 続 けて
存 在 する 場 合 、 ER のベースア ド レ スは 次 のよ う にな り ます。
オ ー バ ー レ イ 実 行 領 域 の 重 複 ブ ロ ッ ク の リ ミ ッ ト ア ド レ ス + offset
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-49
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
以 下 の 表 には、 +offset を OVERLAY 属 性 と 共 に 使 用 し た 場 合 の 影 響 を 示 し ています。
REGION1 は、 スキ ャ ッ タ フ ァ イル 内 の REGION2 の 直 前 に 配 置 されます。
表 8-7 オーバーレ イ での 相 対 オ フ セ ッ ト の 使 用
REGION1 を
OVERLAY と 共 に 設
定 する
+offset
REGION2 ベースア ド レス
いいえ REGION1 の リミット +
はい +0 REGION1 ベースアドレス
はい REGION1 の リミット +
以 下 の 例 では、 相 対 オフセ ッ ト をオーバーレ イ と 共 に 使 用 し た 場 合 の 実 行 領 域 のア
ドレスに 対 する 影 響 を 示 しています。
例 8-20 オーバーレ イ での 相 対 オ フ セ ッ ト の 例
EMB_APP 0x8000{
CODE 0x8000
{
*(+RO)
}
# REGION1 Base = CODE limit
REGION1 +0 OVERLAY
{
module1.o(*)
}
# REGION2 Base = REGION1 Base
REGION2 +0 OVERLAY
{
module2.o(*)
}
# REGION3 Base = REGION2 Base = REGION1 Base
REGION3 +0 OVERLAY
{
module3.o(*)
}
}
# REGION4 Base = REGION3 Limit + 4
Region4 +4 OVERLAY
{
module4.o(*)
}
オーバーレ イ でない 領 域 の 長 さ が 不 明 な 場 合 は、 ゼ ロ 相 対 オフセ ッ ト を 使 用 し て
オーバーレ イの 開 始 ア ド レ ス を 指 定 する こ と で、 オーバーレ イ を タ テ ィ ッ ク セ ク
ションの 直 後 に 配 置 できます。
以 下 の コ マン ド ラ イ ンオプシ ョ ン を 使 用 する と 、 イ メ ージに さ ら にデバ ッ グ 情 報 を
追 加 で き ます。
• --emit_debug_overlay_relocs
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-50
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• --emit_debug_overlay_section
こ れら を 使 用 する こ と で、 現 在 有 効 なオーバーレ イ をオーバーレ イ に 対 応 し たデ
バッガで 追 跡 できるよ うになり ます。
8.25.1 関 連 項 目
概 念
• __at セ ク シ ョ ン を 使 用 し て 特 定 のア ド レ スにセ ク シ ョ ン を 配 置 する (8-39 ペー
ジ) .
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ)
• 実 行 領 域 の 記 述 について (4-10 ページ)
• ロード 領 域 に 相 対 アドレス +offset を 使 用 する 際 の 注 意 事 項 (4-18 ページ)
• 実 行 領 域 に 相 対 ア ド レ ス +offset を 使 用 する 際 の 注 意 事 項 (4-19 ページ) .
参 照
• リンカ 定 義 シンボルへのアクセス (7-4 ページ) .
『リンカリファレンス』:
• --emit_debug_overlay_relocs (2-54 ページ)
• --emit_debug_overlay_section (2-55 ページ)
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ) .
『コンパイ ラ リ ファレンス』 :
• __attribute__((section("name"))) 変 数 属 性 (5-73 ページ) .
その 他 の 情 報
• ABI for the ARM Architecture:Support for Debugging Overlaid Programs,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0049-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-51
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.26 ARM C および C++ ラ イ ブ ラ リ コー ド の 配 置 について
ARM の C および C++ の 標 準 ラ イブラ リ のコード を スキ ャ ッ タ フ ァ イルに 配 置 でき ま
す。 スキャ ッ タフ ァ イルでラ イブラ リ 名 を 解 決 でき る よ う に、*armlib または *cpplib*
を 使 用 して 下 さい。
__main.o、 __scatter*.o、 __dc*.o、 *Region$$Table など、 いくつかの ARM の C および
C++ ラ イ ブ ラ リ セ ク シ ョ ンはルー ト 領 域 に 配 置 する 必 要 があ り ます。 こ れ ら のセ ク
ションはリ リース 間 で 異 なる 能 性 があります。 リンカは InRoot$$Sections を 使 用 する
こ と で、 今 後 も 問 題 が 生 じ ない よ う に こ れら のセ ク シ ョ ンすべてを 自 動 的 に 配 置 で
きます。
8.26.1 関 連 項 目
タスク
• ルー ト 実 行 領 域 の 作 成 (8-14 ページ)
• FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 (8-17 ページ) .
概 念
• ルー ト 領 域 と は (8-13 ページ)
• ルー ト 領 域 へのコー ド の 配 置 例 (8-53 ページ)
• ARM C ラ イ ブ ラ リ コー ド の 配 置 例 (8-54 ページ)
• ARM C++ ラ イ ブ ラ リ コー ド の 配 置 例 (8-55 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-52
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.27 ルー ト 領 域 へのコー ド の 配 置 例
ス キ ャ ッ タ フ ァ イルを 使 用 し て、 名 前 付 き セ ク シ ョ ン と 同 様 にルー ト セ ク シ ョ ン を
指 定 し ます。 以 下 の 例 では、 セ ク シ ョ ンセレ ク タ InRoot$$Sections を 使 用 して、 ルー
ト 領 域 に 配 置 する 必 要 があ るすべてのセ ク シ ョ ン を 配 置 し ています。
例 8-21 ルー ト 領 域 の 指 定
ROM_LOAD 0x0000 0x4000
{
ROM_EXEC 0x0000 0x4000 ; 0x0 にルート 領 域
{
vectors.o (Vect, +FIRST) ; ベクタテーブル
* (InRoot$$Sections) ; ルート 領 域 に 配 置 する 必 要 があるすべての
; ライブラリセクション (__main.o、
; __scatter*.o、 __dc*.o、 * Region$$Table など)
}
RAM 0x10000 0x8000
{
* (+RO, +RW, +ZI) ; 他 のすべてのセ ク シ ョ ン
}
}
8.27.1 関 連 項 目
タスク
• ルー ト 実 行 領 域 の 作 成 (8-14 ページ)
• FIXED 属 性 を 使 用 し たルー ト 領 域 の 作 成 (8-17 ページ) .
概 念
• ルー ト 領 域 と は (8-13 ページ)
• ARM C および C++ ライブラリコードの 配 置 について (8-52 ページ)
• ARM C ラ イ ブ ラ リ コー ド の 配 置 例 (8-54 ページ)
• ARM C++ ラ イ ブ ラ リ コー ド の 配 置 例 (8-55 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-53
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.28 ARM C ラ イ ブ ラ リ コー ド の 配 置 例
以 下 の 例 では、 C ラ イ ブ ラ リ コー ド の 配 置 方 法 を 示 し ています。
例 8-22 ARM C ラ イ ブ ラ リ コー ド の 配 置
ROM1 0
{
* (InRoot$$Sections)
* (+RO)
ROM2 0x1000
{
*armlib/c_* (+RO)
}
}
ROM3 0x2000
{
*armlib/h_* (+RO)
}
RAM1 0x3000
{
*armlib* (+RO)
}
RAM2 0x4000
{
* (+RW, +ZI)
}
; ARM が 提 供 するすべての C ライブラリ 関 数
; ARM が 提 供 する __ARM_* のみ
; 再 配 布 可 能 な ラ イ ブ ラ リ 関 数
; ARM が 提 供 する そ の 他 すべての ラ イ ブ ラ リ コ ー ド
; 浮 動 小 数 点 ラ イ ブ ラ リ な ど
armlib という 名 前 は、install_directory\lib\armlib ディレク ト リにある ARM C ライブ
ラ リ フ ァ イ ルを 示 すために 使 用 さ れています。
8.28.1 関 連 項 目
概 念
• ARM C および C++ ライブラリコードの 配 置 について (8-52 ページ)
• ルー ト 領 域 へのコー ド の 配 置 例 (8-53 ページ)
• ARM C++ ラ イ ブ ラ リ コー ド の 配 置 例 (8-55 ページ) .
参 照
『ARM ® C および C++ ラ イ ブ ラ リ と 浮 動 小 数 点 サポー ト の 使 用 』 :
• C および C++ ラ イ ブ ラ リ の 命 名 規 則 (2-130 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-54
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.29 ARM C++ ラ イ ブ ラ リ コー ド の 配 置 例
以 下 の 例 は、 スキ ャ ッ タ ロード が 行 われる C++ プログラムです。
#include
using namespace std;
extern "C" int foo ()
{
cout

スキャ ッ タ フ ァ イルの 使 用
8.30 ARM ラ イ ブ ラ リ ヘルパ 関 数 の 配 置 例
コンパイ ラによ って、 結 果 と して 生 成 されるオブジェ ク ト フ ァ イルに ARM ヘルパ 関
数 が 生 成 されます。 し たがって、 同 じ 1 つのスキ ャ ッ タ フ ァ イ 内 で armlib と cpplib を
使 用 し て こ れ ら の 関 数 を 配 置 する こ と はで き ません。
こ れら のヘルパ 関 数 を 配 置 する ため、 ス キ ャ ッ タ フ ァ イルに *.* (i.__ARM_*) を 指 定 し
ます。 スキャ ッ タファ イルに * (+RO) があ る 場 合 、 *.* 部 分 が 重 要 です。
* (i.__ARM_*) を 使 用 する と 、 以 下 のエ ラーが 生 成 さ れます。
エラー: L6223E:Ambiguous selectors...
こ れは、 複 数 の 一 致 を 解 決 する ためのス キ ャ ッ タ ロー ド 規 則 が 原 因 で 発 生 し ます。
8.30.1 関 連 項 目
概 念
『ARM コンパイラツールチェーン : リンカリファレンス』
• ス キ ャ ッ タ フ ァ イルの 処 理 時 の 複 数 のマ ッ チングを リ ンカが 解 決 する 方 法
(4-28 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-56
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.31 空 き 領 域 の 予 約
実 行 領 域 のス キ ャ ッ タ ロー ド 記 述 で EMPTY 属 性 を 使 用 し て、 ス タ ッ ク 用 の 空 き メ モ リ
ブロッ クを 予 約 できます。
こ の メ モ リ ブ ロ ッ ク はロー ド 領 域 の 一 部 ではあ り ませんが、 実 行 時 に 使 用 する ため
に 割 り 当 て られます。 この メ モ リ ブロ ッ クはダ ミ ーの ZI 領 域 と し て 作 成 さ れる ため、
リ ンカが こ のブ ロ ッ ク にア ク セスする と きは 以 下 のシンボルが 使 用 さ れます。
• Image$$region_name$$ZI$$Base
• Image$$region_name$$ZI$$Limit
• Image$$region_name$$ZI$$Length.
長 さに 負 の 値 が 指 定 されている 場 合 は、 指 定 されている ア ド レ スが、 その 領 域 の 終
了 ア ド レ ス と し て 使 用 さ れます。 こ のア ド レ スには、 相 対 ア ド ス ではな く 絶 対 ア ド
レスを 指 定 して 下 さい。
以 下 の 例 では、 実 行 領 域 の 定 義 STACK 0x800000 EMPTY –0x10000 によって、 アドレス
0x7F0000 で 始 ま り 、 ア ド レ ス 0x800000 で 終 わる STACK と い う 領 域 が 定 義 さ れています。
例 8-23 ス タ ッ ク 用 の 領 域 の 予 約
LR_1 0x80000
{
STACK 0x800000 EMPTY -0x10000
}
{
}
HEAP +0 EMPTY 0x10000
; ロード 領 域 を 0x80000 から 開 始 する
; 長 さが 負 の 値 であるため、 領 域 は
; 0x800000 で 終 わる。 領 域 の 開 始 ア ド レ スは
; その 長 さを 使 用 して 計 算 する。
; ス タックの 配 置 に 使 用 する 空 き 領 域
; 領 域 は 前 の 領 域 の 末 尾 か ら
; 開 始 す る。 領 域 の 終 了 ア ド レ ス は 正 の 値 の 長 さ を
; 使 用 し て 計 算 す る
{
; ヒープの 配 置 に 使 用 する 空 き 領 域
}
... ; 残 りのスキャ ッ タロード 記 述 ...
注
EMPTY 実 行 領 域 のために 作 成 さ れる ダ ミ ーの ZI 領 域 は、 実 行 時 にゼ ロ で 初 期 化 さ れま
せん。
相 対 ア ド レ ス (+offset) を 指 定 し、 負 の 長 さ を 指 定 し た 場 合 、 エ ラーが 生 成 さ れま
す。
以 下 に、 こ の 例 を 図 示 し ます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-57
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
0x810000
0x800000
0x7F0000
この 例 では、 リ ンカによ って 以 下 のシンボルが 生 成 されます。
図 8-4 ス タ ッ ク 用 の 領 域 の 予 約
Image$$STACK$$ZI$$Base
Image$$STACK$$ZI$$Limit
Image$$STACK$$ZI$$Length
Image$$HEAP$$ZI$$Base
Image$$HEAP$$ZI$$Limit
Image$$HEAP$$ZI$$Length
= 0x7f0000
= 0x800000
= 0x10000
= 0x800000
= 0x810000
= 0x10000
注
EMPTY 属 性 は 実 行 領 域 のみに 適 用 さ れます。 EMPTY 属 性 が ロー ド 領 域 の 定 義 に 使 用 さ れ
てい る 場 合 は、 リ ン カに よ って 警 告 が 生 成 さ れ、 こ の 属 性 は 無 視 さ れます。
リンカは、EMPTY 領 域 に 使 用 さ れる ア ド レ ス 空 間 が、 他 の 実 行 領 域 に 使 用 さ れていな
いかど う かをチェ ッ ク し ます。
8.31.1 関 連 項 目
概 念
『リンカリファレンス』:
• 実 行 領 域 の 記 述 について (4-10 ページ) .
参 照
• Image$$ 実 行 領 域 シンボル (7-6 ページ) .
『リンカリファレンス』:
• 実 行 領 域 の 属 性 (4-13 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-58
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.32 ページ 境 界 での 領 域 の 作 成 について
各 実 行 領 域 がページ 境 界 で 開 始 さ れる、 ターゲ ッ ト に 直 接 ロー ド で き る ELF ファイ
ルを 生 成 できます。
リ ンカには、 ページ 境 界 での ロー ド 領 域 と 実 行 領 域 の 作 成 に 役 立 つ 以 下 の 組 み 込 み
関 数 が 用 意 さ れています。
• AlignExpr
• GetPageSize
注
実 行 領 域 を 整 列 させる と 、 ロー ド ア ド レ ス と 実 行 ア ド レ スの 両 方 が 整 列 さ れます。
以 下 の 例 では、 各 実 行 領 域 が 新 し いページか ら 開 始 さ れる ELF ファイルを 生 成 して
います。
例 8-24 ページ 境 界 での 領 域 の 作 成
LR1 GetPageSize() + SizeOfHeaders()
{
ER_RO +0
{
*(+RO)
}
ER_RW +GetPageSize()
{
*(+RW)
}
ER_ZI +0
{
*(+ZI)
}
}
デフ ォル ト のページサ イ ズであ る 0x8000 が 使 用 さ れます。 こ のページサ イ ズ を 変 更
するには、 --pagesize コマンド ラインオプショ ンを 使 用 します。
8.32.1 関 連 項 目
概 念
• デマン ドページング (4-24 ページ)
• 実 行 領 域 と 入 力 セ ク シ ョ ンのオーバーア ラ イ メ ン ト (8-61 ページ)
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 (8-63 ページ)
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 を 使 用 し たパデ ィ ングの 回 避 (8-64 ページ) .
参 照
『リンカリファレンス』:
• --pagesize=pagesize (2-119 ページ)
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-59
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• ロー ド 領 域 に 厳 密 に 配 置 し た 状 態 で、 実 行 領 域 でベース ア ド レ スに 合 わせる 例
(4-45 ページ)
• AlignExpr(expr, align) 関 数 (4-46 ページ)
• GetPageSize() 関 数 (4-47 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-60
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.33 実 行 領 域 と 入 力 セ ク シ ョ ンのオーバーア ラ イ メ ン ト
コードセクシ ョ ンとデータセクシ ョ ンをオーバーアライ メ ン ト させる 必 要 が 生 じる
場 合 があ り ます。 それ ら のセ ク シ ョ ンの 処 理 方 法 は、 ソ ース コー ド にア ク セスでき
るかど うかによって 異 なり ます。
• 元 の ソース コー ド にア ク セスでき る 場 合 は、 __align(n) キーワード、
--min_array_alignment コ マン ド ラ イ ンオプシ ョ ンなど を 使 用 する こ と で コ ンパ イ
ル 時 に 実 行 でき ます。
• ソースコードにアクセスできない 場 合 は、 スキャッタファイルで 以 下 のアライ
メ ン ト 指 定 子 を 使 用 する 必 要 があ り ます。
ALIGNALL 実 行 領 域 内 のすべてのセ ク シ ョ ンのセ ク シ ョ ンア ラ イ メ ン ト を 増 やし
ます。 以 下 に 例 を 示 し ます。
ER_DATA ...ALIGNALL 8
{
... ; セレクタ
}
OVERALIGN
特 定 のセ ク シ ョ ンのア ラ イ メ ン ト を 増 やし ます。 以 下 に 例 を 示 し ま
す。
ER_DATA ...
{
*.o(.bar, OVERALIGN 8)
... ; セレクタ
}
8.33.1 関 連 項 目
概 念
• ページ 境 界 での 領 域 の 作 成 について (8-59 ページ)
参 照
『リンカリファレンス』:
• 実 行 領 域 の 属 性 (4-13 ページ)
• 入 力 セ ク シ ョ ンの 記 述 について (4-23 ページ) .
『コンパイ ラ リ ファレンス』 :
• __align (5-3 ページ)
• --min_array_alignment=opt (3-156 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-61
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.34 スキャ ッ タ フ ァ イルでのプ リ プ ロセ ッ シング コ マン ド の 使 用
C プリプロセッサを 使 用 して、 スキャッタファイルを 渡 すことができます。 これに
より、C プリプロセッサのすべての 機 能 にアクセスできるようになります。
ス キ ャ ッ タ フ ァ イルの 最 初 の 行 で、 リ ン カが こ のフ ァ イルを 処 理 する ために 呼 び 出
すプ リ プ ロ セ ッ サ コ マン ド を 指 定 し ます。 こ の コ マン ド の 形 式 以 下 に 示 し ます。
#! preprocessor [pre_processor_flags]
一 般 的 には、 #! armcc -E という コマンドが 使 用 されます。 このコマンドは、armcc プリ
プ ロ セ ッ サを 使 用 し て、 ス キ ャ ッ タ フ ァ イ ルを 渡 し ます。
以 下 の こ と がで き ます。
• プリプロセッシングディレクティブをスキャッタファイルの 先 頭 に 追 加 しま
す。
• スキャッタファイル 内 の 単 純 な 式 の 評 価 を 使 用 します。
例 えば、 スキャ ッ タ フ ァ イル file.scat には 以 下 のよ う なコマン ド を 含 めます。
#! armcc -E
#define ADDRESS 0x20000000
#include "include_file_1.h"
lr1 ADDRESS
{
...
}
リ ンカに よ って、 前 処 理 済 みのス キ ャ ッ タ フ ァ イルが 解 析 され、 デ ィ レ ク テ ィ ブが
コメントとして 処 理 されます。
ま た、 ス キ ャ ッ タ フ ァ イルの 前 処 理 を --predefine コマンド ラインオプショ ンと 共 に
使 用 する こ と も で き ます。 こ の 例 では、 以 下 の よ う に し ます。
1. file.scat を 変 更 して、 ディ レ クテ ィブ #define ADDRESS 0x20000000 を 削 除 し ます。
2. 以 下 の コ マン ド を 指 定 し ます。
armlink --predefine="-DADDRESS=0x20000000" --scatter=file.scat
8.34.1 関 連 項 目
概 念
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 (8-63 ページ) .
参 照
『リンカリファレンス』:
• --predefine="string" (2-125 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-62
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.35 スキャ ッ タ フ ァ イル 内 の 式 の 評 価
リンカは、 使 用 されている 演 算 子 が +、 -、 *、 /、 AND、 OR、 および 丸 括 弧 のみの 単 純 な
式 を 評 価 できます。 OR および AND の 実 装 は、 C の 演 算 子 の 優 先 順 位 に 従 います。
8.35.1 式 の 評 価 の 使 用 例
次 のデ ィ レ ク テ ィ ブを 使 用 し ます。
#define BASE_ADDRESS 0x8000
#define ALIAS_NUMBER 0x2
#define ALIAS_SIZE 0x400
#define AN_ADDRESS (BASE_ADDRESS+(ALIAS_NUMBER*ALIAS_SIZE))
ス キ ャ ッ タ フ ァ イルには、 次 の も のが 含 まれる 可 能 性 があ り ます。
LOAD_FLASH AN_ADDRESS
; 開 始 ア ド レ ス
前 処 理 の 後 の 評 価 は 次 の と お り です。
LOAD_FLASH ( 0x8000 + ( 0x2 * 0x400 )) ; 開 始 ア ド レ ス
評 価 の 後 、 スキ ャ ッ タ フ ァ イルが 解 析 されて、 ロード 領 域 が 作 成 されます。
LOAD_FLASH 0x8800 ; 開 始 ア ド レ ス
8.35.2 関 連 項 目
概 念
• スキャッタファイルでのプリプロセッシングコマンドの 使 用 (8-62 ページ)
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 を 使 用 し たパデ ィ ングの 回 避 (8-64 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-63
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.36 スキャ ッ タ フ ァ イル 内 の 式 の 評 価 を 使 用 し たパデ ィ ングの 回 避
スキャッタファイルで ALIGN、 ALIGNALL、 または FIXED 属 性 を 使 用 する と 、 イ メ ージに
大 量 のパデ ィ ン グが 挿 入 さ れる 場 合 があ り ます。 こ のパデ ィ ン グ を 削 除 する には、
式 の 評 価 を 使 用 し て、 ロー ド 領 域 と 実 行 領 域 の 開 始 ア ド レ ス を 指 定 し ます。 ア ド レ
ス 式 の 指 定 には、 組 み 込 み 関 数 AlignExpr を 使 用 できます。
8.36.1 スキャ ッ タ フ ァ イルでのパデ ィ ングの 回 避 例
以 下 のスキャッタファイルでは、 生 成 されたイ メージにパディングが 挿 入 されます。
LR1 0x4000
{
ER1 +0 ALIGN 0x8000
{
...
}
}
ALIGN キーワード を 使 用 する と、ER1 はロードビューと 実 行 ビューの 両 方 で 0x8000 の 境
界 で 整 列 さ れます。 ロー ド ビ ューで 整 列 させる ためには、 リ ンカは 0x4000 バイ トの
パデ ィ ングを 挿 入 する 必 要 があ り ます。
以 下 のスキャッタファイルでは、 生 成 されたイ メージにパディングが 挿 入 されませ
ん。
LR1 0x4000
{
ER1 AlignExpr(+0, 0x8000)
{
...
}
}
AlignExpr を 使 用 する と 、 +0 の 結 果 は 0x8000 の 境 界 で 整 列 さ れます。 そのため、 作 成
さ れる 実 行 領 域 の ロー ド ア ド レ スは 0x4000 にな り ますが、 実 行 ア ド レスは 0x8000 に
なります。
8.36.2 関 連 項 目
概 念
• スキ ャ ッ タ フ ァ イル 内 の 式 の 評 価 (8-63 ページ) .
『リンカリファレンス』:
• ロー ド 領 域 に 厳 密 に 配 置 し た 状 態 で、 実 行 領 域 でベース ア ド レ スに 合 わせる 例
(4-45 ページ) .
参 照
『リンカリファレンス』:
• 実 行 領 域 の 属 性 (4-13 ページ)
• AlignExpr(expr, align) 関 数 (4-46 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-64
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.37 等 価 なスキャ ッ タ ロー ド 記 述 を 使 用 し た 単 純 イ メ ージの 生 成
コマンド ラインオプショ ン --reloc、 --ro_base、 --rw_base、 --ropi、 --rwpi、 および
--split を 指 定 する と 、 以 下 の タ イ プの 単 純 イ メ ージが 作 成 さ れます。
• タイプ 1 のイ メージ :1 つの ロー ド 領 域 と 連 続 する 実 行 領 域
• タイプ 2 のイ メージ :1 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域
• タイプ 3 のイ メージ :2 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域
これと 同 じタイプのイ メージは、--scatter コマンド ラインオプショ ンと、 対 応 する
スキャッタロード 記 述 の 1 つを 含 んでい る フ ァ イ ルを 使 用 し て、 作 成 する こ と がで
きます。
8.37.1 関 連 項 目
概 念
• 単 純 イ メ ージの タ イ プ (4-10 ページ)
• タイプ 1 のイ メージ :1 つの ロー ド 領 域 と 連 続 する 実 行 領 域 (8-66 ページ)
• タイプ 2 のイ メージ :1 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (8-68 ページ)
• タイプ 3 のイ メージ :2 つの ロー ド 領 域 と 連 続 し ない 実 行 領 域 (8-70 ページ) .
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ) .
参 照
『リンカリファレンス』:
• --reloc (2-134 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• --scatter=file (2-144 ページ)
• --split (2-156 ページ)
• ロード 領 域 の 属 性 (4-8 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-65
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.38 タイプ 1 のイ メージ : 1 つのロー ド 領 域 と 連 続 する 実 行 領 域
このタイプのイ メージは、 ロードビュー 内 の 1 つのロー ド 領 域 と 、 実 行 ビ ュー 内 の 3
つの 実 行 領 域 か ら 構 成 さ れます。 実 行 領 域 は メ モ リ マ ッ プ 内 連 続 し て 配 置 さ れます。
--ro_base address を 使 用 する と 、 RO 出 力 セ ク シ ョ ンを 含 んでいる 領 域 のロード ア ド
レスと 実 行 アドレスを 指 定 できます。 以 下 の 例 では、--ro_base 0x040000 を 使 用 する こ
と と 同 じ 意 味 を 持 つスキャ ッ タロード 記 述 を 示 しています。
例 8-25 1 つのロー ド 領 域 と 連 続 する 実 行 領 域
LR_1 0x040000
{
ER_RO +0
}
{
; LR_1 と い う 名 前 のロード 領 域 を 定 義 し、 0x040000 から 開 始 する。
; 最 初 の 実 行 領 域 は ER_RO と い う 名 前 で、 前 の 領 域 の 末 尾 か ら 開 始 する。
; ただし、 前 の 領 域 は 存 在 しないため、 アドレスは 0x040000 になる。
* (+RO) ; すべての RO セクショ ンはこの 領 域 に 連 続 して 配 置 される。
}
ER_RW +0
{
; 2 番 目 の 実 行 領 域 は ER_RW と い う 名 前 で、 前 の 領 域 の 末 尾 か ら
; 開 始 す る。 ア ド レ ス は 0x040000 + ER_RO 領 域 の サ イ ズ に な る。
* (+RW) ; すべての RW セクショ ンはこの 領 域 に 連 続 して 配 置 される。
}
ER_ZI +0
{
}
; 最 後 の 実 行 領 域 は ER_ZI と い う 名 前 で、 前 の 領 域 の 末 尾
; 0x040000 + ER_RO 領 域 の サ イ ズ + ER_RW 領 域 の サ イ ズ
; から 開 始 する。
* (+ZI) ; すべての ZI セ ク シ ョ ンはこ こ に 連 続 し て 配 置 される。
こ の 例 では、 以 下 の よ う にな り ます。
• この 記 述 によ り、ロードアドレスに 0x040000 が 設 定 された、LR_1 という 名 前 の 1
つの ロー ド 領 域 を 含 んでい る イ メ ージが 作 成 さ れます。
• このイ メージには、ER_RO、 ER_RW、 ER_ZI という 3 つの 実 行 領 域 があ り 、 それぞれ
RO、 RW、 ZI の 各 出 力 セ ク シ ョ ン を 含 んでいます。 RO と RW はルー ト 領 域 で
す。 ZI は 実 行 時 に 動 的 に 作 成 さ れます。 ER_RO の 実 行 ア ド レ スは 0x040000 です。
実 行 領 域 の 記 述 において、 +offset 形 式 のベース 指 定 子 を 使 用 する こ と に よ り 、
3 つの 実 行 領 域 がすべて メ モ リ マ ッ プ 内 で 連 続 し て 配 置 さ れます。 こ れに よ り 、
実 行 領 域 をその 前 の 行 領 域 の 直 後 に 配 置 で き ます。
--reloc オプシ ョ ン を 使 用 する と 、 再 配 置 可 能 な イ メ ージを 作 成 で き ます。 --reloc を
単 独 で 使 用 する と 、 単 一 の ロー ド 領 域 の 属 性 が RELOC に 設 定 される、 単 純 タ イプ 1 に
似 たイ メージが 生 成 されます。
8.38.1 ropi の 例
こ の 例 では、 実 行 領 域 は メ モ リ マ ッ プ 内 で 連 続 し て 配 置 さ れます。 ただ し、 --ropi を
指 定 する と 、 RO 出 力 セ ク シ ョ ン を 保 持 する ロー ド 領 域 と 実 行 領 域 が 位 置 非 依 存 と し
てマーク されます。
以 下 の 例 では、 --ro_base 0x010000 --ropi を 使 用 する こ と と 同 じ 意 味 を 持 つスキャ ッ タ
ロード 記 述 を 示 しています。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-66
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
例 8-26 位 置 非 依 存 コー ド
LR_1 0x010000 PI ; 最 初 のロード 領 域 を 0x010000 から 開 始 する。
{
ER_RO +0 ; PI 属 性 が 親 か ら 継 承 さ れ る。
; デフォルトの 実 行 アドレスは 0x010000 だが、 コードは 移 動 できる。
{
* (+RO) ; すべての RO セクションはここに 配 置 される。
}
ER_RW +0 ABSOLUTE ; PI 属 性 が ABSOLUTE によってオーバーライドされる。
{
* (+RW) ; 次 に RW セクショ ンが 配 置 される。 このセクショ ンは 移 動 できない。
}
ER_ZI +0 ; ER_ZI 領 域 は ER_RW 領 域 の 後 に 配 置 さ れ る。
{
* (+ZI) ; すべての ZI セ ク シ ョ ンはこ こ に 連 続 し て 配 置 される。
}
}
RO 実 行 領 域 であ る ER_RO は、 ロー ド 領 域 LR_1 から PI 属 性 を 継 承 し ます。 次 の 実 行 領
域 ER_RW は ABSOLUTE としてマークされ、+offset 形 式 のベース 指 定 子 が 使 用 さ れます。
このため、ER_RW には ER_RO の PI 属 性 が 継 承 さ れません。 ま た、 ER_ZI 領 域 のオフセ ッ
トに +0 が 設 定 されているため、 この 領 域 は ER_RW 領 域 の ABSOLUTE 属 性 を 継 承 し ます。
8.38.2 関 連 項 目
概 念
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ)
• ロード 領 域 に 相 対 アドレス +offset を 使 用 する 際 の 注 意 事 項 (4-18 ページ)
• 実 行 領 域 に 相 対 ア ド レ ス +offset を 使 用 する 際 の 注 意 事 項 (4-19 ページ) .
参 照
『リンカリファレンス』:
• --reloc (2-134 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• ロード 領 域 の 属 性 (4-8 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-67
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.39 タイプ 2 のイ メージ : 1 つのロー ド 領 域 と 連 続 し ない 実 行 領 域
このタイプのイ メージは、 ロードビュー 内 の 1 つのロー ド 領 域 と 、 実 行 ビ ュー 内 の 3
つの 実 行 領 域 か ら 構 成 さ れます。 RW 実 行 領 域 が RO 実 行 領 域 と 隣 接 し ない こ と を 除
いては、 タ イプ 1 のイ メージと 似 ています。
--ro_base=address1 を 使 用 する と 、 RO 出 力 セ ク シ ョ ンを 含 んでいる 領 域 のロード ア ド
レスと 実 行 アドレスを 指 定 できます。--rw_base=address2 を 使 用 する と 、 RW 実 行 領 域
の 実 行 ア ド レ ス を 指 定 でき ます。
以 下 の 例 では、 --ro_base=0x010000 --rw_base=0x040000 を 使 用 する こ と と 同 じ 意 味 を 持
つスキャ ッ タ ロード 記 述 を 示 しています。
例 8-27 1 つのロー ド 領 域 と 複 数 の 実 行 領 域
LR_1 0x010000
{
ER_RO +0
}
; LR_1 という 名 前 のロード 領 域 を 定 義 する。
; 最 初 の 実 行 領 域 は ER_RO と い う 名 前 で、 前 の 領 域 の 末 尾 か ら 開 始 する。
; 前 の 領 域 は 存 在 し ないため、 ア ド レ スは 0x010000 になる。
{
* (+RO) ; すべての RO セ ク シ ョ ンはこ の 領 域 に 連 続 し て 配 置 される。
}
ER_RW 0x040000 ; 2 番 目 の 実 行 領 域 は ER_RW という 名 前 で、0x040000 から 開 始 する。
{
* (+RW) ; すべての RW セ ク シ ョ ンはこ の 領 域 に 連 続 し て 配 置 される。
}
ER_ZI +0 ; 最 後 の 実 行 領 域 は ER_ZI という 名 前 で、
; アドレスは 0x040000 + ER_RW 領 域 の サ イ ズ に な る。
{
* (+ZI) ; すべての ZI セ ク シ ョ ンはこ こ に 連 続 し て 配 置 される。
}
こ の 例 では、 以 下 の よ う にな り ます。
• この 記 述 によ り、ロードアドレスに 0x010000 が 設 定 された、LR_1 という 名 前 の 1
つの ロー ド 領 域 を 含 んでい る イ メ ージが 作 成 さ れます。
• このイ メージには、ER_RO、 ER_RW、 ER_ZI という 3 つの 実 行 領 域 があ り 、 それぞれ
RO、 RW、 ZI の 各 出 力 セ ク シ ョ ン を 含 んでいます。 RO 領 域 はルー ト 領 域 です。
ER_RO の 実 行 ア ド レ スは 0x010000 です。
• ER_RW 実 行 領 域 と ER_RO 実 行 領 域 は 隣 接 し ていません。 こ の 領 域 の 実 行 ア ド レ ス
は 0x040000 です。
• ER_ZI 実 行 領 域 は、 その 前 の 実 行 領 域 であ る ER_RW の 直 後 に 配 置 されます。
8.39.1 rwpi の 例
RW 実 行 領 域 と RO 実 行 領 域 が 隣 接 し ていない 点 で、 --rw_base を 指 定 して 作 成 する タ
イプ 2 のイ メージと 似 ています。 ただし、--rwpi を 指 定 する と 、 RW 出 力 セ ク シ ョ ン
を 保 持 する 実 行 領 域 が 位 置 非 依 存 と し てマー ク さ れます。
以 下 の 例 では、 --ro_base=0x010000 --rw_base=0x018000 --rwpi を 使 用 する こ と と 同 じ 意
味 を 持 つス キ ャ ッ タ ロー ド 記 述 を 示 し ています。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-68
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
例 8-28 位 置 非 依 存 デー タ
LR_1 0x010000
{
ER_RO +0
}
; 最 初 のロード 領 域 を 0x010000 から 開 始 する。
; デ フォルトの ABSOLUTE 属 性 が 親 か ら 継 承 さ れ る。 実 行 ア ド レ ス は
; 0x010000 になる。 コード と RO データは 移 動 できない。
{
* (+RO) ; すべての RO セクションはここに 配 置 される。
}
ER_RW 0x018000 PI ; PI 属 性 に よ っ て ABSOLUTE がオーバーライドされる。
{
* (+RW) ; RW セクショ ンは 0x018000 に 配 置 され、 移 動 でき る。
}
ER_ZI +0 ; ER_ZI 領 域 は ER_RW 領 域 の 後 に 配 置 さ れ る。
{
* (+ZI) ; すべての ZI セ ク シ ョ ンはこ こ に 連 続 し て 配 置 される。
}
RO 実 行 領 域 であ る ER_RO は、 ロー ド 領 域 LR_1 から ABSOLUTE 属 性 を 継 承 し ます。 次 の
実 行 領 域 であ る ER_RW は、 PI としてマークされます。また、ER_ZI 領 域 のオフセ ッ ト に
+0 が 設 定 されているため、 この 領 域 は ER_RW 領 域 の PI 属 性 を 継 承 し ます。
タイプ 2 とタイプ 3 のイ メージに、--ropi と --rwpi の 他 の 組 み 合 わせを 使 用 する ス
キ ャ ッ タ ロー ド の 記 述 も 可 能 です。
8.39.2 関 連 項 目
概 念
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ)
• ロード 領 域 に 相 対 アドレス +offset を 使 用 する 際 の 注 意 事 項 (4-18 ページ)
• 実 行 領 域 に 相 対 ア ド レ ス +offset を 使 用 する 際 の 注 意 事 項 (4-19 ページ) .
参 照
『リンカリファレンス』:
• --ro_base=address (2-137 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• ロード 領 域 の 属 性 (4-8 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-69
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.40 タイプ 3 のイ メージ : 2 つのロー ド 領 域 と 連 続 し ない 実 行 領 域
タイプ 3 のイ メージは、 ロードビュー 内 の 2 つのロード 領 域 と、 実 行 ビ ュー 内 の 3 つ
の 実 行 領 域 か ら 構 成 さ れます。 こ の タ イ プの イ メ ージはタ イ 2 のイ メージと 似 てい
ますが、 このイ メージではタ イプ 2 の 1 つのロー ド 領 域 が 2 つのロー ド 領 域 に 分 割 さ
れます。
ロー ド 領 域 の 再 配 置 と 分 割 を 行 う には、 以 下 の リ ン カオプシ ョ ン を 使 用 し ます。
--reloc --reloc --split の 組 み 合 わせを 使 用 する と 、 単 純 タ イ プ 3 に 似 た イ メ ー
ジが 生 成 されますが、 2 つのロード 領 域 には RELOC 属 性 が 設 定 さ れます。
--ro_base=address1
--rw_base=address2
RO 出 力 セ ク シ ョ ンを 含 んでいる 領 域 のロード ア ド レ ス と 実 行 ア ド レ ス
を 指 定 し ます。
RW 出 力 セ ク シ ョ ンを 含 んでいる 領 域 のロード ア ド レ ス と 実 行 ア ド レ ス
を 指 定 し ます。
--split RO 出 力 セ ク シ ョ ン と RW 出 力 セ ク シ ョ ン を 含 んでい るデフ ォル ト の 1
つのロー ド 領 域 を 2 つの ロー ド 領 域 に 分 割 し ます。 こ れに よ り 、 一 方 の
ロード 領 域 には RO 出 力 セ ク シ ョ ンが 含 められ、 も う 一 方 のロード 領 域
には RW 出 力 セ ク シ ョ ンが 含 め られます。
以 下 の 例 では、 --ro_base=0x010000 --rw_base=0x040000 --split を 使 用 する こ と と 同 じ 意
味 を 持 つス キ ャ ッ タ ロー ド 記 述 を 示 し ています。
例 8-29 複 数 のロー ド 領 域
LR_1 0x010000 ; 最 初 のロード 領 域 を 0x010000 から 開 始 する。
{
ER_RO +0 ; アドレスは 0x010000 になる。
{
* (+RO)
}
}
LR_2 0x040000 ; 2 番 目 のロード 領 域 を 0x040000 から 開 始 する。
{
ER_RW +0 ; アドレスは 0x040000 になる。
{
* (+RW) ; すべての RW セ ク シ ョ ンはこ の 領 域 に 連 続 し て 配 置 される。
}
ER_ZI +0 ; アドレスは 0x040000 + ER_RW 領 域 の サ イ ズ に な る 。
{
* (+ZI) ; すべての ZI セ ク シ ョ ンはこ の 領 域 に 連 続 し て 配 置 される。
}
}
こ の 例 では、 以 下 の よ う にな り ます。
• 0x010000 と 0x040000 をロードアドレスとする 2 つのロード 領 域 LR_1 および LR_2
を 含 んでいる イ メージが 作 成 されます。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-70
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• このイ メージには、ER_RO、 ER_RW、 ER_ZI という 3 つの 実 行 領 域 があ り 、 それぞれ
RO、 RW、 ZI の 各 出 力 セ ク シ ョ ン を 含 んでいます。 ER_RO の 実 行 ア ド レ スは
0x010000 です。
• ER_RW 実 行 領 域 は、 実 行 ア ド レ スが 0x040000 であるため、ER_RO 実 行 領 域 と 隣 接 し
ていません。
• ER_ZI 実 行 領 域 は、 その 前 の 実 行 領 域 であ る ER_RW の 直 後 に 配 置 されます。
8.40.1 再 配 置 可 能 なロー ド 領 域 の 例
このタイプ 3 の イ メ ージ も、 ロー ド ビ ュー 内 の 2 つのロード 領 域 と、 実 行 ビ ュー 内 の
3 つの 実 行 領 域 か ら 構 成 さ れます。 ただ し、 こ こ では 2 つのー ド 領 域 に RELOC 属 性 を
設 定 する ために、 --reloc を 使 用 し ます。
以 下 の 例 では、 --ro_base 0x010000 --rw_base 0x040000 --reloc --split を 使 用 する こ と と
同 じ 意 味 を 持 つスキャ ッ タ ロード 記 述 を 示 しています。
例 8-30 再 配 置 可 能 なロー ド 領 域
LR_1 0x010000 RELOC
{
ER_RO + 0
{
* (+RO)
}
}
LR2 0x040000 RELOC
{
ER_RW + 0
{
* (+RW)
}
}
ER_ZI +0
{
* (+ZI)
}
8.40.2 関 連 項 目
概 念
『リンカリファレンス』:
• ロード 領 域 の 記 述 について (4-5 ページ)
• ロード 領 域 に 相 対 アドレス +offset を 使 用 する 際 の 注 意 事 項 (4-18 ページ)
• 実 行 領 域 に 相 対 ア ド レ ス +offset を 使 用 する 際 の 注 意 事 項 (4-19 ページ) .
参 照
『リンカリファレンス』:
• --reloc (2-134 ページ)
• --ro_base=address (2-137 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-71
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
• --rw_base=address (2-141 ページ)
• --split (2-156 ページ)
• ロード 領 域 の 属 性 (4-8 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-72
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
8.41 スキャ ッ タ フ ァ イルを 使 用 した ELF のマ ッ ピング
単 純 イ メ ージの 場 合 、 ELF 形 式 の 実 行 可 能 な フ ァ イ ルには、 以 下 のセグ メ ン ト が 含
まれます。
• PT_LOAD タイプの 1 つの ELF プログラムセグメン トで 表 されるロード 領 域
• 以 下 の 3 つまでの ELF セ ク シ ョ ンで 表 さ れる 実 行 領 域
— RO 用 のセ ク シ ョ ン
— RW 用 のセ ク シ ョ ン
— ZI 用 のセ ク シ ョ ン
例 えば、 以 下 の よ う な ス キ ャ ッ タ フ ァ イルがあ る と し ます。
例 8-31 スキャ ッ タ フ ァ イル
LOAD 0x8000
{
EXEC_ROM +0
{
*(+RO)
}
RAM +0
{
*(+RW,+ZI)
}
HEAP +0x100 EMPTY 0x100
{
}
STACK +0 EMPTY 0x400
{
}
}
このスキャッタファイルでは、 ロード 領 域 のアドレスが 0x8000 である、 PT_LOAD タ
イプの 1 つのプロ グ ラ ムセグ メ ン ト が 作 成 されます。
EXEC_ROM の 内 容 を 表 す SHT_PROGBITS タイプの 1 つの 出 力 セ ク シ ョ ンが 作 成 さ
れます。 RAM を 表 す 2 つの 出 力 セ ク シ ョ ンが 作 成 さ れます。 1 つは SHT_PROGBITS
タ イ プで、 初 期 化 さ れた 読 み 出 し / 書 き 込 みデータ を 含 みます。 も う 1 つは
SHT_NOBITS タ イ プで、 ゼ ロ で 初 期 化 さ れたデータ についての 記 述 を 含 みます。
ヒープとスタックは、 ELF ファイルの SHT_NOBITS セクションに 記 述 されます。
イ メ ージ 内 のス キ ャ ッ タ ロー ド が 行 われたセ ク シ ョ ン を 確 認 するには、 以 下 の
fromelf コマンドを 入 力 します。
fromelf --text -v my_image.axf
シンボルテーブルを 表 示 する には、 以 下 の コ マン ド を 入 力 し ます。
fromelf --text -s -v my_image.axf
以 下 は fromelf の 出 力 例 で、 LOAD、 EXEC_ROM、 RAM、 HEAP、 および STACK の 各 セ ク シ ョ ンが
示 されています。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-73
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
例 8-32 ELF イ メ ージ 内 のスキャ ッ タ ロー ド が 行 われたセ ク シ ョ ン
...
========================================================================
** Program header #0
Type :PT_LOAD (1)
File Offset :52 (0x34)
Virtual Addr :0x00008000
Physical Addr :0x00008000
Size in file :764 bytes (0x2fc)
Size in memory:2140 bytes (0x85c)
Flags
:PF_X + PF_W + PF_R + PF_ARM_ENTRY (0x80000007)
Alignment :4
========================================================================
** Section #1
Name :EXEC_ROM
...
Addr :0x00008000
File Offset :52 (0x34)
Size :740 bytes (0x2e4)
...
====================================
** Section #2
Name :RAM
...
Addr :0x000082e4
File Offset :792 (0x318)
Size :20 bytes (0x14)
...
====================================
** Section #3
Name :RAM
...
Addr :0x000082f8
File Offset :812 (0x32c)
Size :96 bytes (0x60)
...
====================================
** Section #4
Name :HEAP
...
Addr :0x00008458
File Offset :812 (0x32c)
Size :256 bytes (0x100)
...
====================================
** Section #5
Name :STACK
...
Addr :0x00008558
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-74
ID 111311
Non-Confidential

スキャ ッ タ フ ァ イルの 使 用
File Offset :812 (0x32c)
Size :1024 bytes (0x400)
...
8.41.1 関 連 項 目
概 念
• スキャッタロードについて (8-3 ページ)
• メモリマップが 単 純 なイメージ (8-7 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 8-75
ID 111311
Non-Confidential

第 9 章
armlink における GNU ld スクリプトのサポート
以 下 の ト ピ ッ ク では、 armlink におけ る GNU ld スクリプトのサポートについて 説 明 しま
す。
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ)
• armlink での ld ス ク リ プ ト の 一 般 的 な 使 用 事 例 (9-4 ページ)
• Armlink に 実 装 さ れてい る 重 要 な ld スクリプトコマンド (9-6 ページ)
• armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限 (9-8 ページ)
• armlink での ld ス ク リ プ ト の 使 用 に 関 する 推 奨 事 項 (9-9 ページ)
• armlink に よ っ て 使 用 さ れるデフ ォル ト の GNU ld スクリプト (9-10 ページ)
• ARM Linux 実 行 可 能 フ ァ イルを リ ン クする ための GNU ld スクリプトの 例
(9-14 ページ)
• ARM Linux 共 有 オブジ ェ ク ト を リ ン クする ための GNU ld スクリプトの 例
(9-16 ページ)
• ld --ldpartial オブジェ ク ト を リ ン クするための GNU ld スクリプトの 例
(9-18 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-1
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.1 GNU ld スクリプトのサポート と 制 限 について
armlink では GNU ld ス ク リ プ ト の 使 用 をサポー ト し ていますが、 以 下 の 制 限 があ り ま
す。
• armlink に GNU ld スクリプト 言 語 のサブセットが 実 装 されている。
• サブセッ ト は、 ARM Linux と 部 分 リンクのサポートに 重 点 を 置 いている。
• 仮 想 ア ド レ ス (VMA) がロードアドレス (LMA) と 同 じである 必 要 がある。
• このリ リースでは、 ベアメ タルはサポート されない。
• armlink --sysv コマンドラインオプショ ンでは、 内 部 ld スクリプトが 使 用 され
る。 --sysv は --arm_linux コマンド ラインオプショ ンのデフォルトでもあり ます。
ld スクリプトを 指 定 するには、armlink --linker_script ld_script コマンドラインオプ
ション、 または 同 義 語 のコマンドラインオプション -T ld_script を 使 用 し ます。
9.1.1 イ メ ージおよび 共 有 オブジ ェ ク ト を リ ン クする 場 合 の ld ス ク リ プ ト の 使 用
イ メ ージまたは 共 有 オブジ ェ ク ト を リ ン クするには、 以 下 の 点 に 注 意 し て 下 さ い。
• --sysv オプシ ョ ンまたは --arm_linux オプシ ョ ンが 必 要 です。
• 認 識 さ れないフ ァ イルは、 ld ス ク リ プ ト と 同 様 に 解 析 さ れます。
• ld スクリプトによって 生 成 されたすべての ELF イ メ ージおよび 共 有 オブジ ェ ク
ト では、 デマン ド ページングが 行 われます。 ページサ イ ズを 制 御 すには、
--pagesize オプシ ョ ン を 使 用 し ます。 デフ ォル ト は 0x8000 です。
9.1.2 部 分 オブジ ェ ク ト を リ ン クする 場 合 の ld スクリプトの 使 用
部 分 オブジ ェ ク ト を リ ン ク する には、 armlink --ldpartial コマンドラインオプショ ン
を 使 用 する 必 要 があ り ます。 -r コマンド ラインオプショ ンは --ldpartial の 同 義 語 で
す。
9.1.3 関 連 項 目
概 念
• armlink での ld ス ク リ プ ト の 一 般 的 な 使 用 事 例 (9-4 ページ)
• Armlink に 実 装 されている 重 要 な ld スクリプトコマンド (9-6 ページ)
• armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限 (9-8 ページ)
• armlink での ld ス ク リ プ ト の 使 用 に 関 する 推 奨 事 項 (9-9 ページ)
• armlink によって 使 用 されるデフォルトの GNU ld スクリプト (9-10 ページ) .
参 照
『リンカリファレンス』:
• --arm_linux (2-13 ページ)
• --ldpartial (2-95 ページ)
• --linker_script=ld_script (2-101 ページ)
• --pagesize=pagesize (2-119 ページ)
• --sysroot=path (2-171 ページ)
• --sysv (2-172 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-2
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
その 他 の 情 報
• LD の 使 用 : GNU リンカ
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-3
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.2 armlink での ld ス ク リ プ ト の 一 般 的 な 使 用 事 例
以 下 に、 armlink での ld ス ク リ プ ト の 一 般 的 な 使 用 事 例 を 示 し ます。
ライブラリのラップ
一 部 の ラ イ ブ ラ リ には、 動 的 な 部 分 と 静 的 な 部 分 があ り ます。 ld スクリ
プトでは、INPUT コマン ド で 指 定 された とお り の 順 序 で 両 方 のラ イブラ
リ をロード します。 以 下 に 例 を 示 します。
INPUT(libstatic.a)
INPUT(libdynamic.so)
このスク リプトでは、libstatic.a の 後 に libdynamic.so をロードするよう
にリンカに 指 示 しています。
--ldpartial オプシ ョ ン を 使 用 し た 部 分 リ ン ク
ld スクリプトを 指 定 して、 リンカによるセクションの 結 合 方 法 を 制 御 で
き ます。 以 下 に 例 を 示 し ます。
SECTIONS
{
.text :0
{
*(.text)
*(mysection)
}
}
このスク リプトでは、mysection とすべての .text セクションを 1 つの
.text 出 力 セ ク シ ョ ンに 結 合 する よ う に リ ンカに 指 示 し ています。
ARM Linux のリンクの 細 かい 制 御
デフォル ト の リ ンカス ク リ プ ト で 指 定 されている 順 序 とは 異 なる 順 序 で
セ ク シ ョ ン を 結 合 する こ と が 必 要 にな る 場 合 があ り ます。 ま た、 リ ン カ
で 定 のア ド レ スにシンボルを 定 義 する こ と が 必 要 にな る 場 合 も あ り ま
す。 こ う し た 情 報 は、 ユーザ 定 義 の リ ン カ ス ク リ プ ト で 指 定 で き ます。
注
ARM Linux 上 で 実 行 で き る フ ァ イルを 正 常 に 生 成 するには、 ダ イ ナ ミ ッ
ク ローダがフ ァ イルを ロー ド する のに 使 用 で き る メ タデータ を 格 納 する
出 力 セ ク シ ョ ン を イ メ ージに 含 め る 必 要 があ り ます。 最 初 はいずれかの
サンプルス ク リ プ ト を 元 に、 それを 目 的 に 合 わせて 変 更 する こ と を 推 奨
します。
9.2.1 関 連 項 目
概 念
• ARM Linux 実 行 可 能 フ ァ イルを リ ン ク する ための GNU ld スクリプトの 例
(9-14 ページ)
• ARM Linux 共 有 オブジ ェ ク ト を リ ン ク する ための GNU ld スクリプトの 例
(9-16 ページ)
• ld --ldpartial オブジェ ク ト を リ ン クするための GNU ld スクリプトの 例
(9-18 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-4
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
参 照
『リンカリファレンス』:
• --ldpartial (2-95 ページ)
• --linker_script=ld_script (2-101 ページ)
• --sysroot=path (2-171 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-5
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.3 Armlink に 実 装 されている 重 要 な ld スクリプト コマンド
以 下 の ld スクリプトコマンドが 実 装 されています。
ファイルを 処 理 するコマンド
以 下 の コ マン ド が 実 装 さ れています。
• AS_NEEDED
• ENTRY
• GROUP
• INCLUDE
• INPUT
• OUTPUT
• OUTPUT_ARCH
• OUTPUT_FORMAT
• SEARCH_DIR
• STARTUP
入 力 セ ク シ ョ ン を 出 力 セ ク シ ョ ンにマ ッ プする コ マン ド
SECTIONS コマンドが 実 装 されています。
SECTIONS コマンドは 最 も 複 雑 なコマンドですが、 すべての 機 能 が 実 装 さ
れているわけではあ り ません。 特 に、 ロード ア ド レス 機 能 は 実 装 されて
いません。
AT(address)
>region
AT>region
これらのコマンドはサポート されていません。 これらのコマンドでは、
サポー ト されていない PHDRS コマンドが 必 要 になるか、 または 仮 想 アド
レスとロードアドレスが 別 々になるためです。
以 下 のデータ 定 義 関 数 は 実 装 さ れていません。
• BYTE(expression)
• COMMON
• CONSTRUCTORS
• CREATE_OBJECT_SYMBOLS
• SHORT(expression)
• LONG(expression)
• QUAD(expression)
• SQUAD(expression)
入 力 セ ク シ ョ ンの 指 定 子 は 使 用 で き ません。
archive:file
シンボルバージ ョ ン 管 理 を 制 御 する コマン ド
VERSIONS コマンドが 実 装 されています。
VERSIONS コマンド 構 文 は、armlink --symver_script コマンドラインオプ
ションでサポートされているものとまったく 同 じです。armlink では、
VERSIONS コマン ドでの 符 号 化 されていないシンボル 名 の 一 致 はサポー ト
していません。
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-6
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.3.1 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ)
• armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限 (9-8 ページ) .
参 照
『リンカリファレンス』:
• --linker_script=ld_script (2-101 ページ)
• --symver_script=file (2-169 ページ)
• --sysroot=path (2-171 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-7
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.4 armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限
以 下 の 制 限 は、 armlink で ld ス ク リ プ ト を 使 用 する 場 合 に 適 用 さ れます。
PHDRS このコマンドは 実 装 されていません。 ld ス ク リ プ ト を 使 用 する 場 合 は、
リ ン カに よ っ て 常 にプ ロ グ ラ ムヘ ッ ダが 自 動 的 に 生 成 さ れます。
MEMORY
OVERLAY
このコマンドは 実 装 されていません。 リンカでは、 0 ~ 0XFFFFFFFF に 同 一
な メ モ リ 空 間 があ る と 想 定 し ます。
このコマンドは 実 装 されていません。 オーバーレイは 使 用 できません。
その 他 のコ マン ド と 組 み 込 み 関 数
以 下 の コ マン ド と 組 み 込 み 関 数 はサポー ト さ れていません。
• ASSERT
• FORCE_COMMON_ALLOCATION
• INHIBIT_COMMON_ALLOCATION
• INSERT AFTER
• INSERT BEFORE
• LENGTH
• NOCROSSREFS
• ORIGIN
• REGION_ALIAS
• TARGET
armlink リンカ 定 義 シンボル
各 出 力 セ ク シ ョ ンは、 内 部 的 には 実 行 領 域 と し て 定 義 さ れます。 既 存 の
armlink 実 行 領 域 シンボルを 使 用 で き ます。 以 下 に 例 を 示 し ます。
.text :{ *(.text) }
出 力 セ ク シ ョ ン .text は、 .text と い う 名 前 の 実 行 領 域 で 表 さ れます。 ス
キャッタファイルによって 実 行 領 域 が 定 義 されている 場 合 と 同 様 に、 シ
ンボル Image$$.text$$Base を 使 用 できます。
その 他 の 制 限
その 他 には 以 下 の 制 限 があ り ます。
• ld ス ク リ プ ト を 使 用 する 場 合 、 __AT セクションはサポート されませ
ん。
• ld ス ク リ プ ト を 使 用 する 場 合 、 RW 圧 縮 はサポー ト さ れません。
9.4.1 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ)
• Armlink に 実 装 されている 重 要 な ld スクリプトコマンド (9-6 ページ)
• Image$$ 実 行 領 域 シンボル (7-6 ページ) .
参 照
『リンカリファレンス』:
• --linker_script=ld_script (2-101 ページ)
• --symver_script=file (2-169 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-8
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.5 armlink での ld ス ク リ プ ト の 使 用 に 関 する 推 奨 事 項
armlink で 使 用 する ld ス ク リ プ ト を 生 成 する 場 合 は、 以 下 の 推 奨 事 項 に 従 っ て 下 さ
い。
9.5.1 ARM Linux 向 けの ld ス ク リ プ ト を 生 成 する 場 合 の 推 奨 事 項
ダ イナ ミ ッ ク ローダが 適 切 に 動 作 する ためには、 特 定 の タ イ プの 出 力 セ ク シ ョ ンが
必 要 です。 以 下 にその 出 力 セ ク シ ョ ン を 示 し ます。
• ハッシュテーブル
• ストリングテーブル
• ダイナミ ックシンボルテーブル
• ダイナミ ックセクション
• バージ ョ ンセ ク シ ョ ン
• スレッドローカルス トレージセクション
9.5.2 一 般 的 な 推 奨 事 項
以 下 に 一 般 的 な 推 奨 事 項 を 示 し ます。
• 各 出 力 セ ク シ ョ ンの タ イ プを 同 種 に し ます。 以 下 に 例 を 示 し ます。
.text :{ *(.text) }
.data :{ *(.data) }
.bss :{ *(.bss) }
こ れは、 以 下 の よ う に 変 更 する こ と を 推 奨 し ます。
.stuff
{
*(.text)
*(.data)
*(.bss)
}
• ARM Linux 上 で ELF ファイルを 実 行 する 場 合 は、 ダイナミ ッ ク リ ンカによって
使 用 さ れる メ タデータ の 場 所 を 変 更 し ないで 下 さ い。
• SECTIONS コ マン ド と 一 致 し ないセ ク シ ョ ンは 孤 立 と マー ク さ れます。 孤 立 セ ク
シ ョ ンは、 リ ン カに よ っ て 適 切 な 場 所 に 配 置 さ れます。 リ ン カでは、 必 ずし も
可 能 ではあ り ませんが、 ld を 使 用 して 孤 立 セクシ ョ ンの 配 置 を 一 致 させよ う と
します。armlink に よ る 孤 立 セ ク シ ョ ンの 配 置 方 法 を 使 用 し ない 場 合 は、 明 示 的
な 配 置 を 使 用 し ます。
9.5.3 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ)
• Armlink に 実 装 されている 重 要 な ld スクリプトコマンド (9-6 ページ)
• armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限 (9-8 ページ) .
参 照
『リンカリファレンス』:
• --linker_script=ld_script (2-101 ページ)
• --symver_script=file (2-169 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-9
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.6 armlink によ っ て 使 用 されるデフ ォル ト の GNU ld スクリプト
ld ス ク リ プ ト を 必 要 と する コ マン ド ラ イ ンオプシ ョ ン を 使 用 する 場 合 、
--linker_script コ マン ド ラ イ ンオプシ ョ ンで 使 用 する ス ク リ プ ト を 指 定 で き ます。 ス
ク リ プ ト を 指 定 し ない 場 合 、 armlink によって 使 用 されるデフォルトの ld スクリプト
は、 実 行 可 能 フ ァ イル と 共 有 オブジ ェ ク ト のど ち ら を ビル ド する かに よ って 異 な り
ます。
9.6.1 実 行 可 能 フ ァ イル 用 のデフ ォル ト の ld スクリプト
SECTIONS
{
PROVIDE(__executable_start = 0x0008000);
. = 0x00008000 + SIZEOF_HEADERS;
.interp :{ *(.interp) }
.note.ABI-tag :{ *(.note.ABI-tag) }
.hash :{ *(.hash) }
.dynsym :{ *(.dynsym) }
.dynstr :{ *(.dynstr) }
.version :{ *(.version) }
.version_d :{ *(.version_d) }
.version_r :{ *(.version_r) }
.rel.dyn :{ *(.rel.dyn) }
.rela.dyn :{ *(.rela.dyn) }
.rel.plt :{ *(.rel.plt) }
.rela.plt :{ *(.rela.plt) }
.init :{ KEEP (*(.init)) }
.plt :{ *(.plt) }
.text :{ *(.text .text.*) }
.fini :{ KEEP (*(.fini)) }
PROVIDE(__etext = .);
PROVIDE(_etext = .);
PROVIDE(etext = .);
.rodata :{ *(.rodata .rodata.*) }
__exidx_start = .;
.ARM.exidx :{ *(.ARM.exidx*) }
__exidx_end = .;
. = ALIGN (CONSTANT (MAXPAGESIZE)) - ((CONSTANT (MAXPAGESIZE) - .)& (CONSTANT
(MAXPAGESIZE) - 1));
. = DATA_SEGMENT_ALIGN (CONSTANT (MAXPAGESIZE), CONSTANT (COMMONPAGESIZE));
.tdata :{ *(.tdata .tdata.*) }
.tbss :{ *(.tbss .tbss.*) }
.preinit_array :
{
PROVIDE_HIDDEN (__preinit_array_start = .);
KEEP (*(.preinit_array))
PROVIDE_HIDDEN (__preinit_array_end = .);
}
.init_array :
{
PROVIDE_HIDDEN (__init_array_start = .);
KEEP (*(.init_array*))
PROVIDE_HIDDEN (__init_array_end = .);
}
.fini_array :
{
PROVIDE_HIDDEN (__fini_array_start = .);
KEEP (*(.fini_array*))
PROVIDE_HIDDEN (__fini_array_end = .);
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-10
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
}
.dynamic :{ *(.dynamic) }
.got :{ *(.got.plt) *(.got) }
.data :
{
__data_start = .;
*(.data .data.*)
}
_edata = .;
PROVIDE(edata = .);
__bss_start = .;
__bss_start__ = .;
.bss :
{
*(.bss .bss.*)
. = ALIGN(.!= 0 32 / 8 : 1);
}
__bss_end__ = .;
_bss_end__ = .;
. = ALIGN(4);
__end = .;
_end = .;
PROVIDE(end = .);
}
9.6.2 共 有 オブジ ェ ク ト 用 のデフ ォル ト の ld スクリプト
SECTIONS
{
. = 0 + SIZEOF_HEADERS;
.note.ABI-tag :{ *(.note.ABI-tag) }
.hash :{ *(.hash) }
.dynsym :{ *(.dynsym) }
.dynstr :{ *(.dynstr) }
.version :{ *(.version) }
.version_d :{ *(.version_d) }
.version_r :{ *(.version_r) }
.rel.dyn :{ *(.rel.dyn) }
.rela.dyn :{ *(.rela.dyn) }
.rel.plt :{ *(.rel.plt) }
.rela.plt :{ *(.rela.plt) }
.init :{ KEEP (*(.init)) }
.plt :{ *(.plt) }
.text :{ *(.text .text.*) }
.fini :{ KEEP (*(.fini)) }
PROVIDE(__etext = .);
PROVIDE(_etext = .);
PROVIDE(etext = .);
.rodata :{ *(.rodata .rodata.*) }
__exidx_start = .;
.ARM.exidx :{ *(.ARM.exidx*) }
__exidx_end = .;
.interp :{ *(.interp) }
. = ALIGN (CONSTANT (MAXPAGESIZE)) - ((CONSTANT (MAXPAGESIZE) - .)& (CONSTANT
(MAXPAGESIZE) - 1));
. = DATA_SEGMENT_ALIGN (CONSTANT (MAXPAGESIZE), CONSTANT (COMMONPAGESIZE));
.tdata :{ *(.tdata .tdata.*) }
.tbss :{ *(.tbss .tbss.*) }
.preinit_array :
{
PROVIDE_HIDDEN (__preinit_array_start = .);
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-11
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
KEEP (*(.preinit_array))
PROVIDE_HIDDEN (__preinit_array_end = .);
}
.init_array :
{
PROVIDE_HIDDEN (__init_array_start = .);
KEEP (*(.init_array*))
PROVIDE_HIDDEN (__init_array_end = .);
}
.fini_array :
{
PROVIDE_HIDDEN (__fini_array_start = .);
KEEP (*(.fini_array*))
PROVIDE_HIDDEN (__fini_array_end = .);
}
.dynamic :{ *(.dynamic) }
.got :{ *(.got.plt) *(.got) }
.data :
{
__data_start = .;
*(.data .data.*)
}
_edata = .;
PROVIDE(edata = .);
__bss_start = .;
__bss_start__ = .;
.bss :
{
*(.bss .bss.*)
. = ALIGN(.!= 0 32 / 8 : 1);
}
__bss_end__ = .;
_bss_end__ = .;
. = ALIGN(4);
__end = .;
_end = .;
PROVIDE(end = .);
}
9.6.3 --ldpartial によって 部 分 的 にリンクされたオブジェクトのデフォルトの ld スクリプト
SECTIONS
{
.interp 0 :{ *(.interp) }
.note.ABI-tag 0 :{ *(.note.ABI-tag) }
.hash 0 :{ *(.hash) }
.dynsym 0 :{ *(.dynsym) }
.dynstr 0 :{ *(.dynstr) }
.version 0 :{ *(.version) }
.version_d 0 :{ *(.version_d) }
.version_r 0 :{ *(.version_r) }
.rel.dyn 0 :{ *(.rel.dyn) }
.rel.plt 0 :{ *(.rel.plt) }
.init 0 :{ KEEP (*(.init)) }
.plt 0 :{ *(.plt) }
.text 0 :{ *(.text) }
.fini 0 :{ KEEP (*(.fini)) }
.rodata 0 :{ *(.rodata) }
.ARM.exidx 0 :{ *(.ARM.exidx*) }
.tdata 0 :{ *(.tdata) }
.tbss 0 :{ *(.tbss) }
.preinit_array 0 :
{
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-12
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
KEEP (*(.preinit_array))
}
.dynamic 0 :{ *(.dynamic) }
.got 0 :{ *(.got.plt) *(.got) }
.data 0 :
{
*(.data)
}
.bss 0 :
{
*(.bss)
}
}
9.6.4 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ) .
参 照
『リンカリファレンス』:
• --ldpartial (2-95 ページ)
• --linker_script=ld_script (2-101 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-13
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.7 ARM Linux 実 行 可 能 フ ァ イルを リ ン クするための GNU ld スクリプトの 例
以 下 の ld スクリプトだけで、"hello world" アプ リ ケーシ ョ ンを リ ンクできます。 最 も
重 要 な 部 分 を 以 下 に 示 し ます。
• 最 初 の .= 0x00008000 + SIZEOF_HEADERS;
リンカは、ELF ヘッ ダ と プロ グ ラ ムヘッ ダを 最 初 のページに 含 める こ と ができ
ます。
• RW を 別 のページに 含 め る 境 界 調 整 式
• ダイナミ ック リンカが 必 要 とするメタデータの 出 力 セクション
ld ス ク リ プ ト フ ァ イ ルを 指 定 する には、 armlink --linker_script コマンド ラインオプ
シ ョ ン を 使 用 し ます。
SECTIONS
{
PROVIDE(__executable_start = 0x0008000);
. = 0x00008000 + SIZEOF_HEADERS;
.interp :{ *(.interp) }
.hash :{ *(.hash) }
.gnu.hash :{ *(.gnu.hash) }
.dynsym :{ *(.dynsym) }
.dynstr :{ *(.dynstr) }
.version :{ *(.version) }
.version_d :{ *(.version_d) }
.version_r :{ *(.version_r) }
.rel.dyn :{ *(.rel.dyn) }
.rel.plt :{ *(.rel.plt) }
.init :{ KEEP (*(.init)) }
.plt :{ *(.plt) }
.text :{ *(.text .text.*) }
.fini :{ KEEP (*(.fini)) }
.rodata :{ *(.rodata .rodata.*) }
.ARM.extab :{ *(.ARM.extab*) }
__exidx_start = .;
.ARM.exidx :{ *(.ARM.exidx*) }
__exidx_end = .;
. = ALIGN (CONSTANT (MAXPAGESIZE)) - ((CONSTANT (MAXPAGESIZE) - .)& (CONSTANT
(MAXPAGESIZE) - 1));
. = DATA_SEGMENT_ALIGN (CONSTANT (MAXPAGESIZE), CONSTANT (COMMONPAGESIZE));
.tdata :{ *(.tdata .tdata.*) }
.tbss :{ *(.tbss .tbss.*) }
.preinit_array :
{
PROVIDE_HIDDEN (__preinit_array_start = .);
KEEP (*(.preinit_array))
PROVIDE_HIDDEN (__preinit_array_end = .);
}
.init_array :
{
PROVIDE_HIDDEN (__init_array_start = .);
KEEP (*(SORT(.init_array.*)))
KEEP (*(.init_array))
PROVIDE_HIDDEN (__init_array_end = .);
}
.fini_array :
{
PROVIDE_HIDDEN (__fini_array_start = .);
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-14
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
KEEP (*(.fini_array))
KEEP (*(SORT(.fini_array.*)))
PROVIDE_HIDDEN (__fini_array_end = .);
}
.dynamic :{ *(.dynamic) }
.got :{ *(.got.plt) *(.got) }
.data :
{
*(.data .data.*)
}
.bss :
{
*(.bss .bss.*)
. = ALIGN(.!= 0 32 / 8 : 1);
}
}
9.7.1 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ) .
参 照
『リンカリファレンス』:
• --linker_script=ld_script (2-101 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-15
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.8 ARM Linux 共 有 オブジ ェ ク ト を リ ン クするための GNU ld スクリプトの 例
以 下 の ld スクリプトの 例 は 共 有 ライブラリのリンク 用 で、 アプリケーション 用 の 例
と 似 ています。 共 有 ライブラ リは 0 + SIZEOF_HEADERS から 開 始 します。
ld ス ク リ プ ト フ ァ イ ルを 指 定 する には、 armlink --linker_script コマンド ラインオプ
シ ョ ン を 使 用 し ます。
SECTIONS
{
. = 0 + SIZEOF_HEADERS;
.hash :{ *(.hash) }
.gnu.hash :{ *(.gnu.hash) }
.dynsym :{ *(.dynsym) }
.dynstr :{ *(.dynstr) }
.version :{ *(.version) }
.version_d :{ *(.version_d) }
.version_r :{ *(.version_r) }
.rel.dyn :{ *(.rel.dyn) }
.rel.plt :{ *(.rel.plt) }
.init :{ KEEP (*(.init)) }
.plt :{ *(.plt) }
.text :{ *(.text .text.*) }
.fini :{ KEEP (*(.fini)) }
.rodata :{ *(.rodata .rodata.*) }
.ARM.extab :{ *(.ARM.extab*) }
__exidx_start = .;
.ARM.exidx :{ *(.ARM.exidx*) }
__exidx_end = .;
.interp :{ *(.interp) }
. = ALIGN (CONSTANT (MAXPAGESIZE)) - ((CONSTANT (MAXPAGESIZE) - .)& (CONSTANT
(MAXPAGESIZE) - 1));
. = DATA_SEGMENT_ALIGN (CONSTANT (MAXPAGESIZE), CONSTANT (COMMONPAGESIZE));
.tdata :{ *(.tdata .tdata.*) }
.tbss :{ *(.tbss .tbss.*) }
.preinit_array :
{
PROVIDE_HIDDEN (__preinit_array_start = .);
KEEP (*(.preinit_array))
PROVIDE_HIDDEN (__preinit_array_end = .);
}
.init_array :
{
PROVIDE_HIDDEN (__init_array_start = .);
KEEP (*(SORT(.init_array.*)))
KEEP (*(.init_array))
PROVIDE_HIDDEN (__init_array_end = .);
}
.fini_array :
{
PROVIDE_HIDDEN (__fini_array_start = .);
KEEP (*(.fini_array))
KEEP (*(SORT(.fini_array.*)))
PROVIDE_HIDDEN (__fini_array_end = .);
}
.dynamic :{ *(.dynamic) }
.got :{ *(.got.plt) *(.got) }
.data :
{
*(.data .data.*)
}
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-16
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
.bss :
{
*(.bss .bss.*)
. = ALIGN(.!= 0 32 / 8 : 1);
}
}
9.8.1 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ) .
参 照
『リンカリファレンス』:
• --linker_script=ld_script (2-101 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-17
ID 111311
Non-Confidential

armlink における GNU ld スクリプトのサポート
9.9 ld --ldpartial オブジェ ク ト をリンクするための GNU ld スクリプトの 例
ld --ldpartial の 汎 用 形 式 では、 各 出 力 セ ク シ ョ ンが 0x0 に 割 り 当 て られます。 リ ンカ
は、 SECTIONS コマン ド の 命 令 を 常 に 実 行 でき るわけではあ り ません。 1 つの 出 力 セ ク
シ ョ ンに 結 合 さ れた 入 力 セ ク シ ョ ンは、 次 の リ ン ク で 削 除 で き ません。 次 リ ン ク で
セ ク シ ョ ン を 削 除 する 必 要 があ る こ と を リ ンカが 検 出 し た 場 合 、 セ ク シ ョ ンは 結 合
されません。 結 合 できないセクシ ョ ンは、 そのまま 力 オブジェ ク ト に 渡 されます。
SECTIONS
{
.init 0 :{ *(.init) }
.text 0 :{ *(.text) }
.fini 0 :{ *(.fini) }
.rodata 0 :{ *(.rodata) }
.data 0 :{ *(.data) }
.bss 0 :{ *(.bss) }
}
ld ス ク リ プ ト フ ァ イ ルを 指 定 する には、 armlink --linker_script コマンド ラインオプ
シ ョ ン を 使 用 し ます。
9.9.1 関 連 項 目
概 念
• GNU ld スクリプトのサポート と 制 限 について (9-2 ページ) .
参 照
『リンカリファレンス』:
• --ldpartial (2-95 ページ)
• --linker_script=ld_script (2-101 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 9-18
ID 111311
Non-Confidential

第 10 章
BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ
イル
以 下 の 各 ト ピ ッ ク では、 リ ン カ armlink によるベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ
ンバイナリ インタフェース (BPABI) と System V (SysV) の 共 有 ラ イ ブ ラ リ と 実 行 可 能
フ ァ イルのサポー ト の 仕 組 みについて 説 明 し ます。
概 念
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバイナ リ イ ン タ フ ェース (BPABI) につ
いて (10-3 ページ)
• BPABI がサポー ト しているプラ ッ ト フ ォーム (10-4 ページ)
• すべての BPABI モデルに 共 通 する 概 念 (10-5 ページ)
• BPABI モデルのシンボルのイ ンポー ト と エ ク スポー ト について (10-6 ページ)
• BPABI モデルのシンボルの 可 視 性 (10-7 ページ)
• BPABI モデルの 自 動 的 な イ ンポー ト と エ ク ス ポー ト (10-9 ページ)
• BPABI モデルの 手 動 のイ ンポー ト と エ ク スポー ト (10-10 ページ)
• BPABI モデルのシンボルバージ ョ ン 管 理 (10-11 ページ)
• BPABI モデルの RW 圧 縮 (10-12 ページ)
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• SysV メモリモデル (10-14 ページ)
• SysV メ モ リ モデルにおけ る ダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則 (10-15 ペー
ジ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-1
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
• SysV メモリモデルでのコマンドラインデフォルトへの 変 更 (10-20 ページ)
• ベア メ タルモデルと DLL 類 似 モデルの リ ンカオプシ ョ ン (10-21 ページ)
• ベア メ タルメ モ リ モデルと DLL 類 似 メ モ リ モデル (10-22 ページ)
• BPABI DLL 類 似 モデルでの 必 須 のシンボルバージ ョ ン 管 理 (10-23 ページ)
• BPABI DLL 類 似 モデルにおけ る ダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-24 ページ)
• BPABI DLL 類 似 モデルのア ド レ シングモー ド (10-25 ページ)
• BPABI DLL 類 似 モデルでの C++ の 初 期 化 (10-26 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ)
• シンボルバージ ョ ン 管 理 のスク リプト ファイル (10-28 ページ)
• バージ ョ ン 管 理 シンボルの 作 成 例 (10-29 ページ)
• 組 み 込 みシンボルについて (10-30 ページ)
• 暗 黙 のシンボルバージョン 管 理 を 有 効 にするリンカオプション (10-31 ページ)
.
参 照
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
• BPABI DLL 類 似 モデルに 関 連 する リ ン カ コ マン ド ラ イ ンオプシ ョ ン (10-32 ペー
ジ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-2
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.1 ベースプラ ッ ト フ ォームアプ リケーシ ョ ンバイナリ イン タ フ ェース (BPABI) につ
いて
多 くの 組 み 込 みシステムは、 オペレーティングシステムを 使 用 してデバイスのリ
ソース を 管 理 し ています。 ほ と んどの 場 合 、 こ れはアプ リ ケーシン と 緊 密 に 統 合 さ
れる リアルタイムオペレーティングシステム (RTOS) を 含 む 1 つの 大 容 量 実 行 可 能
ファイルです。 このほか、 さらに 複 雑 なオペレーテ ィ ングシステム (OS) はプラ ッ
トフォーム OS と 呼 ばれ、 ARM Linux などがその 例 です。 これらはアプリ ケーショ ン
や 共 有 ラ イブラ リ をオンデマン ドでロードする 機 能 を 備 えています。
プラッ ト フォーム OS でアプリ ケーシ ョ ンを 実 行 したり 共 有 ライブラ リ を 使 用 したり
するには、 プラ ッ ト フォームのアプ リ ケーシ ョ ンバイナ リ インタフェース (ABI) と
ARM アーキテクチャ 用 ABI に 準 拠 する 必 要 があ り ます。 こ れには、 カ ス タ ム フ ァ イ
ル 形 式 などの リ ンカの 出 力 の 大 幅 な 変 更 も 含 まれます。 このよ う なさ まざまなプ
ラットフォームをサポートするため、ARM アーキテクチャ 用 ABI にはベースプ ラ ッ
トフォームアプリケーションバイナリインタフェース (BPABI) が 用 意 されていま
す。
BPABI はプラ ッ ト フ ォーム ABI を 派 生 で き る 基 本 標 準 を 提 供 し ています。 リ ンカは、
BPABI に 準 拠 する ELF イ メージや 共 有 ライブラリを 生 成 します。ポスト リンカと 呼
ばれるプ ラ ッ ト フ ォーム 固 有 のツールは、 こ の ELF 出 力 フ ァ イルを、 プ ラ ッ ト
フ ォーム 固 有 のフ ァ イル 形 式 に 変 換 し ます。 ポ ス ト ン カ ツールはプ ラ ッ ト フ ォーム
OS ベンダから 提 供 されています。 以 下 の 図 は、 BPABI ツールの 流 れを 示 していま
す。
:
:
.c .o
.axf
bin/exe
ABI BPABI
図 10-1 BPABI ツールの 流 れ
10.1.1 関 連 項 目
概 念
• BPABI がサポー ト しているプラ ッ ト フ ォーム (10-4 ページ)
• すべての BPABI モデルに 共 通 する 概 念 (10-5 ページ) .
その 他 の 情 報
• 『Base Platform ABI for the ARM Architecture』 ,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0037-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-3
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.2 BPABI がサポー ト し ている プ ラ ッ ト フ ォーム
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) では、
共 有 ラ イ ブ ラ リ の 種 類 に よ って 次 の 3 通 りのプラッ トフォームモデルを 定 義 してい
ます。
ベア メ タル ベア メ タルモデルは、 オフ ラ インのダイナ ミ ッ ク ローダまたは 単 純 なモ
ジ ュールローダ 用 に 設 計 されています。 モジ ュール 間 の 参 照 は、 その 他
の 助 構 造 体 な し に 直 接 ローダに よ って 解 決 さ れます。
DLL 類 似 ダイナミ ック リンクライブラ リ (DLL) 類 似 モデルは、 ロード と ランタ
イ ムの 効 率 性 と 引 き 換 えに 動 的 ラ イ ブ ラ リ と 静 的 ラ イ ブ ラ リ の 間 の 透 過
性 を 犠 牲 にし ます。
SysV System V (SysV) モデルは 動 的 ライブラ リ と 静 的 ライブラ リの 間 の 違 い
をマスク します。 ARM Linux はこの 形 式 を 使 用 しています。
10.2.1 リンカの BPABI サポー ト
ARM リンカでは 3 種 類 の BPABI モデルすべてをサポー ト し てお り 、 オブジェ ク ト
フ ァ イ ル と ラ イ ブ ラ リ の コ レ ク シ ョ ン を 以 下 の 要 素 に リ ン ク で き ます。
• ベア メ タル 実 行 可 能 イ メ ージ
• BPABI DLL または SysV の 共 有 オブジェ ク ト
• BPABI または SysV の 実 行 可 能 フ ァ イル
10.2.2 リンカの ARM Linux サポー ト
リンカは、ARM Linux に 必 要 なデータ をすべて 備 えた SysV の 実 行 可 能 フ ァ イル と 共
有 ライブラ リ を 生 成 できます。 ただし、--shared オプシ ョ ンまたは --sysv オプシ ョ ン
だけでな く 、 他 のコマン ド ラ イ ンオプシ ョ ン と ラ イブラ リ も 指 定 する 必 要 があ り ま
す。
正 し い 入 力 オプシ ョ ン と ラ イ ブ ラ リ がすべて 指 定 さ れてい る 場 合 、 後 処 理 な し で
ELF ファイルを 使 用 できます。
10.2.3 関 連 項 目
タスク
『ARM ® コンパイラツールチェーンおよび GNU ライブラリでの Linux アプ リ ケーシ ョ
ンのビルド』 :
• 第 3 章 ARM コンパイラツールチェーンを 使 用 した Linux アプ リ ケーシ ョ ンまた
は Linux ライブラリのビルド .
概 念
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI)
について (10-3 ページ)
• すべての BPABI モデルに 共 通 する 概 念 (10-5 ページ) .
参 照
『リンカリファレンス』:
• --dll (2-49 ページ)
• --shared (2-148 ページ)
• --sysv (2-172 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-4
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.3 すべての BPABI モデルに 共 通 する 概 念
リ ンカ を 使 用 する と 、 ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバイ ナ リ イ ン タ
フェース (BPABI) の 共 有 ラ イ ブ ラ リ を ビル ド し、 共 有 ラ イ ブ ラ リ にオブジ ェ ク ト
をリンクできます。すべての BPABI モデルに 共 通 する 概 念 を 以 下 に 示 し ます
• シンボルのインポート
• シンボルのエクスポート
• バージ ョ ン 管 理
• シンボルの 可 視 性
10.3.1 関 連 項 目
概 念
• BPABI モデルのシンボルのイ ンポー ト と エ ク スポー ト について (10-6 ページ)
• BPABI モデルのシンボルの 可 視 性 (10-7 ページ)
• BPABI モデルの 自 動 的 な イ ンポー ト と エ ク スポー ト (10-9 ページ)
• BPABI モデルの 手 動 のイ ンポー ト と エ ク スポー ト (10-10 ページ)
• BPABI モデルのシンボルバージ ョ ン 管 理 (10-11 ページ)
• BPABI モデルの RW 圧 縮 (10-12 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-5
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.4 BPABI モデルのシンボルのイ ンポー ト と エ ク スポー ト について
従 来 の リ ン ク では、 必 要 な コー ド と データ をすべて 含 む 1 つの 実 行 可 能 フ ァ イルに
リンクするために、すべてのシンボルをリンク 時 に 定 義 する 必 要 がありました。ダ
イナミ ッ ク リ ンクをサポート しているプラ ッ ト フォームでは、 シンボルのバイン
デ ィ ングを ロード 時 か、 場 合 によ っては 実 行 まで 遅 らせる こ と ができ ます。 そのた
め、 アプ リ ケーシ ョ ン を 複 数 のモジ ュール ( 実 行 可 能 フ ァ イルま たは 共 有 ラ イ ブ ラ
リ ) に 分 割 で き ます。 現 在 のモジ ュール 以 外 のモジ ュールで 定 義 さ れてい る シンボ
ルはダ イナ ミ ッ ク シンボルテーブルに 配 置 さ れます。 ロー ド 時 ま たは 実 行 時 に 動 的
にリ ンクするのに 適 している 関 数 もダイナミ ッ クシンボルテーブルに 配 置 されます。
ダイナミ ックシンボルテーブルの 内 容 は、 次 の 2 通 りの 方 法 で 制 御 できます。
• ELF シンボルの 可 視 性 プ ロパテ ィ か ら 内 容 を 推 論 する 自 動 的 な 規 則
• ス テア リ ン グ フ ァ イルに 存 在 する 手 動 のデ ィ レ ク テ ィ ブ
これらの 規 則 は SysV モデルでは 若 干 異 な り ます。
10.4.1 関 連 項 目
概 念
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
• ベア メ タルモデルと DLL 類 似 モデルの リ ンカオプシ ョ ン (10-21 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ) .
その 他 の 情 報
• SysV ELF 仕 様 書
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-6
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.5 BPABI モデルのシンボルの 可 視 性
各 シンボルには、 コ ンパイ ラ ス イ ッチ、 ステア リ ングフ ァ イル、 またはソース コー
ド の 属 性 で 制 御 で き る 可 視 性 プ ロパテ ィ があ り ます。 シンボル 参 照 の 場 合 、 可 視 性
は、 リ ンカがそのシンボルの 定 義 に 使 用 で き る 定 義 を 制 御 し ます。 シンボルが 定 義
の 場 合 、 可 視 性 は、 そのシンボルが 現 在 モジ ュールの 外 か ら 見 え る かど う かを 制 御
します。
ELF 仕 様 では、 以 下 の 可 視 性 オプシ ョ ンが 定 義 さ れています。
可 視 性 参 照 定 義
表 10-1 シンボルの 可 視 性
STV_DEFAULT
STV_PROTECTED
STV_HIDDENSTV_INTERN
AL
シンボルは 共 有 オブジ ェ ク ト の 定 義 に
バインドできます。
シンボルはモジ ュール 内 で 解 決 する 必
要 があ り ます。
シンボルはモジ ュール 内 で 解 決 する 必
要 があ り ます。
シンボルはモジュールの 外 から 見 えるよ う
にで き ます。 別 のモジ ュールか ら の 定 義 に
よってダイナミ ック リンカでプリエンプ
ティブにできます。
シンボルはモジュールの 外 から 見 えるよ う
にで き ます。 別 のモジ ュールか ら の 定 義 に
よ って 実 行 時 にプ リ エンプテ ィ ブにで き ま
せん。
シンボルはモジュールの 外 からは 見 えませ
ん。
シンボルのプリエンプトは System V (SysV) シ ス テムで 最 も 一 般 的 です。 シンボル
のプ リ エンプ ト はベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバイナ リ イ ン タ フ ェー
ス (BPABI) のダイナミ ック リンクライブラ リ (DLL) 類 似 の 実 装 で 起 こるこ とがあ
り ます。 プラ ッ ト フ ォームのオーナーがこ の 動 作 を 定 義 し ます。 詳 細 については、
特 定 のプ ラ ッ ト フ ォームのニ ュ アルを 参 照 し て 下 さ い。
10.5.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ)
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
• ベア メ タルモデルと DLL 類 似 モデルの リ ンカオプシ ョ ン (10-21 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ) .
参 照
『リンカリファレンス』:
• --keep_protected_symbols (2-91 ページ)
• --max_visibility=type (2-112 ページ)
• --override_visibility (2-116 ページ)
• --use_definition_visibility (2-180 ページ)
• EXPORT (3-2 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-7
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
• IMPORT (3-5 ページ)
• REQUIRE (3-9 ページ) .
『コンパイ ラ リ ファレンス』 :
• --apcs=qualifer...qualifier (3-12 ページ)
• --dllexport_all、 --no_dllexport_all (3-84 ページ)
• --dllimport_runtime、 --no_dllimport_runtime (3-85 ページ)
• --hide_all、 --no_hide_all (3-120 ページ) .
『アセンブラ リ フ ァ レンス』 :
• EXPORT、 GLOBAL (6-80 ページ) .
その 他 の 情 報
• SysV ELF 仕 様 書
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-8
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.6 BPABI モデルの 自 動 的 な イ ンポー ト と エ ク スポー ト
リ ンカは 自 動 的 にシンボルを イ ンポー ト およびエ ク ス ポー ト で き ます。 こ の 動 作 は、
出 力 が 実 行 可 能 フ ァ イルま たは 共 有 ラ イ ブ ラ リ で、 プ ラ ッ ト ォームモデルが System V
(SysV) の 場 合 、 入 力 オブジ ェ ク ト フ ァ イル 内 のシンボルの 可 視 性 の 組 み 合 わせに 依
存 し ます。 こ れは、 使 用 し てい る リ ン ク モデルの 種 類 に よ って 異 な り ます。
10.6.1 関 連 項 目
概 念
• すべての BPABI モデルに 共 通 する 概 念 (10-5 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
• ベア メ タルモデルと DLL 類 似 モデルの リ ンカオプシ ョ ン (10-21 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ) .
その 他 の 情 報
• SysV ELF 仕 様 書
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-9
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.7 BPABI モデルの 手 動 のイ ンポー ト と エ ク スポー ト
リ ンカのス テア リ ング フ ァ イルを 使 用 し て、 以 下 の 操 作 を 実 行 で き ます。
• 動 的 な イ ンポー ト と エ ク ス ポー ト の 手 動 制 御
• 自 動 的 な 規 則 のオーバーラ イ ド
ダ イナ ミ ッ ク シンボルテーブルの 内 容 を 制 御 する と き に 使 用 で き る ス テア リ ング
ファイルコマンドを 以 下 に 示 します。
• EXPORT
• IMPORT
• REQUIRE
10.7.1 関 連 項 目
概 念
• ステアリ ングファイルとは (7-24 ページ) .
参 照
『リンカリファレンス』:
• EXPORT (3-2 ページ)
• IMPORT (3-5 ページ)
• REQUIRE (3-9 ページ) .
その 他 の 情 報
• SysV ELF 仕 様 書
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-10
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.8 BPABI モデルのシンボルバージ ョ ン 管 理
シンボルバージ ョ ン 管 理 は、 共 有 ライブラ リのインタフェースを 厳 密 に 制 御 する 方
法 です。
バージ ョ ン 管 理 されているシンボルのある 共 有 ラ イブラ リ からシンボルがイ ンポー
トされると、armlink はシンボルの 最 新 の (デフォル ト ) バージ ョ ンにバイン ド し ま
す。 プ ラ ッ ト フ ォーム OS がシンボルのバージ ョ ンを 解 決 する ロード 時 または 実 行 に
は、 さ ら に 新 し いバージ ョ ンが 使 用 可 能 な 場 合 で も、 常 に armlink によって 選 択 され
たバージ ョ ンに 解 決 さ れます。 こ のプ ロ セ スは 自 動 です。
シンボルを 実 行 可 能 フ ァ イルま たは 共 有 ラ イ ブ ラ リ か ら エ ク ス ポー ト する と き に、
バージ ョ ン を 指 定 で き ます。 armlink では、 バージ ョ ンが 共 有 オブジェ ク ト 名
(--soname で 設 定 ) か ら 派 生 する 暗 黙 的 なシンボルバージ ョ ン 管 理 、 ま たはバージ ョ
ンの 正 確 な 定 義 にス ク リ プ ト が 使 用 さ れる 明 示 的 なシンボルバージ ョ ン 管 理 をサ
ポー ト しています。
10.8.1 関 連 項 目
概 念
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• シンボルバージ ョ ン 管 理 について (10-27 ページ) .
参 照
『リンカリファレンス』:
• --soname=name (2-153 ページ) .
その 他 の 情 報
• SysV ELF 仕 様 書
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-11
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.9 BPABI モデルの RW 圧 縮
圧 縮 さ れた RW データ 用 のデコ ンプレ ッ サは、 ARM C ラ イ ブ ラ リ の 起 動 コー ド に 緊
密 に 統 合 されています。 プラ ッ ト フ ォーム OS でアプ リ ケーシ ョ ン 実 行 する 場 合 は、
この 機 能 をプラッ ト フォームまたはプラッ ト フォームライブラ リで 提 供 する 必 要 が
あります。 したがって、ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバイナ リ イ ン タ
フェース (BPABI) ファイルまたは System V (SysV) ファイルのリ ンク 時 は、 デコン
プレッサがないため、 RW 圧 縮 は 無 効 になっています。 圧 縮 を 再 度 有 効 にする こ と は
できません。
10.9.1 関 連 項 目
概 念
• RW データ 圧 縮 を 使 用 した 最 適 化 (5-16 ページ) .
その 他 の 情 報
• SysV ELF 仕 様 書
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-12
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.10 SysV モデルのリ ンカオプシ ョ ン
リ ンカ を 使 用 する と 、 System V (SysV) の 共 有 ライブラリをビルドおよびリンクし、
SysV の 実 行 可 能 フ ァ イルを 作 成 でき ます。 以 下 の 表 には、 SysV メモリモデルに 関 連
するコマンド ラ インオプシ ョ ンを 示 しています。
表 10-2 SysV サポー ト の 有 効 化
コマンドラインオプ
ション
--arm_linux
--sysv
--sysv --shared
説 明
これは、--sysv を 指 定 したこ
とになります。
SysV の 実 行 可 能 フ ァ イルを
生 成 し ます。
SysV の 共 有 ラ イブラ リ を 生
成 します。
10.10.1 関 連 項 目
概 念
• SysV メモリモデル (10-14 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
.
参 照
『リンカリファレンス』:
• --fpic (2-74 ページ)
• --import_unresolved、 --no_import_unresolved (2-79 ページ)
• --shared (2-148 ページ)
• --sysv (2-172 ページ) .
『コンパイ ラ リ ファレンス』 :
• --apcs=qualifer...qualifier (3-12 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-13
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.11 SysV メモリモデル
System V (SysV) ファイルには、 一 般 的 な ELF 仕 様 に 記 述 さ れてい る 標 準 メ モ リ モ
デルが 含 まれています。 SysV 形 式 を 使 用 するプラ ッ ト フォームオペレーテングシス
テムは 複 数 あり ます ( 例 えば ARM Linux)。
SysV メモリモデルは 標 準 メモリモデルであるため、 設 定 オプションがありません。
リ ンカは、 コ マン ド ラ イ ンで 指 定 する ス キ ャ ッ タ フ ァ イルを 無 視 し、 一 般 的 な ELF
仕 様 に よ っ て 定 義 さ れた 標 準 メ モ リ マ ッ プを 使 用 し ます。
10.11.1 関 連 項 目
概 念
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
その 他 の 情 報
• ELF for the ARM Architecture, http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-14
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.12 SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
System V (SysV) メ モ リ モデルには、 以 下 の 規 則 が 適 用 さ れます。
実 行 可 能 フ ァ イル 未 定 義 のシンボル 参 照 は 未 定 義 のシンボルエ ラーです。
可 視 性 が STV_HIDDEN または STV_INTERNAL のグローバルシンボルは、 ダイ
ナミックシンボルテーブルにエクスポートされません。
可 視 性 が STV_PROTECTED または STV_DEFAULT のグローバルシンボルは、
--export_all オプシ ョ ンまたは --export_dynamic オプシ ョ ン を 指 定 し ない
限 り、 ダイナミ ックシンボルテーブルにエクスポート されません。
共 有 ラ イ ブ ラ リ
可 視 性 が STV_DEFAULT の 未 定 義 のシンボル 参 照 は イ ンポー ト さ れた と 見 な
さ れ、 ダ イ ナ ミ ッ ク シンボルテーブルに 配 置 さ れます。
可 視 性 が STV_DEFAULT ではない 未 定 義 のシンボル 参 照 は、 未 定 義 のシンボ
ルエラーです。
可 視 性 が STV_HIDDEN または STV_INTERNAL のグローバルシンボルは、 ダイ
ナミックシンボルテーブルにエクスポートされません。
注
再 配 置 が 必 要 な STV_HIDDEN または STV_INTERNAL グローバルシンボルはダ
イナミ ッ クシンボルテーブルに 配 置 できますが、 リ ンカによってローカ
ルシンボルに 変 更 さ れて、 共 有 ラ イ ブ ラ リ 外 か ら ア ク セ ス で き な く な り
ます。
可 視 性 が STV_PROTECTED または STV_DEFAULT のグローバルシンボルは、 常 に
ダイナミ ックシンボルテーブルにエクスポート されます。
10.12.1 glibc との 互 換 性 を 確 保 するために 定 義 されるシンボル 定 義
SysV と glibc と の 互 換 性 を 向 上 させる ために、 対 応 する セ ク シ ョ ンがオブジ ェ ク ト
内 に 存 在 する 場 合 は、 リ ン カに よ って 以 下 のシンボルが 定 義 さ れます。
• .init_array セ ク シ ョ ンの 場 合 :
— __init_array_start
— __init_array_end
• .fini_array セ ク シ ョ ンの 場 合 :
— __fini_array_start
— __fini_array_end
• ARM.exidx セクションの 場 合 :
— __exidx_start
— __exidx_end
• .preinit_array セ ク シ ョ ンの 場 合 :
— __preinit_array_start
— __preinit_array_end
• __executable_start
• etext
• _etext
• __etext
• __data_start
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-15
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
• edata
• _edata
• __bss_start
• __bss_start__
• _bss_end__
• __bss_end__
• end
• _end
• __end
• __end__
10.12.2 関 連 項 目
概 念
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード (10-17 ページ)
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
.
参 照
• --export_all、 --no_export_all (2-64 ページ)
• --export_dynamic、 --no_export_dynamic (2-65 ページ)
• --keep_protected_symbols (2-91 ページ) .
その 他 の 情 報
• ELF for the ARM Architecture, http://infocenter.arm.com/help/topic/com.arm.doc.ihi0044-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-16
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.13 SysV メモリモデルのアドレシングモード
System V (SysV) には、 プログラムおよび 他 のモデルからインポート されたデータや
コード にア ク セスする ためのモデルが 定 義 されています。 必 要 に 応 じ て、 リ ンカは
必 要 なプロシージャ リ ンクテーブル (PLT) セクシ ョ ンとグローバルオフセッ トテー
ブル (GOT) セ ク シ ョ ン を 自 動 生 成 し ます。
10.13.1 位 置 非 依 存 コー ド
SysV 共 有 ラ イ ブ ラ リ は、 --apcs=/fpic コンパイラコマンドラインオプションを 使 用 し
て、 位 置 非 依 存 コー ド で コ ンパ イル さ れます。
共 有 ラ イ ブ ラ リ が 位 置 非 依 存 であ る こ と を 宣 言 する 場 合 は、 PLT セクションと GOT
セクションの 構 造 に 影 響 するため、 リンカコマンドラインオプシン --fpic も 使 用 す
る 必 要 があ り ます。
注
デフォル ト では、 コマン ド ラ インオプシ ョ ン --shared を --fpic オプシ ョ ンなしで 指 定
する と 、 リ ン カでエ ラー メ ッ セージが 生 成 さ れます。 位 置 依 存 の 共 有 ラ イ ブ ラ リ を
作 成 する 場 合 は、 --diag_suppress=6403 を 使 用 してエラーメ ッセージをオフにできま
す。
10.13.2 関 連 項 目
概 念
• SysV モデルの リ ンカオプシ ョ ン (10-13 ページ)
• SysV メ モ リ モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-15 ページ)
• SysV メモリモデルのアドレシングモード
• SysV メモリモデルのスレッドローカルストレージ (10-18 ページ)
• SysV メモリモデルに 関 連 するリンカコマンドラインオプション (10-19 ページ)
.
参 照
『リンカリファレンス』:
• --diag_suppress=tag[,tag,...] (2-47 ページ)
• --fpic (2-74 ページ)
• --import_unresolved、 --no_import_unresolved (2-79 ページ)
• --shared (2-148 ページ) .
『コンパイ ラ リ ファレンス』 :
• --apcs=qualifer...qualifier (3-12 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-17
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.14 SysV メ モ リ モデルのスレ ッ ド ローカルス ト レージ
リンカでは、『Addenda to, and Errata in, the ABI for the ARM Architecture』 に 記 述 されて
いる ARM Linux スレ ッ ド ローカルス ト レージモデルをサポー ト しています。
10.14.1 関 連 項 目
その 他 の 情 報
• Addenda to, and Errata in, the ABI for the ARM Architecture (ABI-addenda) ,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0045-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-18
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.15 SysV メモリモデルに 関 連 するリンカコマンドラインオプション
以 下 の リ ン カ コ マン ド ラ イ ンオプシ ョ ンが SysV メモリモデルに 関 連 しています。
参 照
『リンカリファレンス』:
• --arm_linux (2-13 ページ)
• --dynamic_debug (2-50 ページ)
• --dynamic_linker=name (2-51 ページ)
• --export_all、 --no_export_all (2-64 ページ)
• --export_dynamic、 --no_export_dynamic (2-65 ページ)
• --fpic (2-74 ページ)
• --import_unresolved、 --no_import_unresolved (2-79 ページ)
• --linux_abitag=version_id (2-102 ページ)
• --runpath=pathlist (2-140 ページ)
• --shared (2-148 ページ)
• --sysv (2-172 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-19
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.16 SysV メ モ リ モデルでのコ マン ド ラ イ ンデフ ォル ト への 変 更
ARM コンパイラツールチェーンでは、 C および C++ のシ ス テム ラ イ ブ ラ リ を 含 む 共
有 ライブラ リ を 提 供 していません。 System V (SysV) のサポートで 想 定 される 使 用 モ
デルは、 プ ラ ッ ト フ ォームに 付 属 する シ ス テム ラ イ ブ ラ リ の 使 用 です。 例 えば、
ARM Linux では、 これは libc.so です。
libc.so を 使 用 する ために、 リ ンカではデフ ォル ト の 動 作 に 以 下 の 変 更 を 適 用 し ます。
• --arm_linux を 使 用 する と 、 ARM Linux に 必 要 なデフ ォル ト オプシ ョ ンが 設 定 さ
れます。
• --no_ref_cpp_init を 設 定 して ARM C++ 初 期 化 コー ド が 含 まれない よ う に し ま
す。
• リンカが 必 要 なシンボルを 定 義 して libc.so と の 互 換 性 を 確 保 し ます。
• --force_so_throw を 設 定 し て、 リ ンカに 例 外 テーブルを 保 持 させます。
10.16.1 関 連 項 目
参 照
『リンカリファレンス』:
• --arm_linux (2-13 ページ)
• --force_so_throw、 --no_force_so_throw (2-73 ページ)
• --ref_cpp_init、 --no_ref_cpp_init (2-132 ページ)
• --sysv (2-172 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-20
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.17 ベアメ タルモデルと DLL 類 似 モデルのリ ン カオプシ ョ ン
プラッ ト フォーム OS のベア メ タル 実 行 可 能 フ ァ イルおよびダイナミ ック リンクライ
ブラ リ (DLL) 類 似 モデルをビルドするには、 以 下 のコマンド ラインオプシ ョ ンを
使 用 し ます。
表 10-3 BPABI サポー ト の 有 効 化
コマンドラインオプ
ション
--base_platform
--bpabi
--bpabi --dll
説 明
ベースプ ラ ッ ト フ ォーム ABI (BPABI) と 共 にス
キ ャ ッ タ ロー ド を 使 用 し ます。
BPABI の 実 行 可 能 フ ァ イルを 生 成 し ます。
BPABI の DLL を 生 成 します。
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) に 基
づいた、 特 定 のプラ ッ ト フ ォーム OS のアプ リ ケーシ ョ ンや DLL を 開 発 している 場
合 、 プ ラ ッ ト フ ォームのマニ ュ アル と 併 せて 以 下 の 報 を 使 用 する 必 要 があ り ます。
• ベア メ タルメ モ リ モデルと DLL 類 似 メ モ リ モデル
• BPABI DLL 類 似 モデルでの 必 須 のシンボルバージ ョ ン 管 理
• BPABI DLL 類 似 モデルにおけ る ダ イ ナ ミ ッ ク シンボルテーブルの 自 動 規 則
• BPABI DLL 類 似 モデルのア ド レシングモード
• BPABI DLL 類 似 モデルでの C++ の 初 期 化
プラッ ト フォーム OS を 実 装 している 場 合 は、 BPABI 仕 様 と 併 せて こ の 情 報 を 使 用 す
る 必 要 があ り ます。
10.17.1 関 連 項 目
概 念
• ベア メ タルメ モ リ モデルと DLL 類 似 メ モ リ モデル (10-22 ページ)
• BPABI DLL 類 似 モデルでの 必 須 のシンボルバージ ョ ン 管 理 (10-23 ページ)
• BPABI DLL 類 似 モデルにおけ る ダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-24 ページ)
• BPABI DLL 類 似 モデルのア ド レ シングモー ド (10-25 ページ)
• BPABI DLL 類 似 モデルでの C++ の 初 期 化 (10-26 ページ)
• BPABI DLL 類 似 モデルに 関 連 する リ ン カ コ マン ド ラ イ ンオプシ ョ ン (10-32 ペー
ジ) .
参 照
• --base_platform (2-18 ページ)
• --bpabi (2-24 ページ)
• --dll (2-49 ページ) .
その 他 の 情 報
• Base Platform ABI for the ARM Architecture,
http://infocenter.arm.com/help/topic/com.arm.doc.ihi0037-/index.html
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-21
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.18 ベアメ タルメモリモデルと DLL 類 似 メ モ リ モデル
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) ファ
イルには、 BPABI 仕 様 に 記 述 さ れてい る 標 準 メ モ リ モデルが 含 まれています。
--bpabi コ マン ド ラ イ ンオプシ ョ ン を 使 用 する と 、 リ ンカは こ のモデルを 自 動 的 に 適
用 し、 コマンド ラインで 指 定 されたスキャ ッ タファ イルをすべて 無 視 します。 これ
は 次 のイ メ ージレ イ ア ウ ト に 相 当 し ます。
LR_1
{
ER_RO +0
{
*(+RO)
}
}
LR_2
{
ER_RW +0
{
*(+RW)
}
ER_ZI +0
{
*(+ZI)
}
}
10.18.1 メモリモデルのカスタマイズ
オプシ ョ ン --ropi を 指 定 する と、LR_1 は 位 置 非 依 存 と し てマーク さ れます。 それ と 同
様 に、 オプシ ョ ン --rwpi を 指 定 する と、 LR_2 は 位 置 非 依 存 と し てマー ク さ れます。
注
デフォル ト 値 の 0x8000 と 0 がプラ ッ ト フォームに 適 さない 可 能 性 があるので、 ほと ん
どの 場 合 は、 それぞれに --ro_base スイッチと --rw_base スイッチを 指 定 する 必 要 があ
り ます。 こ れら のア ド レ スは、 イ メ ージが 実 行 時 に 再 配 置 さ れる ア ド レ ス を 反 映 し
ている 必 要 はあ り ません。
よ り 複 雑 な メ モ リ レ イ ア ウ ト が 必 要 な 場 合 は、 ベースプ ラ ッ ト フ ォーム リ ン ク モデ
ル --base_platform を 使 用 し ます。
10.18.2 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ) .
参 照
『リンカリファレンス』:
• --base_platform (2-18 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• --rosplit (2-139 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-22
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.19 BPABI DLL 類 似 モデルでの 必 須 のシンボルバージ ョ ン 管 理
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) DLL
類 似 モデルでは、 静 的 なバイ ンデ ィ ングが 必 要 です。 こ れは、 ポ ス ト リ ンカが
BPABI の DLL 内 のシンボ リ ッ ク 情 報 を 変 換 し て、 序 数 のイデク スが 付 いている テー
ブルを イ ンポー ト ま たはエ ク ス ポー ト する 可 能 性 があ る か ら です。 その 場 合 、 実 行
時 にシンボルを 検 索 する こ と は 不 可 です。
シンボルバージ ョ ン 管 理 の 使 用 によって BPABI で 静 的 バイ ンデ ィ ングが 実 行 されま
す。 BPABI ファイルのデフォルトでは、 コマンドラインオプション --symver_soname
はオンになっています。 つま り 、 エク スポー ト されたシンボルはすべて、 DLL の 名
前 に 基 づいてバージ ョ ンが 与 え られます。
10.19.1 関 連 項 目
概 念
• シンボルバージ ョ ン 管 理 について (10-27 ページ) .
参 照
『リンカリファレンス』:
• --soname=name (2-153 ページ)
• --symver_script=file (2-169 ページ)
• --symver_soname (2-170 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-23
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.20 BPABI DLL 類 似 モデルにおけるダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI) DLL
類 似 モデルには、 以 下 の 規 則 が 適 用 さ れます。
実 行 可 能 フ ァ イル 未 定 義 のシンボル 参 照 は 未 定 義 のシンボルエ ラーです。
可 視 性 が STV_HIDDEN または STV_INTERNAL のグローバルシンボルは、 ダイ
ナミックシンボルテーブルにエクスポートされません。
可 視 性 が STV_PROTECTED または STV_DEFAULT のグローバルシンボルは、
--export_all オプシ ョ ンまたは --export_dynamic オプシ ョ ン を 設 定 し ない
限 り、 ダイナミ ックシンボルテーブルにエクスポート されません。
DLL
未 定 義 のシンボル 参 照 は 未 定 義 のシンボルエ ラーです。
可 視 性 が STV_HIDDEN または STV_INTERNAL のグローバルシンボルは、 ダイ
ナミックシンボルテーブルにエクスポートされません。
注
再 配 置 が 必 要 な STV_HIDDEN または STV_INTERNAL グローバルシンボルはダ
イナミ ッ クシンボルテーブルに 配 置 できますが、 リ ンカによってローカ
ルシンボルに 変 更 さ れて、 共 有 ラ イ ブ ラ リ 外 か ら ア ク セ ス で き な く な り
ます。
可 視 性 が STV_PROTECTED または STV_DEFAULT のグローバルシンボルは、 常 に
ダイナミ ックシンボルテーブルにエクスポート されます。
シンボルは、EXPORT ステアリングファイルコマンドおよび IMPORT ステアリングファイ
ルコ マン ド を 使 用 し て、 手 動 でエ ク ス ポー ト およびイ ンポー ト で き ます。 ス テア リ
ングファイルコマンドを 指 定 するには、--edit コマンド ラインオプショ ンを 使 用 しま
す。
10.20.1 関 連 項 目
概 念
• ステアリ ングファイルとは (7-24 ページ)
参 照
• ステアリ ングファイルコマンドの 概 要 (7-26 ページ)
• ステアリ ングファイルの 形 式 (7-27 ページ) .
『リンカリファレンス』:
• --edit=file_list (2-53 ページ)
• --export_all、 --no_export_all (2-64 ページ)
• --export_dynamic、 --no_export_dynamic (2-65 ページ)
• --keep_protected_symbols (2-91 ページ)
• EXPORT (3-2 ページ)
• IMPORT (3-5 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-24
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.21 BPABI DLL 類 似 モデルのア ド レシングモー ド
ベア メ タルモデルとベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ
フェース (BPABI) DLL 類 似 モデル と の 主 な 違 いは、 イ ンポー ト し た 自 分 のプ ロ グ
ラ ム コー ド と データへのア ク セ スに 使 用 さ れる ア ド レ シングモー ド です。 BPABI 仕
様 のカテゴ リ に 対 応 する 次 の 4 つのオプシ ョ ンがあ り ます。
• なし
• 直 接 参 照
• 間 接 参 照
• 相 対 静 的 ベース ア ド レ ス 参 照
必 要 なア ド レ シングモー ド の 選 択 は、 以 下 の コ マン ド ラ イ ンオプシ ョ ンで 制 御 さ れ
ます。
• --pltgot
• --pltgot_opts
10.21.1 関 連 項 目
参 照
『リンカリファレンス』:
• --pltgot=type (2-122 ページ)
• --pltgot_opts=mode (2-124 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-25
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.22 BPABI DLL 類 似 モデルでの C++ の 初 期 化
ダイナミ ック リンクライブラ リ (DLL) では、 初 期 化 を 実 行 する イ ニシ ャ ラ イ ザ 関
数 への 参 照 を 含 むテーブルを 使 用 し た、 静 的 コ ン ス ト ラ ク タ の 初 期 化 をサポー ト し
ています。 そテーブルは、 SHT_INIT_ARRAY という 特 殊 なセクションタイプの ELF セク
シ ョ ンに 保 存 さ れます。 こ れら の 各 イ ニシ ャ ラ イ ザには、 初 期 化 を 実 行 する 関 数 へ
のタイプ R_ARM_TARGET1 の 再 配 置 が 含 まれています。
ELF アプ リ ケーシ ョ ンバイナリ インタフェース (ABI) 仕 様 では、 R_ARM_TARGET1 を 相
対 形 式 ま たは 絶 対 形 式 と し て 記 述 し ています。
ARM C ラ イ ブ ラ リ は 相 対 形 式 を 使 用 し ます。 例 えば、 リ ンカでは、 ARM C ライブラ
リの 定 義 __cpp_initialize__aeabi を 検 出 した 場 合 は、 R_ARM_TARGET1 の 相 対 形 式 を 使 用
し、 そ う でない 場 合 は 絶 対 形 式 を 使 用 し ます。
10.22.1 関 連 項 目
概 念
• ベア メ タルモデルと DLL 類 似 モデルの リ ンカオプシ ョ ン (10-21 ページ)
• ベア メ タルメ モ リ モデルと DLL 類 似 メ モ リ モデル (10-22 ページ)
• BPABI DLL 類 似 モデルでの 必 須 のシンボルバージ ョ ン 管 理 (10-23 ページ)
• BPABI DLL 類 似 モデルにおけ る ダ イナ ミ ッ ク シンボルテーブルの 自 動 規 則
(10-24 ページ)
• BPABI DLL 類 似 モデルのア ド レ シングモー ド (10-25 ページ)
• BPABI DLL 類 似 モデルに 関 連 する リ ン カ コ マン ド ラ イ ンオプシ ョ ン (10-32 ペー
ジ) .
『ARM ® C および C++ ラ イ ブ ラ リ と 浮 動 小 数 点 サポー ト の 使 用 』 :
• 実 行 環 境 の 初 期 化 と アプ リ ケーシ ョ ンの 実 行 (2-61 ページ)
• C++ の 初 期 化 、 構 築 、 および 破 棄 (2-62 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-26
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.23 シンボルバージョ ン 管 理 について
シンボルのバージ ョ ン 管 理 では、 シンボルのイ ンポー ト 元 およびエク スポー ト 先 の
動 的 な 共 有 オブジ ェ ク ト に 関 する 追 加 情 報 を 記 録 し ます。 ダ イ ミ ッ ク ローダでは、
こ の 追 加 情 報 を 使 用 し て、 イ メ ージで 必 要 なすべてのシンボルが ロー ド 時 に 利 用 可
能 にな る よ う にし ます。
共 有 オブジ ェ ク ト の 作 成 者 は、 シンボルのバージ ョ ン を 管 理 する こ と で、 すべての
新 し い ク ラ イ アン ト が 使 用 で き る 新 し いバージ ョ ンのシンボル 作 成 する と 同 時 に、
古 いバージ ョ ンの 共 有 オブジ ェ ク ト に リ ン ク する ク ラ イ アン ト と の 互 換 性 を 維 持 す
ることができます。
10.23.1 バージ ョ ン
シンボルのバージ ョ ン 管 理 によ り 、 ダイナ ミ ッ ク シンボルテーブルにバージ ョ ン と
い う 概 念 が 追 加 さ れます。 バージ ョ ン と は、 シンボルに 関 連 付 け られる 名 前 です。
ダ イナ ミ ッ ク ローダでは、 バージ ョ ン 名 に 関 連 付 け られたシンボル 参 照 を 解 決 する
際 、 同 じバージ ョ ン 名 のシンボル 定 義 に 対 してのみマッチングを 行 う こ とができま
す。
注
共 有 オブジェ ク ト の リ ビジ ョ ン 履 歴 を 示 すために、 バージ ョ ンを 以 前 のバージ ョ ン
名 に 関 連 付 け る こ と ができ ます。
10.23.2 デフォルトのバージョ ン
共 有 オブジ ェ ク ト に 同 じ シンボルの 複 数 のバージ ョ ン を 含 め る こ と はで き ますが、
共 有 オブジ ェ ク ト の ク ラ イ ア ン ト は 最 新 バージ ョ ンに し かバ イ ド で き ません。
このバインドできる 最 新 バージョ ンを、 シンボルのデフォル ト のバージ ョ ン と 呼 び
ます。
10.23.3 バージ ョ ン 管 理 シンボルの 作 成
デフォル ト では、 リ ンカはベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン
タフェース (BPABI) に 準 拠 していない 共 有 オブジェク トにバージ ョ ン 管 理 シンボ
ルを 作 成 しません。
10.23.4 関 連 項 目
参 照
• シンボルバージ ョ ン 管 理 のスク リプト ファイル (10-28 ページ) .
『fromelf イ メ ージ 変 換 ユーテ ィ リ テ ィ の 使 用 』 :
• --symbolversions、 --no_symbolversions (4-75 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-27
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.24 シンボルバージ ョ ン 管 理 のス ク リ プ ト フ ァ イル
シンボルバージョンを 作 成 するコマンドを、 コマンドラインオプション
--symver_script=file で 指 定 さ れた ス ク リ プ ト フ ァ イルに 組 み 込 むこ と がで き ます。 こ
のオプシ ョ ン を 使 用 する と 、 自 動 的 にシンボルバージ ョ ン 管 理 が 有 効 にな り ます。
スクリプトファイルでは、 GNU ld リンカと 同 じ 構 文 をサポートしています。
ス ク リ プ ト フ ァ イルを 使 用 する こ と で、 バージ ョ ン を 以 前 のバージ ョ ンに 関 連 付 け
ることができます。
ス テア リ ン グ フ ァ イル と 組 み 込 みシンボル 方 式 は 組 み 合 わせて 指 定 で き ます。 こ れ
を 行 う 場 合 は、 ス ク リ プ ト フ ァ イル と 組 み 込 みシンボルを 一 致 せ、 以 下 の よ う に
バッカスナウア 記 法 (BNF) の 表 記 を 使 用 する 必 要 があ り ます。
version_definition ::=
version_name "{" symbol_association* "}" [depend_version] ";"
version_name は、 バージ ョ ン 名 を 含 んでいる 文 字 列 です。 depend_version は、 こ の
version_name が 依 存 するバージ ョ ンの 名 前 を 含 んでい る 文 字 列 です。 こ のバージ ョ ン
は、 ス ク リ プ ト フ ァ イル 内 で 事 前 に 定 義 されている 必 要 があ り ます。 バージ ョ ン 名
は 重 要 ではあ り ませんが、 以 下 の よ う に 読 みやすい 名 前 を 付 け る と 便 利 です。
symbol_association ::=
"local:"| "global:"| symbol_name ";"
各 パラ メ ータには 以 下 の 意 味 があ り ます。
• "local:" は、 こ のバージ ョ ン 定 義 で これに 続 く すべての symbol_name が 共 有 オブ
ジェク トに 対 してローカルであり、 バージョン 管 理 されないこ とを 示 します。
• "global:" は、 これに 続 く すべての symbol_name がこのバージョン 定 義 に 属 するこ
とを 示 します。
各 バージ ョ ン 定 義 の 始 めには、 暗 黙 の "global:" が 存 在 し ます。
• symbol_name は、 静 的 シンボルテーブル 内 のグ ローバルシンボルの 名 前 です。
注
ス ク リ プ ト フ ァ イルを 使 用 する 場 合 は、 バージ ョ ン 定 義 と そのバージ ョ ン 定 義 に 関
連 付 け ら れる シンボルが 一 致 する 必 要 があ り ます。 不 一 致 が 見 かっ た 場 合 は、 リ ン
カか ら 警 告 が 生 成 さ れます。
10.24.1 関 連 項 目
概 念
• シンボルバージ ョ ン 管 理 について (10-27 ページ)
• バージ ョ ン 管 理 シンボルの 作 成 例 (10-29 ページ)
• 暗 黙 のシンボルバージョン 管 理 を 有 効 にするリンカオプション (10-31 ページ)
.
参 照
『リンカリファレンス』:
• --symver_script=file (2-169 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-28
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.25 バージ ョ ン 管 理 シンボルの 作 成 例
以 下 の 例 では、 シンボル foo@ver1、 foo@@ver2、 および bar@@ver1 をオブジェク ト シンボ
ルテーブルに 配 置 し ます。
例 10-1 バージ ョ ン 管 理 シンボルの 作 成 、 組 み 込 みシンボル
int old_function(void) __asm__("foo@ver1");
int new_function(void) __asm__("foo@@ver2");
int other_function(void) __asm__("bar@@ver1");
ver2 が ver1 に 依 存 する 追 加 の 依 存 関 係 情 報 を 含 む、 対 応 する ス ク リ プ ト フ ァ イルを
以 下 に 示 し ます。
例 10-2 バージ ョ ン 管 理 シンボルの 作 成 、 ス ク リ プ ト フ ァ イル
ver1
{
global:
foo; bar;
local:
*;
};
ver2
{
global:
foo;
} ver1;
10.25.1 関 連 項 目
概 念
• シンボルバージ ョ ン 管 理 について (10-27 ページ)
• 暗 黙 のシンボルバージョン 管 理 を 有 効 にするリンカオプション (10-31 ページ)
.
参 照
『リンカリファレンス』:
• --symver_script=file (2-169 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-29
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.26 組 み 込 みシンボルについて
リ ンカによ ってシンボルバージ ョ ンが 作 成 される よ う にする 特 定 の 名 前 付 き シンボ
ルを 入 力 オブジ ェ ク ト に 追 加 で き ます。 追 加 で き る シンボルは 以 下 の よ う な 形 式 に
なります。
• name@version (デフ ォル ト 以 外 のバージ ョ ンのシンボルの 場 合 )
• name@@version (デフ ォル ト のバージ ョ ンのシンボルの 場 合 )
こ の よ う なシンボルは、 エ ク ス ポー ト を 考 えてい る 関 数 やデータ のア ド レ スで 定 義
する 必 要 があ り ます。 シンボル 名 は、 シンボル 名 部 分 (name) と バージ ョ ン 定 義 部 分
(version) の 2 つの 部 分 か ら 構 成 さ れます。 name はダイナ ミ ッ クシンボルテーブルに
追 加 さ れ、 共 有 オブジ ェ ク ト の イ ン タ フ ェースの 一 部 にな り ます。 ver がまだ 存 在 し
ない 場 合 は、 その 名 前 のバージ ョ ン を 作 成 し、 name を ver という 名 前 のバージョンに
関 連 付 け ます。
以 下 の 例 では、 シンボル foo@ver1、 foo@@ver2、 および bar@@ver1 をオブジェク ト シンボ
ルテーブルに 配 置 し ます。
例 10-3 バージ ョ ン 管 理 シンボルの 作 成 、 組 み 込 みシンボル
int old_function(void) __asm__("foo@ver1");
int new_function(void) __asm__("foo@@ver2");
int other_function(void) __asm__("bar@@ver1");
リ ンカでは こ れら のシンボルを 読 み 出 し、 バージ ョ ン 定 義 ver1 と ver2 を 作 成 し ます。
シンボル foo はデフ ォル ト のバージ ョ ン 以 外 の ver1 とデフォルトのバージョンの ver2
に 関 連 付 け ら れます。 シンボル bar はデフ ォル ト のバージ ョ ンの ver1 に 関 連 付 け ら れ
ます。
こ の 方 法 では、 複 数 のバージ ョ ン 間 の 関 連 付 けを 作 成 する こ と はで き ません。
10.26.1 関 連 項 目
参 照
『コンパイ ラの 使 用 』 :
• シンボルバージ ョ ンに 対 するコンパイラおよびリ ンカサポートの 使 用
(5-32 ページ) .
『アセンブラの 使 用 』 :
• 第 5 章 ARM アセンブ リ 言 語 の 記 述 .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-30
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.27 暗 黙 のシンボルバージ ョ ン 管 理 を 有 効 にする リ ン カオプシ ョ ン
静 的 バ イ ンデ ィ ン グ を 行 う ためにシンボルのバージ ョ ン 管 理 を 行 う 必 要 があ る が、
指 定 さ れるバージ ョ ン 番 号 に 注 意 を 払 う 必 要 はない 場 合 は、 暗 のシンボルバージ ョ
ン 管 理 を 使 用 でき ます。
コマンド ラインオプショ ン --symver_soname を 使 用 する と、 暗 黙 のシンボルバージ ョ
ン 管 理 が 有 効 にな り ます。
シンボルにバージ ョ ンが 定 義 されていない 場 合 は、 リ ンクしているファイルの SONAME
が 使 用 されます。
こ のオプシ ョ ンは、 組 み 込 みシンボルま たはス ク リ プ ト フ ァ イル と 組 み 合 わせて 使
用 する こ と はで き ません。
10.27.1 関 連 項 目
参 照
• シンボルバージ ョ ン 管 理 について (10-27 ページ)
• シンボルバージ ョ ン 管 理 のスク リプト ファイル (10-28 ページ)
• 組 み 込 みシンボルについて (10-30 ページ) .
『リンカリファレンス』:
• --symver_soname (2-170 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-31
ID 111311
Non-Confidential

BPABI および SysV の 共 有 ラ イ ブ ラ リ と 実 行 可 能 フ ァ イル
10.28 BPABI DLL 類 似 モデルに 関 連 する リ ン カ コ マン ド ラ イ ンオプシ ョ ン
以 下 の リ ン カ コ マン ド ラ イ ンオプシ ョ ンがベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ
ンバイナ リ インタフェース (BPABI) DLL 類 似 モデルに 関 連 し ています。
参 照
『リンカリファレンス』:
• --base_platform (2-18 ページ)
• --bpabi (2-24 ページ)
• --dll (2-49 ページ)
• --dynamic_debug (2-50 ページ)
• --export_all、 --no_export_all (2-64 ページ)
• --pltgot=type (2-122 ページ)
• --pltgot_opts=mode (2-124 ページ)
• --ro_base=address (2-137 ページ)
• --ropi (2-138 ページ)
• --rosplit (2-139 ページ)
• --runpath=pathlist (2-140 ページ)
• --rw_base=address (2-141 ページ)
• --rwpi (2-142 ページ)
• --soname=name (2-153 ページ)
• --symver_script=file (2-169 ページ)
• --symver_soname (2-170 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 10-32
ID 111311
Non-Confidential

第 11 章
ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
以 下 の 各 ト ピ ッ ク では、 ARM リンカ armlink でサポー ト されているベースプラ ッ ト
フ ォーム リ ン ク モデルの 機 能 について 説 明 し ます。
概 念
• ベースプ ラ ッ ト フ ォームモデルでのス キ ャ ッ タ フ ァ イルの 使 用 に 関 する 制 限
(11-2 ページ)
• ベースプ ラ ッ ト フ ォーム リ ン ク モデルのス キ ャ ッ タ フ ァ イルの 例 (11-5 ページ)
• ベースプ ラ ッ ト フ ォームモデルを 使 用 し た PLT シーケンスの 配 置 (11-7 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-1
ID 111311
Non-Confidential

ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
11.1 ベースプ ラ ッ ト フ ォームモデルでのスキャ ッ タ フ ァ イルの 使 用 に 関 する 制 限
ベースプ ラ ッ ト フ ォームモデルでは、 ス キ ャ ッ タ フ ァ イ ルをサポー ト し ています。
スキ ャ ッ タ フ ァ イル 内 で 使 用 でき る キーワード には 制 限 があ り せんが、 使 用 でき る
ス キ ャ ッ タ フ ァ イ ルの タ イ プには 以 下 の 制 限 があ り ます。
• RELOC 属 性 でマー ク さ れた ロー ド 領 域 には、 +offset の 相 対 ベース ア ド レ ス を 持 つ
実 行 領 域 のみが 含 まれている 必 要 があ り ます。 以 下 の 例 では、 RELOC 属 性 と
+offset 相 対 ベース ア ド レ ス を 使 用 する 有 効 な ス キ ャ ッ タ フ ァ イル と 無 効 な ス
キャッタファイルを 示 します。
例 11-1 RELOC と +offset を 使 用 する 有 効 なスキャ ッ タ フ ァ イルの 例
# こ れ は 有 効 で す。 す べ て の 実 行 領 域 に +offset ア ドレスが 指 定 されています。
LR1 0x8000 RELOC
{
ER_RELATIVE +0
{
*(+RO)
}
}
例 11-2 RELOC と +offset を 使 用 する 無 効 なスキャ ッ タ フ ァ イルの 例
# こ れ は 有 効 で は あ り ま せ ん。 実 行 領 域 の 1 つ に 絶 対 ベ ー ス ア ド レ ス が 指 定 さ れ て い ま す。
LR1 0x8000 RELOC
{
ER_RELATIVE +0
{
*(+RO)
}
ER_ABSOLUTE 0x1000
{
*(+RW)
}
}
• PLT セ ク シ ョ ン を 必 要 と する ロー ド 領 域 には、 OVERLAY としてマークされていな
い、 コー ド を 含 む 実 行 領 域 が 少 な く と も 1 つ 含 まれてい る 必 要 があ り ます。 こ
の 実 行 領 域 は、 PLT セ ク シ ョ ン を 保 持 する めに 使 用 さ れます。 PLT は 常 に メ モ
リ 内 に 存 在 している 必 要 があるため、OVERLAY 領 域 は 使 用 でき ません。 以 下 の 例
では、 PLT セ ク シ ョ ン を 必 要 と する 実 行 領 域 を 定 義 する 有 効 な ス キ ャ ッ タ フ ァ
イルと 無 効 なスキャッタファイル 示 します。
例 11-3 PLT セ ク シ ョ ン を 必 要 と する ロー ド 領 域 の 有 効 なスキャ ッ タ フ ァ イルの 例
# これは 有 効 です。 ER_1 にはコードが 含 まれ、 OVERLAY ではあり ません。
LR_NEEDING_PLT 0x8000
{
ER_1 +0
{
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-2
ID 111311
Non-Confidential

ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
}
}
*(+RO)
例 11-4 PLT セ ク シ ョ ン を 必 要 と する ロー ド 領 域 の 無 効 なスキャ ッ タ フ ァ イルの 例
# これは 有 効 ではありません。 コードを 含 むすべての 実 行 領 域 が OVERLAY としてマークされています。
LR_NEEDING_PLT 0x8000
{
ER_1 +0 OVERLAY
{
*(+RO)
}
ER_2 +0
{
*(+RW)
}
}
• ロード 領 域 で PLT セ ク シ ョ ンが 必 要 な 場 合 は、 PLT セクションをロード 領 域 内
に 配 置 する 必 要 があ り ます。 デフ ォル ト では、 ロー ド 領 域 で PLT セクションが
必 要 な 場 合 、 PLT セ ク シ ョ ンは、 リ ンカに よ って コー ド を 含 む 最 初 の 実 行 領 域
内 に 配 置 さ れます。 ス キ ャ ッ タ ロー ド セレ ク タ を 使 用 し て、 の 配 置 先 をオー
バーラ イ ド でき ます。
コー ド を 含 むロー ド 領 域 が 複 数 あ る 場 合 、 name と い う 名 前 のロード 領 域 の PLT
セ ク シ ョ ンの 名 前 は .plt_name にな り ます。 コー ド を 含 むロー ド 領 域 が 1 つだけ
の 場 合 、 PLT セ ク シ ョ ンの 名 前 は .plt にな り ます。
以 下 の 例 では、 PLT セ ク シ ョ ン を 配 置 する 有 効 な ス キ ャ ッ タ フ ァ イ ル と 無 効 な
スキャッタファイルを 示 します。
例 11-5 PLT セ ク シ ョ ン を 配 置 する 有 効 なスキャ ッ タ フ ァ イルの 例
# これは 有 効 です。 LR1 の PLT セクショ ンは LR1 に 配 置 されます。
LR1 0x8000
{
ER1 +0
{
*(+RO)
}
ER2 +0
{
*(.plt_LR1)
}
}
LR2 0x10000
{
ER1 +0
{
*(other_code)
}
}
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-3
ID 111311
Non-Confidential

ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
例 11-6 PLT セ ク シ ョ ン を 配 置 する 無 効 なスキャ ッ タ フ ァ イルの 例
# これは 有 効 ではありません。 LR1 の PLT セクショ ンは LR2 に 配 置 されています。
LR1 0x8000
{
ER1 +0
{
*(+RO)
}
}
LR2 0x10000
{
ER1 +0
{
*(.plt_LR1)
}
}
11.1.1 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• ベースプ ラ ッ ト フ ォームモデルを 使 用 し た PLT シーケンスの 配 置 (11-7 ペー
ジ) .
参 照
『リンカリファレンス』:
• ロード 領 域 の 属 性 (4-8 ページ)
• 実 行 領 域 の 属 性 (4-13 ページ)
• ロー ド 領 域 と 実 行 領 域 のア ド レ ス 属 性 (4-16 ページ)
• ロー ド 領 域 のア ド レ ス 属 性 の 継 承 規 則 (4-20 ページ)
• RELOC ア ド レ ス 属 性 の 継 承 規 則 (4-22 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-4
ID 111311
Non-Confidential

ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
11.2 ベースプ ラ ッ ト フ ォーム リ ン ク モデルのスキャ ッ タ フ ァ イルの 例
こ の 例 では、 ベースプ ラ ッ ト フ ォーム リ ン ク モデルでのス キ ャ ッ タ フ ァ イルの 使 用
方 法 を 示 しています。
再 配 置 可 能 な ロー ド 領 域 を 使 用 し た、 ス キ ャ ッ タ フ ァ イル 形 式 の 標 準 のベースプ
ラットフォームアプリケーションバイナリインタフェース (BPABI) メモリモデル
を 以 下 に 示 し ます。
例 11-7 再 配 置 可 能 なロー ド 領 域 を 使 用 し た 標 準 の BPABI スキャ ッ タ フ ァ イル
LR1 0x8000 RELOC
{
ER_RO +0
{
*(+RO)
}
}
LR2 0x0 RELOC
{
ER_RW +0
{
*(+RW)
}
ER_ZI +0
{
*(+ZI)
}
}
この 例 は、 BPABI 仕 様 と 同 じ 2 領 域 形 式 であ る ため、 BPABI に 準 拠 し ています。
次 の 例 では、 再 配 置 可 能 ではない 2 つのロード 領 域 LR1 と LR2 を 示 しています。
例 11-8 再 配 置 可 能 ではないロー ド 領 域 を 使 用 し たスキャ ッ タ フ ァ イル
LR1 0x8000
{
ER_RO +0
{
*(+RO)
}
ER_RW +0
{
*(+RW)
}
ER_ZI +0
{
*(+ZI)
}
}
LR2 0x10000
{
ER_KNOWN_ADDRESS +0
{
*(fixedsection)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-5
ID 111311
Non-Confidential

ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
}
}
LR3 0x20000 RELOC
{
ER_RELOCATABLE +0
{
*(floatingsection)
}
}
LR1 と LR2 には 固 定 ア ド レ スが 指 定 されているため、 リ ンカは LR1 と LR2 の 間 のダ
イナ ミ ッ ク な 再 配 置 を 生 成 する 必 要 があ り ません。 ただ し、 RELOC ロード 領 域 LR3
は、 ア ド レ ス 空 間 内 で ロー ド 領 域 LR1 と LR2 か ら 非 常 に 離 れた 場 所 に 配 置 さ れる 可
能 性 があ り ます。 そのため、 LR1 と LR3 の 間 および LR2 と LR3 の 間 には、 ダ イナ
ミ ッ ク な 再 配 置 が 必 要 にな り ます。
各 ロード 領 域 に 対 して PLT が 生 成 される よ う にするには、オプシ ョ ン --pltgot=direct
--pltgot_opts=crosslr を 使 用 し ます。
11.2.1 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォームアプ リ ケーシ ョ ンバ イ ナ リ イ ン タ フ ェース (BPABI)
リンクモデル (3-6 ページ)
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ)
• BPABI リンクモデルと SysV リンクモデルの 両 方 に 共 通 する 概 念 (3-11 ページ)
• ベースプ ラ ッ ト フ ォームモデルでのス キ ャ ッ タ フ ァ イルの 使 用 に 関 する 制 限
(11-2 ページ)
参 照
『リンカリファレンス』:
• ロード 領 域 の 属 性 (4-8 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-6
ID 111311
Non-Confidential

ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能
11.3 ベースプラ ッ ト フ ォームモデルを 使 用 した PLT シーケンスの 配 置
リ ン カでは、 ベースプ ラ ッ ト フ ォームモデル (--base_platform) の 場 合 に、 コードを
含 む 複 数 の ロー ド 領 域 に 対 する プロシージャ リ ンクテーブル (PLT) の 生 成 をサポー
トしています。
ベースプ ラ ッ ト フ ォームモデルの 場 合 に PLT の 生 成 を 有 効 にするには、 PLT シーケ
ンスを 生 成 する --pltgot= オプシ ョ ン を 使 用 し ます。 オプシ ョ ン --pltgot_opts=crosslr
を 使 用 する と 、 RELOC ロー ド 領 域 間 で 呼 び 出 し を 行 う ためのエン ト リ を PLT に 追 加 で
き ます。 複 数 の ロー ド 領 域 に 対 する PLT 生 成 は、 --pltgot=direct でのみサポー ト され
ます。
--pltgot_opts=crosslr オプシ ョ ンは、 イ メージが 動 的 にロード される 際 に 互 いに 関 連
し て 移 動 する 複 数 の ロー ド 領 域 があ る 場 合 に 便 利 です。 リ ン カに よ っ て ロー ド 領 域
ごとに PLT が 生 成 される ため、 離 れている PLT にア ク セスするのに 呼 び 出 し を 拡 張
する 必 要 があ り ません。
リンカによって 生 成 された PLT セクションの 配 置
• ロード 領 域 が 1 つしかない 場 合 、 PLT は 1 つです。 オブジェ ク ト anon$$obj.o の
.plt という 名 前 のセクションがリンカによって 作 成 されます。
• ロード 領 域 が 複 数 ある 場 合 は、 PLT セ ク シ ョ ン を 必 要 と する ロー ド 領 域 ご と に
PLT セクションが 作 成 されます。 デフォルトでは、 PLT セクションはコードを
含 む 最 初 の 実 行 領 域 内 に 配 置 さ れます。 配 置 先 は、 ス キ ャ ッ タ フ ァ イルで 正 確
な PLT セ ク シ ョ ン 名 を 指 定 する こ と でオーバーラ イ ド で き ます。
例 えば、 LR Name と い う 名 前 のロード 領 域 の 場 合 、 PLT セクションはオブジェク
ト anon$$obj.o の .plt_LR_NAME という 名 前 になります。 スキャッタファイルでこ
の PLT セ ク シ ョ ンの 名 前 を 正 確 に 指 定 するには、 以 下 のセレ ク タ を 使 用 し ま
す。
anon$$obj.o(.plt_LR_NAME)
以 下 の 点 に 注 意 し て 下 さい。
• ロード 領 域 LR_NAME の PLT をロード 領 域 LR_NAME の 範 囲 外 に 移 動 する と 、 リ ン カ
によってエラーメ ッセージが 生 成 されます。
• ロード 領 域 LR_NAME に RELOC 実 行 領 域 と RELOC 以 外 の 実 行 領 域 が 混 在 し てい る 場
合 、 リ ン カに よ っ てエ ラー メ ッ セージが 生 成 さ れます。 こ れは、 実 行 時 に RELOC
実 行 領 域 か ら PLT にアクセスでき る 保 証 がないためです。
• --pltgot=indirect と --pltgot=sbrel は、 複 数 の ロー ド 領 域 ではサポー ト さ れませ
ん。
11.3.1 関 連 項 目
概 念
• ベースプ ラ ッ ト フ ォーム リ ン ク モデル (3-8 ページ) .
参 照
『リンカリファレンス』:
• --base_platform (2-18 ページ)
• --pltgot=type (2-122 ページ)
• --pltgot_opts=mode (2-124 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. 11-7
ID 111311
Non-Confidential

付 録 A
『 リ ン カの 使 用 』 に 対 する 改 訂
『リンカの 使 用 』 に 対 し て、 以 下 の 技 術 的 変 更 が 加 え ら れま し た。
表 A-1 発 行 E と 発 行 F の 相 違 点
変 更 点
適 切 な 場 合 、
• Thumb に 16 ビ ッ ト の 接 頭 辞 を 付 け ま し
た
• Thumb-2 を 32 ビッ ト Thumb に 変 更 し ま
した。
ARMCC5INC な どの 新 し いバージ ョ ンの 番 号 付 け
の 方 式 に 環 境 変 数 の リ ス ト を 更 新 し ま し た。
関 連 する ト ピ ッ ク
• リンカについて (2-2 ページ)
• Thumb コー ド を 含 む 実 行 領 域 の 順 序 付 け
について (4-26 ページ)
• ベニアの 概 要 (4-27 ページ)
• 関 数 の イ ン ラ イ ン 化 に 影 響 を 与 え る 要 因
(5-23 ページ)
• スキャッタロードの 記 述 におけるベニア
入 力 セ ク シ ョ ンの 選 択 (8-36 ページ)
• リンカによる ARM 標 準 ラ イ ブ ラ リ の 検
索 方 法 の 制 御 (4-39 ページ)
• リンク 時 のユーザライブラリの 指 定
(4-41 ページ)
• リ ンカに よ る 参 照 の 解 決 方 法
(4-43 ページ) .
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. A-1
ID 111311
Non-Confidential

『リ ン カの 使 用 』 に 対 する 改 訂
表 A-2 発 行 D と 発 行 E の 相 違 点
変 更 点
--api、 --no_api、 --veneerinject、 --no_veneerinject オプ
シ ョ ンの 説 明 への リ ン ク を 追 加 し ま し た。
ARM 1176 エ ラ ッ タ を 回 避 する オプシ ョ ンへの リ ン ク
を 追 加 しま した。
ト ピ ッ ク の タ イ ト ルを 改 善 し ま し た。
関 連 する ト ピ ッ ク
リ ン カ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一
覧 (2-5 ページ)
リ ン カ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一
覧 (2-5 ページ)
__attribute__((section("name"))) を 使 用 したコー
ド と データ の 配 置 (8-37 ページ)
サンプルの C/C++ コー ド を 追 加 し ま し た。 • __at セ ク シ ョ ンの 自 動 配 置 (8-42 ペー
ジ)
• __at セ ク シ ョ ンの 手 動 配 置 (8-44 ペー
ジ)
• __at を 使 用 したフラ ッシュ メモ リ での
キーの 配 置 (8-46 ページ) .
表 A-3 発 行 C と 発 行 D の 相 違 点
変 更 点
リンカ 機 能 のリストから LTCG とプロファイ リング
についての 項 目 を 削 除 し ま し た。
プ ロ フ ァ イ リ ン グについての メ モを 削 除 し ま し た。
廃 止 予 定 の 機 能 であ る LTCG についての メ モを 追 加
しました。
関 連 する ト ピ ッ ク
リンカについて (2-2 ページ)
リンク 時 コード 生 成 について (5-13 ページ)
表 A-4 発 行 B と 発 行 C の 相 違 点
変 更 点
厳 格 なオプシ ョ ンフ ァ ミ リ についての 新 規 ト ピ ッ ク。
あ る 実 行 領 域 について、 ANY_SIZE キーワー ド を 使 用 し
て 未 割 り 当 てセ ク シ ョ ンの 配 置 に 許 容 さ れる 最 大 サ
イ ズを 指 定 する 方 法 に 関 する 詳 細 を 追 加 し ま し た。
スキャッタファイルを 使 用 して ARM ライブラリヘル
パ 関 数 を 配 置 する 方 法 についての 新 規 ト ピ ッ ク を 追
加 しました。
関 連 する ト ピ ッ ク
リンカにおける 厳 格 なオプションファミ リの
使 用 (4-45 ページ)
.ANY モジュールセレ ク タによ る 未 割 り 当 てセ
クションの 配 置 (8-25 ページ)
ARM ラ イ ブ ラ リ ヘルパ 関 数 の 配 置 例
(8-56 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. A-2
ID 111311
Non-Confidential

『リ ン カの 使 用 』 に 対 する 改 訂
表 A-5 発 行 A と 発 行 B の 相 違 点
変 更 点
64 ビ ッ ト リ ン カのサポー ト に 関 する メ モを 追 加 し ま
した。
『リンカリファレンス』 の 新 しいコマン ド ラ イ ンオプ
ションへのリンクを 追 加 しました。
プ ロ グ ラ ムセグ メ ン ト サ イ ズの 制 限 に 関 する メ モを
追 加 し ま し た。
ス キ ャ ッ タ フ ァ イルおよび 対 応 する コ マン ド ラ イ ン
オプシ ョ ンの 比 較 表 を 追 加 し ま し た。
未 割 り 当 てセ ク シ ョ ンの 処 理 に 関 する 情 報 を 追 加 し
ました。
PROTECTED キーワー ド を 使 用 し た 場 合 、 ロー ド 領 域 の
重 複 も 防 止 さ れます。
マッピングシンボルの 概 要 トピックを 追 加 しました。
Load$$ ZI 出 力 セ ク シ ョ ンシンボルを 追 加 し ま し た。
ARM アセンブラで リ ンカ 定 義 シンボルをインポート
する 方 法 についての ト ピ ッ ク を 追 加 し ま し た。
コー ド およびデータ を 特 定 のア ド レ スに 配 置 する 方
法 の 例 を 追 加 し ま し た。
.ANY モジ ュールセレ ク タ の 使 用 法 を 説 明 する ト ピ ッ
ク を 追 加 し ま し た。
__attribute__((section("name"))) の 使 用 時 に 影 響 を 受
け る 各 種 の リ ン カ 機 能 について、 情 報 を 追 加 し ま し
た。
+offset 実 行 領 域 およびオーバーレ イ 実 行 領 域 につい
ての 情 報 を 追 加 し ました。
サポー ト さ れないキーワー ド の 一 覧 か ら、 GNU ld ス
クリプトキーワード ABSOLUTE、 ADDR、 ALIGNOF、 DEFINED、
EXTERN、 LOADADDR、 SIZEOF を 削 除 しま した。 現 在 はサ
ポー ト されています。
関 連 する ト ピ ッ ク
リンカについて (2-2 ページ)
リ ン カ コ マン ド ラ イ ンオプシ ョ ンの 目 的 別 一
覧 (2-5 ページ)
• イメージの 構 造 (4-3 ページ)
• 入 力 セ ク シ ョ ン、 出 力 セ ク シ ョ ン、 領
域 、 およびプ ロ グ ラ ムセグ メ ン ト
(4-5 ページ) .
リ ン カで イ メ ージの メ モ リ マ ッ プを 指 定 する
方 法 (4-8 ページ)
リンカによるセクションの 配 置 (4-20 ページ)
ス キ ャ ッ タ ロー ド 時 のベニアの 再 利 用
(4-32 ページ)
マッピングシンボルについて (7-3 ページ)
Load$$ 実 行 領 域 シンボル (7-7 ページ)
ARM アセンブラでの リ ンカ 定 義 シンボルのイ
ンポート (7-13 ページ)
特 定 ア ド レ スへの 関 数 と データ の 配 置
(8-18 ページ)
• .ANY モジ ュールセレ ク タ に よ る 未 割 り
当 てセク シ ョ ンの 配 置 (8-25 ページ)
• .ANY セ ク シ ョ ンの 配 置 アルゴ リ ズムの
使 用 例 (8-29 ページ)
• 領 域 の 割 り 当 て、 セレ ク タ、 および 優 先
度 の 動 作 を 示 す next_fit アルゴ リ ズ
ムの 例 (8-32 ページ)
• .ANY セクションのソートアルゴリズム
の 使 用 例 (8-34 ページ) .
__attribute__((section("name"))) を 使 用 したコー
ド と データ の 配 置 (8-37 ページ)
オーバーレ イ を 使 用 し たセ ク シ ョ ンの 配 置
(8-49 ページ)
armlink での ld ス ク リ プ ト の 使 用 に 固 有 の 制 限
(9-8 ページ)
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. A-3
ID 111311
Non-Confidential

『リ ン カの 使 用 』 に 対 する 改 訂
表 A-5 発 行 A と 発 行 B の 相 違 点 ( 続 き)
変 更 点
実 行 可 能 フ ァ イルおよび 共 有 オブジ ェ ク ト のデフ ォ
ルトの ld スクリプトに 変 更 を 加 え、.bss 領 域 に 続 く 4
バイ トの 境 界 で 整 列 させるよ うにしました。
--ldpartial 用 のデフ ォル ト の ld ス ク リ プ ト を 追 加 し
ました。
ベースプラットフォームリンクモデルのトピックを
「ベースプ ラ ッ ト フ ォーム リ ン ク モデルの 機 能 」 に 移
動 しました。
関 連 する ト ピ ッ ク
armlink に よ って 使 用 さ れるデフ ォル ト の GNU
ld スクリプト (9-10 ページ)
armlink に よ って 使 用 さ れるデフ ォル ト の GNU
ld スクリプト (9-10 ページ)
• ベースプ ラ ッ ト フ ォームモデルでのス
キ ャ ッ タ フ ァ イルの 使 用 に 関 する 制 限
(11-2 ページ)
• ベースプ ラ ッ ト フ ォーム リ ン ク モデルの
スキャッタファイルの 例 (11-5 ページ)
• ベースプ ラ ッ ト フ ォームモデルを 使 用 し
た PLT シーケンスの 配 置 (11-7 ページ)
.
ARM DUI 0474FJ Copyright © 2010-2011 ARM. All rights reserved. A-4
ID 111311
Non-Confidential