fromELF - ARM Information Center

®
ARM
デベロッパスイート
バージョン 1.2
リンカ / ユーティリティガイド
Copyright © 2001 ARM Limited. All rights reserved.
ARM DUI0151AJ-00

ARM デベロッパスイート
リンカ / ユーティリティガイド
Copyright © 2001 ARM Limited. All rights reserved.
リリース 情 報
改 訂 履 歴
日 付
発 行
変 更 内 容
2001 年 11 月 A ADS リリース 1.2
著 作 権
®
または のマークが 付 いた 言 葉 およびロゴは、ARM 社 が 所 有 する 登 録 商 標 または 商 標 です。 本 書
に 記 載 されている 他 の 製 品 名 は、 各 社 の 所 有 する 商 標 です。
本 書 に 記 載 されている 情 報 の 全 部 または 一 部 、ならびに 本 書 で 紹 介 する 製 品 は、 著 作 権 所 有 者 の
文 書 による 事 前 の 許 可 を 得 ない 限 り、 転 用 ・ 複 製 することを 禁 じます。
本 書 に 記 載 されている 製 品 は、 今 後 も 継 続 的 に 開 発 ・ 改 良 の 対 象 となります。 本 書 に 含 まれる 製
品 およびその 利 用 方 法 についての 情 報 は、ARM が 利 用 者 の 利 益 のために 提 供 するものです。した
がって 当 社 では、 製 品 の 市 販 性 または 利 用 の 適 切 性 を 含 め、 暗 示 的 ・ 明 示 的 に 関 係 なく 一 切 の 責
任 を 負 いません。
本 書 は、 本 製 品 の 利 用 者 をサポートすることだけを 目 的 としています。 本 書 に 記 載 されている 情
報 の 使 用 、 情 報 の 誤 りまたは 省 略 、あるいは 本 製 品 の 誤 使 用 によって 発 生 したいかなる 損 失 ・ 損
傷 についても、ARM 社 は 一 切 責 任 を 負 いません。
ii Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

目 次
ARM デベロッパスイートリンカ / ユーティリティ
ガイド
序 章
本 書 について ...................................................................................................vi
ご 意 見 ・ご 質 問 ................................................................................................ix
第 1 章
第 2 章
第 3 章
第 4 章
はじめに
1.1 リンカおよびユーティリティについて.........................................................1-2
armlink のコマンド 構 文
2.1 armlink について ...........................................................................................2-2
2.2 armlink のコマンド 構 文 ................................................................................2-8
基 本 リンカ 機 能
3.1 イメージ 構 造 の 指 定 ......................................................................................3-2
3.2 セクションの 配 置 .........................................................................................3-8
3.3 最 適 化 と 修 正 .............................................................................................. 3-12
3.4 コマンドラインオプションを 使 用 した 単 純 イメージの 作 成 ...................... 3-14
イメージシンボルへのアクセス
4.1 リンカ 定 義 シンボルへのアクセス ................................................................4-2
4.2 別 のイメージに 含 まれるシンボルへのアクセス ..........................................4-5
4.3 グローバルシンボルの 隠 蔽 と 再 命 名 ............................................................4-9
4.4 $Super$$ と $Sub$$ を 使 用 したシンボル 定 義 のオーバライド ................. 4-12
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. iii

目 次
第 5 章
第 6 章
第 7 章
第 8 章
分 散 ローディング 記 述 ファイルの 使 用
5.1 分 散 ローディングについて .......................................................................... 5-2
5.2 分 散 ローディング 記 述 ファイルの 形 式 構 文 ................................................. 5-7
5.3 例 : 領 域 アドレスとセクションアドレスの 指 定 ........................................ 5-22
5.4 等 価 な 分 散 ローディング 記 述 を 使 用 した 単 純 イメージの 生 成 .................. 5-28
ライブラリの 作 成 と 使 用
6.1 ライブラリについて ..................................................................................... 6-2
6.2 ライブラリの 検 索 、 選 択 、スキャン............................................................ 6-3
6.3 ARM ライブラリアン ................................................................................... 6-6
fromELF の 使 用
7.1 fromELF について ........................................................................................ 7-2
7.2 fromELF コマンドラインオプション............................................................ 7-3
7.3 fromELF の 使 用 例 ...................................................................................... 7-10
ARM プロファイラの 使 用
8.1 ARM プロファイラ ....................................................................................... 8-2
8.2 プロファイラのコマンドラインオプション ................................................. 8-3
8.3 サンプル 出 力 ................................................................................................ 8-4
用 語 集
iv Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

序 章
本 章 では、ARM デベロッパスイート(ADS)に 含 まれているリンカおよびユーティリ
ティの 解 説 書 について 説 明 します。 本 章 は 以 下 のセクションから 構 成 されています。
• 本 書 について:P. vi
• ご 意 見 ・ご 質 問 :P. ix
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. v

序 章
本 書 について
本 書 は ADS の 解 説 書 です。 本 書 では、ADS に 含 まれているリンカへのコマンドライン
オプションと 他 の ARM ツールについて 説 明 しています。
対 象 読 者
本 書 は、ADS を 使 用 してアプリケーションを 作 成 する 全 ての 開 発 者 を 対 象 としていま
す。 本 書 の 内 容 は、ADS の「スタートアップガイド」に 記 載 されている ARM 開 発 ツー
ルに 精 通 した 経 験 豊 富 なソフトウェア 開 発 者 を 想 定 して 書 かれています。
本 書 の 構 成
本 書 は 以 下 の 章 と 付 録 から 構 成 されています。
第 1 章
第 2 章
第 3 章
第 4 章
第 5 章
第 6 章
第 7 章
はじめに
ADS バージョン 1.2 に 含 まれているリンカと 関 連 ユーティリティを 概 説
します。
armlink のコマンド 構 文
リンカに 使 用 することができる 全 てのコマンドラインオプションについ
て 説 明 します。
基 本 リンカ 機 能
単 純 なイメージの 作 成 方 法 を 具 体 的 に 説 明 します。
イメージシンボルへのアクセス
イメージ 内 のシンボルへのアクセス 方 法 について 詳 しく 説 明 します。
分 散 ローディング 記 述 ファイルの 使 用
分 散 ローディングファイルを 使 用 してメモリ 内 にコードとデータを 格 納
する 方 法 を 説 明 します。
ライブラリの 作 成 と 使 用
ライブラリオブジェクトを 作 成 し、それにアクセスする 際 の 手 順 につい
て 説 明 します。
fromELF の 使 用
fromELF ユーティリティプログラムの 概 要 と、このプログラムを 使 用 し
たイメージ 形 式 の 変 更 方 法 について 説 明 します。
vi Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

序 章
第 8 章
ARM プロファイラの 使 用
ADS に 含 まれている ARM プロファイラユーティリティプログラムにつ
いて 説 明 します。
表 記 規 則
本 書 では 以 下 の 表 記 規 則 を 用 いています。
monospace コマンド、ファイル 名 、プログラム 名 、ソースコードなど、キーボード
から 入 力 可 能 なテキストを 示 しています。
monospace コマンドまたはオプションに 使 用 可 能 な 略 語 を 示 しています。コマンド
名 またはオプション 名 を 全 て 入 力 する 代 わりに、 下 線 部 分 の 文 字 だけを
入 力 してこれらを 指 定 することができます。
monospace italic
コマンドおよび 関 数 への 引 数 で、 特 定 の 値 に 置 き 換 えることが 可 能 なも
のを 示 しています。
monospace bold
サンプルコード 以 外 に 使 用 される 言 語 キーワードを 示 しています。
italic
bold
重 要 用 語 、 専 門 用 語 、 相 互 参 照 、 引 用 箇 所 を 斜 体 で 記 載 しています。
メニュー 名 などのインタフェース 要 素 を 太 字 で 記 載 しています。また、
適 宜 記 述 リスト 内 の 重 要 箇 所 と、ARM プロセッサシグナルの 名 前 にも 太
字 を 用 いています。
参 考 資 料
このセクションでは、ARM プロセッサファミリの 開 発 コード 関 連 情 報 を 提 供 している
ARM 社 および 各 社 の 出 版 物 を 紹 介 します。
ARM は 自 社 出 版 物 の 定 期 的 な 更 新 ・ 修 正 を 行 っています。 最 新 の 正 誤 表 と 追 補 情 報 、
ならびに ARM によく 寄 せられる 質 問 とその 回 答 については、ARM ホームページ
http://www.arm.com をご 覧 下 さい。
ARM の 出 版 物
本 書 では、ADS に 含 まれている 開 発 ツールの 参 考 情 報 を 提 供 しています。この 他 、 本
製 品 には 以 下 の 資 料 が 同 梱 されています。
• ADS Installation and License Management Guide(ARM DUI 0139)
• スタートアップガイド(ARM DUI 0064)
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. vii

序 章
• ADS デベロッパガイド(ARM DUI 0056)
• ADS アセンブラガイド(ARM DUI 0068)
• ADS コンパイラ / ライブラリガイド(ARM DUI 0067)
• AXD/armsd デバッガガイド(ARM DUI 0066)
• ADS デバッグターゲットガイド(ARM DUI 0058)
• CodeWarrior IDE Guide(ARM DUI 0065)
ARM デベロッパスイートには 上 記 の 他 に 以 下 の 資 料 が 収 録 されています。
• ARM Architecture Reference Manual(ARM DDI 0100)。DynaText と PDF 形 式 で 収
録 されています。
• ARM Applications Library Programmer's Guide。DynaText と PDF 形 式 で 収 録 されて
います。
• ARM ELF 仕 様 書 (SWS ESPC 0003)。PDF 形 式 で
install_directory\PDF\specs\ARMELF.pdf に 収 録 されています。
• TIS DWARF 2 仕 様 書 。PDF 形 式 で
install_directory\PDF\specs\TIS-DWARF2.pdf に 収 録 されています。
• ARM/Thumb ® Procedure Call Standard specification。PDF 形 式 で
install_directory\PDF\specs\ATPCS.pdf に 収 録 されています。
また、ARM 製 品 の 関 連 情 報 については、 以 下 の 出 版 物 を 参 照 して 下 さい。
• ARM Reference Peripheral Specification(ARM DDI 0062)
• ご 使 用 中 のハードウェアデバイスに 関 する ARM データシートまたはテクニカル
リファレンスマニュアル
その 他 、サンプルコードおよび 記 述 コードに 関 する 情 報 については、ARM Firmware Suite
(AFS)のサンプルコードと 説 明 書 を 参 照 して 下 さい。AFS の 詳 細 については、 以 下 の
ARM 出 版 物 を 参 照 して 下 さい。
• ARM Firmware Suite User Guide(ARM DUI 0136)
• ARM Firmware Suite Reference Guide(ARM DUI 0102)
他 の 出 版 物
本 書 では、ARM アセンブリ 言 語 、C ならびに C++ プログラミング 言 語 については 詳 し
く 説 明 していません。プログラミングに 関 する 一 般 情 報 については、 他 の 出 版 物 を 参
照 して 下 さい。
ARM アーキテクチャについての 一 般 情 報 については、 以 下 の 出 版 物 を 参 照 して 下 さい。
• ARM System-on-chip Architecture (second edition), Furber, S., (2000). Addison Wesley.
ISBN 0-201-67519-6.
viii Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

序 章
ご 意 見 ・ご 質 問
ARM 社 では、ADS および 本 書 に 関 するご 意 見 ・ご 質 問 をお 待 ちしています。
ARM デベロッパスイートについてのご 意 見 ・ご 質 問
ADS に 関 するご 意 見 ・ご 質 問 がございましたら、 製 品 購 入 元 までご 連 絡 下 さい。その
際 、 迅 速 かつ 適 切 な 対 応 をさせて 頂 くために、 以 下 の 情 報 をご 用 意 下 さい。
• お 名 前 と 会 社 名
• 製 品 のシリアル 番 号
• ご 使 用 になっている 製 品 のリリース 情 報
• ハードウェアプラットフォーム、オペレーティングシステムのタイプ、バージョ
ンなど、ご 使 用 になっているプラットフォームについての 詳 しい 情 報
• 当 該 問 題 が 繰 り 返 し 発 生 するコードの 小 さなスタンドアロンサンプル
• 当 初 の 期 待 する 動 作 と、 実 際 に 起 こったことに 関 する 詳 しい 説 明
• コマンドラインオプションを 含 め、 使 用 した 全 てのコマンド
• 問 題 を 例 示 するサンプル 出 力
• バージョン 番 号 、ビルド 番 号 などを 含 め、ご 使 用 になっているツールのバージョ
ン 情 報
本 書 に 関 するご 意 見
本 書 に 関 するご 意 見 等 がございましたら、 電 子 メールに 以 下 の 情 報 をご 記 入 の 上 、
errata@arm.com までお 寄 せ 下 さい。
• 資 料 名
• 資 料 番 号
• ご 意 見 のあるページ 番 号
• 問 題 点 の 詳 しい 説 明
補 足 または 向 上 すべき 点 についてのご 提 案 もお 待 ちしています。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. ix

序 章
x Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 1 章
はじめに
本 章 では、ADS に 収 録 されている ARM リンカ / ユーティリティプログラムをご 紹 介 し
ます。 本 章 は 以 下 のセクションから 構 成 されています。
• リンカおよびユーティリティについて:P. 1-2
• リンカ:P. 1-2
• ユーティリティ:P. 1-3
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 1-1

はじめに
1.1 リンカおよびユーティリティについて
ADS は、 支 援 文 書 およびサンプルを 含 み、ARM ファミリの RISC プロセッサ 用 アプリ
ケーションの 記 述 やデバッグを 目 的 としたアプリケーション 群 で 構 成 されています。
ADS を 使 用 することにより、C、C++、ならびに ARM アセンブリ 言 語 プログラムの 開
発 ・ 作 成 ・デバッグが 可 能 となります。
ADS ツールキットは、 以 下 の 主 要 コンポーネントから 構 成 されています:
• コマンドライン 開 発 ツール
• GUI 開 発 ツール
• ユーティリティ
• 支 援 ソフトウェア
本 書 では、ADS に 含 まれている ARM リンカ armlink と、コマンドラインユーティリ
ティツールについて 説 明 します。ADS に 収 録 されている ARM アセンブラ、コンパイ
ラ、デバッガ、 支 援 ソフトウェアの 参 考 文 書 については、P. vii「ARM の 出 版 物 」をご
覧 下 さい。
1.1.1 リンカ
armlink は、1 つ 以 上 のオブジェクトファイルの 内 容 と、1 つ 以 上 のオブジェクトライブ
ラリから 選 択 された 部 分 とを 組 み 合 わせ、ELF 実 行 イメージまたは 部 分 的 にリンクし
た ELF オブジェクトを 生 成 します。
armlink は ARM コードと Thumb コードをリンクさせ、 必 要 に 応 じてプロセッサ 状 態 を
切 り 替 えるためのインタワーキングベニアを 自 動 生 成 することができます。またこの
リンカは、 必 要 に 応 じて 長 分 岐 ベニアを 自 動 生 成 し、 分 岐 命 令 の 範 囲 を 拡 張 すること
ができます。
armlink は、システムメモリマップ 内 にコードとデータを 別 々の 位 置 に 配 置 できるコマ
ンドラインオプションをサポートしています。 別 の 方 法 としては、 分 散 ロード 記 述 ファ
イルを 使 用 して、ロード 時 と 実 行 時 のどちらにも、 出 力 イメージ 内 のコードセクショ
ンとデータセクションに 別 々のメモリ 位 置 を 指 定 することができます。これにより 複
数 のメモリに 広 がる 複 雑 なイメージを 作 成 することができます。
armlink を 使 用 して 共 通 セクションと 未 使 用 セクションを 削 除 し、 出 力 イメージのサイ
ズを 小 さくすることができます。さらに、このリンカを 使 用 して 以 下 を 行 うことがで
きます。
• リンクされたファイルのデバッグ 情 報 と 参 照 情 報 の 生 成
• スタティックコールグラフの 生 成 とそのスタック 使 用 率 のリスト
• 出 力 イメージにあるシンボルテーブルの 内 容 の 制 御
armlink は、リンクしようとするオブジェクトのビルド 属 性 に 基 づいて、リンクに 適 し
た 標 準 C または C++ ライブラリバリアントを 自 動 的 に 選 択 します。
1-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

はじめに
armlink は ELF 以 外 の 出 力 形 式 を 生 成 しません。したがって、ELF イメージを ROM に
ロードするためにプレーンバイナリなどの 他 の 形 式 に 変 換 したい 場 合 には、fromELF
ユーティリティを 使 用 して 下 さい。ユーティリティをご 覧 下 さい。
このARMリンカの 詳 細 については、 第 2 章 「armlinkのコマンド 構 文 」を 参 照 して 下 さい。
1.1.2 ユーティリティ
このセクションでは、 主 要 開 発 ツールをサポートするために 提 供 されている 以 下 の
ユーティリティツールについて 概 説 します。
• fromELF
• armar
• armprof
fromELF
fromELF は、ARM イメージ 変 換 ユーティリティです。fromELF は ELF 形 式 の 入 力 ファ
イルを 受 け 取 り、 以 下 の 多 様 な 出 力 形 式 に 変 換 します。
• プレーンバイナリ
• Motorola32 ビット S レコード 形 式
• Intel Hex-32 形 式
• バイト 指 向 (Verilog メモリモデル)Hex 形 式
また、fromELF を 使 用 して 入 力 ファイルに 関 するテキスト 情 報 を 作 成 し、コードを 逆
アセンブルすることもできます。 詳 細 については、 第 7 章 「fromELF の 使 用 」を 参 照 し
て 下 さい。
armar
ARM ライブラリアン armar を 使 用 して、ELF ファイルセットを ar 形 式 ライブラリに 収
集 ・ 保 管 することができます。 複 数 の ELF オブジェクトファイルの 代 わりにライブラ
リをリンカに 渡 すことができます。 詳 細 については、P. 6-6「ARM ライブラリアン」を
参 照 して 下 さい。
armprof
ARM プロファイラ armprof は、ARM デバッガが 生 成 したプロファイルデータファイル
からの 簡 単 なプログラムの 実 行 プロファイルを 表 示 します。 詳 細 については、 第 8 章
「ARM プロファイラの 使 用 」を 参 照 して 下 さい。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 1-3

はじめに
1-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 2 章
armlink のコマンド 構 文
本 章 では、armlink のコマンド 構 文 について 詳 しく 説 明 します。 本 章 は 以 下 のセクショ
ンから 構 成 されています。
• armlink について:P. 2-2
• armlink のコマンド 構 文 :P. 2-8
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-1

armlink のコマンド 構 文
2.1 armlink について
ARM リンカ armlink を 使 用 して、 以 下 を 行 うことができます。
• ARMコードまたは Thumb コードのどちらかを 使 用 したライブラリとオブジェク
トの 集 合 をリンクし、1 つの 実 行 イメージを 作 成 する。
• 後 のリンク 作 業 の 入 力 として 使 用 可 能 なオブジェクトにするために、オブジェク
ト 集 合 の 一 部 を 1 つのオブジェクトにする。
• コードとデータのメモリ 内 の 位 置 を 指 定 する。
• リンクされたファイルに 関 するデバッグ 情 報 と 参 照 情 報 を 作 成 する。
オブジェクトは、コードと、 初 期 化 データと、ゼロに 設 定 する 必 要 のあるメモリの 位
置 を 含 む、 複 数 の 入 力 セクションから 構 成 されます。 入 力 セクションには、 読 み 出 し
専 用 (RO)、 読 み 出 し - 書 き 込 み(RW)、ゼロ 初 期 化 (ZI)のいずれかの 属 性 を 設 定 す
ることができます。armlink はこれらの 属 性 を 使 用 して 入 力 セクションをグループ 化 し、
出 力 セクション、 出 力 領 域 、 出 力 イメージと 呼 ばれる 大 きなビルディングブロックを
作 成 します。ロード 領 域 は ELF セグメントと 同 じです。
通 常 、リセット 時 またはデバッガによってイメージがターゲットにロードされた 後 は、
ロード 領 域 はシステムメモリマップ 内 に 存 在 します。イメージを 実 行 するには、その
前 にいくつかの 領 域 を 実 行 アドレスに 移 動 させなければならない 場 合 があります。こ
のためイメージのメモリマップには 全 く 異 なる 2 つのビューがあります。
• プログラムとデータが 最 初 にロードされたときのメモリのロードビュー
• コードを 通 常 の 実 行 位 置 に 移 動 した 後 のメモリの 実 行 ビュー
ロードアドレスで 実 行 される 領 域 をルート 領 域 と 呼 びます。
イメージ 階 層 の 詳 細 については、P. 3-2「イメージ 構 造 の 指 定 」を 参 照 して 下 さい。
2-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
2.1.1 armlink への 入 力
armlink への 入 力 は 以 下 で 構 成 されます。
• ELF オブジェクト 形 式 の 1 つ 以 上 のオブジェクトファイル。この 形 式 については
ARM ELF 仕 様 書 で 説 明 しています。 詳 細 については P. vii「ARM の 出 版 物 」を 参
照 して 下 さい。
• その 他 、armar で 作 成 された 1 つまたは 複 数 のライブラリ( 第 6 章 「ライブラリ
の 作 成 と 使 用 」 参 照 )
注
下 位 互 換 性 の 目 的 で、armlink は AOF 形 式 のオブジェクトファイルと ALF 形 式 のライ
ブラリにも 対 応 しています。ただし、これらの 旧 形 式 は 今 後 サポート 対 象 外 となる 予
定 です。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-3

armlink のコマンド 構 文
2.1.2 armlink からの 出 力
armlink の 呼 び 出 しに 成 功 すると、 以 下 のいずれかの 出 力 が 得 られます。
• ELF 実 行 可 能 形 式 の 実 行 イメージ
• 部 分 リンクされた ELF オブジェクト 形 式 のオブジェクト
単 純 なイメージの 場 合 、ELF 実 行 ファイルにはそのイメージの RO および RW 出 力 セ
クションとほぼ 同 じセグメントが 含 まれています。また ELF 実 行 ファイルは、イメー
ジの 出 力 セクションを 含 む ELF セクションも 保 持 しています。
ELF 実 行 可 能 形 式 の 実 行 イメージは、fromELF ユーティリティを 使 用 して 他 のファイ
ル 形 式 に 変 換 することができます。 詳 細 については、 第 7 章 「fromELF の 使 用 」を 参 照
して 下 さい。
実 行 イメージの 構 成
armlink を 使 用 して 実 行 イメージを 構 成 するとき、armlink は 以 下 を 行 います。
• 入 力 オブジェクトファイル 間 のシンボリック 参 照 を 解 決 する。
• そのままでは 不 完 全 なシンボリック 参 照 を、ライブラリからオブジェクトモ
ジュールを 抽 出 することによって 完 成 させる。
• 入 力 セクションを 属 性 と 名 前 によってソートし、 類 似 する 属 性 と 名 前 の 付 いたセ
クションを 連 続 するチャンクにマージする。
• デバッグセクションの 重 複 コピーを 削 除 する。
• 決 められたグループ 化 情 報 と 配 置 情 報 に 基 づき、オブジェクトフラグメントをメ
モリ 領 域 内 にまとめる。
• 再 配 置 可 能 値 を 再 配 置 する。
• 実 行 イメージを 生 成 する。
部 分 リンクされたオブジェクトの 構 成
armlink を 使 用 して 部 分 リンクされたオブジェクトを 構 成 するとき、armlink は 以 下 を 行
います。
• デバッグセクションの 重 複 コピーを 削 除 する。
• シンボルテーブルのサイズを 最 小 化 する。
• 未 解 決 参 照 は 未 解 決 のままにしておく。
• 次 のリンクステップへの 入 力 として 使 用 可 能 なオブジェクトを 生 成 する。
注
部 分 リンクを 行 う 場 合 、 分 散 ローディングファイルにあるコンポーネントオブジェク
トを 名 前 で 参 照 することはできません。
2-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
2.1.3 armlink オプションの 概 要
このセクションでは、armlink の 各 コマンドラインオプションについて 簡 単 に 説 明 しま
す。これらのオプションは 機 能 グループで 分 類 しています。
ヘルプおよび 情 報 へのアクセス
使 用 可 能 なコマンドラインオプションに 関 する 情 報 を 得 るには、 以 下 のオプションを
使 用 します。
-help
ツールのバージョン 番 号 を 確 認 するには、 以 下 のオプションを 使 用 します。
-vsn
出 力 タイプと 出 力 ファイル 名 の 指 定
1 つの 実 行 イメージではなく 部 分 リンクされたオブジェクトを 作 成 するには、 以 下 のオ
プションを 使 用 します。
-partial
出 力 ファイルに 名 前 を 付 けるには、 以 下 のオプションを 使 用 します。
-output
出 力 ファイル 形 式 を 指 定 するには、 以 下 のオプションを 使 用 します。
-elf
ELF はデフォルトかつ 唯 一 使 用 できる 出 力 形 式 です。fromELF を 使 用 することにより、
ELF 出 力 を 他 の 形 式 に 変 換 することができます。 詳 細 については、 第 7 章 「fromELF の
使 用 」を 参 照 して 下 さい。
via ファイルの 使 用
リンカへの 追 加 コマンドライン 引 数 を 含 む via ファイルを 指 定 するには、 以 下 のオプ
ションを 使 用 します。
-via
詳 細 については、ADS コンパイラ / ライブラリガイドの via ファイル 関 連 セクションを
参 照 して 下 さい。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-5

armlink のコマンド 構 文
イメージのメモリマップ 情 報 の 指 定
以 下 のオプションを 使 用 して、 単 純 なメモリマップを 指 定 することができます。
-reloc
-ro-base
-rw-base
-ropi
-rwpi
-split
複 雑 なイメージの 場 合 には、 以 下 のオプションを 使 用 します。
-scatter
分 散 ローディングについては、 第 5 章 「 分 散 ローディング 記 述 ファイルの 使 用 」を 参
照 して 下 さい。
-scatter オプションを 使 用 する 場 合 は、 単 純 メモリマップオプションの -ro-base、
-rw-base、-reloc、-ropi、-rwpi、-split のいずれも 使 用 できません。-scatter
オプションを 使 用 するには、 分 散 ローディング 記 述 ファイルを 使 用 して
__user_initial_stackheap() 関 数 を 再 実 装 する 必 要 があります。
単 純 メモリマップオプションは 実 行 イメージのメモリマップを 指 定 するため、 部 分 リ
ンクには 使 用 できません。 詳 細 については ADS デベロッパガイドを 参 照 して 下 さい。
イメージ 内 容 の 制 御
以 下 のオプションを 使 用 して、イメージの 内 容 に 影 響 を 及 ぼす 様 々な 要 因 を 制 御 する
ことができます。
-debug | -nodebug
-entry
-first
-keep
-last
-libpath
-edit
-locals | -nolocals
-remove | -noremove
-scanlib | -noscanlib
-match
2-6 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
イメージ 関 連 情 報 の 生 成
以 下 のオプションを 使 用 して、イメージ 関 連 情 報 の 抽 出 方 法 と 表 示 方 法 を 制 御 するこ
とができます。
-callgraph
-info
-map
-symbols
-symdefs
-xref
-xreffrom
-xrefto
-callgraphを 除 き、リンカは 標 準 出 力 ストリームstdoutで 要 求 された 情 報 をデフォ
ルトで 印 字 します。この 情 報 は、-list コマンドラインオプションを 使 用 してテキス
トファイルに 転 送 することができます。
-callgraph を 使 用 する 場 合 、この 情 報 は HTML ファイルに 保 存 されます。
output_name.htmと 命 名 されたHTMLファイルが、 生 成 イメージと 同 じディレクトリ
に 保 存 されます。
armlink の 診 断 の 制 御
以 下 のオプションを 使 用 して、armlink による 診 断 の 実 行 方 法 を 制 御 することができます。
-errors
-list
-verbose
-strict
-unresolved
-mangled
-unmangled
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-7

armlink のコマンド 構 文
2.2 armlink のコマンド 構 文
注
括 弧 を 使 用 するコマンドライン 引 数 の 場 合 、UNIX システムでは 逆 スラシュ 文 字 (\)
を 用 いて 括 弧 文 字 をエスケープしなければならない 場 合 があります。
以 下 は、armlink の 完 全 コマンド 構 文 です。
armlink [-help] [-vsn] [-partial] [-output file] [-elf] [-reloc]
[-ro-base address] [-ropi] [-rw-base address] [-rwpi] [-split] [-scatter file]
[-debug|-nodebug] [-remove (RO/RW/ZI/DBG)|-noremove] [-entry location ]
[-keep section-id] [-first section-id] [-last section-id] [-libpath pathlist]
[-scanlib|-noscanlib] [-locals|-nolocals] [-callgraph] [-info topics] [-map]
[-symbols] [-symdefs file] [-edit file] [-xref] [-xreffrom object(section)]
[-xrefto object(section)] [-errors file] [-list file] [-verbose] [-unmangled
|-mangled] [-match crossmangled] [-via file] [-strict] [-unresolved symbol]
[-MI|-LI|-BI] [input-file-list]
各 オプションの 説 明 :
-help
-vsn
-partial
-output file
-elf
頻 繁 に 使 用 される 複 数 のコマンドラインオプションの 一 覧 を 印
字 します。
armlink のバージョン 情 報 を 表 示 します。
1 つの 実 行 イメージではなく 部 分 リンクされたオブジェクトを 作
成 します。
出 力 ファイルの 名 前 を 指 定 します。このファイルは、 部 分 リンク
されたオブジェクトでも 実 行 イメージでも 構 いません。 出 力 ファ
イルの 名 前 が 指 定 されていない 場 合 、armlink は 以 下 のデフォルト
を 使 用 します。
__image.axf 出 力 が 実 行 イメージの 場 合 。
__object.o 出 力 が 部 分 リンクされたオブジェクトの 場
合 。
fileにパス 情 報 が 指 定 されていない 場 合 、このファイルは 現 在 の
作 業 ディレクトリ 内 に 作 成 されます。パス 情 報 が 指 定 されている
場 合 は、そのディレクトリがデフォルトの 出 力 ディレクトリにな
ります。
ELF 形 式 のイメージを 生 成 します。ELF は armlink がサポートし
ている 唯 一 の 出 力 形 式 です。デフォルトにはこの 形 式 が 使 用 され
ます。
2-8 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
-reloc
-ro-base address
-ropi
再 配 置 可 能 イメージを 作 成 します。
再 配 置 可 能 イメージに 含 まれる 動 的 セグメントは、リンク 後 のイ
メージの 再 配 置 に 使 用 できる 再 配 置 アドレスを 保 持 します。リン
ク 後 の 再 配 置 を 示 すサンプルコードに、 拡 張 ROM 構 成 と 実 行 時
の 動 的 ローディングが 含 まれます。
イメージをリンク 時 のアドレスにロードする 場 合 は、armlink が 作
成 する 再 配 置 可 能 イメージの 再 配 置 処 理 を 行 う 必 要 はなく、その
イメージの 有 効 なデバッグデータを 得 ることができます。しか
し、イメージをリンク 時 のアドレスとは 異 なるアドレスにロード
して 再 配 置 処 理 を 行 った 場 合 には、そのイメージ 内 にあるすべて
のデバッグデータが 無 効 になります。
-reloc を 単 体 で 使 用 すると 単 純 タイプ 1 に 似 たイメージが 生 成
されますが、その 1 つのロード 領 域 に RELOC 属 性 が 設 定 されま
す。タイプ 1 のイメージについては、P. 3-14「タイプ 1: 単 一 ロー
ド 領 域 と 連 続 出 力 領 域 」を 参 照 して 下 さい。
-reloc -split の 組 み 合 わせを 使 用 すると 単 純 タイプ 3 に 似 た
イメージが 生 成 されますが、この 場 合 は 2 つのロード 領 域 に
RELOC 属 性 が 設 定 されます。タイプ 3 のイメージについては、
P. 3-17「タイプ 3:2 ロード 領 域 と 不 連 続 出 力 領 域 」を 参 照 して 下
さい。
-split を 使 用 せずに -reloc -rw-base を 使 用 すると、エラー
が 発 生 します。
RO 出 力 セクションを 含 む 領 域 のロードアドレスと 実 行 アドレス
の 両 方 を address に 設 定 します。address は、ワード 境 界 で 整
列 させる 必 要 があります。このオプションを 指 定 していない 場 合
は、デフォルトの RO ベースアドレス 0x8000 が 使 用 されます。
RO 出 力 セクションを 含 むロード / 実 行 領 域 を 位 置 独 立 にします。
このオプションを 使 用 しない 場 合 は、その 領 域 が 絶 対 領 域 として
マーキングされます。 通 常 、 読 み 出 し 専 用 のどの 入 力 セクション
も、 読 み 出 し 専 用 位 置 独 立 セクションである 必 要 があります。こ
のオプションを 選 択 した 場 合 、armlink は 以 下 を 行 います。
• セクション 間 の 再 配 置 が 可 能 であるかどうかをチェックし
ます。
• インタワーキングベニアなど、armlink が 生 成 したすべての
コードが 読 み 出 し 専 用 の 位 置 独 立 コードであることを 確 認
します。
注
armlink が 入 力 セクションの 処 理 を 終 了 するまで、ARM ツールは
最 終 出 力 イメージが 読 み 出 し 専 用 の 位 置 独 立 イメージであるか
どうかを 決 定 できません。したがって、コンパイラやアセンブラ
に ROPI オプションを 指 定 した 場 合 でも、armlink が ROPI エラー
メッセージを 発 行 することがあります。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-9

armlink のコマンド 構 文
-rw-base address
-rwpi
RW 出 力 セクションを 含 む 領 域 の 実 行 アドレスを address に 設
定 します。address はワード 境 界 であること。
このオプションを -split と 共 に 使 用 すると、RW 出 力 セクショ
ンを 含 む 領 域 のロードアドレスと 実 行 アドレスの 両 方 がaddress
に 設 定 されます。
RW/ZI 出 力 セクションを 含 むロード / 実 行 領 域 を 位 置 独 立 にしま
す。このオプションを 使 用 しない 場 合 は、その 領 域 が 絶 対 領 域 と
してマーキングされます。このオプションを 使 用 する 場 合 は、
-rw-base に 値 を 指 定 する 必 要 があります。-rw-base が 指 定 さ
れていない 場 合 は、-rw-base 0 とみなされます。 通 常 、 書 き 込
み 可 能 な 各 入 力 セクションは、Read Only Position Independent セク
ションである 必 要 があります。
このオプションを 選 択 した 場 合 、armlink は 以 下 を 行 います。
• 読 み 出 し - 書 き 込 み 実 行 領 域 への 入 力 セクションに PI 属 性
が 設 定 されているかどうかをチェックします。
• セクション 間 の 再 配 置 が 可 能 であるかどうかをチェックし
ます。
• RO 領 域 と RW 領 域 のコピー 時 または 初 期 化 時 に 使 用 される
テーブルの 静 的 ベース 相 対 エントリアドレスを 生 成 します。
注
書 き 込 み 可 能 データに 位 置 独 立 属 性 が、コンパイラによって 設 定
されることはありません。つまり、コンパイラやアセンブラに
RWPI オプションを 指 定 した 場 合 でも、armlink はそのデータが
RWPI ではないと 診 断 する 場 合 があります。
-split
RO 出 力 セクションと RW 出 力 セクションを 含 むデフォルトの
ロード 領 域 を 2 つのロード 領 域 に 分 割 します。
• RO 出 力 セクションを 含 む 領 域 :デフォルトのロードアドレ
スは 0x8000 ですが、-ro-base オプションを 使 用 して 別
のアドレスを 指 定 することができます。
• RW 出 力 セクションを 含 む 領 域 :この 領 域 のロードアドレス
は -rw-base オプションによって 指 定 されます。このオプ
ションを 使 用 するには、-rw-base に 値 を 指 定 する 必 要 が
あります。-rw-base が 指 定 されていない 場 合 は、
-rw-base 0 とみなされます。
2-10 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
-scatter file
file に 書 かれた 分 散 ローディングの 記 述 を 使 用 してイメージの
メモリマップを 作 成 します。この 記 述 により、イメージ 内 の 様 々
な 領 域 とセクションのグループ 化 および 配 置 情 報 を 用 意 するこ
とができます。 詳 細 については、 第 5 章 「 分 散 ローディング 記 述
ファイルの 使 用 」を 参 照 して 下 さい。
注
このオプションを 使 用 する 場 合 は、スタックとヒープの 初 期 化 関
数 __user_initial_stackheap() を 再 実 装 する 必 要 がありま
す。
-debug
-nodebug
出 力 ファイルにデバッグ 情 報 を 付 加 します。このデバッグ 情 報 に
は、デバッグ 入 力 セクションとシンボル / ストリングテーブルが
含 まれています。このオプションはデフォルトで 設 定 されます。
出 力 ファイルにデバッグ 情 報 を 付 加 しません。このオプションを
使 用 するとイメージサイズは 小 さくなりますが、ソースレベルで
のデバッグが 不 可 能 になります。armlink は、 入 力 オブジェクトと
ライブラリメンバ 内 で 検 出 したすべてのデバッグ 入 力 セクショ
ンを 破 棄 し、イメージがデバッガにロードされるときにシンボル
/ ストリングテーブルを 付 加 しません。これによる 影 響 を 受 ける
のはデバッガロード 時 におけるイメージサイズのみであり、ター
ゲットにダウンロードされるバイナリイメージのサイズには 影
響 しません。
イメージではなく 部 分 リンクされたオブジェクトを 作 成 する 場
合 、armlink は 入 力 オブジェクト 内 で 検 出 したデバッグ 入 力 セク
ションを 破 棄 しますが、 部 分 リンクされたオブジェクト 内 にシン
ボル / ストリングテーブルを 作 成 します。
注
fromELF を 使 用 する 場 合 は、-nodebug を 使 用 しないで 下 さい。
デバッグ 情 報 がないイメージを 作 成 した 場 合 :
• fromELF を 使 用 しても、そのイメージを 他 のファイル 形 式
に 変 換 することができません。
• fromELF が 有 意 な 逆 アセンブリリストを 作 成 することがで
きません。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-11

armlink のコマンド 構 文
-remove (RO/RW/ZI/DBG)
入 力 セクション 上 の 未 使 用 セクションを 削 除 し、イメージから 未
使 用 セクションを 削 除 します。イメージのエントリポイントを 含
んでいる、あるいは 使 用 セクションから 参 照 される 入 力 セクショ
ンは、 使 用 するセクションとみなされます。P. 3-12「 未 使 用 セク
ションの 削 除 」を 参 照 して 下 さい。
注 意
-remove を 使 用 する 場 合 は、 例 外 ハンドラを 削 除 しないように 注
意 して 下 さい。この 場 合 は -keep オプションを 使 用 して 例 外 ハ
ンドラを 識 別 するか、ENTRY ディレクティブを 使 用 して 例 外 ハン
ドラにエントリポイントのラベルを 付 けて 下 さい。
また、セクション 属 性 修 飾 子 を 使 用 すれば、 未 使 用 セクションの
削 除 プロセスをより 厳 密 に 制 御 することができます。この 場 合 は
以 下 の 修 飾 子 を 使 用 することができます。
RO RO タイプの 全 ての 未 使 用 セクションが 削 除 されます。
RW RW タイプの 全 ての 未 使 用 セクションが 削 除 されます。
ZI ZI タイプの 全 ての 未 使 用 セクションが 削 除 されます。
DBG DEBUG タイプの 全 ての 未 使 用 セクションが 削 除 され
ます。
上 記 の 修 飾 子 を 使 用 する 場 所 と 順 序 に 制 約 はありませんが、 修 飾
子 は 必 ず 括 弧 () で 囲 み、スラッシュ / で 区 切 る 必 要 があります。
デフォルトには -remove (RO/RW/ZI/DBG) が 使 用 されます。
セクション 属 性 修 飾 子 が 指 定 されていない 場 合 は、 全 ての 未 使 用
セクションが 削 除 されます。-remove は
-remove (RO/RW/ZI/DBG) と 等 価 です。
-noremove
-entry location
このオプションを 使 用 すると、 入 力 セクション 上 の 未 使 用 セク
ションの 削 除 が 実 行 されません。 最 終 イメージ 内 の 入 力 セクショ
ンは 未 使 用 セクションも 含 めて 全 て 保 持 されます。
イメージの 固 有 の 初 期 エントリポイントを 指 定 します。イメージ
には 複 数 のエントリポイントが 含 まれている 可 能 性 があります
が、このコマンドを 使 用 して 指 定 された 初 期 エントリポイント
は、ローダが 使 用 する 実 行 ファイルヘッダにストアされます。コ
マンドラインでこのオプションを 使 用 できるのは 1 箇 所 だけで
す。イメージがロードされるとき、ARM デバッガはこのエント
リアドレスを 使 用 して PC を 初 期 化 します。 初 期 エントリポイン
トは、 以 下 の 条 件 を 満 たしている 必 要 があります。
• イメージのエントリポイントが 実 行 領 域 内 に 存 在 する。
• その 実 行 領 域 が 非 オーバレイ 領 域 であり、かつルート 実 行
領 域 である(ロードアドレス= 実 行 アドレス)。
2-12 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
-keep section-id
location を 以 下 のいずれかと 置 き 換 えます。
entry_address
数 値 を 指 定 します。
例 :
-entry 0x0
symbol イメージのエントリポイントに symbol のアドレスを
指 定 します。
例 :
-entry int_handler
symbolの 定 義 が 複 数 存 在 すると、armlinkはエラーメッ
セージを 生 成 します。
offset+object(section)
イメージのエントリポイントを、 特 定 の object に 含
まれる section 内 の offset の 位 置 に 指 定 します。
例 :
-entry 8+startup(startupseg)
-entry への 引 数 にはスペースを 入 れないで 下 さい。
input section とオブジェクト 名 のマッチングにお
いて、 大 文 字 ・ 小 文 字 は 区 別 されません。 以 下 の 簡 略
化 された 表 記 を 使 用 することができます。
• object(section) と 表 記 すれば、offset=0 と
みなします。
• 入 力 セクションが 1 つしかないとき、object の
み 表 記 できます。この 形 式 を 使 用 した 場 合 に、
object 内 に 複 数 の 非 デバッグ 入 力 セクション
が 存 在 すると、armlink はエラーメッセージを 生
成 します。
未 使 用 セクションを 削 除 する 処 理 に 対 して、 削 除 してはならない
入 力 セクションを 指 定 します。P. 3-5「イメージのメモリマップの
指 定 」を 参 照 して 下 さい。-keep へのどの 形 式 の section-id
引 数 にも、ワイルドカード * および?を 使 用 することができます。
section-id を 以 下 のいずれかに 置 き 換 えて 下 さい。
symbol 未 使 用 セクションを 削 除 する 処 理 に 対 して、symbol
が 定 義 されている 入 力 セクションを 保 持 するように 指
定 します。symbol の 定 義 が 複 数 存 在 する 場 合 、
symbol を 定 義 する 全 ての 入 力 セクションが 同 様 に 処
理 されます。
例 :
-keep int_handler
_handler で 終 わるシンボルを 定 義 する 全 てのセク
ションを 保 存 するには、 以 下 を 使 用 します。
-keep *_handler
このコマンドは、コマンドライン 上 で 何 度 でも 使 用 す
ることができます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-13

armlink のコマンド 構 文
object(section)
未 使 用 セクションを 削 除 する 処 理 に 対 して、object に
ある section を 削 除 しないように 指 定 します。 入 力 セ
クションとオブジェクト 名 のマッチングにおいて、 大
文 字 ・ 小 文 字 は 区 別 されません。 例 えば、vectors.o
オブジェクトの vect セクションを 保 持 するには 以 下
のコマンドを 使 用 します。
-keep vectors.o(vect)
vectors.o オブジェクトに 含 まれ、セクション 名 の 先
頭 3 文 字 が vec である 全 てのセクションを 保 持 するに
は、 以 下 のコマンドを 使 用 します。
-keep vectors.o(vec*)
object
このコマンドは、コマンドライン 上 で 何 度 でも 使 用 す
ることができます。
未 使 用 セクションを 削 除 するとき、object にある 1 つ
の 入 力 セクションを 保 持 するように 指 定 します。オブ
ジェクト 名 のマッチングが 行 われるとき、 大 文 字 ・ 小
文 字 は 区 別 されません。この 省 略 形 を 使 用 したときに
objectに 複 数 の 入 力 セクションが 存 在 すると、armlink
はエラーメッセージを 生 成 します。
例 :
-keep dspdata.o
名 前 が dsp で 始 まる 各 オブジェクトの 1 つの 入 力 セク
ションを 保 持 するには、 以 下 のコマンドを 使 用 します。
-keep dsp*.o
このオプションは、コマンドライン 上 で 何 度 でも 使 用
することができます。
-first section-id 選 択 された 入 力 セクションを 実 行 領 域 内 に 最 初 に 配 置 します。 例
えば、このオプションを 使 用 することによって、リセットおよび
割 り 込 みベクタを 含 むセクションを 最 初 にイメージ 内 に 配 置 す
ることができます。section-id を 以 下 のいずれかに 置 き 換 えて
下 さい。
symbol symbol を 定 義 するセクションを 選 択 します。 複 数 のセ
クションを 最 初 に 配 置 することは 不 可 能 なため、 複 数
の 定 義 を 持 つシンボルを 指 定 することはできません。
例 :
-first reset
object(section)
objectからsectionを 選 択 します。objectとその 後
の 開 括 弧 との 間 にはスペースを 入 れないで 下 さい。
例 :
-first init.o(init)
2-14 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
object
object にある 1 つの 入 力 セクションを 選 択 します。こ
の 省 略 形 を 使 用 したときに 複 数 の 入 力 セクションが 存
在 すると、armlink はエラーメッセージを 生 成 します。
例 :
-first init.o
注
分 散 ローディングを 使 用 する 場 合 は、コマンドラインで 指 定 され
た -FIRST の 代 わりに 分 散 ローディング 記 述 ファイル 内 の
+FIRST を 優 先 します。 分 散 ローディングファイルが 使 用 される
と、armlink は -first と -last が 無 視 されることを 警 告 します。
-first を 使 用 すると、 最 初 に RO を、 次 に RW を、 最 後 に ZI を 配
置 する、 領 域 内 の 出 力 セクションの 基 本 属 性 ソート 順 序 を 変 更 で
きません。 対 象 領 域 に RO セクションが 存 在 する 場 合 は、RW セ
クションまたは ZI セクションを 最 初 に 配 置 することができませ
ん。 対 象 領 域 に RO セクションまたは RW セクションが 存 在 する
場 合 は、ZI セクションを 最 初 に 配 置 することはできません。
異 なる 2 つのセクションの 両 方 を 同 一 実 行 領 域 内 の 最 初 に 配 置 す
ることはできないため、このオプションは 1つしか 使 用 できません。
-last section-id
選 択 された 入 力 セクションを 実 行 領 域 の 最 後 に 配 置 します。 例 え
ば、このオプションを 使 用 することで、チェックサムを 含 む 入 力
セクションを RW セクション 内 の 最 後 に 強 制 的 に 配 置 することが
できます。section-id を 以 下 のいずれかに 置 き 換 えて 下 さい。
symbol symbol を 定 義 するセクションを 選 択 します。 最 後 に 複
数 のセクションを 配 置 することは 不 可 能 なため、 複 数
の 定 義 を 持 つシンボルを 指 定 することはできません。
例 :
-last checksum
object(section)
objectからsectionを 選 択 します。objectとその 後
の 開 括 弧 との 間 にはスペースを 入 れないで 下 さい。
例 :
-last checksum.o(check)
object object から 1 つの 入 力 セクションを 選 択 します。
objectに 複 数 の 入 力 セクションがある 場 合 、armlinkは
エラーメッセージを 生 成 します。
注
分 散 ローディングを 使 用 する 場 合 は、コマンドラインで 指 定 され
た -LAST の 代 わりに 分 散 ローディング 記 述 ファイル 内 の +LAST
を 優 先 します。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-15

armlink のコマンド 構 文
-last を 使 用 すると、 最 初 に RO を、 次 に RW を、 最 後 に ZI を 配 置
する、 領 域 内 の 出 力 セクションの 基 本 属 性 ソート 順 序 をオーバラ
イドすることができなくなります。 対 象 領 域 に ZI セクションが 存
在 する 場 合 、RW セクションを 最 後 に 配 置 することはできません。
対 象 領 域 に RW セクションまたは ZI セクションが 存 在 する 場 合 、
RO セクションを 最 後 に 配 置 することはできません。
異 なる 2 つのセクションの 両 方 を 同 一 実 行 領 域 内 の 最 後 に 配 置 す
ることはできないため、このオプションは1つしか 使 用 できません。
-libpath pathlist ARM 標 準 C/C++ ライブラリの 探 索 に 使 用 されるパスのリストを
指 定 します。
注
このオプションがユーザライブラリの 探 索 に 影 響 を 及 ぼすこと
はありません。
これらのパスは、ARMLIB 環 境 変 数 によって 指 定 されたパスを
オーバライドします。pathlist は、 必 要 な ARM ライブラリの
検 索 のみに 使 用 されるパス path1, path2,... pathn をカン
マで 区 切 ってリストにしたものです。ARM ライブラリを 含 むディ
レクトリのデフォルトパスは、ARMLIB 環 境 変 数 によって 指 定 さ
れます。ライブラリのインクルードについては、P. 6-3「ライブラ
リの 検 索 、 選 択 、スキャン」を 参 照 して 下 さい。
-scanlib
-noscanlib
-locals
-nolocals
参 照 を 解 決 するデフォルトライブラリ( 標 準 ARM C/C++ ライブ
ラリ)のスキャンをイネーブルします。このオプションはデフォ
ルトで 設 定 されています。
リンク 時 にデフォルトライブラリをスキャンしません。
実 行 イメージの 作 成 時 に、 出 力 シンボルテーブルにローカルシン
ボルを 追 加 するようにリンカに 命 令 します。このオプションはデ
フォルトで 設 定 されています。
実 行 イメージの 作 成 時 に、 出 力 シンボルテーブルにローカルシン
ボルを 追 加 しないようにリンカに 命 令 します。 出 力 シンボルテー
ブルのサイズを 小 さくしたい 場 合 には、このオプションを 使 用 す
ることによって 最 適 化 を 図 ることができます。
2-16 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
-callgraph
関 数 のスタティックコールグラフを HTML 形 式 で 作 成 します。こ
のコールグラフから、イメージ 内 の 全 ての 関 数 の 定 義 情 報 と 参 照
情 報 を 得 ることができます。 各 関 数 func について、コールグラ
フは 以 下 を 示 します。
• 関 数 がコンパイルされるときのプロセッサ 状 態 (ARM また
は Thumb)
• func を 呼 び 出 す 関 数 の 集 合
• func によって 呼 び 出 される 関 数 の 集 合
• func のアドレスがイメージ 内 で 使 用 される 回 数
さらに、コールグラフから 以 下 の 関 数 を 識 別 することができます。
• インタワーキングベニアを 通 じて 呼 び 出 される 関 数
• イメージ 外 で 定 義 される 関 数
• 未 定 義 のままであっても 許 される 関 数 ( 弱 い 参 照 )
スタティックコールグラフからは、 以 下 のスタック 使 用 情 報 も 得
ることができます。
• 各 関 数 が 使 用 するスタックフレームのサイズ
• 対 象 関 数 が 全 てのコールシーケンスを 通 じて、つまりコー
ルグラフの 非 周 期 ファンクションコールを 通 じて 使 用 する
スタックの 最 大 サイズ
-info topics
指 定 されたトピックに 関 する 情 報 を 印 字 します。topics は 一 連
のトピックキーワードをカンマで 区 切 ったものです。トピック
キーワードには 以 下 のいずれかを 使 用 することができます。
sizes イメージ 内 の 各 入 力 オブジェクトおよびライブラリメ
ンバに 使 用 されるコードとデータ(RO データ、RW
データ、ZI データ、デバッグデータ)のサイズをリス
トします。このオプションを 使 用 すると、-info
sizes,totals が 暗 黙 に 定 義 されます。
totals 入 力 オブジェクトおよびライブラリに 使 用 されるコー
ドとデータ(RO データ、RW データ、ZI データ、デ
バッグデータ)のサイズの 合 計 を 示 します。
veneers armlink が 生 成 するベニアの 詳 細 を 示 します。ベニアの
詳 細 については、P. 3-13「ベニアの 生 成 」を 参 照 して
下 さい。
unused -removeを 使 用 したことによってイメージから 削 除 さ
れた 全 未 使 用 セクションをリストします。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-17

armlink のコマンド 構 文
注
リスト 内 のキーワード 間 にはスペースを 入 れないで 下 さい。
正 しい 入 力 の 例 :
-info sizes,totals
間 違 った 入 力 の 例 :
-info sizes, totals
-map
-symbols
-symdefs file
-edit file
-xref
イメージマップを 作 成 します。このイメージマップは、デバッガ
およびリンカが 生 成 した 入 力 セクションを 含 め、イメージ 内 の 各
ロード 領 域 、 実 行 領 域 、 入 力 セクションのアドレスとサイズを 保
持 します。
リンクステップで 使 用 される 各 ローカル / グローバルシンボルと
その 値 をリストします。この 中 にはリンカが 生 成 したシンボルも
含 まれます。
出 力 イメージからのグローバルシンボルの 定 義 を 含 んだシンボ
ル 定 義 ファイルを 作 成 します。
デフォルトでは、 全 てのグローバルシンボルが symdefs ファイル
に 書 き 込 まれます。file が 既 に 存 在 する 場 合 、リンカは 既 存 の
symdefs ファイルにリストされたシンボルだけを 出 力 します。
fileがパス 情 報 のないままで 指 定 されている 場 合 、リンカは 出 力
イメージが 書 き 込 まれるディレクトリ 内 でそのファイルを 検 索
します。ファイルが 検 出 されない 場 合 は、そのディレクトリ 内 に
作 成 されます。
このシンボル 定 義 ファイルは、 別 のイメージにリンクするときの
入 力 として 使 用 することができます。 詳 細 については、P. 4-5「 別
のイメージに 含 まれるシンボルへのアクセス」を 参 照 して 下 さい。
このオプションを 使 用 して、 出 力 バイナリのシンボルテーブルを
編 集 するコマンドを 含 んだ、ステアリングファイルを 指 定 するこ
とができます。ステアリングファイル 内 には 以 下 のコマンドを 指
定 することができます。
• グローバルシグナルを 隠 蔽 するコマンド。このオプション
を 使 用 して、オブジェクトファイル 内 の 特 定 のグローバル
シンボルを 隠 蔽 することができます。 隠 蔽 されたシンボル
は 公 開 されません。
• グローバルシンボルに 別 名 を 付 けるコマンド。このオプ
ションを 使 用 して、シンボル 名 の 競 合 を 解 消 することがで
きます。
ステアリングファイルの 構 文 については、P. 4-9「グローバルシン
ボルの 隠 蔽 と 再 命 名 」を 参 照 して 下 さい。
入 力 セクション 間 の 全 ての 相 互 参 照 をリストします。
2-18 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
-xreffrom object(section)
objectの 入 力 sectionから 別 の 入 力 セクションへの 相 互 参 照 を
リストします。このリストは -xref を 使 用 することによって 得 ら
れるリストのサブセットであり、 特 定 の 入 力 セクションからの 参
照 を 調 べたいときに 便 利 です。このオプションを 複 数 使 用 して、
複 数 入 力 セクションからの 参 照 をリストさせることができます。
-xrefto object(section)
他 の 入 力 セクションから object に 含 まれる 入 力 section への
相 互 参 照 をリストします。このリストは -xref を 使 用 すること
によって 得 られるリストのサブセットであり、 特 定 の 入 力 セク
ションへの 参 照 を 調 べたいときに 便 利 です。このオプションを 複
数 使 用 して、 複 数 入 力 セクションへの 参 照 をリストさせることが
できます。
-errors file 標 準 エラーストリームからの 診 断 を file へ 転 送 します。
-list file
-verbose
-unmangled
-mangled
-info、-map、-symbols、-xref、-xreffrom、-xrefto の
各 コマンド 出 力 からの 診 断 を file へ 転 送 します。
file がパス 情 報 のないままで 指 定 されている 場 合 、そのファイル
は 出 力 イメージが 書 き 込 まれる 出 力 ディレクトリ 内 に 作 成 され
ます。
インクルードされるオブジェクトと、それらのオブジェクトが 取
得 されるライブラリを 含 め、リンク 操 作 に 関 する 詳 しい 情 報 を 印
字 します。
診 断 メッセージ 内 、ならびに -xref、-xreffrom、-xrefto、
-symbols の 各 オプションによって 作 成 されたリスト 内 に、 符 号
化 されていないC++シンボル 名 を 表 示 するようにリンカに 指 示 し
ます。
このオプションが 選 択 されている 場 合 、リンカは C++ シンボル 名
がソースコード 表 記 のように 表 示 されるよう、これらのシンボル
名 を 復 号 化 します。このオプションはデフォルトです。
診 断 メッセージ 内 、ならびに -xref、-xreffrom、-xrefto、
-symbols の 各 オプションによって 作 成 されたリスト 内 に、 符 号
化 された C++ シンボル 名 を 表 示 するようにリンカに 指 示 します。
このオプションが 選 択 されている 場 合 、リンカは C++ シンボル 名
を 復 号 化 しません。シンボル 名 は、オブジェクトのシンボルテー
ブルに 出 現 する 形 で 表 示 されます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-19

armlink のコマンド 構 文
-match crossmangled
以 下 の 組 み 合 わせのマッチングを 行 うようにリンカに 指 示 します。
• 復 号 化 されたシンボルへの 参 照 と、 符 号 化 された 定 義
• 符 号 化 されたシンボルへの 参 照 と、 復 号 化 された 定 義
ライブラリとマッチングは 以 下 のように 行 われます。
• ライブラリメンバが 符 号 化 された 定 義 を 定 義 し、 復 号 化 さ
れた 未 解 決 参 照 があるとき、この 参 照 を 満 たすためにその
メンバがロードされます。
• ライブラリメンバが 復 号 化 された 定 義 を 定 義 し、 符 号 化 さ
れた 未 解 決 参 照 があるとき、この 参 照 を 満 たすためにその
メンバがロードされます。
注
このオプションは 部 分 リンクに 使 用 しても 作 用 しません。 部 分 オ
ブジェクトは、たとえ 符 号 化 された 定 義 が 存 在 しても、 復 号 化 さ
れたシンボルへの 全 ての 未 解 決 参 照 を 保 持 します。マッチングは
最 終 リンクステップにおいてのみ 実 行 されます。
-via file
入 力 ファイル 名 およびリンカオプションの 詳 細 リストを file か
ら 読 み 込 みます。
armlink のコマンドラインには 複 数 の -via オプションを 入 力 する
ことができます。また、-via オプションは via ファイル 内 に 含 め
ることもできます。via ファイルの 記 述 に 関 する 詳 しい 情 報 につい
ては、ADS コンパイラ / ライブラリガイドを 参 照 して 下 さい。
-strict
警 告 ではなく、エラーとして 障 害 を 引 き 起 こす 可 能 性 のある 条 件
を 通 知 するようにリンカに 指 示 します。
-unresolved symbol
未 定 義 シンボルと、symbol のグローバル 定 義 とのマッチングを
行 います。symbol は、 定 義 済 みのグローバルシンボルである 必
要 があります。シンボルが 未 定 義 シンボルとしてリストされる
と、リンクは、 失 敗 です。このオプションを 使 用 すれば、 見 当 ら
ない 関 数 への 各 参 照 をダミー 関 数 とのマッチングを 行 うことに
よって 部 分 的 に 実 装 されたシステムをテストすることが 可 能 と
なるため、トップダウン 方 式 の 開 発 では 特 に 便 利 です。
このオプションを 使 用 しても 警 告 は 表 示 されません。
2-20 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

armlinkのコマンド 構 文
input-file-list オブジェクトまたはライブラリをスペースで 区 切 ってリストし
たものです。
オブジェクトファイルの 特 殊 タイプであるsymdefファイルをこの
リストに 入 れることで、 以 前 に 生 成 されたイメージファイルのグ
ローバルシンボルの 値 を 得 ることができます。 詳 細 については、
P. 4-5「 別 のイメージに 含 まれるシンボルへのアクセス」を 参 照 し
て 下 さい。
入 力 ファイルリスト 内 でライブラリを 使 用 する 方 法 には 以 下 の 2
通 りがあります。
• ライブラリから 抽 出 し、 独 立 オブジェクトとしてイメージ
に 追 加 する 特 定 のメンバを 指 定 する。 例 えば、 入 力 ファイ
ルリスト 内 にmystring.lib(strcmp.o)と 指 定 すること
ができます。
• 非 弱 な 未 解 決 参 照 を 解 決 してくれるライブラリのメンバを
抽 出 して、 追 加 すべきライブラリをライブラリリストに 指
定 する。 例 えば、 入 力 ファイルリスト 内 に mystring.lib
と 指 定 することができます。armlink がデフォルトのライブ
ラリディレクトリをスキャンし、ほぼ 一 致 する 使 用 可 能 な
ライブラリを 選 択 すると、armlink によって 暗 黙 的 にこのラ
イブラリが、このライブラリリストに 追 加 されます。この
リストに 含 まれるライブラリのメンバは、それらが 非 弱 な
未 解 決 参 照 を 解 決 する 場 合 にのみ、イメージに 追 加 されま
す。 詳 細 については、P. 6-3「ライブラリの 検 索 、 選 択 、ス
キャン」を 参 照 して 下 さい。
armlink は、 以 下 の 順 序 で 入 力 ファイルリストを 処 理 します。
1. オブジェクトをイメージに 無 条 件 で 追 加 する。
2. パターンを 使 用 してライブラリから 選 択 したメンバを、オ
ブジェクトであるかのようにイメージに 無 条 件 で 追 加 す
る。 例 :
armlink main.o mylib(stdio.o) mylib(a*.o).
全 ての a*.o オブジェクトおよび stdio.o を 無 条 件 で 追 加
します。
3. 後 で 残 りの 非 弱 な 未 解 決 参 照 の 解 決 に 使 用 されるライブラ
リをライブラリストに 追 加 する。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 2-21

armlink のコマンド 構 文
2-22 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 3 章
基 本 リンカ 機 能
本 章 では、armlink の 基 本 機 能 について 説 明 します。 本 章 は 以 下 のセクションから 構 成
されています。
• イメージ 構 造 の 指 定 :P. 3-2
• セクションの 配 置 :P. 3-8
• 最 適 化 と 修 正 :P. 3-12
• コマンドラインオプションを 使 用 した 単 純 イメージの 作 成 :P. 3-14
より 高 度 なリンカ 機 能 については、 以 下 のセクションを 参 照 して 下 さい。
シンボルへのアクセス
第 4 章 「イメージシンボルへのアクセス」
分 散 ローディング 第 5 章 「 分 散 ローディング 記 述 ファイルの 使 用 」
ライブラリ 第 6 章 「ライブラリの 作 成 と 使 用 」
形 式 の 変 更 第 7 章 「fromELF の 使 用 」
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-1

基 本 リンカ 機 能
3.1 イメージ 構 造 の 指 定
イメージの 構 造 は 以 下 によって 定 義 されます。
• それを 構 成 する 領 域 と 出 力 セクションの 数
• イメージがロードされるときの、 上 記 の 領 域 とセクションのメモリ 内 における
位 置
• イメージが 実 行 されるときの、 上 記 の 領 域 とセクションのメモリ 内 における 位 置
3.1.1 オブジェクトとイメージのビルディングブロック
実 行 ファイルにストアされたイメージは、イメージ、 領 域 、 出 力 セクション、 入 力 セ
クションから 成 る 階 層 から 構 成 されています。
• 1つのイメージは、1 つ 以 上 の 領 域 から 構 成 されています。 各 領 域 は、1 つ 以 上 の
出 力 セクションから 構 成 されています。
• 各 出 力 セクションには、1 つ 以 上 の 入 力 セクションが 含 まれています。
• 入 力 セクションには、オブジェクトファイル 内 のコードおよびデータ 情 報 が 含 ま
れています。
P. 3-3 図 3-1は、 領 域 、 出 力 セクションならびに 入 力 セクション 間 の 関 係 を 示 しています。
3-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
図 3-1 イメージのビルディングブロック
入 力 セクション
入 力 セクションには、コードまたは 初 期 化 データを 保 持 しているものと、
初 期 化 されていないメモリ、あるいはイメージ 実 行 前 にゼロを 設 定 する
必 要 があるメモリの 断 片 を 記 述 するものがあります。 入 力 セクションに
は、RO、RW、ZI のいずれかの 属 性 を 設 定 することができます。armlink
はこれらの 属 性 を 使 用 して 入 力 セクションをグループ 化 し、 出 力 セク
ションまたは 出 力 領 域 と 呼 ばれる 大 きなビルディングブロックを 構 成 し
ます。
出 力 セクション
1 つの 出 力 セクションは、RO、RW、ZI のうちで 同 じ 属 性 を 持 った、 連
続 する 一 連 の 入 力 セクションから 構 成 されます。 出 力 セクションは、そ
れを 構 成 する 入 力 セクションと 同 じ 属 性 を 持 ちます。これらの 入 力 セク
ションは、その 出 力 セクション 内 において P. 3-8「セクションの 配 置 」で
説 明 する 規 則 にしたがってソートされます。
領 域
1 つの 領 域 は、1 ~ 3 つの 連 続 する 出 力 セクションから 構 成 されます。 領
域 内 の 出 力 セクションは、 属 性 にしたがってソートされます。 最 初 に RO
出 力 セクション、 次 に RW 出 力 セクション、 最 後 に ZI 出 力 セクションが
配 置 されます。 通 常 、 領 域 は ROM、RAM、ペリフェラルなどの 物 理 メ
モリデバイスにマップされます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-3

基 本 リンカ 機 能
3.1.2 イメージのロードビューと 実 行 ビュー
イメージ 領 域 は、ロード 時 にシステムのメモリマップに 配 置 されます。イメージを 実
行 するには、その 前 にいくつかの 領 域 を 実 行 アドレスへ 移 動 し、ZI 出 力 セクションを
作 成 しなければならない 場 合 があります。 例 えば、 初 期 化 された RW データは、ROM
内 のロードアドレスからRAM 内 の 実 行 アドレスにコピーしなければならない 場 合 があ
ります。
イメージのメモリマップには 異 なる 2 つのビューがあります( 図 3-2)。
ロードビュー
実 行 ビュー
このビューは、イメージがメモリにロードされるとき、すなわち
イメージ 実 行 開 始 前 のアドレスに 基 づいて 各 領 域 と 各 セクショ
ンを 表 します。
このビューは、イメージ 実 行 中 におけるアドレスに 基 づいて 各 領
域 と 各 セクションを 表 します。
図 3-2 ロード 時 と 実 行 時 のメモリマップ
表 3-1 は、ロードビューと 実 行 ビューの 比 較 を 示 しています。
表 3-1
ロード
説 明
実 行
説 明
ロード
アドレス
イメージの 実 行 開 始 前 まで、そのイ
メージ 内 のセクションまたは 領 域 が
ロードされているメモリ 内 のアドレ
ス。セクションまたは 非 ルート 領 域 の
ロードアドレスは、 実 行 アドレスと 異
なる 場 合 があります。
実 行 アドレス
イメージの 実 行 中 に、そのイメージ 内 の
セクションまたは 領 域 が 位 置 するアド
レス。
ロード 領 域 ロードアドレス 空 間 内 の 領 域 。 実 行 領 域 実 行 アドレス 空 間 内 の 領 域 。
3-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
3.1.3 イメージのメモリマップの 指 定
1 つのイメージを 構 成 する 領 域 および 出 力 セクションの 数 に 制 限 はありません。これら
の 領 域 がいくつあっても、 異 なるロードアドレスと 実 行 アドレスを 割 り 当 てることが
できます。イメージのメモリマップを 構 成 するには、armlink に 以 下 に 関 する 情 報 を 与
える 必 要 があります。
グループ 化 入 力 セクションを 出 力 セクションと 出 力 領 域 にグループ 化 する 方 法 。
配 置 メモリマップ 内 におけるイメージ 領 域 の 位 置 。
イメージのメモリマップの 複 雑 度 により、この 情 報 は 以 下 の 2 つの 方 法 で armlink に 渡
すことができます。
コマンドラインオプションの 使 用
イメージ 内 のロード 領 域 が 1 ~ 2 つで、 実 行 領 域 が 3 つまでしかないよ
うな 単 純 なケースには、 以 下 のオプションを 使 用 することができます。
• -ro-base
• -rw-base
• -split
• -ropi
• -rwpi
上 記 のオプションを 使 用 した 簡 素 化 された 記 述 により、 単 純 イメージに
使 用 する 分 散 ローディング 記 述 と 同 じことを 設 定 することができます。
詳 細 については、P. 3-14「コマンドラインオプションを 使 用 した 単 純 イ
メージの 作 成 」を 参 照 して 下 さい。
分 散 ローディング 記 述 ファイルの 使 用
イメージコンポーネントのグループ 化 と 配 置 を 厳 密 に 制 御 しなければな
らない 複 雑 なケースには、 記 述 ファイルを 使 用 します。 詳 細 については、
第 5 章 「 分 散 ローディング 記 述 ファイルの 使 用 」を 参 照 して 下 さい。 分
散 ローディングの 使 用 には、コマンドラインで -scatter filename を
指 定 します。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-5

基 本 リンカ 機 能
3.1.4 イメージのエントリポイント
イメージ 内 のエントリポイントによって、プログラムの 実 行 開 始 位 置 が 示 されます。エ
ントリポイントには 異 なる 2 つのタイプがあります。
初 期 エントリポイント
イメージの 初 期 エントリポイントは 1 つの 値 で 表 され、ELF ヘッダファ
イルにストアされます。オペレーティングシステムまたはブートローダ
によって RAM にロードされたプログラムに 対 して、ローダはそのイメー
ジ 内 の 初 期 エントリポイントに 制 御 を 渡 すことによって、イメージの 実
行 を 開 始 します。
1 つのイメージ 内 に 存 在 し 得 る 初 期 エントリポイントは 1 つだけです。 初
期 エントリポイントはENTRYディレクティブによって 設 定 されたエント
リポイントの 1 つとも 考 えられますが、 必 ずしもそうであるとは 限 りま
せん。
ENTRY ディレクティブによって 設 定 されたエントリポイント
エントリポイントが ENTRY ディレクティブを 使 用 してアセンブリ 言 語
ソースに 設 定 されていることがあります。 組 み 込 みシステムの 場 合 、こ
のディレクティブは 例 外 ベクタ 経 由 で 開 始 されるコードのマーキングに
使 用 するのが 一 般 的 です。
初 期 エントリポイントの 指 定
初 期 エントリポイントは -entry リンカオプションを 使 用 して 指 定 することができま
す。-entry オプションを 指 定 できるのは 1 箇 所 だけです。 詳 細 については、P. 2-8
「armlink のコマンド 構 文 」を 参 照 して 下 さい。
ブートローダまたはオペレーティングシステムのプログラムローダといったローダに
よって 実 行 されるイメージには、 初 期 エントリポイントが 含 まれている 必 要 がありま
す。 例 えば、OS のイメージはブートローダによってロードされ、 実 行 ファイルヘッダ
内 に 指 定 された 初 期 エントリポイントから 実 行 が 開 始 されます。このイメージはロー
ドされた 後 にブートローダをオーバライドし、OS となります。オペレーティングシス
テムの 場 合 、そのイメージには 例 外 ハンドラアドレスなどの 他 のエントリポイントが
含 まれています。
ゼロ 番 地 に ROM を 置 く 組 み 込 みアプリケーションの 場 合 には、-entry 0x0(または
上 位 ベクタを 使 用 する CPU では 0xffff0000)を 使 用 します。
初 期 エントリポイントは、 以 下 の 条 件 を 満 たしている 必 要 があります。
• そのイメージのエントリポイントが 実 行 領 域 内 に 存 在 していること。
• その 実 行 領 域 が 非 オーバレイ 領 域 であり、かつルート 領 域 であること(ロードア
ドレスが 実 行 アドレスと 同 じであること)。
3-6 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
-entry オプションを 使 用 して 初 期 エントリポイントを 指 定 していない 場 合 でも、リン
カは 可 能 な 限 りこれを 設 定 しようと 試 みます。
• -entry オプションを 使 用 していない 場 合 に、 入 力 オブジェクトに ENTRY ディ
レクティブによって 設 定 されたエントリポイントが 1 つだけ 存 在 しているとき、
リンカはそのエントリポイントをイメージの 初 期 エントリポイントとして 使 用
します。
• -entry オプションが 使 用 されておらず、さらに 以 下 のどちらかが 真 である 場 合
に、リンカは 初 期 エントリポイントを 含 まない 出 力 オブジェクトを 生 成 します。
— ENTRYディレクティブを 使 用 して 複 数 のエントリポイントが 指 定 されてい
る。
— ENTRYディレクティブを 使 用 して 指 定 されているエントリポイントが 存 在
しない。
出 力 オブジェクトに 初 期 エントリポイントが 含 まれていない 場 合 、リンカは 以 下
の 警 告 を 発 行 します。
L6305W: Image does not have an entry point. (Not specified or
not set due to multiple choices)
複 数 エントリポイントの 指 定
組 み 込 みイメージには 複 数 のエントリポイントを 記 述 することができます。 例 えば、
一 般 的 に 組 み 込 みイメージには、Reset、IRQ、FIQ、SVC、UNDEF、ABORT の 各 例 外
がそのイメージの 実 行 中 に 制 御 を 渡 すために 使 用 するエントリポイントが 含 まれてい
ます。
ENTRY ディレクティブを 使 用 すれば、1 つのイメージ 内 に 複 数 のエントリポイントを 記
述 することができます。このディレクティブは ENTRY キーワードで 出 力 コードセク
ションをマーキングし、リンカが 未 使 用 セクションの 削 除 を 実 行 する 際 にそのセク
ションを 削 除 しないように 指 示 します。C または C++ で 記 述 したプログラムの 場 合 、C
ライブラリにある __main() 関 数 もエントリポイントとなります。ENTRY ディレク
ティブの 詳 細 については、ADS アセンブラガイドを 参 照 して 下 さい。
組 み 込 みイメージがローダによって 使 用 される 場 合 には、そのイメージのヘッダに 1 つ
の 初 期 エントリポイントを 指 定 する 必 要 があります。 詳 細 については、P. 3-6「 初 期 エ
ントリポイントの 指 定 」を 参 照 して 下 さい。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-7

基 本 リンカ 機 能
3.2 セクションの 配 置
リンカは、 領 域 内 の 全 ての 入 力 セクションをその 属 性 にしたがってソートします。 同
一 属 性 を 持 つ 入 力 セクションは、その 領 域 内 において 一 連 の 連 続 したブロックを 形 成
します。
各 入 力 セクションのベースアドレスはリンカが 定 義 するソート 順 序 によって 決 定 さ
れ、そのベースアドレスを 保 持 する 出 力 セクション 内 で 正 しく 整 列 されます。
イメージを 生 成 するとき、リンカは 以 下 の 順 序 で 入 力 セクションをソートします。
• 属 性
• 入 力 セクションの 名 前
• 入 力 リスト 内 における 各 セクションの 位 置 (-first または -last オプション
によってオーバライドされている 位 置 を 除 く)。 詳 細 については、P. 3-10「FIRST
と LAST を 使 用 したセクションの 配 置 」を 参 照 して 下 さい。
デフォルトでリンカが 作 成 するイメージは、RO と RW に 加 え、オプションで ZI の 属
性 を 持 つ 出 力 セクションから 構 成 されます。メモリ 管 理 ハードウェアを 搭 載 したシス
テムでは、ランタイムに RO 出 力 セクションを 保 護 することができます。また、RO セ
クションはターゲットの ROM 内 に 配 置 することも 可 能 です。
3-8 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
3.2.1 属 性 による 入 力 セクションの 順 序 付 け
特 定 言 語 のランタイムシステムと 関 連 付 けられたイメージ 部 分 は、 数 を 最 小 限 に 抑 え
た 連 続 領 域 にまとめられます。armlink は、 入 力 セクションを 属 性 によって 以 下 のよう
に 順 序 付 けます。
• 読 み 出 し 専 用 コード
• 読 み 出 し 専 用 データ
• 読 み 出 し / 書 き 込 みコード
• 他 の 初 期 化 データ
• ゼロ 初 期 化 ( 未 初 期 化 )データ
同 一 属 性 を 持 つ 入 力 セクションは、 名 前 によって 順 序 付 けされます。 名 前 は 大 文 字 ・ 小
文 字 を 区 別 するものとみなされ、ASCII 文 字 照 合 シーケンスを 使 用 してアルファベット
順 で 比 較 されます。
同 一 の 属 性 と 名 前 を 持 つ 入 力 セクションは、 入 力 リスト 内 における 相 対 位 置 にした
がって 順 序 付 けられます。
したがって、ライブラリからインクルードされる、 同 じ 属 性 と 名 前 を 持 つ 入 力 セクショ
ンの 位 置 は 予 測 不 可 能 です。 厳 密 な 位 置 設 定 を 行 う 必 要 がある 場 合 には、モジュール
を 手 動 で 抽 出 し、それを 入 力 リストに 組 み 込 むことができます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-9

基 本 リンカ 機 能
3.2.2 FIRST と LAST を 使 用 したセクションの 配 置
領 域 内 の 全 ての RO コード 入 力 セクションは 連 続 して 1 つの RO 出 力 セクションを 形 成
し、この 出 力 セクションは 全 ての RW 入 力 セクションを 含 む 出 力 セクションよりも 優
先 されます。
分 散 ローディングを 使 用 しない 場 合 には、リンカオプション -first および -last を
使 用 して 入 力 セクションを 配 置 します。
分 散 ローディングを 使 用 するときに 配 置 順 序 が 重 要 な 場 合 には、 分 散 ロード 記 述 ファ
イル 内 で 擬 似 属 性 FIRST および LAST を 使 用 し、 実 行 領 域 内 の 最 初 と 最 後 の 入 力 セク
ションをマーキングします。
ただし、FIRST と LAST の 使 用 方 法 が 基 本 属 性 ソート 順 序 に 違 反 してはなりません。つ
まり、ある 入 力 セクションは、それを 含 む 出 力 セクションが 実 行 領 域 内 の 最 初 (また
は 最 後 )の 出 力 セクションである 場 合 に、その 領 域 内 の 最 初 (または 最 後 )に 配 置 す
ることができます。 例 えば、RO 入 力 セクションを 含 む 実 行 領 域 内 の FIRST 入 力 セク
ションは、RO 入 力 セクションでなければなりません。 同 様 に、その 実 行 領 域 に ZI 入
力 セクションが 含 まれている 場 合 には、LAST 入 力 セクションは ZI 入 力 セクションで
なければなりません。
各 出 力 セクション 内 において、 入 力 セクションはその 名 前 にしたがってアルファベッ
ト 順 でソートされ、 次 に 入 力 順 序 内 における 位 置 によってソートされます。
3-10 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
3.2.3 セクションの 整 列
入 力 セクションが 順 序 付 けられると、armlink はベースアドレスが 固 定 される 前 に 必 要
に 応 じてパディングを 行 い、 各 入 力 セクションをそのアライメントの 倍 数 になるアド
レスから 開 始 させます。アライメントは 拡 張 する( 通 常 は 4 バイト 整 列 のものを 8 バ
イト 整 列 に 設 定 する)ことが 可 能 ですが、 自 然 アライメントを 縮 小 する( 通 常 は 4 バ
イト 整 列 のものを 2 バイト 整 列 に 設 定 する)ことはできません。 入 力 セクションはワー
ド 境 界 で 整 列 させるのが 一 般 的 です。 入 力 セクションのアライメントは、 以 下 のいず
れかを 使 用 して 指 定 することができます。
ALIGN
__align
この 属 性 はアセンブリ 言 語 から AREA ディレクティブに 使 用 します。こ
の 場 合 の 入 力 セクションのアドレスは、2 (align 属 性 値 )の 倍 数 となります。
C からの 場 合 はこの 修 飾 子 を 使 用 します。 入 力 セクションアドレスは、
指 定 値 (2 の 累 乗 )の 倍 数 となります。
__alignについては、 例 3-1およびADSコンパイラ/ライブラリガイドの__alignの 項 を 参
照 して 下 さい。ALIGN については、 例 3-2 および ADS アセンブラガイドの ALIGN の
項 を 参 照 して 下 さい。
例 3-1 __align 修 飾 子 の 使 用
__align(8) long long big_var; // big_var eight-byte aligned
例 3-2 アセンブリコードにおける ALIGN 属 性 の 使 用
AREA LDR_LABEL, CODE, READONLY, ALIGN=3 ; align on eight-byte boundary
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-11

基 本 リンカ 機 能
3.3 最 適 化 と 修 正
armlink は、 重 複 セクションを 削 除 するために 最 適 化 と 修 正 を 何 度 か 実 行 し、ARM コー
ドと Thumb コード 間 のインタワーキングを 可 能 にして 長 分 岐 を 実 現 します。
3.3.1 共 通 デバッグセクションの 削 除
コンパイラとアセンブラは、コンパイル 単 位 である 各 ソースファイルにつき、1 つのデ
バッグセクションセットを 生 成 します。armlink は、 特 定 ソースファイルのデバッグセ
クションのコピーを 複 数 検 出 し、 最 終 イメージには 1 つのコピーだけを 残 して、その
他 全 てのコピーを 破 棄 します。これにより、イメージのデバッグサイズを 大 幅 に 縮 小
することができます。
3.3.2 共 通 セクションの 削 除
ソース 内 にインライン 関 数 またはテンプレートが 使 用 されている 場 合 、ARM C++ コン
パイラはインライン 関 数 およびテンプレート 関 数 の 独 立 した 複 数 のコピーを 保 持 する
ように、オブジェクトを 生 成 します。 共 通 ヘッダファイル 内 で 宣 言 されている 場 合 、こ
れらの 関 数 はその 後 リンクする 個 々のオブジェクト 内 で 何 度 も 定 義 される 可 能 性 があ
ります。 重 複 を 削 除 するため、コンパイラはこれらの 関 数 を 共 通 コードセクションの
別 々のインスタンスにコンパイルし、armlinkは 各 共 通 コードセクションの1つのコピー
だけを 保 持 します。
共 通 コードセクションの 個 々のインスタンスが 同 一 でない 場 合 もあります。 例 えば、こ
れらのコピーのいくつかは、 異 なる(ただし 互 換 性 のある)ビルドオプション、 最 適
化 オプション、あるいはデバッグオプションを 使 用 してビルドされたライブラリ 内 で
検 出 される 場 合 があります。
コピーが 同 一 でない 場 合 、armlink は 入 力 オブジェクトの 属 性 に 基 づき、 各 共 通 コード
セクションの 最 も 可 用 性 の 高 い 部 分 を 一 つにして 保 持 します。
3.3.3 未 使 用 セクションの 削 除
未 使 用 セクションの 削 除 によって、 一 度 も 実 行 されないコード、またはそのコードに
よって 参 照 されないデータが 最 終 イメージから 削 除 されます。この 最 適 化 は、
-(no)remove、-first、-last、-keep のリンカオプションを 使 用 して 制 御 するこ
とができます。-info unused リンカオプションを 使 用 すると、 削 除 された 未 使 用 セ
クションのリストを 生 成 するようにリンカに 指 示 することができます。
3-12 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
入 力 セクションは 以 下 の 条 件 で 最 終 イメージに 保 持 されます。
• エントリポイントが 含 まれている 場 合
• エントリポイントを 含 む 入 力 セクションからの 非 弱 な 参 照 によって、 直 接 的 また
は 間 接 的 に 参 照 される 場 合
• -first オプションまたは -last オプション(あるいはこれと 同 じ 分 散 ローディ
ング 機 能 )を 使 用 して、 最 初 または 最 後 の 入 力 セクションが 指 定 されている 場 合
• -keep オプションによって 削 除 不 可 とマーキングされている 場 合
3.3.4 ベニアの 生 成
armlink は、 以 下 の 場 合 にベニアを 生 成 する 必 要 があります。
• 分 岐 によって ARM 状 態 と Thumb 状 態 が 変 更 される 場 合
• 分 岐 のデスティネーションが、 現 在 の 状 態 の 分 岐 範 囲 外 にある 場 合
ベニアは、 分 岐 範 囲 を 拡 大 してプロセッサ 状 態 を 変 更 することができます。armlink は、
長 分 岐 と 状 態 変 更 を 結 合 します。インタワーキングベニアも 全 て 長 分 岐 ベニアです。
以 下 のベニアタイプは、それぞれ 異 なる 分 岐 要 件 を 満 たします。 必 要 に 応 じ、リンカ
は 位 置 独 立 なベニアを 生 成 します。
ARM → ARM
ARM → Thumb
Thumb → ARM
Thumb → Thumb
長 分 岐
長 分 岐 とインターワーキング
長 分 岐 とインタワーキング
長 分 岐
armlink は、 各 ベニアに 対 して Veneer$$Code と 呼 ばれる 1 つの 入 力 セクションを 作
成 します。ベニアは、 要 件 を 満 たせる 既 存 のベニアが 存 在 しない 場 合 に 初 めて 生 成 さ
れます。2 つの 入 力 セクションに 同 一 デスティネーションへの 長 分 岐 が 含 まれていると
き、1 つのベニアに 両 方 のセクションから 到 達 できる 場 合 には、1 つのベニアだけが 生
成 されます。
1 つの 入 力 セクションにベニアを 収 集 する 場 合 には、それによって 生 成 されるベニア 入
力 セクションが 他 の 入 力 セクションの 範 囲 内 に 収 まらない 可 能 性 があるため、 全 ての
ベニアを 収 集 することはできません。これらのセクションがアドレシング 範 囲 内 にな
い 場 合 、 長 分 岐 は 不 可 能 です。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-13

基 本 リンカ 機 能
3.4 コマンドラインオプションを 使 用 した 単 純 イメージの 作 成
単 純 イメージは、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 の 3 つのオプションを 使 用 します。
単 純 イメージのどのタイプの 場 合 にも、 使 用 できる 実 行 領 域 は 3 つまでです。
• 最 初 の 実 行 領 域 には RO 出 力 セクションが 含 まれます。
• 2 番 目 の 実 行 領 域 には RW 出 力 セクションが 含 まれます( 存 在 する 場 合 )。
• 3 番 目 の 実 行 領 域 には ZI 出 力 セクションが 含 まれます( 存 在 する 場 合 )。
これらの 実 行 領 域 は、RO、RW ならびに ZI 実 行 領 域 と 呼 びます。
単 純 イメージは 分 散 ローディングファイルを 使 用 して 作 成 することも 可 能 です。 分 散
ローディングファイルの 詳 細 については、P. 5-28「 等 価 な 分 散 ローディング 記 述 を 使 用
した 単 純 イメージの 生 成 」を 参 照 して 下 さい。
3.4.1 タイプ 1: : 単 一 ロード 領 域 と 連 続 出 力 領 域
このタイプのイメージはロードビュー 内 の 1 つのロード 領 域 から 構 成 され、その 3 つ
の 実 行 領 域 はメモリマップ 内 に 隣 接 して 配 置 されます。この 方 法 は、OS ブートローダ、
Angel、デスクトップシステムなど、RAM にプログラムをロードするシステムに 適 し
ています(P. 3-15 図 3-3 参 照 )。
3-14 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
図 3-3 タイプ 1
ロードビュー
単 一 のロード 領 域 は、 隣 接 して 配 置 された RO および RW 出 力 セクションから 構 成 さ
れます。ロード 時 には ZI 出 力 セクションは 存 在 しません。ZI 出 力 セクションは、 実 行
前 にイメージファイル 内 の 出 力 セクションの 記 述 を 使 用 して 作 成 されます。
実 行 ビュー
RO、RW、ZI の 各 出 力 セクションを 含 む 3 つの 実 行 領 域 は 隣 接 して 配 置 されます。RO
および RW 実 行 領 域 の 実 行 アドレスはロードアドレスと 同 じであるため、ロードアド
レスから 実 行 アドレスに 移 動 させる 必 要 のあるものはありません。しかし、ZI 出 力 セ
クションを 含 む ZI 実 行 領 域 は、 実 行 開 始 前 に 作 成 されます。
RO 出 力 を 含 む 領 域 のロード / 実 行 アドレスを 指 定 するには、armlink オプション
-ro-base address を 使 用 します。このデフォルトアドレスは 0x8000 です( 図 3-3 参
照 )。
再 配 置 可 能 イメージを 作 成 するには、-reloc オプションを 使 用 します。-reloc をそ
れだけで 使 用 すると、 単 純 タイプ 1 に 似 たイメージが 生 成 されますが、その 1 つのロー
ド 領 域 に RELOC 属 性 が 設 定 されます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-15

基 本 リンカ 機 能
3.4.2 タイプ 2: : 単 一 ロード 領 域 と 不 連 続 出 力 領 域
このタイプのイメージは 1 つのロード 領 域 で 構 成 され、 実 行 ビューでは 3 つの 実 行 領
域 から 構 成 されます。RW 実 行 領 域 と RO 実 行 領 域 は 隣 接 していません。この 方 法 は、
ROM ベースの 組 み 込 みシステムなどに 使 用 できます( 図 3-4 参 照 )。
図 3-4 タイプ 2
ロードビュー
ロードビューでは、ROM などに 連 続 で 配 置 された RO および RW 出 力 セクションが 1
つのロード 領 域 を 構 成 します。ロード 時 には ZI 出 力 セクションは 存 在 しません。ZI 出
力 セクションは、 実 行 前 にイメージファイル 内 の 出 力 セクションの 記 述 を 使 用 して 作
成 されます。
実 行 ビュー
実 行 ビューでは、 最 初 の 実 行 領 域 に RO 出 力 セクションが、2 番 目 の 実 行 領 域 に RW お
よび ZI 出 力 セクションが 含 まれます。
RO 出 力 セクションを 含 む 領 域 の 実 行 アドレスはそのロードアドレスと 同 じであるた
め、RO 出 力 セクションを 移 動 させる 必 要 はありません。
3-16 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

基 本 リンカ 機 能
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 の 直 ぐ 上 に 配 置 されます。
3.4.3 タイプ 3:2 ロード 領 域 と 不 連 続 出 力 領 域
このタイプのイメージはタイプ 2 のイメージと 似 ていますが、ここではタイプ 2 の 1 つ
のロード 領 域 が 2 つのロード 領 域 に 分 割 されます( 図 3-5)。
図 3-5 タイプ 3
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 3-17

基 本 リンカ 機 能
ロードビュー
ロードビューでは、 最 初 のロード 領 域 が RO 出 力 セクションから 構 成 され、2 番 目 の
ロード 領 域 が RW 出 力 セクションから 構 成 されます。ロード 時 には ZI 出 力 セクション
は 存 在 しません。ZI 出 力 セクションは、 実 行 前 にイメージファイル 内 の 出 力 セクショ
ンの 記 述 を 使 用 して 作 成 されます。
実 行 ビュー
実 行 ビューでは、 最 初 の 実 行 領 域 に RO 出 力 セクションが、2 番 目 の 実 行 領 域 に RW お
よび ZI 出 力 セクションが 含 まれます。
RO 領 域 の 実 行 アドレスはそのロードアドレスと 同 じであるため、RO 出 力 セクション
の 内 容 がロードアドレスから 実 行 アドレスに 移 動 されることはありません。
RW 領 域 の 実 行 アドレスもロードアドレスと 同 じであるため、RW 出 力 セクションの 内
容 はロードアドレスから 実 行 アドレスに 移 動 されません。しかし、ZI 出 力 セクション
は 実 行 開 始 前 に 作 成 され、RW 領 域 の 後 に 配 置 されます。
ロード / 実 行 アドレスは 以 下 のリンカオプションを 使 用 して 指 定 することができます。
-reloc
-reloc -splitの 組 み 合 わせを 使 用 すると 単 純 タイプ3と 同 様 のイメー
ジが 作 成 されますが、2 つのロード 領 域 に RELOC 属 性 が 設 定 されます。
-split このオプションは、-ro-base と -rw-base を 使 用 して 2 つの 領 域 を
別 々に 配 置 できるように、デフォルトの 1 つのロード 領 域 (RO 出 力 セ
クションと RW 出 力 セクションを 含 む 領 域 )を 2 つのロード 領 域 ( 一 方
が RO 出 力 セクションを、 他 方 が RW 出 力 セクションを 含 む)に 分 割 し
ます。
-ro-base address
RO セクションを 含 む 領 域 のロード / 実 行 アドレスに 4 バイト 整 列 の
address( 例 :ROM 内 の 先 頭 位 置 のアドレス)を 設 定 するように armlink
に 指 示 します。-ro-base オプションを 使 用 してこのアドレスが 指 定 さ
れていない 場 合 、armlink はデフォルト 値 の 0x8000 を 使 用 します。
-rw-base address
RW 出 力 セクションを 含 む 領 域 の 実 行 アドレスに、4 バイト 整 列 の
address を 設 定 するように armlink に 指 示 します。このオプションを
-split と 共 に 使 用 すると、RW 領 域 のロードアドレスと 実 行 アドレスの
両 方 が 指 定 されます。
-splitを 使 用 せずに-reloc -rw-baseを 使 用 すると、エラーが 発 生 し
ます。
3-18 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 4 章
イメージシンボルへのアクセス
本 章 では、armlink を 使 用 したシンボルの 参 照 方 法 について 説 明 します。 本 章 は 以 下 の
セクションから 構 成 されています。
• リンカ 定 義 シンボルへのアクセス:P. 4-2
• 別 のイメージに 含 まれるシンボルへのアクセス:P. 4-5
• グローバルシンボルの 隠 蔽 と 再 命 名 :P. 4-9
• $Super$$ と $Sub$$ を 使 用 したシンボル 定 義 のオーバライド:P. 4-12
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 4-1

イメージシンボルへのアクセス
4.1 リンカ 定 義 シンボルへのアクセス
armlink が 定 義 するいくつかのシンボルには、 文 字 シーケンス $$ が 含 まれています。こ
れらのシンボルと、シーケンス $$ を 含 む 他 の 全 ての 外 部 名 は、ARM で 予 約 している
名 前 です。これらのシンボルは、 領 域 、 出 力 セクション、 入 力 セクションのそれぞれ
のベースアドレスと 範 囲 を 指 定 する 目 的 で 使 用 されます。
アセンブリ 言 語 プログラムの 場 合 、これらのシンボリックアドレスはインポートして
再 配 置 可 能 アドレスとして 使 用 することが 可 能 であり、また C/C++ ソースコードから
はを extern シンボルとして 参 照 することができます。
注
リンカ 定 義 シンボルは、コードがこれらを 参 照 する 場 合 にのみ 定 義 されます。
4.1.1 領 域 関 連 シンボル
領 域 関 連 シンボルは、armlink がイメージを 作 成 するときに 生 成 されます。 表 4-1 は、イ
メージ 内 に 存 在 する 各 実 行 領 域 に 対 して armlink が 生 成 するシンボルを 示 しています。
分 散 ローディングを 使 用 する 場 合 は、 記 述 ファイルがイメージ 内 の 全 ての 実 行 領 域 を
命 名 し、 各 領 域 のロードアドレスと 実 行 アドレスを 定 義 します( 第 5 章 「 分 散 ローディ
ング 記 述 ファイルの 使 用 」 参 照 )。
分 散 ローディングを 使 用 しない 場 合 、リンカはregion_nameの 値 に 以 下 を 使 用 します。
• ER_RO 読 み 出 し 専 用 領 域
• ER_RW 読 み 出 し / 書 き 込 み 領 域
• ER_ZI ゼロ 初 期 化 領 域
ZI 出 力 セクションを 含 む 全 ての 実 行 領 域 に 対 し、armlink は $$ZI$$ を 含 む 追 加 シンボ
ルを 生 成 します。
表 4-1 領 域 関 連 リンカシンボル
シンボル
Load$$region_name$$Base
Image$$region_name$$Base
説 明
領 域 のロードアドレス。
領 域 の 実 行 アドレス。
Image$$region_name$$Length 実 行 領 域 のバイト 長 (4 の 倍 数 )。
Image$$region_name$$Limit
実 行 領 域 の 終 わりを 超 えるバイトアドレス。
4-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

イメージシンボルへのアクセス
表 4-1 領 域 関 連 リンカシンボル
シンボル
Image$$region_name$$ZI$$Base
説 明
この 領 域 にある ZI 出 力 セクションの 実 行 アドレス。
Image$$region_name$$ZI$$Length ZI 出 力 セクションのバイト 長 (4 の 倍 数 )。
Image$$region_name$$ZI$$Limit
実 行 領 域 に 含 まれる ZI 出 力 セクションの 終 わりを 超
えるバイトアドレス。
注
• イメージの ZI 出 力 セクションは 静 的 に 生 成 されるのではなく、ランタイムに 動
的 に 自 動 生 成 されます。したがって、ZI 出 力 セクションのロードアドレスシンボ
ルはありません。
• セクション 関 連 シンボルよりも 領 域 関 連 シンボルを 優 先 して 使 用 することを 推
奨 します。
ZI 領 域 の 上 にスタックとヒープを 配 置 する
領 域 関 連 シンボルの 一 般 的 な 使 用 目 的 の 1 つに、ZI 領 域 のすぐ 上 にヒープを 配 置 する
ことが 挙 げられます。 例 4-1 は、__user_initial_stackheap() の 再 ターゲッティ
ング 化 バージョンをアセンブリ 言 語 で 作 成 する 方 法 を 示 しています。この 例 では、ARM
Cライブラリからデフォルトである1 領 域 のメモリモデルを 使 用 することを 想 定 してい
ます。 詳 細 については、ADS コンパイラ / ライブラリガイドの
__user_initial_stackheap() の 項 を 参 照 して 下 さい。C を 使 用 する 場 合 の 方 法 に
ついては、ADS デベロッパガイドの「ROM へのコードの 書 き 込 み」の 章 にある
retarget.c の 説 明 を 参 照 して 下 さい。
例 4-1
IMPORT ||Image$$region_name$$ZI$$Limit||
__user_initial_stackheap
LDR r0, =||Image$$region_name$$ZI$$Limit||
MOV pc, lr
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 4-3

イメージシンボルへのアクセス
4.1.2 セクション 関 連 シンボル
表 4-2 が 示 す 出 力 セクションシンボルは、コマンドラインオプションを 使 用 して 単 純 イ
メージを 作 成 するときに 生 成 されます。 単 純 イメージには、3 つの 実 行 領 域 を 生 成 する
3 つの 出 力 セクション(RO、RW、ZI)が 含 まれています。このイメージ 内 にある 全 て
の 入 力 セクションに 対 し、armlink は 表 4-2 が 示 す 入 力 シンボルを 生 成 します。
表 4-2 セクション 関 連 リンカシンボル
シンボル
セクション
のタイプ
説 明
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 出 力 セクションの 終 わりを 超 えるバイトアドレス。
SectionName$$Base 入 力 SectionName と 呼 ばれる 連 結 セクションの 開 始 アドレス。
SectionName$$Limit 入 力 SectionName と 呼 ばれる 連 結 セクションの 終 わりを 超 える
バイトアドレス。
注
コードが 入 力 セクションシンボルを 参 照 する 場 合 、イメージ 内 に 含 まれる 同 一 名 の 全
ての 入 力 セクションは、そのイメージのメモリマップ 内 に 連 続 配 置 するものとみなさ
れます。 不 連 続 メモリ 上 でベースシンボルと 範 囲 シンボルを 使 用 すると 予 測 不 能 かつ
有 害 な 結 果 をもたらすことが 多 いため、 分 散 ローディング 記 述 によって 入 力 セクショ
ンが 不 連 続 配 置 された 場 合 には、armlink はこれをエラーと 診 断 します。
分 散 ローディングファイルを 使 用 する 場 合 の 表 4-2の 出 力 セクションシンボルは 未 定 義
です。コードがこれらのシンボルにアクセスする 場 合 は、 弱 い 参 照 として 処 理 する 必
要 があります。
__user_initial_stackheap() の 標 準 実 装 では、Image$$ZI$$Limit の 値 を 使 用
します。したがって、 分 散 ローディングファイルを 使 用 する 場 合 には
__user_initial_stackheap() を 再 実 装 し、ヒープとスタックの 境 界 を 設 定 する 必
要 があります。ADS コンパイラ / ライブラリガイドのライブラリメモリモデル 関 連 セク
ションと、P. 4-2「 領 域 関 連 シンボル」を 参 照 して 下 さい。
4-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

イメージシンボルへのアクセス
4.2 別 のイメージに 含 まれるシンボルへのアクセス
シンボル 定 義 (symdefs)ファイルを 使 用 することにより、あるイメージに 別 のイメー
ジに 含 まれるグローバルシンボルの 値 を 知 らせることができます。
このファイルは、 例 えば、ROM に 常 駐 する 1 つのイメージと、RAM にロードされる
複 数 のイメージがある 場 合 などに 使 用 できます。RAM にロードされるイメージは、
ROM にあるイメージのグローバル 関 数 とグローバルデータにアクセスすることができ
ます。
4.2.1 symdefs ファイルの 読 み 出 し
symdefs ファイルは、コードもデータも 含 まない、シンボル 情 報 だけのオブジェクト
ファイルと 考 えられます。symdefs ファイルを 読 み 出 すには、 他 のオブジェクトファイ
ルの 場 合 と 同 様 に、このファイルをファイルリストに 追 加 します。armlink はこのファ
イルを 読 み 出 し、ファイルに 含 まれているシンボルとそれらの 値 を 出 力 シンボルテー
ブルに 追 加 します。 追 加 されたシンボルには ABSOLUTE と GLOBAL の 2 つの 属 性 があ
ります。
部 分 リンクが 実 行 されている 場 合 は、これらのシンボルが 出 力 オブジェクトシンボル
テーブルに 追 加 されます。 完 全 リンクが 実 行 されている 場 合 は、これらのシンボルは
イメージシンボルテーブルに 追 加 されます。
ファイル 内 に 無 効 な 行 を 検 出 すると、armlink はエラーメッセージを 生 成 します。 行 は
以 下 の 場 合 に 無 効 となります。
• 欠 けている 列 がある 場 合
• いずれかの 列 に 無 効 な 値 が 含 まれている 場 合
symdefs ファイルから 抽 出 されるシンボルは、オブジェクトシンボルテーブルから 抽 出
されるシンボルと 全 く 同 じ 方 法 で 処 理 されます。 多 重 シンボル 定 義 および ARM/Thumb
同 義 語 に 関 しても、 同 じ 制 約 条 件 が 適 用 されます。
4.2.2 symdefs ファイルの 作 成
symdefs ファイルを 作 成 するには、armlink オプション -symdefs filename を 使 用 し
ます。
armlink は、 正 常 な 最 終 リンクステージの 間 に symdefs ファイルを 作 成 します。 部 分 リ
ンクの 場 合 と、 最 終 リンクに 失 敗 した 場 合 には、symdefs ファイルは 作 成 されません。
注
filename が 存 在 しない 場 合 には、 全 てのグローバルシンボルを 含 むファイルが 作 成 さ
れます。filename が 存 在 する 場 合 には、armlink がそのファイルに 再 度 書 き 込 みを 行
うときに 出 力 されるシンボルの 選 択 に、filename の 既 存 の 内 容 が 使 用 されます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 4-5

イメージシンボルへのアクセス
グローバルシンボルのサブセットの 出 力
デフォルトでは、 全 てのグローバルシンボルが symdefs ファイルに 書 き 込 まれます。
filename が 存 在 する 場 合 、armlink はその 内 容 を 使 用 して、 出 力 をグローバルシンボル
のサブセットに 制 限 します。 出 力 シンボルを 制 限 するには:
1. image1 の 最 終 リンクを 行 うところで -symdefs filename を 指 定 する。armlink
が symdef ファイル filename を 作 成 します。
2. テキストエディタで filename を 開 き、 最 終 リストに 不 要 なシンボル 項 目 を 削
除 し、ファイルを 保 存 する。
3. image1 の 最 終 リンクを 行 うときに -symdefs filename を 指 定 する。
image1 を 作 成 する 1 つ 以 上 のオブジェクトの 使 用 方 法 が 変 更 された 後 でシンボ
ル 定 義 を 更 新 する 場 合 など、filename はいつでも 編 集 してコメントを 追 加 した
り image1 を 再 リンクすることが 可 能 です。
armlink は 以 下 の 方 法 で symdefs ファイルを 更 新 します。
1. armlink が 一 時 出 力 ファイルを 作 成 する。
2. filename に 含 まれている 行 が 処 理 される。
a. コメント 行 と 空 白 行 が、そのまま 変 更 されずに 一 時 ファイルにコピーされ
る。
b. filename 内 でシンボル 名 が 検 出 されると、 現 在 のイメージに 含 まれる 命
名 済 みシンボルの 定 義 が 一 時 ファイルに 出 力 されます。
注
1 つのシンボルが filename 内 に 複 数 回 出 現 する 場 合 、そのシンボルの 1
つの 定 義 だけが 一 時 ファイルに 出 力 されます。
filename 内 で 検 出 されたシンボルが 現 在 のイメージ 内 で 定 義 されていな
い 場 合 、そのシンボルに 関 する 出 力 は 生 成 されません。
3. 最 終 リンクに 成 功 すると filename が 削 除 され、 一 時 ファイルが filename と
再 命 名 される。
4-6 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

イメージシンボルへのアクセス
4.2.3 Symdefs ファイルの 形 式
symdefs ファイルは、シンボルとその 値 を 含 む、1 つのタイプのオブジェクトファイル
です。しかし 他 のオブジェクトファイルとは 異 なり、このファイルにはコードもデー
タも 含 まれていません。
symdefs ファイルは、 識 別 行 、 任 意 のコメント、シンボル 情 報 から 構 成 されます( 例 4-2
参 照 )。
例 4-2
## ARM Linker, ADS1.2 [Build 776]: Last Updated: Tue Jul 24 13:56:35 2001
;value type name, this is an added comment
0x00001000 A function1
0x00002000 T function2
# This is also a comment, blank lines are ignored
0x00003300 A function3
0x00003340 D table1
識 別 ストリング
テキストファイル 内 の 最 初 の 11 文 字 が ## である 場 合 、armlink はそのファ
イルを symdefs ファイルとして 認 識 します。
識 別 ストリングの 後 には、リンカのバージョン 情 報 と、symdefs ファイルが 一 番 最 近 更
新 された 日 付 と 時 刻 が 続 きます。バージョン 情 報 と 更 新 情 報 は、 識 別 ストリングの 一
部 ではありません。
コメント
コメントは、テキストエディタを 使 用 して 手 動 で 挿 入 できます。コメントには 以 下 の
プロパティがあります。
• 最 初 の 非 空 白 文 字 が ; または # である 行 は 全 てコメントです。
• 先 頭 行 は 必 ず 特 殊 識 別 コメント ## で 開 始 します。このコメントは
ファイル 作 成 時 に armlink が 挿 入 するもので、ユーザが 削 除 してはなりません。
• 最 初 の 非 空 白 文 字 の 後 に ; または # がある 場 合 はコメントとみなされません。
• 空 白 行 は 無 視 されますが、 読 みやすくする 目 的 で 挿 入 することも 可 能 です。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 4-7

イメージシンボルへのアクセス
シンボル 情 報
シンボル 情 報 はシンボルのアドレス、タイプ、 名 前 で 構 成 され、1 行 に 記 述 されます。
シンボルの 値 armlink はシンボルの 絶 対 アドレスを 固 定 16 進 形 式 ( 例 :
0x00004000)で 書 き 込 みます。このファイルを 編 集 する 場 合 、
シンボルのアドレス 値 には 16 進 形 式 または 10 進 形 式 のどちらで
も 使 用 することができます。
タイプフラグ
シンボル 名
以 下 の 各 文 字 はそれぞれのタイプを 表 します。
A ARM コード
T Thumb コード
D データ
シンボルの 名 前
4-8 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

イメージシンボルへのアクセス
4.3 グローバルシンボルの 隠 蔽 と 再 命 名
このセクションでは、ステアリングファイルを 使 用 して、 出 力 ファイル 内 のグローバ
ルシンボルを 隠 蔽 または 再 命 名 する 方 法 を 説 明 します。 例 えば、ステアリングファイ
ルは 知 的 所 有 権 の 保 護 やネーム 空 間 のクラッシュの 回 避 に 使 用 することができます。
ステアリングファイルは、 出 力 オブジェクトのシンボルテーブルを 編 集 するコマンド
セットを 含 んだテキストファイルです。
ステアリングファイルを 指 定 するには、armlink コマンドラインオプション -edit
filename を 使 用 します(P. 2-8「armlink のコマンド 構 文 」の -edit オプションの 説 明
を 参 照 して 下 さい)。
サポートされているコマンドは 以 下 の 3 つです。
• RENAME:P. 4-10
• HIDE:P. 4-11
• SHOW:P. 4-11
4.3.1 ステアリングファイルの 形 式
ステアリングファイルは、 以 下 の 形 式 のプレーンテキストファイルです。
• 最 初 の 非 空 白 文 字 がセミコロン(;)またはハッシュ(#) 文 字 である 行 がコメン
トとして 解 釈 されます。コメントは 空 白 行 として 処 理 されます。
• 空 白 行 は 無 視 されます。
• 空 白 ではない 非 コメント 行 は、コマンドまたは 連 続 する 非 空 白 行 に 分 割 されたコ
マンドの 一 部 です。
• 最 後 の 非 空 白 文 字 がカンマ(,)で 終 わるコマンド 行 は、 次 の 非 空 白 行 に 続 きます。
各 コマンドは、コマンドとそれに 続 く 1 つ 以 上 のカンマで 区 切 られたオペランドグルー
プで 構 成 されます。そのコマンドによって、 各 オペランドグループは 1 つまたは 2 つ
のオペランドから 構 成 されます。コマンドは、そのコマンド 内 の 各 オペランドグルー
プに 適 用 されます。この 場 合 には 以 下 の 規 則 が 適 用 されます。
• コマンドの 大 文 字 ・ 小 文 字 は 区 別 されませんが、 一 般 的 には 大 文 字 で 表 示 され
ます。
• オペランドは 大 文 字 ・ 小 文 字 が 区 別 されるシンボル 名 とのマッチングを 行 う 必 要
があるため、 大 文 字 ・ 小 文 字 が 区 別 されます。オペランドにはワイルドカード 文
字 を 使 用 することができます。
コマンドはグローバルシンボルだけに 適 用 されます。ローカルシンボルや STT_FILE
などの 他 のシンボルは 影 響 を 受 けません。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 4-9

イメージシンボルへのアクセス
4.3.2 ステアリングファイルコマンド
以 下 のステアリングファイルコマンドによって、シンボルテーブルに 含 まれるシンボ
ルの 再 命 名 、 隠 蔽 、 表 示 を 行 うことができます。
RENAME
RENAME コマンドは、 定 義 済 みの、または 未 定 義 のグローバルシンボル 名 を 再 命 名 し
ます。
構 文
RENAME pattern AS replacement_pattern [,pattern AS replacement_pattern]*
上 記 において:
pattern 0 個 以 上 のグローバルシンボルに 一 致 し、ワイルドカード 文 字 を 含 める
ことのできるストリングです。pattern がどのグローバルシンボルにも
一 致 しない 場 合 、リンカはそのコマンドを 無 視 します。このオペランド
は、 定 義 済 みシンボルと 未 定 義 シンボルのどちらにも 一 致 させることが
できます。
replacement_pattern
ワイルドカード 文 字 を 含 めることのできるストリングであり、このスト
リングのシンボルが 再 命 名 されます。ワイルドカードを 使 用 する 場 合 は、
pattern 内 に 対 応 するワイルドカードが 存 在 していなければなりませ
ん。pattern のワイルドカードに 一 致 する 文 字 が、
replacement_pattern のワイルドカードに 置 き 換 わります。
例 えば、func1 と 命 名 されたシンボルの 場 合 :
RENAME f* AS my_f*
によって、func1 は my_func1 と 再 命 名 されます。
用 法
ターゲットシンボルの 名 前 がそれ 自 体 で 再 命 名 される 場 合 でも、あるシンボルに 既 に
存 在 しているシンボル 名 を 付 けることはできません。RENAME コマンドでは、ワイルド
カード 文 字 は 1 文 字 しか(* または ?) 使 用 できません。
armlink は 置 換 を 行 う 前 にステアリングファイルを 処 理 します。したがって、1 行 目 で
RENAME A AS B を 使 用 し、2 行 目 で RENAME B AS A を 使 用 することはできません。
4-10 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

イメージシンボルへのアクセス
HIDE
HIDEコマンドは、シンボルテーブル 内 の 定 義 済 みグローバルシンボルを 匿 名 にします。
構 文
HIDE pattern [,pattern]*
上 記 において:
pattern
0 個 以 上 の 定 義 済 みグローバルシンボルに 一 致 し、ワイルドカード 文 字
を 含 めることのできるストリングです。pattern がどの 定 義 済 みグロー
バルシンボルにも 一 致 しない 場 合 、リンカはそのコマンドを 無 視 します。
未 定 義 シンボルを 隠 蔽 することはできません。
SHOW
SHOWコマンドは、それまでHIDEコマンドで 隠 蔽 されていたグローバルシンボルを 認 識
可 能 にします。このコマンドは、HIDE コマンドにワイルドカードを 使 用 した 特 定 シン
ボルの 隠 蔽 を 解 除 したい 場 合 に 便 利 です。
構 文
SHOW pattern [,pattern]*
上 記 において:
pattern
0 個 以 上 のグローバルシンボルに 一 致 し、ワイルドカード 文 字 を 含 める
ことのできるストリングです。pattern がどのグローバルシンボルにも
一 致 しない 場 合 、リンカはそのコマンドを 無 視 します。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 4-11

イメージシンボルへのアクセス
4.4 $Super$$ と $Sub$$ を 使 用 したシンボル 定 義 のオーバライド
外 部 ライブラリや ROM コード 内 に 存 在 しているなどの 理 由 で、 既 存 のシンボルを 修 正
できない 場 合 があります。
このような 場 合 には、$Super$$ と $Sub$$ のパタンを 使 用 して 既 存 のシンボルをパッ
チします。 例 えば、 関 数 foo() の 定 義 をパッチするには、$Sub$$foo() と
$Super$$foo() を 使 用 します。
$Sub$$foo
元 関 数 foo() の 代 わりに 呼 び 出 される 新 しい 関 数 を 識 別 します。このパ
タンを 使 用 して、 元 関 数 の 前 処 理 または 後 処 理 を 追 加 します。
$Super$$foo パッチされていない 元 関 数 foo() を 識 別 します。 元 関 数 はこのパタンを
使 用 して 直 接 呼 び 出 すことができます。
例 4-3 は、ExtraFunc() への 呼 び 出 しと foo() への 呼 び 出 しを 行 うように 修 正 され
た 従 来 の 関 数 foo() を 示 しています。 詳 細 については、pdf\specs ディレクトリ 内
の ARMELF.pdf に 保 存 されている 文 書 を 参 照 して 下 さい。
例 4-3
extern void ExtraFunc(void);
extern void $Super$$foo(void):
/* this function will be linked instead of the original foo() */
void $Sub$$foo(void)
{
ExtraFunc(); /* does some extra setup work */
$Super$$foo(); /* calls the original foo function */
}
4-12 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 5 章
分 散 ローディング 記 述 ファイルの 使 用
本 章 では、armlink と 分 散 ローディング 記 述 ファイルを 使 用 した 複 雑 イメージの 作 成 方
法 を 説 明 します。 本 章 は 以 下 のセクションから 構 成 されています。
• 分 散 ローディングについて:P. 5-2
• 分 散 ローディング 記 述 ファイルの 形 式 構 文 :P. 5-7
• 等 価 な 分 散 ローディング 記 述 を 使 用 した 単 純 イメージの 生 成 :P. 5-28
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-1

分 散 ローディング 記 述 ファイルの 使 用
5.1 分 散 ローディングについて
イメージは 領 域 と 出 力 セクションから 構 成 されます。イメージに 含 まれる 各 領 域 の
ロードアドレスと 実 行 アドレスは 異 なっていても 構 いません(P. 3-2「イメージ 構 造 の
指 定 」 参 照 )。
分 散 ローディング 機 能 を 使 用 することにより、イメージのメモリマップを armlink に 指
定 することができます。 分 散 ローディングでは、イメージコンポーネントのグループ
化 と 配 置 を 全 て 制 御 することができます。これにより、ロード 時 と 実 行 時 にメモリマッ
プ 内 で 分 散 する 複 数 領 域 から 構 成 される 複 雑 イメージのマップを 記 述 することができ
ます。 分 散 ローディンは 単 純 イメージ(P. 5-5 図 5-2 参 照 )にも 使 用 できますが、メモ
リマップが 複 雑 なイメージのみに 使 用 されるのが 一 般 的 です(P. 5-6 図 5-4 参 照 )。
イメージのメモリマップを 構 成 するには、armlink に 以 下 に 関 する 情 報 を 与 える 必 要 が
あります。
• 入 力 セクションを 領 域 にグループ 化 する 方 法 を 記 述 したグループ 化 情 報
• メモリマップ 内 にイメージ 領 域 を 配 置 するアドレスを 記 述 した 配 置 情 報
これらの 情 報 は 分 散 ローディング 記 述 を 使 用 して、armlink に 渡 されるテキストファイ
ル 内 に 指 定 されます。
5.1.1 分 散 ローディング 用 に 定 義 されたシンボル
armlink は 分 散 ローディング 記 述 を 使 用 してイメージを 作 成 するときに、いくつかの 領
域 関 連 シンボルを 作 成 します。これらのシンボルについては、P. 4-2「 領 域 関 連 シンボ
ル」を 参 照 して 下 さい。これらの 特 殊 シンボルは、コードが 参 照 している 場 合 にのみ
armlink によって 作 成 されます。
注 意
分 散 ローディング 記 述 ファイルが 使 用 されていない 場 合 、シンボルImage$$RW$$Base、
Image$$RW$$Limit、Image$$RO$$Base、Image$$RO$$Limit、Image$$ZI$$Base、
Image$$ZI$$Limit は 定 義 されません。
デフォルトの 実 装 では Image$$ZI$$Limit を 使 用 しているため、
__user_initial_stackheap() を 再 実 装 してヒープ 領 域 の 開 始 位 置 とスタック 領
域 の 最 上 位 を 示 す 値 を 定 義 する 必 要 があります。 詳 細 については、ADS コンパイラ / ラ
イブラリガイドの「ライブラリメモリモデル」のセクションと、ADS デベロッパガイ
ドの「ROM へのコードの 書 き 込 み」のセクションを 参 照 して 下 さい。
__user_initial_stackheap() を 再 実 装 しないと、リンカによって 以 下 のエラーメッ
セージが 表 示 されます。
Undefined symbol Image$$ZI$$Limit (referred from sys_stackheap.o).
5-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
5.1.2 分 散 ローディングはいつ 使 用 すべきか
リンカへのコマンドラインオプションを 使 用 すればデータとコードの 配 置 をある 程 度
制 御 することができますが、 配 置 を 完 全 に 制 御 するには、コマンドラインから 入 力 可
能 な 指 示 よりもさらに 詳 細 な 指 示 を 必 要 とします。 以 下 に、 分 散 ローディング 記 述 を
必 要 とする(あるいはその 方 が 非 常 に 有 効 である)ケースを 挙 げます。
メモリマップが 複 雑 な 場 合
数 多 くの 異 なるメモリエリアに 配 置 しなければならないコードとデータ
には、どのセクションをどのメモリ 空 間 に 配 置 するかを 定 義 した 詳 細 な
指 示 が 必 要 となります。
メモリタイプが 異 なる 場 合
多 くのシステムには、フラッシュ、ROM、SDRAM、 高 速 SRAM が 組 み
込 まれています。 分 散 ローディング 記 述 を 使 用 することにより、コード
とデータを 最 も 適 切 なメモリタイプにマッチングさせることができま
す。 例 えば、 割 り 込 みコードは 高 速 SRAM に 配 置 して 割 り 込 み 応 答 時 間
を 向 上 させ、あまり 使 用 されないコンフィギュレーション 情 報 はそれよ
りも 遅 いフラッシュメモリに 配 置 するといったことが 考 えられます。
メモリマップ I/O を 使 用 する 場 合
分 散 ローディング 記 述 を 使 用 して、データセクションをメモリマップ 内
の 厳 密 なアドレスに 配 置 することができます。
関 数 の 位 置 を 固 定 する 場 合
周 辺 アプリケーションが 修 正 され、 再 コンパイルされた 場 合 でも、 関 数
はメモリ 内 の 同 じ 位 置 に 配 置 しておくことができます。
ヒープとスタックの 識 別 にシンボルを 使 用 する 場 合
ヒープとスタックの 位 置 を 示 すシンボルを 定 義 し、そこに 内 包 されるモ
ジュールの 位 置 はアプリケーションのリンク 時 に 指 定 することができ
ます。
このように、 組 み 込 みシステムでは ROM、RAM、メモリマップ I/O が 使 用 されるため、
これらの 実 行 にはほとんどの 場 合 に 分 散 ローディングが 必 要 となります。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-3

分 散 ローディング 記 述 ファイルの 使 用
5.1.3 コマンドラインオプション
以 下 は、 分 散 ローディングに 使 用 する armlink コマンドラインオプションです。
-scatter description_file_name
このコマンドは、description_file_name に 記 述 されている 通 りにメモリマップを
構 成 するよう、armlink に 指 示 します。 記 述 ファイルの 形 式 については、P. 5-7「 分 散
ローディング 記 述 ファイルの 形 式 構 文 」を 参 照 して 下 さい。
分 散 ローディング 記 述 ファイルの 詳 細 については、 以 下 を 参 照 して 下 さい。
• 例 : 領 域 アドレスとセクションアドレスの 指 定 :P. 5-22
• 等 価 な 分 散 ローディング 記 述 を 使 用 した 単 純 イメージの 生 成 :P. 5-28
• ADS デベロッパガイドの「ROM へのコードの 書 き 込 み」の 説 明
5.1.4 メモリマップが 単 純 なイメージ
図 5-1 が 示 す 分 散 ローディング 記 述 は、オブジェクトファイルからのセグメントを、
P. 5-5 図 5-2 のマップに 対 応 するメモリにロードします。この 領 域 の 最 大 サイズは 特 に
指 定 する 必 要 はありませんが、 指 定 しておけば 領 域 が 境 界 をオーバフローしていない
かどうかをリンカにチェックさせることができます。
図 5-1 単 純 なファイルの 内 容
5-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
図 5-2 メモリマップ
リンカへのコマンドラインオプションで -ro-base 0x0 および -rw-base 0x10000
を 指 定 しても、これと 同 じ 結 果 が 得 られます。
5.1.5 メモリマップが 複 雑 なイメージ
図 5-3 の 分 散 ローディング 記 述 は、program1.o と program2.o の 2 ファイルからの
セグメントを、P. 5-6 図 5-4 のマップに 対 応 するメモリにロードします。
図 5-3 メモリマップが 複 雑 なファイルの 内 容
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-5

分 散 ローディング 記 述 ファイルの 使 用
図 5-4 分 散 ロードされる 複 雑 なメモリマップ
P. 5-5 図 5-2 が 示 す 単 純 なメモリマップとは 異 なり、このアプリケーションは 基 本 コマ
ンドラインオプションだけではリンカに 指 定 できません。
注 意
P. 5-5 図 5-3 の 分 散 ローディング 記 述 は、program1.o および program2.o のコード
とデータの 位 置 だけを 指 定 します。したがって、 例 えば program3.o という 別 のモ
ジュールをリンクさせるときにこの 記 述 ファイルを 使 用 しても、program3.o のコー
ドとデータの 位 置 は 指 定 されません。
コードとデータの 配 置 をよほど 厳 密 に 行 うのでない 限 り、 残 ったコードとデータの 配
置 には、 指 定 子 * または .ANY の 使 用 を 推 奨 します(P. 5-24「 固 定 アドレスへの 領 域 の
配 置 」 参 照 )。
5-6 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
5.2 分 散 ローディング 記 述 ファイルの 形 式 構 文
分 散 ローディング 記 述 ファイルは、ターゲット 組 み 込 み 製 品 のメモリマップを armlink
に 通 知 するテキストファイルです。armlink をコマンドラインから 使 用 する 場 合 には、
この 記 述 ファイルのファイル 拡 張 子 に 意 味 はありません。しかし、CodeWarrior IDE を
使 用 する 場 合 は、 記 述 ファイルのデフォルト 拡 張 子 に .scf が 使 用 されます。(たとえ
この 拡 張 子 を 変 更 しても、CodeWarrior IDE は 分 散 ローディングファイルとして 認 識 し
ます。) 分 散 ローディング 記 述 ファイルを 使 用 すると、 以 下 を 指 定 することができます。
• 各 ロード 領 域 のロードアドレスおよび 最 大 サイズ
• 各 ロード 領 域 の 属 性
• 各 ロード 領 域 から 導 出 される 実 行 領 域
• 各 実 行 領 域 の 実 行 アドレスおよび 最 大 サイズ
• 各 実 行 領 域 の 入 力 セクション
記 述 ファイルの 形 式 には、ロード 領 域 、 実 行 領 域 、 入 力 セクションの 階 層 が 反 映 され
ます。
注
領 域 に 対 する 入 力 セクションの 割 り 当 ては、 選 択 パタンが 分 散 ローディング 記 述 ファ
イルに 書 き 込 まれる 順 序 と 全 く 関 係 ありません。 選 択 パタンと、ファイル / セクション
の 名 前 またはセクション 属 性 との 間 で 最 適 な 組 み 合 わせが 使 用 されます。P. 5-18「 多 重
一 致 の 解 決 」を 参 照 して 下 さい。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-7

分 散 ローディング 記 述 ファイルの 使 用
5.2.1 BNF の 表 記 と 構 文
表 5-1 は、 形 式 言 語 の 記 述 に 使 用 する BNF シンボルを 示 しています。
表 5-1 BNF 構 文
シンボル
説 明
" クオテーションマークは、 通 常 は BNF 構 文 の 一 部 である 文 字 が 定 義 の
中 でリテラル 文 字 として 使 用 されることを 示 す 場 合 に 使 用 します。
例 えば、 定 義 B"+"C はパタン B+C によってのみ 置 き 換 えることがで
きます。 定 義 B+C は、パタン BC、BBC、BBBC のいずれかに 置 き 換 え
られます。
A ::= B
A を B として 定 義 します。 例 えば、A::= B"+" | C は、A が B+ また
は C のどちらかと 等 価 であることを 意 味 します。
::= 表 記 は、そのコンポーネントにおいて 上 位 レベルの 構 成 を 定 義 す
るために 使 用 します。また 各 コンポーネントには、さらに 単 純 なコン
ポーネントの 上 位 レベルの 構 成 を 定 義 する ::= 定 義 を 使 用 することも
可 能 です。
例 えば、A::= B および B::= C | D は、 定 義 A がパタン C または D
と 等 価 であることを 意 味 します。
[A]
任 意 のエレメント A を 示 します。 例 えば、A::= B[C]D は 定 義 A を
BD または BCD に 拡 大 可 能 であることを 意 味 します。
A+ エレメント A が 1 個 以 上 出 現 することを 意 味 します。 例 えば、A::=
B+ は、 定 義 A を B、BB、BBB のいずれかに 拡 大 できることを 示 します。
A* エレメント A が 0 個 以 上 出 現 することを 意 味 します。
A | B
出 現 するのはエレメント A または B のどちらかであり、 両 方 ではない
ことを 意 味 します。
(A B) エレメント A および B が 一 緒 にグループ 化 されることを 意 味 します。
このシンボルは、| 演 算 子 を 使 用 するとき、あるいは 複 雑 なパタンを 繰
り 返 すときに 使 用 すると 便 利 です。
例 えば、A::=(B C)+ (D | E) は、 定 義 A が BCD、BCE、BCBCD、
BCBCE、BCBCBCD、BCBCBCE のいずれかに 拡 大 可 能 であることを 意 味
します。
5-8 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
5.2.2 分 散 ローディング 記 述 ファイルに 使 用 する 構 文 の 概 要
このセクションで 説 明 する BNF の 定 義 では、 読 みやすくするために 改 行 とスペースを
入 れています。 分 散 ローディングの 定 義 に 改 行 とスペースを 入 れる 必 要 はなく、たと
えファイル 内 に 存 在 していても 無 視 されます。
scatter_descriptionは、1つ 以 上 のload_region_descriptionパタンと 定 義 さ
れます。
Scatter_description ::=
load_region_description+
load_region_description はロード 領 域 の 名 前 として 定 義 され、この 後 に 任 意 の 属
性 指 定 子 またはサイズ 指 定 子 、ならびに 1 つ 以 上 の 実 行 領 域 の 記 述 が 続 きます。
load_region_description ::=
load_region_name (base_address | ("+" offset)) [attributes] [max_size]
"{"
execution_region_description+
"}"
execution_region_description は、 実 行 領 域 名 、ベースアドレス 指 定 、 任 意 の 属
性 指 定 子 またはサイズ 指 定 子 、ならびに 1 つ 以 上 の 入 力 セクションの 記 述 として 定 義
されます。
execution_region_description ::=
execution_region_name (base_address | "+" offset) [attributes] [max_size]
"{"
input_section_description+
"}"
input_section_description は、ソースモジュールセレクタパタンとそれに 続 く
任 意 の 入 力 セクションセレクタして 定 義 されます。
input_section_description ::=
module_select_pattern
[ "("
("+" input_section_attr | input_section_pattern)
([","] "+" input_section_attr | "," input_section_pattern))*
")" ]
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-9

分 散 ローディング 記 述 ファイルの 使 用
図 5-5 は、 典 型 的 な 分 散 ローディング 記 述 ファイルの 内 容 と 構 成 を 示 しています。
図 5-5 分 散 ローディングファイル 定 義 のコンポーネント
5-10 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
5.2.3 ロード 領 域 の 記 述
ロード 領 域 は 以 下 で 構 成 されます。
• 名 前 (リンカはこの 名 前 を 使 用 して 数 あるロード 領 域 を 識 別 します。)
• ベースアドレス(ロードビューにおけるコードとデータの 開 始 アドレスです。)
• 属 性 (オプション)
• 最 大 サイズ(オプション)
• 実 行 領 域 リスト( 実 行 ビューにおけるモジュールのタイプと 位 置 を 識 別 します。)
図 5-6 は、 典 型 的 なロード 領 域 の 記 述 に 含 まれるコンポーネントを 示 しています。
以 下 は BNF における 構 文 です。
load_region_description ::=
図 5-6 ロード 領 域 の 記 述 に 含 まれるコンポーネント
load_region_name (base_address | ("+" offset)) [attribute_list] [ max_size ]
"{"
execution_region_description+
"}"
上 記 において:
load_region_name
ロード 領 域 を 命 名 します。 先 頭 31 文 字 だけが 有 意 です。この 名
前 は 各 領 域 の 識 別 のみに 使 用 されます。exec_region_name
(P. 5-13)とは 異 なり、load_region_name は
Load$$region_name シンボルの 生 成 には 使 用 されません。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-11

分 散 ローディング 記 述 ファイルの 使 用
注
デバッガは 領 域 をロードアドレスにロードする 必 要 があるため、
デバッガに 使 用 する 目 的 で 作 成 されるイメージには 各 領 域 に 固 有
のベースアドレスが 必 要 となります。ロード 領 域 アドレスがオー
バラップしていると、そのイメージの 一 部 が 上 書 きされます。
しかし、ローダまたはオペレーティングシステムは、オーバラッ
プしている 位 置 独 立 領 域 を 正 しくロードすることができます。1 つ
以 上 の 位 置 独 立 領 域 が 異 なるアドレスに 自 動 的 に 移 動 されます。
base_address
領 域 内 のオブジェクトをリンクさせるアドレスです。
base_address にはワード 境 界 整 列 の 数 値 を 指 定 する 必 要 があ
ります。
+offset
先 行 ロード 領 域 の 終 わりを offset バイト 分 だけ 超 えたベースア
ドレスを 示 します。offset には 4 で 割 った 余 りが 0 になる 値 を
指 定 する 必 要 があります。これが 最 初 のロード 領 域 である 場 合 、
+offset はベースアドレス 0 から offset バイトずれた 位 置 で 開
始 することを 意 味 します。
attribute_list ロード 領 域 の 内 容 のプロパティを 指 定 します。
PI
位 置 独 立
RELOC
再 配 置 可 能
OVERLAY
オーバレイ
ABSOLUTE 絶 対 アドレス
属 性 は 上 記 の 中 から 1 つだけを 指 定 することができます。デフォ
ルトのロード 領 域 属 性 は ABSOLUTE です。
PI、RELOC、OVERLAY のいずれかの 属 性 を 持 つロード 領 域 のアド
レス 範 囲 はオーバラップさせることができます。ABSOLUTE ロー
ド 領 域 のアドレス 範 囲 がオーバラップしていると、armlink はエ
ラーを 生 成 します。
OVERLAY キーワードを 使 用 することにより、 同 一 アドレス 上 に 複
数 の 実 行 領 域 を 配 置 することができます。ADS にはオーバレイ 機
能 はありません。したがって 同 一 アドレス 上 に 複 数 の 実 行 領 域 を
配 置 するには、 専 用 のオーバレイマネージャを 使 用 する 必 要 があ
ります。
max_size
execution_region_description
ロード 領 域 の 最 大 サイズを 指 定 します。( 任 意 の max_size の 値
が 指 定 されている 場 合 、その 領 域 に 複 数 の max_size バイトが 割
り 当 てられていると、armlink はエラーを 生 成 します。)
実 行 領 域 の 名 前 、アドレス、 内 容 を 指 定 します(P. 5-13「 実 行 領
域 の 記 述 」 参 照 )。
5-12 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
5.2.4 実 行 領 域 の 記 述
実 行 領 域 は 以 下 で 構 成 されます。
• 名 前
• ベースアドレス( 絶 対 または 相 対 )
• 任 意 の 最 大 サイズの 指 定
• 実 行 領 域 のプロパティを 指 定 する 属 性
• 1つ 以 上 の 入 力 セクションの 記 述 ( 対 象 実 行 領 域 に 配 置 されるモジュール)
図 5-7 は、 典 型 的 な 実 行 領 域 の 記 述 に 含 まれるコンポーネントを 示 しています。
以 下 は BNF を 使 用 した 実 行 領 域 記 述 構 文 を 示 しています。
execution_region_description ::=
図 5-7 実 行 領 域 の 記 述 に 含 まれるコンポーネント
exec_region_name (base_address | "+" offset) [attribute_list] [max_size]
"{"
input_section_description+
"}"
上 記 において:
exec_region_name 実 行 領 域 を 命 名 します。( 先 頭 31 文 字 だけが 有 意 です。)
base_address
+offset
領 域 内 のオブジェクトをリンクさせるアドレスです。
base_address はワード 境 界 で 整 列 させる 必 要 があります。
先 行 の 実 行 領 域 の 終 わりを offset バイト 超 えたベースアドレス
を 記 述 します。offset には 4 で 割 った 余 りが 0 になる 値 を 指 定
する 必 要 があります。
先 行 の 実 行 領 域 が 存 在 しない 場 合 (つまり、これがロード 領 域 内
の 最 初 の 実 行 領 域 である 場 合 )、+offset は 実 行 領 域 のベースア
ドレスが、それを 含 むロード 領 域 のベースから offset バイトず
れた 位 置 から 開 始 することを 意 味 します。
* ベース 指 定 子 (base_designator)は 下 記 の 部 分 を 指 します。
(base_address | "+" offset)
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-13

分 散 ローディング 記 述 ファイルの 使 用
+offset 形 式 が 使 用 され、それを 含 むロード 領 域 にRELOC 属 性 が
設 定 されている 場 合 、 実 行 領 域 はこの RELOC 属 性 を 継 承 します。
しかし、 固 定 base_address が 使 用 されていると、それ 以 後 に
出 現 する offset は RELOC 属 性 を 継 承 しません。
attribute_list 実 行 領 域 の 内 容 のプロパティを 指 定 します。
PI
位 置 独 立
OVERLAY
オーバレイ
ABSOLUTE 絶 対 アドレス。 領 域 の 実 行 アドレスはベース
指 定 子 によって 指 定 されます。
FIXED
固 定 アドレス。 対 象 領 域 のロードアドレスと
実 行 アドレスの 両 方 がベース 指 定 子 によっ
て 指 定 されます(この 領 域 はルート 領 域 で
す。P. 5-22「ルート 実 行 領 域 の 作 成 」を 参 照
して 下 さい)。ベース 指 定 子 には 絶 対 ベース
アドレス、あるいは +0 のオフセットを 指 定
する 必 要 があります。
UNINIT
未 初 期 化 データ
属 性 には、PI、OVERLAY、FIXED、ABSOLUTE のいずれか 1 つを
指 定 することができます。PI、FIXED、OVERLAY のいずれかが
指 定 されていない 限 り、 実 行 領 域 のデフォルト 属 性 には
ABSOLUTE が 使 用 されます。
+offset 形 式 のベース 指 定 子 を 使 用 する 実 行 領 域 は、その 前 の 実
行 領 域 (あるいは、その 領 域 がロード 領 域 内 の 最 初 の 実 行 領 域 で
ある 場 合 には、それを 含 んでいるロード 領 域 )の 属 性 を 継 承 する
か、ABSOLUTE 属 性 を 持 ちます。
実 行 領 域 に 属 性 RELOC を 明 示 的 に 指 定 することはできません。 実
行 領 域 は、 前 の 実 行 領 域 または 親 領 域 の 属 性 を 継 承 する 場 合 にの
み RELOC 属 性 を 持 つことができます。
+offset 形 式 のベース 指 定 子 を 使 用 する 実 行 領 域 がそれ 自 身 の
属 性 を 持 つことはできません(ただし、 継 承 をオーバライドする
ABSOLUTE 属 性 は 除 きます)。 開 始 位 置 を 変 更 せずに 領 域 に
ABSOLUTE を 設 定 するには、+0 ABSOLUTE の 組 み 合 わせを 使 用 し
ます。
PI または OVERLAY が 指 定 された(あるいは RELOC 属 性 を 継 承 し
た) 実 行 領 域 は、オーバラップしたアドレス 範 囲 を 持 つことがで
きます。ABSOLUTE または FIXED が 設 定 された 実 行 領 域 のアドレ
ス 範 囲 がオーバラップしていると、armlink はエラーを 生 成 します。
UNINIT は、 実 行 領 域 内 に ZI 出 力 セクションが 存 在 している 場 合
に、その ZI 出 力 セクションが 0 に 初 期 化 されないことを 示 しま
す。この 属 性 を 使 用 することにより、 未 初 期 化 データまたはメモ
リマップ I/O を 含 む 実 行 領 域 を 作 成 することができます。
5-14 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
max_size
対 象 領 域 に 複 数 の max_size が 割 り 当 てられている 場 合 にはエ
ラーを 生 成 するように armlink に 命 令 する 任 意 の 数 値 です。
input_section_description
入 力 セクションの 内 容 を 指 定 します(「 入 力 セクションの 記 述 」 参
照 )。
5.2.5 入 力 セクションの 記 述
input_section の 記 述 とは、 以 下 によって 入 力 セクションを 識 別 するパタンを 意 味
します。
• モジュール 名 (オブジェクトファイルの 名 前 、ライブラリメンバの 名 前 、あるい
はライブラリファイルの 名 前 )。モジュール 名 にはワイルドカード 文 字 を 使 用 す
ることができます。
• 入 力 セクション 名 、あるいは READ-ONLY や CODE などの 入 力 セクション 属 性
図 5-8 は、 典 型 的 な 入 力 セクションの 記 述 に 含 まれるコンポーネントを 示 しています。
以 下 は BNF を 使 用 した 構 文 を 示 しています。
input_section_description ::=
図 5-8 入 力 セクションの 記 述 に 含 まれるコンポーネント
module_select_pattern
["("
("+" input_section_attr | input_section_pattern)
([","] "+" input_section_attr | "," input_section_pattern))*
")"]
上 記 において:
module_select_pattern
リテラルテキストから 構 成 されるパタンです。ワイルドカード 文 字 * は
0 個 以 上 の 文 字 と、? は 任 意 の 1 文 字 とマッチングされます。
ファイル 名 の 大 文 字 ・ 小 文 字 を 区 別 するホストでも、マッチングは 大 文
字 ・ 小 文 字 の 区 別 なく 行 われます。
全 てのオブジェクトとマッチングさせるときは *.o を、 全 てのファイル
およびライブラリとマッチングさせるときは * を 使 用 します。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-15

分 散 ローディング 記 述 ファイルの 使 用
入 力 セクションは、module_selector_pattern が 以 下 のいずれか 1
つと 一 致 するときに、module_selector_pattern と 一 致 します。
• その 入 力 セクションを 含 むオブジェクトファイルの 名 前
• ライブラリメンバの 名 前 ( 先 行 パス 名 なし)
• そのセクションが 抽 出 されたライブラリのフルネーム(パス 名 を
含 む)。この 名 前 にスペースが 含 まれている 場 合 には、ワイルド
カードを 使 用 して 検 索 を 簡 素 化 することができます。 例 えば、
C:\lib dir\libname.libとのマッチングには*libname.lib
を 使 用 します。
特 殊 モジュールセレクタパタン .ANY を 使 用 すると、 入 力 セクションの
親 モジュールを 考 えることなく、 入 力 セクションを 実 行 領 域 に 割 り 当 て
ることができます。.ANY は、 実 行 領 域 をドントケア 割 り 当 てによって
満 たす 場 合 に 使 用 します。
注
• module_selector_pattern かつ、input_section_attr ま
たは input_section_pattern のどちらかと 一 致 する 入 力 セク
ションだけが 実 行 領 域 に 含 まれます。
(+ input_section_attr)および(input_section_pattern)
を 省 略 した 場 合 には、デフォルトの +RO が 使 用 されます。
• コンパイラによって 生 成 された、あるいは ARM ライブラリコード
によって 使 用 される 入 力 セクション 名 は 信 頼 しないで 下 さい。こ
れらの 名 前 は、 異 なるコンパイラオプションが 使 用 される 場 合 な
どに、コンパイルの 都 度 変 更 される 可 能 性 があります。また、コ
ンパイラに 使 用 されるセクション 命 名 規 則 が 全 てのリリースで 一
貫 しているとは 限 りません。
input_section_attr
入 力 セクション 属 性 とマッチ ングされる 属 性 セレ クタです。 各
input_section_attr の 前 には + を 付 けます。
入 力 セクション 名 とマッチングするパタンを 指 定 するとき、この 名 前 に
は 接 頭 文 字 + を 付 ける 必 要 があります。+ の 直 前 にあるカンマは 省 略 す
ることが 可 能 です。
5-16 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
セレクタの 大 文 字 ・ 小 文 字 は 区 別 されません。 認 識 されるセレクタは 以
下 のとおりです。
• RO-CODE
• RO-DATA
• RO(RO-CODE と RO-DATA の 両 方 を 選 択 します。)
• RW-DATA
• RW-CODE
• RW(RW-CODE と RW-DATA の 両 方 を 選 択 します。)
• ZI
• ENTRY(ENTRY ポイントを 含 むセクションです。)
以 下 の 同 義 語 が 認 識 されます。
• CODE:RO-CODE
• CONST:RO-DATA
• TEXT:RO
• DATA:RW
• BSS:ZI
以 下 の 擬 似 属 性 が 認 識 されます。
• FIRST
• LAST
FIRST と LAST は、 配 置 順 序 が 重 要 な 場 合 ( 例 えば、 特 定 の 入 力 セク
ションを 領 域 内 の 最 初 に 配 置 し、チェックサムを 含 む 入 力 セクションを
最 後 に 配 置 しなければならない 場 合 など)に、 領 域 内 の 最 初 と 最 後 のセ
クションをマーキングする 目 的 で 使 用 することができます。FIRST また
は LAST が input_section_attr として 最 初 に 出 現 した 時 点 で、その
リストを 終 了 します。
特 殊 モジュールセレクタパタン .ANY を 使 用 すると、 入 力 セクションの
親 モジュールを 考 えることなく、 入 力 セクションを 実 行 領 域 に 割 り 当 て
ることができます。.ANY は、 実 行 領 域 をドントケア 割 り 当 てによって
満 たす 場 合 に 使 用 します。ほとんどの 場 合 、1 つの .ANY を 使 用 しても、
* モジュールセレクタを 使 用 しても、 結 果 は 同 じです。
分 散 ローディング 記 述 ファイル 内 に 2 つの * セレクタを 使 用 することは
できません。しかしながら、 例 えば 2 つの 修 正 セレクタ *A と *B を 使 用
することは 可 能 であり、また .ANY セレクタを * モジュールセレクタと
組 み 合 わせて 使 用 することも 可 能 です。* モジュールセレクタは .ANY よ
りも 優 先 されます。* セレクタを 含 むファイルの 一 部 分 が 削 除 されると、
.ANY セレクタが 有 効 になります。
.ANY モジュールセレクタパタンを 持 つ
input_section_descriptions の 解 決 は、その 他 全 ての( 非 .ANY の)
入 力 セクションの 記 述 が 解 決 され、 入 力 セクションが 完 全 一 致 に 最 も 近
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-17

分 散 ローディング 記 述 ファイルの 使 用
い 実 行 領 域 に 割 り 当 てられてから 行 われます。 複 数 の .ANY パタンが 存
在 するとき、リンカは 可 能 な 限 り 最 初 の .ANY を 埋 めてから、 次 の .ANY
の 充 填 を 開 始 します。
残 りの 各 未 割 り 当 て 入 力 セクションは、 以 下 の 特 性 を 持 つ 実 行 領 域 に 割
り 当 てられます。
• 残 りの 空 き 空 間 が 最 大 の 領 域 (max_size 値 と、 既 に 割 り 当 てら
れている 入 力 セクションのサイズによって 決 定 されます。)
• .ANY input_section_description に 一 致 する 領 域
• メモリアクセス 属 性 ( 存 在 する 場 合 )が 入 力 セクションのメモリ
属 性 と 一 致 する 領 域
input_section_pattern
大 文 字 ・ 小 文 字 の 区 別 なく、 入 力 セクション 名 とマッチングするパタン
です。このパタンはリテラルテキストで 構 成 されます。ワイルドカード
文 字 * は 0 個 以 上 の 文 字 と、? は 任 意 の 1 文 字 とマッチングされます。
5.2.6 多 重 一 致 の 解 決
1 つのセクションが 複 数 の 実 行 領 域 と 一 致 するとき、それらの 一 致 は 以 下 のように 解 決
されます。 一 意 の 一 致 を 検 出 できない 場 合 、armlink はその 分 散 ローディング 記 述 を 誤
りとみなします。 各 セクションは module_selector_pattern と
input_section_selector によって 選 択 されます。
module_selector_pattern の 指 定 例 :
• * は 全 てのモジュールまたはライブラリと 一 致 します。
• *.o は 全 てのオブジェクトモジュールと 一 致 します。
• math.o は math.o モジュールと 一 致 します。
• *math.lib は math.lib で 終 わる 全 てのライブラリパスと 一 致 します( 例 :
C:\apps\lib\math\satmath.lib)。
input_section_selector 指 定 例 :
• +ROは、 全 てのROコードと 全 てのROデータに 一 致 する 入 力 セクション 属 性 です。
• +RW,+ZI は、 全 ての RW コード、 全 ての RW データ、 全 ての ZI データに 一 致 す
る 入 力 セクション 属 性 です。
• BLOCK_42 は、BLOCK_42. と 命 名 されたアセンブリファイルエリアに 一 致 する
入 力 セクションパタンです。
5-18 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
注
コンパイラは、.text、.data、.constdata、.bss などの 入 力 セクションパ
タンによって 識 別 可 能 なエリアを 生 成 します。しかし、これらの 名 前 は 今 後 の
バージョンで 変 更 される 可 能 性 があるため、できるだけ 使 用 しないで 下 さい。
CまたはC++ファイルに 含 まれる 特 定 の 関 数 または 外 部 データをマッチングする
必 要 がある 場 合 には、 以 下 のいずれかの 方 法 を 使 用 して 下 さい。
— その 関 数 またはデータを 独 立 モジュールにコンパイルし、そのモジュール
オブジェクト 名 でマッチングする。
— #pragma arm section を 使 用 して 対 象 コードまたはデータを 含 むセク
ションを 指 定 する(ADS コンパイラ / ライブラリガイドのプラグマの 説 明
を 参 照 して 下 さい)。
多 重 一 致 の 記 述 には 以 下 の 変 数 を 使 用 します。
• m1 および m2:モジュールセレクタパタンを 表 します。
• s1 および s2: 入 力 セクションセレクタを 表 します。
多 重 一 致 の 場 合 、armlink は 最 も 厳 密 な module_selector_pattern と
input_section_selector の 組 み 合 わせに 基 づいて、 入 力 セクションを 割 り 当 てる
領 域 を 決 定 します。
例 えば、 入 力 セクション A が 実 行 領 域 R1 の m1,s1 と 一 致 し、 実 行 領 域 R2 の m2,s2 と
一 致 する 場 合 、armlink は 以 下 のように 割 り 当 てを 行 います。
• m1,s1 が m2,s2 よりも 厳 密 な 場 合 は、A を R1 に 割 り 当 てます。
• m2,s2 が m1,s1 よりも 厳 密 な 場 合 は、A を R2 に 割 り 当 てます。
• m1,s1 が m2,s2 よりも 厳 密 ではなく、 同 時 に m2,s2 が m1,s1 よりも 厳 密 ではない 場
合 は、その 分 散 ローディングの 記 述 を 誤 りと 診 断 します。
armlink は 以 下 の 順 序 で 最 も 厳 密 な module_selector_pattern、
input_section_selector 対 を 決 定 します。
1. モジュールセレクタパタンの 場 合 :
テキストストリング m1 がパタン m2 に 一 致 し、テキストストリング m2 がパタン
m1 に 一 致 しない 場 合 は、m1 が m2 よりも 厳 密 であると 判 断 します。
2. 入 力 セクションセレクタの 場 合 :
• s1 と s2 の 両 方 が 同 一 パタンのセクション 名 を 持 つ 場 合 には、モジュールセ
レクタパタンと 同 じ 定 義 が 使 用 されます。
• s1、s2 のどちらか 一 方 が 入 力 セクション 名 と 一 致 し、 他 方 が 入 力 セクショ
ン 属 性 と 一 致 する 場 合 には、s1 と s2 の 順 序 付 けは 行 われず、その 記 述 は 誤
りと 診 断 されます。
• s1 と s2 の 両 方 が 入 力 セクション 属 性 に 一 致 する 場 合 、s1 が s2 よりも 厳 密
であるかどうかの 決 定 は、 次 の 関 係 によって 定 義 されます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-19

分 散 ローディング 記 述 ファイルの 使 用
ENTRY は、RO-CODE、RO-DATA、RW-CODE、RW-DATA よりも 厳 密 である。
RO-CODE は RO よりも 厳 密 である。
RO-DATA は RO よりも 厳 密 である。
RW-CODE は RW よりも 厳 密 である。
RW-DATA は RW よりも 厳 密 である。
セクション 属 性 においては、 上 記 以 外 に(s1 が s2 よりも 厳 密 である) 関 係
を 示 すメンバはありません。
3. module_selector_pattern, input_section_selector 対 に 関 して、
m1,s1 は 以 下 が 真 である 場 合 にのみ m2,s2 よりも 厳 密 であると 判 断 されます。
• s1 がリテラル 入 力 セクション 名 (つまり、パタン 文 字 が 含 まれていない 名
前 )であり、s2 が +ENTRY 以 外 の 入 力 セクション 属 性 と 一 致 する。
• m1 が m2 よりも 厳 密 である。
• s1 が s2 よりも 厳 密 である。
このマッチング 方 式 は 以 下 の 結 果 をもたらします。
• 記 述 がファイル 内 に 書 かれた 順 序 に 依 存 しない。
• 一 般 的 に、オブジェクトの 記 述 が 厳 密 になればなるほど、それに 含 まれる 入 力 セ
クションの 記 述 が 厳 密 になる。
• input_section_selectors が 以 下 の 場 合 を 除 いて 検 査 されない。
— オブジェクトの 選 択 が 確 定 されない。
— 一 方 のセレクタが 入 力 セクションの 完 全 な 名 前 を 指 定 し、 他 方 が 属 性 で 選
択 する。この 場 合 、 明 示 的 な 入 力 セクション 名 は、ENTRY 以 外 の、1 つの
オブジェクトから 1 つの 入 力 セクションだけを 選 択 するどの 属 性 よりも 厳
密 です。このことは、 入 力 セクション 名 に 関 連 付 けられたオブジェクトセ
レクタがその 属 性 よりも 厳 密 ではない 場 合 にも 言 えます。
5-20 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
例 5-1 は、 複 数 実 行 領 域 とパタンマッチングを 示 しています。
例 5-1 パタンマッチング
LR_1 0x040000
{
ER_ROM 0x040000
; The startup exec region address is the same
{ ; as the load address.
application.o (+ENTRY) ; The section containing the entry point from
} ; the object is placed here.
ER_RAM1 0x048000
{
application.o (+RO_CODE) ; Other RO code from the object goes here
}
ER_RAM2 0x050000
{
}
application.o (+RO)
}
ER_RAM3 0x060000
{
application.o (+RW)
}
ER_RAM4 +0
{
*.o (+RO, +RW, +ZI)
}
; The RO data goes here
; RW code and data go here
; Follows on from end of ER_R3
; Everything except for application.o goes here
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-21

分 散 ローディング 記 述 ファイルの 使 用
5.3 例 : 領 域 アドレスとセクションアドレスの 指 定
このセクションでは、 分 散 ローディング 記 述 ファイルを 使 用 した 以 下 のアドレスの 指
定 方 法 を 説 明 します。
• ベニア
• ROM 内 の RO 定 数
• ルート 実 行 領 域
固 定 アドレスにあるデータおよび 関 数 へのアクセスについては、ADS デベロッパガイ
ドの「ROM へのコードの 書 き 込 み」を 参 照 して 下 さい。
5.3.1 分 散 ローディング 記 述 におけるベニア 入 力 セクションの 選 択
ベニアは、ARM コードと Thumb コードの 切 り 替 え、あるいは 1 つの 命 令 で 指 定 可 能 な
ジャンプよりも 長 いプログラムジャンプの 実 行 に 使 用 されます(P. 3-13「ベニアの 生
成 」 参 照 )。リンカが 生 成 したベニア 入 力 セクションの 配 置 には、 分 散 ローディング
ファイルを 使 用 します。 分 散 ローディング 記 述 ファイル 内 で *(Veneer$$Code) セク
ションセレクタを 保 持 できる 実 行 領 域 は 多 くても 1 つです。
armlink は、 安 全 な 場 合 に 限 り、*(Veneer$$Code) セクションセレクタによって 識 別
される 領 域 にベニア 入 力 セクションを 配 置 します。アドレス 範 囲 の 問 題 や 実 行 領 域 サ
イズの 制 限 などにより、ベニア 入 力 セクションをその 領 域 に 割 り 当 てることができな
い 場 合 もあります。 指 定 された 領 域 にベニアを 追 加 できない 場 合 は、そのベニアを 生
成 した 再 配 置 後 の 入 力 セクションを 含 む 実 行 領 域 に 追 加 されます。
旧 バージョンの ARM ツールを 使 用 した 分 散 ローディング 記 述 ファイルに 含 まれる
*(IWV$$Code) のインスタンスは、 自 動 的 に *(Veneer$$Code) に 変 換 されます。 新
しい 記 述 では *(Veneer$$Code) を 使 用 して 下 さい。
5.3.2 ルート 実 行 領 域 の 作 成
イメージの 初 期 エントリポイントを 指 定 する 場 合 、あるいは ENTRY ディレクティブが
1 つしか 使 用 されていないためにリンカが 初 期 エントリポイントを 作 成 する 場 合 には、
そのエントリポイントが 必 ずルート 領 域 内 に 配 置 されるようにしなければなりませ
ん。ルート 領 域 とは、そのロードアドレスで 実 行 する 領 域 を 指 します。 初 期 エントリ
ポイントがルート 領 域 内 に 存 在 しない 場 合 はリンクが 不 可 能 となり、リンカは 以 下 の
ようなエラーメッセージを 返 します。
Entry point (0x00000000) lies within non-root region ER_ROM
5-22 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
分 散 ローディング 記 述 ファイルにおいて、ある 領 域 がルート 領 域 であることを 指 定 す
るには、 以 下 のどちらかの 方 法 を 使 用 することができます。
• その 実 行 領 域 の 属 性 として、 明 示 的 に、あるいはデフォルトのままで ABSOLUTE
を 指 定 し、 最 初 の 実 行 領 域 とそれを 含 むロード 領 域 に 同 じアドレスを 使 用 しま
す。 実 行 領 域 のアドレスをロード 領 域 のアドレスと 同 一 にするには、 以 下 のどち
らかの 方 法 を 使 用 します。
— 実 行 領 域 のベース 指 名 子 (アドレス)とロード 領 域 のベース 指 名 子 (アド
レス)の 両 方 に 同 一 数 値 を 指 定 する。
— ロード 領 域 内 の 最 初 の 実 行 領 域 に +0 オフセットを 指 定 する。
全 ての 実 行 領 域 にオフセット 0(+0)を 指 定 すると、それらの 領 域 全 てが
ルート 領 域 となります( 例 5-2 参 照 )。
• FIXED 実 行 領 域 属 性 を 使 用 して、 特 定 領 域 のロードアドレスと 実 行 アドレスを 同
じにします(P. 5-24 例 5-3、P. 5-24 図 5-9 参 照 )。
FIXED 属 性 を 使 用 することにより、どの 実 行 領 域 でも ROM 内 の 特 定 アドレスに 配 置 す
ることができます。 詳 細 については、P. 5-24「 固 定 アドレスへの 領 域 の 配 置 」を 参 照 し
て 下 さい。
例 5-2 同 一 ロード / 実 行 アドレスの 指 定
LR_1 0x040000
; load region starts at 0x40000
{ ; start of execution region descriptions
ER_RO 0x040000 ; load address = execution address
{
*(+RO)
; all RO sections (must include section with
; initial entry point)
}
; rest of scatter description...
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-23

分 散 ローディング 記 述 ファイルの 使 用
例 5-3 FIXED 属 性 の 使 用
LR_1 0x040000
; load region starts at 0x40000
{ ; start of execution region descriptions
ER_RO 0x040000 ; load address = execution address
{
*(+RO)
; RO sections other than those in init.o
}
ER_INIT 0x080000 FIXED ; load address and execution address of this
; execution region are fixed at 0x80000
{
init.o(+RO) ; all RO sections from init.o
}
; rest of scatter description...
図 5-9 固 定 実 行 領 域 のメモリマップ
5.3.3 固 定 アドレスへの 領 域 の 配 置
実 行 領 域 の 分 散 ローディング 記 述 に FIXED 属 性 を 使 用 することにより、ロードおよび
実 行 が 固 定 アドレスで 行 われるルート 領 域 を 作 成 することができます。
FIXED は、1 つのロード 領 域 内 ( 一 般 的 には 単 一 ROM デバイス 内 )に 複 数 のルート 領 域
を 作 成 するために 使 用 します。 例 えば、この 属 性 を 使 用 することで 定 数 テーブルや
チェックサムなどの 関 数 またはデータブロックをROM 内 の 固 定 アドレスに 配 置 できる
ため、ポインタから 容 易 にアクセスすることが 可 能 となります。
例 えば、 何 らかの 初 期 化 コードを ROM の 開 始 位 置 に 配 置 し、チェックサムを ROM の
終 わりに 配 置 するように 指 定 した 場 合 には、メモリ 内 容 の 一 部 分 が 使 用 されない 可 能
性 があります。このような 場 合 には * または .ANY モジュールセレクタを 使 用 して、 初
期 化 ブロックの 終 わりからデータブロック 開 始 までの 領 域 を 充 填 します。
5-24 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
注
コードの 保 守 性 とデバッグの 容 易 性 を 高 めるには、 分 散 ローディング 記 述 ファイル 内 の
配 置 指 定 要 素 を 最 小 限 に 抑 え、 関 数 とデータの 詳 細 な 配 置 はリンカに 任 せておきます。
部 分 リンクされたコンポーネントオブジェクトは 指 定 できません。 例 えば、オブジェ
クト obj1.o、obj2.o、obj3.o を 部 分 リンクさせて obj_all.o を 生 成 したとき、
これらのコンポーネントオブジェクトの 名 前 は 生 成 されたオブジェクトで 破 棄 されま
す。このため、 例 えばオブジェクトの 1 つである obj1.o を 名 前 で 参 照 することはで
きなくなります。 参 照 できるのは 結 合 オブジェクトである obj_all.o のみです。
特 定 アドレスへの 関 数 とデータの 配 置
通 常 、コンパイラは 1 つのソースファイルから RO、RW、ZI の 各 セクションを 生 成 し
ます。これらの 領 域 にはソースファイルからの 全 てのコードとデータが 含 まれていま
す。1 つの 関 数 またはデータ 項 目 を 固 定 アドレスに 配 置 するには、リンカにその 関 数 ま
たはデータを 入 力 ファイルの 残 りの 部 分 とは 別 に 生 成 させる 必 要 があります。 個 々の
オブジェクトにアクセスするには、 以 下 のいずれかの 方 法 を 使 用 します。
• 関 数 またはデータ 項 目 をそれ 専 用 のソースファイルに 配 置 する。
注
関 数 ごと、またはデータブロックごとに 1 つのオブジェクトを 指 定 すると、コン
パイラの 最 適 化 能 力 が 低 下 します。
• -zo コンパイラオプションを 使 用 して、 関 数 ごとに 1 つのオブジェクトファイル
を 生 成 する(ADS コンパイラ / ライブラリガイド 参 照 )。
• C または C++ ソースコード 内 で #pragma arm section を 使 用 し、 複 数 の 名 前
を 持 つセクションを 作 成 する(P. 5-27 例 5-5 参 照 )。
• アセンブリ 言 語 から AREA ディレクティブを 使 用 する。アセンブリコードでは、
配 置 可 能 な 最 小 単 位 が AREA となります(ADS アセンブラガイド 参 照 )。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-25

分 散 ローディング 記 述 ファイルの 使 用
各 オブジェクトファイルの 内 容 の 配 置
例 5-4 が 示 す 分 散 ローディング 記 述 ファイルは、 以 下 の 配 置 を 行 います。
• 初 期 化 コードをアドレス 0x0 に 配 置 する( 続 けて 残 りの RO コードと、オブジェ
クト data.o 内 の RO データを 除 く 全 ての RO データを 配 置 します)。
• 全 てのグローバル RW 変 数 を RAM 内 の 0x400000 に 配 置 する。
• data.o からのテーブル RO_DATA をアドレス 0x1ff00 に 固 定 する。
例 5-4 セクションの 配 置
LOADREG1 0x0 0x10000
{
EXECREG1 0x0 0x2000 ; ROOT Region, containing init code
{ ; place init code at exactly 0x0
init.o (Init, +FIRST)
* (+RO) ; rest of code and read-only data
}
RAM 0x400000
; RW data to be placed at 0x400000
{
* (+RW +ZI)
}
DATABLOCK 0x1ff00 0xff FIXED ; execution region fixed at 0x1ff00
{ ; the maximum space available for table is 0xff
data.o(+RO_DATA) ; place read-only data between 0x1ff00 and 0x1ffff
}
}
注
FIXED を 単 一 ロード 領 域 に 使 用 することが 適 切 ではない 場 合 があります。 以 下 に、 固
定 位 置 を 指 定 するための 他 の 方 法 を 紹 介 します。
• 使 用 するローダが 複 数 のロード 領 域 を 処 理 できる 場 合 は、RO コードまたはデー
タをその 専 用 のロード 領 域 に 配 置 する。
• 関 数 またはデータを ROM 内 の 固 定 位 置 に 配 置 する 必 要 がない 場 合 は、FIXED の
代 わりに ABSOLUTE を 使 用 する。これにより、ローダはロード 領 域 からのデー
タを RAM 内 の 指 定 されたアドレスにコピーします(ABSOLUTE はデフォルト 属
性 です)。
• データ 構 造 をメモリマップ I/O の 位 置 に 配 置 するには、2 つのロード 領 域 を 使 用
して UNINIT を 指 定 する(UNINIT を 使 用 するとメモリ 位 置 はゼロ 初 期 化 されま
せん)。 詳 細 については、ADS デベロッパガイドの「ROM へのコードの 書 き 込
み」を 参 照 して 下 さい。
5-26 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
arm セクションプラグマの 使 用
コードまたはデータオブジェクトを 専 用 ソースファイル 内 に 配 置 して、そのオブジェ
クトファイルのセクションを 配 置 するには、 標 準 的 なコーディング 方 法 を 使 用 します。
しかしながら、 命 名 されたセクションの 配 置 には、プラグマと 分 散 ローディング 記 述
ファイルも 使 用 することができます。モジュール( 例 :adder.c)を 作 成 し、 例 5-5 が
示 すようにセクションを 明 示 的 に 命 名 します。
例 5-5 セクションの 命 名
// file adder.c
int x1 = 5;
int y1[100];
int const z1[3] = {1,2,3};
int sub1(int x) {return x-1;}
// in.data
// in.bss
// in.constdata
// in.text
#pragma arm section rwdata = "foo", code ="foo"
int x2 = 5;
// in foo (data part of region)
char *s3 = "abc";
// s3 in foo, "abc" in .constdata
int add1(int x) {return x+1;} // in foo (.text part of region)
#pragma arm section code, rwdata // return to default placement
命 名 したセクションを 配 置 する 位 置 は、 分 散 ローディング 記 述 ファイルを 使 用 して 指
定 します( 例 5-6 参 照 )。コードセクションとデータセクションの 名 前 が 同 じ 場 合 には、
コードセクションを 先 に 配 置 します。
例 5-6 セクションの 配 置
FLASH 0x24000000 0x4000000
{
FLASH 0x24000000 0x4000000
{
init.o (Init, +First)
; place code from init.o first
* (+RO) ; sub1(), z1[]
}
32bitRAM 0x0000
{
vectors.o (Vect, +First)
* (+RW,+ZI) ; x1, y1
}
ADDER 0x08000000
{
adder.o (foo)
; x2, string s3, and add1()
}
}
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-27

分 散 ローディング 記 述 ファイルの 使 用
5.4 等 価 な 分 散 ローディング 記 述 を 使 用 した 単 純 イメージの 生 成
コマンドラインオプション(-ro-base、-rw-base、-reloc、-split、-ropi、-rwpi)
を 使 用 すると、P. 3-14「コマンドラインオプションを 使 用 した 単 純 イメージの 作 成 」で
説 明 した 単 純 イメージタイプが 作 成 されます。これらと 同 じイメージタイプは、
-scatter コマンドラインオプションと、 対 応 する 分 散 ローディング 記 述 を 含 むファイ
ルを 使 用 して 作 成 することができます。
5.4.1 タイプ 1
このタイプのイメージは、ロードビューでは 1 つのロード 領 域 、 実 行 ビューでは 3 つ
の 実 行 領 域 から 構 成 されます。 実 行 領 域 はメモリマップ 内 で 連 続 配 置 されます。
非 ropi 領 域
-ro-base address は、RO 出 力 セクションを 含 む 領 域 のロード / 実 行 アドレスを 指 定
します。 例 5-7 は、-ro-base 0x040000 を 使 用 したときと 同 じ 結 果 をもたらす 分 散
ローディング 記 述 を 示 しています。
例 5-7 単 一 ロード 領 域 と 連 続 実 行 領 域
LR_1 0x040000 ; Define the load region name as LR_1, the region starts at 0x040000.
{ ; Start of execution region descriptions.
ER_RO +0 ; First execution region is called ER_RO, region starts at end of previous region.
; However, since there was no previous region, the address is 0x040000.
{
*(+RO) ; All RO sections go into this region, they are placed consecutively.
}
ER_RW +0 ; Second execution region is called ER_RW, the region starts at the end of the
; previous region. The address is 0x040000 + size of ER_RO region.
{
}
*(+RW)
}
ER_ZI +0
{
}
*(+ZI)
; All RW sections go into this region, they are placed consecutively.
; Last execution region is called ER_ZI, the region starts at the end of the
; previous region at 0x040000 + the size of the ER_RO regions + the size of
; the ER_RW regions.
; All ZI region are placed consecutively here.
この 記 述 により、ロードアドレスが 0x040000 の、LR_1 と 命 名 された 単 一 ロード 領
域 が 作 成 されます。
5-28 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
このイメージは ER_RO、ER_RW、ER_ZI と 命 名 された 3 つの 実 行 領 域 で 構 成 され、こ
れらの 領 域 には RO、RW、ZI 出 力 セクションがそれぞれ 含 まれます。ER_RO の 実 行 ア
ドレスは 0x040000 です。これら 3 つの 全 ての 領 域 は、 実 行 領 域 の 記 述 に +offset 形
式 のベース 指 名 子 を 使 用 することによって、メモリマップ 内 に 連 続 で 配 置 されます。こ
の 方 法 で、1 つの 実 行 領 域 をその 前 の 実 行 領 域 の 直 後 に 配 置 することができます。
ropi 領 域
実 行 領 域 はメモリマップ 内 に 連 続 で 配 置 されます。しかし、-ropi は RO 出 力 セクショ
ンを 含 む 実 行 領 域 を 位 置 独 立 領 域 としてマーキングします。
RO 出 力 セクションを 含 む 領 域 のロード / 実 行 アドレスを 指 定 するには、-ro-base
address を 使 用 します。
例 5-8 は、-ro-base 0x010000 -ropi を 使 用 したときと 同 じ 結 果 をもたらす 分 散
ローディング 記 述 を 示 しています。
例 5-8 位 置 独 立 コード
LR_1 0x010000 PI ; The first load region is at 0x010000.
{
ER_RO +0
; The PI attribute is inherited from parent.
; The default execution address is 0x010000, but the code can be moved.
{
*(+RO)
; All the RO sections go here.
}
ER_RW +0 ABSOLUTE ; PI attribute is overridden by ABSOLUTE.
{
*(+RW)
; The RW sections are placed next. They cannot be moved.
}
ER_ZI +0
; ER_ZI region placed after ER_RW region.
{
*(+ZI)
; All the ZI sections are placed consecutively here.
}
}
RO 実 行 領 域 である ER_RO は、ロード 領 域 LR_1 の PI 属 性 を 継 承 します。 次 の 実 行 領
域 ER_RW は ABSOLUTE とマーキングされており、+offset 形 式 のベース 指 名 子 を 使
用 しています。このため、ER_RW は ER_RO から PI 属 性 を 継 承 しません。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-29

分 散 ローディング 記 述 ファイルの 使 用
5.4.2 タイプ 2
このタイプのイメージは、ロードビューでは 1 つのロード 領 域 から、 実 行 ビューでは 3
つの 実 行 領 域 から 構 成 されます。RW 実 行 領 域 が RO 実 行 領 域 と 隣 接 していないことを
除 けば、このタイプはタイプ 1 のイメージと 同 様 です。
非 rwpi 領 域
-ro-base address1は、RO 出 力 セクションを 含 む 領 域 のロード/ 実 行 アドレスを 指 定
します。-rw-base address2 は、RW 実 行 領 域 の 実 行 アドレスを 指 定 します。
例 5-9 は、-ro-base 0x010000 -rw-base 0x040000 を 使 用 したときと 同 じ 結 果
をもたらす 分 散 ローディング 記 述 を 示 しています。
例 5-9 単 一 ロード 領 域 と 複 数 実 行 領 域
LR_1 0x010000
{
ER_RO +0
}
; Defines the load region name as LR_1
; The first execution region is called ER_RO and starts at end of previous region.
; Since there was no previous region, the address is 0x010000.
{
*(+RO) ; All RO sections are placed consecutively into this region.
}
ER_RW 0x040000 ; Second execution region is called ER_RW and starts at 0x040000.
{
*(+RW) ; All RW sections are placed consecutively into this region.
}
ER_ZI +0
{
}
*(+ZI)
; The last execution region is called ER_ZI.
; The address is 0x040000 + size of ER_RW region.
; All ZI sections are placed consecutively here.
この 記 述 により、LR_1 と 命 名 され、ロードアドレスが 0x010000 の 単 一 ロード 領 域
で 構 成 されるイメージが 作 成 されます。
このイメージは、それぞれ RO、RW、ZI の 各 出 力 セクションを 含 む、ER_RO、ER_RW、
ER_ZI と 命 名 された 3 つの 実 行 領 域 から 構 成 されます。ER_RO の 実 行 アドレスは
0x010000 です。
ER_RW 実 行 領 域 は ER_RO に 隣 接 していません。この 領 域 の 実 行 アドレスは 0x040000
です。
5-30 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
ER_ZI 実 行 領 域 は、その 前 の 実 行 領 域 である ER_RW の 直 後 に 配 置 されます。
rwpi 領 域
この 領 域 は、RW 実 行 領 域 の -rw-base を RO 実 行 領 域 から 切 り 離 したタイプ 2 のイメー
ジに 似 ています。しかし、-rwpi は RW 出 力 セクションを 含 む 実 行 領 域 を 位 置 独 立 領
域 としてマーキングします。
タイプ 2 の 他 のイメージと 同 様 に、-ro-base address は RO 出 力 セクションを 含 む
領 域 のロード / 実 行 アドレスの 指 定 に 使 用 し、-rw-base address2 は RW 出 力 セク
ションを 含 む 領 域 のロード / 実 行 アドレスの 指 定 に 使 用 します。
例 5-10 は、-ro-base 0x010000 -rw-base 0x018000 -rwpi を 使 用 したときと
同 じ 結 果 をもたらす 分 散 ローディング 記 述 を 示 しています。
例 5-10 位 置 独 立 データ
LR_1 0x010000 ; The first load region is at 0x010000.
{
ER_RO +0
; Default ABSOLUTE attribute is inherited from parent. The execution address
; is 0x010000. The code and ro data cannot be moved.
{
*(+RO)
; All the RO sections go here.
}
ER_RW 0x018000 PI ; PI attribute overrides ABSOLUTE
{
*(+RW)
; The RW sections are placed at 0x018000 and they can be moved.
}
ER_ZI +0
; ER_ZI region placed after ER_RW region.
{
*(+ZI)
; All the ZI sections are placed consecutively here.
}
}
RO 実 行 領 域 である ER_RO は、ロード 領 域 LR_1 の ABSOLUTE 属 性 を 継 承 します。 次
の 実 行 領 域 ER_RW は PI とマーキングされています。
タイプ 2 とタイプ 3 のイメージにおける -ropi と -rwpi の 他 の 組 み 合 わせの 用 法 に
対 応 するように 同 様 の 分 散 ローディング 記 述 を 書 くこともできます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-31

分 散 ローディング 記 述 ファイルの 使 用
5.4.3 タイプ 3
タイプ 3 のイメージは、ロードビューでは 2 つのロード 領 域 から、 実 行 ビューでは 3 つ
の 実 行 領 域 から 構 成 されます。このタイプは、タイプ 2 での 単 一 ロード 領 域 が 2 つの
ロード 領 域 に 分 割 される 点 を 除 き、タイプ 2 のイメージと 同 様 です。
再 配 置 不 可 能 なロード 領 域
-ro-base address1は、RO 出 力 セクションを 含 む 領 域 のロード/ 実 行 アドレスを 指 定
します。-rw-base address2 は、RW 出 力 セクションを 含 む 領 域 のロード / 実 行 ア
ドレスを 指 定 します。
-split は、デフォルトの 単 一 ロード 領 域 (RO および RW 出 力 セクションを 含 む 領 域 )
を 2 つのロード 領 域 に 分 割 するために 使 用 します。これにより、 一 方 のロード 領 域 に
RO 出 力 セクションが、 他 方 に RW 出 力 セクションが 含 まれます。
例 5-11 は、-ro-base 0x010000 -rw-base 0x040000 -split を 使 用 したときと
同 じ 結 果 をもたらす 分 散 ローディング 記 述 を 示 しています。
例 5-11 複 数 ロード 領 域
LR_1 0x010000 ; The first load region is at 0x010000.
{
ER_RO +0 ; The address is 0x010000.
{
*(+RO)
}
}
LR_2 0x040000 ; The second load region is at 0x040000.
{
ER_RW +0 ; The address is 0x040000.
{
*(+RW) ; All RW sections are placed consecutively into this region.
}
ER_ZI +0 ; The address is 0x040000 + size of ER_RW region.
{
*(+ZI) ; All ZI sections are placed consecutively into this region.
}
}
この 記 述 により、ロードアドレスが 0x010000 と 0x040000 の、LR_1 および LR_2
と 命 名 された 2 つのロード 領 域 を 持 つイメージが 作 成 されます。
5-32 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

分 散 ローディング 記 述 ファイルの 使 用
このイメージは、それぞれ RO、RW、ZI の 各 出 力 セクションを 含 む、ER_RO、ER_RW、
ER_ZI と 命 名 された 3 つの 実 行 領 域 から 構 成 されます。ER_RO の 実 行 アドレスは
0x010000 です。
ER_RW 実 行 領 域 は ER_RO に 隣 接 していません。この 領 域 の 実 行 アドレスは 0x040000
です。
ER_ZI 実 行 領 域 は、その 前 の 実 行 領 域 である ER_RW の 直 後 に 配 置 されます。
再 配 置 可 能 なロード 領 域
このタイプ 3 のイメージもまた、ロードビューでは 2 つのロード 領 域 から、 実 行 ビュー
では 3 つの 実 行 領 域 から 構 成 されます。しかし、-reloc を 使 用 することによって、2
つのロード 領 域 に RELOC 属 性 が 設 定 されます。
-ro-base address1は、RO 出 力 セクションを 含 む 領 域 のロード/ 実 行 アドレスを 指 定
します。-rw-base address2 は、RW 出 力 セクションを 含 む 領 域 のロード / 実 行 ア
ドレスを 指 定 します。
-splitは、RO 出 力 セクションとRW 出 力 セクションを 含 むデフォルトの 単 一 ロード 領
域 を 2 つのロード 領 域 に 分 割 するために 使 用 します。これにより、 一 方 のロード 領 域
には RO 出 力 セクションが、 他 方 には RW 出 力 セクションが 含 まれます。
P. 5-34 例 5-12 は、-ro-base 0x010000 -rw-base 0x040000 -reloc -split を
使 用 したときと 同 じ 結 果 をもたらす 分 散 ローディング 記 述 を 示 しています。
この 記 述 により、ロードアドレスが 0x010000 と 0x040000 の、LR_1 および LR_2
と 命 名 された 2 つのロード 領 域 を 持 つイメージが 作 成 されます。
このイメージは、それぞれ RO、RW、ZI の 各 出 力 セクションを 含 む、ER_RO、ER_RW、
ER_ZIと 命 名 された3つの 実 行 領 域 から 構 成 されます。ER_ROのデフォルト 実 行 アドレ
スは 0x010000 です。
ER_RW 実 行 領 域 は ER_RO に 隣 接 していません。この 領 域 のデフォルト 実 行 アドレスは
0x040000 です。
ER_ZI 実 行 領 域 は、その 前 の 実 行 領 域 である ER_RW の 直 後 に 配 置 されます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 5-33

分 散 ローディング 記 述 ファイルの 使 用
例 5-12 再 配 置 可 能 なロード 領 域
LR_1 0x010000 RELOC
{
ER_RO + 0
{
*(+RO)
}
}
LR2 0x040000 RELOC
{
ER_RW + 0
{
*(+RW)
}
}
ER_ZI +0
{
*(+ZI)
}
5-34 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 6 章
ライブラリの 作 成 と 使 用
本 章 では armlink とライブラリの 使 用 について 説 明 します。 本 章 は 以 下 のセクションか
ら 構 成 されています。
• ライブラリについて:P. 6-2
• ライブラリの 検 索 、 選 択 、スキャン:P. 6-3
• ARM ライブラリアン:P. 6-6
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 6-1

ライブラリの 作 成 と 使 用
6.1 ライブラリについて
オブジェクトファイルは、 関 数 や 変 数 といった 外 部 シンボルを 参 照 することができま
す。armlink はこれらの 参 照 を、 他 のオブジェクトファイルまたはライブラリから 検 出
された 定 義 とマッチングすることによって 解 決 しようと 試 みます。armlink は、ar 形 式
のファイルに 格 納 された ELF ファイルの 集 合 をライブラリとして 認 識 します。
6-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

ライブラリの 作 成 と 使 用
6.2 ライブラリの 検 索 、 選 択 、スキャン
armlink がオブジェクトファイルをイメージに 追 加 する 方 法 と、ライブラリをイメージ
に 追 加 する 方 法 には、 以 下 の 違 いがあります。
• 入 力 リスト 内 の 各 オブジェクトファイルは、それを 参 照 するものがあるかどうか
に 関 係 なく 無 条 件 に 出 力 イメージに 追 加 されますが、-noremove が 使 用 されて
いない 限 り、 未 使 用 セクションは 後 で 削 除 されます。
• ライブラリのメンバは、オブジェクトファイルまたはインクルード 済 みのライブ
ラリメンバがそのメンバへの 弱 い 参 照 を 行 う 場 合 にのみ、あるいは armlink が 明
示 的 にそのメンバを 追 加 するように 指 示 されている 場 合 にのみ、 出 力 にインク
ルードされます。
注
パタンを 使 用 してライブラリから 選 択 されたメンバは、オブジェクトであるかの
ように 無 条 件 にイメージに 追 加 されます。
弱 いシンボルへの 未 解 決 参 照 によってライブラリメンバがロードされることはありま
せん。
注
-noscanlib オプションが 指 定 されている 場 合 、armlink はデフォルトの ARMライブラ
リを 検 索 せずに、 入 力 ファイルリスト 内 に 指 定 されているライブラリのみを 使 用 して
参 照 を 解 決 します。
あるライブラリメンバが 入 力 ファイルリスト 内 で 明 示 的 に 要 求 されている 場 合 、その
メンバはたとえ 現 在 の 参 照 を 解 決 するものでなくてもロードされます。この 場 合 、 明
示 的 に 要 求 されたメンバは、 通 常 のオブジェクトであるかのように 扱 われます。
armlink はライブラリリストを 以 下 のように 作 成 します。
1. armlink は、 入 力 ファイルリスト 内 に 指 定 されている 全 てのライブラリをリスト
に 追 加 します。
2. armlink によってユーザ 指 定 検 索 パスが 検 査 され、 入 力 オブジェクトに 組 み 込 ま
れたライブラリ 要 求 のライブラリディレクトリが 識 別 されます。この 検 索 プロセ
スの 詳 細 については、P. 6-4「ARM ライブラリの 検 索 」を 参 照 して 下 さい。
検 索 対 象 のディレクトリおよびサブディレクトリからは、 最 適 なライブラリバリアン
トが 選 択 されます。ARM が 提 供 しているライブラリには、そのメンバの 属 性 に 基 づい
て 命 名 された 複 数 のバリアントがあります。ライブラリバリアントの 詳 細 については、
ADS コンパイラ / ライブラリガイドおよび P. 6-4「ARM ライブラリバリアントの 選 択 」
を 参 照 して 下 さい。
armlink はライブラリのリストを 構 成 すると、リスト 内 の 各 ライブラリを 何 度 もスキャ
ンすることによって 参 照 を 解 決 します。 詳 細 については、P. 6-5「ライブラリのスキャ
ン」を 参 照 して 下 さい。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 6-3

ライブラリの 作 成 と 使 用
6.2.1 ユーザライブラリの 検 索
コマンドラインで 明 示 的 にインクルードするライブラリの 場 合 、それらのライブラリ
が 現 在 の 作 業 ディレクトリ 内 に 存 在 しなければパスが 要 求 されます。
注
ARM 標 準 ライブラリに 使 用 される 検 索 パスは、ユーザライブラリの 検 索 対 象 となりま
せん。
6.2.2 ARM ライブラリの 検 索
ARM 標 準 ライブラリの 検 出 に 使 用 される 検 索 パスは、 以 下 の 方 法 で 指 定 することがで
きます。
• armlink コマンドラインにおいて、カンマで 区 切 った 親 ディレクトリのリストに
-libpath 引 数 を 追 加 する。
このリストは、ARM ライブラリディレクトリ armlib および cpplib の 親 ディ
レクトリで 終 わっている 必 要 があります。ARMLIB 変 数 は、ARM ライブラリの
親 ディレクトリへのパスを 保 持 します。
注 意
-libpath は、ARMLIB 変 数 によって 指 定 されるパスをオーバライドします。
• CodeWarrior IDE リンカコンフィギュレーションパネルを 使 用 する(CodeWarrior
IDE Guide 参 照 )。
• 環 境 変 数 ARMLIB を 使 用 する。
armlink は、 上 記 の -libpath、コンフィギュレーションパネル、ARMLIB 変 数 のいず
れかによって 指 定 された 各 親 ディレクトリと、 入 力 オブジェクトからの 各 サブディレ
クトリ 要 求 を 組 み 合 わせることにより、ARM ライブラリの 検 索 場 所 を 識 別 します。 親
ディレクトリ 内 のARMサブディレクトリの 名 前 は、Lib$$Request$$sub_dir_name
形 式 のシンボルを 使 用 することにより、コンパイル 後 の 各 オブジェクト 内 に 配 置 され
ます。
6.2.3 ARM ライブラリバリアントの 選 択
armlink は ARM ライブラリの 検 索 時 に 選 択 した 各 ディレクトリから 最 適 なライブラリ
を 選 択 する 必 要 があります。これらのライブラリは、そのメンバオブジェクトの 属 性
に 基 づいた ARM ライブラリのバリアントです。ARM ライブラリのバリアントが ARM
ライブラリに 代 わってコーディングされます。ライブラリの 命 名 規 則 については、ADS
コンパイラ / ライブラリガイドを 参 照 して 下 さい。
6-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

ライブラリの 作 成 と 使 用
armlink は 各 入 力 オブジェクトの 属 性 を 累 算 し、それらを 使 用 して 累 算 属 性 に 最 適 なラ
イブラリバリアントを 選 択 します。 選 択 した 複 数 のライブラリが 同 等 に 適 している 場
合 には、 最 初 に 選 択 されたライブラリが 保 存 され、 他 のライブラリは 破 棄 されます。
最 終 リストには、armlink が 参 照 を 解 決 するためにスキャンする 全 てのライブラリが 含
まれています。
6.2.4 ライブラリのスキャン
全 てのディレクトリが 検 索 されると、 最 も 互 換 性 の 高 いライブラリバリアントが 選 択
されてライブラリリストに 追 加 され、 要 求 されたメンバをロードするために 各 ライブ
ラリがスキャンされます。
1. 現 時 点 で 未 解 決 の 非 弱 な 各 参 照 について、armlink は 一 致 する 定 義 を 求 めてライ
ブラリリストをシーケンシャルに 検 索 します。 最 初 に 検 出 された 定 義 がステップ
2 のためにマーキングされます。
検 索 をシーケンシャルに 行 う 理 由 は、 複 数 のライブラリが 同 一 シンボルを 定 義 し
ている 場 合 でも、armlink にリスト 内 で 最 初 に 出 現 したライブラリを 選 択 させる
ためです。したがって、 使 用 するライブラリを 入 力 ファイルリストに 追 加 するこ
とで、ARM C ライブラリなどの 他 のライブラリからの 関 数 定 義 をオーバライド
することができます。
2. ステップ 1 でマーキングされたライブラリメンバがロードされます。メンバが
ロードされるたび、 場 合 によっては 弱 い 参 照 も 含 めた 未 解 決 参 照 の 幾 分 かが 満 た
されます。また、ライブラリをロードすることにより、 未 解 決 の 弱 い 参 照 または
非 弱 な 参 照 が 新 たに 作 成 される 可 能 性 があります。
3. ステップ 1 と 2 のプロセスは、 全 ての 非 弱 な 参 照 が 解 決 されるまで、あるいはど
のライブラリによっても 解 決 できなくなるまで 継 続 されます。
スキャン 動 作 の 終 了 時 に 非 弱 な 参 照 が 未 解 決 のまま 残 っている 場 合 には、armlink はエ
ラーメッセージを 生 成 します。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 6-5

ライブラリの 作 成 と 使 用
6.3 ARM ライブラリアン
ARM ライブラリアン armar により、ELF オブジェクトファイルセットをまとめてライ
ブラリに 保 存 することができます。armlink には 複 数 のオブジェクトファイルの 代 わり
にこのライブラリを 渡 すことができます。しかし、1 つのオブジェクトライブラリファ
イルとリンクさせても、そのオブジェクトライブラリファイルに 収 集 された 全 てのオ
ブジェクトファイルとリンクしたときと 同 じ 結 果 が 得 られるとは 限 りません。これは
armlink が 入 力 リストとライブラリを 異 なる 方 法 で 処 理 するためです。
• armlink -remove オプションが 指 定 されていれば 未 使 用 エリアは 削 除 されます
が、 入 力 リスト 内 の 各 オブジェクトファイルは 無 条 件 に 出 力 に 出 現 します。
• ライブラリファイルのメンバは、オブジェクトファイルまたはその 前 に 処 理 され
たライブラリファイルによって 参 照 される 場 合 にのみ、 出 力 にインクルードされ
ます。
armlink の 入 力 ファイルの 処 理 方 法 については、 第 2 章 「armlink のコマンド 構 文 」を 参
照 して 下 さい。
6.3.1 ライブラリアンコマンドラインオプション
以 下 は、ファイルまたはライブラリ 情 報 の 抽 出 に 使 用 する armar コマンド 構 文 を 示 して
います。
armar [ -help] [-C] [-entries] [-p] [-t] [-s] [-sizes] [-T] [-vsn] [-v]
[-via option_file] [-x] [-zs] [-zt] library [file_list]
以 下 は、ライブラリ 内 のファイルを 追 加 または 修 正 するときに 使 用 する 構 文 です。
armar [ -help] [-create] [-c] [-d] [-m] [-q] [-r] [-u] [-vsn] [-v]
[-via option_file] [ {-a|-b|-i} pos_name] library [file_list]
オプションの 説 明 :
-a library 内 の 新 しいファイルをファイル pos_name の 後 に 配 置 します。
-b library 内 の 新 しいファイルをファイル pos_name の 前 に 配 置 します。
-create
library が 既 に 存 在 している 場 合 でも、 新 しいライブラリを 作 成 します。
-c ライブラリの 作 成 時 に、 通 常 は 標 準 エラーに 書 き 込 まれる 診 断 メッセー
ジを 抑 制 します。
-C 抽 出 実 行 時 に、 既 存 ファイルを 似 た 名 前 のファイルと 置 き 換 えないよう
にライブラリアンに 指 示 します。このオプションは、 短 縮 ファイル 名 が
同 じ 接 頭 文 字 でファイルを 置 き 換 えないように -T を 一 緒 に 使 用 すると
有 効 です。
-d library から 1 つ 以 上 のファイルを 削 除 します。
6-6 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

ライブラリの 作 成 と 使 用
-entries
file_list
-help
library 内 に 定 義 された 全 てのエントリポイントをリストします。リスト
形 式 は 以 下 のとおりです。
ENTRY at offset num in section name of member
処 理 対 象 となるファイルのリストです。 各 ファイルは、そのパスと 名 前
で 完 全 指 定 します。このパスには、 絶 対 パス、ドライブ / ルートに 対 す
る 相 対 パス、カレントディレクトリに 対 する 相 対 パスのいずれかを 指 定
することができます。
ライブラリに 含 まれるファイルの 名 前 との 比 較 には、パスの 最 後 にある
ファイル 名 だけが 使 用 されます。 複 数 のパスオペランドが 同 一 ファイル
名 で 終 わっている 場 合 の 結 果 は 定 義 されていません。ファイルの 指 定 に
は、ワイルドカード * および ? を 使 用 できます。
これらのファイルの 1 つがライブラリである 場 合 、armar はその 入 力 ライ
ブラリの 全 てのメンバをデスティネーションライブラリにコピーしま
す。コマンドラインからの 入 力 項 目 の 順 序 がそのまま 保 たれます。した
がって、ライブラリファイルを 与 えることは、その 全 てのメンバをライ
ブラリに 保 存 したときの 順 序 で 与 えることと 論 理 的 には 同 じことです。
armar コマンドの 詳 細 をオンラインで 提 供 します。
-i library 内 の 新 しいファイルをメンバ pos_name の 前 に 配 置 します(-b と
等 価 です)。
library ライブラリファイルのパス 名 です。
-m ファイルを 移 動 します。-a、-b、-i が pos_name に 指 定 されていると
き、ファイルが 新 しい 位 置 に 移 動 されます。その 他 の 場 合 は、ファイル
がライブラリの 終 わりに 移 動 されます。
-n アーカイブシンボルテーブルを 抑 制 します。このオプションは、ライブ
ラリがオブジェクトライブラリではない 場 合 に 使 用 します。
-p library 内 のファイルの 内 容 を 標 準 出 力 に 印 字 します。
pos_name 相 対 配 置 に 使 用 される 既 存 のライブラリメンバの 名 前 です。この 名 前 は、
オプション -a、-b、あるいは -i を 付 けて 指 定 する 必 要 があります。
-q -r のエイリアスです。
-r library 内 のファイルを 置 換 、または 追 加 します。library が 存 在 しない 場
合 は 新 しいライブラリファイルが 作 成 され、 診 断 メッセージが 標 準 エ
ラーに 書 き 込 まれます。
file_list が 指 定 されていないときにライブラリが 存 在 する 場 合 の 結 果 は 定
義 されていません。 既 存 ファイルに 置 き 換 わるファイルが、ライブラリ
の 順 序 を 変 更 することはありません。
-u オプションが 使 用 されている 場 合 には、ライブラリファイルよりも 後
の 修 正 日 付 を 持 つファイルだけが 置 き 換 えられます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 6-7

ライブラリの 作 成 と 使 用
-a、-b、-i のいずれかのオプションを 使 用 するときは pos_name が 存 在
していなければならず、 新 しいファイルを pos_name の 後 (-a)と 前 (-b
または -i)のどちらに 配 置 するかを 指 定 する 必 要 があります。 指 定 され
ていない 場 合 、 新 しいファイルは 最 後 に 配 置 されます。
-t library の 内 容 を 印 字 します。 印 字 されるリストには file_list によって 指 定
されたファイルが 含 まれます。file_list が 指 定 されていない 場 合 は、ライ
ブラリ 内 の 全 てのファイルがアーカイブ 順 に 印 字 されます。
-s アーカイブシンボルテーブルを 生 成 します。
-sizes
library に 含 まれる 各 メンバの Code、RO Data、RW Data、ZI Data、
Debug のサイズをリストします。 以 下 はこの 出 力 例 です。
Code RO Data RW data ZI Data Debug Object Name
464 0 0 0 8612 app_1.o
3356 0 0 10244 11848 app_2.o
3820 0 0 10244 20460 TOTAL
-T このオプションを 使 用 すると、ファイルシステムがサポートできる 長 さ
よりもライブラリ 名 が 長 い 抽 出 ファイルの 名 前 を 短 縮 することができま
す。デフォルトでは、 長 過 ぎる 名 前 のファイルを 抽 出 するとエラーが 生
じます。この 場 合 は 診 断 メッセージが 書 き 込 まれ、そのファイルは 抽 出
されません。
-u 古 いファイルを 更 新 します。-r オプションと 組 み 合 わせて 使 用 した 場 合
は、 対 応 ファイルの 修 正 時 間 が 少 なくともライブラリ 内 のファイルの 修
正 時 間 と 同 じぐらい 最 近 の 場 合 にのみ、library 内 のファイルが 置 き 換 え
られます。
-via option_file
ライブラリアンに option_file からオプションを 取 得 するように 命 令
します。via ファイルの 記 述 については、ADS コンパイラ / ライブラリガ
イドを 参 照 して 下 さい。
-v verbose 出 力 を 与 えます。
この 出 力 は、 他 に 使 用 されているオプションに 依 存 します。
-d, -r or -x
ライブラリ 作 成 のファイルごとの 記 述 、 構 成 ファイル、 保 守
活 動 を 記 述 します。
-p ファイル 自 体 を 標 準 出 力 に 書 き 込 む 前 に、ファイルの 名 前 を
標 準 出 力 に 書 き 込 みます。
-t ライブラリ 内 のファイルに 関 する 情 報 の 長 いリストを 含 み
ます。
-x 各 抽 出 前 にファイル 名 を 印 字 します。
-vsn
標 準 エラーにバージョン 番 号 を 印 字 します。
6-8 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

ライブラリの 作 成 と 使 用
-x library から file_list 内 のファイルを 抽 出 します。library の 内 容
は 変 更 されません。ファイルオペランドが 指 定 されていない 場 合 は、
library 内 の 全 ファイルが 抽 出 されます。ライブラリから 抽 出 された
ファイルの 名 前 がデスティネーションディレクトリでサポートされてい
る 長 さよりも 長 い 場 合 の 結 果 は 定 義 されていません。
-zs
-zt
シンボルテーブルを 表 示 します。
library に 含 まれるメンバのサイズおよびエントリポイントをリストしま
す。 出 力 形 式 については、-sizes および -entries を 参 照 して 下 さい。
注
通 常 操 作 では、オプション -a、-b、-C、-i、-m、-T、-u、-v は 必 要 ありません。
ARM ツールチェインではシンボルテーブルを 持 たないライブラリを 使 用 することがで
きないため、ライブラリ 順 序 に 関 連 するオプション(-a、-b、-i、-m など)は 関 係
ありません(シンボルテーブルが 存 在 すれば、 順 序 は 関 係 ありません)。
ライブラリは 更 新 するよりも 再 構 築 することが 多 いため、ライブラリの 更 新 に 関 連 す
るオプション(-C および -u)を 使 用 することはあまりありません。
6.3.2 例
例 6-1 ~ P. 6-10 例 6-7 は、 構 文 の 例 を 示 しています。
例 6-1 新 しいライブラリの 作 成 と 全 オブジェクトファイルの 追 加
armar -create mylib *.o
例 6-2 目 次 のリスト
armar -t mylib
例 6-3 シンボルテーブルのリスト
armar -zs mylib
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 6-9

ライブラリの 作 成 と 使 用
例 6-4 ファイルの 追 加 (または 置 換 )
armar -r my_lib obj1.o obj2.o obj3.o ...
armar -ru mylib k*.o
例 6-5 ファイルグループの 抽 出
armar -x my_lib k*.o
例 6-6 ファイルグループの 削 除
armar -d my_lib sys_*
例 6-7 ライブラリと 追 加 (または 置 換 )ファイルのマージ
armar -r my_lib.a obj1.o my_lib.a other_lib.a obj2.o obj3.o
6-10 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 7 章
fromELF の 使 用
本 章 では ADS に 収 録 されている fromELF ソフトウェアユーティリティについて 説 明 し
ます。 本 章 は 以 下 のセクションから 構 成 されています。
• fromELF について:P. 7-2
• fromELF コマンドラインオプション:P. 7-3
• fromELF の 使 用 例 :P. 7-10
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 7-1

fromELF の 使 用
7.1 fromELF について
fromELF ユーティリティは、armlink によって 生 成 された 実 行 リンク 形 式 (ELF)のイ
メージファイルを、ROM ツールまたはメモリへの 直 接 ロードに 適 した 他 の 形 式 に 変 換
します。また、このユーティリティを 使 用 して ELF オブジェクトに 関 する 様 々な 情 報
を 表 示 させたり、その 情 報 を 含 むテキストファイルを 生 成 することもできます。
fromELF は 以 下 のイメージ 形 式 を 出 力 します。
• プレーンバイナリ 形 式
• Motorola 32 ビット S レコード 形 式
• Intel Hex-32 形 式
• バイト 向 き(Verilog メモリモデル)16 進 形 式
• ELF 形 式 (ELF で 再 保 存 することができます。 例 えば、-debug ELF イメージを
-nodebug ELF イメージに 変 換 することが 可 能 です。)
また fromELF を 使 用 することにより、 逆 アセンブリ 出 力 やシンボルリストなどの 入 力
ファイルに 関 する 情 報 を、 標 準 出 力 またはテキストファイルに 印 字 させることも 可 能
です。
注
-fieldoffsets fromELF ステップを 必 要 とする 場 合 は、-nodebug リンカオプション
使 用 してイメージをリンクしないで 下 さい。デバッグ 情 報 なしでイメージが 生 成 され
た 場 合 :
• fromELF はそのイメージを 他 のファイル 形 式 に 変 換 することができません。
• fromELF は 有 意 な 逆 アセンブリリストを 生 成 することができません。
7.1.1 イメージ 構 造
fromELF はファイルを ELF から 他 の 形 式 に 変 換 することができます。ただし、-base
オプションが 使 用 されているときに Motorola S レコードまたは Intel Hex 出 力 のベース
アドレスを 変 更 することを 除 いては、イメージの 構 造 もアドレスも 変 更 することがで
きません。 分 散 ロードされる ELF イメージを 他 の 形 式 の 非 分 散 ロードイメージに 変 換
することはできません。 構 造 またはアドレシングに 関 する 情 報 は、 全 てリンク 時 に
armlink に 渡 す 必 要 があります。
7-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

fromELFの 使 用
7.2 fromELF コマンドラインオプション
以 下 は、fromELF のコマンド 構 文 です。
fromelf [-help] [-fieldoffsets [-select select_options ]] [-nolinkview]
[-nodebug] [-vsn] [text_output_format| code_output_format] [-base n]
[memory_config] [-output output_file] input_file
オプションの 説 明 :
-help
-fieldoffsets
ヘルプ 情 報 と 用 法 を 表 示 します。このオプションが 指 定 されてい
るとき、 他 のコマンドラインオプションは 無 視 されます。パラ
メータを 何 も 指 定 せずに fromELF を 呼 び 出 すと、 同 じヘルプ 情 報
が 生 成 されます。
C++ クラスまたは C 構 造 フィールドの 名 前 が、そのクラスまたは
構 造 のベースからのオフセットを、また、アセンブリ 言 語 の 場 合
の EQU ディレクティブのリストを 生 成 し、 標 準 出 力 に 書 き 込 みま
す。この 入 力 ELF ファイルは 再 配 置 可 能 なオブジェクトまたはイ
メージです。
出 力 をファイルに 転 送 するには -o を 使 用 します。 生 成 されたファ
イルをロードし、C++ クラスおよび C 構 造 のメンバにアセンブリ
言 語 から 名 前 でアクセスするには、armasm から INCLUDE コマン
ドを 使 用 します。armasm の 詳 細 については、ADS アセンブラガ
イドを 参 照 して 下 さい。
注
ソースファイルにデバッグ 情 報 が 含 まれていない 場 合 は、このオ
プションを 使 用 できません。また、このオプションを
code_output_format と 一 緒 に 使 用 することはできません。
-fieldoffsets は、 全 ての 構 造 情 報 を 出 力 します。 構 造 のサブ
セットを 出 力 するには、-select select_options を 使 用 し
ます。
armasm に 入 力 可 能 なファイルを 必 要 としない 場 合 には、-text
-a オプションを 使 用 することによって、 表 示 アドレスをさらに 読
みやすい 形 式 にフォーマットすることができます。-a オプション
は、イメージ 内 の 構 造 とスタティックデータのアドレス 情 報 のみ
を 出 力 します。これは、それらのアドレスが 再 配 置 可 能 オブジェ
クト 内 においては 未 知 であるためです。
-select select_options
-select select_option は、-fieldoffsets または -text
-a のどちらかのオプションと 一 緒 に 使 用 することにより、オプ
ションリスト 内 のパタンと 一 致 するフィールドだけを 選 択 する
ことができます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 7-3

fromELF の 使 用
複 数 フィールドの 選 択 には 特 殊 文 字 を 使 用 します。
• リスト 内 のオプションを 結 合 するには a を 使 用 します( 例 :
a*,b*,c*)
• 任 意 の 名 前 とのマッチングには、ワイルドカード 文 字 * を
使 用 できます。
• 任 意 の 1 文 字 とのマッチングには、ワイルドカード 文 字 ?
を 使 用 できます。
• インクルードするフィールドは、select_option ストリ
ングに 接 頭 文 字 a + を 付 けることによって 指 定 します。これ
はデフォルトです。
• 除 外 するフィールドは、select_option ストリングに 接
頭 文 字 a ~ を 付 けることによって 指 定 します。
Unix 上 で 特 殊 文 字 を 使 用 する 場 合 は、シェルが 選 択 を 拡 大 しない
ように、オプションを 引 用 符 で 囲 む 必 要 があります。
-nolinkview
ELF イメージからセクションレベルのビュー(リンク 時 のビュー)
を 破 棄 し、セグメントレベルのビュー(ロード 時 のビュー)だけ
を 保 存 する 場 合 は -nolinkview を 使 用 します。セクションレベ
ルのリンクビューを 破 棄 すると、 以 下 が 削 除 されます。
• セクションヘッダテーブル
• セクションヘッダストリングテーブル
• ストリングテーブル
• シンボルテーブル
• 全 てのデバッグセクション
出 力 に 残 るのはプログラムヘッダテーブルとプログラムセグメ
ントだけです。ELF 仕 様 により、ELF ファイル 内 に 存 在 するもの
でプログラムローダに 依 存 するものはこれだけです。
注 意
コマンドラインで -elf を 指 定 していないときにこのオプション
を 使 用 すると、 予 期 しない 結 果 が 生 じることがあります。 正 しい
用 例 については、P. 7-5 例 7-2 を 参 照 して 下 さい。
7-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

fromELFの 使 用
-nodebug
このオプションを 使 用 すると、 出 力 ファイルにデバッグ 情 報 が 含
まれません。バイナリイメージの 場 合 はこれがデフォルト 設 定 で
す。-nodebug が 指 定 されていると、 全 ての 出 力 形 式 に 作 用 しま
す。このオプションは -text -g オプションをオーバライドし
ます。
注 意
コマンドラインで -elf を 指 定 していないときにこのオプション
を 使 用 すると、 予 期 しない 結 果 が 生 じることがあります。 例 7-1
のオプションは、 出 力 形 式 が 指 定 されていないためにテキスト
ファイルを 生 成 します。
例 7-1 テキスト 出 力
fromelf -nodebug image -o image_nodb.asf
ELF 形 式 の 出 力 を 得 るには、 例 7-2が 示 すオプションを 使 用 します。
例 7-2 ELF 出 力
fromelf -elf -nodebug image.axf -o image_ndb.axf
-vsn
fromELF のバージョン 情 報 を 表 示 します。
text_output_format
イメージ 情 報 をテキスト 形 式 で 表 示 させるには、テキスト 指 定
( 例 :-text -c)を 使 用 します。このオプションを 使 用 して、ELF
イメージまたはELFオブジェクトファイルをデコードすることが
できます。このオプションはデフォルトです。テキスト 形 式 また
は、コード 出 力 形 式 が 指 定 されていない 場 合 には、-text とみな
されます。
output_fileが-oオプションと 一 緒 に 指 定 されていない 場 合 に
は、 情 報 は 標 準 出 力 に 表 示 されます。
特 定 のテキストカテゴリを 指 定 していない 場 合 は、デフォルトで
ヘッダ 情 報 が 出 力 されます。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 7-5

fromELF の 使 用
指 定 する 場 合 、テキストカテゴリは 以 下 の 1 つ 以 上 の 要 素 で 構 成
します。
a グローバルアドレスとスタティックデータアドレス
( 構 造 および 合 併 内 容 のアドレスを 含 む)を 印 字 しま
す。このオプションは、デバッグ 情 報 を 含 むファイル
にのみ 使 用 できます。データアドレスのサブセットを
出 力 するには、-select オプションを 使 用 します。
c コードを 逆 アセンブルします。
d データセクションの 内 容 を 印 字 します。
g デバッグ 情 報 を 印 字 します。
r 再 配 置 情 報 を 印 字 します。
s シンボルテーブルを 印 字 します。
t ストリングテーブルを 印 字 します。
v イメージの 各 セグメントとセクションヘッダに 関 する
詳 細 情 報 を 印 字 します。
z コードサイズとデータサイズを 印 字 します。
上 記 のカテゴリセレクタは、 以 下 のいずれかで 指 定 することがで
きます。
• 個 々のオプション( 例 :-text -c -d)
• 単 一 の 連 結 ストリング( 例 :-text -cd)
• カテゴリセレクタのみ( 例 :-c -d)
• スラッシュ 文 字 の 後 に 複 数 文 字 を 続 ける( 例 :-text/cd)
出 力 形 式 が 指 定 されていない 場 合 は、デフォルト 出 力 形 式 -text
が 使 用 され、 個 々のカテゴリセレクタが 認 識 されます。 別 の 出 力
形 式 が 指 定 されている 場 合 、これらのセレクタは 無 視 されます。
7-6 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

fromELFの 使 用
code_output_format
バイナリまたは ELF 出 力 ファイルオプションを 選 択 します。
code_output_format には 以 下 のいずれかを 指 定 することがで
きます。
-bin プレーンバイナリ。memory_config オプションを 使
用 して、このオプションからの 出 力 を 複 数 のファイル
に 分 割 することができます。
-ihf 拡 張 Intellec16 進 形 式 。この 出 力 のベースアドレスは
-base オプションを 使 用 して 指 定 することができま
す。(このオプションは 現 在 使 用 されておらず、 本 製 品
の 今 後 のバージョンからは 削 除 される 予 定 です。)
-m32 Motorola 32 ビット 形 式 (32 ビット S レコード)。この
出 力 のベースアドレスは-base オプションを 使 用 して
指 定 することができます。
-i32 Intel Hex-32 形 式 。この 出 力 のベースアドレスは -base
オプションを 使 用 して 指 定 することができます。
-vhx バイト 向 け(Verilog メモリモデル)16 進 形 式 。この 形
式 は、HDL シミュレータのメモリモデルへのロードに
適 しています。memory_config オプションを 使 用 し
て、このオプションからの 出 力 を 複 数 ファイルに 分 割
することができます。
-elf ELF 形 式 (ELF で 再 保 存 )。このオプションを 使 用 し
て、デバッグ ELF イメージを 非 デバッグ ELF イメージ
に 変 換 することができます。
fromELF を 使 用 し、-bin、-ihf、-m32、-i32、-vhx オプショ
ンのいずれかを 使 用 して 複 数 のロード 領 域 を 含 むELFイメージを
バイナリ 形 式 に 変 換 する 場 合 、fromELF は output_file と 命 名
された 出 力 ディレクトリを 作 成 し、 入 力 イメージ 内 の 各 ロード 領
域 につき 1 つのバイナリ 出 力 ファイルを 生 成 します。fromELF は
これらの 出 力 ファイルを output_file ディレクトリ 内 に 配 置 し
ます。
複 数 のロード 領 域 を 定 義 する 分 散 ロード 記 述 ファイルを 使 用 し
て ELF イメージをビルドした 場 合 、この ELF イメージには 複 数
のロード 領 域 が 含 まれます。
-base n
Motorola S レコード、Intel Hex、 拡 張 Intellec16 進 の 各 ファイル 形
式 で 生 成 された 出 力 のベースアドレスを 指 定 します。このオプ
ションは、 出 力 形 式 -m32、-i32、-ihf のいずれかが 指 定 され
ている 場 合 にのみ 使 用 できます。
ベースアドレスは 以 下 のどちらかで 指 定 することができます。
• 10 進 数 ( 例 :-base 0)
• 16 進 数 ( 例 :-base 0x8000)
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 7-7

fromELF の 使 用
出 力 ファイルにエンコードされた 全 てのアドレスが、ベースアド
レス n で 開 始 します。-base オプションを 指 定 していない 場 合 は、
このベースアドレスがロード 領 域 アドレスから 取 得 されます。
注
. 複 数 のロード 領 域 が 存 在 する 場 合 、-base 値 は 各 出 力 ファイルに
使 用 されます。つまり、この 値 が 全 てのロード 領 域 アドレスを
オーバライドします。
memory_config
複 数 メモリバンクに 対 して 複 数 ファイルを 出 力 します。このオプ
ションは、 出 力 形 式 として -vhx または -bin が 指 定 されている
場 合 にのみ 使 用 できます。
memory_config の 形 式 は -widthxbanks で 指 定 されます。 上 記
において:
width. ターゲットメモリシステムのメモリ 幅 (8 ビット、16
ビット、32 ビット、あるいは 64 ビット)を 指 定 します。
banks. ターゲットメモリシステム 内 のメモリバンクの 数 を 指
定 します。
以 下 は 有 効 なコンフィギュレーションです。
-8x1
-8x2
-8x4
-16x1
-16x2
-32x1
-32x2
-64x1
複 数 のコンフィギュレーションが 指 定 されているとき、fromELF
は 最 後 に 指 定 されているコンフィギュレーションを 使 用 します。
このオプションが -vhx または -bin 以 外 の 形 式 に 選 択 されてい
る 場 合 は 無 視 されます。
イメージが 1 つのロード 領 域 で 構 成 されている 場 合 、fromELF は
以 下 の 命 名 規 則 を 使 用 して bank ファイルを 生 成 します。
• 1 つのメモリバンクが 存 在 するとき(banks = 1)、 出 力 ファ
イルは -o output_file 引 数 によって 命 名 されます。
• 複 数 のメモリバンクが 存 在 する 場 合 (bank>1)、fromELF は
output_file0 で 始 まり、output_file bank-1 で 終 わ
る banks 個 のファイルを 生 成 します。 例 :
fromelf -vhx -8x2 test.axf -o test
は、test0 および test1 と 命 名 された 2 つのファイルを 生
成 します。
イメージが 複 数 のロード 領 域 で 構 成 されている 場 合 、fromELF は
output_file という 名 前 のディレクトリを 作 成 し、load
region0 から load region banks-1 の 間 で 命 名 された 各 ロー
ド 領 域 のバンクファイルを 生 成 します。
7-8 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

fromELFの 使 用
width で 指 定 したメモリ 幅 は、イメージから 読 み 出 され、ファイ
ルに 書 き 込 まれるチャンク 情 報 のサイズを 決 定 します。 最 初 に 読
み 出 されたチャンクは 最 初 のファイル(output_file0)に 割 り
当 てられ、 次 のチャンクは 次 のファイルに 割 り 当 てられます。
チャンクが 最 後 のファイルに 割 り 当 てられると、 割 り 当 てが 最 初
のファイルから 再 び 開 始 されます(つまり、この 割 り 当 てはファ
イル 数 に 基 づくモジュロです)。 例 えば、
memory_config が -8x4 の 場 合 :
byte0 -> file0
byte1 -> file1
byte2 -> file2
byte3 -> file3
byte4 -> file0
...
memory_config が -16x2 の 場 合 :
halfword0 -> file0
halfword1 -> file1
halfword3 -> file0
...
-output output_file
このオプションは 出 力 ファイルの 名 前 、あるいは 複 数 の 出 力 ファ
イルが 作 成 される 場 合 は 出 力 ディレクトリの 名 前 を 指 定 します
(text_output_format および code_output_format の 説 明
を 参 照 して 下 さい)。-text 出 力 オプションを 使 用 する 場 合 の 出
力 ファイルの 指 定 は 任 意 ですが、 他 の 全 ての 出 力 では 必 ず 指 定 す
る 必 要 があります。
input_file 変 換 する ELF ファイルを 指 定 します。
fromELF は、ARM 実 行 ELF ファイルと ARM オブジェクト ELF
ファイル(.o)しか 受 け 取 りません。input_file が 複 数 のロー
ド 領 域 を 含 む 分 散 ロードイメージであり、その 出 力 形 式 が -bin、
-ihf、-m32、-i32、-vhx のいずれかである 場 合 、fromELF は 各
ロード 領 域 に 別 々のファイルを 作 成 します。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 7-9

fromELF の 使 用
7.3 fromELF の 使 用 例
このセクションでは、fromELF を 使 用 したイメージ 形 式 の 変 更 方 法 、または ELF ファ
イルからの 情 報 の 抽 出 方 法 を 示 した 例 を 紹 介 します。
注
Unix で *、?、~ などのワイルドカード 文 字 を 使 用 する 場 合 は、シェルが 選 択 を 拡 大 し
ないように、これらのオプションを 引 用 符 で 囲 む 必 要 があります。
例 えば、*, ~*.* ではなく、’*, ~*.*’ と 入 力 します。
7.3.1 プレーンバイナリファイルの 生 成
ELF ファイルをプレーンバイナリ(.bin)ファイルに 変 換 するには、 以 下 のように 入
力 します。
fromelf -bin -o outfile.bin infile.axf
7.3.2 逆 アセンブリ
ELF ファイルの 逆 アセンブリバージョンを 含 む 標 準 出 力 へのリストを 生 成 するには、 以
下 のように 入 力 します。
fromelf -c infile.axf
ELF ファイルの 逆 アセンブリバージョンとシンボルテーブルを 含 むプレーンテキスト
出 力 ファイルを 生 成 するには、 以 下 のように 入 力 します。
fromelf -c -s -o outfile.lst infile.axf
7.3.3 フィールドオフセットをアセンブリ 言 語 EQU としてリストする
ファイル inputfile.o 内 に 存 在 する 全 ての 構 造 から、 全 てのフィールドオフセット
を 含 む 標 準 出 力 への 出 力 リストを 生 成 するには、 以 下 のように 入 力 します。
fromelf -fieldoffsets inputfile.o
p で 始 まる 名 前 のファイル inputfile.o 内 の 構 造 から、outputfile.a にリストす
る 全 てのフィールドオフセットを 含 む 出 力 ファイルを 生 成 するには、 以 下 のように 入
力 します。
fromelf -fieldoffsets -select p* -o outputfile.a inputfile.o
tools または moretools の 名 前 を 持 つファイル inputfile.o 内 の 構 造 から、
outputfile.a にリストする 全 てのフィールドオフセットを 含 む 出 力 ファイルを 生 成
するには、 以 下 のように 入 力 します。
fromelf -fieldoffsets -select tools.*, moretools.* -o outputfile.a inputfile.o
7-10 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

fromELFの 使 用
名 前 が 数 字 で 始 まり、ファイル inputfile.o 内 の 構 造 tools 内 の 構 造 フィールド
top に 含 まれる 構 造 フィールドの、outputfile.a にリストする 全 てのフィールドオ
フセットを 含 む 出 力 ファイルを 生 成 するには、 以 下 のように 入 力 します。
fromelf -fieldoffsets -select tools.top.number* -o outputfile.a inputfile.o
7.3.4 スタティックデータアドレスのリスト
全 てのグローバル 変 数 とスタティックデータ 変 数 、ならびに 全 ての 構 造 フィールドア
ドレスを 標 準 出 力 にリストするには、 以 下 のように 入 力 します。
fromelf -text -a -select * infile.axf
構 造 のみの 選 択
inputfile.axf 内 の 全 ての 構 造 アドレスを 含 み、グローバル 変 数 またはスタティック
データ 変 数 の 情 報 を 含 まないテキストファイルを 生 成 するには、 以 下 のように 入 力 し
ます。
fromelf -text -a -select *.* -o strucaddress.txt infile.axf
入 れ 子 構 造 のみの 選 択
入 れ 子 構 造 のアドレスのみを 含 むテキストファイルを 生 成 するには、 以 下 のように 入
力 します。
fromelf -text -a -select *.*.* -o strucaddress.txt infile.axf
変 数 のみの 選 択
inputfile.axf 内 のグローバル 変 数 またはスタティクデータ 変 数 の 情 報 を 含 み、 構 造
アドレスは 含 まないテキストファイルを 生 成 するには、 以 下 のように 入 力 します。
fromelf -text -a -select *, ~*.* -o strucaddress.txt infile.axf
7.3.5 デバッグから 非 デバッグへの 変 換
-debug オプションを 使 用 して 生 成 された ELF ファイルから、-nodebug オプションを
使 用 したときと 同 様 の 新 しい 出 力 ファイルを 生 成 するには、 以 下 のように 入 力 します。
fromelf -nodebug -elf -o outfile.axf infile.axf
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 7-11

fromELF の 使 用
7-12 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

第 8 章
ARM プロファイラの 使 用
本 章 では、ADS に 収 録 されている ARM プロファイラについて 説 明 します。 本 章 は 以
下 のセクションから 構 成 されています。
• ARM プロファイラ:P. 8-2
• プロファイラのコマンドラインオプション:P. 8-3
• サンプル 出 力 :P. 8-4
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 8-1

ARM プロファイラの 使 用
8.1 ARM プロファイラ
ARM プロファイラ armprof は、ARM デバッガによって 生 成 されたプロファイルデータ
ファイルから、プログラムの 実 行 プロファイルを 表 示 します。
注
ARM プロファイラは、 基 本 ATPCS 標 準 にコンパイルされた 単 純 なイメージに 対 して
のみ 有 用 です。 分 散 ローディングなどを 使 用 している 場 合 には、 有 益 な 情 報 は 得 られ
ません。
ARM プロファイラは、プロファイルデータ 内 に 存 在 する 情 報 量 に 基 づいて、2 つのタ
イプの 実 行 プロファイルのうち、どちらか 一 方 を 表 示 します。
• pcサンプリング 情 報 だけが 存 在 する 場 合 、プロファイラは 各 関 数 に 費 やされた 時
間 の 割 合 を 示 すフラットプロファイルだけを 表 示 することができます。 関 数 の 子
に 費 やされた 時 間 は 表 示 されません。
• 関 数 呼 び 出 しのカウント 情 報 が 存 在 する 場 合 、プロファイラは 各 関 数 に 費 やされ
た 時 間 、 各 関 数 の 全 ての 子 への 呼 び 出 しごとに 計 算 された 時 間 、ならびに 異 なる
親 からの 呼 び 出 しに 割 り 当 てられた 時 間 の 近 似 値 を 示 すコールグラフプロファ
イルを 表 示 することができます。
8-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

ARMプロファイラの 使 用
8.2 プロファイラのコマンドラインオプション
いくつかのオプションを 使 用 して、プロファイラ 出 力 内 の 形 式 と 情 報 量 を 制 御 するこ
とができます。 以 下 は、このコマンド 構 文 を 示 しています。
armprof [-parent|-noparent] [-child|-nochild] [-sort options] prf_file
オプションの 説 明 :
-parent
-noparent
-child
-nochild
プロファイルリスト 内 の 各 関 数 の 親 に 関 する 情 報 を 表 示 します。
このオプションを 使 用 すると、それぞれの 親 からの 呼 び 出 しを 処
理 する 各 関 数 に 費 やされた 時 間 の 近 似 情 報 を 得 ることができま
す。
親 のリスティングをオフにします。
各 関 数 の 子 に 関 する 情 報 を 表 示 します。プロファイラは、 親 の 代
わりに 処 理 を 実 行 するそれぞれの 子 に 費 やされた 近 似 時 間 を 表
示 します。
子 のリスティングをオフにします。
-sort options
以 下 のいずれか 1 つのオプションを 使 用 して、プロファイル 情 報
をソートします。
cumulative 各 関 数 と、その 全 ての 子 に 費 やされた 合 計 時
間 で 出 力 をソートします。
self
各 関 数 に 費 やされた 時 間 (その 子 に 費 やされ
た 時 間 は 除 く)で 出 力 をソートします。
descendants 各 関 数 の 全 ての 子 に 費 やされた 時 間 ( 関 数 本
体 に 費 やされた 時 間 は 除 く)で 出 力 をソート
します。
calls
リスト 内 の 各 関 数 への 呼 び 出 しの 数 で 出 力
をソートします。
prf_file
プロファイル 情 報 を 保 持 するファイルを 指 定 します。
デフォルトでは、 子 関 数 はリストされますが 親 関 数 はリストされず、 出 力 が 累 算 時 間
でソートされます。
8.2.1 例
armprof -parent sort.prf
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. 8-3

ARM プロファイラの 使 用
8.3 サンプル 出 力
プロファイラ 出 力 はいくつものセクションに 分 割 され、 各 セクションは 行 で 区 切 られ
ます。 各 セクションは 1 つの 関 数 に 関 する 情 報 を 保 持 します。 親 関 数 の 情 報 も 子 関 数
の 情 報 も 持 たないフラットプロファイルでは、 各 セクションが 1 行 で 構 成 されます。
以 下 は、insert_sort および strcmp を 呼 ぶ 関 数 のサンプルセクションを 示 してい
ます。
Name cum% self% desc% calls
-------------------------------------------------------
main 17.69% 60.06% 1
insert_sort 77.76% 17.69% 60.06% 1
strcmp 60.06% 0.00% 243432
-------------------------------------------------------
qs_string_compare 3.21% 0.00% 13021
shell_sort 3.46% 0.00% 14059
insert_sort 60.06% 0.00% 243432
strcmp 66.75% 66.75% 0.00% 270512
-------------------------------------------------------
8-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

用 語 集
ADS ARM デベロッパスイート 参 照 。
Angel
ANSI
API
Architecture
(アーキテクチャ)
ARM ベースのハードウェアで 実 行 するアプリケーションの 開 発 とデバッグに 使 用 可 能
なデバッグモニタプログラム。Angel は、ARM 状 態 または Thumb 状 態 で 動 作 するアプ
リケーションをデバッグすることができます。
米 国 規 格 協 会 (American National Standards Institute)。 他 の 中 でも 特 にコンピュータソフ
トウェアの 規 格 を 規 定 する 団 体 です。
アプリケーションプログラムインタフェース。
同 様 の 特 長 を 持 つプロセッサグループの 識 別 に 使 用 される 用 語 。
ARM Developer Suite(ARM デベロッパスイート)
支 援 文 書 およびサンプルを 含 み、ARM ファミリの RISC プロセッサ 用 アプリケーショ
ンを 記 述 してデバッグするためのアプリケーションスイート。
ARMulator
命 令 セットシミュレータ。 各 種 ARM プロセッサの 命 令 セットとアーキテクチャをシ
ミュレートするモジュールの 集 合 です。
ATPCS
ARM/Thumb プロシージャコール 標 準 。サブルーチンコールに 関 するレジスタとスタッ
クの 使 用 方 法 を 定 義 します。
Big-endian(ビッグ
エンディアン)
BNF
ワードの 最 下 位 バイトが 最 上 位 バイトよりも 上 位 アドレスに 位 置 するメモリ 構 成 。
バッカスノアフォーム。 論 理 構 造 を 定 義 する 数 学 表 記 です。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. Glossary-1

用 語 集
Byte(バイト)
8 ビットで 構 成 されるメモリ 域 の 単 位 。
Deprecated
廃 止 予 定 のオプションまたは 機 能 は、 使 用 しないことを 強 く 推 奨 します。 衰 退 オプショ
( 廃 止 予 定 )
ンおよび 機 能 は、 本 製 品 の 今 後 のバージョンではサポートしない 予 定 です。
Double word
64 ビット 単 位 の 情 報 。ダブルワードの 内 容 は、 指 定 されていない 限 り 符 号 なし 整 数 と
(ダブルワード)
みなされます。
DWARF Debug With Arbitrary Record Format( 任 意 レコード 形 式 でのデバッグ)の 略 。
ELF 実 行 リンク 形 式 。
Environment( ( 環 境 ) アプリケーションを 実 行 する 実 ハードウェアとオペレーティングシステムのこと。
Executable and linking format( ( 実 行 リンク 形 式 )
ARM デベロッパスイートで 使 用 している 業 界 標 準 バイナリファイル 形 式 。ELF オブ
ジェクト 形 式 は、armcc や armasm などの ARM オブジェクト 生 成 ツールによって 生 成
されます。ARM リンカは ELF オブジェクトファイルを 受 け 取 り、ELF 実 行 ファイルま
たは 部 分 リンク ELF オブジェクトを 出 力 することができます。
Execution view
( 実 行 ビュー)
Flash memory
(フラッシュメモリ)
イメージがメモリにロードされて 実 行 を 開 始 した 後 の、 領 域 およびセクションのアド
レス。
アプリケーションコードの 保 持 に 頻 繁 に 使 用 される 不 揮 発 性 メモリ。
Heap(ヒープ)
新 しい 変 数 の 作 成 に 使 用 可 能 なコンピュータメモリの 一 部 分 。
Host(ホスト)
IDE
Image(イメージ)
Input section
( 入 力 セクション)
別 のコンピュータにデータや 他 のサービスを 提 供 するコンピュータ。
統 合 開 発 環 境 ( 例 :CodeWarrior IDE)。
実 行 を 目 的 にプロセッサにロードされた 実 行 可 能 ファイル。
コードまたは 初 期 化 データを 保 持 する、あるいはアプリケーションの 起 動 前 にゼロに
設 定 する 必 要 があるメモリフラグメントを 記 述 するセクション。
出 力 セクション 参 照 。
Interrupt( ( 割 り 込 み) 外 部 シグナルなどが 原 因 で、アプリケーションの 通 常 処 理 シーケンスに 変 更 が 生 じる
こと。
Interworking(インターワーキング)
ARM コードと Thumb コードの 両 方 を 使 用 するアプリケーションの 生 成 。
Library
(ライブラリ)
Linker(リンカ)
Little-endian(リトル
エンディアン)
アセンブラまたはコンパイラの 出 力 オブジェクトの 集 合 をグループ 化 した 1 つの 構 成
物 。
1 つ 以 上 のソースアセンブラ / コンパイラ 出 力 オブジェクトから 1 つのイメージを 生 成
するソフトウェア。
ワードの 最 下 位 バイトが 最 上 位 バイトよりも 下 位 アドレスに 位 置 するメモリ 構 成 。
Glossary-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

用 語 集
Load view
(ロードビュー)
Output section
( 出 力 セクション)
イメージがメモリにロードされ、 実 行 がまだ 開 始 されていないときの 領 域 およびセク
ションのアドレス。
RO、RW、ZI のうちで 同 じ 属 性 を 持 った、 連 続 する 一 連 の 入 力 セクションから 構 成 さ
れるセクション。 出 力 セクションは、 領 域 と 呼 ばれるさらに 大 きなフラグメントにグ
ループ 化 されます。これらの 領 域 がグループ 化 されて 最 終 的 な 実 行 イメージが 生 成 さ
れます。
領 域 参 照 。
PIC
位 置 独 立 コード。
ROPI 参 照 。
PID
位 置 独 立 データまたは ARM プラットフォーム 独 立 開 発 カード。
RWPI 参 照 。
Profiling
(プロファイリング)
パフォーマンスの 測 定 や 重 要 コードエリアの 特 定 を 目 的 に、デバッグ 対 象 プログラム
の 実 行 中 の 統 計 データを 蓄 積 したもの。
コールグラフプロファイリングでは 詳 細 な 情 報 を 得 られますが、 実 行 速 度 が 著 しく 低
下 します。フラットプロファイリングでは 簡 単 な 統 計 データを 得 ることができ、 実 行
速 度 への 影 響 もそれほどありません。
Program image(プログラムイメージ)
どちらのタイプのプロファイリングでも、 統 計 データ 収 集 動 作 間 の 時 間 間 隔 を 指 定 す
ることができます。
イメージ 参 照 。
Redirection( ( 転 送 ) デフォルト 出 力 を 異 なるデスティネーションに 送 信 する、あるいはデフォルト 入 力 を
異 なるソースから 受 信 するプロセス。 転 送 は、 転 送 しなければコンピュータ 画 面 に 表
示 されるテキストをファイルに 出 力 する 目 的 で 使 用 するのが 一 般 的 です。
Region( ( 領 域 ) イメージ 内 において、1 ~ 3 個 の 連 続 する 一 連 の 出 力 セクション(RO、RW、ZI)から
構 成 される 領 域 。 領 域 は 一 般 的 に、ROM、RAM、ペリフェラルなどの 物 理 メモリデバ
イスにマップされます。
ルート 領 域 参 照 。
Remapping
( 再 マッピング)
Retargeting
( 再 対 象 化 )
Root region
(ルート 領 域 )
ROPI
物 理 メモリまたはデバイスのアドレスを、アプリケーションの 実 行 開 始 後 に 変 更 する
こと。 通 常 、この 動 作 は 初 期 化 完 了 後 に ROM を RAM に 置 き 換 えるために 行 われます。
ある 実 行 環 境 に 合 わせて 設 計 されたコードを 別 の 実 行 環 境 に 移 す 作 業 工 程 。
イメージ 内 において、それ 自 身 のロードアドレスで 実 行 される 領 域 。 非 ルート 領 域 と
は、そのロードアドレスから 実 行 アドレスにコピーする 必 要 がある 領 域 を 言 います。
読 み 出 し 専 用 位 置 独 立 。コードおよび 読 み 出 し 専 用 データのアドレスはランタイムに
変 更 することが 可 能 です。
ARM DUI0151AJ-00 Copyright © 2001 ARM Limited. All rights reserved. Glossary-3

用 語 集
RTOS
RWPI
Scatter-loading
( 分 散 ローディング)
Sections
(セクション)
Semihosting
(セミホスティング)
Stack(スタック)
SWI
Target(ターゲット)
リアルタイムオペレーティングシステム。
読 み 出 し / 書 き 込 み 位 置 独 立 。 読 み 出 し / 書 き 込 みデータのアドレスはランタイムに 変
更 することが 可 能 です。
1 つの 大 きなブロックを 使 用 するのではなく、コードセクションとデータセクションの
アドレスを 個 々に 割 り 当 て、これらをグループ 化 すること。
イメージを 構 成 するソフトウェアコードまたはデータのブロック。
入 力 セクション 参 照 。
ターゲットがアプリケーションコード 内 で 発 生 した I/O 要 求 を、その I/O 自 体 をサポー
トしようとするのではなく、ホストシステムに 通 知 するメカニズム。
サブルーチンを 呼 び 出 すコードのリターンアドレスを 記 録 するために 使 用 されるメモ
リの 部 分 。スタックは、パラメータおよび 一 時 変 数 にも 使 用 することができます。
ソフトウェア 割 り 込 み。プロセッサにプログラマが 指 定 したサブルーチンを 呼 び 出 さ
せる 命 令 。ARM によってセミホスティングを 処 理 するために 使 用 されます。
ターゲットアプリケーションを 実 行 する 実 ターゲットプロセッサ( 実 際 の、またはシ
ミュレートされたプロセッサ)。
デバッギングセッションにおける 基 本 オブジェクト。デバッギングシステムの 基 礎 。
ターゲットソフトウェアを 実 行 する 環 境 。 実 質 的 には、 実 際 の、またはシミュレート
されたプロセッサの 集 合 を 意 味 します。
Veneer(ベニア)
プロセッサ 状 態 の 変 更 要 件 、あるいは 現 在 のプロセッサ 状 態 では 到 達 不 可 能 なアドレス
への 分 岐 要 件 があるときに、サブルーチンコールに 使 用 される 小 さなコードブロック。
Volatile( ( 揮 発 性 ) 内 容 を 実 行 中 のアプリケーションとは 無 関 係 に 変 更 し 得 るメモリアドレスは、 揮 発 性
と 記 述 されます。 一 般 的 にはメモリマップされるペリフェラルを 指 します。
メモリマップ 参 照 。
VFP
Word(ワード)
ZI
ベクタ 浮 動 小 数 点 。 複 数 のデータ 値 を 1 つの 命 令 で 処 理 できる 浮 動 小 数 点 コプロセッ
サの 標 準 。
32 ビット 単 位 の 情 報 。ワードの 内 容 は、 指 定 されていない 限 り 符 号 なし 整 数 とみなさ
れます。
ゼロ 初 期 化 。 初 期 値 を 持 たない 変 数 の 保 持 に 使 用 される R/W メモリです。 通 常 、この
メモリはリセット 時 にゼロに 設 定 されます。
Glossary-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI0151AJ-00

Index
The items in this index are listed in alphabetical order, with symbols and numerics appearing at the end. The references given
are to page numbers.
A
armar 6-6
ARMLIB variable 6-4
armprof 8-2
C
Call graph, profiling 8-2
Command syntax
fromelf 7-3
librarian 6-6
linker
profiler 8-3
D
Disassembly 7-6
E
ELF 2-3
ELF file format 2-8
Entry point
specifying to the linker 2-12, 2-13
Execution
profile 8-2
regions and veneers 3-13
F
File formats
ELF 2-8
fromELF output 7-7
symdefs 4-7
Files
scatter-loading 5-1
steering 4-9
symdefs 4-5
via 2-20
Function call count, profiling 8-2
H
Hiding and renaming symbols 2-18,
4-9
I
Images
complex 5-4
examples, scatter-loaded 5-4
regions, overview 3-3
sections 5-7
overview 3-3
simple 3-14
specifying a memory map 3-5
structure of 3-2
Image$$
symbols not defined 5-2
user_initial_stackheap() 5-2
Interworking
ARM and Thumb 1-2
ARM DUI 0151A Copyright © 2001 ARM Limited. All rights reserved. Index-1

Index
L
Librarian 6-6
Libraries
and linker, see Linker, libraries
Linker
code and data sizes 2-17
debug information
turning on and off 2-11
default addresses 2-9
diagnostics 2-19
entering commands via a file 2-20
execution information 3-4
help on 2-5, 2-17
image
construction 2-6
entry point 2-12
keeping sections 2-13
load and execution views 3-4
overview 3-2
structure 3-2
image-related information 2-7
Image$$ errors 5-2
information 2-16, 2-19, 2-20
libraries
defaults 2-16
including during link step 6-2
linker search path 2-16
scanning 2-16
load information 3-4
local symbols 2-16
memory attributes 2-20
memory map information 2-2, 2-11,
3-4
messages 2-16, 2-19, 2-20
output file 2-5, 2-8
output formats 2-5
output sections 3-3
overview of 2-2
partial linking 2-8
regions 3-3
RO section base address 2-9, 3-18
RW section base address 2-10
scatter-loading
command-line option 2-6, 2-11
software version 2-8
sorting input sections 3-8
standard output stream 2-19
steering files 2-18, 4-9
symbols 4-2, 5-2
hiding and renaming 2-18, 4-9
used in link step 2-18
syntax 2-8
undefined symbols 2-20
unused sections 2-12, 2-17
veneers 2-17
version number 2-5
via files 2-5, 2-20
$$ symbols 4-2
Linker options
-edit 2-18, 4-9
-elf 2-8
-entry 2-12
-errors 2-19
-first 2-14
-help 2-8
-info 2-17
-keep 2-13
-last 2-15
-libpath 2-16, 6-4
-list 2-19
-locals 2-16
-mangled 2-19, 2-20
-nodebug 2-11
-nolocals 2-16
-noremove 2-12
-noscanlib 2-16
-output 2-8
-partial 2-8
-remove 2-12
-ro-base 2-9
-ropi 2-9
-rw-base 2-10
-rwpi 2-10
-scanlib 2-16
-scatter 2-11, 5-4
-split 2-10
-strict 2-20
-symbols 2-18
-symdefs 2-18
-unmangled 2-19
-unresolved 2-20
-verbose 2-19
-via 2-20
-vsn 2-8
-xreffrom 2-19
M
Memory map
describing to linker 5-7
overlaid 5-14
specifying 2-11
uninitialized 5-14
P
Position independence 2-9
Profiler 8-2
S
Scatter-loading
description file 5-2
area syntax 5-15
execution region syntax 5-13
FIRST 5-17
LAST 5-17
load region syntax 5-11
pseudo-attributes 5-17
sections 5-7
synonyms in 5-17
error Image$$ZI$$Limit 5-2
linker command-line option 5-4
region matching 5-18
section placement 2-15
section-related symbols 4-4
symbols defined by linker 5-2
+FIRST 2-15
+LAST 2-15
Sections
aligning 3-11
attributes 2-2
in region 2-2
input 3-3
multiple matches in scatterloading
5-18
placement of 2-14, 2-15, 3-8, 5-7,
5-17
by attribute 3-9
FIRST and LAST 3-10
in region 3-3
sorting rules 3-8
unused 2-12, 2-17
Index-2 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI 0151A

Index
Steering files 2-18, 4-9
Symbols
hiding and renaming 4-9
Image$$ undefined 5-2
in another image 4-5
input section-related 4-4
linker 2-18, 4-2, 4-9
region-related 4-2
scatter-loading 5-2
section-related 4-4
stack 4-3
undefined 2-20
ZI 4-2
$$ 4-2
Symdefs file 4-5
Symbols
$$ symbols 4-2
T
Thumb
code 1-2
verneer 3-13
U
Uninitialized memory 5-14
V
Variables
ARMLIB 6-4
Veneers
ARM to ARM 3-13
ARM to Thumb 3-13
size 2-17
Thumb to ARM 3-13
Verneers
placing 5-22
Via files 2-20
Z
ZI symbols 4-2
ARM DUI 0151A Copyright © 2001 ARM Limited. All rights reserved. Index-3

Index
Index-4 Copyright © 2001 ARM Limited. All rights reserved. ARM DUI 0151A