11.3 MB - Spansion

本ドキュメントは Cypress (サイプレス) 製品に関する情報が記載されております。本ドキュメント
には、仕様の開発元企業として「スパンション」または「Spansion」の名が記載されておりますが、
これらの製品は Cypress が新規および既存のお客様に引き続き提供してまいります。
商品仕様の継続性について
Cypress 製品として提供することに伴う商品仕様としての変更はなく、ドキュメントとしての変更も
ありません。また本ページのお知らせは、変更情報として追記いたしません。本ドキュメントに変更
情報が記載されている場合、それは本お知らせを除いた前版からの変更点です。なお、今後改訂は必
要に応じて行われますが、その際の変更内容は改訂後のドキュメントに記載いたします。
オーダ型格および品名について
Spansion は既存のオーダ型格および品名を引き続きサポートいたします。これらの製品をご注文の
際は、このドキュメントに記載されているオーダ型格および品名をご使用ください。
詳しいお問い合わせ先
Cypress 製品およびそのソリューションの詳細につきましては、お近くの営業所へお問い合わせくだ
さい。
サイプレスについて
サイプレス (銘柄コード:CY) は、車載や産業機器、ネットワーキング プラットフォームから高機能
民生機器およびモバイル機器まで、今日の最先端組み込みシステム向けに高性能で高品質のソリュー
TM
TM
ションを提供します。NOR フラッシュ メモリや F-RAM 、SRAM、Traveo マイクロコントロー
®
ラー、業界唯一の PSoC プログラマブル システムオンチップ ソリューション、アナログおよび
PMIC Power Management IC、CapSense®静電容量タッチセンシング コントローラー、Wireless
®
BLE Bluetooth Low-Energy、USB コネクティビティ ソリューションなど、幅広い差別化製品ポート
フォリオを、一貫した革新性と業界最高クラスの技術サポート、比類のないシステム バリューとと
もにグローバルに提供します。
F2MC-16 ファミリ
SOFTUNE® リンケージキットマニュアル
V3 対応
Support Soft Manual
Publication Number CM41-00315
MB90880ÉVÉäÅ[ÉY Cover Sheet
Revision 6.0
Issue Date July 31, 2015
F2MC-16 ファミリ
SOFTUNE® リンケージキットマニュアル
V3 対応
Support Soft Manual
MB90880ÉVÉäÅ[ÉY Cover Sheet
Support
Soft
Ma nual
はじめに
■ 本書の目的と対象読者
本書は , Spansion SOFTUNE リンケージキットの機能および使用方法を説明したもので
す。
本書は , F2MC-16 ファミリマイクロプロセッサを使用した応用プログラムを開発する
技術者を対象にしています。本書をご一読ください。
リンケージキットはリンカ , ライブラリアン , コンバータの 3 種類のプログラムで構成
されています。
■ 商標
F2MC は Spansion LLC の商標です。
SOFTUNE は Spansion LLC の商標です。
Microsoft, Windows は , 米国 Microsoft Corporation の米国およびその他の国における登
録商標です。
その他の記載されている社名および製品名などの固有名詞は , 各社の商標または登録
商標です。
■ 本書の全体構成
本書は , 以下に示す 4 部構成となっています。
第 I 部 リンケージキット編
この部では , リンケージキットに含まれるツールの概要と , ツール全体に共通する
項目について説明します。
第 II 部 リンカ編
この部では , リンカの仕様 , オプションおよび出力リストなどについて説明します。
第 III 部 ライブラリアン編
この部では , ライブラリアンの仕様 , オプションおよび出力リストなどについて説
明します。
第 IV 部 オブジェクト形式コンバータ編
この部では , オブジェクト形式コンバータの種類 , オプション一覧 , 機能説明および
オブジェクト形式の変換について説明します。
付録
付録では,リンケージキットのエラーメッセージ, HEXフォーマットおよびSフォー
マットのレコード形式などを記載しています。
July 31, 2015, CM41-00315-6
i
Su pp or t
ii
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
目次
第I部
リンケージキット編 .................................................................................. 1
第1章
リンケージキットの仕様 .......................................................................... 3
1.1 リンケージキットの概要 ...................................................................................................... 4
1.2 起動方法 ............................................................................................................................... 5
1.3 強制終了 ............................................................................................................................... 6
1.4 終了コード ............................................................................................................................ 7
1.5 起動メッセージ .................................................................................................................... 8
1.6 終了メッセージ .................................................................................................................... 9
1.7 ヘルプメッセージ ............................................................................................................... 10
1.8 識別子 ................................................................................................................................. 11
1.9 ファイル名規則 .................................................................................................................. 12
1.10 環境変数 ............................................................................................................................. 13
1.10.1
TMP( ワークディレクトリ ) ..................................................................................... 14
1.10.2
FELANG ................................................................................................................... 15
1.10.3
FETOOL ................................................................................................................... 16
1.10.4
LIB907 ...................................................................................................................... 17
1.10.5
OPT907 .................................................................................................................... 18
1.10.6
OPT .......................................................................................................................... 19
第2章
2.1
2.2
2.3
2.4
2.5
第3章
オプション ............................................................................................. 21
オプション ..........................................................................................................................
オプションパラメータでの数値表現 ..................................................................................
オプション指定時の注意と評価 .........................................................................................
包含 / 相反関係にあるオプションの指定 ............................................................................
コマンドラインの指定例 ....................................................................................................
共通オプション ...................................................................................... 27
3.1 共通オプション一覧 ...........................................................................................................
3.2 共通オプション詳細 ...........................................................................................................
3.2.1
デフォルトオプションファイル抑止指定 (-Xdof) .....................................................
3.2.2
オプションファイルからの読込み指定 (-f) ...............................................................
3.2.3
ヘルプメッセージの表示 (-help) ...............................................................................
3.2.4
版数 / メッセージ出力指定 (-V) ................................................................................
3.2.5
版数 / メッセージ出力抑止 (-XV) ..............................................................................
3.2.6
終了メッセージ表示指定 (-cmsg) .............................................................................
3.2.7
終了メッセージ表示抑止指定 (-Xcmsg) ...................................................................
3.2.8
ワーニング発生時の終了コードを 1 にする指定 (-cwno) .........................................
3.2.9
ワーニング発生時の終了コードを 0 にする指定 (-Xcwno) ......................................
第4章
4.1
4.2
4.3
22
23
24
25
26
28
29
30
31
33
34
35
36
37
38
39
オプションファイル ............................................................................... 41
オプションファイルの概要 ................................................................................................. 42
オプションファイル中での継続指定 .................................................................................. 43
オプションファイル中のコメント指定 ............................................................................... 44
July 31, 2015, CM41-00315-6
iii
Su pp or t
4.4
4.5
So ft
Manu al
オプションファイルの記述例 ............................................................................................. 45
デフォルトオプションファイル ......................................................................................... 46
第 II 部
リンカ編 .................................................................................................. 49
第5章
リンカの仕様 .......................................................................................... 51
5.1 リンカの概要 ......................................................................................................................
5.2 リンカの機能 ......................................................................................................................
5.2.1
入出力ファイル / メッセージに関する制御 ..............................................................
5.2.2
セクションの結合 / 配置に関する制御 .....................................................................
5.2.3
ライブラリの検索に関する制御 ...............................................................................
5.2.4
エントリアドレス / シンボル値の設定 .....................................................................
5.3 セクションの種類 ...............................................................................................................
5.4 セクションの結合 ...............................................................................................................
5.5 セクションの配置 ...............................................................................................................
5.5.1
セクションの結合順序が指定されなかった場合の配置例 ........................................
5.5.2
セクションの結合順序が指定された場合の配置例 ..................................................
5.5.3
セクショングループの指定がある場合の配置例 ......................................................
5.6 セクションの自動配置 ........................................................................................................
5.6.1
-AL 1 が指定された場合のセクションの自動配置 ....................................................
5.6.2
-AL 2 が指定された場合のセクションの自動配置 ....................................................
5.7 ライブラリの検索 ...............................................................................................................
5.7.1
ライブラリファイルが 1 つの場合の検索例 1 ..........................................................
5.7.2
ライブラリファイルが 1 つの場合の検索例 2 ..........................................................
5.7.3
ライブラリファイルが 1 つの場合の検索例 3 ..........................................................
5.7.4
ライブラリファイルが複数の場合の検索例 1 ..........................................................
5.7.5
ライブラリファイルが複数の場合の検索例 2 ..........................................................
5.7.6
ライブラリファイルが個別に指定された場合の処理 ...............................................
5.8 ROM/RAM 領域 ..................................................................................................................
5.9 ROM → RAM 転送セクション ............................................................................................
5.10 DIR 属性セクションの配置について ..................................................................................
5.11 CPU 情報ファイル ..............................................................................................................
5.12 リンカでのオブジェクト混在 .............................................................................................
5.13 リンカでの関数呼び出しインタフェースの異なるオブジェクトの混在について ..............
5.14 未使用関数削除 ..................................................................................................................
第6章
52
53
55
56
57
58
59
61
62
63
64
65
66
67
69
72
73
74
75
76
77
78
79
80
83
86
87
88
89
リンカのオプション ............................................................................... 91
6.1 リンカのオプション一覧 .................................................................................................... 92
6.2 リンカのオプション詳細 .................................................................................................... 95
6.2.1
出力ロードモジュールファイル名指定 (-o) .............................................................. 96
6.2.2
デバッグ情報の出力指定 (-g) ................................................................................... 97
6.2.3
デバッグ情報の削除指定 (-Xg) ................................................................................. 98
6.2.4
絶対形式ロードモジュールの出力指定 (-a) .............................................................. 99
6.2.5
相対形式ロードモジュールの出力指定 (-r) ............................................................. 100
6.2.6
ROM 領域のフィル指定 (-fill) .................................................................................. 101
6.2.7
マップリストファイル名の指定 (-m) ...................................................................... 103
6.2.8
マップリスト出力の抑止指定 (-Xm) ....................................................................... 104
6.2.9
リスト表示の名前の省略解除 (-dt) ......................................................................... 105
6.2.10
メモリ使用情報リストの出力指定 (-mmi) .............................................................. 106
iv
CM41-00315-6, July 31, 2015
Support
6.2.11
6.2.12
6.2.13
6.2.14
6.2.15
6.2.16
6.2.17
6.2.18
6.2.19
6.2.20
6.2.21
6.2.22
6.2.23
6.2.24
6.2.25
6.2.26
6.2.27
6.2.28
6.2.29
6.2.30
6.2.31
6.2.32
6.2.33
6.2.34
6.2.35
6.2.36
6.2.37
6.2.38
6.2.39
6.2.40
6.2.41
6.2.42
6.2.43
6.2.44
6.2.45
6.2.46
6.2.47
6.2.48
6.2.49
6.2.50
6.2.51
6.2.52
6.2.53
6.2.54
6.2.55
6.2.56
6.2.57
6.2.58
6.2.59
Soft
Ma nual
リスト行の桁数指定 (-pw) ......................................................................................
リスト 1 ページの行数指定 (-pl) .............................................................................
ROM 領域のチェックサム指定 (-cs) .......................................................................
警告メッセージ出力レベルの指定 (-w) ..................................................................
ROM 領域の指定 (-ro) .............................................................................................
RAM 領域の指定 (-ra) .............................................................................................
セクション配置順 / アドレスの指定 (-sc) ...............................................................
セクショングループの指定 (-gr) .............................................................................
レジスタバンク領域の指定 (-rg) .............................................................................
自動配置指定 (-AL) .................................................................................................
検索ライブラリファイルの指定 (-l) ........................................................................
ライブラリ検索パスの指定 (-L) ..............................................................................
シンボル個別のライブラリの指定 (-el) ..................................................................
ライブラリ検索の抑止指定 (-nl) .............................................................................
デフォルトライブラリ検索の抑止指定 (-nd) ..........................................................
未使用関数削除指定 (-lnkopt) .................................................................................
C ソースのプログラム実行開始シンボル指定 (-entryc) .........................................
削除対象外関数指定 (-Xdel) ...................................................................................
未使用関数削除情報ファイル格納パス指定 (-ufiin) ................................................
エントリアドレスの指定 (-e) .................................................................................
外部シンボル値の仮設定 (-df) ................................................................................
ターゲット CPU 指定 (-cpu) ...................................................................................
CPU 情報ファイル指定 (-cif) ..................................................................................
デバッグ情報存在チェック抑止指定 (-NCI0302LIB) ..............................................
内蔵 ROM/RAM 領域の自動設定 (-set_rora) ..........................................................
内蔵 ROM/RAM 領域自動設定の抑止指定 (-Xset_rora) .........................................
ユーザ指定領域のチェック指定 (-check_rora) .......................................................
ユーザ指定領域のチェック抑止指定 (-Xcheck_rora) .............................................
セクション配置領域チェック指定 (-check_locate) ................................................
セクション配置領域チェック抑止指定 (-Xcheck_locate) ......................................
ユーザ指定外セクションのチェック指定 (-check_section) ...................................
ユーザ指定外セクションのチェック抑止指定 (-Xcheck_section) ..........................
スタンバイモード遷移命令チェック指定 (-check_SCF) ........................................
スタンバイモード遷移命令チェック抑止指定 (-Xcheck_SCF) ..............................
フェッチ単位チェックの指定 (-Wf) ........................................................................
引数のレジスタ渡しのロードモジュール出力指定オプション (-rp) .......................
引数のスタック渡しのロードモジュール出力指定オプション (-Xrp) ....................
DIR 属性セクション合計サイズチェック指定 (-check_dirsize) .............................
DIR 属性セクション合計サイズチェック抑止指定 (-Xcheck_dirsize) ....................
サイズ 0 のセクション配置チェック指定 (-check_size0_sec) ...............................
サイズ 0 のセクション配置チェック抑止指定 (-Xcheck_size0_sec) .....................
相対アセンブルリスト入力ディレクトリ指定 (-alin) .............................................
絶対アセンブルリスト出力ディレクトリ指定 (-alout) ...........................................
絶対アセンブルリスト出力指定 (-als) ....................................................................
絶対アセンブルリスト出力モジュール指定 (-alsf) .................................................
絶対アセンブルリスト出力抑止指定 (-Xals) ..........................................................
ROM/RAM, ARRAY リスト出力指定 (-alr) .............................................................
ROM/RAM, ARRAY リスト出力モジュール指定 (-alrf) ..........................................
ROM/RAM, ARRAY リスト出力抑止指定 (-Xalr) ....................................................
July 31, 2015, CM41-00315-6
107
108
109
116
117
118
119
122
123
125
127
128
129
130
131
132
134
135
136
137
138
139
140
141
142
143
144
146
147
150
151
153
154
156
158
160
161
162
163
164
166
167
168
169
170
171
172
173
174
v
Su pp or t
6.2.60
6.2.61
6.2.62
6.2.63
6.2.64
6.2.65
6.2.66
6.2.67
6.2.68
6.2.69
第7章
So ft
Manu al
ROM/RAM, ARRAY リストのシンボルとアドレスの表示位置指定
(-na, -an) ...................................................................................................................... 175
外部シンボル相互参照情報リスト出力指定 (-xl) ....................................................
外部シンボル相互参照情報リストファイル名の指定 (-xlf) .....................................
外部シンボル相互参照情報リスト出力抑止指定 (-Xxl) ..........................................
ローカルシンボル情報リスト出力指定 (-sl) ...........................................................
ローカルシンボル情報リストファイル名の指定 (-slf) ............................................
ローカルシンボル情報リスト出力抑止指定 (-Xsl) ..................................................
セクション詳細マップリスト出力指定 (-ml) ..........................................................
セクション詳細マップリストファイル名の指定 (-mlf) ...........................................
セクション詳細マップリスト出力抑止指定 (-Xml) ................................................
リンカの出力リストファイル .............................................................. 187
7.1 リンカの出力するリストファイルの種類 .........................................................................
7.2 リンクリストファイル ......................................................................................................
7.2.1
コントロールリスト ...............................................................................................
7.2.2
マップリスト ..........................................................................................................
7.2.3
メモリ使用情報リスト ...........................................................................................
7.2.4
シンボルリスト ......................................................................................................
7.3 絶対アセンブルリストファイル .......................................................................................
7.3.1
ヘッダ , インフォメーションリスト .......................................................................
7.3.2
ROM/RAM, ARRAY リスト ....................................................................................
7.3.3
アセンブルソースリスト ........................................................................................
7.3.4
セクション情報リスト ...........................................................................................
7.3.5
クロスリファレンスリスト ....................................................................................
7.4 外部シンボル相互参照情報リストファイル .....................................................................
7.5 ローカルシンボル情報リストファイル .............................................................................
7.6 セクション配置詳細情報リストファイル .........................................................................
第8章
8.1
8.2
第 III 部
第9章
9.1
9.2
9.3
9.4
9.5
9.6
9.7
9.8
vi
177
178
179
180
181
182
183
184
185
188
189
190
192
194
196
198
200
201
203
205
207
209
210
212
リンカの制限事項および Q &A ............................................................ 215
リンカの制限事項 ............................................................................................................. 216
リンカの使用上の Q &A ................................................................................................... 217
ライブラリアン編 ................................................................................. 221
ライブラリアンの仕様 ......................................................................... 223
ライブラリアンの機能 ......................................................................................................
ライブラリアンの機能分類 ...............................................................................................
ライブラリファイルの作成編集 .......................................................................................
ライブラリファイル内のモジュール抽出 .........................................................................
ライブラリのデバッグ情報の削除 ....................................................................................
ライブラリファイルの内容チェックと表示 .....................................................................
ライブラリアンでのオブジェクト混在 .............................................................................
ライブラリアンでの関数呼び出しインタフェースの
異なるオブジェクトの混在について ................................................................................
224
226
227
229
230
231
232
233
CM41-00315-6, July 31, 2015
Support
第 10 章
Soft
Ma nual
ライブラリアンのオプション .............................................................. 235
10.1 ライブラリアンのオプション一覧 ....................................................................................
10.2 ライブラリアンのオプション詳細 ....................................................................................
10.2.1
モジュールの追加 ( 登録 )(-a) .................................................................................
10.2.2
モジュールの置換 ( 登録 )(-r) ..................................................................................
10.2.3
モジュールの削除 (-d) ............................................................................................
10.2.4
モジュールの抽出 (-x) ............................................................................................
10.2.5
リストファイルの出力指定 (-m) .............................................................................
10.2.6
リストファイルの出力抑止指定 (-Xm) ...................................................................
10.2.7
リストファイルの詳細情報の出力指定 (-dt) ...........................................................
10.2.8
リスト 1 ページの行数指定 (-pl) .............................................................................
10.2.9
リスト 1 行の桁数指定 (-pw) ..................................................................................
10.2.10
バックアップファイルの作成 (-b) ..........................................................................
10.2.11
バックアップファイルの作成抑止 (-Xb) .................................................................
10.2.12
ライブラリファイルの内容検査 (-c) .......................................................................
10.2.13
ファイル内容の最適化 (-O) ....................................................................................
10.2.14
デバッグ情報の出力指定 (-g) .................................................................................
10.2.15
デバッグ情報の出力抑止指定 (-Xg) ........................................................................
10.2.16
ターゲット CPU 指定 (-cpu) ...................................................................................
10.2.17
CPU 情報ファイル指定 (-cif) ..................................................................................
10.2.18
引数のレジスタ渡しのライブラリ出力指定オプション (-rp) .................................
10.2.19
引数のスタック渡しのライブラリ出力指定オプション (-Xrp) ...............................
第 11 章
11.1
11.2
11.3
11.4
ライブラリアンのリストフォーマット ................................................ 259
リストファイルの情報内容 ...............................................................................................
モジュール名リスト .........................................................................................................
モジュールごとの詳細情報 ...............................................................................................
ライブラリ内の外部定義 / 参照シンボル情報 ...................................................................
第 12 章
236
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
258
260
261
262
263
ライブラリアンの制限事項および Q &A ............................................. 265
12.1 ライブラリアンの制限事項 ............................................................................................... 266
12.2 ライブラリアンの使用上の Q &A ..................................................................................... 267
第 IV 部
オブジェクト形式コンバータ編 ............................................................ 269
第 13 章
オブジェクト形式コンバータの仕様 .................................................... 271
13.1 オブジェクト形式コンバータの概要 ................................................................................ 272
13.2 オブジェクト形式コンバータの種類 ................................................................................ 274
13.3 オブジェクト形式コンバータの実行 ................................................................................ 276
第 14 章
オブジェクト形式コンバータの共通オプション .................................. 277
14.1 オブジェクト形式コンバータのオプション一覧 .............................................................. 278
14.2 出力ファイル名の変更 (-o) ............................................................................................... 279
14.3 パディング (-p) ................................................................................................................. 281
July 31, 2015, CM41-00315-6
vii
Su pp or t
第 15 章
So ft
Manu al
ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es) ........................ 283
15.1 ロードモジュールコンバータの概要 ................................................................................
15.2 ロードモジュールコンバータのオプション一覧 ..............................................................
15.3 ロードモジュールコンバータのオプション詳細 ..............................................................
15.3.1
出力 S フォーマット指定 (-S1/-S2/-S3) .................................................................
15.3.2
出力 HEX フォーマット指定 (-I16/-I20/-I32) ..........................................................
15.3.3
スタートアドレスレコード出力指定 (-entry) .........................................................
15.3.4
スタートアドレスレコード出力抑止指定 (-Xentry) ................................................
15.3.5
整形指定 (-adjust) ...................................................................................................
15.4 f2ms( 絶対形式ロードモジュール→ S フォーマット変換 ) ..............................................
15.5 f2hs( 絶対形式ロードモジュール→ HEX フォーマット変換 ) ..........................................
15.6 f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変換 ),
f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変換 ) ......................................
第 16 章
18.1
18.2
18.3
18.4
310
312
313
314
315
316
317
319
その他のコンバータ ............................................................................. 321
m2is(S フォーマット→ HEX8 フォーマット変換 ) ..........................................................
m2es(S フォーマット→ HEX16 フォーマット変換 ) .......................................................
i2ms(HEX8 フォーマット→ S フォーマット変換 ) ..........................................................
e2ms(HEX16 フォーマット→ S フォーマット変換 ) .......................................................
第 19 章
298
301
302
303
304
305
307
308
バイナリコンバータ (m2bs, h2bs) ...................................................... 309
17.1 バイナリコンバータの概要 ...............................................................................................
17.2 バイナリコンバータのオプション一覧 .............................................................................
17.3 バイナリコンバータのオプション詳細 .............................................................................
17.3.1
出力範囲指定 (-ran) ................................................................................................
17.3.2
スプリットモード指定 (-sp) ...................................................................................
17.3.3
スプリットモード抑止指定 (-Xsp) ..........................................................................
17.3.4
マップリストファイルの作成指定 (-m) ..................................................................
17.3.5
マップリストファイルの作成抑止指定 (-Xm) ........................................................
第 18 章
295
フォーマットアジャスタ (m2ms, h2hs) .............................................. 297
16.1 フォーマットアジャスタの概要 .......................................................................................
16.2 フォーマットアジャスタのオプション一覧 .....................................................................
16.3 フォーマットアジャスタのオプション詳細 .....................................................................
16.3.1
出力レコード内データ長指定 (-len) .......................................................................
16.3.2
出力範囲指定 (-ran) ................................................................................................
16.3.3
出力 S フォーマット指定 (-S1/-S2/-S3) .................................................................
16.3.4
出力 HEX フォーマット指定 (-I16/-I20/-I32) ..........................................................
16.3.5
開始アドレス変更指定 (-ST) ..................................................................................
第 17 章
284
285
286
287
288
289
291
292
293
294
322
323
324
325
オブジェクト形式コンバータの制限事項および Q &A ........................ 327
19.1 オブジェクト形式コンバータの制限事項 ......................................................................... 328
19.2 オブジェクト形式コンバータの使用上の Q &A ............................................................... 329
viii
CM41-00315-6, July 31, 2015
Support
付録
付録 A
付録 B
B.1
B.2
B.3
B.4
B.5
B.6
B.7
付録 C
C.1
C.2
C.3
C.4
C.5
C.6
C.7
C.8
付録 D
付録 E
付録 F
付録 G
付録 H
H.1
H.2
H.3
H.4
H.5
H.6
H.7
H.8
付録 I
付録 J
付録 K
付録 L
付録 M
付録 N
索引
Soft
Ma nual
.............................................................................................................. 331
リンケージキットのエラーメッセージ .......................................................................
HEX フォーマット .......................................................................................................
一般形式 ......................................................................................................................
データレコード (HEX8/HEX16/HEX32) タイプ : 00 ...................................................
エンドレコード (HEX8/HEX16/HEX32) タイプ : 01 ...................................................
拡張セグメントアドレスレコード (HEX16/HEX32) タイプ : 02 .................................
スタートセグメントアドレスレコード (HEX16/HEX32) タイプ : 03 ..........................
拡張リニアアドレスレコード (HEX32) タイプ : 04 .....................................................
スタートリニアアドレスレコード (HEX32) タイプ : 05 .............................................
S フォーマット ............................................................................................................
S0 タイプ ( ヘッダレコード ) ......................................................................................
S1 タイプ ( データレコード : 2 バイトアドレス ) .......................................................
S2 タイプ ( データレコード : 3 バイトアドレス ) .......................................................
S3 タイプ ( データレコード : 4 バイトアドレス ) .......................................................
S5 タイプ ( レコード数管理レコード ) ........................................................................
S7 タイプ ( ターミネータレコード ) ...........................................................................
S8 タイプ ( ターミネータレコード ) ...........................................................................
S9 タイプ ( ターミネータレコード ) ...........................................................................
リンカのオプション一覧表 .........................................................................................
ライブラリアンのオプション一覧表 ...........................................................................
オブジェクト形式コンバータのコマンドおよびオプション一覧表 ............................
OS による仕様の相違点 ..............................................................................................
F2MC-16LX スタンバイモード遷移命令チェックツール ............................................
F2MC-16LX スタンバイモード遷移命令チェックツールの概要 .................................
スタンバイモード遷移命令チェックツールの操作方法 ..............................................
チェック手順 ...............................................................................................................
警告メッセージ ...........................................................................................................
チェック方法 ...............................................................................................................
検出可能なスタンバイモード遷移命令 .......................................................................
スタンバイモード遷移命令チェックツールの制限事項 ..............................................
スタンバイモード遷移のための低消費電力モード制御レジスタ (LPMCR) へ
アクセスする際の注意事項 .........................................................................................
SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a) の仕様の差異について ...........
SOFTUNE ライブラリアン (flib907s) と旧版ライブラリアン (lib907a) の
仕様の差異について ....................................................................................................
SOFTUNE ロードモジュールコンバータ (f2ms, f2hs) と
旧版ロードモジュールコンバータ (lmc907a) の仕様の差異について .........................
SOFTUNE 言語ツール移行時のオブジェクト同一性確認方法 ...................................
関数呼び出しインタフェース変更ガイド ....................................................................
主な変更内容 ...............................................................................................................
332
362
363
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
383
384
386
387
388
389
395
396
397
400
402
403
407
412
415
417
421
430
.............................................................................................................. 433
July 31, 2015, CM41-00315-6
ix
Su pp or t
x
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
第I部
Soft
Ma nual
リンケージキット編
リンケージキットに含まれるツールの概要と , ツール全体に共通する項目について説
明します。
第 1 章 リンケージキットの仕様
第 2 章 オプション
第 3 章 共通オプション
第 4 章 オプションファイル
July 31, 2015, CM41-00315-6
1
Su pp or t
2
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第1章
リンケージキットの仕様
この章では , リンケージキットに含まれるツールの
概要 , 起動方法 , 終了方法および識別子などについ
て説明します。
1.1 リンケージキットの概要
1.2 起動方法
1.3 強制終了
1.4 終了コード
1.5 起動メッセージ
1.6 終了メッセージ
1.7 ヘルプメッセージ
1.8 識別子
1.9 ファイル名規則
1.10 環境変数
July 31, 2015, CM41-00315-6
3
第 1 章 リンケージキットの仕様
1.1 リンケージキットの概要
Su pp or t
1.1
So ft
Manu al
リンケージキットの概要
リンケージキットは , オブジェクトモジュールの結合に使用するリンカと , オブジェ
クトモジュールをまとめて管理するライブラリアン , その他 , ROM 書込み用のオブ
ジェクト形式へのコンバータで構成されています。
■ リンケージキットのサポート範囲
図 1.1-1 に , リンケージキットのサポート範囲を示します。
図 1.1-1 リンケージキットのサポート範囲
テキストエディタ
Cソースプログラム
.c
アセンブラ
ソースプログラム
Cコンパイラ
.asm
アセンブラ
オブジェクトモジュール
ライブラリアン
.obj
リンクマップリスト
ライブラリファイル
リンカ
.mp1
絶対形式
アセンブルリスト
.lib
絶対形式
ロードモジュール
.als
コンバータ
.abs
リンカ出力リスト
ROM化オブジェクト形式
.mpx
.mhx
.mpm
.ehx
.mps
.ihx
.hex
デバッガ
4
ROMライタ
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.2 起動方法
Support
1.2
Soft
Ma nual
起動方法
リンケージキット ( リンカ , ライブラリアン , オブジェクト形式コンバータ ) を実行
するための , コマンドラインの形式および指定方法について説明します。
■ コマンドラインの形式
SOFTUNEリンケージキットのコマンドラインの指定方法(起動コマンドシンタックス)
は , 以下のとおりです。
• コマンドラインの指定方法 : コマンド名に続けて , ファイル名とオプションを必要
なだけ繰り返し指定する。
以下の説明では , オプションの指定をコマンド名の次にしてありますが , オプションの
記述位置は , ファイル名の前後どちらでもかまいません。オプションについて , 詳しく
は「第 2 章 オプション」を参照してください。
● リンカ
flnk907s [ オプション ] …
< ファイル名 > …
< ファイル名 > には , 入力するオブジェクトモジュールファイル名を指定します。
複数のファイル名を指定するときは , スペースを入れます。
また , *.obj のようにワイルドカードの使用もできます。ファイル名のワイルドカード
の展開はOSに依存するため,
「付録 G OSによる仕様の相違点」を参考にしてください。
リンカでは , -cpu オプションでターゲット CPU の指定が必要です。リンク処理実行の
際は , 必ず -cpu オプションを指定してください。
● ライブラリアン
flib907s [ オプション ] …
< ファイル名 >
< ファイル名 > には , 編集対象のライブラリファイルを指定します。
ライブラリアンでは , -cpu オプションでターゲット CPU の指定が必要です。ライブラ
リ処理実行の際は , 必ず -cpu オプションを指定してください。
● オブジェクト形式コンバータ
コマンド名
[ オプション ] …
< ファイル名 >
< ファイル名 > には , それぞれのツールの機能に応じたオブジェクト形式のファイル名
を指定します。以下の 3 形式のファイルが対象となります。
• リンカ出力の絶対形式ロードモジュール
• S フォーマット
• HEX フォーマット
July 31, 2015, CM41-00315-6
5
第 1 章 リンケージキットの仕様
1.3 強制終了
Su pp or t
1.3
So ft
Manu al
強制終了
プログラムの実行を途中で止めたい場合は , CTRL キーを押しながら , C キーを押す
( 以降 , "CTRL-C を押す " と記述します ) ことにより行えます。CTRL-C が押される
と , プログラムの実行が中断されます。
■ 強制終了
CTRL-C により , プログラム処理を中止した場合 , 出力結果のファイルは正しく作成さ
れません。リンケージキットが実行時に使用する作業ファイルは消去されます。
6
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.4 終了コード
Support
1.4
Soft
Ma nual
終了コード
リンケージキットの各ツールは , その処理の終了状態を終了コードとして OS に返し
ます。
■ 終了コードの値と終了状態
リンケージキットの各ツールは , その処理の終了状態 ( 正常に終了したかまたはエラー
が発生したかなどの状態 ) を終了コードとして OS に返します。終了コードと処理の終
了状態の関係を , 表 1.4-1 に示します。
表 1.4-1 終了コードと処理の終了状態
終了コード
July 31, 2015, CM41-00315-6
処理の終了状態
0
正常に終了または警告レベルのエラーがあったとき
1
-cwno オプション指定時で , 警告レベルのエラーがあったとき
2
正しい出力結果を作成できないようなエラーがあったとき
3
処理の続行が不可能となる致命的エラーがあったとき
7
第 1 章 リンケージキットの仕様
1.5 起動メッセージ
Su pp or t
1.5
So ft
Manu al
起動メッセージ
リンケージキットは , -V オプションで起動メッセージの表示を行います。デフォル
ト処理では , 起動メッセージの表示は行いません。
■ 起動メッセージと -V オプション
リンケージキットは , デフォルト処理では , 処理中に検出されたエラーに関するメッ
セージを表示しますが , 起動を示すメッセージは表示しません。起動時にメッセージ表
示を行いたい場合は , -V オプションを用います。
また , -V オプションを無効にしたい場合は , -V オプションの後に -XV オプションを指
定します。詳しくは「3.2.4 版数 / メッセージ出力指定 (-V)」,「3.2.5 版数 / メッセー
ジ出力抑止 (-XV)」を参照してください。
■ 起動メッセージ
起動メッセージは , プログラム名と版数 , 著作権表示で構成されます。
8
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.6 終了メッセージ
Support
1.6
Soft
Ma nual
終了メッセージ
リンケージキットは , -cmsg オプションで終了メッセージの表示を行います。デ
フォルト処理では , 終了メッセージの表示は行いません。
■ 終了メッセージと -cmsg オプション
リンケージキットは , デフォルト処理では , 処理中に検出されたエラーに関するメッ
セージを表示しますが , 終了を示すメッセージは表示しません。終了時にメッセージ表
示を行いたい場合は , -cmsg オプションを用います。
また , -cmsg オプションを無効にしたい場合は , -cmsg オプションより後に -Xcmsg オプ
ションを指定します。詳しくは「3.2.6 終了メッセージ表示指定 (-cmsg)」,「3.2.7 終了
メッセージ表示抑止指定 (-Xcmsg)」を参照してください。
■ 終了メッセージ
終了メッセージは , ツール名 , エラーの有無を表示します。
以下に , 終了メッセージ例を示します。
エラーがない場合
プログラム名 COMPLITED FOUND
NO ERROR
エラーがあった場合
プログラム名 COMPLITED FOUND
July 31, 2015, CM41-00315-6
ERROR
9
第 1 章 リンケージキットの仕様
1.7 ヘルプメッセージ
Su pp or t
So ft
Manu al
ヘルプメッセージ
1.7
ヘルプメッセージとして表示されるメッセージは , 以下の 2 種類です。
• コマンドラインの記述形式
• 起動時オプションの一覧
■ ヘルプメッセージ
起動時にコマンド名以外何も指定しなかった場合または -help オプションを指定したと
き , コマンドラインの記述形式と起動時オプションの一覧を表示して終了します。詳し
くは「3.2.3 ヘルプメッセージの表示 (-help)」を参照してください。
● ヘルプメッセージの例
以下に , リンカの場合 ( 英文 ) のヘルプメッセージの例を示します。
図 1.7-1 ヘルプメッセージの例
*1
usage : flnk907s [-option ...] object[ object ...]
-----------options:
------- target CPU option -------cpu cpu-name
: Specify target CPU
(need)
------- linker mode options -------a
: absolute linking mode
-r
: relocatable linking mode
(absolute)
*2
------- library options -------l filename[,...] : specify library file name
:
:
( 例の説明 )
*1: コマンドラインシンタックス ( 起動方法 ) の表示
*2: オプションの一覧および , 簡単な説明
なお , メッセージは , 環境変数 FELANG(「 1.10.2 FELANG」参照 ) 設定により , 日本
語で表示することも可能です。
10
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.8 識別子
Support
1.8
Soft
Ma nual
識別子
リンケージキットでプログラム作成時などに扱う識別子には , 以下の 7 種類があり
ます。
• ファイル名
• モジュール名
• オプション名
• セクション名
• グループ名
• ROM/RAM 領域名
• シンボル名
■ 識別子の構成文字種
識別子に使用可能な文字種は , 以下のとおりです。
• 英字
• 数字
• アンダスコア (_)
先頭文字に数字の使用は許されません。
また , ファイル名に使用可能な文字の種類は , 動作 OS に準拠します。したがって , ファ
イル名から作られるモジュール名も同等です。
■ 識別子の区別
英字の大文字小文字は区別されます。
■ 識別子文字数の制限
識別子の文字数は , 255 文字 (255 バイト ) 以内です。これを超える長さの文字列は , 255
バイトで打ち切ります。
■ リスト出力時の識別名表示
リンケージキットが作成する各種リストファイル中では , 常に 255 文字までの識別子の
名前全部を表示するようにはしていません。
長い識別子の名前は , 先頭の 20 文字程度のみを出力し , 残りの部分は表示していない
ものもあります。
1 行の中に表示される文字数は , リストのページ幅指定の変更で増減しますので , 見や
すいフォーマットを選択できます。
また , 複数行にわたりますが , 省略せずに表示するオプションも用意してあります。
July 31, 2015, CM41-00315-6
11
第 1 章 リンケージキットの仕様
1.9 ファイル名規則
Su pp or t
1.9
So ft
Manu al
ファイル名規則
入出力ファイルのファイル名は , OS での使用制限に準じています。
ファイル名は , オブジェクトモジュール中にも設定されるため , 文字数やコード系に
注意する必要がある場合があります。
■ ファイル名の文字数
入出力ファイルのファイル名は , OS での使用制限に準じています。
■ ファイル名の文字コード
C やアセンブラのソースファイル名は , 出力されるオブジェクトモジュール内に , ソ スファイル名情報として設定されるほか , モジュール名としても設定されます。
モジュール名には ,「 1.8 識別子」で示されるように英字 , 数字 , アンダスコア (_) しか
使用できません。したがって , 漢字や空白を用いたファイル名では , アセンブル時に ,
モジュール名を指定するなどの工夫が必要です。
● ファイル名として使用できる文字
(Windows 版 )
英字 , 数字 , 仮名文字 , シフト JIS 漢字コードおよび下記以外の記号が使用できます。
\ / : ; , * ? "
<
> |
空白を含むファイル名を指定する場合には , ファイル名を 2 重引用符 (") で括ってくだ
さい。
環境変数に空白を含むディレクトリ名を指定する場合には , 2 重引用符 (") で括らない
でください。
12
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10
Soft
Ma nual
環境変数
リンケージキットでは , 以下の 6 種類の環境変数をサポートしています。
• TMP
• FELANG
• FETOOL
• LIB907
• OPT907
• OPT
■ TMP( ワークディレクトリ )
TMP は , 作業用ディレクトリを指定します。詳しくは「 1.10.1 TMP( ワークディレク
トリ )」を参照してください。
■ FELANG
FELANG は , メッセージの言語の選択 , 指定を行います。詳しくは「 1.10.2 FELANG」
を参照してください。
■ FETOOL
FETOOL は , 開発ツールをインストールしたディレクトリを指定します。詳しくは
「 1.10.3 FETOOL」を参照してください。
■ LIB907 ( ライブラリファイル検索ディレクトリ )
LIB907は,ライブラリを格納したディレクトリを指定します。詳しくは,「1.10.4 LIB907」
を参照してください。
■ OPT907 ( デフォルトオプションファイル格納ディレクトリ )
OPT907 は , リンカおよびライブラリアンのデフォルトオプションファイルを格納した
ディレクトリを指定します。詳しくは ,「1.10.5 OPT907」を参照してください。
■ OPT( デフォルトオプションファイル格納ディレクトリ )
OPT は , オブジェクトツールのデフォルトオプションファイルを格納したディレクト
リを指定します。詳しくは ,「 1.10.6 OPT」を参照してください。
July 31, 2015, CM41-00315-6
13
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
1.10.1
So ft
Manu al
TMP( ワークディレクトリ )
TMP( ワークディレクトリ ) は , リンケージキットが実行時に使用する作業用のディ
レクトリを指定します。
TMP の記述形式 , 説明 , 指定例を示します。
■ TMP( ワークディレクトリ )
【記述形式】
SET TMP= < パス名 >
【説明】
リンケージキットが実行時に使用する作業用のディレクトリを指示します。
この環境変数 TMP は , ほかの開発ツール (C コンパイラやアセンブラなど ) でも使
用されます。
環境変数 TMP の設定がないときはカレントディレクトリを使用します。
【例】
SET
14
TMP=G:\ WORK
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10.2
Soft
Ma nual
FELANG
FELANG は , ヘルプメッセージおよびエラーメッセージ表示のメッセージ言語の選
択 , 指定を行います。
FELANG の記述形式 , 説明 , 指定例を示します。
■ FELANG
【記述形式】
SET FELANG={ASCII|EUC|SJIS}
ASCII: 英語
ASCII コード ( デフォルト )
EUC : 日本語
EUC コード
SJIS : 日本語
SJIS コード
【説明】
ヘルプメッセージおよびエラーメッセージ表示の日本語 / 英語 ( メッセージ言語 ) の
選択 , 指定を行います。
指定がない場合は , 英語のメッセージ (ASCII 指定 ) が選択されます。日本語環境の
ないシステムで , EUC または SJIS 以外のコード系をご使用の場合には , FELANG 環
境変数の設定を行わないか , ASCII を指定してください。
この環境変数 FELANG は , ほかの開発ツール (C コンパイラやアセンブラなど ) で
も使用されます。
【例】
SET
July 31, 2015, CM41-00315-6
FELANG=ASCII
15
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
1.10.3
So ft
Manu al
FETOOL
FETOOL は , リンケージキットをインストールした親ディレクトリを指定します。
FETOOL の記述形式 , 説明 , 指定例などを示します。
■ FETOOL
【記述形式】
SET FETOOL= < パス名 >
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
リンケージキットをインストールしたディレクトリを指定します。
リンケージキットは , ここで指定したディレクトリを起点として , メッセージファ
イルやライブラリファイルの格納ディレクトリを知り , 実行に必要なファイルをア
クセスします。
指定がない場合は , 実行されたロードモジュールのあるディレクトリの親ディレク
トリとなります。
この環境変数 FETOOL は , ほかの開発ツール (C コンパイラやアセンブラなど ) で
も使用されます。
【例】
SET
FETOOL=C:\ Softune
【推奨ディレクトリ構造】
図 1.10-1 推奨ディレクトリ構造
\Softune
\BIN
\LIB
リンケージキットのロードモジュールを格納
ターゲットCPUに依存しないメッセージファイルを格納
\907
F2MC-16ファミリ用ライブラリファイル
およびメッセージファルを格納
【補足】
リンケージキットは , 上記のようなディレクトリ構造に各ファイルを格納して実行
されることを前提に作成されています。
FETOOL 環境変数は , "SOFTUNE" ディレクトリのパスをリンケージキットに知ら
せるものです。
16
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10.4
Soft
Ma nual
LIB907
LIB907( ライブラリファイル検索ディレクトリ ) は , リンカが検索するライブラリ
ファイルを格納したディレクトリを指定します。
LIB907 の記述形式 , 説明 , 指定例などを示します。
■ LIB907
【記述形式】
SET LIB907= < パス名 > [ ; < パス名 > … ]
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
リンカが検索するライブラリファイルを格納したディレクトリを指定します。
通常は , C ライブラリを格納したディレクトリを指定しておきます。
複数の検索パスを指定する場合は , < パス名 > を次の記号で区切ります。
• セミコロン (;)
複数指定時の検索順は , 指定した順となります。
【例】
SET
LIB907=C:\ Softune\ LIB\907
【補足】
環境変数 FETOOL が指定されている場合 , 前項で説明したディレクトリ構造のライ
ブラリ格納ディレクトリも検索されるため , 環境変数 LIB907 の設定を行わなくて
も C ライブラリは検索されます。
ライブラリ検索パスは , リンカ実行時のオプション -L でも指定できます。
これらの複合指定によるライブラリ検索パスの優先順位は以下のようになります。
1. リンカのオプション -L で指定されたディレクトリ
2. 環境変数 LIB907 で指定されたディレクトリ
3. 環境変数 FETOOL より導かれるディレクトリ (%FETOOL%\ LIB\ 907)
ユーザがライブラリを作成した場合などは , C ライブラリとの検索順に注意してパ
スの指定を行ってください。
July 31, 2015, CM41-00315-6
17
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
1.10.5
So ft
Manu al
OPT907
OPT907( デフォルトオプションファイル格納ディレクトリ ) は , リンカおよびライ
ブラリアンのデフォルトオプションファイルを格納したディレクトリを指定します。
OPT907 の記述形式 , 説明 , 指定例などを示します。
■ OPT907
【記述形式】
SET OPT907= < パス名 >
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
リンカおよびライブラリアンで使用するデフォルトオプションファイルを格納し
たディレクトリを指定します。
この環境変数は省略できます。
省略した場合は , 開発環境ディレクトリ内のデフォルトオプションファイルを参照
します。
開発環境ディレクトリ内のデフォルトオプションファイルは以下のとおりです。
● リンカ
• %FETOOL%\ LIB\ 907\ FLNK907.OPT
● ライブラリアン
• %FETOOL%\ LIB\907\ FLIB907.OPT
【例】
SET
18
OPT907=C:\ Softune\ LIB\ 907
CM41-00315-6, July 31, 2015
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10.6
Soft
Ma nual
OPT
OPT( デフォルトオプションファイル格納ディレクトリ ) は , オブジェクトツールの
デフォルトオプションファイルを格納したディレクトリを指定します。
OPT の記述形式 , 説明 , 指定例などを示します。
■ OPT
【記述形式】
SET OPT= < パス名 >
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
オブジェクトツールで使用するデフォルトオプションファイルを格納したディレ
クトリを指定します。
この環境変数は省略できます。
省略した場合は , 開発環境ディレクトリ内のデフォルトオプションファイルを参照
します。
開発環境ディレクトリ内のデフォルトオプションファイルは以下のとおりです。
● オブジェクトツール
• %FETOOL% \ LIB \ F2M.OPT
• %FETOOL% \ LIB \ F2H.OPT
• %FETOOL% \ LIB \ M2B.OPT
• %FETOOL% \ LIB \ M2M.OPT
• %FETOOL% \ LIB \ H2B.OPT
• %FETOOL% \ LIB \ H2H.OPT
• %FETOOL% \ LIB \ F2I.OPT
• %FETOOL% \ LIB \ F2E.OPT
• %FETOOL% \ LIB \ M2I.OPT
• %FETOOL% \ LIB \ M2E.OPT
• %FETOOL% \ LIB \ I2M.OPT
• %FETOOL% \ LIB \ E2M.OPT
【例】
SET
July 31, 2015, CM41-00315-6
OPT=C: \ Softune \ LIB
19
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
20
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第2章
オプション
この章では , リンケージキットのオプションについ
て説明します。
2.1 オプション
2.2 オプションパラメータでの数値表現
2.3 オプション指定時の注意と評価
2.4 包含 / 相反関係にあるオプションの指定
2.5 コマンドラインの指定例
July 31, 2015, CM41-00315-6
21
第 2 章 オプション
2.1 オプション
Su pp or t
2.1
So ft
Manu al
オプション
オプションは , オプション名とパラメータで構成されます。オプションの形式や指定
方法について説明します。
■ オプション形式
オプションの形式は以下のとおりです。
- オプション名
[ パラメータ ] …
オプション名の先頭には , ハイフン (-) を付加します。
オプション名とパラメータの区切りにはスペースを置きます。
パラメータの有無および形式は , オプションごとに定義されているため , 個々のオプ
ションの説明を参照してください。
また , オプション指定時には , 以下の点に注意してください。
• オプション名の英字は , 大文字と小文字の区別を行います。
• パラメータが必要なオプションは , すべてのパラメータを省略できません。
• 複数のオプションを指定する場合 , 例えば -a と -V を -aV のようにまとめて指定す
ることはできません。
• ハイフンとオプション名の間にスペースを置くことはできません。
■ パラメータ
パラメータは,オプションの操作対象となるファイル名やモジュール名などを指定する
ものです。2 つ以上のパラメータを記述する場合には , 通常カンマ (,) で区切りますが
複雑なパラメータ指定では , カンマ以外の記号も使用するため , 詳細は個々のオプショ
ンの説明を参照してください。
【例】
-a
gets.obj,puts.obj,getc.obj,putc.obj
-sc CODE=0xC1000,DATA=0x1000
22
CM41-00315-6, July 31, 2015
第 2 章 オプション
2.2 オプションパラメータでの数値表現
Support
2.2
Soft
Ma nual
オプションパラメータでの数値表現
オプションパラメータでの数値表現には , 10 進数と 16 進数が使えます。
■ オプションパラメータでの数値表現
オプションパラメータの数値の先頭が (0x) で始まるものは 16 進数 , そうでないものは
10 進数とみなします。16 進表現の a ~ f は , 大文字と小文字の区別なくどちらでも使
用できます。
【例】
0x100
… 16 進表現 (= 256)
100
… 10 進表現 (= 0x64)
0xff と 0xFF は同じ
July 31, 2015, CM41-00315-6
23
第 2 章 オプション
2.3 オプション指定時の注意と評価
Su pp or t
2.3
So ft
Manu al
オプション指定時の注意と評価
オプションを指定するとき , 重複指定や指定順序に注意が必要なものがあります。
リンケージキットでは , 一定の規則に従ってオプションの評価をします。
■ オプション指定時の注意と評価
オプション指定時の注意と評価の規則を , 以下に示します。
● パラメータの不要なオプション
1 回だけ指定があれば良く , 何度指定しても同じです。
【例】
-V: メッセージ出力の指定
-V -V と何度指定してもエラーではありません。
● パラメータが必要なオプション。
複数回のオプション指定があるとき , 評価方法が異なります。
• 最後の指定 1 つだけが有効なもの
• 指定順に意味があり , すべての指定が有効なもの
• 指定順に意味がなく , すべての指定が有効なもの
【例 1 最後の指定 1 つだけが有効なもの】
-o file.abs: 出力ファイル名の指定
-o file.abs -o file.rel のように複数回指定した場合には , 後指定が有効になります。
( この例の場合 file.rel が有効 )
【例 2 指定順に意味があり , すべての指定が有効なもの】
-l lib1.lib
-l lib2.lib: 検索ライブラリ指定 ( リンカ )
-l lib2.lib -l lib1.lib とすると , ライブラリ検索の順番が逆になります。
【例 3 指定順に意味がなく , すべての指定が有効なもの】
-sc CODE=0x1000
-sc DATA=0x200: セクション配置指定 ( リンカ )
-sc DATA=0x200 -sc CODE=0x1000 としても , セクション配置は個々に独立のため
同等の指定となります。
24
CM41-00315-6, July 31, 2015
第 2 章 オプション
2.4 包含 / 相反関係にあるオプションの指定
Support
2.4
Soft
Ma nual
包含 / 相反関係にあるオプションの指定
ほかのオプションと包含関係にあるものは , 上位のオプション指定が有効になりま
す。また , ほかのオプションと相反関係にあるものは , 後指定が有効になります。
■ 包含関係にあるオプションの指定例
【例】
-Xm -pw 80
: リスト出力抑止とページ幅の指定
-pw オプションは , リスト出力を行うときのみ有効であるため , -Xm( リスト出力抑
止 ) オプションにより , 指定自体が意味のないものとなります。-pw 80 -Xm と指定
順が逆でも同じです。
■ 相反関係にあるオプションの指定例
ほかのオプションと相反関係にあるものは , 後指定が有効になります。
【例 1】
-a
-r
絶対形式出力指定と相対形式出力指定 ( リンカ )-r が有効となります。
【例 2】
-m mapfile
-Xm
リストファイル名指定とリスト出力抑止 -m は取り消され , リスト出力は行われま
せん。
July 31, 2015, CM41-00315-6
25
第 2 章 オプション
2.5 コマンドラインの指定例
Su pp or t
2.5
So ft
Manu al
コマンドラインの指定例
コマンドライン指定例を 3 種類示し , 説明します。
■ コマンドラインの指定例
【例 1】
flnk907s
flnk907s file1.obj file2.obj -g -a -help
コマンド名だけの指定の場合 , もしくは , 途中で , オプションがわからなくなったと
きなど , -help オプションを指定すると , 簡単なヘルプメッセージを表示します。
【例 2】
flib907s
sys.lib
-m sys.mp2
…
*1
flib907s
-m sys.mp2
sys.lib
…
*2
オプションの指定位置は決まっていませんので , コマンドラインで自由に記述でき
ます。
*1 と *2 の指定はどちらも有効であり , 同等の指定です。
【例 3】
flnk907s *.obj -g -o sample.abs
ワイルドカードを使用した , 複数入力ファイル名の指定
26
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第3章
共通オプション
リンケージキットには , どのツールにも共通して使
用できるオプションがあります。これらのオプ
ションは , C コンパイラやアセンブラにも用意され
ています。
この章では , リンケージキットの共通オプションに
ついて説明します。また , ツール固有のオプション
については , それぞれの部で説明します。
3.1 共通オプション一覧
3.2 共通オプション詳細
July 31, 2015, CM41-00315-6
27
第 3 章 共通オプション
3.1 共通オプション一覧
Su pp or t
3.1
So ft
Manu al
共通オプション一覧
ここでは , リンケージキットで共通して使用できるオプション一覧を示します。
■ 共通オプション一覧
表 3.1-1 に , リンケージキットで共通に指定できるオプション一覧を示します。
表 3.1-1 共通オプション一覧
機能
28
オプション
デフォルトオプションファイル読み込み抑止指定
-Xdof
オプションファイル名指定
-f
ヘルプメッセージの表示指定
-help
プログラムの版数 , 起動メッセージ表示の指定
-V
プログラムの版数 , 起動メッセージの出力抑止
-XV
終了メッセージの表示指定
-cmsg
終了メッセージの出力抑止
-Xcmsg
ワーニング発生時の終了コードを 1 にする指定
-cwno
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
備考
デフォルト
デフォルト
デフォルト
CM41-00315-6, July 31, 2015
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2
Soft
Ma nual
共通オプション詳細
ここでは , リンケージキットで共通して使用できる個々のオプションついて説明しま
す。
■ -Xdof オプション
-Xdof オプションは , デフォルトオプションファイルの読込みを取り消します。詳しく
は ,「 3.2.1 デフォルトオプションファイル抑止指定 (-Xdof)」を参照してください。
■ -f オプション
-f オプションでは , オプションを記述したファイルから , オプションを読み込むことを
指示します。詳しくは ,「 3.2.2 オプションファイルからの読込み指定 (-f)」を参照し
てください。
■ -help オプション
-help オプションでは , ヘルプメッセージを表示することを指示します。詳しくは ,
「 3.2.3 ヘルプメッセージの表示 (-help)」を参照してください。
■ -V オプション
-V オプションでは , プログラムの起動時のメッセージを出力します。なお , このメッ
セージは , デフォルト処理実行では表示されません。詳しくは 「
, 3.2.4 版数 / メッセー
ジ出力指定 (-V)」を参照してください。
■ -XV オプション
-XV オプションでは , 起動時のメッセージの出力を抑止することを指示します。詳し
くは ,「 3.2.5 版数 / メッセージ出力抑止 (-XV)」を参照してください。
■ -cmsg オプション
プログラムの終了メッセージを表示します。詳しくは ,「 3.2.6 終了メッセージ表示指
定 (-cmsg)」を参照してください。
■ -Xcmsg オプション
プログラムの終了メッセージの表示を抑止します。詳しくは ,「 3.2.7 終了メッセージ
表示抑止指定 (-Xcmsg)」を参照してください。
■ -cwno オプション
プログラムでワーニングが発生した場合に , 終了コードとして , OS に 1 を返します。
詳しくは ,「3.2.8 ワーニング発生時の終了コードを 1 にする指定 (-cwno)」を参照して
ください。
■ -Xcwno オプション
プログラムでワーニングが発生した場合に , 終了コードとして , OS に 0 を返します。
詳しくは ,「3.2.9 ワーニング発生時の終了コードを 0 にする指定 (-Xcwno)」を参照し
てください。
July 31, 2015, CM41-00315-6
29
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.1
So ft
Manu al
デフォルトオプションファイル抑止指定 (-Xdof)
デフォルトオプションファイルの読込みを取り消します。
本オプションの指定がない場合 , デフォルトオプションファイルは常に読み込まれま
す。
■ デフォルトオプションファイル抑止指定 (-Xdof)
【記述形式】
-Xdof
【パラメータ】
なし
【説明】
デフォルトオプションの読込みを取り消します。
本オプションの指定がない場合 , デフォルトオプションファイルは常に読み込まれ
ます。
デフォルトオプションファイルに関しては ,「 4.5 デフォルトオプションファイル」
を参照してください。
【注意】
本オプションは , コマンドラインでの指定のみ有効です。
【例】
flnk907s test.obj -Xdof
30
CM41-00315-6, July 31, 2015
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.2
Soft
Ma nual
オプションファイルからの読込み指定 (-f)
-f オプションは , オプションを記述したファイルからオプションを読み込むことを指
示します。また , このファイル内容を , コマンドラインに指定されたものと同等に扱
います。
■ オプションファイルからの読込み指定 (-f)
【記述形式】
-f < オプションファイル名 >
【パラメータ】
< オプションファイル名 > オプションや入力ファイルを記述したファイル名
【説明】
< オプションファイル名 > で指定したファイルに , オプションや入力ファイル名を
記述しておきます。
オプションを記述したファイルから , オプションを読み込むことを指示します。
このファイル内容を , コマンドラインでの指定と同様に評価し , 処理します。
ファイル名の拡張子は , デフォルトで決められたものはありません。
【注意】
オプションファイル内では , -f オプション自身の指定はできません。
オプションファイルは , 1 行に最大 1023 文字まで記述できます。
【例 1】
f2ms -V -f optfile.f2m
optfile.f2m の内容
#
# from FJ-OMF to S Format
#
cpp903.abs
# IN ABS-LM
-o cpp903.mhx
# OUT S Format
これは , 以下のようにコマンドラインで指定したのと同等です。
f2ms -V ccp903.abs -o ccp903.mhx
【例 2】
flib907s syslib.lib -f objfile.opt
syslib.lib に登録するモジュールを objfile.opt に記述し , ライブラリアンはこのファイ
ル内容を参照してライブラリファイルを作成します。
July 31, 2015, CM41-00315-6
31
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
So ft
Manu al
objfile.opt の内容は , 例えば以下のようになります。
-a
putc.obj, getc.obj, puts.obj, gets.obj,
memchr.obj, strcat.obj, strerr.obj, strpbrk.obj,
strchr.obj, strcmp.obj, strcpy.obj, strlen.obj
ライブラリ名指定まで含め , 以下のように指定することもできます。
flib907s -f libfile.opt
この場合 , objfile.opt の内容は , 以下のようになります。
syslib.lib
-a
putc.obj, getc.obj, puts.obj, gets.obj,
memchr.obj, strcat.obj, strerr.obj, strpbrk.obj,
strchr.obj, strcmp.obj, strcpy.obj, strlen.obj
オプションファイルを 2 回指定することも可能です。
flib907s syslib.lib -f objgr1.opt -f objgr2.opt
objgr1.opt および objgr2.opt の内容は , 例えば以下のようになります。
objgr1.opt の内容
-a putc.obj, getc.obj, puts.obj, gets.obj
objgr2.opt の内容
-a memchr.obj, strcat.obj, strerr.obj, strpbrk.obj,
strchr.obj, strcmp.obj, strcpy.obj, strlen.obj
32
CM41-00315-6, July 31, 2015
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.3
Soft
Ma nual
ヘルプメッセージの表示 (-help)
-help オプションは , プログラムを実行せずにヘルプメッセージを表示することを指
示します。コマンドラインの指定形式と , オプションの概要を表示します。
■ ヘルプメッセージの表示 (-help)
【記述形式】
-help
【パラメータ】
なし
【説明】
-help オプションは , コマンドラインの指定形式とオプション一覧を簡単に表示しま
す。
ヘルプメッセージは標準出力 (stdout) に出力されます。
コマンド名だけの指定時にも , 同じヘルプメッセージが出力されます。
入力ファイル名やほかのオプションが指定されている場合にも , 本オプションが指
定されていると , プログラムを実行せずにヘルプメッセージのみ表示します。
July 31, 2015, CM41-00315-6
33
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.4
So ft
Manu al
版数 / メッセージ出力指定 (-V)
-V オプションでは , プログラムの起動時のメッセージの出力を行います。
■ 版数 / メッセージ出力指定 (-V)
【記述形式】
-V
【パラメータ】
なし
【説明】
-V オプションは , 起動メッセージの出力を行うようにする指定です。なお , リンケー
ジキットの各ツールは , デフォルト実行では起動メッセージを出力しません。起動
メッセージ出力は , 必ずこの -V オプションを使って行います。
起動メッセージには , プログラム版数 , 著作権表示などが含まれます。
メッセージは標準出力 (stdout) に出力します。
【例 1】
flnk907s ccp903
本オプションを指定しない場合 , 実行開始時にメッセージを出力しません。
終了時は , OS のプロンプトが出て , 次のコマンド入力待ちになるだけです。
【例 2】
flib907s -V
-V オプションだけが指定された場合 , プログラム名 , プログラム版数 , コピーライ
トメッセージを表示したのち , 直ちにプログラムを終了します。
34
CM41-00315-6, July 31, 2015
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.5
Soft
Ma nual
版数 / メッセージ出力抑止 (-XV)
-XV オプションは , -V オプションを無効にします。これにより , プログラムの起動
メッセージの出力を行わないようにします。
■ 版数 / メッセージ出力抑止 (-XV)
【記述形式】
-XV
【パラメータ】
なし
【説明】
リンケージキットの各ツールは , デフォルト実行では起動メッセージを出力しませ
んので , 起動メッセージを出力させるには -V オプションを指定します。
-XV オプションは , -V 指定を無効にするときに指定します。
【例 1】
flnk907s ccp903
flnk907s ccp903 -XV
デフォルト処理では , 実行開始時にメッセージを出力しません。
上記指定はどちらも同じです。
【例 2】
f2ms -f lkit.opt
ccp903
-XV
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。lkit.opt 内に -V オプションがある場合 , lkit.opt の内容を
変更せずコマンドライン上で -XV 指定を行うと , -V オプションを取り消すことがで
きます。
July 31, 2015, CM41-00315-6
35
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.6
So ft
Manu al
終了メッセージ表示指定 (-cmsg)
終了メッセージを表示します。
■ 終了メッセージ表示指定 (-cmsg)
【記述形式】
-cmsg
【パラメータ】
なし
【説明】
プログラムの終了メッセージを表示します。
リンケージキットはデフォルトでは , プログラムの終了メッセージの表示を行いま
せん。
【例 1】
flnk907s ccp903
本オプションを指定しない場合 , 終了時にメッセージを出力しません。
終了時は , OS のプロンプトが出て , 次のコマンド入力待ちになるだけです。
【例 2】
f2ms ccp903 -cmsg
F2MS COMPLITED FOUND NO ERROR
終了時に , 終了メッセージ ( プログラム名 , エラーの有無 ) を表示します。
36
CM41-00315-6, July 31, 2015
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.7
Soft
Ma nual
終了メッセージ表示抑止指定 (-Xcmsg)
終了メッセージの表示を抑止します。
■ 終了メッセージ表示抑止指定 (-Xcmsg)
【記述形式】
-Xcmsg
【パラメータ】
なし
【説明】
終了メッセージの表示を抑止します。
リンケージキットは , デフォルトでプログラムの終了メッセージの表示を行いませ
ん。
本オプションはプログラムの終了メッセージの表示オプション (-cmsg) を取り消す
場合に使用します。
【例 1】
flnk907s ccp903
flnk907s ccp903 -Xcmsg
デフォルト処理では , 終了時にメッセージを出力しません。
上記指定はどちらも同じです。
【例 2】
f2ms -f lkit.opt
ccp903
-Xcmsg
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。lkit.opt 内に -cmsg オプションがある場合 , lkit.opt の内容
を変更せずコマンドライン上で -Xcmsg 指定を行うと , -cmsg オプションを取り消す
ことができます。
July 31, 2015, CM41-00315-6
37
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.8
So ft
Manu al
ワーニング発生時の終了コードを 1 にする指定
(-cwno)
プログラム実行時にワーニングのみが発生した場合の終了コードを 1 に変更します。
■ ワーニング発生時の終了コードを 1 にする指定 (-cwno)
【記述形式】
-cwno
【パラメータ】
なし
【説明】
プログラム実行時にワーニングのみが発生した場合の終了コードを 1 に変更しま
す。
SOFTUNE リンケージキットでは , 通常ワーニングのみが発生した場合の終了コー
ドは 0 です。
【例 1】
flnk907s ccp903 -cwno
プログラム実行時にワーニングのみ発生した場合 , OS への終了コードが 1 になりま
す。
【例 2】
flnk907s ccp903
プログラム実行時にワーニングのみの発生の場合, OSへの終了コードはデフォルト
である 0 のままです。
38
CM41-00315-6, July 31, 2015
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.9
Soft
Ma nual
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno)
終了メッセージの表示を抑止します。
■ ワーニング発生時の終了コードを 0 にする指定 (-Xcwno)
【記述形式】
-Xcwno
【パラメータ】
なし
【説明】
プログラム実行時にワーニングのみが発生した場合の終了コードをデフォルトで
ある 0 に戻します。
SOFTUNE リンケージキットでは , 通常ワーニングのみが発生した場合の終了コー
ドは 0 です。
本オプションはワーニング発生時の終了コードを 1 にするオプション (-cwno) を取
り消す場合に使用します。
【例 1】
flnk907s ccp903
flnk907s ccp903 -Xcwno
デフォルト処理では , ワーニング発生時の終了コードは 0 です。
上記指定はどちらも同じです。
【例 2】
f2ms -f lkit.opt
ccp903
-Xcwno
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。lkit.opt 内に -cwno オプションがある場合 , lkit.opt の内容
を変更せずコマンドライン上で -Xcwno 指定を行うと , -cwno オプションを取り消す
ことができます。
July 31, 2015, CM41-00315-6
39
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
40
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第4章
オプションファイル
この章では , リンケージキットのオプションファイ
ルについて説明します。
4.1 オプションファイルの概要
4.2 オプションファイル中での継続指定
4.3 オプションファイル中のコメント指定
4.4 オプションファイルの記述例
4.5 デフォルトオプションファイル
July 31, 2015, CM41-00315-6
41
第 4 章 オプションファイル
4.1 オプションファイルの概要
Su pp or t
4.1
So ft
Manu al
オプションファイルの概要
オプションファイルは , コマンドライン入力を簡略化するために , あらかじめ処理に
必要なファイル名やオプションを記述しておくファイルです。
■ オプションファイル
オプションファイルは,コマンドラインで指定する入力ファイル名やオプションを記述
したファイルです。
記述シンタックスは , コマンドライン上での指定方法と同じです。
ただし , オプションファイル中では , 以下の 2 項目が加わります。
• コメント文が記述できる。
• 任意区切り位置で改行可能である。
コメント文は , コメント記号 (#) で始まり , 改行で終了します。
コメント文および改行記号は , コマンドライン上でのスペースと同等に扱われます。
■ オプションファイル指定による実行
コマンドラインの指定だけでは入力できる文字数に制限があるため,指定するファイル
名やオプションが多い場合には指定しきれなくなります。また , 毎回そのような指定を
行うことは , 効率の低下と入力ミスによる誤動作の原因になります。
処理が定型化してきた場合や , 指定するオプションやファイル名が多い場合は , 毎回コ
マンドライン入力を行う手間を省くために , ファイルに記述された内容を , コマンドラ
インでの指定と同等に扱い処理できます。その際 , 処理に必要なファイル名やオプショ
ンを , テキストエディタを使いオプションファイルに作成しておき , -f オプションを用
いて実行します。
【例】
flib 907 s -f optfile
オプションファイル "optfile" の内容
prg.lib
-a main.obj
-a send.obj,receive.obj,exchange.obj
-a account.obj
-m prg.mp2
オプションファイル内の記述形式は , 上記の例のようにコマンドラインでの記述形
式と同じです。上記の例ではオプションを各行に分けていますが , 以下のように 1
行で記述してもかまいません。
ただし , 1 行の文字数は 1023 バイト以内にしてください。
prg.lib -a main.obj … -a account.obj -m prg.mp2
この例では , オプションだけではなく , 編集対象のライブラリファイル (prg.lib) の記
述も行っています。
このように , オプションファイル中には , (-f オプション , -Xdof オプションの指定を
除き ) コマンドラインで記述することのできるすべての指定が同じ形式で記述でき
ます。
42
CM41-00315-6, July 31, 2015
第 4 章 オプションファイル
4.2 オプションファイル中での継続指定
Support
4.2
Soft
Ma nual
オプションファイル中での継続指定
オプションファイル中では , オプションやパラメータの区切りの箇所で改行し , 継続
して指定できます。
■ オプションファイル中の継続指定
オプションファイルにオプションやファイル名を記述していると , オプションが 1 行に
記述しきれない場合や,見やすさのため複数行に渡って記述したいと思う場合がありま
す。
このため , オプションファイル中では , オプションやパラメータの区切りの箇所で改行
できるようにしています。以下に , オプションファイルの記述例を 2 つ示します。
【例 1 オプションファイルの内容を 1 行で記述した場合の例】
:
-a mod01, mod02, obj03, obj04
:
【例 2 オプションファイルの内容を 2 行で記述した場合の例】
:
-a mod01, mod02, obj03, obj04
:
July 31, 2015, CM41-00315-6
←継続行
43
第 4 章 オプションファイル
4.3 オプションファイル中のコメント指定
Su pp or t
4.3
So ft
Manu al
オプションファイル中のコメント指定
オプションファイル中には , コメントを入れることができます。
■ オプションファイル中のコメント指定
オプションファイル中にコメントを入れる場合 , コメント開始記号には (#) を使用しま
す。
【例 オプションファイルの内容にコメントを入れた場合の例】
下線部分がコメントです。
# Example of Library Options
syslib.lib
-a mod01, mod02, obj03, obj04
44
#
#
INDICATES LIBRARY FILE
Add Modules
CM41-00315-6, July 31, 2015
第 4 章 オプションファイル
4.4 オプションファイルの記述例
Support
4.4
Soft
Ma nual
オプションファイルの記述例
オプションファイルの記述例として , コマンドラインでの -a mod01, mod02, obj03,
obj04 と等価に扱われるオプションファイル中での指定方法を以下に示します。
■ オプションファイルの記述例
-a mod01,mod02,obj03,obj04
同じ
-a mod01, mod02 ,obj03 , obj04
, の前後にスペース挿入
-a mod01,mod02,obj03,obj04 # comment
文末にコメントを付加
# comment line
-a mod01,mod02,obj03,obj04
コメント行を追加
-a mod01,mod02,obj03,
obj04
, の後ろで改行
パラメータを継続
-a mod01,mod02,obj03
,obj04
, の前で改行
パラメータを継続
-a mod01,mod02,obj03, # comment
obj04
コメント挿入
パラメータを継続
-a
mod01,mod02,obj03,obj04
-a の後ろで改行
パラメータ全部を継続
July 31, 2015, CM41-00315-6
45
第 4 章 オプションファイル
4.5 デフォルトオプションファイル
Su pp or t
4.5
So ft
Manu al
デフォルトオプションファイル
オプションファイル機能の 1 つですが , 起動時オプション "-f" を指定しなくてもあ
らかじめ指定されているオプションファイルを読込み実行します。
この機能をデフォルトオプションファイルといいます。
■ デフォルトオプションファイル
デフォルトオプションファイルは , オプションファイル機能の 1 つですが , 起動時オプ
ション "-f" を指定しなくてもあらかじめ指定されているオプションファイルを読込み
実行します。この機能をデフォルトオプションファイルといいます。
デフォルトオプションファイルは , 常にプログラムの起動時に読み込まれるため , ユー
ザの環境にあった起動時オプションをあらかじめ指定しておくことができます。
デフォルトオプションファイル機能を抑止するには , 起動時オプション "-Xdof" を指定
します。
このオプションが指定されると , デフォルトオプションファイルは読み込まれません。
デフォルトオプションファイル名は , 表 4.5-1 で示すように決まっています。
表 4.5-1 リンケージキットのデフォルトオプションファイル名
ツール名
プログラム名
オプションファイル名
リンカ
flnk907s
flnk907.opt
ライブラリアン
flib907s
flib907.opt
オブジェクト形式
コンバータ
f2ms
f2m.opt
f2hs
f2h.opt
m2ms
m2m.opt
h2hs
h2h.opt
m2bs
m2b.opt
h2bs
h2b.opt
f2is
f2i.opt
f2es
f2e.opt
m2is
m2i.opt
m2es
m2e.opt
i2ms
i2m.opt
e2ms
e2m.opt
デフォルトオプションファイルの参照方法を次に示します。
46
CM41-00315-6, July 31, 2015
第 4 章 オプションファイル
4.5 デフォルトオプションファイル
Support
Soft
Ma nual
● 環境変数 "OPT907" または "OPT" が設定されている場合
環境変数で設定されているディレクトリのファイルを参照します。
• リンカ , ライブラリアン
- %OPT907% \ デフォルトオプションファイル
• オブジェクトツール
- %OPT% \ デフォルトオプションファイル
● 環境変数 "OPT907" または "OPT" が設定されていない場合
開発環境ディレクトリ内のデフォルトオプションファイルを参照します。
• リンカ , ライブラリアン
- %FETOOL% \ LIB \ 907 \ デフォルトオプションファイル
• オブジェクトツール
- %FETOOL% \ LIB \ デフォルトオプションファイル
<注意事項>
デフォルトオプションファイルが見つからない場合 , リンケージキットはエラーメッセー
ジを表示しません。
July 31, 2015, CM41-00315-6
47
第 4 章 オプションファイル
4.5 デフォルトオプションファイル
Su pp or t
48
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
第 II 部
Soft
Ma nual
リンカ編
リンカの仕様 , オプションおよび出力リストなどについて説明します。
第 5 章 リンカの仕様
第 6 章 リンカのオプション
第 7 章 リンカの出力リスト ファイル
第 8 章 リンカの制限事項 および Q &A
July 31, 2015, CM41-00315-6
49
Su pp or t
50
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第5章
リンカの仕様
この章では , リンカの概要とリンカの各機能につい
て説明します。
5.1 リンカの概要
5.2 リンカの機能
5.3 セクションの種類
5.4 セクションの結合
5.5 セクションの配置
5.6 セクションの自動配置
5.7 ライブラリの検索
5.8 ROM/RAM 領域
5.9 ROM → RAM 転送セクション
5.10 DIR 属性セクションの配置について
5.11 CPU 情報ファイル
5.12 リンカでのオブジェクト混在
5.13 リンカでの関数呼び出しインタフェースの異なるオブ
ジェクトの混在について
5.14 未使用関数削除
July 31, 2015, CM41-00315-6
51
第 5 章 リンカの仕様
5.1 リンカの概要
Su pp or t
5.1
So ft
Manu al
リンカの概要
リンカは , アセンブラが出力した複数のオブジェクトモジュールを結合し , アドレス
解決などを行って実行形式のロードモジュールを作成するツールです。
■ リンカの概要
開発するプログラム規模が大きくなると , 1 本のソースプログラムだけですべてを記述
するのには無理が生じてきます。
また , C コンパイラを使用した開発では , 通常 C のライブラリファイルの取り込みが必
要になります。
複数の関連しあったオブジェクトモジュールを結合して , メモリ配置アドレスを割当
て , 実行可能な形式のロードモジュールを作成するのがリンカの役割です。
図 5.1-1 にリンカと入出力ファイルの関係を示します。
図 5.1-1 リンカと入出力ファイルの関係
アセンブラ
ライブラリ
相対形式
オブジェクト
(.lib)
(.obj)
リンカ
アセンブルリスト
(.lst)
絶対形式
アセンブルリスト
(.als)
オブジェクト
内容リスト
相対形式
ロードモジュール
(.mp1)
(.rel)
絶対形式
ロードモジュール
(.abs)
52
(.mpx)
(.mps)
(.mpm)
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2
Soft
Ma nual
リンカの機能
リンカには多くの機能がありますが , 大きく分けると以下の 4 つに分類できます。
• 入出力ファイル / メッセージに関する制御
• セクションの結合 / 配置に関する制御
• ライブラリの検索に関する制御
• エントリアドレス / シンボル値の設定
■ 入出力ファイル / メッセージに関する制御
入出力ファイルとその制御の概要について説明します。詳しくは「 5.2.1 入出力ファイ
ル / メッセージに関する制御」を参照してください。
• 入力ファイルは , 以下の 4 つです。
- 「アセンブラ出力オブジェクトモジュールファイル」
- 「リストファイル」
- 「リンカ出力の相対形式ロードモジュールファイル」
- 「ライブラリファイル」
• オブジェクトモジュールファイルとロードモジュールファイルは , コマンドライン
またはオプションファイル中に記述した順に処理されます。
• 出力ファイルは , 以下の 3 つです。
- 最終目的となる「絶対形式ロードモジュールファイル」
- 再入力可能な「相対形式ロードモジュールファイル」
- 「リンクマップリストファイル」
• 出力ロードモジュールの形式(絶対/相対)指定や,出力ファイル名の変更ができます。
• マップリストは 1 ページの行数やページ幅の変更ができます。
• オプションを指定することにより , 以下の 4 つのファイルを出力できます。
これらのファイルを出力するには , リンク時のロードモジュールの形式を絶対指定
にしてください。
- アセンブラが出力したリストファイルを絶対形式にした「絶対形式アセンブルリ
ストファイル」
- 各モジュールで使用している外部シンボルについてモジュール間の定義 / 参照の
相互参照を表示した「外部シンボル相互参照情報リスト」
- モジュールごとに使用したローカルシンボルに関する情報を表示した「ローカル
シンボル情報リスト」
- 各モジュール内のセクション配置アドレスを表示した「セクション詳細マップリ
スト」
• メッセージにはプログラム版数などの情報を含む起動メッセージ , 簡単な使用方法
を示すヘルプメッセージおよびエラーメッセージがあります。起動メッセージ出力
の有無を選択したり , ワーニング検出レベルを選択したりすることができます。
July 31, 2015, CM41-00315-6
53
第 5 章 リンカの仕様
5.2 リンカの機能
Su pp or t
So ft
Manu al
■ セクションの結合 / 配置に関する制御
セクションの結合 / 配置に関する制御の概要について説明します。詳しくは ,「 5.2.2
セクションの結合 / 配置に関する制御」を参照してください。
• ROM および RAM のアドレス範囲を指定することで , 領域外への配置チェックがで
きます。
• セクションの指定では複数セクションをグループ化し , まとめて処理したり , 属性
別のセクション選択などができます。
• セクションの指定には , ワイルドカードが使用できるため , セクションが多数ある
場合のセクション結合や配置の指定が簡潔に行えます。
• ROM 化支援機能を備えています。
• 指定した ROM および RAM 領域内への自動配置ができます。
■ ライブラリの検索に関する制御
ライブラリの検索に関する制御について概要を説明します。詳しくは「 5.2.3 ライブラ
リの検索に関する制御」を参照してください。
• C での開発時に , リンクに必要な C の実行時ライブラリを自動識別して結合できま
す ( デフォルトライブラリファイルの検索 )。
• ユーザが作成した複数のライブラリを検索できます。
• 個々のシンボルごとに , 検索するライブラリファイルを指定できます。
• ライブラリ検索の抑止ができます。
■ エントリアドレス / シンボル値の設定
一時的に未定義外部シンボルに値を割り付けたり,エントリアドレスを設定したりでき
ます。詳しくは「 5.2.4 エントリアドレス / シンボル値の設定」を参照してください。
54
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2.1
Soft
Ma nual
入出力ファイル / メッセージに関する制御
リンカの機能のうち , 入出力ファイル / メッセージに関する制御を行うそれぞれの機
能について説明します。
■ 入力オブジェクトファイルの指定
リンカの入力となるファイルは , アセンブラ出力のオブジェクトモジュールファイル
と , リンカ出力の相対形式ロードモジュールファイルです。
入力するファイルすべてを指定します。ワイルドカードを使用することで簡単に指定
が行えます。
■ 出力ロードモジュールファイル名の指定
リンク後に生成される出力ロードモジュールファイル名は,デフォルトではリンカが最
初に入力したモジュールのファイル名をもとに作られます。
デフォルトファイル名は,リンク結果の全体を示す名称としては不適当である場合が多
いため , このデフォルト出力ファイル名を変更するための機能です。
特に , ワイルドカードを使用してファイル名を指定した場合には , 出力ファイル名がわ
かりにくくなるため , 出力ファイル名の指定を行うことを推奨します。
■ デバッグ情報の継承
デバッグのためには , シンボル情報やソースファイルに関する情報が必要です。
C およびアセンブラで , デバッグ情報作成の指定 (-g オプション ) を行うと , オブジェ
クトモジュール中にデバッグ情報が作成されます。
リンカでは , このデバッグ情報を継承してロードモジュール中に出力するか , 削除する
かを選択できます。
■ 出力フォーマットの指定
リンクした結果として , 絶対形式ロードモジュールを生成するのか , 相対形式ロードモ
ジュールを生成するのかを指定する機能です。
■ リストファイル名の指定
リストファイルは出力オブジェクトファイル名をもとに作成されますが,このデフォル
トファイル名を変更するための機能です。
■ リストファイルの形式変更
リストファイル作成ではページ制御を行っていますが , 1 ページの行数や 1 行の文字数
を変更できます。
また , シンボル名の文字数が長いときは 1 行に表示できる範囲で打ち切っていますが ,
ユーザの定義どおりの名称で表示するように指示できます。
■ 警告チェックレベルの選択
警告は軽微なエラーであり,リンク処理が継続できる程度の不都合が発生した場合に通
知されるメッセージですが , 修正を要するものと , そのままで特に問題のないものとが
あります。これらのチェックレベルを選択できます。
■ 起動メッセージ表示の選択
起動時のツール名と著作権の表示を行うか否かを選択できます。
■ 終了メッセージ表示の選択
終了メッセージの表示を行うか否かを選択できます。
July 31, 2015, CM41-00315-6
55
第 5 章 リンカの仕様
5.2 リンカの機能
Su pp or t
5.2.2
So ft
Manu al
セクションの結合 / 配置に関する制御
リンカの機能のうち , セクションの結合 / 配置に関する制御を行うそれぞれの機能に
ついて説明します。
■ ROM および RAM 領域の指定
ROM 領域と RAM 領域のアドレス範囲を指定して領域名称を定義すると , セクション
の配置指定時にアドレス指定の代わりにこの領域名称を用いることができ,範囲外への
配置に対するチェックが可能になります。
セクションの自動配置を行う場合には , この領域指定範囲内に配置します。
■ セクションの配置順と配置アドレスの指定
すべてのセクションは任意の順序で , 任意の領域に配置できます。セクション名の指定
には , ワイルドカードが使用できます。
また , セクション内容種別を付加した指定が可能なため , ワイルドカードと組み合わせ
ることで同じ内容種別 (code, data など ) のセクションだけを集めることもできます。
■ セクションのグループ化
リンカは , セクション単位に結合と配置を行いますが , 多くのセクション名を使ってプ
ログラムを作成した場合 , セクションの配置指定が煩雑になります。
複数セクションにグループ名を付け , 連続領域に集めることで , そのまとまりをあたか
も 1 つのセクションのように扱うことができます。
■ ROM 化支援
C でのプログラム開発においては初期値付変数が生成され , その変数の書換えなどの処
理を行うことが頻繁にあります。
組込み用のアプリケーションにおいては , 初期値データは ROM に置き , 実行前に RAM
へデータを転送しないと使用できないことになります。
このような使用を可能にするための機能です。詳しくは「 5.9 ROM → RAM 転送セク
ション」を参照してください。
56
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2.3
Soft
Ma nual
ライブラリの検索に関する制御
リンカの機能のうち , ライブラリの検索に関する制御を行うそれぞれの機能について
説明します。
■ ライブラリ検索パス指定
ライブラリの検索パスは , 通常 C ライブラリを格納したディレクトリを環境変数で指
定しておきますが,ユーザが自身で作成したライブラリを別のディレクトリに格納した
場合などに指定します。
■ 検索ライブラリファイル指定
C コンパイラが提供する実行時ライブラリ以外に , ユーザが独自に作ったライブラリ
ファイルの名前を検索対象ライブラリとして指定します。
■ シンボルごとの検索ライブラリファイル指定
複数のライブラリファイルの検索を行うリンク処理において,ライブラリ間に同一の外
部シンボルが含まれていることが分かっている場合,どのライブラリのモジュールとリ
ンクするかを明確に指定するために使用します。
■ ライブラリ検索の抑止
デフォルトライブラリの検索を禁止したり,すべてのライブラリ検索を行わないように
したりすることができます。
July 31, 2015, CM41-00315-6
57
第 5 章 リンカの仕様
5.2 リンカの機能
Su pp or t
5.2.4
So ft
Manu al
エントリアドレス / シンボル値の設定
リンクの機能のうち , エントリアドレス / シンボル値の設定に関する機能について説
明します。
■ エントリアドレス指定
プログラムの実行開始アドレスを , 出力ロードモジュール中に設定する機能です。
■ 外部シンボル値の設定
プログラムが未完成であるか , 外部シンボル名を間違えているかなどが原因で , リンク
後に定義されていない外部シンボルがある場合はエラーとなります。
このエラーを一時的に取り除き,とりあえず実行可能なロードモジュールを作成したい
場合に仮の値を設定する機能です。
58
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.3 セクションの種類
Support
5.3
Soft
Ma nual
セクションの種類
リンカが結合処理を行うときの最小単位はセクションです。
セクションはプログラムでの使用目的の違いにより , 配置や結合の方法に特長があり
ます。
セクション名 , 内容種別 , 配置属性 , 結合属性などについて説明します。
■ セクション名
セクションを識別するために付けた名前です。
■ セクション内容種別
使用目的の違いによるセクション内容種別には以下の 7 つがあります。
実行 , Read, Write の属性は , アセンブラが決定します。表 5.3-1 にセクションの種別を
示します。
表 5.3-1 セクションの種別
種別
説明
属性
CODE
プログラムコード領域
実行 , Read
DATA
変数領域
Read, Write
CONST
初期値付変数領域
Read
STACK
スタック領域
Read, Write
IO
IO 領域
Read, Write
DIR
direct 領域
Read, Write
DIRCONST
初期値付 direct 領域
Read
■ セクションの配置属性
セクションの配置に関する属性は , 再配置可能か否かの 2 種類あります。表 5.3-2 にセ
クションの配置属性を示します。
表 5.3-2 セクションの配置属性
属性
説 明
ABS
絶対番地の指定されたセクションです。
REL
再配置可能なセクションです。
July 31, 2015, CM41-00315-6
59
第 5 章 リンカの仕様
5.3 セクションの種類
Su pp or t
So ft
Manu al
■ セクションの結合属性
セクションの結合に関する属性は , 共有か連結かの 2 種類あります。表 5.3-3 にセク
ションの結合属性を示します。
表 5.3-3 セクションの結合属性
属性
説 明
PUBLIC
次々に連続して結合されます。
COMMON
同じアドレスに重ねあわせて結合されます。
■ セクションの識別
リンカでは , セクション名と内容種別と結合属性が同一で , REL 属性のセクションを同
一セクションとして扱います。
ABS 属性セクションは , リンカの配置処理の対象にはなりません。
リンカは , セクション名によってセクションの識別を行うため , 同じセクション名で内
容種別や属性の異なるセクションは定義しないでください。
60
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.4 セクションの結合
Support
5.4
Soft
Ma nual
セクションの結合
リンカでは ,「複数のオブジェクトを結合する」という表現を多く用いますが , 正確
には「オブジェクト中のセクションを結合する」という意味です。
セクションの結合方法には , 単純連結結合 (PUBLIC) と共有結合 (COMMON) があり
ます。
■ セクションの単純連結結合
同じセクション名と内容種別を持ち , 結合属性が PUBLIC である REL セクションは単
純連結結合を行います。
図 5.4-1 に , 2 つのオブジェクトファイル中の同一セクションの単純連結結合の概要を
示します。
結合後の全体のサイズは , A-1 と A-2 のサイズの合計に , バウンダリ調整により生じた ,
A-1 と A-2 の間の隙間分のサイズを加えたものとなります。
図 5.4-1 セクションの単純連結結合
セクションA-1
セクションA-1
セクションA-2
セクションA-2
■ セクションの共有結合
同じセクション名と内容種別を持ち , 結合属性が COMMON である REL セクションは
共有結合を行います。
初期値のない , データセクションでの使用が考えられます。
図 5.4-2 に , 2 つのオブジェクトファイル中の同一セクションの共有結合の概要を示し
ます。
結合後の全体のサイズは , A-1 と A-2 のサイズのうち大きい方になります。
図 5.4-2 セクションの共有結合
セクションA-1
セクションA-2
A-1
セクションA-2
July 31, 2015, CM41-00315-6
61
第 5 章 リンカの仕様
5.5 セクションの配置
Su pp or t
5.5
So ft
Manu al
セクションの配置
リンカは , 同一のセクションを結合したのちそれぞれのセクションの配置アドレスを
決定します。ここでは , ユーザがアドレス指定をした場合を含めて , リンカのセク
ション配置の方法を説明します。
■ セクションのリンク
結合と配置処理は , 相対セクションのみが対象となります。
絶対セクションは , 結合・配置の対象にはなりません。
セクションの結合・配置は , 以下のような手順で行います。
1. それぞれのオブジェクトモジュールから同一セクションを集める。
2. 集めた同一セクション同士を , 結合属性に従って結合する。
3. 同一セクションを結合したものを配置する。
セクション配置順序に関係するオプションが指定されている場合はそれに従って行わ
れ,指定がない場合はオブジェクトファイル中での出現順がそのまま配置の順番になり
ます。
詳しくは ,「 5.5.1 セクションの結合順序が指定されなかった場合の配置例」,「 5.5.2
セクションの結合順序が指定された場合の配置例」,「 5.5.3 セクショングループの指
定がある場合の配置例」を参照してください。
62
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.5 セクションの配置
Support
5.5.1
Soft
Ma nual
セクションの結合順序が指定されなかった場合の配
置例
セクションの結合順序が指定されなかった場合の配置例を図 5.5-1 に示し , この図に
従って説明します。
■ セクションの結合順序が指定されなかった場合の配置例
オブジェクトファイルの入力順が , モジュール 1 → 2 → 3 であるとき , セクションの出
現順は A → B → C となるので , 配置アドレスも低い方から順に A → B → C となります。
図 5.5-1 セクションの結合順序が指定されなかった場合の配置例
モジュール1
モジュール2
モジュール3
ロードモジュール
A
A
A
A-1
B
B
A-2
A-3
C
C
B
C-1
C-2
(注意事項) セクションA, CはPUBLIC属性を持ち, セクションBはCOMMON属性
を持つとした場合
July 31, 2015, CM41-00315-6
63
第 5 章 リンカの仕様
5.5 セクションの配置
Su pp or t
5.5.2
So ft
Manu al
セクションの結合順序が指定された場合の配置例
セクションの結合順序が指定された場合の配置例を図 5.5-2 に示し , この図に従って
説明します。
■ セクションの結合順序が指定された場合の配置例
オブジェクトファイルの入力順が , モジュール 1 → 2 → 3 であるとき , セクションの出
現順は A → B → C であるが , 配置順として A → C → B が指定された場合。
図 5.5-2 セクションの結合順序が指定された場合の配置例
モジュール1
モジュール2
モジュール3
ロードモジュール
A
A
A
A-1
B
B
A-2
A-3
C
C
C-1
C-2
B
(注意事項) セクションA, CはPUBLIC属性を持ち, セクションBはCOMMON属性
を持つとした場合
64
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.5 セクションの配置
Support
5.5.3
Soft
Ma nual
セクショングループの指定がある場合の配置例
セクショングループの指定がある場合の配置例を図 5.5-3 に示し , この図に従って説
明します。
■ セクショングループの指定がある場合の配置例
グループ指定がある場合は,それぞれのグループに属するセクションは連続した領域に
配置されます。セクションの出現順は , A → B → C → D → E → F ですが , F は C の所
属するグループ (C → D → F) に含まれているため , E の前に配置されます。
図 5.5-3 セクショングループの指定がある場合の配置例
モジュール1
モジュール2
モジュール3
ロードモジュール
A
A
A
A-1
A-2
B
B
C
D
A-3
B
C
C-1
C-2
E
E
F
D
F
F-2
F-3
E
(注意事項) セクションB, EはCOMMON属性を持ち, ほかのセクションはPUBLIC属性とする。
配置順序指定はなく, セクションC, D, Fが, 同一グループにグループ化
される場合
July 31, 2015, CM41-00315-6
65
第 5 章 リンカの仕様
5.6 セクションの自動配置
Su pp or t
5.6
So ft
Manu al
セクションの自動配置
通常リンカは , ユーザの配置指定に従って , セクション配置アドレスの決定を行いま
す。しかし , -AL オプションを指定することで , セクション配置アドレスの決定を自
動的にリンカに任せることが可能です。
-ra, -ro オプションで指定した領域内へセクション配置を行うとき , アブソリュート
セクションが存在していれば , 配置アドレスが重ならないように , リロケータブルセ
クションの配置を行います。このとき , アライメント値およびサイズの大きいセク
ションから順に配置し , 空き領域が最小となるような最適配置を行います。
■ セクションの自動配置
本リンカは , 以下に示す 2 つのタイプでセクションの自動配置をサポートしています。
• -AL 1 が指定された場合のセクションの自動配置
• -AL 2 が指定された場合のセクションの自動配置
セクションの自動配置の詳細については 「5.6.1
,
-AL 1 が指定された場合のセクション
の自動配置」,「5.6.2 -AL 2 が指定された場合のセクションの自動配置」を参照してく
ださい。
66
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.6 セクションの自動配置
Support
5.6.1
Soft
Ma nual
-AL 1 が指定された場合のセクションの自動配置
-AL 1 が指定されたとき , リンカは領域内に存在するアブソリュートセクションと配
置アドレスが重ならないように , リロケータブルセクションの配置を行います。
■ 配置アドレスの決定方法
自動配置の対象となるセクションは , -sc オプションで領域名指定が行われているセク
ションです。
各セクションの配置は , アライメント値の大きいセクション順に処理し , アライメント
値が同じ場合にはサイズの大きいセクションから順に処理されます。
表 5.6-1 に , 各セクションのアライメント値とサイズを示します。
表 5.6-1 各セクションのアライメント値 / サイズ
セクション名
アライメント値
サイズ
code1
2
0x0180
code2
2
0x0100
code3
2
0x0200
code4
4
0x0100
code5
4
0x0200
code6
2
0x0020
例えば,表 5.6-1 のようなセクションでは,以下のように配置処理の順番が決定されます。
1. アライメント値が 4 であるセクション (code4, code5) が , アライメント値が 2 のセク
ション (code1, code2, code3) より先に配置処理が行われます。
2. code4 と code5 では , サイズが大きい code5 の方が先に配置処理されます。
したがって , 表 5.6-1 に示されるセクションの配置処理の順番は , 表 5.6-2 で示すように
なります。
表 5.6-2 各セクションのアライメント値 / サイズ
配置処理順
セクション名
アライメント値
サイズ
1
code5
4
0x0200
2
code4
4
0x0100
3
code3
2
0x0200
4
code1
2
0x0180
5
code2
2
0x0100
6
code6
2
0x0020
配置先は , 配置可能で最小の空きエリアが選択されます。
July 31, 2015, CM41-00315-6
67
第 5 章 リンカの仕様
5.6 セクションの自動配置
Su pp or t
So ft
Manu al
■ -AL 1 が指定された場合の配置例
リンカのオプション指定と各セクションの内容が , 図 5.6-1 , 表 5.6-3 の場合の配置例を
示します。
図 5.6-1 リンカのオプション指定
-ro ROM=0xC1000/0xC18FF
-sc code1+code2+code3+code4+code5+code6=ROM
-AL 1
:
表 5.6-3 各セクションの内容
セクション名
配置属性
アドレス範囲
アライメント値
サイズ
code1
REL
-
2
0x0180
code2
REL
-
2
0x0100
code3
REL
-
2
0x0200
code4
REL
-
4
0x0100
code5
REL
-
4
0x0200
code6
REL
-
2
0x0020
AbsSec
ABS
0xC1120 ~ 0xC121F
0
0x0100
図 5.6-2 に , -AL 1 が指定された場合の配置例を示します。
このように , -AL 1 を使用すると , リンカが指定された領域内で , アブソリュートセク
ションと重ならないように , また空き領域が最小となるような最適配置を行います。
図 5.6-2 -AL 1 が指定された場合の配置例
0xC1000
code4
0xC1100
0xC1120
code6
AbsSec
0xC1220
code5
0xC1420
code3
0xC1620
code1
0xC17A0
code2
0xC18A0
未使用(空き)
0xC18FF
-scで指定された領域ROM
68
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.6 セクションの自動配置
Support
5.6.2
Soft
Ma nual
-AL 2 が指定された場合のセクションの自動配置
-AL 2 が指定されれば , リンカは , -sc オプションで配置アドレス指定が行われな
かったセクションに対して , そのセクションの種別から , ROM 領域に配置すべきか ,
RAM 領域に配置すべきかをリンカが判断し , それぞれの領域内の空き領域に配置し
ます。
ここでは , セクションの種別ごとの配置先や配置アドレス決定の順序について説明し
ます。
また , -AL 2 が指定された場合の配置例を図 5.6-4 に示します。
■ セクション種別と配置先
-AL 2 が指定された場合 , リンカは配置指定の行われていないセクションを自動的に配
置します。このとき , リンカはセクション種別により , 表 5.6-4 に示すように配置先
( 領域 ) の決定を行います。
表 5.6-4 セクション種別と配置先
配置先
セクション種別
ROM 領域
(-ro で指定された領域 )
CODE
CONST
DIRCONST
RAM 領域
(-ra で指定された領域 )
IO
DIR
DATA
STACK
July 31, 2015, CM41-00315-6
69
第 5 章 リンカの仕様
5.6 セクションの自動配置
Su pp or t
So ft
Manu al
■ 配置アドレスの決定方法
-AL 2 が指定された場合 , リンカは , 表 5.6-5 に示す順にセクション配置アドレス決定を
行います。
表 5.6-5 で示す順のように , 自動配置よりもユーザ指定が優先されるようになっていま
す。
なお,リンカは,配置可能な場所を検索する場合,常に低位アドレスから検索を行います。
表 5.6-5 セクション配置先
順番
処理対象のセクション
配置先と配置方法
1
ABS 属性を持つセクション
セクションが持つアドレスに配置する。
2
-rgオプションで指定されたレジスタバンク
該当するレジスタバンク領域に配置する。
3
-sc オプションで , "-sc Section=0x0100" のよ
うに,配置アドレスの指定が行われているセ
クション
指定されたアドレスに配置する。
4
-sc オプションで , "-sc Section=ROM" のよう
に,配置領域の指定が行われているセクショ
ン
指定された領域内で,ほかのセクションと重
ならないように,配置可能な場所を検索して
配置する。
5
配置に関する指定が行われていないセク
ション
表 5.6-4 に従って配置領域の決定を行い , そ
の領域内で,ほかのセクションと重ならない
ように , 配置可能な場所を検索して配置す
る。
■ -AL 2 が指定された場合の配置例
リンカのオプション指定と各モジュールに含まれるセクションが , 図 5.6-3 , 表 5.6-6 の
場合の配置例を示します。
レジスタバンク 0 の領域は 0x0180 ~ 0x018F の 16 バイトとします。
図 5.6-3 リンカのオプション指定
file1.obj, file2.obj file3.obj
-ro ROM=0xFF8000/0xFFFFFF
-ra RAM=0x000000/0x0007FF
-sc ivect=0xFFFF00
-AL 2
70
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.6 セクションの自動配置
Support
Soft
Ma nual
表 5.6-6 各モジュールに含まれるセクション
モジュール
セクション名
種別
配置属性
アドレス
サイズ
p1
CODE
REL
-
0x0C00
p4
CODE
REL
-
0x1000
stk
STACK
REL
-
0x0100
ivect
CONST
REL
-
0x0100
i1
IO
ABS
0x0000
0x0080
d1
DATA
REL
-
0x0040
d3
DATA
ABS
0x0200
0x0180
p3
CODE
REL
-
0x1000
d2
CONST
REL
-
0x0300
p2
CODE
ABS
0x9000
0x0C00
d4
DATA
REL
-
0x0100
file1.obj
file2.obj
file3.obj
図 5.6-4 に , -AL 2 が指定された場合の配置例を示します。
このように , -AL 2 を使用すると , リンカが適当に指定された領域内でセクションの自
動配置を行うので , ユーザはプログラムの動作上必要な , 最小限の領域指定やセクショ
ン配置指定で済み , セクションの配置を指定する手間を軽減できます。
図 5.6-4 -AL 2 が指定された場合の配置例
0xFF8000
0x0000
i1
0x0080
0x00C0
d1
d4
0x01C0
0x0200
0x0480
stk
0xFF9000
p2
p4
0xFFAC00
0xFFFF00
July 31, 2015, CM41-00315-6
p3
未使用(空き)
未使用(空き)
0xFFFFFF
RAM領域
未使用(空き)
0xFF9C00
0xFFBC00
0x07FF
p1
d2
0xFF8F00
未使用(空き)
d3
0x0380
0xFF8C00
ivect
ROM領域
71
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7
So ft
Manu al
ライブラリの検索
リンカでの検索を行いたいライブラリファイルは , 以下の 3 とおりの方法で指定で
きます。
• デフォルトライブラリの設定
• -l オプションによる指定
• -el オプションによる指定
■ 検索ライブラリの指定
リンカは , 指定された入力ファイルの結合がすべて終了した時点で , 未定義のシンボル
が残っていれば , その解決のためにライブラリファイルの検索を行います。
ライブラリファイルの検索は , 検索漏れが発生しないように再帰的に行われます。
検索すべきライブラリファイルは , 以下の 3 とおりの方法で指定できます。
● デフォルトライブラリの設定
プログラムを C 言語で記述した場合 , リンク時には C ライブラリが必要となります。
リンク時にユーザが検索すべきライブラリファイルを指定することは面倒であり,指定
を間違えれば意図しないモジュールを結合してしまうこともあります。
このようなことを防ぐために, Cコンパイラは選択すべきライブラリファイル名の情報
をアセンブラの疑似命令で指示し,アセンブラはその情報をオブジェクトモジュール内
に設定します。
このようにして,リンクされるオブジェクトモジュール内に設定されたライブラリファ
イル名をデフォルトライブラリとよびます。
● -l オプションによる指定
デフォルトライブラリとして設定されていないライブラリファイルを検索対象とした
い場合は , ユーザがリンク時に指定しなくてはなりません。
ユーザ自身がライブラリファイルを作成し , これをリンクしたい場合 , アセンブラでラ
イブラリ指定の疑似命令を記述するか , リンカ起動時に -l オプションで指定します。
なお , -l オプションについて詳しくは「 6.2.22 ライブラリ検索パスの指定 (-L)」を参照
してください。
● -el オプションによる指定
ライブラリファイルは複数個指定できます。
異なるライブラリファイルに,同一名の外部定義シンボルが含まれている場合もあり得
ます ( 原因の判りにくい障害を招く恐れがありますので , 極力避けてください )。
-el オプションは , シンボルごとにシンボル検索を行うライブラリファイル名を特定す
るための指定です。詳しくは「 6.2.23 シンボル個別のライブラリの指定 (-el)」を参照
してください。
■ ライブラリファイルの検索順序
リンカは , まず -el オプションで指定のあるシンボルについてシンボル参照を解決し ,
次に -l オプションで指定された順にライブラリの検索を行い , 最後にデフォルトライ
ブラリを検索します。ライブラリファイルから,モジュールの取り込みがなくなるまで,
この一連の検索が続けられます。
72
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
5.7.1
Soft
Ma nual
ライブラリファイルが 1 つの場合の検索例 1
ライブラリファイルが 1 つの場合の検索例は 3 つあります。このうち 1 つを図 5.7-1
に示し , この図に従って説明します。
■ ライブラリファイルが 1 つの場合の検索例 1
図 5.7-1 ライブラリファイルが 1 つの場合の検索例 1
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
参照 (S2)
オブジェクトY
Y
定義 {S2}
ライブラリファイル
シンボルテーブル
{S1} → A
{S2} → B
:
A
定義 {S1}
B
定義 {S2}
:
+
X
参照 (S1)
参照 (S2)
抽出モジュール
Y
定義 {S2}
A
定義 {S1}
A
定義 {S1}
オブジェクトモジュールXとYを結合した結果,
X内の外部参照シンボル(S2)は, Y内の外部定義
シンボル{S2}によって解決されます。
X内の外部参照シンボル(S1)が未解決なため
ライブラリを検索します。
モジュールAに, 外部定義シンボル{S1}が含ま
れているため, このモジュールを新たにリンク
します。
これで, 未解決の外部参照シンボルはなくなる
ため, モジュールX, Y, Aから成るロードモ
ジュールを作成してリンク処理を終了します。
ライブラリ中のモジュールBに外部定義シンボル
{S2}がありますが, 既にリンクされたモジュール
Yに存在しているため, (S2)に関してはライブラ
リ検索の対象になりません。
(注意事項) 図中の( )で括ったシンボル名は"参照"を, { }で括ったシンボル名は
"定義"を表します。
July 31, 2015, CM41-00315-6
73
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7.2
So ft
Manu al
ライブラリファイルが 1 つの場合の検索例 2
ライブラリファイルが 1 つの場合の検索例は 3 つあります。このうち 1 つを図 5.7-2
に示し , この図に従って説明します。
■ ライブラリファイルが 1 つの場合の検索例 2
図 5.7-2 ライブラリファイルが 1 つの場合の検索例 2
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
参照 (S2)
オブジェクトY
Y
参照 (S2)
ライブラリファイル
+
X
参照 (S1)
参照 (S2)
抽出モジュール
Y
参照 (S2)
A
定義 {S1}
B
定義 {S2}
A
定義 {S1}
B
定義 {S2}
シンボルテーブル
{S1} → A
{S2} → B
:
オブジェクトモジュールXとYを結合した結果,
X, Y内の外部参照シンボル(S1)と(S2)は, 共に
未解決となります。
A
定義 {S1}
ライブラリを検索し, モジュールAに外部定義
シンボル{S1}が, モジュールBに外部定義シン
ボル{S2}が含まれているため, この2つのモ
ジュールを新たにリンクします。
B
定義 {S2}
:
これで, 未解決の外部参照シンボルはなくなる
ため, モジュールX, Y, A, Bから成るロードモ
ジュールを作成してリンク処理を終了します。
(注意事項) 図中の( )で括ったシンボル名は"参照"を, { }で括ったシンボル名は
"定義"を表します。
74
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
5.7.3
Soft
Ma nual
ライブラリファイルが 1 つの場合の検索例 3
ライブラリファイルが 1 つの場合の検索例は 3 つあります。このうち 1 つを図 5.7-3
に示し , この図に従って説明します。
■ ライブラリファイルが 1 つの場合の検索例 3
図 5.7-3 ライブラリファイルが 1 つの場合の検索例 3
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
+
オブジェクトY
抽出モジュール
Y
参照 (S1)
X
参照 (S1)
Y
参照 (S1)
A
定義 {S1}
参照 (S2)
A
定義 {S1}
参照 (S2)
B
定義 {S2}
B
定義 {S2}
ライブラリファイル
シンボルテーブル
{S1} → A
{S2} → B
:
A
定義 {S1}
参照 (S2)
B
定義 {S2}
:
オブジェクトモジュールXとYを結合した結果,
X, Y内の外部参照シンボル(S1)が未解決となりま
す。
ライブラリを検索し, モジュールAに外部定義
シンボル{S1}が含まれているため, このモジュー
ルを新たにリンクします。
この結果, 外部参照シンボル(S2)が新たな未解
決シンボルとなったため, もう一度ライブラリを
検索し, {S2}の定義されているモジュールBをリ
ンクします。
これで, 未解決の外部参照シンボルはなくなる
ため, モジュールX, Y, A, Bから成るロードモ
ジュールを作成してリンク処理を終了します。
(注意事項)
July 31, 2015, CM41-00315-6
図中の( )で括ったシンボル名は"参照"を, { }で括ったシンボル名は
"定義"を表します。
75
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7.4
So ft
Manu al
ライブラリファイルが複数の場合の検索例 1
ライブラリファイルが複数の場合の検索例は 2 つあります。このうち 1 つを図 5.7-4
に示し , この図に従って説明します。
■ ライブラリファイルが複数の場合の検索例 1
図 5.7-4 ライブラリファイルが複数の場合の検索例 1
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
+
Y
参照 (S3)
オブジェクトY
Y
参照 (S3)
ライブラリファイル1
シンボルテーブル
{S1} → A
{S2} → B
:
X
参照 (S1)
抽出モジュール
A
定義 {S1}
A
定義 {S1}
C
定義 {S3}
C
定義 {S3}
検索対象のライブラリファイルが複数ある場
合,指定された順にライブラリ検索を行います。
A
定義 {S1}
X, Yモジュールのリンク後, 未解決シンボルの
(S1)と(S3)が残ります。
B
定義 {S2}
ライブラリ1, ライブラリ2の順で検索します。
:
ライブラリファイル2
シンボルテーブル
{S3} → C
:
ライブラリ1の検索で{S1}の定義のあるモ
ジュールAをリンクします。
次に(S3)についてライブラリ1を検索します
が, 見つからないためライブラリ1の検索を終了
し, ライブラリ2を検索します。
{S3}がモジュールCで定義されているため,
このモジュールをリンクします。
(注意事項)
C
定義 {S3}
:
76
図中の( )で括ったシンボル名は"参照"
を, { }で括ったシンボル名は"定義"を
表します。
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
5.7.5
Soft
Ma nual
ライブラリファイルが複数の場合の検索例 2
ライブラリファイルが複数の場合の検索例は 2 つあります。このうち 1 つを図 5.7-5
に示し , この図に従って説明します。
■ ライブラリファイルが複数の場合の検索例 2
図 5.7-5 ライブラリファイルが複数の場合の検索例 2
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
ライブラリファイル1
シンボルテーブル
{S1} → A
{S2} → B
:
A
定義 {S1}
B
定義 {S2}
:
ライブラリファイル2
シンボルテーブル
{S1} → C
:
C
定義 {S1}
:
July 31, 2015, CM41-00315-6
+
抽出モジュール
X
参照 (S1)
A
定義 {S1}
A
定義 {S1}
検索対象のライブラリファイルが複数ある場
合,指定された順にライブラリ検索を行います。
複数のライブラリファイルに同一名の外部シン
ボル含まれているような場合, 先に検索したライ
ブラリ中のモジュールをリンクします。
Xモジュールの未解決シンボル(S1)の解決のた
めに, ライブラリ1, ライブラリ2の順で検索しま
す。
ライブラリ1の検索で{S1}の定義のあるモ
ジュールAをリンクします。
この時点で, 未解決シンボルはなくなったため,
ライブラリの検索は終了します。
この場合, ライブラリ2の検索は行われませ
ん。
(注意事項)
図中の( )で括ったシンボル名は"参照"
を, { }で括ったシンボル名は"定義"を
表します。
77
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7.6
So ft
Manu al
ライブラリファイルが個別に指定された場合の処理
ライブラリファイルが個別に指定された場合の処理を図 5.7-6 に示し , この図に従っ
て説明します。
■ ライブラリファイルが個別に指定された場合の処理
図 5.7-6 ライブラリファイルが個別に指定された場合の処理
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
参照 (S2)
ライブラリファイル1
シンボルテーブル
{S1} → A
{S2} → B
:
A
定義 {S1}
抽出モジュール
C
定義 {S2}
X
参照 (S1)
参照 (S2)
C
定義 {S2}
A
定義 {S1}
A
定義 {S1}
ライブラリファイルが個別に指定された外部参
照シンボルは, ます最初に検索されます。
B
定義 {S2}
ここでは, (S2)シンボルをライブラリ2から取
り込むように指定されたものとします。
:
(S2)についてライブラリ2を検索し, モジュー
ルCをリンクします。
ライブラリファイル2
シンボルテーブル
{S2} → C
:
C
定義 {S2}
:
78
+
(S1)の解決に, ライブラリファイル1を検索
し, モジュールAをリンクします。
ライブラリファイル1中の{S2}は, 検索対象に
なりません。
(注意事項)
・図中の( )で括ったシンボル名は"参照"
を, { }で括ったシンボル名は"定義"を表
します。
・指定されたライブラリに, 検索対象の外部
定義シンボルが見つからなかった場合,
この例のようにほかの検索対象ライブラリ中
に該当するシンボルがあればシンボル解決
が行われるため注意してください。
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.8 ROM/RAM 領域
Support
5.8
Soft
Ma nual
ROM/RAM 領域
組込用のアプリケーション開発では , 使用することのできる ROM および RAM のサ
イズや , アドレス範囲に制約があるものです。
リンク時に , リンカにこの領域を通知しておくことで , サイズオーバや使用できない
アドレスへのセクション配置についてのチェックができます。
セクションの自動配置を行う場合には , この領域指定範囲内に配置します。
■ ROM/RAM 領域の設定とセクション配置
リンカのセクション配置は ,【例 1】に示すようにセクション名 (CODE) と , 配置する
先頭アドレス (0x1000) を指定するといった方法で行います。
【例 1】
-sc CODE=0x1000,DATA=0x0180
セクションの終了アドレスは , リンク結果の出力であるマップリストにより確認す
る必要があります。
本リンカでは , セクション配置の先頭アドレスと終了アドレスを指定することで ,
決められた範囲内に配置されたか否かをチェックする機能を備えています。
まず ,【例 2】に示すように -ro および -ra オプションにより , 配置アドレス範囲を決
めて , 領域名と対応づけます。
【例 2】
-ro CodeA=0x1000/0x3FFF
-ra DataA=0x0180/0x57F
領域名 CodeA は , 0x1000 ~ 0x3FFF のアドレス範囲を示します。
領域名 DataA は , 0x0180 ~ 0x057F のアドレス範囲を示します。
領域名を使用したセクション配置指定は ,【例 3】のようになります。
【例 3】
-sc CODE=CodeA, DATA=DataA
領域名を使用したセクション配置では , 指定したアドレス範囲内に配置されたか否
かをチェックできます。
July 31, 2015, CM41-00315-6
79
第 5 章 リンカの仕様
5.9 ROM → RAM 転送セクション
Su pp or t
5.9
So ft
Manu al
ROM → RAM 転送セクション
C コンパイラを使用したプログラム開発においては初期値付変数が生成され , その変
数の書換えなどの処理を行うことが頻繁にあります。
これらの変数は実行時に書換えられるため , アプリケーション実行時は RAM になく
てはなりません。したがって , 組込み用のプログラムにおいては , 初期値データは
ROM に置き , アプリケーション実行前に RAM へ初期値データを転送しないと使用
できないことになります。
ROM → RAM 転送セクションは , このような使用を可能にするための機能です。
■ ROM → RAM 転送セクション
C コンパイラを使用したプログラム開発においては初期値付変数が生成され , その変数
の書換えなどの処理を行うことが頻繁にあります。
組込み用プログラムでは , 初期値付変数データは ROM に置かれますが , これらの変数
は実行時に書換えられるため,アプリケーション実行時はRAMになくてはなりません。
したがって , アプリケーション実行前に RAM へ初期値データを転送して使用すること
になります。
本リンカでは , このような使用を簡単にするため , ROM → RAM 転送セクションを指
定することで , プログラムの参照アドレスは RAM 上で解決し , 初期値データは ROM
上に配置するしくみをサポートしています。
■ ROM → RAM 転送セクションの使用方法
ROM→RAM転送セクションの指定は, -scオプションを用いて次のように使用します。
初期値付変数がまとめられているセクションを INIT とします。
DATA は , 初期値なし変数のセクションとし , start は , ROM 上の初期値付変数データ
を RAM へ転送するプログラム , CODE は , 実行されるアプリケーションプログラムと
します。
-sc DATA+ INIT =0x1000,start+CODE+ @INIT =0xC000
ここで , 上記のように , RAM 側 (0x1000) に INIT を配置するように指定し , ROM 側
(0xC000) にもセクション名の先頭に @ マークを付加して INIT を配置するように指定
します。
このように配置指定を行うと INIT は ROM → RAM 転送セクションとして処理され , 図
5.9-1 のような配置になり , INIT のアドレス解決は RAM 側で行われ , 初期値データは
ROM 側に配置されます。
80
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.9 ROM → RAM 転送セクション
Support
Soft
Ma nual
図 5.9-1 ROM → RAM 転送セクションの配置例
0x1000
RAM
0xC000
ROM
DATA
INIT
_RAM_INIT (転送先先頭アドレスシンボル)
start
CODE
(INIT)
_ROM_INIT (転送元先頭アドレスシンボル)
このとき , _ROM_INIT や _RAM_INIT のように , ROM → RAM 転送セクションには , そ
れぞれセクションの先頭を示すシンボルが "_ROM_ セクション名 ", "_RAM_ セクショ
ン名 " の規則で自動生成されます。
ユーザは , これらシンボルを , ROM 上の初期値付変数データを RAM へ転送するプロ
グラム内で使用できます。
"_ROM_ セクション名 ", "_RAM_ セクション名 " はリンカの予約シンボルです。プロ
グラム中で定義を行わないでください。詳細は ,「 8.1 リンカの制限事項」を参照して
ください。また , 初期値付変数データの転送プログラム例は ,「 8.2 リンカの使用上の
Q &A」を参照してください。
■ ROM → RAM 転送セクションの注意
ROM → RAM 転送セクションを指定するとセクションの Write 属性が無条件に変更さ
れます。
ROM 側へ配置されたセクションは , Write 属性が不可に変更され , RAM 側へ配置され
たセクションは Write 属性が可に変更されます。
以下のようなプログラムの ROM → RAM 転送セクションを例に説明します。
.program
sample
.section
init, data
val1:
.word
0x1234
val2:
.word
0x5678
.section
Data, data
.res.w
0x1
.section
Prog1, code
movw
A, val1
movw
rw2, A
movw
A, val2
movw
rw3, A
.section
Prog2, code
movw
A, val3
cmpw
A, #0
val3:
.end
July 31, 2015, CM41-00315-6
81
第 5 章 リンカの仕様
5.9 ROM → RAM 転送セクション
Su pp or t
So ft
Manu al
上記プログラムでは , 初期値付変数が記述されているセクション init, 変数領域が記述
されているセクション Data, プログラムコードが記述されているセクション Prog1,
Prog2 があります。
それぞれのセクションについてアセンブル後の実行 , Read, Write の可 / 不可は , 表 5.91 のようになります。
表 5.9-1 アセンブル後の各セクションの属性
セクション名
実行
Read
Write
init
×
○
○
Data
×
○
○
Prog1
○
○
×
Prog2
○
○
×
○ …可 × …不可
ここで , リンク時に , init と Prog1 の ROM → RAM 転送セクション指定を行うと , それ
ぞれのセクションのリンク後の実行 , Read, Write の可 / 不可は , 表 5.9-2 のようになり
ます。
表 5.9-2 リンク後の各セクションの属性
セクション名
init(RAM 側 )
実行
Read
Write
×
○
○
備考
リンカにより用意された ROM 側
のセクション
Write が不可に変更された
init(ROM 側 )
×
○
×
Data
×
○
○
Prog1(RAM側)
○
○
○
Write が可に変更された
Prog1(ROM側)
○
○
×
リンカにより用意された ROM 側
のセクション
Prog2
○
○
×
○ …可 × …不可
82
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.10 DIR 属性セクションの配置について
Support
5.10
Soft
Ma nual
DIR 属性セクションの配置について
F2MC-16 ファミリでは , 複数のダイレクトページの使用が可能です。しかし , コン
パイラの出力したモジュールをリンクする際は注意をしてください。
■ ダイレクトページについて
ダイレクトページは , DIR 属性 セクションを配置するための領域です。
1 つのダイレクトページのサイズは 256 バイトです。
F2MC-16 ファミリでは , 複数のダイレクトページを使用可能です。複数のダイレクト
ページの使用法については , 各チップのハードウェアマニュアルを参照してください。
■ DIR 属性セクションの配置について
DIR 属性 セクションは , 連続して配置する必要があり , 結合された領域は 256 バイト境
界をまたいで配置できません。DIR セクションは , リンク時に以下のように配置されま
す。
● DIR 属性セクション合計サイズが 256 バイト以下の場合
リンカは , DIR 属性 セクションを 1 つのダイレクトページに配置します。
図 5.10-1 DIR 属性セクション合計サイズが 256 バイト以下の場合
0x000
DIRDATA
DIRDATA
+
DIRINIT
ダイレクトページ1
Link
DIRINIT
0x100
DIRDATA+DIRINNIT <
= 256Byte
ダイレクトページ2
0x200
July 31, 2015, CM41-00315-6
83
第 5 章 リンカの仕様
5.10 DIR 属性セクションの配置について
Su pp or t
So ft
Manu al
● 1 つの DIR 属性セクションサイズが 256 バイトを超える場合
1 つの DIR セクションが 256 バイトを超える場合 , リンカはエラー (***E4363L: セク
ションの最大サイズを超えました ( セクション名 )) を出力します。
図 5.10-2 1 つの DIR セクションが 256 バイトを超える場合
0x000
ダイレクトページ1
DIRDATA
×
Link
+
0x100
リンク中断
ダイレクトページ2
DIRINIT
0x200
DIRDATA > 256Byte
DIRDATAセクションが256バイトを超えたため,リンク
時にエラー(***E4363:セクションの最大サイズを
超えました (DIRDATA))を出力します。
● 各DIR属性セクションが256バイト以下でかつDIRセクション合計が256バイトを超える場合
リンカは , DIR 属性セクションをダイレクトページに収まるように (256 バイト境界を
またがないように ) 複数のダイレクトページに配置します。
図 5.10-3 各 DIR 属性セクションが 256 バイト以下でかつ DIR セクション合計が 256 バイトを超え
る場合
0x000
DIR_
1
DIRDATA
DIRDATA
ダイレクトページ1
+
Link
0x100
DIRINIT
DIRINIT
ダイレクトページ2
DIRDATA+DIRINIT > 256Byte
かつ
DIRDATA <
= 256Byte
DIRINIT <
= 256Byte
0x200
256バイト境界をまたがないように複数
のダイレクトページに配置します。
84
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.10 DIR 属性セクションの配置について
Support
Soft
Ma nual
■ DIR 属性セクション合計サイズチェックについて
コンパイラは , DIR 属性セクションが 1 つのダイレクトページに配置されることを前提
に処理を行います。
図 5.10-3 の場合 , DIR 属性セクションがアクセスできない領域に配置されることにな
ります ( 図 5.10-3 では DIRINIT ができなくなります )。
リンカには , DIR 属性セクションの合計サイズが 256 バイトを超えた場合警告を出力す
る機能があります。
(「6.2.48 DIR 属性セクション合計サイズチェック指定 (-check_dirsize)」参照 )
警告が出力された場合 , DIR 属性セクションの合計サイズが 256 バイト以下になるよう
ソースを修正してください。
<注意事項>
以下のような場合 , DIR 属性セクションの合計サイズが 256 バイトを超えても問題ありま
せん。
• アセンブラソースにおいて複数のダイレクトページを使用している場合
• リアルタイム OS のタスクごとに異なったダイレクトページを使用している場合
DIR 属性セクションの合計サイズが 256 バイトを超えても問題ない場合 , DIR セクション
合計サイズのチェックは抑止できます (「6.2.49 DIR 属性セクション合計サイズチェック
抑止指定 (-Xcheck_dirsize)」参照 )。
July 31, 2015, CM41-00315-6
85
第 5 章 リンカの仕様
5.11 CPU 情報ファイル
Su pp or t
5.11
So ft
Manu al
CPU 情報ファイル
リンカは , -cpu オプションから CPU を特定し , CPU 情報ファイルから ROM/RAM
領域を自動的に設定します。
■ CPU 情報ファイル
リンカは , -cpu オプションから CPU を特定し , CPU 情報ファイルから該当するチップ
の情報を抽出し , ROM/RAM 領域を自動的に設定します。
■ ROM/RAM 領域名
リンカは , ROM/RAM 領域を以下の名前で設定します。
• ROM 領域の場合 : _ROM_*_
- 上記 * には , 低位アドレスの領域順に 1 から順番に番号が入ります。領域が 1 つ
しかない場合は , "_ROM_1_" となります。
• RAM 領域の場合 : _RAM_*_
- 上記 * には , 低位アドレスの領域順に 1 から順番に番号が入ります。領域が 1 つ
しかない場合は , "_RAM_1_" となります。
これらの名前は , -sc オプションで使用可能です。
■ CPU 情報ファイル名
以下に , CPU 情報ファイル名と検索ディレクトリを示します。
● CPU 情報ファイル名
• 907.csv
● 検索ディレクトリ
• %FETOOL% \ LIB\907
■ 内蔵 ROM/RAM 領域自動設定の抑止指定
リンカは , デフォルトで -cpu オプションから CPU を特定し , CPU 情報ファイルから該
当するチップの情報を抽出し , ROM/RAM 領域を自動的に設定します。
本機能を抑止したい場合は , -Xset_rora オプションを指定します。
<注意事項>
CPU 情報ファイルが見つからない場合または CPU 情報ファイル内に該当 MB 番号の情報
が存在しない場合 , リンカはエラーを出力します。
86
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.12 リンカでのオブジェクト混在
Support
5.12
Soft
Ma nual
リンカでのオブジェクト混在
リンカ (flnk907s) では , -cpu オプションで指定したターゲット CPU が上位互換
CPU の場合に , 下位 CPU 用に作られたオブジェクトやライブラリの混在が可能で
す。
■ オブジェクト混在
リンカ (flnk907s) では , -cpu オプションで指定したターゲット CPU が上位互換の場合
に , 下位 CPU 用に作られたオブジェクトやライブラリの混在が可能です。
リンカは , -w オプションで 2 が指定されているときのみ , オブジェクトの混在が起こっ
た場合にインフォメーションを出力します。
■ -cpu オプションとオブジェクト混在可能 CPU 一覧
表 5.12-1 に , -cpu オプションと混在可能な下位 CPU 用のオブジェクト , ライブラリを
示します。
表 5.12-1 -cpu オプションとオブジェクト混在可能 CPU 一覧
オブジェクト / ライブラリ作成時の -cpu オプション
リンク時の -cpu オプション指定
F2MC-16L/16/16H
F2MC-16LX
F2MC-16FX
F2MC-16F
F2MC-16L/16/16H の CPU
◎
×
×
×
F2MC-16LX の CPU
○
◎
○
×
F2MC-16FX の CPU
○
○
◎
×
F2MC-16F の CPU
○
○
○
◎
◎ : 同一ターゲットです。混在ではありません。
○: 混在可能ですが,リンカは, -wオプションで2が指定された場合にイン フォメーションを出力します。
× : 混在できません。リンカはエラーを出力します。
July 31, 2015, CM41-00315-6
87
第 5 章 リンカの仕様
5.13 リンカでの関数呼び出しインタフェースの異なるオブ
ジェクトの混在について
Su pp or t
5.13
So ft
Manu al
リンカでの関数呼び出しインタフェースの異なるオブ
ジェクトの混在について
ここでは , リンカでの関数呼び出しインタフェースの異なるオブジェクトの混在に
ついて説明します。
■ リンカでの関数呼び出しインタフェースの異なるオブジェクトの混在
F2MC-16 ファミリでは , 以下のような関数呼び出しインタフェースをサポートしてい
ます。
• 引数のスタック渡し ( 従来の関数呼び出しインタフェース )
• 引数のレジスタ (RW0, RW1) 渡し
引数のレジスタ 渡しのオブジェクトと引数のスタック渡しのオブジェクトとでは引数
の受け渡し方法とレジスタの使用方法が異なります。そのため , 関数呼び出しインタ
フェースの異なるオブジェクトを混在して使用するとプログラムが正しく動作しませ
ん。
リンカでは , 引数のスタック渡しのオブジェクトと引数のレジスタ 渡しのオブジェク
トは , ターゲット CPU が同じでも混在できません。
関数呼び出しインタフェースの異なるオブジェクトが混在していた場合 , リンカはエ
ラーを出力し処理を中断します。
(*** E4313L : 関数呼び出しインタフェースの異なるモジュールがあります ( ファイル
名 ))
関数呼び出しインタフェースが同じ場合 , 従来どおりターゲット CPU によるオブジェ
クト混在チェックを行います。ターゲット CPU によるオブジェクト混在チェックは ,
「5.12 リンカでのオブジェクト混在」を参照してください。
88
CM41-00315-6, July 31, 2015
第 5 章 リンカの仕様
5.14 未使用関数削除
Support
5.14
Soft
Ma nual
未使用関数削除
未使用関数削除機能は , 使用しない関数のオブジェクトコードを削除して ROM 使用
量を削減するための機能です。
■ 未使用関数とは
未使用関数とは , プログラムの動作上一度も参照されない関数を指します。
【例】未使用関数の例
main.c
void main(void)
{
func1();
func3();
}
void func1(void)
{
func4();
}
void func2(void)
{
func8();
}
module1.c
void func3(void)
{
func7();
}
void func4(void)
{
}
void func5(void)
{
}
void func6(void)
{
}
module2.c
void func7(void)
{
func5();
}
void func8(void)
{
func6();
}
上記構成プログラムの場合 , 以下の関数が未使用関数です。
• func2()
• func6()
• func8()
■ 未使用関数削除機能
未使用関数削除機能は , 使用しない関数のオブジェクトコードを削除して ROM 使用量
を削減するための機能です。
未使用関数削除機能は , 以下のように未使用関数のオブジェクトコードを削除します。
1. -K LNKOPT オプションを指定して , C ソースをコンパイルします。
リンク時に未使用関数を抽出するための情報を未使用関数削除情報ファイル (ufi
ファイル ) に出力します。
リンカが関数を削除できるように , CODE セクションを関数単位に分割します。
2. コンパイラが出力した ufi ファイルを解析し , 未使用関数を抽出します。
3. 2. で未使用関数と判定された関数の CODE セクションを削除します。
July 31, 2015, CM41-00315-6
89
第 5 章 リンカの仕様
5.14 未使用関数削除
Su pp or t
90
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第6章
リンカのオプション
リンカの各オプションについて詳しく説明します。
6.1 リンカのオプション一覧
6.2 リンカのオプション詳細
July 31, 2015, CM41-00315-6
91
第 6 章 リンカのオプション
6.1 リンカのオプション一覧
Su pp or t
6.1
So ft
Manu al
リンカのオプション一覧
リンカの動作を細かく指示するために , オプションがあります。
■ リンカのオプション一覧
リンカのオプション一覧を , 表 6.1-1 に示します。
表 6.1-1 リンカのオプション一覧 (1 / 3)
機能
入出力 出力ロード
制御
モジュールに
オプ
関する指定
ション
出力リストに
関する指定
-o
デバッグ情報出力指定
-g
デバッグ情報削除指定
-Xg
デフォルト
絶対形式ロードモジュール出力指定
-a
デフォルト
相対形式ロードモジュール出力指定
-r
ROM 領域のフィル指定
-fill
マップリストファイル名指定
-m
マップリスト出力抑止指定
-Xm
リスト表示の名前省略解除
-dt
92
デフォルト
デフォルト
-mmi
リスト行の桁数指定
-pw
デフォルト 132
リスト 1 ページの行数指定
-pl
デフォルト 60
ROM 領域のチェックサム指定
-cs
出力メッセージ 警告メッセージ出力レベル指定
に関する指定
ライブラリ制御
オプション
備考
出力ロードモジュールファイル名指定
メモリ使用情報リストの 出力指定
配置 / 結合オプション
オプション
-w
ROM 領域指定
-ro
RAM 領域指定
-ra
セクション配置
-sc
セクショングループ指定
-gr
レジスタバンク領域の指定
-rg
自動配置指定
-AL
検索ライブラリファイル指定
-l
ライブラリ検索パス指定
-L
シンボル個別のライブラリ指定
-el
ライブラリ検索抑止指定
-nl
デフォルトライブラリ検索抑止指定
-nd
デフォルト 0
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.1 リンカのオプション一覧
Support
Soft
Ma nual
表 6.1-1 リンカのオプション一覧 (2 / 3)
機能
未使用関数削除機能
関連オプション
その他のリンク制御
オプション
未使用関数削除指定
-lnkopt
C ソース実行開始シンボル指定
-entryc
削除対象外関数指定
-Xdel
未使用関数削除情報ファイル格納パス指定
-ufiin
エントリアドレス指定
-e
外部シンボル値の仮設定
-df
ターゲット CPU 指定
-cpu
CPU 情報ファイル指定
-cif
デバッグ情報存在チェック抑止指定
内蔵 ROM/RAM 領域の自動設定
-set_rora
-Xset_rora
ユーザ指定領域のチェック指定
-check_rora
ユーザ指定領域のチェック抑止指定
-Xcheck_rora
セクション配置領域チェック指定
-check_locate
セクション配置領域チェック抑止指定
-Xcheck_locate
ユーザ指定外セクションのチェック指定
-check_section
スタンバイモード遷移命令チェック指定
スタンバイモード遷移命令チェック抑止指定
備考
デフォルト
_main
必須
-NCI0302LIB
内蔵 ROM/RAM 領域自動設定の抑止指定
ユーザ指定外セクションのチェック抑止指定
デフォルト
デフォルト
デフォルト
-Xcheck_section
デフォルト
-check_SCF
デフォルト
-Xcheck_SCF
フェッチ単位チェックの指定
-Wf
引数のレジスタ渡し用ロードモジュール出力指定
-rp
引数のスタック渡し用ロードモジュール出力指定
-Xrp
デフォルト
-check_dirsize
デフォルト
DIR 属性 セクション合計サイズチェック指定
DIR 属性 セクション合計サイズチェック抑止指定
-Xcheck_dirsize
サイズ 0 のセクション配置チェック指定
-check_size0_sec
サイズ 0 のセクション配置チェック抑止指定
July 31, 2015, CM41-00315-6
オプション
-Xcheck_size0_sec デフォルト
93
第 6 章 リンカのオプション
6.1 リンカのオプション一覧
Su pp or t
So ft
Manu al
表 6.1-1 リンカのオプション一覧 (3 / 3)
機能
絶対形式アセンブル
リスト出力関連
オプション
相対アセンブルリスト入力ディレクトリ指定
-alin
絶対アセンブルリスト出力ディレクトリ指定
-alout
絶対アセンブルリスト出力指定
-als
絶対アセンブルリスト出力モジュール指定
-alsf
絶対アセンブルリスト出力抑止指定
-Xals
ROM/RAM, ARRAY リスト出力指定
-alr
ROM/RAM, ARRAY リスト出力モジュール指定
-alrf
ROM/RAM, ARRAY リスト出力抑止指定
-Xalr
ROM/RAM, ARRAY リストのシンボルとアドレス
の表示位置指定
オブジェクト内容
リスト出力関連
オプション
共通オプション
-xl
外部シンボル相互参照情報リストファイル名指定
-xlf
外部シンボル相互参照情報リスト出力抑止指定
-Xxl
ローカルシンボルリスト出力指定
-sl
ローカルシンボルリストファイル名の指定
-slf
ローカルシンボルリスト出力抑止指定
-Xsl
セクション詳細マップリスト出力指定
-ml
セクション詳細マップリストファイル名の指定
-mlf
セクション詳細マップリスト出力抑止指定
-Xml
デフォルトオプションファイル読み込み抑止指定
-Xdof
-f
ヘルプメッセージ表示指定
-help
版数 / メッセージ出力指定
-V
版数 / メッセージ出力抑止
-XV
終了メッセージ表示指定
終了メッセージ表示抑止指定
備考
-na/-an
外部シンボル相互参照情報リスト出力指定
オプションファイル読み込み指定
94
オプション
デフォルト
-cmsg
-Xcmsg
ワーニング発生時の終了コードを 1 にする指定
-cwno
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
デフォルト
デフォルト
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2
Soft
Ma nual
リンカのオプション詳細
ここでは , リンカの各オプションについて説明します。
なお , リンケージキットで共通のオプションは ,「第 3 章 共通オプション」で説明
しています。
■ 出力モジュールに関するオプション
出力モジュールに関するオプションの詳細を「6.2.1 出力ロードモジュールファイル名
指定 (-o)」~「6.2.6 ROM 領域のフィル指定 (-fill)」で説明します。
■ 出力リストに関するオプション
出力リストに関するオプションの詳細を「6.2.7 マップリストファイル名の指定 (-m)」~
「6.2.13 ROM 領域のチェックサム指定 (-cs)」で説明します。
■ 出力メッセージに関する指定
出力メッセージに関するオプションの詳細を「6.2.14 警告メッセージ出力レベルの指
定 (-w)」で説明します。
■ 配置 / 結合オプション
配置 / 結合に関するオプションの詳細を「6.2.15 ROM 領域の指定 (-ro)」~「6.2.20 自
動配置指定 (-AL)」で説明します。
■ ライブラリ制御オプション
ライブラリ制御オプションの詳細を「6.2.21 検索ライブラリファイルの指定 (-l)」~
「6.2.25 デフォルトライブラリ検索の抑止指定 (-nd)」で説明します。
■ 未使用関数削除機能関連オプション
未使用関数削除機能関連オプションの詳細を「6.2.26 未使用関数削除指定 (-lnkopt)」~
「6.2.29 未使用関数削除情報ファイル格納パス指定 (-ufiin)」で説明します。
■ その他のリンク制御オプション
その他のリンク制御に関するオプションの詳細を「6.2.30 エントリアドレスの指定 (-e)」~
「6.2.51 サイズ 0 のセクション配置チェック抑止指定 (-Xcheck_size0_sec)」で説明しま
す。
■ 絶対形式アセンブルリスト出力関連オプション
絶対形式アセンブルリスト出力に関するオプションの詳細を「6.2.52 相対アセンブル
リスト入力ディレクトリ指定 (-alin)」~「6.2.60 ROM/RAM, ARRAY リストのシンボ
ルとアドレスの表示位置指定 (-na, -an)」で説明します。
■ オブジェクト内容リスト出力関連オプション
オブジェクト内容リスト出力に関するオプションの詳細を「6.2.61 外部シンボル相互
参照情報リスト出力指定 (-xl)」~「6.2.69 セクション詳細マップリスト出力抑止指定
(-Xml)」で説明します。
July 31, 2015, CM41-00315-6
95
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.1
So ft
Manu al
出力ロードモジュールファイル名指定 (-o)
リンク結果のロードモジュールファイル名を指定します。このオプションが指定さ
れないときは , 最初に入力したファイル名から出力ファイル名を作ります。
■ 出力ロードモジュールファイル名指定 (-o)
【記述形式】
-o
< ロードモジュールファイル名 >
( デフォルト )
【パラメータ】
< ロードモジュールファイル名 >
出力ロードモジュールファイル名です。
【説明】
リンク結果の出力ロードモジュールファイル名を指定します。
本オプション指定がない場合は , リンカが最初に入力したファイル名をもとに , リ
ンクモードに応じた拡張子を付加した名称で出力ファイルを作ります。
リンクモード
デフォルト拡張子
絶対形式出力 (-a オプション )
.abs
相対形式出力 (-r オプション )
.rel
< ロードモジュールファイル名 > の指定で拡張子を省略した場合も , リンクモードの違
いにより同様の拡張子が付加されます。
【例 1】
flnk907s putc.obj,getc.obj
ファイル名 putc.abs でロードモジュールファイルを作成します。
【例 2】
flnk907s *.obj -o outfile
ファイル名 outfile.abs でロードモジュールファイルを作成します。
この例のように , 入力オブジェクトファイル指定にワイルドカードを使用する場合
には , 本オプションを使用して出力ファイル名を明確にしておくことをお勧めしま
す。
【例 3】
flnk907s *.obj -o outfile.
ファイル名 outfile. でロードモジュールファイルを作成します。
ファイル名の最後にピリオドがある場合は , 拡張子ありとみなします。
【例 4】
flnk907s *.obj -r -o outfile.rel
ファイル名 outfile.rel で相対形式ロードモジュールファイルを作成します。
96
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.2
Soft
Ma nual
デバッグ情報の出力指定 (-g)
C コンパイラやアセンブラで , デバッグ情報の出力指定をして作られたオブジェクト
モジュールには , デバッガで利用するためのデバッグ情報が含まれています。
デバッグ情報をリンク後も継承して使用するためには , -g オプションを指定します。
■ デバッグ情報の出力指定 (-g)
【記述形式】
-g
【パラメータ】
なし
【説明】
リンカは , 入力するオブジェクトモジュールファイルまたは相対形式ロードモ
ジュールファイルにデバッグ情報が含まれている場合 , デフォルト出力ではデバッ
グ情報を削除します。
出力ロードモジュールファイル中にデバッグ情報を残したい場合に , 本オプション
を使用します。
リンカは , デバッグ情報を新たに作り出すことはありませんので , 入力ファイルに
デバッグ情報が含まれていない場合は , 指定することに意味はありません。
デバッグ時にシンボリックデバッグを行いたい場合には , C コンパイラ~アセンブ
ラ~リンカのすべてのツールで -g オプションの指定をしてください。
【例】
flnk907s -f rllnk.opt b1 b2
図 6.2-1 デバッグ情報の出力指定例
rllnk.opt
-r
-g
-pw 100
-o rel1.rel
July 31, 2015, CM41-00315-6
# relocatable LM output
# debug info.
# page width
# output filename
97
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.3
So ft
Manu al
デバッグ情報の削除指定 (-Xg)
C コンパイラやアセンブラで , デバッグ情報の出力指定をして作られたオブジェクト
モジュールには , デバッガで利用するためのデバッグ情報が含まれています。
デバッグ情報をリンク後に取り去るためには , -Xg オプションを指定します。または ,
-g オプションの指定を行わないようにします。
■ デバッグ情報の削除指定 (-Xg)
【記述形式】
( デフォルト )
-Xg
【パラメータ】
なし
【説明】
リンカは , 入力するオブジェクトモジュールファイルまたは相対形式ロードモ
ジュールファイルにデバッグ情報が含まれている場合 , デフォルト出力ではデバッ
グ情報を削除しますので , 本オプションを指定する必要はありません。
オプションファイルを利用したリンクにおいて , オプションファイル中に -g オプ
ションがある場合など , -g オプションを無効にするときに使用します。
【例】
flnk907s -f rllnk.opt a1 a2 a3 -Xg -o a123.rel
図 6.2-2 デバッグ情報の削除指定例
rllnk.opt
-r
-g
-pw 100
-o rel1.rel
98
# relocatable LM output
# debug info.
# page width
# output filename
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.4
Soft
Ma nual
絶対形式ロードモジュールの出力指定 (-a)
-a オプションは , リンカの最終目的ファイルである , 絶対形式のロードモジュールを
作成することを指示するオプションです。
■ 絶対形式ロードモジュールの出力指定 (-a)
【記述形式】
( デフォルト )
-a
【パラメータ】
なし
【説明】
絶対形式のロードモジュールファイル出力を指示します。
リンカのデフォルト出力は絶対形式ですので , 通常使用することはありません。
-r オプション指定を打ち消し -a 指定に変更する場合に指定します。
絶対形式の出力ファイルは , 以下の名前で作成されます。
• -o オプション指定がないとき : 最初に指定された入力ファイルの拡張子を ".abs"
とした名称
• -o オプション指定があるとき : 指定された名称。拡張子指定がないときは , ".abs"
を付加した名称
【例】
flnk907s a1 a2 a3 -r -o a123.abs -a
コマンドラインの途中の -r オプションを無効にします。
出力ロードモジュールファイルは , 絶対形式で作成されます。
July 31, 2015, CM41-00315-6
99
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
相対形式ロードモジュールの出力指定 (-r)
6.2.5
-r オプションは , 再入力可能な相対形式ロードモジュールを作成することを指示する
オプションです。相対形式のロードモジュールは , アドレス解決を行わないで複数の
モジュールを 1 つのファイルにまとめた形式を持っています。
■ 相対形式ロードモジュールの出力指定 (-r)
【記述形式】
-r
【パラメータ】
なし
【説明】
相対形式のロードモジュールファイル出力を指示します。
リンカのデフォルト出力 ( 絶対形式 ) を変更するときに指定します。
-a オプションのあとに -r オプションを指定すると , -a オプションを無効にすること
ができます。
-AL オプションの指定は 0 または -AL の指定なしにしてください。詳しくは「6.2.20
自動配置指定 (-AL)」を参照してください。
相対形式のロードモジュールは , アドレス解決を行わないで複数のオブジェクトモ
ジュールを 1 つのファイルにまとめた形式です。リンカへの再入力が可能であり ,
以降のリンク処理で指定する入力ファイル数を少なくできることが利点ですが , こ
の中のモジュールに変更が生じた場合には , ライブラリ形式ファイルと異なり差し
替えることはできません。
このオプションが指定された場合 , 絶対形式アセンブルリスト , オブジェクト内容
リストに関するオプションはすべて無視され,それらのファイルは出力されません。
出力ファイルは , 以下の名前で作成されます。
• -o オプション指定がないとき :最初に指定された入力ファイルの拡張子を ".rel"と
した名称
• -o オプション指定があるとき : 指定された名称。拡張子指定がないときは , ".rel"
を付加した名称
【例】
flnk907s a1 a2 a3 -r -o a123.rel
リンカの出力オブジェクトを相対形式にします。
<注意事項>
最初に指定された入力ファイルが , 拡張子 ".rel" であるとき , 出力ファイル名が同じになり
ます。この場合 , 入力ファイルの内容は保存されませんので , 不都合が有る場合には , -o
オプションで出力ファイル名の指定をしてください。
100
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.6
Soft
Ma nual
ROM 領域のフィル指定 (-fill)
-fill オプションは指定した領域を指定した値で埋めるオプションです。
■ ROM 領域のフィル指定 (-fill)
【記述形式】
-fill < スタートアドレス >/< エンドアドレス >,< フィル値 >[/< ビット幅 >]
[/< エンディアン >]
【パラメータ】
< スタートアドレス >
値を埋める領域の開始アドレスを指定します。このパラメータは省略できません。
< エンドアドレス >
値を埋める領域の終了アドレスを指定します。このパラメータは省略できません。
< フィル値 >
スタートアドレスとエンドアドレスで指定した領域 ( 以下 , フィル領域とよぶ ) の
オブジェクトデータがない箇所を埋める値を指定します。このパラメータは省略で
きません。
< ビット幅 >
フィル値のビット幅は 8,16 または 32 のどれかを指定します。このパラメータは省
略できます。
省略時のビット幅は 8 です。
8: 8 ビット
16: 16 ビット
32: 32 ビット
< エンディアン >
フィル値のエンディアンを B または L で指定します。このパラメータは省略できま
す。省略時のエンディアンは L です。
B: ビッグエンディアン
L: リトルエンディアン
【説明】
フィル領域のオブジェクトデータがない箇所を指定したフィル値で埋めます。値を
埋める領域が複数ある場合 ,-fill オプションを複数指定してください。値を埋める領
域が重複した場合 , 重複した領域は後に指定した -fill オプションのフィル値で埋め
られます。
-cs オプションの値を埋める領域と -fill オプションの値を埋める領域が重複した場
合 , 重複した領域は常に -fill オプションのフィル値で埋められます。
本オプションは,絶対形式ロードモジュール作成時に有効となります。相対形式ロー
ドモジュール作成時は , 以下の警告メッセージが出力され , 本オプションの指定は
無視されます。
[ 警告メッセージ ]
*** W1321L: REL モード時には (-fill) オプションは無視されます。
July 31, 2015, CM41-00315-6
101
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例】
以下のような指定を行った場合,各領域は図 6.2-3 のようにフィル値で埋められます。
flnk907s -fill 0xFD0000/0xFEFFFF,0x0055AAFF/32/
B -fill 0xFF0000/0xFFFFFF,0x1234/16/L
-fill 0xFF8000/0xFFFFFF,0x5678/16/B
図 6.2-3 フィル領域指定例
flnk907s
-fill 0xFD0000/0xFEFFFF,0x0055AAFF/32/B ①
-fill 0xFF0000/0xFFFFFF,0x1234/16/L
②
-fill 0xFF8000/0xFFFFFF,0x5678/16/B
③
フィル領域
フィル領域配置イメージ
0xFD0000
①で指定したフィル値で埋められます。
①の指定領域 (0x00,0x55,0xAA,0xFF,0x00,
0x55,0xAA,00xFF,・・・)
①の指定領域
0xFEFFFF
0xFF0000
0xFF7FFF
0xFF8000
②の指定領域
②の指定領域
③の指定領域
0xFFFFFF
②で指定したフィル値で埋められます。
(0x34,0x12,0x34,0x12,・・・)
③で指定したフィル値で埋められます。
③の指定領域 (0x56,0x78,0x56,0x78,・・・)
②と③のフィル対象領域は重なっています。
③のフィル領域指定が②より後に行われているため,
重なっている領域は③で指定したフィル値で埋められます。
オブジェクトデータと値を埋める領域が重なる場合 , 図 6.2-4 のように , 各領域がフィ
ル値で埋められた後 , オブジェクトデータが配置されます。
図 6.2-4 最終的なオブジェクトデータ
セクション配置前のオブジェクトデータ
セクション配置後のオブジェクトデータ
0xFD0000
フィル領域配置後にセクションを
配置されます。
オブジェクトデータ
オブジェクトデータ
0xFEFFFF
0xFF0000
0xFF7FFF
0xFF8000
オブジェクトデータ
オブジェクトデータ
0xFFFFFF
102
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.7
Soft
Ma nual
マップリストファイル名の指定 (-m)
リンカが出力するマップリストファイルのファイル名を指定します。
このオプションが指定されないときは , 出力ロードモジュールファイル名からファイ
ル名を作ります。
■ マップリストファイル名の指定 (-m)
【記述形式】
-m < マップリストファイル名 >
( デフォルト )
【パラメータ】
< マップリストファイル名 >
出力マップリストファイル名パラメータは省略できません。
【説明】
リンカは , デフォルトでマップリストファイルを出力します。このとき , 出力ロー
ドモジュールファイルの拡張子を , ".mp1" とした名称のファイルが作られます。
-m オプションは , デフォルトのマップリストファイル名を変更したいときに使用し
ます。
-Xm オプションの後に -m オプションを指定すると , -Xm オプションを無効にする
ことができます。
【例】
flnk907s a1 a2 a3 -r -o a123.rel -m a123.map
リンカが出力するマップリストファイル名を a123.map にします。
July 31, 2015, CM41-00315-6
103
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.8
So ft
Manu al
マップリスト出力の抑止指定 (-Xm)
リンカにマップリストファイルを出力しないことを指示します。このオプションを
指定しないときは , 必ずマップリストファイルが作成されます。
■ マップリスト出力の抑止指定 (-Xm)
【記述形式】
-Xm
【パラメータ】
なし
【説明】
マップリストファイルの出力の抑止を行います。
-m オプションの後に -Xm オプションを指定すると , -m オプションを無効にするこ
とができます。
-Xm オプションの指定により , -dt, -pw, -pl オプションは無効になります。
【例】
flnk907s a1 a2 a3 -r -o a123.rel -Xm
マップリストファイルの作成は行わないようにします。
104
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.9
Soft
Ma nual
リスト表示の名前の省略解除 (-dt)
リンカのマップリスト , オブジェクト内容リストには , セクション名やシンボル名な
ど名前の表示がありますが , デフォルトでのリスト出力では見やすさを考慮して , 長
い名前は途中までを表示するようにしています。
このオプションは , 名前を省略せずに出力することを指示します。
マップリストの表示フォーマットについては ,「 7.2 リンクリストファイル」を参照
してください。
■ リスト表示の名前の省略解除 (-dt)
【記述形式】
-dt
【パラメータ】
なし
【説明】
マップリスト , オブジェクト内容リストで表示されるシンボル名およびセクション
名を途中で省略せずに表示します。この場合 , 1 つのシンボル名 , セクション名は数
行に渡って表示されます。
デフォルト出力では 80 文字程度の表示ができますが , リスト 1 行の表示桁数を小さ
な値に設定したときに表示可能な文字数も減りますので , シンボル名およびセク
ション名の省略表示が起こりえます。
【例】
flnk907s a1 a2 a3 -o a123.abs -m a123.map -dt
使用されているシンボル名およびセクション名は , 省略することなくリストに表示
します。
July 31, 2015, CM41-00315-6
105
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
メモリ使用情報リストの出力指定 (-mmi)
6.2.10
リンカが出力するマップリストファイルの中にメモリ使用情報を出力するように指
示します。
■ メモリ使用情報リストの出力指定 (-mmi)
【記述形式】
-mmi
【パラメータ】
なし
【説明】
リンカが , デフォルトで出力するマップリストファイルの中に , オプションで指定
された ROM 領域と RAM 領域の使用状況を示すメモリ使用情報リストを出力しま
す。
使用可能領域 , 使用した領域や領域内ギャップの位置とサイズ等の情報を表示しま
す。
【例】
flnk907s l0mp00 im_lnk -mmi -ra RAM1=0x1000/0x1FFF,
RAM2=0x2000/0x23FF
-ro ROM1=0xBC000/0xBCFFF,ROM2=0xBD000/0xBFFFF -AL 2
<注意事項>
-mmi が指定されていても , 以下の場合は出力を行いません。
• メモリ領域の設定がない (-ra, -ro の指定がない )。
• マップリストファイルの出力が有効になっていない。
106
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
リスト行の桁数指定 (-pw)
6.2.11
リンカ出力のマップリスト , オブジェクト内容リストは , デフォルトでは 1 行に 132
桁までを表示します。このオプションは , 1 行の表示桁数を変更するときに指定しま
す。
■ リスト行の桁数指定 (-pw)
【記述形式】
-pw < 桁数 >
( デフォルト : 132)
【パラメータ】
< 桁数 >
1 行に表示する桁数。70 ~ 1023 の範囲で指定します。
【説明】
リンクリストファイル , オブジェクト内容リストの 1 行の長さの指定を行います。
この指定がない場合は , 132 桁になります。
【例】
flnk907s a1 a2 a3 -o a123.abs -m a123.map -dt -pw 80
リスト行の表示桁数を 80 にします。
<注意事項>
以下のリストは -pw オプションで 1 行の桁数を指定できます。
• リンクマップリスト (.mp1)
• セクション詳細マップリスト (.mpm)
以下のリストは -pw オプションで 1 行の桁数を指定できません。
• 絶対形式アセンブルリスト (.als)
• 外部シンボル相互参照情報リスト (.mpx)
• ローカルシンボル情報リスト (.mps)
July 31, 2015, CM41-00315-6
107
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
リスト 1 ページの行数指定 (-pl)
6.2.12
リンカ出力のマップリスト , オブジェクト内容リストは , デフォルトでは 1 ページに
60 行までを表示します。
このオプションは , 1 ページの表示行数を変更するときに指定します。
■ リスト 1 ページの行数指定 (-pl)
【記述形式】
-pl < 行数 >
( デフォルト : 60)
【パラメータ】
< 行数 >
1 ページに表示する行数。0 または 20 ~ 255 の範囲で指定します。
【説明】
リンクリストファイル , オブジェクト内容リストの 1 ページの行数の指定を行いま
す。
この指定がない場合は 60 行となります。
0 の指定は , ページ制御を行わないようにするものです。
【例】
flnk907s a1 a2 a3 -o a123.abs -m a123.map -dt -pl 64 -pw 100
リスト 1 ページの表示行数を 64 にします。
<注意事項>
以下のリストは -pl オプションで 1 ページの行数を指定できます。
• リンクリスト (.mp1)
• セクション詳細マップリスト (.mpm)
以下のリストは -pl オプションで 1 ページの行数を指定できません。
• 絶対形式アセンブルリスト (.als)
• 外部シンボル相互参照情報リスト (.mpx)
• ローカルシンボル情報リスト (.mps)
108
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.13
Soft
Ma nual
ROM 領域のチェックサム指定 (-cs)
-cs オプションは , 指定した領域のチェックサム演算を行い , 結果をマップリストに
出力するオプションです。
チェックサムの演算方法には , 単純加算 (SUM) と巡回冗長検査 (CRC) があります。
■ ROM 領域のチェックサム指定 (-cs)
【記述形式】
-cs < スタートアドレス >/< エンドアドレス >[,< スタートアドレス >/< エンドアドレス >,•••],
< チェックサム演算方法 >[,< フィル値 >]
【パラメータ】
< スタートアドレス >
チェックサム演算の領域の開始アドレスを指定します。このパラメータは省略でき
ません。
< エンドアドレス >
チェックサム演算の領域の終了アドレスを指定します。このパラメータは省略でき
ません。
< チェックサム演算方法 >
チェックサム演算の方法はSUM16, SUM32, CRC16 またはCRC32 のどれかを指定し
ます。このパラメータは省略できません。
SUM16: 16 ビット単純加算
SUM32: 32 ビット単純加算
CRC16: 16 ビット巡回冗長検査
CRC32: 32 ビット巡回冗長検査
SUM16 または SUM32 を指定した場合 , 補数形式として 0, 1 または 2 のどれかを =
に続けて指定できます。省略時の補数形式は 0 です。
0:補数なし
1:1 の補数
2:2 の補数
CRC16 または CRC32 を指定した場合 , 生成多項式値を = に続けて指定できます。省
略時の生成多項式値は以下のとおりです。
CRC16 の場合 : 0x8005(CRC-ANSI)
CRC32 の場合 : 0x04C11DB7(CRC-32 ITU-T)
< フィル値 >
スタートアドレスとエンドアドレスで指定した領域 ( 以下 , チェックサム演算領域
とよぶ ) のオブジェクトデータがない箇所を埋めるフィル値を指定します。このパ
ラメータは省略できます。省略時のフィル値は 0xff です。
July 31, 2015, CM41-00315-6
109
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【説明】
チェックサム演算領域に対して , 指定した演算方法によるチェックサム演算を行い
ます。結果はマップファイルに出力されます。このとき , チェックサム演算領域の
オブジェクトデータがない箇所は , チェックサム演算の前にフィル値で埋められま
す。
マ ッ プ フ ァ イ ル へ の 出 力 例 を 図 6.2-5 に 示 し ま す。図 中 の S_Addr., E_Addr.,
Algorithm および Value は , それぞれスタートアドレス , エンドアドレス , チェック
サム演算方法およびチェックサム演算の結果に該当します。
図 6.2-5 マップファイルへの出力例
Check Sum(s)
S_Addr.
-E_Addr.
0x00FF0000-0x00FFFFFF
Algorithm
SUM32=1
Value
0x92DA8F5B
複数の領域をまとめてチェックサム演算する場合は, 1 つの-cs オプションに複数の
領域を指定してください。複数の領域を指定する場合は , チェックサム演算領域を
カンマで区切って指定してください。
複数の領域を個別にチェックサム演算する場合は , -cs オプションを複数記述して
ください。
チェックサム演算領域が重なった場合 , 重なった領域は後に指定した -cs オプショ
ンのフィル値で埋められます。
-cs オプションの値を埋める領域と -fill オプションの値を埋める領域が重なった場
合 , 重なった領域は常に -fill オプションのフィル値で埋められます。
本オプションは , 絶対形式ロードモジュール作成時に有効となります。
相対形式ロードモジュール作成時は , 以下の警告メッセージが出力され , 本オプ
ションの指定は無視されます。
[ 警告メッセージ ]
*** W1321L: REL モード時には (-cs) オプションは無視されます。
110
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 1】
flnk907s -cs 0xFE8000/0xFF7FFF,SUM32,0x7F
32 ビット単純加算で 0xFE8000/0xFF7FFF の領域のチェックサム演算を行います。
チェックサム演算対象領域でオブジェクトデータがない箇所は 0x7F で埋めます ( 図
6.2-6 参照 )。
図 6.2-6 チェックサム演算の例 1
チェックサム演算領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0xFE8000
オブジェクトデータ
チェックサム
演算対象領域
オブジェクトデータがない箇所は,
0x7Fで埋められた後,チェックサム
演算が行われます。
オブジェクトデータ
0xFF7FFF
0xFFFFFF
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
0x00FE8000-0x00FF7FFF
July 31, 2015, CM41-00315-6
Algorithm
SUM32=0
Value
0x252B7378
111
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例 2】
flnk907s -fill 0xFF0000/0xFF7FFF,0xFF/8 -cs 0xFE8000/
0xFFFFFF,SUM16=2,0x7F
16 ビット単純加算 ( 補数 2) で 0xFE8000/0xFFFFFF の領域のチェックサム演算を行
います。
-cs と -fill を同時に指定した場合 , オブジェクトデータがなくフィル指定されていな
い箇所が 0x7F で埋められた後にチェックサム演算が行われます ( 図 6.2-7 参照 )。
図 6.2-7 チェックサム演算の例 2
チェックサム演算
領域の設定
フィル対象
領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0xFE8000
オブジェクトデータ
0xFEFFFF
0xFF0000
チェックサム
演算対象領域
フィル対象領域
オブジェクトデータがなく,
フィル指定がない箇所は,
0x7Fで埋められた後,チェッ
クサム演算が行われます。
オブジェクトデータ
0xFF7FFF
0xFF8000
オブジェクトデータ
0xFFFFFF
0xFF0000~0xFF7FFFは,フィルオプションにより
0xFFで埋められます。
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
Algorithm
0x00FE8000-0x00FFFFFF SUM16=2
112
Value
0xCA64
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 3】
flnk907s -cs 0xFE8000/0xFEFFFF,0xFF8000/0xFFFFFF,CRC16,0x7F
16 ビット巡回冗長検査 (CRC16) で 0xFE8000/0xFEFFFF と 0xFF8000/0xFFFFFF の領
域のチェックサム演算を行います ( 図 6.2-8 参照 )。
図 6.2-8 チェックサム演算の例 3
チェックサム演算領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0xFE8000
チェックサム
演算対象領域
オブジェクトデータ
0xFEFFFF
0xFF8000
それぞれの領域のオブジェクト
データがない箇所が0x7Fで埋め
られた後, チェックサム演算が
行われます。
この2つの領域は,まとめてチェッ
クサム演算が行われます。
オブジェクトデータ
チェックサム
演算対象領域
0xFFFFFF
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
Algorithm
0x00FE8000-0x00FEFFFF CRC16=0x8005
0x00FF8000-0x00FFFFFF
July 31, 2015, CM41-00315-6
Value
0xEB83
113
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例 4】
flnk907s -cs 0xFE8000/0xFEFFFF,CRC16,0x7F -cs 0xFF8000/
0xFFFFFF,CRC32,0xFF
16 ビット巡回冗長検査 (CRC16) で 0xFE8000/0xFEFFFF の領域のチェックサム演算
を行います。
また , 32 ビット巡回冗長検査 (CRC32) で 0xFF8000/0xFFFFFF の領域のチェックサ
ム演算を行います ( 図 6.2-9 参照 )。
図 6.2-9 チェックサム演算の例 4
チェックサム演算領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0xFE8000
チェックサム
演算対象領域
オブジェクトデータ
0xFEFFFF
オブジェクトデータ
0xFF8000
チェックサム
演算対象領域
オブジェクトデータがない箇所が
0x7Fで埋められた後,チェックサム
演算が行われます。
オブジェクトデータがない箇所が
0xFFで埋められた後,チェックサム
演算が行われます。
0xFFFFFF
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
Algorithm
Value
0x00FE8000-0x00FEFFFF CRC16=0x8005
0xA1A9
0x00FF8000-0x00FFFFFF CRC32=0x04C11DB7 0xF154670A
114
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 5】
flnk907s -cs 0xFE8000/0xFFFFFF,SUM16=1,0x7F -cs 0xFF8000/
0xFFFFFF,SUM32=2,0xFF
16 ビット単純加算で 0xFE8000/0xFFFFFF の領域のチェックサム演算を行います。
0xFE8000/0xFF7FFF の領域でオブジェクトデータがない箇所は0x7F で埋められます。
また,32ビット単純加算で0xFF8000/0xFFFFFFの領域のチェックサム演算を行います。
0xFF8000/0xFFFFFF の領域でオブジェクトデータがない箇所は 0xFF で埋められま
す ( 図 6.2-10 参照 )。
図 6.2-10 チェックサム演算の例 5
セクション配置後の
オブジェクトデータ
チェックサム演算領域の設定
オブジェクトデータ
0xFE8000
オブジェクトデータ
オブジェクトデータがない箇所が
0x7Fで埋められた後,チェックサム
演算が行われます。
チェックサム
演算対象領域
オブジェクトデータ
0xFF8000
オブジェクトデータがない箇所が
0xFFで埋められた後,チェックサム
演算が行われます。
チェックサム
演算対象領域
0xFFFFFF
チェックサム演算対象領域が重なった場合,後で指定した
-csオプションのフィル値が有効となります。
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
Algorithm
0x00FE8000-0x00FFFFFF SUM16=1
0x00FF8000-0x00FFFFFF SUM32=2
July 31, 2015, CM41-00315-6
Value
0xBC1B
0xFFF01C34
115
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.14
So ft
Manu al
警告メッセージ出力レベルの指定 (-w)
警告メッセージの出力レベルを設定します。リンカの警告メッセージを完全に抑止
するときや , リンカの動作状態の確認をするときに使用します。
■ 警告メッセージ出力レベルの指定 (-w)
【記述形式】
-w < 数値 >
【パラメータ】
< 数値 >
警告レベルとして 0, 1 または 2 を指定します。
【説明】
警告レベルのメッセージ出力を抑止したり , より詳細なメッセージ出力を行うよう
に得たい情報をコントロールしたりします。
• 0: 警告レベルのメッセージを出力しません。
• 1: 通常のチェックです。( デフォルト )
• 2: 通常無視してよいレベルのものと , 単なるリンカの動作内容を通知するメッ
セージまで出力します。
詳細は ,「付録 A リンケージキットのエラーメッセージ」を参照してください。
【例】
flnk907s a1 a2 a3 -o a123.abs -w 2 -Xm
すべてのメッセージを出力します。
116
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.15
Soft
Ma nual
ROM 領域の指定 (-ro)
プログラムで使用する予定の ROM 領域を定義することにより , セクションの配置を
行うときのアドレス指定を簡略化します。
また , プログラムサイズのチェックも可能にします。
■ ROM 領域の指定 (-ro)
【記述形式】
-ro < 領域名 >= < スタートアドレス >/ < エンドアドレス >
[, < 領域名 >= < スタートアドレス >/ < エンドアドレス >] …
【パラメータ】
< 領域名 >
設定するアドレス領域を示す名前
< スタートアドレス >
設定するアドレス領域の先頭アドレス
< エンドアドレス >
設定するアドレス領域の最終アドレス
【説明】
ROM 領域の定義を行います。領域は , 必要に応じていくつでも定義できます。
スタートアドレスとエンドアドレスを指定して , その領域に名前を付けます。
このオプションで定義した領域名は , セクション配置オプションで使用します。
-ro オプションの定義だけではリンカの動作には何の効果もおよぼさないので , 必ず
セクション配置オプションでのアドレス指定パラメータに , ここで定義した領域名
を使うことになります。
スタートアドレスとエンドアドレスの指定には , バンク番号 (8 ビット ) を含めたア
ドレスを指定します。
【例】
flnk907s *.obj -o ap.abs -ro RomA=0x1000/0x2FFF -sc code=RomA •••
セクション名 code のセクションを , 0x1000 ~ 0x2FFF のアドレスに配置することを
指定します。
0x1000 番地から順に配置し , 0x2FFF 番地を越えた場合には警告メッセージを出力
します。
July 31, 2015, CM41-00315-6
117
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.16
So ft
Manu al
RAM 領域の指定 (-ra)
プログラムで使用する予定の RAM 領域を定義することにより , セクションの配置を
行うときのアドレス指定を簡略化します。
また , プログラムサイズのチェックも可能にします。
■ RAM 領域の指定 (-ra)
【記述形式】
-ra < 領域名 >= < スタートアドレス >/ < エンドアドレス >
[, < 領域名 >= < スタートアドレス >/ < エンドアドレス >] …
【パラメータ】
< 領域名 >
設定するアドレス領域を示す名前
< スタートアドレス >
設定するアドレス領域の先頭アドレス
< エンドアドレス >
設定するアドレス領域の最終アドレス
【説明】
RAM 領域の定義を行います。領域は , 必要に応じていくつでも定義できます。
スタートアドレスとエンドアドレスを指定して , その領域に名前を付けます。
このオプションで定義した領域名は , セクション配置オプションで使用します。
-ra オプションの定義だけではリンカの動作には何の効果もおよぼさないので , 必ず
セクション配置オプションでのアドレス指定パラメータに , ここで定義した領域名
を使うことになります。
スタートアドレスとエンドアドレスの指定には , バンク番号 (8 ビット ) を含めたア
ドレスを指定します。
【例】
flnk907s *.obj -o ap.abs -ra RamD=0x0100/0x01FF -sc data=RamD •••
セクション名 data のセクションを , 0x0100 ~ 0x1FF のアドレスに配置することを指
定します。
0x0100 番地から順に配置し , 0x01FF 番地を越えた場合には警告メッセージを出力
します。
118
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.17
Soft
Ma nual
セクション配置順 / アドレスの指定 (-sc)
セクション配置の開始アドレスおよび配置順をリンカに指示します。
■ セクション配置順 / アドレスの指定 (-sc)
【記述形式】
-sc < セクション名リスト > [/ < 内容種別 >] [/ < アライメント >]
[={ < アドレス > | < 領域名 >}] [, ••• ]
【パラメータ】
< セクション名リスト >
セクション名またはセクショングループ名リストセクション名の指定には , ワイル
ドカードが使えます。複数指定するときは , + 記号で連結します。
< 内容種別 >
code, data, stack, const, dir, dirconst, IO
< アライメント >
配置可能な領域の境界を以下に示すキーワードで指定できます。
• BYTE:
配置可能なバイト境界に配置します。前に配置済みのセクションがあ
れば , 隙間なく配置されます。
• WORD:
配置可能なアドレスのワード境界に配置されます。
• PAGE:
配置可能なアドレスのページ境界に配置されます。
< アドレス >
配置先頭アドレス
< 領域名 >
ROM/RAM 指定オプションで指定した領域名
【説明】
セクション配置の順序指定および配置アドレスの指定を行います。
セクション配置の順序は , パラメータに記述された順序に従います。
アドレスまたは領域名指定がない場合は , 0 番地から配置します。
セクション名の先頭に @ マークを付けると , 実行時にデータを ROM から RAM に
転送して動作する ROM → RAM 転送セクションの ROM 側のアドレス指定になりま
す。
ワイルドカードを使用する場合は , 以下の文字で囲んでください。ただし , オプショ
ンファイル中ではワイルドカードを "( ダブルクォート ) で囲まないでください。
【例 1】
flnk907s *.obj -o ap.abs -sc "*/code"=0xC1000,D=0x1000 •••
図 6.2-11 にこの場合の配置例を示します。
0xC1000 番地から内容種別が code のセクションを配置し , 0x1000 番地からセクショ
ン D を配置します。
July 31, 2015, CM41-00315-6
119
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
図 6.2-11 セクションの配置例 1
0x1000
D
0xC1000
内容種別がcodeの
セクション
【例 2】
flnk907s *.obj -o ap.abs -ro ROM=0xC1000/0xCFFFF -ra RAM=
0x1000/0x13FF -sc
P+code+text1=ROM,D=RAM
図 6.2-12 にこの場合の配置例を示します。
ROM/RAM オプションを使用したセクション配置指定の場合 , 配置終了アドレスの
チェックが行えます。
図 6.2-12 セクションの配置例 2
0x1000
D
0xC1000
P
code
text1
0xCFFFF
< セクション名リスト > に使用できるワイルドカード文字は "*" のみで , 記述パター
ンは以下の 4 とおりです。
パターン
*
-sc "*/code"
マッチする
ab_1, code_1, XXsect など
マッチしない
なし
~*
-sc "ab_*/code"
マッチする
ab_1, ab_XX, ab_ など
マッチしない
aab_XX, ab など
*~
-sc "*_1/code"
マッチする
ab_1, XX_1, _1 など
マッチしない
ab_11, _ など
~*~
120
例
-sc "ab_*_1/code"
マッチする
ab_XX_1, ab__1 など
マッチしない
aab_XX_11, ab_1 など
説明
内容種別が code であるすべてのセク
ションとマッチします。
内容種別が code であり , セクション名
の先頭 3 文字が "ab_" であるすべてのセ
クションとマッチします。
内容種別が code であり , セクション名
の最後の 2 文字が "_1" であるすべての
セクションとマッチします。
内容種別が code であり , セクション名
の先頭 3 文字が "ab_" で , かつ最後の 2
文字が "_1" であるすべてのセクション
とマッチします。
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
<注意事項>
ワイルドカード指定に一致するセクションには , ほかの -sc オプションで指定されたセク
ションや絶対アドレス ( セクションの配置属性が ABS) を持つセクションは含まれません。
-sc*=RAM -sc CODE=RAM
上記のような指定でワイルドカード指定は "CODE" 以外の再配置可能なセクション ( セク
ションの配置属性が REL) すべてと一致します。
July 31, 2015, CM41-00315-6
121
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.18
So ft
Manu al
セクショングループの指定 (-gr)
複数のセクションをユーザの目的に応じて 1 つに連結し , グループ名をつけます。
セクションの配置指定時にこのグループ名を使用することで , 複数セクションをまと
めて扱えます。
■ セクショングループの指定 (-gr)
【記述形式】
-gr < グループ名 >= < セクション名リスト > [/ < 内容種別 >] [, … ]
【パラメータ】
< グループ名 >
グループ化する複数セクションの総称
< セクション名リスト >
グループ化するセクション名を記述します。
ワイルドカードが使用できます。
複数指定するときは , + 記号で連結します。
< 内容種別 >
code,data,stack,const,dir,dirconst,IO
【説明】
グループ化するセクションの指定と , グループ内でのセクションの配置の順序指定
を行います。
セクション配置の順序は , パラメータに記述された順序に従います。
グループ名は , セクション名やほかのグループ名と重複しないユニークなものであ
る必要があります。
1 つのグループに属するセクションが , ほかのグループに属してはいけません。
ワイルドカードを使用する場合は , "( ダブルクォート ) で囲んでください。ただし ,
オプションファイル中ではワイルドカードを "( ダブルクォート ) で囲まないでくだ
さい。
【例 1】
flnk907s *.obj -o ap.abs -ro ROM=0xC1000/0xCFFFF -ra RAM=
0x1000/0x13FF •••
-gr romG=P+CODE+text1 -sc romG=ROM,D=RAM •••
グループ化オプションを使用した場合は , セクション名を幾つも指定するかわりに ,
その全体をグループ名で代表することができます。
【例 2】
flnk907s *.obj -o ap.abs -gr cdgrp="*/code" -sc cdgrp=0xC1000
内容種別が code であるセクションをすべて結合して cdgrp というグループ名を付け
ます。それを -sc オプションで 0xC1000 番地に配置します。
122
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.19
Soft
Ma nual
レジスタバンク領域の指定 (-rg)
プログラムで使用するレジスタバンク領域の指定を行います。
■ レジスタバンク領域の指定 (-rg)
【記述形式】
-rg < レジスタバンク番号 >
[{, < レジスタバンク番号 > | - < レジスタバンク番号 >}] …
【パラメータ】
< レジスタバンク番号 >
設定するレジスタバンクの番号を指定します。
【説明】
プログラムで使用するレジスタバンク領域の設定を行います。
プログラム中で汎用レジスタを使用する場合には , 本オプションで領域の確保が必
要です。
連続するレジスタバンク番号を指定する場合には , "3-8" のようにハイフンを用いて
一括指定が可能です ( この場合 , レジスタバンク 3, 4, 5, 6, 7, 8 を指定 )。
本指定が行われない場合 , リンカはレジスタバンク領域の確保を行いません。
表 6.2-1 に -rg オプションで確保される領域を示します。
表 6.2-1 レジスタバンク番号と領域
番号
確保される領域
番号
確保される領域
0
0x000180 ~ 0x00018F
16
0x000280 ~ 0x00028F
1
0x000190 ~ 0x00019F
17
0x000290 ~ 0x00029F
2
0x0001A0 ~ 0x0001AF
18
0x0002A0 ~ 0x0002AF
3
0x0001B0 ~ 0x0001BF
19
0x0002B0 ~ 0x0002BF
4
0x0001C0 ~ 0x0001CF
20
0x0002C0 ~ 0x0002CF
5
0x0001D0 ~ 0x0001DF
21
0x0002D0 ~ 0x0002DF
6
0x0001E0 ~ 0x0001EF
22
0x0002E0 ~ 0x0002EF
7
0x0001F0 ~ 0x0001FF
23
0x0002F0 ~ 0x0002FF
8
0x000200 ~ 0x00020F
24
0x000300 ~ 0x00030F
9
0x000210 ~ 0x00021F
25
0x000310 ~ 0x00031F
10
0x000220 ~ 0x00022F
26
0x000320 ~ 0x00032F
11
0x000230 ~ 0x00023F
27
0x000330 ~ 0x00033F
12
0x000240 ~ 0x00024F
28
0x000340 ~ 0x00034F
13
0x000250 ~ 0x00025F
29
0x000350 ~ 0x00035F
14
0x000260 ~ 0x00026F
30
0x000360 ~ 0x00036F
15
0x000270 ~ 0x00027F
31
0x000370 ~ 0x00037F
July 31, 2015, CM41-00315-6
123
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例】
flnk907s *.obj -o ap.abs -rg 0,1,5-7 •••
レジスタバンク領域 0, 1, 5, 6, 7 を確保します。
124
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.20
Soft
Ma nual
自動配置指定 (-AL)
セクションの自動配置の指定を行います。
■ 自動配置指定 (-AL)
【記述形式】
-AL { 0 | 1 | 2 }
【パラメータ】
<0 >
自動配置を行いません。( デフォルト )
<1 >
領域内にアブソリュートセクションが存在するとき , そのセクションと重複しない
ように配置します。
<2 >
セクションの属性から , ROM 領域に配置すべきか , RAM 領域に配置すべきかを判
断し , それぞれの領域内の空き領域に配置します。
(link907a 自動配置互換 )
【説明】
セクションの自動配置の指定を行います。
相対形式のロードモジュールを作成するときは , -AL オプションの指定は 0 または
-AL の指定なしにしてください。詳しくは「6.2.5 相対形式ロードモジュールの出
力指定 (-r)」を参照してください。
• パラメータ 1 の場合 :
-ra, -ro オプションで指定した領域内へセクション配置を行うとき , アブソリュー
トセクションが存在していれば , 配置アドレスが重ならないように , リロケータ
ブルセクションの配置を行います。このとき , アライメント値およびサイズの大
きいセクションから順に配置し , 空き領域が最小となるような最適配置を行いま
す。
• パラメータ 2 の場合 :
-sc オプションで配置指定が行われなかったセクションに対して , セクションの属
性から , ROM 領域に配置すべきか , RAM 領域に配置すべきかを判断し , それぞれ
の領域内の空き領域に配置します。
「5.6 セクションの自動配置」を合わせて参照してください。
【例】
flnk907s -AL 1 -ro ROM=0x1000/0x1FFF -sc
code1+code2+code3=ROM ...
ただし , 各セクションは以下のようなものであるとします。
• code1 : リロケータブル , サイズ =0x18
• code2 : リロケータブル , サイズ =0x10
• code3 : リロケータブル , サイズ =0x30
• AbsSec : アブソリュート , アドレス範囲 =0x1010 ~ 0x1017
July 31, 2015, CM41-00315-6
125
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
この場合の , リンクマップを示します。
図 6.2-13 リンクマップ例
S_Addr. -E_Addr
Size
Section Type
AL
Sec
00001000-0000100F
00000010
CODE P R-XI
02 REL code2
00001010-00001017
00000008
CODE NR-XI
00 ABS AbsSec
00001018-00001047
00000030
CODE P R-XI
02 REL code3
00001048-0000105F
00000018
CODE P R-XI
02 REL code1
<注意事項>
-AL 1 が指定されていても , 以下の場合は自動配置を行いません。
• 領域の設定がない (-ra, -ro の指定がない )。
• -sc のアドレス指定で領域名を使用していない。
• 指定した領域内に配置されるアブソリュートセクションがない。
-AL 2 を指定した場合 , 以下の場合はエラーになりリンク処理を行いません。
• 領域の設定がない (-ra, -ro の指定がない )。
-w 2 を指定すると自動配置機能が働いた場合メッセージが出力されます。
126
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.21
Soft
Ma nual
検索ライブラリファイルの指定 (-l)
デフォルトライブラリ以外に検索すべきライブラリを指示します。複数のライブラ
リファイルがある場合 , 検索順に指定します。
■ 検索ライブラリファイルの指定 (-l)
【記述形式】
-l < ライブラリファイル名 > [, … ]
【パラメータ】
< ライブラリファイル名 >
検索するライブラリファイル名を記述します。パス名付きの指定も可能。ワイルド
カード使用可能。
【説明】
指定された順に , ライブラリファイルを検索します。
デフォルトライブラリより先に , ここで指定したライブラリが検索されます。
パス名なしでライブラリファイルを指定した場合に検索されるディレクトリは , -L
オプションで指定したディレクトリ , 環境変数 LIB907 で指定のディレクトリ , 環境
変数 FETOOL より導かれるシステムライブラリパスの順になります。
カレントディレクトリは検索しません。カレントディレクトリを検索対象にしたい
ときは , -L オプションまたは環境変数 LIB907 にピリオド (.) を指定してください。
-nl オプションより後で , -l オプションを指定することで -nl オプションを無効にす
ることができます。
ワイルドカードを使用する場合は , "( ダブルクォート ) で囲んでください。ただし ,
オプションファイル中ではワイルドカードを "( ダブルクォート ) で囲まないでくだ
さい。
【例】
flnk907s *.obj -o ap.abs -l .. \ lib \ com.lib,libu
flnk907s *.obj -o ap.abs -l "p*.lib"
ファイル名の先頭 1 文字が "p" であるすべてのライブラリファイルが検索対象にな
ります。
July 31, 2015, CM41-00315-6
127
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.22
So ft
Manu al
ライブラリ検索パスの指定 (-L)
ライブラリファイルを検索するパス名の指定を行います。
■ ライブラリ検索パスの指定 (-L)
【記述形式】
-L < ライブラリパス名 > [, … ]
【パラメータ】
< ライブラリパス名 >
ライブラリファイルを格納したパス名
【説明】
-l オプションで指定したライブラリファイルが , どのディレクトリにあるのかをリ
ンカに指示します。
通常は , 本オプションを指定しなくてもよいように環境変数 LIB907 を設定してお
きます。
LIB907 で指定したパスには , C コンパイラに付属の C ライブラリを格納しますので ,
特別にユーザが作成したライブラリを別ディレクトリで管理したいような場合に ,
-L オプションを使用してください。
複数のパスが指定された場合は , 指定順に検索します。
ライブラリファイルは , まずここで指定されたパスから探し , なければ環境変数
LIB907 で指定されたパス , 環境変数 FETOOL より導かれるシステムライブラリパ
スの順で検索します。
ライブラリファイルの指定で , パス名まで含めて指定された場合は , そのパスだけ
を検索します。
-nl オプションがある場合は , ライブラリ検索を行わないので -L オプションは無効
になります。
【例】
flnk907s *.obj -o ap.abs -L C: \ usr \ usrlib -l com.lib,libu
128
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.23
Soft
Ma nual
シンボル個別のライブラリの指定 (-el)
外部参照シンボルの値の解決に使用するライブラリファイルを特定できます。
■ シンボル個別のライブラリの指定 (-el)
【記述形式】
-el < シンボル名リスト >= < ライブラリファイル名 > [, … ]
【パラメータ】
< シンボル名リスト >
外部参照シンボル名を記述します。
複数シンボルを指定する場合は , / で区切ります。
< ライブラリファイル名 >
検索対象とするライブラリファイル名
パス名付きの指定も可能です。なお , ワイルドカードは使用できません。
【説明】
本オプションで指定した外部参照シンボルの値の解決に使用するライブラリファ
イルを特定します。
同じ外部定義シンボル名を含むモジュールが , 複数ライブラリに存在しているのが
分かっており , リンカが標準で行うライブラリ検索順では希望しないモジュールが
結合されてしまうときに使用します。
この機能を使用せざるを得ないのは , 複数のライブラリを使用するときにライブラ
リの作成方法に問題があるためです。思わぬ障害混入の原因を含んでいますので ,
できれば使用しないことが望ましいものです。
ライブラリファイルの作り直しを検討してください。
なお , パス名指定なしでライブラリファイル名を指定した場合の検索ディレクトリ
は , -l オプションと同じです。
【例】
flnk907s *.obj -o sp.abs -L C: \ usr \ usrlib -l libu,
sublib -el sym1=sublib
July 31, 2015, CM41-00315-6
129
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.24
So ft
Manu al
ライブラリ検索の抑止指定 (-nl)
ライブラリファイルの検索を行わないことを指示します。
■ ライブラリ検索の抑止指定 (-nl)
【記述形式】
-nl
【パラメータ】
なし
【説明】
ライブラリファイルの検索を行わないようにします。
【例 1】
flnk907s -L C: \ usr \ usrlib -l libu,sublib *.obj -o ap.abs -nl
先に指定した -L, -l, -el オプションを無効にし , デフォルトライブラリも含めて , ラ
イブラリの検索を行わないようにします。
【例 2】
flnk907s -l libl *.obj -o ap.abs -nl -l lib2
一度指定した lib1.lib をキャンセルして , lib2.lib を検索するように指定し直すことが
できます。
この例のように , 複数の -l オプションの間に -nl オプションを指定すると , -nl の指
定以前に指定していた -l オプションはすべてキャンセルされます。しかし , -L オプ
ションの指定 , -el オプション指定 , -nd オプション指定およびデフォルトライブラ
リの検索は -nl 指定以前の設定状態になります。
したがって , この例の場合は , lib2.lib とデフォルトライブラリを検索します。
130
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.25
Soft
Ma nual
デフォルトライブラリ検索の抑止指定 (-nd)
デフォルトライブラリとは , C コンパイラが使用することを仮定したライブラリファ
イルであり , オブジェクトファイル中にそのライブラリファイル名が設定されていま
す。
このデフォルトライブラリファイルの検索を行わないことを指示します。
■ デフォルトライブラリ検索の抑止指定 (-nd)
【記述形式】
-nd
【パラメータ】
なし
【説明】
デフォルトライブラリファイルの指定を無効とし , 検索しないようにします。
【例】
flnk907s -L C: \ usr \ usrlib -l libu,sublib *.obj -o ap.abs -nd
-l オプションで指定したライブラリのみを検索し , デフォルトライブラリの検索は
行わないようにします。
July 31, 2015, CM41-00315-6
131
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.26
So ft
Manu al
未使用関数削除指定 (-lnkopt)
-lnkopt オプションは , 未使用関数を削除するオプションです。
■ 未使用関数削除指定 (-lnkopt)
【記述形式】
-lnkopt
【パラメータ】
なし
【説明】
未使用関数を削除します。
未使用関数を削除するには , C ソースを -K LNKOPT オプションを指定してコンパ
イルする必要があります。
コンパイル時に -K LNKOPT オプションを指定していない場合 , -lnkopt オプション
は無視します。
ライブラリ形式のファイル (.lib) 内に格納されているオブジェクト形式ファイル
(.obj) は削除対象となります。
相対形式のロードモジュールファイル (.rel) からは未使用関数があっても削除の対
象外です。
C ソースで __interrupt 宣言を付与した関数は削除の対象外です。
アセンブラソースで記述された CODE セクションは , 削除の対象外です。
【例 1】
fcc907s sample1.c -K LNKOPT -c
fcc907s sample2.c -K LNKOPT -c
flnk907s -lnkopt sample1.obj sample2.obj
未使用関数を削除します。
【例 2】
fcc907s sample1.c -c
fcc907s sample2.c -c
flnk907s -lnkopt sample1.obj sample2.obj
未使用関数を削除しません。
132
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
<注意事項>
以下の場合 , 未使用関数削除機能は , 実際には使用している関数を削除することがありま
す。
• アセンブラソースからのみ参照される関数
• OS のタスク
• 関数ポインタから間接参照される関数
• アドレス値で参照される関数
実際には使用している関数が削除された場合 , 以下のリンクエラーが発生します。
E4305L: 外部シンボルが定義されていません
プログラム中に存在する関数に対してE4305Lが発生した場合,-XdelオプションでE4305L
が発生した関数を削除対象から除外してください。
July 31, 2015, CM41-00315-6
133
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.27
So ft
Manu al
C ソースのプログラム実行開始シンボル指定 (entryc)
-entryc オプションは , C ソースのプログラム実行開始シンボルを指定するオプショ
ンです。
-entryc オプションが省略された場合のプログラム実行開始シンボルは , "_main" で
す。
■ C ソースのプログラム実行開始シンボル指定 (-entryc)
【記述形式】
-entryc < シンボル名 >
【パラメータ】
< シンボル名 >
C ソースのプログラム実行開始シンボルを指定します。
【説明】
-entryc オプションは C ソースのプログラム実行開始シンボルを指定するオプション
です。指定するシンボル名は C ソースの関数が func() である場合 , 先頭の文字にア
ンダバーを追加し , "_func" とします。指定されたシンボル名が static かつ複数ある
場合 , リンカのコマンド指定順で先に見つかったほうが対象として選択されます。
リンカは , -entryc オプションで指定されたシンボル名からのコールツリーを解析し ,
未使用関数を抽出します。
-entryc オプションが省略された場合 , プログラム実行開始シンボルには "_main" が
設定されます。
-entrycオプションを複数回指定した場合 , 最後に指定した -entryc オプションが有効
になります。
-lnkopt オプションが無効の場合 , -entryc オプションは無視します。
【例】
flnk907s -lnkopt -entryc _start
start() を C ソースのプログラム実行開始として , 未使用関数を抽出します。
134
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.28
Soft
Ma nual
削除対象外関数指定 (-Xdel)
-Xdel オプションは , 未使用関数削除機能で削除しない関数を指定するオプションで
す。
■ 削除対象外関数指定 (-Xdel)
【記述形式】
-Xdel < シンボル名 >
【パラメータ】
< シンボル名 >
未使用関数削除機能で削除しない関数のシンボル名を指定します。
【説明】
-Xdel オプションは , 未使用関数削除機能で削除しない関数を指定するオプションで
す。指定するシンボル名は C ソースの関数が func() である場合 , 先頭の文字にアン
ダバーを追加し , "_func" とします。
-Xdel オプションで指定された関数は , 未使用関数削除機能により未使用の関数と判
定されても削除されません。また , 指定されたシンボル名が static かつ複数ある場
合 , リンカのコマンド指定順で先に見つかったほうが対象として選択されます。
-Xdel オプションは , 複数指定できます。
-lnkopt オプションが無効の場合 , -Xdel オプションは無視します。
-Xdel オプションは , 以下の場合に使用します。
• 実際には使用している関数が未使用関数削除機能で削除された場合
• OS のタスクのように C ソースのプログラム実行開始シンボルが複数ある場合
【例】
flnk907s -lnkopt -Xdel _func
func() が未使用関数削除機能で未使用関数と判定されても , 削除しません。
July 31, 2015, CM41-00315-6
135
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.29
So ft
Manu al
未使用関数削除情報ファイル格納パス指定 (-ufiin)
-ufiin オプションは , 未使用関数削除情報ファイル (ufi ファイル ) の格納パスを指定
するオプションです。
-ufiin オプションが省略された場合 , オブジェクトファイルが格納されているパスに
ある ufi ファイルを使用します。
■ 未使用関数削除情報ファイル格納パス指定 (-ufiin)
【記述形式】
-ufiin < パス >
【パラメータ】
< パス >
未使用関数削除情報ファイル (ufi ファイル ) が格納されているパスを指定します。
絶対パスと相対パスが指定できます。
【説明】
-ufiin オプションは , ufi ファイルの格納パスを指定するオプションです。
-ufiin オプションが省略された場合 , オブジェクトファイルが格納されているパスに
ある ufi ファイルを使用します。
-ufiin オプションを複数回指定した場合 , 最後に指定した -ufiin オプションが有効に
なります。
-lnkopt オプションが無効の場合 , -ufiin オプションは無視します。
格納パスにオブジェクト形式ファイルと対になる名前の ufi ファイルが見つからな
い場合 , 関数はそのオブジェクト形式ファイルから未使用関数削除機能で削除され
ません。
【例】
flnk907s -lnkopt -ufiin C:\sample\ufi
"C:\sample\ufi" に格納された ufi ファイルを使用します。
136
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.30
Soft
Ma nual
エントリアドレスの指定 (-e)
ユーザプログラムの実行開始アドレスを , 外部定義シンボルで指定します。
■ エントリアドレスの指定 (-e)
【記述形式】
-e < シンボル名 >
【パラメータ】
< シンボル名 >
エントリポイントのシンボル名
外部定義シンボル以外は指定できません。
【説明】
ユーザプログラムの実行開始アドレスを , 外部定義シンボルで指定したものに変更
します。
実行開始アドレスは , アセンブラの .end 疑似命令で指定できます。
エントリポイントは , シュミレータデバッガで , 実行開始時の PC( プログラムカウ
ンタ ) の初期値として設定されます。
【例】
flnk907s *.obj -o ap.abs -e ProgStart
July 31, 2015, CM41-00315-6
137
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.31
So ft
Manu al
外部シンボル値の仮設定 (-df)
ユーザプログラム未定義シンボルの値を強制的に定義します。
■ 外部シンボル値の仮設定 (-df)
【記述形式】
-df < シンボル名 >={ < 数値 > | < 外部定義シンボル名 >}
【パラメータ】
< シンボル名 >
外部参照シンボルのシンボル名
< 数値 >
定義する値
< 外部定義シンボル名 >
値の定義されている外部シンボル名
【説明】
未定義の外部参照シンボルの値を強制的に定義します。
リンカはリロケーション解決にこの値を用いてオブジェクトデータを作成します
が , 出力する絶対形式ロードモジュールファイル中のシンボル情報には影響を与え
ません。
デバッガなどでロードした場合 , ここで指定したシンボル名は未定義のままです。
【例】
flnk907s -L \ usr \ usrlib -l libu,sublib *.obj -o
ap.abs -df Sym1=100
Sym1 が定義されていないとき , 値を 100 とします。
138
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
ターゲット CPU 指定 (-cpu)
6.2.32
ターゲット CPU の指定を行います。
リンクを行うプログラムのターゲット CPU を MB 番号で指定します。
■ ターゲット CPU 指定 (-cpu)
【記述形式】
-cpu <MB 番号 >
【パラメータ】
<MB 番号 >
ターゲット CPU の MB 番号
【説明】
リンクを行うプログラムのターゲット CPU を MB 番号で指定します。
【例】
flnk907s *.obj -o ap.abs -cpu MB90611A
flnk907s *.obj -o ap.abs -cpu MB90704
<注意事項>
リンク処理を実行する際には , 本オプションでターゲット CPU の指定が必要です。
このオプションの省略はできません。
July 31, 2015, CM41-00315-6
139
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
CPU 情報ファイル指定 (-cif)
6.2.33
リンカで使用する CPU 情報ファイルを指定します。
■ CPU 情報ファイル指定 (-cif)
【記述形式】
-cif <CPU 情報ファイル名 >
【パラメータ】
<CPU 情報ファイル名 >
リンカで使用する CPU 情報ファイル
【説明】
リンカで使用する CPU 情報ファイルを指定します。
【例】
flnk907s *.obj -o ap.abs -cpu MB90704
-cif C:\Softune\lib\907\cpu_info\MB90704.csv
<注意事項>
SOFTUNE Tools は , CPU 情報ファイルを参照して , CPU に関する情報を取得します。
関連するツール間で異なる CPU 情報ファイルを参照した場合 , 作成するプログラムに問
題が発生する可能性があります。
SOFTUNE Tools に標準で添付されている CPU 情報ファイルは , 以下の場所にあります。
インストール先ディレクトリ \lib\907\907.csv
コンパイラ・アセンブラパックを異なるディレクトリにインストールし , SOFTUNE
Workbench を使用せずにコンパイラ , アセンブラおよびリンケージキットを使用する場
合, 各ツールに対して同一のCPU情報ファイルを参照するように-cifで指定してください。
140
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.34
Soft
Ma nual
デバッグ情報存在チェック抑止指定 (-NCI0302LIB)
ライブラリファイルのモジュールに対するデバッグ情報存在チェックを抑止します。
■ デバッグ情報存在チェック抑止指定 (-NCI0302LIB)
【記述形式】
-NCI0302LIB
【パラメータ】
なし
【説明】
デバッグ情報出力指定 (-g) と警告レベル 2(-w 2) を指定してリンカを動作させると ,
リンカはデバッグ情報が存在しないモジュールに対して , 以下のインフォメーショ
ンを出力します。
I0302L: デバッグ情報が存在しません ( ファイル名 )
本オプションを指定すると , リンカはライブラリファイルから抽出したモジュール
に対して , 上記インフォメーションメッセージの出力を行いません。
【例】
flnk907s -cpu MB90704 -g -w 2 test.obj -l lib907c.lib
*** I0302L: デバッグ情報が存在しません (C: \ Softune \ lib \ 907 \ lib907c.lib)
*** I0302L: デバッグ情報が存在しません (C: \ Softune \ lib \ 907 \ lib907c.lib)
・
・
・
→ インフォメーション I0302L が出力されます。
flnk907s -cpu MB90704 -g -w 2 test.obj -l lib907c.lib -NCI0302LIB
→ インフォメーション I0302L は出力されません。
July 31, 2015, CM41-00315-6
141
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.35
So ft
Manu al
内蔵 ROM/RAM 領域の自動設定 (-set_rora)
CPU 情報ファイルからターゲット CPU の内蔵 ROM/RAM 領域情報の設定を行いま
す。
■ 内蔵 ROM/RAM 領域の自動設定 (-set_rora)
【記述形式】
-set_rora
【パラメータ】
なし
【説明】
CPU 情報ファイルからターゲット CPU の内蔵 ROM/RAM 領域情報の設定を行いま
す。
本オプションを指定した際リンカは , CPU 情報ファイルから該当するチップの内蔵
ROM/RAM 領域を自動的に設定します。
リンカは , ROM/RAM 領域を以下の名前で設定します。
• ROM 領域の場合 : _ROM_*_
- 上記 * には , 低位アドレスの領域順に 1 から順番に番号が入ります。領域が 1
つしかない場合は , "_ROM_1_" となります。
• RAM 領域の場合 : _RAM_*_
- 上記 * には , 低位アドレスの領域順に 1 から順番に番号が入ります。領域が 1
つしかない場合は , "_RAM_1_" となります。
これらの名前は , -sc オプションで使用可能です。
【例】
flnk907s *.obj -o ap.abs -cpu MB90704 -set_rora
142
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.36
Soft
Ma nual
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora)
CPU 情報ファイルからターゲット CPU の内蔵 ROM/RAM 領域情報の設定を抑止し
ます。
■ 内蔵 ROM/RAM 領域自動設定の抑止指定 (-Xset_rora)
【記述形式】
-Xset_rora
【パラメータ】
なし
【説明】
CPU 情報ファイルからターゲット CPU の内蔵 ROM/RAM 領域情報の設定を抑止し
ます。
【例】
flnk907s *.obj -o ap.abs -cpu MB90704 -Xset_rora
July 31, 2015, CM41-00315-6
143
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.37
So ft
Manu al
ユーザ指定領域のチェック指定 (-check_rora)
メモリマップが変わっていないかを MB 番号指定を変更するだけでチェックできま
す。
指定した ROM 領域 , RAM 領域 (-ro, -ra オプション ) が実際の内蔵 ROM, 内蔵 RAM
のアドレスと合っているかチェックを行います。
シングルチップモードの場合にご使用ください。
■ ユーザ指定領域のチェック指定 (-check_rora)
【記述形式】
-check_rora
【パラメータ】
なし
【説明】
指定の ROM 領域 , RAM 領域 (-ro, -ra オプション ) が , 内蔵 ROM, 内蔵 RAM を超え
ていないかチェックを行います。
-ro/-ra オプションで指定した領域が内蔵 ROM, 内蔵 RAM に収まっていない場合に ,
以下の警告を出力します。
W1368L: -ro オプションで内蔵 ROM 領域の範囲外が指定されています ( 領域名 )
W1369L: -ra オプションで内蔵 RAM 領域の範囲外が指定されています ( 領域名 )
シングルチップモードをご使用の場合 , このオプションと MB 番号を指定しておく
と , その品種の内蔵 ROM, 内蔵 RAM のアドレスと合っているかチェックを行うた
め , 別品種にプログラムを移植する場合など , MB 番号を変更するだけでメモリマッ
プが変わっていないかチェックできます。
また , 併せて -check_locate オプションを指定しておけば内蔵 ROM, 内蔵 RAM 内に
プログラムが収まっているかのチェックも行えます。
【例】
flnk907s -cpu MB90754 -check_rora -ro ROM = 0x00080800/0x000fffff
-ra RAM1=0x00001000/0x00008fff , RAM2=0x00080000/0x000807ff …
W1368L: -ro オプションで内蔵 ROM 領域の範囲外が指定されています (ROM)
W1369L: -ra オプションで内蔵 RAM 領域の範囲外が指定されています (RAM1)
→下線部の指定が範囲外のため警告が出力されます。
flnk907s -cpu MB90754 -check_rora -ro ROM = 0x000A0000/0x000fffff
-ra RAM1=0x00001000/0x00005fff, RAM2=0x00080000/0x000807ff …
→ 正常範囲指定 警告はありません。
144
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
<注意事項>
• ワーニング出力抑止 (-w 0) が指定されている場合でも本オプションが指定されている
場合は警告が出力されます。
• 本オプションは , 絶対形式ロードモジュール作成時のみ有効です。リロケータブルロー
ドモジュール作成時は , 本オプションは無視されます。
• 本オプションは CPU 情報ファイル内の内蔵 ROM 情報および内蔵 RAM 情報を用いて
います。したがって , CPU 情報ファイル内に該当情報が存在しない場合には警告は出
力されません。-cpu オプションで正確な MB 番号指定を行ってください。
July 31, 2015, CM41-00315-6
145
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.38
So ft
Manu al
ユーザ指定領域のチェック抑止指定 (-Xcheck_rora)
指定した ROM 領域 , RAM 領域 (-ro, -ra オプション ) と内蔵 ROM 領域または内蔵
RAM 領域のチェックを抑止します。
-check_rora オプションを取り消す際に用います。
■ ユーザ指定領域のチェック抑止指定 (-Xcheck_rora)
【記述形式】
-Xcheck_rora
【パラメータ】
なし
【説明】
指定の ROM 領域 , RAM 領域 (-ro, -ra オプション ) と内蔵 ROM, 内蔵 RAM のアドレ
スのチェックを抑止します。
-check_rora オプションを取り消す際に用います。
【例】
flnk907s -cpu MB90754 -check_rora -ro ROM = 0x00080800/0x000fffff
-ra RAM1 = 0x00001000/0x00008fff, RAM2=0x00080000/0x000807ff …
W1368L: -ro オプションで内蔵 ROM 領域の範囲外が指定されています (ROM)
W1369L: -ra オプションで内蔵 RAM 領域の範囲外が指定されています (RAM1)
→下線部の指定が範囲外のため警告が出力されます。
flnk907s -cpu MB90754 -check_rora -ro ROM = 0x00080800/0x000fffff
-ra RAM1 = 0x00001000/0x00008fff, RAM2=0x00080000/0x000807ff
-Xcheck_rora …
→下線部の指定が範囲外ですが , -Xcheck_rora でチェック抑止を行っているため警
告は出力されません。
146
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.39
Soft
Ma nual
セクション配置領域チェック指定 (-check_locate)
メモリ領域外に配置されていないことをチェックします。
指定の ROM 領域 , RAM 領域 (-ro, -ra オプション ) または cpu 情報ファイル内の内
蔵 ROM 情報 , 内蔵 RAM 情報を元にセクション配置アドレスをチェックし , 領域外
の配置に対して警告を出力します。
■ セクション配置領域チェック指定 (-check_locate)
【記述形式】
-check_locate
【パラメータ】
なし
【説明】
指定の ROM 領域 , RAM 領域 (-ro, -ra オプション ) または cpu 情報ファイル内の内
蔵 ROM/RAM 情報を元にセクション配置アドレスをチェックし , 領域外の配置に対
して以下の警告を出力します。
W1370L: ROM 領域外への配置です ( セクション名 )
W1371L: RAM 領域外への配置です ( セクション名 )
W1372L: RAM 領域または IO 領域外への配置です ( セクション名 )
W1373L: IO 領域外への配置です ( セクション名 )
以下にセクションタイプとチェック領域を示します。
チェック対象領域
セクションタイプ
-check_rora オプション指定あり
ROM 領域に配置されるべきセクション
CODE
-ro 指定領域外かつ内蔵 ROM 領域外
CONST
に配置されているセクションに対し
て警告出力。
DIRCONST
-check_rora オプション指定なし
-ro 指定領域外に配置されているセク
ションに対して警告出力。
ROM → RAM 転送元セクション
RAM 領域に配置されるべきセクション
STACK
-ra 指定領域外かつ内蔵 RAM 領域外
DIR
に配置されているセクションに対し
ROM → RAM 転送先セクション て警告出力。
RAM 領域または IO 領域に配置されるべきセクション
DATA
-ra 指定領域外かつ内蔵 RAM 領域 ,
内蔵 IO 領域外に配置されているセク
ションに対して警告出力。
IO 領域に配置されるべきセクション
IO
内蔵 IO 領域外に配置されているセク
ションに対して警告出力。
July 31, 2015, CM41-00315-6
-ra 指定領域外に配置されているセク
ションに対して警告出力。
-ra 指定領域外に配置されているセク
ションに対して警告出力。
内蔵 IO 領域外に配置されているセク
ションに対して警告出力。
147
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
シングルチップモードでご使用の場合は , -check_rora と併せて指定することで , 内蔵メ
モリ領域外にプログラムが配置されていないことをチェックできます。
また , その他の場合でも ROM 領域指定 , RAM 領域指定 (-ro, -ra オプション ) と併せて
指定することでメモリ領域外にプログラムが配置されていないことをチェックできま
す。
【例】
下図のようなメモリマップでDATA タイプのDATA_A, DATA_B, DATA_C とCODE
タイプの CODE_D, CODE_E, CODE_F と STACK タイプの STACK_G が配置されて
いる場合のチェックは次のようになります。
flnk907s -cpu MB90754 -check_locate -ro ROM = 0x000A0000/0x000fffff
-ra RAM1=0x00001000/0x00005fff, RAM2=0x00080000/0x000807ff …
W1372L: RAM 領域または IO 領域外への配置です (DATA_A)
W1371L: RAM 領域外への配置です (STACK_G)
W1372L: RAM 領域または IO 領域外への配置です (DATA_C)
W1370L: ROM 領域外への配置です (CODE_D)
W1370L: ROM 領域外への配置です (CODE_F)
0x000000
I/O
DATA A
0x000800
アクセス禁止
0x001000
RAM1
内蔵RAM 20K
DATA B
STACK G
0x006000
アクセス禁止
DATA C
0x080000
RAM2
内蔵RAM 2K
DATA D
0x080800
アクセス禁止
0x0A0000
ROM
内蔵ROM 384K
CODE E
CODE F
0x100000
アクセス禁止
0xffffff
DATA_A は内蔵 IO 領域内に配置されているため警告は出力されません。
DATA_B は -ra で指定した領域内に配置されているため警告は出力されません。
DATA_C は -ra で指定した領域外から配置されているため警告が出力されます。
CODE_D は -ro で指定した領域外に配置されているため警告が出力されます。
CODE_E は -ro で指定した領域内に配置されているため警告は出力されません。
CODE_F は -ro で指定した領域外に配置されているため警告が出力されます。
STACK_G は -ra で指定した領域外に配置されているため警告が出力されます。
148
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
<注意事項>
• ワーニング出力抑止 (-w 0) が指定されている場合でも本オプションが指定されている
場合は警告が出力されます。
• 本オプションは , 絶対形式ロードモジュール作成時のみ有効です。リロケータブルロー
ドモジュール作成時は , 本オプションは無視されます。
• 本オプションの使用にあたっては , -ro, -ra オプションを用いた領域指定を行う必要が
あります。
• リンカ処理対象外である ABS 属性のセクションに対してもチェックを行います。
July 31, 2015, CM41-00315-6
149
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.40
So ft
Manu al
セクション配置領域チェック抑止指定 (-Xcheck_locate)
セクション配置領域チェックを抑止します。
-check_locate オプションを取り消す際に使用します。
■ セクション配置領域チェック抑止指定 (-Xcheck_locate)
【記述形式】
-Xcheck_locate
【パラメータ】
なし
【説明】
セクション配置領域チェックを抑止します。
-check_locate オプションを取り消す際に用います。
150
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.41
Soft
Ma nual
ユーザ指定外セクションのチェック指定 (-check_section)
ユーザにより配置指定が行われていないセクションが存在しないかチェックを行い
ます。
■ ユーザ指定外セクションのチェック指定 (-check_section)
【記述形式】
-check_section
【パラメータ】
なし
【説明】
ユーザにより配置指定が行われていないセクションが存在しないかチェックを行
います。
リンカは本オプションが指定されている場合 , セクション配置指定 (-sc) オプション
で指定されていないセクションに対して以下の警告を出力します。
W1375L: -sc オプションで配置指定の行われていないセクションです
( セクション名 )。
本オプションが指定されていない場合 , リンカはチェックを行いません。
【例】
CODE, INIT, CONST, DATA, STACK のセクションを持つオブジェクトをリンクし
た場合の動作を示します。
flnk907s -cpu MB90754 -check_section
-ro ROM=0x000a0000/0x000fffff
-ra RAM1=0x00001000/0x00008fff,RAM2=0x00080000/0x000807ff
-sc CODE+CONST=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
W1375L: -sc オプションで配置指定の行われていないセクションです (INIT)
→ セクション INIT に対して配置指定が行われていません。-check_section オプショ
ンが指定されているため , セクション INIT に対して警告が出力されます。
flnk907s -cpu MB90754 -check_section
-ro ROM=0x000a0000/0x000fffff
-ra RAM1=0x00001000/0x00008fff,RAM2=0x00080000/0x000807ff
-gr ROMGROUP=CODE+CONST -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
W1375L: -sc オプションで配置指定の行われていないセクションです (CODE)
W1375L: -sc オプションで配置指定の行われていないセクションです (INIT)
W1375L: -sc オプションで配置指定の行われていないセクションです (CONST)
→ セクション CODE, CONST は -gr でグループ化されていますが , -sc オプション配
置指定を行っていないためCODE, CONSTセクションに対して警告が出力されます。
flnk907s -cpu MB90754 -check_section
-ro ROM=0x000a0000/0x000fffff
-ra RAM1=0x00001000/0x00008fff,RAM2=0x00080000/0x000807ff
-sc *=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
→ ワイルドカードでセクション名を指定したことにより , セクション DATA,
July 31, 2015, CM41-00315-6
151
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
STACK 以外のすべてのセクションに対して配置指定が行われています。すべての
セクションに対して配置指定が行われているため警告は出力されません。
<注意事項>
• ソースプログラム中で配置アドレス指定が行われているセクションはチェック対象外
です。
• -grオプションでセクショングループ指定を行っていても , -scオプションで配置指定を
行っていない場合は警告が出力されます。
• -sc オプションのセクション名にワイルドカードを用いて指定した場合 , ワイルドカー
ドに一致したセクションはすべて配置指定が行われています。したがって , ワイルド
カードに一致したセクションに対して警告は出力されません。セクション名をワイル
ドカードで指定する際には注意を行ってください。
152
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.42
Soft
Ma nual
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section)
ユーザにより配置指定が行われていないセクションの存在チェックを抑止します。
-check_section オプションを取り消す際に用います。
■ ユーザ指定外セクションのチェック抑止指定 (-Xcheck_section)
【記述形式】
-Xcheck_section
【パラメータ】
なし
【説明】
配置指定が行われていないセクションの存在チェックを抑止します。
-check_section オプションを取り消す際に用います。
本オプションがデフォルトです。
【例】
CODE, INIT, CONST, DATA, STACK のセクションを持つオブジェクトをリンクし
た場合の動作を示します。
flnk907s -cpu MB90754 -check_section -Xcheck_section
-ro ROM=0x000a0000/0x000fffff
-ra RAM1=0x00001000/0x00008fff,RAM2=0x00080000/0x000807ff
-sc CODE+CONST=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
→ セクション INIT に対して配置指定が行われていません。-Xcheck_section でチェッ
ク指定の取り消しを行っているため警告は出力されません。
flnk907s -cpu MB90754
-ro ROM=0x000a0000/0x000fffff
-ra RAM1=0x00001000/0x00008fff,RAM2=0x00080000/0x000807ff
-sc CODE+CONST=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
→ セクションINITに対して配置指定が行われていませんが, -check_sectionでチェッ
ク指定を行っていないため警告は出力されません。リンカのデフォルト動作です。
July 31, 2015, CM41-00315-6
153
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.43
So ft
Manu al
スタンバイモード遷移命令チェック指定
(-check_SCF)
リンカは , スタンバイモード遷移命令のチェックを必ず行います。
■ スタンバイモード遷移命令チェック指定 (-check_SCF)
【記述形式】
-check_SCF
【パラメータ】
なし
【説明】
本オプションが指定された場合 , リンカは必ずスタンバイモード遷移命令のチェッ
クを行います。
リンカのデフォルト動作では , 起動時に指定された MB 番号が「スタンバイモード
遷移のための低消費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事
項」に該当する品種であった場合にのみスタンバイモード遷移命令のチェックを行
いますが , 本オプションが指定されている場合には 「スタンバイモード遷移のため
,
の低消費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事項」に該当
する・しないに かかわらず,必ずスタンバイモード遷移命令のチェックを行います。
【例】
-check_SCF オプション指定が行われている場合
flnk907s -cpu MB90F462 main.obj standby.obj -check_SCF
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F90001 standby.asm:61)
*** W1379L: 適切でないスタンバイモード遷移命令列をバイト検索で検出し
ました
(mov
io, #imm8, 00F90003 standby.asm:101)
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました
(mov
io, #imm8, 00F90007 standby.asm:122)
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F9000D standby.asm:183)
*** W1379L: 適切でないスタンバイモード遷移命令列をバイト検索で検出し
ました (mov
io, #imm8, 00F9002F standby.asm:211)
*** I0312L: S.C.F チェックで 5 個のワーニングが出力されました
MB90F462 は「スタンバイモード遷移のための低消費電力モード制御レジスタ
(LPMCR) へアクセスする際の注意事項」に該当しませんが , "-check_SCF" オプショ
ン指定により , スタンバイモード遷移命令のチェックが行われます。
154
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
-check_SCF オプション指定が行われていない場合
flnk907s -cpu MB90F462 main.obj standby.obj -check_SCF
MB90F462 は「スタンバイモード遷移のための低消費電力モード制御レジスタ
(LPMCR) へアクセスする際の注意事項」に該当しないためスタンバイモード遷移命
令のチェックは行われません。
July 31, 2015, CM41-00315-6
155
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.44
So ft
Manu al
スタンバイモード遷移命令チェック抑止指定 (-Xcheck_SCF)
リンカは , スタンバイモード遷移命令のチェックを行いません。
■ スタンバイモード遷移命令チェック抑止指定 (-Xcheck_SCF)
【記述形式】
-Xcheck_SCF
【パラメータ】
なし
【説明】
本オプションが指定された場合 , リンカはスタンバイモード遷移命令のチェックは
行いません。
リンカのデフォルト動作では , 起動時に指定された MB 番号が「スタンバイモード
遷移のための低消費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事
項」に該当する品種であった場合にはスタンバイモード遷移命令のチェックを行い
ますが , 本オプションが指定されている場合には 「スタンバイモード遷移のための
,
低消費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事項」に該当す
る・しないに かかわらず , スタンバイモード遷移命令のチェックは行いません。
【例】
-Xcheck_SCF オプション指定が行われている場合
flnk907s -cpu MB90F387 main.obj standby.obj -Xcheck_SCF
MB90F387 は「スタンバイモード遷移のための低消費電力モード制御レジスタ
(LPMCR) へアクセスする際の注意事項」に該当しますが , "-Xcheck_SCF" オプショ
ン指定により , スタンバイモード遷移命令のチェックが行われません。
-Xcheck_SCF オプション指定が行われていない場合
flnk907s -cpu MB90F387 main.obj standby.obj
flnk907s -cpu MB90F462 main.obj standby.obj -check_SCF
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F90001 standby.asm:61)
*** W1379L: 適切でないスタンバイモード遷移命令列をバイト検索で検出し
ました
(mov
io, #imm8, 00F90003 standby.asm:101)
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました
(mov
io, #imm8, 00F90007 standby.asm:122)
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F9000D standby.asm:183)
*** W1379L: 適切でないスタンバイモード遷移命令列をバイト検索で検出し
ました (mov
156
io, #imm8, 00F9002F standby.asm:211)
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
*** I0312L: S.C.F チェックで 5 個のワーニングが出力されました
MB90F387 は「スタンバイモード遷移のための低消費電力モード制御レジスタ
(LPMCR) へアクセスする際の注意事項」に該当するのでスタンバイモード遷移命令
のチェックが行われます。
July 31, 2015, CM41-00315-6
157
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.45
So ft
Manu al
フェッチ単位チェックの指定 (-Wf)
リンカは , スタンバイモード遷移命令のチェック時にフェッチ単位のチェックのみを
行います。
■ フェッチ単位チェックの指定 (-Wf)
【記述形式】
-Wf
【パラメータ】
なし
【説明】
本オプションが指定された場合 , スタンバイモード遷移命令のチェック時にフェッ
チ単位でのチェックのみを行います。
リンカのデフォルト動作では , スタンバイモード遷移命令のチェック時にフェッチ
単位によるチェックとバイト単位によるチェックの両方が行われます。しかし , 本
オプションが指定されている場合には , フェッチ単位のチェックしか行いません。
スタンバイモード遷移命令のチェック方法等詳細につきましては
「F2MC-16LX ファ
ミリ スタンバイモード遷移命令チェックツールマニュアル」を参照してください。
【例】
-Wf オプション指定が行われている場合
flnk907s -cpu MB90F387 main.obj standby.obj -Wf
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F90001 standby.asm:61)
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F90007 standby.asm:122)
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F9000D standby.asm:183)
*** I0312L: S.C.F チェックで 3 個のワーニングが出力されました
"-Wf" オプション指定により , のフェッチ単位のチェックのみ行われバイト単位の
チェックは行われません。
-Wf オプション指定が行われていない場合
flnk907s -cpu MB90F387 main.obj standby.obj
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F90001 standby.asm:61)
*** W1379L: 適切でないスタンバイモード遷移命令列をバイト検索で検出し
ました (mov
158
io, #imm8, 00F90003 standby.asm:101)
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
*** W1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F90007 standby.asm:122)
*** FW1378L: 適切でないスタンバイモード遷移命令列をフェッチ検索で検出
しました (mov
io, #imm8, 00F9000D standby.asm:183)
*** W1379L: 適切でないスタンバイモード遷移命令列をバイト検索で検出し
ました (mov
io, #imm8, 00F9002F standby.asm:211)
*** I0312L: S.C.F チェックで 3 個のワーニングが出力されました
フェッチ単位のチェックとバイト単位のチェックが行われます。
July 31, 2015, CM41-00315-6
159
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
引数のレジスタ渡しのロードモジュール出力指定
オプション (-rp)
6.2.46
-rp オプションは , 関数呼び出しインタフェースが引数のレジスタ渡しのオブジェク
トをリンクする際に指定するオプションです。
-rp, -Xrp どちらの指定もない場合は , 関数呼び出しインタフェースが引数のスタッ
ク渡しのロードモジュールを出力するものとしてリンクします。
■ 引数のレジスタ渡しのロードモジュール出力指定オプション (-rp)
【記述形式】
- rp
【パラメータ】
なし
【説明】
-rp オプションは , 関数呼び出しインタフェースが引数のレジスタ渡しのオブジェク
トをリンクする際に指定するオプションです。
出力されるロードモジュールは引数のレジスタ渡しのロードモジュールとなりま
す。
【例】
flnk907s -cpu mb90704 mod1.obj mod2.obj mod3.obj -rp
<注意事項>
• 以下のような場合 , リンカはエラー (***E4313L: 関数呼び出しインタフェースの異なる
モジュールがあります ( ファイル名 )) を出力します。エラーが出力された場合は , -rp
オプション指定または,入力オブジェクトの関数呼び出しインタフェースを修正してく
ださい。
- -rp オプション指定時 , 引数のスタック渡しのオブジェクトをリンクしようとした場
合
- -Xrp オプション指定時 , 引数のレジスタ渡しのオブジェクトをリンクしようとした
場合
• 引数のレジスタ渡しのオブジェクトをリンクする場合に使用する C ライブラリは , 必
ずファイル名に "_rp" の付いた C ライブラリを使用してください。
160
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
引数のスタック渡しのロードモジュール出力指定
オプション (-Xrp)
6.2.47
-Xrp オプションは , 関数呼び出しインタフェースが引数のスタック渡しのオブジェ
クトをリンクする際に指定するオプションです。
-rp, -Xrp どちらの指定もない場合は , 関数呼び出しインタフェースが引数のスタッ
ク渡しのロードモジュールを出力するものとしてリンクします。
■ 引数のスタック渡しのロードモジュール出力指定オプション (-Xrp)
【記述形式】
( デフォルト )
- Xrp
【パラメータ】
なし
【説明】
-Xrp オプションは , 関数呼び出しインタフェースが引数のスタック渡しのオブジェ
クトをリンクする際に指定するオプションです。
出力されるロードモジュールは引数のスタック渡しのロードモジュールとなりま
す。
-Xrp オプションを指定すると , 既に指定されている -rp オプションを無効にします。
【例】
flnk907s -cpu mb90704 mod1.obj mod2.obj mod3.obj -rp -Xrp
<注意事項>
以下のような場合 , リンカはエラー (***E4313L: 関数呼び出しインタフェースの異なるモ
ジュールがあります ( ファイル名 )) を出力します。エラーが出力された場合は , -rp オプ
ション指定または , 入力オブジェクトの関数呼び出しインタフェースを修正してくださ
い。
• -rp オプション指定時 , 引数のレジスタ渡しのオブジェクトをリンクしようとした場合
• -Xrp オプション指定時 , 引数のスタック渡しのオブジェクトをリンクしようとした場
合
July 31, 2015, CM41-00315-6
161
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
DIR 属性セクション合計サイズチェック指定
(-check_dirsize)
6.2.48
-check_dirsize オプションは , DIR 属性セクションの合計サイズをチェックする際
に指定するオプションです。
-check_dirsize オプション指定時 , DIR 属性セクションの合計サイズが 256 バイト
を超えるとリンカは警告を出力します。
■ DIR 属性セクション合計サイズチェック指定 (-check_dirsize)
【記述形式】
-check_dirsize
( デフォルト )
【パラメータ】
なし
【説明】
-check_dirsize オプションは , DIR 属性セクションの合計サイズをチェックする際に
指定するオプションです。
-check_dirsize オプション指定時 , DIR 属性セクションの合計サイズが 256 バイトを
超えるとリンカは警告 (***W1377L: DIR 属性セクションの合計サイズが 256 バイト
を超えました ) を出力します。
警告が出力された場合 , DIR 属性セクション合計サイズが 256 バイト以下になるよ
うソースを修正してください。
【例】
flnk907s -cpu mb90704 mod1.obj mod2.obj mod3.obj -check_dirsize
<注意事項>
以下のような場合 , DIR 属性セクションの合計サイズが 256 バイトを超えても問題ありま
せん。本メッセージは無視してください。
• アセンブラソースにおいて複数のダイレクトページを使用している場合
• リアルタイム OS のタスクごとに異なったダイレクトページを使用する場合
DIR 属性セクションの合計サイズが 256 バイトを超えても問題ない場合 , -Xcheck_dirsize
オプションでチェックは抑止できます。
162
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.49
Soft
Ma nual
DIR 属性セクション合計サイズチェック抑止指定
(-Xcheck_dirsize)
-Xcheck_dirsize オプションは , DIR 属性セクション合計サイズのチェックを抑止す
る際に指定するオプションです。
■ DIR 属性セクション合計サイズチェック抑止指定 (-Xcheck_dirsize)
【記述形式】
-Xcheck_dirsize
【パラメータ】
なし
【説明】
-Xcheck_dirsize オプションは , DIR 属性セクション合計サイズのチェックを抑止す
る際に指定するオプションです。
-Xcheck_dirsize オプションを指定すると既に指定されている -check_dirsize オプショ
ンを無効にします。
-Xcheck_dirsize オプションを指定すると , DIR 属性セクション合計サイズが 256 バ
イトを超えてもリンカは警告を出力しません。
【例】
flnk907s -check_dirsize -cpu mb90704 mod1.obj mod2.obj mod3.obj -Xcheck_dirsize
July 31, 2015, CM41-00315-6
163
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.50
So ft
Manu al
サイズ 0 のセクション配置チェック指定
(-check_size0_sec)
サイズ 0 のセクションに対して配置チェックを行います。
■ サイズ 0 のセクション配置チェック指定 (-check_size0_sec)
【記述形式】
-check_size0_sec
【パラメータ】
なし
【説明】
サイズが 0 のセクションは , プログラムとして全く意味を持たないため , 本来配置
チェックは不要です。
しかし , サイズが 0 のセクションを含めたすべてのセクションの配置をチェックし
たい場合は , -check_size0_sec を指定してください。
-check_size0_sec を指定すると , サイズが 0 のセクションに対して配置が正しいかを
チェックします。
チェックする項目は以下のとおりです。
• ROM 領域に書込み可能なセクションが配置されていないかをチェック
• RAM 領域に初期値のあるセクションを配置していないかをチェック
• ROM 配置セクションが ROM 領域以外に配置されていないかをチェック
• RAM 配置セクションが RAM 領域以外に配置されていないかをチェック
• IO 配置セクションが IO 領域以外に配置されていないかをチェック
• 配置可能なアドレスが存在するかをチェック
-check_size0_sec を指定すると , サイズ 0 のセクションに対しても以下のメッセージ
が出力されます。
W1301L:ROM 領域に書き込み可能セクションが配置されました ( セクション名 )
W1303L:RAM エリアに初期値のあるセクションが配置されました ( セクション名 )
W1370L:ROM 領域外への配置です ( セクション名 )
W1371L:RAM 領域外への配置です ( セクション名 )
W1372L:RAM 領域または IO 領域外への配置です ( セクション名 )
W1373L:IO 領域外への配置です ( セクション名 )
E4365L: 配置可能なアドレスが領域 " 領域名 " に見つかりません ( セクション名 )
E4366L: 配置可能なアドレスが見つかりません。( セクション名 )
164
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例】
flnk907s -cpu mb90704 -check_size0_sec
module1.obj module2.obj
<注意事項>
サイズ 0 セクションの配置チェックはデフォルトでは行われません。
サイズ 0 セクションの配置チェックを行いたい場合は , -check_size0_sec オプションを指
定してください。
July 31, 2015, CM41-00315-6
165
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.51
So ft
Manu al
サイズ 0 のセクション配置チェック抑止指定
(-Xcheck_size0_sec)
サイズ 0 のセクションの配置チェックを抑止します。
-Xcheck_size0_sec を指定してもサイズが 0 ではないセクションは , 通常どおり配
置チェックを行います。
■ サイズ 0 のセクション配置チェック抑止指定 (-Xcheck_size0_sec)
【記述形式】
-Xcheck_size0_sec
( デフォルト )
【パラメータ】
なし
【説明】
サイズが 0 のセクションは , プログラムとして全く意味を持たないため , 本来配置
チェックは不要です。
サイズ 0 のセクションの配置チェックを行いたくない場合は , -Xcheck_size0_sec を
指定してください。
-Xcheck_size0_sec を指定してもサイズが 0 ではないセクションの配置チェックは通
常どおり行います。
抑止されるチェック項目は以下のとおりです。
• ROM 領域に書込み可能なセクションが配置されていないかをチェック
• RAM 領域に初期値のあるセクションを配置していないかをチェック
• ROM 配置セクションが ROM 領域以外に配置されていないかをチェック
• RAM 配置セクションが RAM 領域以外に配置されていないかをチェック
• IO 配置セクションが IO 領域以外に配置されていないかをチェック
• 配置可能なアドレスが存在するかをチェック
-Xcheck_size0_sec を指定することによって , サイズ 0 のセクションに対して以下の
メッセージの出力が抑止されます。
W1301L:ROM 領域に書き込み可能セクションが配置されました ( セクション名 )
W1303L:RAM エリアに初期値のあるセクションが配置されました ( セクション名 )
W1370L:ROM 領域外への配置です ( セクション名 )
W1371L:RAM 領域外への配置です ( セクション名 )
W1372L:RAM 領域または IO 領域外への配置です ( セクション名 )
W1373L:IO 領域外への配置です ( セクション名 )
E4365L: 配置可能なアドレスが領域 " 領域名 " に見つかりません ( セクション名 )
E4366L: 配置可能なアドレスが見つかりません。( セクション名 )
【例】
flnk907s -cpu mb90704 -Xcheck_size0_sec
166
module1.obj module2.obj
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.52
Soft
Ma nual
相対アセンブルリスト入力ディレクトリ指定 (-alin)
相対アセンブルリストファイルが格納されているディレクトリを指定します。
このオプションがない場合は , オブジェクトモジュールと同じ場所となります。
■ 相対アセンブルリスト入力ディレクトリ指定 (-alin)
【記述形式】
-alin < パス名 >
【パラメータ】
< パス名 >
相対アセンブルリストファイルが格納されているディレクトリ
【説明】
絶対アセンブルリストファイルを出力するときに , 使用するオプションです。
相対アセンブルリストファイルが格納されているディレクトリを指定します。
本オプションの指定がない場合は,オブジェクトモジュールと同じ場所になります。
-alf オプションで , 相対アセンブルリストファイルをパス名付きで指定している場
合には , -alf オプション指定のパスを優先します。
【例】
flnk907s *.obj -o ap.abs -alin d: \ fmc16 -alf swctr1.lst,mstdef.lst
flnk907s *.obj -o ap.abs -alsf d: \ fmc16 \ swctrl.lst,d: \ fmc16 \ mstdef.lst
上記の 2 つの例は同じ意味です。
July 31, 2015, CM41-00315-6
167
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.53
So ft
Manu al
絶対アセンブルリスト出力ディレクトリ指定 (-alout)
絶対アセンブルリストファイルを出力するディレクトリを指定します。
■ 絶対アセンブルリスト出力ディレクトリ指定 (-alout)
【記述形式】
-alout < パス名 >
【パラメータ】
< パス名 >
絶対アセンブルリストファイルを出力するディレクトリ
【説明】
絶対アセンブルリストファイルを出力するディレクトリを指定します。
本オプションの指定がない場合は , カレントディレクトリとなります。
【例】
flnk907s *.obj -o ap.abs -alin d: \ fmc16 -alf swctrl.lst,mstdef.lst
-alout d: \ fmc16 \ als
168
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.54
Soft
Ma nual
絶対アセンブルリスト出力指定 (-als)
絶対アセンブルリストファイルの出力を指定します。
すべてのオブジェクトモジュールに対する出力指示です。
■ 絶対アセンブルリスト出力指定 (-als)
【記述形式】
-als
【パラメータ】
なし
【説明】
すべてのモジュールに対して絶対アセンブルリストを作成することを指示します。
本オプションの指定がないときは , 絶対アセンブルリストの作成を行いません。
前に指定した , -alsf, -Xals を無効にします。
【例】
flnk907s *.obj -o ap.abs -als
July 31, 2015, CM41-00315-6
169
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.55
So ft
Manu al
絶対アセンブルリスト出力モジュール指定 (-alsf)
絶対アセンブルリストファイルを出力するモジュールを指定します。
オブジェクトモジュールに対する選択出力指示を行います。
■ 絶対アセンブルリスト出力モジュール指定 (-alsf)
【記述形式】
-alsf < 相対アセンブルリストファイル名 > [, … ]
【パラメータ】
< 相対アセンブルリストファイル名 >
絶対アセンブルリスト作成の元になる相対アセンブルリストファイル名
ファイル名の指定にはワイルドカードが使えます。
【説明】
絶対アセンブルリストを作成するモジュールを選択します。
モジュールの指定は , 相対アセンブルリストファイル名で行います。拡張子を省略
した場合には , ".lst" を仮定します。
指定されなかったモジュールは , 絶対アセンブルリストの作成を行いません。
本オプションは , 複数に分けて指定できます。
前に指定した , -als, -Xals を無効にします。
-alin オプションより相対アセンブルリストの格納パスを指定できますので , 本オプ
ション指定時にはパス指定を省略することが可能です。
【例】
flnk907s *.obj -o ap.abs -alsf swctrl.lst,mstdef.lst
flnk907s *.obj -o ap.abs -alsf swctrl.lst -alsf mstdef.lst
flnk907s *.obj -o ap.abs -alsf swctrl -alsf mstdef
上記の 3 つの例は同じ意味です。
170
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.56
Soft
Ma nual
絶対アセンブルリスト出力抑止指定 (-Xals)
すべてのモジュールに対して絶対アセンブルリストを , 作成しないことを指示しま
す。
■ 絶対アセンブルリスト出力抑止指定 (-Xals)
【記述形式】
( デフォルト )
-Xals
【パラメータ】
なし
【説明】
すべてのモジュールに対して絶対アセンブルリストを作成しないことを指示しま
す。
本オプションはデフォルトです。
前に指定した , -als, -alsf を無効にするときに使用します。
【例】
flnk907s *.obj -o ap.abs -alsf sectrl.lst,mstdef.lst -xals
July 31, 2015, CM41-00315-6
171
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.57
So ft
Manu al
ROM/RAM, ARRAY リスト出力指定 (-alr)
ROM/RAM, ARRAY リストを出力指定します。
コンパイル , アセンブル時にデバッグ情報が出力されていることが必要です。
■ ROM/RAM, ARRAY リスト出力指定 (-alr)
【記述形式】
-alr
【パラメータ】
なし
【説明】
すべての絶対アセンブルリストに ROM/RAM, ARRAY リストを付加します。
本オプションを使用する場合 , -als オプションは省略できます。
前に指定した , -alrf, -Xalr を無効にします。
ROM/RAM, ARRAY リストを出力するためには , コンパイル , アセンブル , リンク時
にデバッグ情報出力オプション (-g) を指定してください。
【例】
flnk907s *.obj -o ap.abs -als -alr -g
flnk907s *.obj -o ap.abs -alr -g
上記の 2 つの例は同じ意味です。
172
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.58
Soft
Ma nual
ROM/RAM, ARRAY リスト出力モジュール指定
(-alrf)
ROM/RAM, ARRAY リストを出力するモジュールを指定します。
コンパイル , アセンブル時にデバッグ情報が出力されていることが必要です。
■ ROM/RAM, ARRAY リスト出力モジュール指定 (-alrf)
【記述形式】
-alrf < 相対アセンブルリストファイル名 > [, … ]
【パラメータ】
< 相対アセンブルリストファイル名 >
ROM/RAM, ARRAYリストを出力するモジュールを相対アセンブルリストファイル
名で指定します。
ファイル名の指定にはワイルドカードが使えます。
【説明】
絶対アセンブルリストにROM/RAM, ARRAYリストを付加して出力したいモジュー
ルを選択します。
モジュールの指定は , 相対アセンブルリストファイル名で行います。拡張子を省略
した場合には , ".lst" を仮定します。
指定されなかったモジュールは , ROM/RAM, ARRAY リストが作成されません。
本オプションを使用する場合 , -alsf オプションは省略できます。
本オプションは , 複数に分けて指定できます。
前に指定した , -alr, -Xalr を無効にします。
【例】
flnk907s *.obj -o ap.abs -alsf swctrl.lst,mstdef.lst-alrf swctrl.lst,mstdef.lst
flnk907s *.obj -o ap.abs -alsf swctrl.lst -alrf mstdef.lst,mstdef.lst
flnk907s *.obj -o ap.abs -alrf swctrl -alrf mstdef
上記の 3 つの例は同じ意味です。
July 31, 2015, CM41-00315-6
173
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.59
So ft
Manu al
ROM/RAM, ARRAY リスト出力抑止指定 (-Xalr)
すべての絶対アセンブルリストに ROM/RAM, ARRAY リストを付加しないことを指
定します。
■ ROM/RAM, ARRAY リスト出力抑止指定 (-Xalr)
【記述形式】
( デフォルト )
-Xalr
【パラメータ】
なし
【説明】
すべての絶対アセンブルリストにROM/RAM, ARRAYリストを付加しないことを指
定します。
本オプションは , デフォルトのため特に指定する必要はありません。
前に指定した , -alr, -alrf を無効にします。
【例】
flnk907s *.obj -o ap.abs -als -alr -Xalr
flnk907s *.obj -o ap.abs -als -Xalr
上記の 2 つの例は同じ意味です。
174
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.60
Soft
Ma nual
ROM/RAM, ARRAY リストのシンボルとアドレスの
表示位置指定 (-na, -an)
ROM/RAM, ARRAY リストのシンボルとアドレスの表示位置の指定を行います。
-na が指定された場合 , シンボル (NAME), アドレス (ADDRESS) の順に出力します。
-an が指定された場合 , アドレス (ADDRESS), シンボル (NAME) の順に出力します。
■ ROM/RAM, ARRAY リストのシンボルとアドレスの表示位置指定 (-na, -an)
【記述形式】
( デフォルト )
-na
【パラメータ】
なし
【説明】
ROM/RAM, ARRAY リストのシンボルとアドレスを NAME, ADDRESS の順に出力
します。
シンボルはアルファベット順に出力します。
ROM/RAM, ARRAY リストが出力指定されたモジュールに対してのみ有効です。
このオプションの機能はデフォルトですので, -anオプションを取り消すときに指定
します。
【例】
flnk907s *.obj -o ap.abs -alr -na
flnk907s *.obj -o ap.abs -alr
上記の 2 つの例は同じ意味です。
【記述形式】
-an
【パラメータ】
なし
【説明】
ROM/RAM, ARRAY リストのシンボルとアドレスを ADDRESS, NAME の順に出力
します。
シンボルはアドレス順に出力します。
-na オプション ( デフォルト ) を変更するときに使用します。
ROM/RAM, ARRAY リストが出力指定されたモジュールに対してのみ有効です。
July 31, 2015, CM41-00315-6
175
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例】
flnk907s *.obj -o ap.abs -alr -na -an
flnk907s *.obj -o ap.abs -alr -an
上記の 2 つの例は同じ意味です。
176
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.61
Soft
Ma nual
外部シンボル相互参照情報リスト出力指定 (-xl)
外部シンボル相互参照情報リストファイルを出力指定します。
■ 外部シンボル相互参照情報リスト出力指定 (-xl)
【記述形式】
-xl
【パラメータ】
なし
【説明】
外部シンボル相互参照情報リストファイルを作成することを指示します。
本オプションの指定がないときは , 外部シンボル相互参照情報リストファイルの作
成を行いません。
【例】
flnk907s *.obj -o ap.abs -xl
July 31, 2015, CM41-00315-6
177
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.62
So ft
Manu al
外部シンボル相互参照情報リストファイル名の指定
(-xlf)
外部シンボル相互参照情報リストファイルの出力先ディレクトリやファイル名を変
更したいときに使用します。
■ 外部シンボル相互参照情報リストファイル名の指定 (-xlf)
【記述形式】
-xlf < 出力ファイル名 >
【パラメータ】
< 出力ファイル名 >
出力ファイル名を指定します。出力先のディレクトリを変更するときは前にパス名
を付けます。
【説明】
指定した名前で外部シンボル相互参照情報リストファイルを作成します。
本オプションを使用する場合 , -xl オプションは省略できます。
< 出力ファイル名 > 指定で拡張子を省略した場合は , デフォルト拡張子 ".mpx" が付
加されます。
本オプションの指定がない場合は , 絶対形式ロードモジュールファイル名の拡張子
を ".mpx" に直したものを , 出力ファイル名とします。
【例】
flnk907s *.obj -o ap.abs -xl -xlf ccp903.mpx
flnk907s *.obj -o ap.abs -xlf ccp903
上記の 2 つの例は同じ意味です。
178
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.63
Soft
Ma nual
外部シンボル相互参照情報リスト出力抑止指定 (-Xxl)
外部シンボル相互参照情報リストファイルを出力抑止指定します。
■ 外部シンボル相互参照情報リスト出力抑止指定 (-Xxl)
【記述形式】
( デフォルト )
-Xxl
【パラメータ】
なし
【説明】
外部シンボル相互参照情報リストファイルの出力抑止を指示します。
本オプションは , デフォルトのため特に指定する必要はありません。
前に指定した , -xl, -xlf を無効にします。
【例】
flnk907s *.obj -o ap.abs -xl -Xxl
flnk907s *.obj -o ap.abs -Xxl
flnk907s *.obj -o ap.abs
上記の 3 つの例は同じ意味です。
July 31, 2015, CM41-00315-6
179
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.64
So ft
Manu al
ローカルシンボル情報リスト出力指定 (-sl)
ローカルシンボル情報リストファイルを出力指定します。この場合 , コンパイル , ア
センブル , リンク時にデバッグ情報が出力されていることが必要です。
■ ローカルシンボル情報リスト出力指定 (-sl)
【記述形式】
-sl
【パラメータ】
なし
【説明】
ローカルシンボル情報リストファイルを作成することを指示します。
本オプションの指定がないときは , ローカルシンボル情報リストファイルの作成を
行いません。
ローカルシンボル情報リストファイルを出力するためには , コンパイル , アセンブ
ル , リンク時にデバッグ情報出力オプション (-g) を指定してください。
【例】
flnk907s *.obj -o ap.abs -sl -g
180
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.65
Soft
Ma nual
ローカルシンボル情報リストファイル名の指定 (-slf)
ローカルシンボル情報リストファイルの出力先ディレクトリやファイル名を変更し
たいときに使用します。
■ ローカルシンボル情報リストファイル名の指定 (-slf)
【記述形式】
-slf < 出力ファイル名 >
【パラメータ】
< 出力ファイル名 >
出力ファイル名を指定します。出力先のディレクトリを変更するときは前にパス名
を付けます。
【説明】
指定した名前でローカルシンボル情報リストファイルを作成します。
本オプションを使用する場合 , -sl オプションは省略できます。
< 出力ファイル名 > 指定で拡張子を省略した場合は , デフォルト拡張子 ".mps" が付
加されます。
本オプションの指定がない場合は , 絶対形式ロードモジュールファイル名の拡張子
を ".mps" に直したものを , 出力ファイル名とします。
【例】
flnk907s *.obj -o ap.abs -sl -slf ccp903.mps -g
flnk907s *.obj -o ap.abs -slf ccp903 -g
上記の 2 つの例は同じ意味です。
July 31, 2015, CM41-00315-6
181
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.66
So ft
Manu al
ローカルシンボル情報リスト出力抑止指定 (-Xsl)
ローカルシンボル情報リストファイルを出力抑止指定します。
■ ローカルシンボル情報リスト出力抑止指定 (-Xsl)
【記述形式】
( デフォルト )
-Xsl
【パラメータ】
なし
【説明】
ローカルシンボル情報リストファイルの出力抑止を指示します。
本オプションは , デフォルトのため特に指定する必要はありません。
前に指定した , -sl, -slf を無効にします。
【例】
flnk907s *.obj -o ap.abs -sl -Xsl
flnk907s *.obj -o ap.abs -Xsl
flnk907s *.obj -o ap.abs
上記の 3 つの例は同じ意味です。
182
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.67
Soft
Ma nual
セクション詳細マップリスト出力指定 (-ml)
セクション詳細マップリストファイルを出力指定します。
■ セクション詳細マップリスト出力指定 (-ml)
【記述形式】
-ml
【パラメータ】
なし
【説明】
セクション詳細マップリストファイルを作成することを指示します。
本オプションの指定がないときは , セクション詳細マップリストファイルの作成を
行いません。
【例】
flnk907s *.obj -o ap.abs -ml
July 31, 2015, CM41-00315-6
183
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.68
So ft
Manu al
セクション詳細マップリストファイル名の指定 (-mlf)
セクション詳細マップリストファイルの出力先ディレクトリやファイル名を変更し
たいときに使用します。
■ セクション詳細マップリストファイル名の指定 (-mlf)
【記述形式】
-mlf < 出力ファイル名 >
【パラメータ】
< 出力ファイル名 >
出力ファイル名を指定します。出力先のディレクトリを変更するときは前にパス名
を付けます。
【説明】
指定した名前でセクション詳細マップリストファイルを作成します。
本オプションを使用する場合 , -ml オプションは省略できます。
< 出力ファイル名 > 指定で拡張子を省略した場合は , デフォルト拡張子 ".mpm" が付
加されます。
本オプションの指定がない場合は , 絶対形式ロードモジュールファイル名の拡張子
を ".mpm" に直したものを , 出力ファイル名とします。
【例】
flnk907s *.obj -o ap.abs -ml -mlf ccp903.mpm
flnk907s *.obj -o ap.abs -mlf ccp903
上記の 2 つの例は同じ意味です。
184
CM41-00315-6, July 31, 2015
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.69
Soft
Ma nual
セクション詳細マップリスト出力抑止指定 (-Xml)
セクション詳細マップリストファイルを出力抑止指定します。
■ セクション詳細マップリスト出力抑止指定 (-Xml)
【記述形式】
( デフォルト )
-Xml
【パラメータ】
なし
【説明】
セクション詳細マップリストファイルの出力をすることを抑止指示します。
本オプションは , デフォルトのため特に指定する必要はありません。
前に指定した , -ml, -mlf を無効にします。
【例】
flnk907s *.obj -o ap.abs -ml -Xml
flnk907s *.obj -o ap.abs -Xml
flnk907s *.obj -o ap.abs
上記の 3 つの例は同じ意味です。
July 31, 2015, CM41-00315-6
185
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
186
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第7章
リンカの出力リスト
ファイル
この章では , リンカの出力する各リストファイルの
フォーマット , 情報の見方について説明します。
7.1 リンカの出力するリストファイルの種類
7.2 リンクリストファイル
7.3 絶対アセンブルリストファイル
7.4 外部シンボル相互参照情報リストファイル
7.5 ローカルシンボル情報リストファイル
7.6 セクション配置詳細情報リストファイル
July 31, 2015, CM41-00315-6
187
第 7 章 リンカの出力リスト ファイル
7.1 リンカの出力するリストファイルの種類
Su pp or t
7.1
So ft
Manu al
リンカの出力するリストファイルの種類
リンカが出力するリストファイルは以下の 5 つです。
• リンクリストファイル
• 絶対形式アセンブルリスト
• 外部シンボル相互参照情報リスト
• ローカルシンボル情報リスト
• セクション詳細マップリスト
これらのファイルは , リンカ起動時のオプションで , 出力するかどうか選択できます。
■ リンクリストファイル
リンクリストファイルは , リンカ起動時のオプションや入力モジュール名 , モジュール
リンク後のセクションと外部シンボルの情報が出力されます。
■ 絶対形式アセンブルリスト
絶対形式アセンブルリストは , モジュールリンク後の情報をもとに , アセンブラが出力
した相対形式のアセンブルリストを絶対形式で表示したリストです。
アセンブラ言語レベルでのデバッグを行う場合に参照でき,リンクリストではわからな
い機械語の 1 ステップ単位のアドレスを確認できます。
■ 外部シンボル相互参照情報リスト
外部シンボル相互参照情報リストは,リンク後の各モジュールの外部定義シンボルと外
部参照シンボルのモジュール間相互参照の情報が出力されます。
■ ローカルシンボル情報リスト
ローカルシンボル情報リストは,リンク後のモジュールごとのローカルシンボルを含ん
だ変数や関数などの情報を出力します。
■ セクション詳細マップリスト
セクション詳細マップリストは,リンク後のモジュールごとのセクション配置の情報を
作成します。
188
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
7.2
Soft
Ma nual
リンクリストファイル
リンクリストファイルは , 情報内容により 4 つの部分に分かれています。
• コントロールリスト
• マップリスト
• メモリ使用情報リスト
• 外部シンボルリスト
ここでは , それぞれに出力される項目を説明します。
■ リンクリストファイルの構成
リンカのリストファイルは , 4 つの部分に分かれています。
● コントロールリスト
• 指定されたオプション
• 入力オプション
• エラーメッセージ
● マップリスト
• セクション名
• セクション属性
• リンク後のセクション配置アドレス
● メモリ使用情報リスト
• ROM/RAM 使用情報
• 領域内情報
• 総合評価情報
● 外部シンボルリスト
• 外部シンボル名
• 定義 , 参照の種別
• シンボルの値
各リストの境界には , 改ページの制御文字が出力されます。
July 31, 2015, CM41-00315-6
189
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
7.2.1
So ft
Manu al
コントロールリスト
コントロールリストには , リンカを実行したときに指定したオプションと , 入力モ
ジュール名を表示します。また , リンク処理中に発見したエラーも表示します。
■ コントロールリスト部のリスト出力フォーマット
図 7.2-1 にコントロールリスト部のリスト出力フォーマットを示します。
図 7.2-1 コントロールリスト部のリスト出力フォーマット
F2MC-16 Family SOFTUNE Linker
Control List
YYYY-MM-DD hh:mm:ss Page:
1
Option File(s)
① オプションファイル名表示エリア
Control(s)
② リンカ制御オプション表示エリア
Input Module(s)
③ 入力モジュール表示エリア
Error(s)
④ エラーメッセージ表示エリア
ページヘッダ
先頭行にリンカ名, リスト名, 日時, ページ番号を表示します。
① オプションファイル名表示エリア
オプションファイルが使用された場合に, そのファイル名を表示します。
使用されなかった場合は, 「** no use **」を表示します。
② リンカ制御オプション表示エリア
指定されたオプションおよびデフォルトで有効としたオプションを表示します。
オプションファイル内で指定されたオプションの場合, オプションの前に@を付けます。
③ 入力モジュール表示エリア
1から始まる通し番号を付けて, ファイル名とモジュール名を表示します。
④ エラーメッセージ表示エリア
処理中に検出したエラーメッセージを表示します。
エラーがない場合は, 「** Nothing **」を表示します。
190
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ コントロールリスト部のリスト表示例
図 7.2-2 にコントロールリスト部のリスト表示例を示します。
図 7.2-2 コントロールリスト部のリスト表示例
F2MC-16 Family SOFTUNE Linker Control List
2003-08-26 15:18:11 Page:
1
Option File(s)
** no use **
Control(s)
-g
-a
-l usrlb.lib
-ro prog=0x8000/0xffff
-ra data=0x0000/0x03ff
-sc P+code=prog,D+data+S=data
Input Module(s)
1 pca02.obj(pca01)
2 pcasb.obj(pcasb)
3 xccdef.obj(xccdef)
Error(s)
** Nothing **
July 31, 2015, CM41-00315-6
191
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
7.2.2
So ft
Manu al
マップリスト
マップリストには , セクションの名前 , 内容種別 , 属性と結合後のセクション配置ア
ドレスを表示します。
■ マップリスト部のリスト出力フォーマット
マップリスト部のリスト出力フォーマットを図 7.2-3 に示します。
図 7.2-3 マップリスト部のリスト出力フォーマット
F2MC-16 Family SOFTUNE Linker Mapping List YYYY-MM-DD hh:mm:ss Page:
S_Addr. -E_Addr. Size
Section Type Al
Sec.(Top **)
2
C
① マップ情報表示エリア
ページヘッダ
先頭行にリンカ名, リスト名, 日時, ページ番号を表示します。
① マップ情報表示エリア
マップ情報は, 開始アドレス順, ただし, 開始アドレスが同じ場合はセクション出現順
に表示されます。
S-Addr
:セクションの開始アドレス (16進)
未使用関数削除機能により削除されたセクションは, "--------"と表示します。
E-Addr
:セクションの終了アドレス (16進)
未使用関数削除機能により削除されたセクションは, "--------"と表示します。
Size
:セクションのサイズ (16進)
未使用関数削除機能により削除されたセクションは, "--------"と表示します。
Section
:セクション内容種別
セクションの内容種別を表示します。
CODE
プログラムセクション
DATA
データセクション
CONST
初期値付データセクション
STACK
スタックセクション
IO
IOセクション
DIR
DIRセクション
DIRC
DIRCONSTセクション
セクション種別の後に, 結合属性を表示します。
P 単純連結結合
C 共有結合
N 結合なし
type
:セクションの属性
左から順に, 以下の属性を表示します。
R/- Read可/不可
W/- Write可/不可
X/- 実行可/不可
I/- 初期値あり/なし
Al
:セクション配置時の境界調整数 (16進)
境界調整数が0x100以上の場合は, "**"と表示されます。
Sec.(Top **) :セクション名
ROM→RAM転送セクションで生成されたセクションには先頭に"#"が
表示されます。
"**"は, 指定されたページ幅でセクション名が何桁表示できるかか
を示します。
(注意事項)セクションサイズが"0"のセクションの終了アドレスは, 「........」で表示します。
192
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ マップリスト部のリスト表示例
図 7.2-4 にマップリスト部のリスト表示例を示します。
図 7.2-4 マップリスト部のリスト表示例
F2MC-16 Family SOFTUNE Linker
S_Addr.
-E_Addr.
Size
Mapping List
Section
Type Al
2003-08-09 20:41:12
Page:
Sec.(Top 29)
00000000 -0000001F 00000020
DATA P RW-- 08 REL D
00000020 -00000039 0000001A
DATA P RW-- 02 REL data
0000003A -00000053 0000001A
STAK P RW-- 02 REL S
00000054 -0000006D 0000001A
DATA P RW-I 02 REL init
00008000 -00008039 0000003A
CODE P R-XI 02 REL P
0000803A -00008053 0000001A
CODE P R-XI 02 REL code
00008054 -0000806D 0000001A
DATA P R--I 02 REL #init
2
C
■ 未使用関数削除機能により削除されたセクションのマップリスト表示例
未使用関数削除機能により削除されたセクションのマップリスト表示例を図 7.2-5 に
示します。
削除されたセクションの S_Addr., E_Addr., Size は ,"--------" と表示します。
図 7.2-5 削除されたセクションのリスト表示例
F2MC-16 Family SOFTUNE Linker
S_Addr.
-E_Addr.
Size
Mapping List
Section
Type Al
2015-08-01 16:41:12
Sec.(Top 29)
00008024 -00008025 00000002
CODE P R-XI 01 REL CODE_main_func1
00008026 -0000802F 0000000A
CODE P R-XI 01 REL CODE_main_main
-------- --------- --------
CODE P R--I 01 REL CODE_main_func2
July 31, 2015, CM41-00315-6
Page:
2
C
193
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
7.2.3
So ft
Manu al
メモリ使用情報リスト
メモリ使用情報リストには , RAM 指定領域と ROM 指定領域の , 領域名 , 空きまたは
オーバ領域サイズ , 指定領域の先頭・終端アドレスなどを表示します。
■ メモリ使用情報リスト部のリスト出力フォーマット
メモリ使用情報リスト部のリスト出力フォーマットを図 7.2-6 に示します。
図 7.2-6 メモリ使用情報リスト部のリスト出力フォーマット
F2MC-16 Family SOFTUNE Linker ROM/RAM Used Info YYYY-MM-DD hh:mm:ss Page:
S_Addr. -E_Addr.
Size
Remain
Name/State
3
C
① ROM/RAM使用情報
.....
② 領域内情報
③ 総合評価値情報
.....
ページヘッダ
先頭行にリンカ名, リスト名, 日時, ページ番号を表示します。
① ROM/RAM使用情報表示エリア
・ ROM/RAM使用情報表示エリア内で, 出力された行の先頭に "#" の文字が付いた行は,
-ro, -raオプションにより指定された情報を表示しています。
・ 出力された行の先頭に "#" の文字が付いていない行は, 有効エリア内のセクション
群の先頭アドレス, 終端アドレス, ギャップ領域を含む使用領域サイズと使用領域サ
イズに対する過不足値を表示しています。
・ -ro, -raオプションにより指定された領域に, 配置できなかったセクションのセク
ション名とセクションサイズの表示も行います。
S-Addr
: 開始アドレス (16進)
E-Addr
: 終了アドレス (16進)
Size
: 領域サイズ (16進)
Remain
: メモリ内の状況領域サイズ (16進)
先頭の記号は以下のことを示します。
+
: 空き領域サイズ
: オーバ領域サイズ
スペース
: 空き/オーバ領域がゼロの場合
Name/State
: メモリ領域名, セクション名
② 領域内情報エリア
領域内情報エリアは, 有効エリア内の空き領域, 使用済領域, ギャップ領域をマップイ
メージで表示します。
この情報エリアに表示される情報は, 指定領域に対して配置されたセクションのみの情報
です。
S-Addr
: 領域の開始アドレス (16進)
E-Addr
: 領域の終了アドレス (16進)
Size
: 領域サイズ (16進)
Name/State
: 領域タイプ
FREE
: 空き領域
USED
: 使用済領域
GAP
: ギャップ領域
③ 総合評価値情報
総合評価値情報は, ROMエリアの総合とRAMエリアの総合の2つに対して, 以下の3つの情報
を表示します。
・ 指定領域の合計値 (Total)
・ 使用した領域の合計値 (Used) (注意事項:ギャップ領域を含む)
・ 空きまたはオーバ領域の合計値 (Remainder)
194
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ メモリ使用情報リスト部のリスト表示例
図 7.2-7 にメモリ使用情報リスト部のリスト表示例を示します。
図 7.2-7 メモリ使用情報リスト部のリスト表示例
F2MC-16 Family SOFTUNE Linker ROM/RAM Used Info List 2003-09-02 20:45:25
S-Addr.
- E-Addr.
Size
Remain
- 00001FFF
- 00001774
00001000
00000775
--------RAM1
+0000088B
-
00001136
00001137
0000152B
0000152F
00001774
00001FFF
00000137
00000001
000003F4
00000004
00000245
0000088B
-------------------------------------------------
# 00002000
- 000023FF
00002000
- 00003A1E
** Not Locate **
** Not Locate **
00000400
00001A1F
00000B28
00000EF6
--------RAM2
-0000161F
--------data01
--------data02
00000400
---------
# 00001000
00001000
00001000
00001137
00001138
0000152C
00001530
00001775
00002000
- 000023FF
RAM -- Total(00001400) Used(00002194)
Name/State
---------00001100
ROM1
000BC000
- 000BCFFF
00001000
---------
USED
# 000BD000
000BD000
- 000BFFFF
- ........
00003000
00000000
--------ROM2
+00003000
000BD000
- 000BFFFF
00003000
---------
(*3):
RAM1領域の情報
←(*1)
←配置できなかったセクション情報(*2)
Remainder(-00000D94)
00001000
00002100
(*2):
←オプションで指定したメモリ領域
←配置したセクションに対するメモリ状況
RAM2領域の情報
FREE
- 000BCFFF
- 000BDFFF
説明
(*1):
3
C
USED
GAP
USED
GAP
USED
FREE
# 000BC000
000BBF00
ROM -- Total(00004000) Used(00002100)
Page:
←全RAM領域の情報
←(*3)
←ROM1領域の情報
ROM2領域の情報
FREE
Remainder(+00001F00)
←全ROM領域の情報
自動配置オプションによりメモリ領域にセクションを配置しようとして配置できなかったセクションが
あるメモリ領域の情報は, そのセクションのサイズを加えた状態を示しています。 (数値表現として
0xFFFFFFFFを超えた場合, その数値の下位32bit分が表示されます。)
自動配置オプションのモード2が指定された場合の配置できなかったセクションは, (ROM領域, RAM領域
のどちらかの)最後に指定されたメモリ領域に対して表示を行います。
ユーザ配置指定が行われたセクションは, そのセクションの先頭アドレスが含まれるメモリ領域に含みま
す。
July 31, 2015, CM41-00315-6
195
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
7.2.4
So ft
Manu al
シンボルリスト
シンボルリストには , 外部シンボル名 , 定義 , 参照の種別 , シンボルの値を表示しま
す。
■ シンボルリスト部のリスト出力フォーマット
シンボルリスト部のリスト出力フォーマットを図 7.2-8 に示します。
図 7.2-8 シンボルリスト部のリスト出力フォーマット
F2MC-16 Family SOFTUNE Linker
Symbol Value
Type
Def.
Symbol List
YYYY-MM-DD hh:mm:ss
Page:
Symbol Name(Top **)
1
C
① シンボルリストエリア
ページヘッダ
先頭行にリンカ名, リスト名, 日時, ページ番号を表示します。
① シンボルリスト表示エリア
Symbol Value
: シンボルアドレス or シンボル値
(16進)
未使用関数削除機能により削除された関数は, "--------(DEL)"と表示します。
Type
: シンボル種別
以下のどれかが表示されます。
Addr.
: シンボルはアドレスレベルです。
EQU
: シンボルはEQU定義シンボルです。
bit
: シンボルはビット属性です。
Def. : シンボルの定義
以下のどれかが表示されます。
OM/LM : 入力オブジェクトモジュールまたは相対形式ロードモジュール
中で定義されています。
LIB
: 結合されたライブラリ中で定義されています。
user
: -df オプションにより値を仮設定されたシンボルです。
Symbol Name
: シンボル名
"**"は, 指定されたページ幅でシンボル名が何桁表示できるかを示します。
(注意事項)
シンボルが, 参照されている場合は, そのままシンボル名を表示し, 参照されていない場合
は, シンボル名の先頭に"@"を付けて表示します。
196
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ シンボルリスト部のリスト表示例
図 7.2-9 にシンボルリスト部のリスト表示例を示します。
図 7.2-9 シンボルリスト部のリスト表示例
F2MC-16 Family SOFTUNE Linker Symbol List
Symbol Value
00000004(ABS)
00000008(ABS)
000000C4(ABS)
00000018(ABS)
Type
Addr.
Addr.
Addr.
Addr.
Def.
OM/LM
OM/LM
OM/LM
OM/LM
2003-10-26 15:26:20
Page:
Symbol Name(Top **)
_Filename
_c1
_main
_ulval
3
C
■ 削除された関数のシンボルリスト表示例
未使用関数削除機能により削除された関数のシンボルリスト表示例を図 7.2-10 に示し
ます。
削除された関数の Symbol Value は ,"--------(DEL)" と表示します。
図 7.2-10 削除された関数のシンボルリスト部のリスト表示例
F2MC-16 Family SOFTUNE Linker Symbol List
Symbol Value
00008024(ABS)
Type
Addr.
- - - - - - - -(DEL)
Addr.
00008026(ABS)
Addr.
July 31, 2015, CM41-00315-6
Def.
Symbol Name(Top **)
OM/LM @_func1
func1
OM/LM @_func2
func2
OM/LM @_main
main
2015-08-01 15:26:32
Page:
3
C
197
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
7.3
So ft
Manu al
絶対アセンブルリストファイル
リンカが出力する絶対形式アセンブルリストは , 以下により構成されています。
• ヘッダ
• インフォメーションリスト
• ROM/RAM, ARRAY リスト
• アセンブルソースリスト
• セクション情報リスト
• クロスリファレンスリスト
ここでは , それぞれに出力される項目を説明します。
■ 絶対アセンブルリストの形式
● ヘッダ
各ページの先頭に出力されます。
● インフォメーションリスト
アセンブラが出力したインフォメーションリストをそのまま出力します。
● ROM/RAM, ARRAY リスト
• ROM/RAM リスト : ROM/RAM 領域に配置されているグローバルシンボルの名前 ,
絶対アドレス情報などが出力されます。
• ARRAY リスト :
配列要素の名前 , 構造体のメンバ名 , 絶対アドレス情報などが
出力されます。
オプション -alr を指定すると , ROM/RAM, ARRAY リストを表示します。-Xalr を指定
すると ROM/RAM, ARRAY リストは表示されません。
● アセンブルソースリスト
アセンブルソースリストは,ソースプログラムをアセンブルしたときの様々な情報を行
単位に表示したものです。エラー情報 , ロケーション , オブジェクトコードなどが表示
されます。
● セクション情報リスト
ソースプログラム内で定義されたセクションの名前 , 属性などが表示されます。
● クロスリファレンスリスト
ソースプログラム内で使用しているシンボル名の定義 , 参照関係を行番号で示します。
リストの構成は , 図 7.3-1 のようになっています。
198
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
Soft
Ma nual
図 7.3-1 アセンブルリストの構成
インフォメーションリスト
(ROM/RAMリスト)
-alr指定
(ARRAYリスト)
アセンブルソースリスト
セクション情報リスト
クロスリファレンスリスト
■ アセンブルリスト内のエラーメッセージ
アセンブル時に発生したエラーが,もし,アセンブルリスト上にあれば,エラーメッセー
ジがそのまま表示されます。
July 31, 2015, CM41-00315-6
199
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
7.3.1
So ft
Manu al
ヘッダ , インフォメーションリスト
ヘッダは 4 行で構成されています。
また , リストの 1 ページ目には , ヘッダに続いてインフォメーションリスト ( アセン
ブラ起動時の指定内容 , エラー数 , ワーニング数 , ソースファイル名 , インクルード
ファイル名 , オプションファイル名など ) が表示されています。
■ ヘッダ形式
ヘッダは 4 行より構成されています。各ページの先頭に表示されます。1 ~ 2 行目はア
センブルリスト全体を通じて共通の形式をもち , 3 行目は各ソースプログラムで異なり
ます。ヘッダの形式を図 7.3-2 に示します。
図 7.3-2 ヘッダ形式
[1~2行目]
F2MC-16 Family SOFTUNE Linker VxxLxx YYYY-MM-DD hh:mm:ss
ツール名
絶対アセンブルリスト作成年月日
Page: xxxx
ページ番号
[3行目]
- 各リスト名 - ( モジュール名 )
元のアセンブルリストの内容がそのまま表示されます。
[4行目]
空白行が出力されます。
200
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
7.3.2
Soft
Ma nual
ROM/RAM, ARRAY リスト
ROM/RAM, ARRAY リストは , C ソースプログラム内で記述されるシンボルについ
ての情報を示すものです。
ROM/RAM, ARRAY リストを出力するには , コンパイル , アセンブル時にデバッグ情
報が出力指定されていることが必要です。
■ ROM/RAM, ARRAY リスト
ROM/RAM, ARRAY リストの形式を図 7.3-3 に示します。
図 7.3-3 ROM/RAM, ARRAY リストの形式
・ROM/RAMリストの形式
- ROM/RAM LISTING - (モジュール名)
NAME
ADDRESS VALUE
KIND MEMORY
--- 名前 ---
xxxxxxxx
xxxxxxxx
x
xxx
*2
*3
*4
*5
*1
・ARRAYリストの形式
- ARRAY LISTING - (モジュール名)
NAME
ADDRESS VALUE
--- 名前 ---
xxxxxxxx
xxxxxxxx
*2
*3
*1
*1: シンボル名
プログラム内で記述されているシンボルの名前を表示します。
ARRAY リストの場合は配列 , 構造体の要素すべてを表示します。
*2: アドレス
絶対アドレスを 16 進で表示します。
未使用関数削除機能により削除された関数は ,"--------" と表示します。
シンボル名とアドレスの表示位置はオプションで変更できます。-na を指定すると
シンボル名 , アドレスの順で , -an を指定するとアドレス , シンボル名の順に表示し
ます。
詳細は ,「6.2.60 ROM/RAM, ARRAY リストのシンボルとアドレスの表示位置指定
(-na, -an)」を参照してください。
*3: 値
シンボルに初期値が代入されている場合はその値を 10 進で表示します。
*4: シンボルの種別
以下があります。
L : 変数値 F : 関数名 T : タグ名参照
July 31, 2015, CM41-00315-6
201
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
So ft
Manu al
*5: メモリ配置
シンボルが配置されているメモリ領域を表示します。
ROM: ROM 領域
RAM: RAM 領域
【例 1】
図 7.3-4 ROM/RAM リスト例
- ROM/RAM LISTING - (sample1)
NAME
_Line
_Nameleng
_symref
_Tflg
ADDRESS
000002B8
0000004C
00005592
00000763
VALUE
00000100
00000016
00000002
KIND
L
L
T
L
MEMORY
ROM
RAM
ROM
RAM
【例 2】
未使用関数削除機能により削除された関数の ROM/RAM リスト表示例を図 7.3-5 に
示します。
削除された関数の ADDRESS は "--------" と表示します。
図 7.3-5 削除された関数の ROM/RAM リスト例
- ROM/RAM LISTING - (sample1)
NAME
_func1
_func2
_main
ADDRESS VALUE
00008024
-------00008026
KIND
F
F
F
MEMORY
ROM
ROM
ROM
【例 3】
図 7.3-6 ARRAY リスト例
- ARRAY LISTING - (sample1)
202
NAME
ADDRESS VALUE
_symref[0].val
_symref[0].nam
_symref[0].atr
_symref[1].val
_symref[1].nam
_symref[1].atr
_Xpcr[0][0]
_Xpcr[0][1]
00005592
00005596
00005598
0000559A
0000559E
000055A0
00001066
000010A0
00000100
00000002
00000016
00012000
00000002
00000016
00000400
00000120
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
Soft
Ma nual
アセンブルソースリスト
7.3.3
アセンブルソースリストはロケーション部分が絶対アドレス , オブジェクトコード部
分がリンク後の確定したコードで表示されます。
■ アセンブルソースリストの形式
アセンブルソースリストの形式を図 7.3-7 に示します。
図 7.3-7 アセンブルソースリストの形式
- SOURCE LISTING - (モジュール名)
SN
LOC
xx
xxxxxxxx xxxxxxxxxxxxxxxxxxxxxx x
OBJ
*1
*2
*3
LLINE
xxxxxxxxxxxx
*4 *5
SOURCE
x
--------------
*6 *7
上に示す形式の 1 行目の部分をソースリストヘッダとよびます。ソースリストヘッダ
はページごとに表示されます。
*1: セクション頭文字
セクション名の先頭 2 文字までを表示します。
*2: ロケーション
32 ビットのロケーション値を 16 進で表示します。
未使用関数削除機能により削除された関数は ,"--------" と表示します。
*3: オブジェクトコード
リンク後の決定したオブジェクトコードを 16 進で表示します。1 行にすべて表示で
きないときは複数行で表示します。
*4: オブジェクトコードの種類
オブジェクトコードに含まれる値の属性を以下の優先順位で表示します。
I
: 外部参照値
S
: セクション値
空白
: 絶対値
相対アセンブルリストに表示されている "R" は絶対アセンブルリストでは絶対値に
変換されるため表示されません。
*5: 行番号
行番号を 10 進 5 桁で表示します。
*6: プリプロセッサの処理状況表示
プリプロセッサ
X: アセンブル対象外となった行
&: マクロ展開行
July 31, 2015, CM41-00315-6
203
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
So ft
Manu al
*7: ソース行
ソースプログラムの 1 行を表示します。リスト 1 行におさまらない場合複数行で表
示します。
【例 1】
図 7.3-8 アセンブルソースリスト例
- SOURCE LISTING - (sample1)
SN LOC
OBJ
LLINE
IN 002CE724
IN 002CE724
IN 002CE726
CO 0000A280
CO 0000A280
--------<INIT>--------[2] 02
0020 0010
--------<CODE>--------AC043C
1025
1026
1027
1028
1029
SOURCE
label
.DATAB.B 2, 2
.DATA.H 32,16
.SECTION CODE, CODE
MOVW RW4,#LS1
行番号
ソースプログラム
オブジェクトコード:リンク後の確定した値で表示します。
ロケーションカウンタ:32ビットの絶対アドレスで表示します。
セクション頭文字:セクション名の先頭2文字までを表示します。
【例 2】
未使用関数削除機能により削除された関数のアセンブルソースリスト表示例を図
7.3-9 に示します。
削除された関数の LOC は ,"--------" と表示します。
図 7.3-9 削除された関数のアセンブルソースリスト例
SN LOC
OBJ
CO - - - - - - - - --<CODE_main_func2>-CO - - - - - - - CO - - - - - - - - 66
204
LLINE
SOURCE
13
14
15
16
.section CODE_main_func2, CODE, align=1
.global _func2
_func2:
RETP
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
Soft
Ma nual
セクション情報リスト
7.3.4
セクション情報リストは , プログラム内で定義されるセクションについての情報を示
しているものです。
セクション情報リストは , 改ページを行い , 新しいページから表示します。
■ セクション情報リストの形式
セクション情報リストの形式を図 7.3-10 に示します。
図 7.3-10 セクション情報リストの形式
F2MC-16 Family SOFTUNE Linker VxxLxx
YYYY-MM-DD hh:mm:ss Page: xxxx
- SECTION LISTING - (モジュール名)
NO SECTION-NAME
SIZE
ATTRIBUTES
xx
--------セクション名--------
xxxxxxxx
xxx xxx
*1
*2
*3
*4
xxxx=xxxx
*5
*1: セクション出現番号
0 から始まります。オブジェクトファイル中のセクション番号に相当します。
*2: セクション名
定義されたセクション名を出現順に表示します。
*3: セクションサイズ
セクションのサイズを 16 進 32 ビット長で表示します。
*4: セクションタイプ
セクションの種別を表示します。種別を以下に示します。
CODE
: コードセクション
DATA
: データセクション
CONST
: 初期値付きデータセクション
COMMON
: 共有セクション
STACK
: スタックセクション
DIR
: direct セクション
DIRCONST
: 初期値付き direct セクション
IO
: IO セクション
*5: セクション配置形式
相対アセンブルリストの表示をそのまま出力します。
アセンブル時に相対セクションならば ALIGN 値を表示します。絶対セクションな
らば LOCATE 値を表示します。
July 31, 2015, CM41-00315-6
205
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
So ft
Manu al
【例】
図 7.3-11 セクション情報リスト例
F2MC-16 Family SOFTUNE Linker V30L11
2003-08-23 10:04:51
Page: 78
- SECTION LISTING - (sample1)
NO
0
1
2
3
206
SECTION-NAME
DATA ....................
INIT ....................
CONST ....................
CODE ....................
SIZE
00000004
0000001C
00000020
00000038
ATTRIBUTES
DATA REL ALIGN=2
DATA REL ALIGN=2
CONST REL ALIGN=2
CODE REL ALIGN=2
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
7.3.5
Soft
Ma nual
クロスリファレンスリスト
クロスリファレンスリストは , プログラム内で記述される名前についての情報とその
定義と参照の関係を示すものです。
クロスリファレンスリストは , 改ページを行い , 新しいページから表示します。
■ クロスリファレンスリストの形式
クロスリファレンスリストの形式を図 7.3-12 に示します。
図 7.3-12 クロスリファレンスリストの形式
F2MC-16 Family SOFTUNE Linker VxxLxx
YYYY-MM-DD 10:04:51 Page: XXXX
- CROSSREFERENCE LISTING - (モジュール名)
NAME
ATTRIB.
VALUE
--------名前-------*1
xxxx/xxxx
*2
xxxxxxxx xxx xxx xxx
*3
*4
DEFINITION/REFERENCE
*1: 名前
シンボル名 , セクション名を , 大文字 , 小文字 , アルファベット順に表示します。
*2: シンボル種別
シンボルの種別を以下の形式で表示します。
ABS
: 絶対シンボル
REL
: 相対シンボル
ABS/EXP
: 絶対シンボル ( 外部定義指定 )
REL/EXP
: 相対シンボル ( 外部定義指定 )
IMP
: 外部参照シンボル
SECT/ABS
: 絶対セクション
SECT/REL
: 相対セクション
UNDEFINED
: 未定義シンボル
REGLIST
: レジスタシンボル
*3: 値
シンボルが値を持つ場合 , その値を 32 ビットの絶対アドレスで表示します。
未使用関数削除機能により削除された関数は ,"--------" と表示します。
*4: 定義 , 参照行番号
シンボルを定義している行と参照している行を示します。
シンボルが定義されている行番号の後ろにシャープ記号 "#" が付けられます。
July 31, 2015, CM41-00315-6
207
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
So ft
Manu al
【例 1】
図 7.3-13 クロスリファレンスリスト例
F2MC-16 Family SOFTUNE Linker V30L11
2003-08-23 13:58:00
Page: 86
- CROSSREFERENCE LISTING - (sample)
NAME
ARRSY
BINCOL
DATAC
IROAS
ATTRIB.
SECT/REL
REL/EXP
REL
ABS
VALUE
000021C2
00000308
00006D58
00000101
DEFINITION/REFERENCE
266 #
40 # 92 13
437 #
79 # 10 4
【例 2】
未使用関数削除機能により削除された関数クロスリファレンスリスト表示例を図
7.3-14 に示します。
削除された関数は ,"--------" と表示します。
図 7.3-14 削除された関数のクロスリファレンスリスト例
F2MC-16 Family SOFTUNE Linker V30L16
2015-08-01 13:58:00
Page: 86
- CROSSREFERENCE LISTING - (sample)
NAME
CODE_main_func1 . .
CODE_main_func2 . .
CODE_main_main . . .
208
ATTRIB.
SECT/REL
SECT/REL
SECT/REL
VALUE
00008024
-------00008026
DEFINITION/REFERENCE
20 #
13 #
24 #
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.4 外部シンボル相互参照情報リストファイル
Support
7.4
Soft
Ma nual
外部シンボル相互参照情報リストファイル
外部シンボル相互参照情報リストファイルは , リンク後の各オブジェクトモジュール
の外部定義シンボルと外部参照シンボルのモジュール間の相互参照情報を表示しま
す。
■ 外部シンボル相互参照情報リストファイル
図 7.4-1 に外部シンボル相互参照情報リストの出力形式を示します。
図 7.4-1 外部シンボル相互情報リストの出力形式
External Symbol Cross Reference List
YYYY-MM-DD hh:mm:ss
Page: 1
YYYY-MM-DD hh:mm:ss
Page: 2
Module(s)
1. Module01
2. Module02
:
15. Module15
External Symbol Cross Reference List
--- symbol --extsym1
extsym2
extsym3
--- type/value --Addr. 0x000012E8
Addr. 0x000C3F34
Addr. 0x000012E6
extsymxxlongxx+
longxx
extsymunresolved
n1m
func2
Addr. 0x000CA8EE
--- module (No.) --1# 2 3 4 5 6 8 11 12 14
2 3 4# 5 6 8 11 12 14
1# 2 3 4 5 6 8 11 12 13
14 15
4 5 6 11 12 14#
???? 0x00000000
EQU 0xFFFFFFFF
Addr. 0x00000000
10 15
1 3 4 7 11 12 13 14 15#
2#
● Module(s)
1 から始まる通し番号を付けて , モジュール名を示します。
● symbol
シンボル名を表示します ( デフォルト最大 20 文字 )。
● type/value
type には以下があります。
• Addr.
: アドレス
• EQU
: EQU シンボル
• Bit
: ビットシンボル
• ????
: 未定義
valueは,値を示します。ビットシンボルの場合,括弧内にビットポジションを示します。
未使用関数削除機能により削除された関数は ,"0x00000000" と表示します。
● module (No.)
定義 / 参照のあったモジュールを番号で示します。# 記号は定義モジュールです。
July 31, 2015, CM41-00315-6
209
第 7 章 リンカの出力リスト ファイル
7.5 ローカルシンボル情報リストファイル
Su pp or t
7.5
So ft
Manu al
ローカルシンボル情報リストファイル
ローカルシンボル情報リストファイルは , 絶対形式ロードモジュールを構成する個々
のモジュールごとのローカルシンボルを含んだ変数や関数などの情報を表示します。
このリストはデバッグ情報をもとに作成されますので , コンパイル , アセンブル時
に , -g オプションを指定してください。
■ ローカルシンボル情報リストファイル
図 7.5-1 にローカルシンボル情報リストの出力形式を示します。
図 7.5-1 ローカルシンボル情報リストの出力形式
Local Symbol List
YYYY-MM-DD hh:mm:ss
Page: 1
YYYY-MM-DD hh:mm:ss
Page: 2
Module(s)
1. Module01
2. Module02
:
15. Module15
Local Symbol List
=== Module No.1(module01) ===
--- symbol --func1
localstatic1
localstatic2
:
=== Module No.15(module015) ===
--- symbol --func2
Atable
Extsym
--- Kind --Func. g
Var.
s
Var.
s
--- val --0x000C3F34
0x000012EE
0x000012F0
--- kind --Func
g
loc.
s
Var.
g
--- val ---------0xFFFFFFFC
0x00001342
● Module(s)
1 から始まる通し番号を付けて , モジュール名を示します。
● symbol
シンボル名を表示します。
関数内で使用しているシンボルは , 3 カラム目から表示します。
シンボル名の先頭から最大 20 文字迄がリストの 1 行に表示されます。
● Kind
以下のシンボル種別を表示します。
210
Var.
: 変数 (C)
Func.
: 関数 (C)
loc.
: ローカル (C)
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.5 ローカルシンボル情報リストファイル
Support
Soft
Ma nual
Addr.
: アドレス (ASM)
EQU
: EQU シンボル (ASM)
bit
: bit シンボル (ASM)
????
: 未定義
s
: static(C)
g
: global(C)
value は , 値を示します。
● val
シンボルの値を示します。
未使用関数削除機能により削除された関数は ,"--------" と表示します。
<注意事項>
構造体の詳細情報 ( メンバ名 ) や ,typedef 定義などは表示しません。
July 31, 2015, CM41-00315-6
211
第 7 章 リンカの出力リスト ファイル
7.6 セクション配置詳細情報リストファイル
Su pp or t
7.6
So ft
Manu al
セクション配置詳細情報リストファイル
セクション配置詳細リストファイルは , 絶対形式ロードモジュールを構成する個々の
モジュールごとのセクション配置の情報を作成します。
マップリストファイルに 1 つにまとまったセクション全体のマップリストが表示さ
れますが , さらに詳しいセクション配置情報を確認できます。
■ セクション配置詳細情報リストファイル
図 7.6-1 にセクション配置詳細情報リストの出力形式を示します。
図 7.6-1 セクション配置詳細情報リストの出力形式
Section Mapping List
YYYY-MM-DD hh:mm:ss
Page: 1
YYYY-MM-DD hh:mm:ss
Page: 2
Module(s)
1. Module01
2. Module02
:
15. Module15
Section Mapping List
S.Addr. -E.Addr.
00000000-00000048
0000004A-000003E1
000003E4- . . . . . . . .
000003E4-00000643
00000644-00000743
Size
00000049
00000348
00000000
00000260
00000100
Section
DATA P
DATA P
DATA P
DATA P
STACK P
Type
RW-RW-RW-RW-I
RW--
Al
04
04
04
04
04
M.No.
1
2
3
4
4
000C0000-000C0441
000C0442-000C148B
*000C148C-000C201D
*000C2000-000C2203
000C3000-000C325F
-----------------
00000442
0000104A
00000B92
00000204
00000260
--------
CODE P
CODE P
CODE P
CODE P
DATA P
CODE P
R-XI
R-XI
R-XI
R-XI
R--I
R--I
02
02
02
02
04
01
1
3
4
5
4
2
Sec.(Top 18)
data
data
data
init
sectionnametoolong+
toolong
code
code
code
subprog1
#init
CODE_main_func2
● Module(s)
1 から始まる通し番号を付けて , モジュール名を示します。
● S.Addr.-E.Addr.
セクションの開始と終了アドレスです。
アドレスがほかと重なっているセクションは,開始アドレスの前に(*)が付加されます。
サイズ 0 のセクションの場合 , 終了アドレスの表示は「........」になります。
未使用関数削除機能により削除された関数のセクションの場合,"--------"と表示します。
● Size
許されるアドレス空間をオーバフローしているセクションは , サイズの最大値 +1 を表
示します。
未使用関数削除機能により削除された関数のセクションの場合,"--------"と表示します。
212
CM41-00315-6, July 31, 2015
第 7 章 リンカの出力リスト ファイル
7.6 セクション配置詳細情報リストファイル
Support
Soft
Ma nual
● Section
セクションの内容種別を表示します。
CODE
: プログラムセクション
DATA
: データセクション
CONST
: 初期値付きデータセクション
STACK
: スタックセクション
DIR
: direct セクション
DIRCONST
: 初期値付き direct セクション
IO
: IO セクション
セクション種別の後に , 結合属性を表示します。
P
: 単純連結結合
C
: 共有結合
N
: 結合なし
● type
左から順に , 以下の属性を表示します。
R/-
: Read 可 / 不可
W/-
: Write 可 / 不可
X/-
: 実行可 / 不可
I/-
: 初期値あり / なし
● Al
セクション配置の境界調整数を 16 進で表示します。
● M.No.
モジュール番号を表示します。Module(s) で表示のモジュール番号を示します。
● Sec.(Top xx)
セクション名を表示します。(Top xx) の xx は , セクション名を行の折り返しなしで表
示できる文字数です。
セクション名の前に # がついているセクションは , 実行前に RAM へ転送される初期値
付きデータの配置されたセクションであることを示します。
July 31, 2015, CM41-00315-6
213
第 7 章 リンカの出力リスト ファイル
7.6 セクション配置詳細情報リストファイル
Su pp or t
214
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第8章
リンカの制限事項
および Q &A
この章では , リンカの制限事項や使用上の Q &A に
ついて述べます。
8.1 リンカの制限事項
8.2 リンカの使用上の Q &A
July 31, 2015, CM41-00315-6
215
第 8 章 リンカの制限事項 および Q &A
8.1 リンカの制限事項
Su pp or t
8.1
So ft
Manu al
リンカの制限事項
リンカを使用する上で , 処理可能な入力ファイル数やセクション数など , 特に制限値
は設けていません。しかし , 入力ファイル数およびライブラリファイル数にはオブ
ジェクトフォーマット上に制限があります。
■ リンカの制限事項
リンカは , 入力ファイル数やセクション数 , シンボル数などに処理制限を設けていませ
ん。リンカの内部処理で , セクション名やシンボル名などの登録が必要になれば , 動的
にメモリ獲得を行い,リンカが実行に使用できるメモリを使いきってしまうまで処理可
能です。
処理限界に達すると , メモリ不足のメッセージを通知し , リンカの処理を終了します。
<注意事項>
リンカが絶対形式アセンブルリストを出力する場合 , 以下の制限があります。
リンカ入力モジュール数
1048576 個
外部シンボルと静的 (static) シンボルの合計数
1048576 個
セクションの数
1048576 個
■ リンカの予約シンボル
リンカは , ROM → RAM 転送機能を用いたセクションごとに "_ROM_ セクション名 ",
"_RAM_ セクション名 " でシンボルの自動生成を行います。
したがって , 同名のシンボルがユーザプログラム内で定義されていると , "W1327L: こ
のシンボルは既に定義されています ( シンボル名 )" が発生します。ユーザは "_ROM_
セクション名 ", "_RAM_ セクション名 " でシンボル定義を行わないでください。
■ オブジェクトファイルフォーマット上の制限事項
リンカでの制限は , 上記のとおりですが , オブジェクトファイルで管理できるシンボル
数などに以下の制限があります。
入力ファイル数
65535 個
セクション数 (1 ファイルあたり )
65535 個
外部定義シンボル数 (1 ファイルあたり )
65535 個
外部参照シンボル数 (1 ファイルあたり )
65535 個
( 注意事項 ) ここでのファイルは , オブジェクトファイルのことです。相対形式ロード
モジュールファイルの場合は , それらを作成するときに入力したオブジェ
クトファイルの総数として換算してください。
216
CM41-00315-6, July 31, 2015
第 8 章 リンカの制限事項 および Q &A
8.2 リンカの使用上の Q &A
Support
8.2
Soft
Ma nual
リンカの使用上の Q &A
リンカの使用に関する Question と Answer を示します。
■ リンカの使用上の Q &A
● ワイルドカードの使用
Q.
入力するオブジェクトモジュールファイル数が非常に多いのですが , ワイルドカードは使
用できますか ?
A.
コマンドライン上では , 入力ファイルの指定にワイルドカードを使用すると , リンカが展開
して実行します。オプションファイル中にも入力ファイル名の指定ができますが , ここで
もワイルドカードが利用できます。下記の例を参考にして , 使用してください。
例.
flnk907s *.obj -o outfile.abs
flnk907s mactrl.obj xz???.obj
Q.
セクション配置指定時 , セクション名にワイルドカードが使用できますが , どのように使
用したらよいですか ?
A.
内容種別が同じセクションをまとめたいとき , または多数のセクション名を用いてプログ
ラムを作成したときに使用すると便利な場合があります。セクション名を命名するときに ,
リンカでワイルドカードが使用できることを考慮して , キーワードとなる文字を決めてお
くことが必要になるかもしれません。
例.
内容種別が data のセクションとして , DTdata1, DTdata2, DTdata3, DTdata4 ...
内容種別が code のセクションとして , CDprog1, CDprog2, CDprog3, CDprog4, ...
のような名前でセクション名定義をしているとします。この場合 , 下記のような指定方法
が選択できます。(-sc オプションの部分のみ示します )
-sc DTdata1+DTdata2+Dtdata3+DTdata4=0x1000,
CDprog1+CDprog2+Cdprog3+CDprog4=0x3000
-sc DT*=0x1000,CD*=0x3000
-sc */data=0x1000,*/code=0x3000
July 31, 2015, CM41-00315-6
217
第 8 章 リンカの制限事項 および Q &A
8.2 リンカの使用上の Q &A
Su pp or t
So ft
Manu al
■ 初期値付変数の扱い
Q.
C コンパイラを使用した組込用のプログラム開発においては , 初期値付変数が生成されま
すが , このデータはプログラム実行時に書換えられるため , 実行時は RAM 上になくてはな
りません。
プログラム作成時の手順と注意事項を教えてください。
A.
組込用のプログラムでは , 初期値付変数は最初 ROM にあり , 参照するときには RAM にな
くてはなりません。したがって , プログラムでの参照アドレスは RAM にし , アプリケー
ション実行前に ROM から RAM への初期値データを転送するしくみを実現しておかない
とプログラムの実行ができないことになります。
・メモリモデルが small または medium の場合
F2MC-16 ファミリの C コンパイラが生成する初期値付変数は , 実行時に使用される , 名前
が INIT のセクションと , 初期値データが格納されている , 名前が DCONST のセクションに
まとめられています。
したがって , プログラム作成中は , 初期値付変数の総バイト数と RAM のサイズに注意する
以外は特に気を付けることはありません。
なお , ユーザは , DCONST から INIT へ初期値データ転送を行うプログラムを記述する必要
があります。
例 1a に「初期値データ転送のプログラム例」を示します。
・メモリモデルが compact または large の場合
F2MC-16 ファミリの C コンパイラが生成する初期値付変数は , モジュールごとに生成され ,
実行時に使用される名前が "INIT_ モジュール名 " のセクションと , 初期値データが格納さ
れている , 名前が "DCONST_ モジュール名 " のセクションにまとめられ , 名前が DTRANS
のセクションにその情報が設定されます。
したがって , プログラム作成中は , 初期値付変数の総バイト数と RAM のサイズに注意する
以外は特に気を付けることはありません。
なお , ユーザは , DTRANS に設定されている情報を元に , 初期値データを転送行うプログラ
ムを記述する必要があります。
例 1b に「初期値データ転送のプログラム例」を示します。
例 1a
[ 初期値データ転送のプログラム例 : メモリモデルが small または medium の場合 ]
.section
DCONST, const
…… ①
DCONST_S
.section
INIT, data
…… ②
INIT_S
.section
start, code
MOV
A, #bnksym(DCONST_S)
MOV
ADB, A
MOV
A, #bnksym(INIT_S)
MOV
DTB, A
MOVW
RW0, #sizeof(INIT)
MOVW
A, #INIT_S
MOVW
A, #DCONST_S
MOVSI
DTB, ADB
① DCONST_S は , ROM 上の DCONST セクション ( 転送元 ) の先頭アドレスを示すシンボ
ルです。
② INIT_S は , RAM 上の INIT セクション ( 転送先 ) の先頭アドレスを示すシンボルです。
これらのシンボルは , セクションの先頭に定義する必要があるのでリンク時に , 初期値
データ転送のプログラムを 1 番最初にリンクする必要があります。
218
CM41-00315-6, July 31, 2015
第 8 章 リンカの制限事項 および Q &A
8.2 リンカの使用上の Q &A
Support
Soft
Ma nual
[ 初期値データ転送のプログラム例 : メモリモデルが compact または large の場合 ]
.section DTRANS, const
DTRANS_S
例 1b
.section start, code
MOV
A, #bnksym(DTRANS_S)
MOV
DTB, A
MOVW RW1, #DTRANS_S
BRA
LABEL2
LABEL1:
MOVW A, @RW1+6
MOV
USB, A
MOVW A, @RW1+2
MOV
ADB, A
MOVW A, @RW1+4
MOVW A, @RW1
MOVW RW0, @RW1+8
MOVSI SPB, ADB
MOVN A, #10
ADDW RW1, A
LABEL2:
MOVW A, RW1
SUBW
A, #DTRANS_S
CMPW A, #sizeof(DTRANS)
BNE
LABEL1
① DTRANS_S は , ROM 上の DTRANS セクション ( 転送情報格納テーブル ) の先頭アドレ
スを示すシンボルです。
このシンボルは , セクションの先頭に定義する必要があるのでリンク時に , 初期値デー
タ転送のプログラムを 1 番最初にリンクする必要があります。
July 31, 2015, CM41-00315-6
219
第 8 章 リンカの制限事項 および Q &A
8.2 リンカの使用上の Q &A
Su pp or t
220
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
第 III 部
Soft
Ma nual
ライブラリアン編
ライブラリアンの仕様 , オプション , 出力リストなどについて説明します。
第 9 章 ライブラリアンの仕様
第 10 章 ライブラリアンの オプション
第 11 章 ライブラリアンの リストフォーマット
第 12 章 ライブラリアンの制限事項および Q &A
July 31, 2015, CM41-00315-6
221
Su pp or t
222
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第9章
ライブラリアンの仕様
ライブラリアンの機能と各機能概要を説明します。
ライブラリファイルを作成するツールです。
9.1 ライブラリアンの機能
9.2 ライブラリアンの機能分類
9.3 ライブラリファイルの作成編集
9.4 ライブラリファイル内のモジュール抽出
9.5 ライブラリのデバッグ情報の削除
9.6 ライブラリファイルの内容チェックと表示
9.7 ライブラリアンでのオブジェクト混在
9.8 ライブラリアンでの関数呼び出しインタフェースの異な
るオブジェクトの混在について
July 31, 2015, CM41-00315-6
223
第 9 章 ライブラリアンの仕様
9.1 ライブラリアンの機能
Su pp or t
9.1
So ft
Manu al
ライブラリアンの機能
ライブラリアンは , アセンブラが出力した複数のオブジェクトモジュールをまとめ
て , 1 つのライブラリファイルを作成するツールです。
■ ライブラリアンの役割
プログラムを開発する場合は,ソースプログラムを機能単位などによりモジュール分割
し , モジュールごとにコンパイル , アセンブルを行います。
コンパイルおよびアセンブルした結果は , リンカによって 1 つに結合し目的とするプロ
グラムを作成します。
ライブラリアンは,アセンブラが出力した複数のオブジェクトモジュールをまとめてラ
イブラリファイルを作成するツールです。
プログラムを構成する複数のモジュールを,そのプログラム専用のライブラリファイル
に登録することにより , 一括して管理できます。
よく利用するモジュールをまとめて登録し , 汎用ライブラリファイルを作成しておけ
ば , ほかのプログラムへの流用が容易に行えます。C のライブラリは , このようにして
利用されている良い例です。
ライブラリファイルは , ライブラリアンによってモジュール単位に追加 , 削除 , 置換な
どの編集が行えるため , 各モジュールを最新の状態で保管できます。
図 9.1-1 に , ライブラリアンの役割を示します。
224
CM41-00315-6, July 31, 2015
第 9 章 ライブラリアンの仕様
9.1 ライブラリアンの機能
Support
Soft
Ma nual
図 9.1-1 ライブラリアンの役割
アセンブラ
相対形式
オブジェクト
(.obj)
ライブラリアン
ライブラリ
(.lib)
リンカ
絶対形式
オブジェクト
(.abs)
July 31, 2015, CM41-00315-6
225
第 9 章 ライブラリアンの仕様
9.2 ライブラリアンの機能分類
Su pp or t
9.2
So ft
Manu al
ライブラリアンの機能分類
ライブラリアンには , 以下の 6 つの機能があります。
• ライブラリファイルの新規作成
• ライブラリファイルの編集
• ライブラリファイル内のモジュール抽出
• デバッグ情報の削除
• ライブラリファイルの内容チェック
• ライブラリファイルの内容表示
■ ライブラリファイルの新規作成
オブジェクトモジュールファイルを入力ファイルとして,新規にライブラリファイルを
作成する機能です。
■ ライブラリファイルの編集
既に作成されているライブラリファイルに,新たにオブジェクトモジュールを追加した
り , 不要になったオブジェクトモジュールを削除したりする機能です。
また , ライブラリファイルに登録したモジュールに障害があることが判ったり , 機能の
変更を行ったりする場合 , 修正して差し替える必要があります。この作業は削除と追加
でもできますが , 置換を行う機能もあります。
■ ライブラリファイル内のモジュール抽出
ライブラリファイルに登録されているオブジェクトモジュールを抽出し,オブジェクト
モジュールファイルの形式に戻す機能です。
■ デバッグ情報の削除
デバッグ情報付のオブジェクトモジュールが登録されているとき,デバッグ情報のみを
取り除いて登録しなおします。
■ ライブラリファイルの内容チェック
ライブラリファイルを作っているオブジェクトモジュールの集まりの中で,外部シンボ
ルの定義 / 参照関係がきちんと解決されているかを調べます。
デバッグ情報付のオブジェクトモジュールが登録されているか否かを調べます。
■ ライブラリファイルの内容表示
ライブラリファイルに登録されているモジュール名や,外部シンボルなどの情報をリス
トファイルまたは標準出力に出力します。
226
CM41-00315-6, July 31, 2015
第 9 章 ライブラリアンの仕様
9.3 ライブラリファイルの作成編集
Support
9.3
Soft
Ma nual
ライブラリファイルの作成編集
アセンブラが出力した ( 複数の ) オブジェクトモジュールを 1 つにまとめ , ライブラ
リファイルとして登録できます。
また , 既に作成済のライブラリファイルに対して , モジュールの追加 , 削除 , 置換が
できます。
■ ライブラリファイルの新規作成
アセンブラが出力した ( 複数の ) オブジェクトモジュールを 1 つにまとめライブラリ
ファイルとして登録できます ( 図 9.3-1 を参照 )。
図 9.3-1 ライブラリファイルの新規作成
登録対象オブジェクト
モジュールファイル
新規ライブラリ
ファイル
モジュールA
モジュールA
作成
モジュールB
モジュールB
モジュールC
モジュールC
■ ライブラリファイルの編集
すでに作成済のライブラリファイルに対して,モジュールの追加,削除,置換ができます。
● モジュールの追加
既存のライブラリファイルにモジュールを追加します ( 図 9.3-2 を参照 )。
図 9.3-2 モジュールの追加
編集後のライブラリ
ファイル
既存ライブラリ
ファイル
モジュールD
モジュールA
モジュールA
追加
更新
+
モジュールB
モジュールB
モジュールC
モジュールC
モジュールD
July 31, 2015, CM41-00315-6
227
第 9 章 ライブラリアンの仕様
9.3 ライブラリファイルの作成編集
Su pp or t
So ft
Manu al
● モジュールの削除
既存のライブラリファイルから不要になったモジュールを削除します ( 図 9.3-3 を
参照 )。
図 9.3-3 モジュールの削除
既存ライブラリ
ファイル
編集後のライブラリ
ファイル
モジュールA
モジュールA
更新
モジュールB
モジュールB
モジュールC
モジュールD
削除
モジュールD
● モジュールの置換
既存のライブラリファイル内のモジュールを , 新しいモジュールと置き換えます ( 図
9.3-4 を参照 )。
図 9.3-4 モジュールの置換
既存ライブラリ
ファイル
置換
モジュールB
モジュールA
モジュールB
モジュールC
228
編集後のライブラリ
ファイル
モジュールA
更新
モジュールB
モジュールC
CM41-00315-6, July 31, 2015
第 9 章 ライブラリアンの仕様
9.4 ライブラリファイル内のモジュール抽出
Support
9.4
Soft
Ma nual
ライブラリファイル内のモジュール抽出
ライブラリファイルからモジュールを抽出し , オブジェクトモジュール形式ファイル
に戻します。
■ ライブラリファイル内のモジュール抽出
ライブラリファイルからモジュールを抽出し,オブジェクトモジュール形式ファイルに
戻します ( 図 9.4-1 を参照 )。
図 9.4-1 モジュールの抽出
既存ライブラリ
ファイル
オブジェクト
ファイル
モジュールA
モジュールB
B.obj
抽出
モジュールB
モジュールC
July 31, 2015, CM41-00315-6
229
第 9 章 ライブラリアンの仕様
9.5 ライブラリのデバッグ情報の削除
Su pp or t
9.5
So ft
Manu al
ライブラリのデバッグ情報の削除
ライブラリに登録されているオブジェクトモジュールにデバッグ情報ブロック付き
のものがある場合 , デバッグ情報部を取り除いて登録しなおします。
■ デバッグ情報の削除
ライブラリに登録されているオブジェクトモジュールにデバッグ情報ブロック付きの
ものがある場合 , デバッグ情報部を取り除いて登録しなおします ( 図 9.5-1 を参照 )。
図 9.5-1 デバッグ情報の削除
LHD
LHD
LMD1
LMD1
LMD2
LMD2
LMD3
LMD3
LED1
LED1
LED2
LED2
LED3
LED3
OM1
OM1
OM1デバッグ情報
OM2
OM2
OM3
OM3
LTR
OM3デバッグ情報
LTR
230
デバッグ情報付で登録されたOM1とOM3
からデバッグ情報部を取り除く。
CM41-00315-6, July 31, 2015
第 9 章 ライブラリアンの仕様
9.6 ライブラリファイルの内容チェックと表示
Support
9.6
Soft
Ma nual
ライブラリファイルの内容チェックと表示
以下の 2 項目のチェックをします。
• ライブラリ内未解決外部参照シンボルの有無
• デバッグ情報付モジュールの有無
また , ライブラリファイルの作成 / 更新日時 , モジュールの登録日時および各モ
ジュールで定義されている外部定義シンボルの名前などの情報を確認できます。
■ ライブラリファイルの内容チェック
以下の 2 項目のチェックをします。
● ライブラリ内未解決外部参照シンボルの有無
リンカでは,ライブラリから取り込んだモジュールに外部参照シンボルが含まれていた
場合 , まず始めに同じライブラリファイル中で定義シンボルを探します。
したがって , 1 つのライブラリファイル中では , あるモジュール中に外部参照シンボル
がある場合,該当する外部定義シンボルを含むモジュールが同じライブラリファイル内
に必ず登録されていることが推奨されます。
1 つのライブラリファイル中での , 外部参照・定義シンボルの対応関係を調べ , 定義の
ない参照シンボルが残っている場合に , 診断メッセージを出力します。
● デバッグ情報付モジュールの有無
デバッグ情報付のオブジェクトモジュールが含まれている場合に,診断メッセージを出
力します。
-g オプション指定でのライブラリファイルへのモジュール登録処理では , オブジェク
トモジュール中にデバッグ情報が含まれていても,取り除くことなくそのままライブラ
リに登録します。
これは , ライブラリに登録したモジュールのデバッグを行うことを考慮したためです
が , 動作確認が済めばデバッグ情報は必要がなくなります。
■ ライブラリファイルの内容表示
ライブラリファイルのモジュール情報および外部定義シンボル情報などを,リストファ
イルまたは標準出力へ編集出力します。
このリストにより , ライブラリファイルの作成 / 更新日時 , モジュールの登録日時 , お
よび各モジュールで定義されている外部定義シンボルの名前などの情報を確認できま
す。
表示内容については「第
,
11 章 ライブラリアンの リストフォーマット」で説明します。
July 31, 2015, CM41-00315-6
231
第 9 章 ライブラリアンの仕様
9.7 ライブラリアンでのオブジェクト混在
Su pp or t
9.7
So ft
Manu al
ライブラリアンでのオブジェクト混在
ライブラリアン (flib907s) では , -cpu オプションで指定したターゲット CPU が上位
互換 CPU の場合に , 下位 CPU 用に作られたオブジェクトやライブラリの混在が可
能です。
■ ライブラリアンでのオブジェクト混在
ライブラリアンでは , -cpu オプションで指定したターゲット CPU が上位互換の場合に ,
下位 CPU 用に作られたオブジェクトの混在が可能です。
オブジェクトの混在を行った場合に , ライブラリアンは , インフォメーションを出力し
ます。
■ -cpu オプションとオブジェクト混在可能 CPU 一覧
表 9.7-1 に , -cpu オプションと混在可能な下位 CPU 用のオブジェクト , ライブラリを示
します。
表 9.7-1 -cpu オプションとオブジェクト混在可能 CPU 一覧
オブジェクト作成時の -cpu オプション
-cpu オプション 指定
F2MC-16L/16/16H
F2MC-16LX
F2MC-16FX
F2MC-16F
F2MC-16L/16/16H の CPU
◎
×
×
×
F2MC-16LX の CPU
○
◎
○
×
F2MC-16FX の CPU
○
○
◎
×
F2MC-16F の CPU
○
○
○
◎
◎ : 同一ターゲットです。混在ではありません。
○ : 混在可能ですが , ライブラリアンはインフォメーションを出力します。
× : 混在できません。ライブラリアンはエラーを出力します。
232
CM41-00315-6, July 31, 2015
第 9 章 ライブラリアンの仕様
9.8 ライブラリアンでの関数呼び出しインタフェースの異なる
オブジェクトの混在について
Support
9.8
Soft
Ma nual
ライブラリアンでの関数呼び出しインタフェースの異
なるオブジェクトの混在について
ここでは , ライブラリアンでの関数呼び出しインタフェースの異なるオブジェクト
の混在について説明します。
■ ライブラリアンでの関数呼び出しインタフェースの異なるオブジェクトの混在
F2MC-16 ファミリでは , 以下のような関数呼び出しインタフェースをサポートしてい
ます。
• 引数のスタック渡し ( 従来の関数呼び出しインタフェース )
• 引数のレジスタ (RW0, RW1) 渡し
引数のレジスタ渡しのオブジェクトと引数のスタック渡しのオブジェクトとでは引数
の受け渡し方法とレジスタの使用方法が異なります。そのため , 関数呼び出しインタ
フェースの異なるオブジェクトを混在して使用するとプログラムが正しく動作しませ
ん。
そのため , ライブラリアンでは , 引数のスタック渡しのオブジェクトと引数のレジスタ
渡しのオブジェクトは , ターゲット CPU が同じでも混在はできません。
ライブラリアンは , エラーを出力し処理を中断します。
(***E4410U:関数呼び出しインタフェースの異なるモジュールがあります ( ファイル
名 ))
関数呼び出しインタフェースが同じ場合 , 従来どおりターゲット CPU によるオブジェ
クト混在チェックを行います。ターゲット CPU によるオブジェクト混在チェックは ,
「9.7 ライブラリアンでのオブジェクト混在」を参照してください。
July 31, 2015, CM41-00315-6
233
第 9 章 ライブラリアンの仕様
9.8 ライブラリアンでの関数呼び出しインタフェースの異なる
オブジェクトの混在について
Su pp or t
234
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 10 章
ライブラリアンの
オプション
この章では , ライブラリアンの各オプションの形式 ,
パラメータ , 注意事項などについて説明します。
10.1 ライブラリアンのオプション一覧
10.2 ライブラリアンのオプション詳細
July 31, 2015, CM41-00315-6
235
第 10 章 ライブラリアンの オプション
10.1 ライブラリアンのオプション一覧
Su pp or t
10.1
So ft
Manu al
ライブラリアンのオプション一覧
ライブラリアンの動作を細かく指示するために , オプションがあります。
■ オプション一覧
オプション名と機能概要を , 表 10.1-1 に示します。
オプションに必要なパラメータや機能の詳細は,各オプションの説明を参照してくださ
い。
表 10.1-1 ライブラリアンのオプション一覧 (1 / 2)
機能
ライブラリの作成,編集
に関するオプション
モジュールの追加 ( 登録 )
-a
モジュールの置換 ( 登録 )
-r
モジュールの削除
-d
モジュールの抽出
-x
リストファイルの出力指定
-m
リストファイルの出力抑止指定
出力リストに関する
オプション
その他のオプション
236
-Xm
備考
デフォルト
リストファイルの詳細情報の出力指定
-dt
s, d, r, a
リスト 1 ページの行数指定
-pl
デフォルト 60
リスト 1 行の桁数指定
-pw
デフォルト 70
バックアップファイルの作成
ファイル検索 , 保護に
関するオプション
オプション
バックアップファイルの作成抑止
-b
-Xb
ライブラリファイルの内容検査
-c
ファイル内容の最適化
-O
デバッグ情報の出力指定
-g
デバッグ情報の出力抑止指定
-Xg
ターゲット CPU 指定
-cpu
CPU 情報ファイル指定
-cif
引数のレジスタ渡し用ライブラリ出力指定
-rp
引数のスタック渡し用ライブラリ出力指定
-Xrp
デフォルト
必須
デフォルト
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.1 ライブラリアンのオプション一覧
Support
Soft
Ma nual
表 10.1-1 ライブラリアンのオプション一覧 (2 / 2)
機能
オプション
デフォルトオプションファイル読込み抑
止指定
-Xdof
オプションファイル読込み指定
共通オプション
-help
版数 / メッセージ出力指定
-V
終了メッセージ出力指定
終了メッセージ出力抑止指定
July 31, 2015, CM41-00315-6
-f
ヘルプメッセージ表示指定
版数 / メッセージ出力抑止指定
備考
-XV
デフォルト
-cmsg
-Xcmsg
ワーニング発生時の終了コードを 1 にする
指定
-cwno
ワーニング発生時の終了コードを 0 にする
指定
-Xcwno
デフォルト
デフォルト
237
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2
So ft
Manu al
ライブラリアンのオプション詳細
ここでは , ライブラリアンの各オプションについて説明します。
なお , リンケージキットで共通のオプションは ,「第 3 章 共通オプション」で説明
しています。
■ ライブラリの作成 , 編集に関するオプション
ライブラリの作成 , 編集に関するオプションの詳細を「 10.2.1 モジュールの追加 ( 登
録 )(-a)」~「10.2.4 モジュールの抽出 (-x) 」で説明します。
■ 出力リストに関するオプション
出力リストに関するオプションの詳細を「 10.2.5 リストファイルの出力指定 (-m)」~
「10.2.9 リスト 1 行の桁数指定 (-pw)」で説明します。
■ ファイル検索 , 保護に関するオプション
ファイル検索 , 保護に関するオプションの詳細を「 10.2.10 バックアップファイルの作
成 (-b)」~「 10.2.13 ファイル内容の最適化 (-O)」で説明します。
■ その他のオプション
その他のオプションの詳細を「 10.2.14 デバッグ情報の出力指定 (-g)」~「 10.2.19 引
数のスタック渡しのライブラリ出力指定オプション (-Xrp)」で説明します。
238
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
モジュールの追加 ( 登録 )(-a)
10.2.1
ライブラリファイルを新規に作成する場合 , 既にあるライブラリファイルにモジュー
ルの追加を行う場合には -a オプションを使用します。
■ モジュールの追加 ( 登録 )(-a)
【記述形式】
-a < オブジェクトモジュールファイル名 > [, … ]
【パラメータ】
< オブジェクトモジュールファイル名 >
アセンブラが出力したオブジェクトモジュールファイル名
【説明】
ライブラリファイルへ登録するモジュールを内容とするファイル名を指定します。
ファイル名に拡張子の指定がないときは , ".obj" を拡張子とします。
登録しようとするモジュールと同じ名前のモジュールが既に登録されている場合 ,
エラーメッセージを出力しモジュールの登録処理は行いません。
同名の外部定義シンボルがある場合も同様に登録処理は行いません。
<オブジェクトモジュールファイル名 >の指定には,ワイルドカードが使用できます。
【例 1】
flib907s syslib.lib -a mod1.obj,mod2.obj,modx.obj
オブジェクトモジュールファイル mod1.obj, mod2.obj, modx.obj をライブラリファイ
ル syslib.lib に登録します。
• syslib.lib がないとき : 新規作成
• syslib.lib があるとき : 追加登録
【例 2】
flib907s syslib -a "mod*.obj" -a chksw
カレントディレクトリ中の拡張子 .obj のオブジェクトモジュールファイルの内先頭
3 文字が mod であるものと , chksw.obj を登録します。
<注意事項>
登録可能なモジュール数は , 最大 65535 個です。
ワイルドカードを使用する場合は , < オブジェクトモジュールファイル名 > をカンマで区
切って指定できません。
上述の例のように複数の -a オプションに分けて指定してください。
ワイルドカード指定時は拡張子の補完は行わないため , 必ず拡張子まで指定してください。
ファイル名のワイルドカードの展開は , OS に依存しますので ,「付録 G OS による仕様
の相違点」を参考にしてください。
July 31, 2015, CM41-00315-6
239
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
モジュールの置換 ( 登録 )(-r)
10.2.2
既に作成しているライブラリファイル中のモジュールを新しい同名のモジュールと
置き換えます。
■ モジュールの置換 ( 登録 )(-r)
【記述形式】
-r < オブジェクトモジュールファイル名 > [, … ]
【パラメータ】
< オブジェクトモジュールファイル名 >
アセンブラが出力したオブジェクトモジュールファイル名
【説明】
指定したファイル内のモジュールと同名のモジュールが編集中のライブラリファ
イルに存在する場合はモジュールの置換を行い , 存在しない場合には指定モジュー
ルを登録します。
ファイル名に拡張子の指定がないときは ".obj" が拡張子となります。
<オブジェクトモジュールファイル名 >の指定には,ワイルドカードが使用できます。
【例 1】
flib907s syslib.obj -r loadx.obj,loady.obj
loadx.obj および loady.obj 内の 2 つのモジュールを , 編集中のライブラリファイル内
の同名モジュールと置き換えます。
ライブラリファイル中に同名モジュールがない場合には , 追加登録されます。
【例 2】
flib907s syslib.lib -r "load?.obj"
カレントディレクトリ中の拡張子 .obj のオブジェクトモジュールファイルのうち先
頭 4 文字が load であり , その後ろに任意の 1 文字が付くファイル内のモジュールを
置換えの対象とします。
<注意事項>
ワイルドカードを使用する場合は , < オブジェクトモジュールファイル名 > をカンマで区
切って指定できません。複数の -r オプションに分けて指定してください。
ワイルドカード指定時は拡張子の補完は行わないため , 必ず拡張子まで指定してくださ
い。
ファイル名のワイルドカードの展開は , OS に依存しますので ,「付録 G OS による仕様
の相違点」を参考にしてください。
240
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
モジュールの削除 (-d)
10.2.3
ライブラリファイルから不要になったモジュールを取り除きます。
■ モジュールの削除 (-d)
【記述形式】
-d < モジュール名 > [, … ]
【パラメータ】
< モジュール名 >
削除するモジュール名
【説明】
指定したモジュールをライブラリファイルから削除します。
ここでの指定は , ファイル名ではなくモジュール名のため注意してください。
【例】
flib907s syslib.lib -d inchar,outchar
syslib.lib から , 2 つのモジュール inchar と outchar を削除します。
<注意事項>
アセンブラの疑似命令でモジュール名の指定ができますが , 特別な理由がない限りオブ
ジェクトモジュールファイル名とモジュール名は同じにしてください。異なる名前にする
と , ライブラリの編集作業においては誤りの原因になります。
ファイル名とモジュール名を同じにするためには , 英数字とアンダバーだけを使用した
ファイル名を用います。
モジュール名を確認したい場合は , リスト出力オプション (-m) を使用してリストファイル
の先頭部分に出力されるモジュール名を参照してください。
July 31, 2015, CM41-00315-6
241
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
モジュールの抽出 (-x)
10.2.4
ライブラリファイルからモジュールを抽出し , 登録前のオブジェクトモジュールファ
イルに戻します。
■ モジュールの抽出 (-x)
【記述形式】
-x < モジュール名 > [, < オブジェクトモジュールファイル名 >]
【パラメータ】
< モジュール名 >
抽出するモジュール名
< オブジェクトモジュールファイル名 >
抽出モジュールの出力ファイル名
【説明】
指定したモジュールをライブラリファイルから抽出します。
抽出したモジュールは , 登録前と同じ形式のオブジェクトモジュールファイルにな
ります。
< オブジェクトモジュールファイル名 > の指定を省略すると , < モジュール名 > に
拡張子 ".obj" を付けた名前でファイルを作ります。
【例】
flib907s syslib -x add
flib907s syslib.lib -x add,add.obj
既存ライブラリファイルから , モジュール add を抽出し add.obj ファイルを作成しま
す。
flib907s syslib -x add,add.o
既存ライブラリファイルから,モジュールaddを抽出しadd.oファイルを作成します。
<注意事項>
-x オプションは , 抽出したいモジュールの数だけ指定できます。
同じモジュール名が指定された場合は , 後に指定した方が有効になります。以下の例では ,
add.obj は作成されず , addfunc.obj のみ作成されます。
flib907s syslib -x add -x add,addfunc.obj
242
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
10.2.5
Soft
Ma nual
リストファイルの出力指定 (-m)
ライブラリファイルに登録されているモジュール名や外部定義シンボル名などの情
報リスト出力を行います。
■ リストファイルの出力指定 (-m)
【記述形式】
-m { < リストファイル名 > | - }
【パラメータ】
< リストファイル名 >
出力するライブラリアンリストのファイル名を指定。リストを標準出力に出力する
場合にはハイフン (-) を指定。
【説明】
ライブラリファイルに登録されているモジュール名や外部定義シンボル名などの
情報リスト出力を行います。
< リストファイル名 > に拡張子指定がない場合 , ".mp2" を付加します。
本オプションにより出力される情報は登録されているモジュール名だけですが , 後
述の -dt オプションで , より詳しい情報を表示させることができます。
リスト内容は , ライブラリアンの処理終了時の状態を示します。
ほかに編集作業に関するオプションがない場合には , 指定したライブラリファイル
の内容がリストされます。
ライブラリファイルの内容をリストに残さずに画面上で確認したい場合には , パラ
メータにハイフンを指定します。
【例 1】
flib907s syslib.lib -m libx.mp2
syslib.lib に登録されているモジュール名リストを libx.mp2 に出力します。
【例 2】
flib907s syslib -a obj1,obj2 -m libx.lis
obj1.obj と obj2.obj のモジュールを追加した結果作成された syslib.lib の内容を libx.lis
に出力します。
【例 3】
flib907s syslib -m syslib.lib に登録されているモジュール名リストを標準出力に出力します。
July 31, 2015, CM41-00315-6
243
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.6
So ft
Manu al
リストファイルの出力抑止指定 (-Xm)
ライブラリアンにリストファイルを出力しないことを指示します。
■ リストファイルの出力抑止指定 (-Xm)
【記述形式】
-Xm
【パラメータ】
なし
【説明】
リストファイルの出力の抑止を行います。
-m オプションの後に -Xm オプションを指定すると , -m オプションを無効にするこ
とができます。
【例】
flib907s syslib.lib -m libx.mp2 -Xm
リストファイルの作成は行わないようにします。
244
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
10.2.7
Soft
Ma nual
リストファイルの詳細情報の出力指定 (-dt)
-m オプションでリスト出力を行いますが , 登録モジュール名の一覧を表示するだけ
です。
ライブラリに登録されている個々のモジュールごとにセクションや外部シンボルの
情報を得たいときまたはライブラリ全体の外部定義 / 外部参照シンボル情報を得たい
ときは , -dt オプションを使用します。
■ リストファイルの詳細情報の出力指定 (-dt)
【記述形式】
-dt < 情報種別 > [, < 情報種別 >] •••
【パラメータ】
< 情報種別 >
s: モジュールごとにセクション名とそのサイズを出力します。
d: モジュールごとに外部定義シンボルを出力します。
r: モジュールごとに外部参照シンボルを出力します。
a: ライブラリ全体の外部定義シンボルと ,ライブラリ内で未解決の外部参照シンボ
ルを出力します。
【説明】
本オプション指定がないとき , リストファイルには登録されているモジュール名だ
けが出力されます。本オプションは , さらに詳しい情報を得たいときに使用します。
< 情報種別 > の指定は省略できません。
< 情報種別 > 指定は , 複数のキーワードをカンマで区切って指定できます。
-m オプションが指定されていない場合 , 本オプション指定は無効になります。
【例 1】
flib907s syslib.lib -m libx.mp2 -dt r,s
外部参照シンボルおよびセクション名を含むリストを libx.mp2 に出力します。
【例 2】
flib907s syslib -m libx.lis -dt s,d,r,a
ライブラリアンが出力可能なすべての情報を libx.lis に出力します。
July 31, 2015, CM41-00315-6
245
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.8
So ft
Manu al
リスト 1 ページの行数指定 (-pl)
リスト 1 ページの出力行数をデフォルト (60 行 ) から変更するときに使用します。
■ リスト 1 ページの行数指定 (-pl)
【記述形式】
-pl < 行数 >
( デフォルト : 60)
【パラメータ】
< 行数 >
0, 20 ~ 255 の範囲で指定する。
【説明】
リストファイルの 1 ページに印字する行数を指定します。
0 指定は , リストファイル出力時 , ページ制御を行わないようにします。
-m オプションが指定されていない場合 , 本オプション指定は無効になります。
【例 1】
flib907s syslib.lib -m libx.mp2 -pl 40
リスト 1 ページの行数を , 40 にします。
【例 2】
flib907s syslib.lib -m - -dt s -pl 0
改ページなしで , セクション情報を付加したリストを標準出力に出力します。
246
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
リスト 1 行の桁数指定 (-pw)
10.2.9
リスト 1 行の出力桁数をデフォルト (70 文字 ) から変更するときに使用します。
■ リスト 1 行の桁数指定 (-pw)
【記述形式】
-pw < 桁数 >
( デフォルト : 70)
【パラメータ】
< 桁数 >
70 ~ 1023 の範囲で指定する。
【説明】
リストファイルの 1 行に印字する桁数を指定します。
長いシンボル名 , セクション名 , モジュール名がデフォルト桁数では 2 行以上になっ
て見にくい場合に使用してください。
デフォルト表示桁数 (70) のとき , 1 行内で表示できる文字数は以下のとおりです。
• モジュール名 : 22 文字
• セクション名 : 20 文字
• シンボル名 : 29 文字
-m オプションが指定されていない場合 , 本オプション指定は無効になります。
【例】
flib907s syslib.lib -m libx.mp2 -pw 80
リスト 1 行の桁数を , 80 に変更します。
この場合 , 1 行内で表示できる各名称の文字数は以下のようになります。
• モジュール名 : 32 文字
• セクション名 : 30 文字
• シンボル名 : 34 文字
<注意事項>
ライブラリアンのリストは , -pw オプションでの桁数指定により , 1 行内で表示するモ
ジュール名 , セクション名 , シンボル名の文字数が変わります。
シンボル名は , 1 行を左右 2 つのフィールドに分けて表示するため , 最も長いシンボル名
の 2 倍 +12 が見やすいリストになります。
July 31, 2015, CM41-00315-6
247
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.10
So ft
Manu al
バックアップファイルの作成 (-b)
ライブラリファイルの編集処理を行うと , ライブラリファイルの内容が変更されま
す。
編集前のライブラリファイルのバックアップを残したい場合に -b オプションを指定
します。
■ バックアップファイルの作成 (-b)
【記述形式】
-b
【パラメータ】
なし
【説明】
ライブラリアンは , モジュールの追加や削除など編集作業を行うと , ファイル内容
が変更されるため元の内容は失われます。
このオプションにより , 元のファイルのバックアップファイルを作成します。
バックアップファイルの拡張子は , ".bak" になります。
バックアップは 1 世代分しか行わないため , 大事なライブラリファイルを編集する
場合は , ユーザ自身でバックアップをとってからライブラリアンを使用してくださ
い。
【例】
flib907s syslib -a putc.obj -b
編集前の syslib.lib を編集後 syslib.bak として残します。
編集後の syslib.lib は , putc.obj と getc.obj が追加されます。
248
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
10.2.11
Soft
Ma nual
バックアップファイルの作成抑止 (-Xb)
バックアップ取得オプションである -b を取り消すときに -Xb オプションを使用しま
す。
■ バックアップファイルの作成抑止 (-Xb)
【記述形式】
( デフォルト )
-Xb
【パラメータ】
なし
【説明】
ライブラリアンは , デフォルト設定で編集対象のライブラリファイルのバックアッ
プは作成しません。これは , -Xb オプションを指定したのと同じです。
本オプションは , -b オプションの指定を無効にする場合に指定します。
【例】
以下の 3 つの指定は , すべて同じ処理を行います。
flib907s syslib
-a putc.obj,getc.obj
flib907s syslib
-a putc.obj,getc.obj -Xb
flib907s syslib -b -a putc.obj,getc.obj -Xb
編集前の syslib.lib は , 編集後削除されます。
編集後の syslib.lib には , putc.obj と getc.obj が付加されています。
July 31, 2015, CM41-00315-6
249
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
ライブラリファイルの内容検査 (-c)
10.2.12
ライブラリファイルの内容の簡単な検査を行うオプションです。
■ ライブラリファイルの内容検査 (-c)
【記述形式】
-c
【パラメータ】
なし
【説明】
以下の 2 項目の検査を行います。
● ライブラリ内未解決外部参照シンボルの有無
リンカは,ライブラリから取り込んだモジュールに未解決の外部参照シンボルが含まれ
ていた場合,同じライブラリファイル中に定義シンボルを含むモジュールがあることを
前提にして , 同じライブラリファイル中でのシンボル解決を優先します。
1 つのライブラリファイル中での , 外部参照 / 定義シンボルの対応関係を調べ , 該当す
る外部定義シンボルのない外部参照シンボルが含まれる場合に,メッセージを出力しま
す。
● デバッグ情報付モジュールの有無
-g オプションを指定したライブラリファイルへのモジュール登録処理では , オブジェ
クトモジュール中のデバッグ情報を取り除くことなくそのままライブラリに登録しま
す。
これは , ライブラリに登録したモジュールのデバッグを行うことを考慮したためです。
動作確認が済めばデバッグ情報は必要がなくなります。
ライブラリ中にデバッグ情報付きのモジュールが登録されているか否かを確認し,もし
あればメッセージを出力します。
【例】
flib907s syslib.lib -c
syslib.lib の内容をチェックします。
<注意事項>
ライブラリファイルの内容検査 (-c) オプションは , ほかのオプションと共に指定できませ
ん。
上記の指定例のように , 単独で指定してください。
250
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
ファイル内容の最適化 (-O)
10.2.13
ライブラリに登録されているオブジェクトモジュールにデバッグ情報があれば取り
除きます。
■ ファイル内容の最適化 (-O)
【記述形式】
-O
【パラメータ】
なし
【説明】
ライブラリに登録されているオブジェクトモジュールにデバッグ情報ブロック付
きのものがある場合 , デバッグ情報部を取り除いて登録しなおします。
オブジェクトモジュールファイル中では , デバッグ情報がかなり大きな部分を占め
ていますので , デバッグ情報を削除することでライブラリファイルのサイズをかな
り小さくすることができます。
【例】
flib907s syslib -O
syslib.lib ファイルから , デバッグ情報を削除します。
<注意事項>
ファイル内容の最適化 (-O) オプションは , ほかのオプションと共に指定できません。
上記の指定例のように , 単独で指定してください。
July 31, 2015, CM41-00315-6
251
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.14
So ft
Manu al
デバッグ情報の出力指定 (-g)
ライブラリファイルにオブジェクトモジュールを登録するときに , デバッグ情報を削
除しないようにするときに指定します。
■ デバッグ情報の出力指定 (-g)
【記述形式】
-g
【パラメータ】
なし
【説明】
ライブラリアンは , 通常オブジェクトモジュールにデバッグ情報が含まれている場
合 , デバッグ情報を取り去ってライブラリファイルに登録しますが , 本オプション
によりデバッグ情報の有無に かかわらず指定されたオブジェクトをそのまま登録
します。
ライブラリ作成後にデバッグ情報を削除したい場合には , 最適化オプション -O を使
用してライブラリファイルを作り直すことができます。
【例】
flib907s syslib.lib -a inchar,outchar -g
inchar.obj, outchar.obj に , デバッグ情報が含まれていても削除せずにライブラリファ
イルに登録します。
252
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
10.2.15
Soft
Ma nual
デバッグ情報の出力抑止指定 (-Xg)
デバッグ情報の未削除指定オプションである -g を取り消すときに -Xg オプションを
使用します。
■ デバッグ情報の出力抑止指定 (-Xg)
【記述形式】
( デフォルト )
- Xg
【パラメータ】
なし
【説明】
ライブラリアンは , 通常オブジェクトモジュールにデバッグ情報が含まれている場
合 , デバッグ情報を取り去ってライブラリファイルに登録します。これは , この -Xg
オプションを指定したのと同じです。
本オプションは , -g オプションの指定を打ち消すために指定します。
最適化オプション -O を使用した場合 , ライブラリ作成後にデバッグ情報を一括して
削除することもできます。
【例】
以下の 3 つの指定は , すべて同じ処理を行います。
flib907s syslib.lib
-a inchar,outchar
flib907s syslib.lib
-a inchar,outchar -Xg
flib907s syslib.lib -g -a inchar,outchar -Xg
inchar.obj, outchar.obj に含まれているデバッグ情報は , ライブラリファイルに登録し
ません。
July 31, 2015, CM41-00315-6
253
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
ターゲット CPU 指定 (-cpu)
10.2.16
ターゲット CPU の指定を行います。
ライブラリファイル化を行うプログラムのターゲット CPU を MB 番号で指定しま
す。
■ ターゲット CPU 指定 (-cpu)
【記述形式】
-cpu <MB 番号 >
【パラメータ】
<MB 番号 >
ターゲット CPU の MB 番号
【説明】
ライブラリファイル化を行うプログラムのターゲット CPU を MB 番号で指定しま
す。
【例】
flib907s syslib.lib -a inchar,outchar -cpu MB90600A
flib907s syslib.lib -a inchar,outchar -cpu MB90700
<注意事項>
ライブラリ化処理を実行する際には , 本オプションでターゲット CPU の指定が必要です。
このオプションの省略はできません。
254
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
CPU 情報ファイル指定 (-cif)
10.2.17
ライブラリアンで使用する CPU 情報ファイルを指定します。
■ CPU 情報ファイル指定 (-cif)
【記述形式】
-cif <CPU 情報ファイル名 >
【パラメータ】
<CPU 情報ファイル名 >
ライブラリアンで使用する CPU 情報ファイル
【説明】
ライブラリアンで使用する CPU 情報ファイルを指定します。
【例】
flib907s syslib.lib -a inchar,outchar -cpu MB90704
-cif C:\Softune\lib\907\cpu_info\MB90704.csv
<注意事項>
SOFTUNE Tools は , CPU 情報ファイルを参照して , CPU に関する情報を取得します。
関連するツール間で異なる CPU 情報ファイルを参照した場合 , 作成するプログラムに問
題が発生することがあります。
SOFTUNE Tools に標準で添付されている CPU 情報ファイルは , 以下の場所にあります。
インストール先ディレクトリ \lib\907\907.csv
コンパイラ・アセンブラパックを異なるディレクトリにインストールし , SOFTUNE
Workbench を使用せずにコンパイラ , アセンブラおよびリンケージキットを使用する場
合, 各ツールに対して同一のCPU情報ファイルを参照するように-cifで指定してください。
July 31, 2015, CM41-00315-6
255
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.18
So ft
Manu al
引数のレジスタ渡しのライブラリ出力指定オプショ
ン (-rp)
-rp オプションは , 関数呼び出しインタフェースが引数のレジスタ渡しのライブラリ
を作成 / 編集する際に指定するオプションです。
-rp, -Xrp どちらの指定もない場合は , 関数呼び出しインタフェースが引数のスタッ
ク渡しのライブラリものとして処理します。
■ 引数のレジスタ渡しのライブラリ出力指定オプション (-rp)
【記述形式】
-rp 【パラメータ】
なし
【説明】
-rp オプションは , 関数呼び出しインタフェースが引数のレジスタ渡しのライブラリ
を作成 / 編集する際に指定するオプションです。
-rp オプションは , 以下のような場合に指定します。
• 引数のレジスタ渡しのオブジェクトをライブラリに登録する場合
• 引数のレジスタ渡しのオブジェクトが登録されたライブラリを編集する場合
【例】
flib907s sample.lib -cpu mb90704 -a mod1.obj mod2.obj -rp
256
CM41-00315-6, July 31, 2015
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
<注意事項>
• 以下の場合 , ライブラリアンはエラー(***E4410U: 関数呼び出しインタフェースの異な
るモジュールがあります ( ファイル名 )) を出力します。本エラーが発生した場合 , -rp
オプション指定または , 入力オブジェクト , 編集対象ライブラリの関数呼び出しインタ
フェースを修正してください。
- -rp オプション指定時 , 引数のスタック渡しのオブジェクトを登録しようとした場合
- -rp オプション指定時 , 引数のスタック渡しのオブジェクトが登録されたライブラリ
を編集しようとした場合
- -Xrpオプション指定時,引数のレジスタ渡しのオブジェクトを登録しようとした場合
- -Xrp オプション指定時 , 引数のレジスタ渡しのオブジェクトが登録されたライブラ
リを編集しようとした場合
• 引数のレジスタ渡しのオブジェクトと引数のスタック渡しのオブジェクトの混在リン
クはできません。
そのため , ライブラリを作成 / 管理する際 , 以下のことをお勧めします。
- ライブラリファイル名に登録されているオブジェクトの関数呼び出しインタフェー
スが区別できる名前を指定する。
例 ) 引数のスタック渡しのライブラリ:sample_stk.lib
引数のレジスタ渡しのライブラリ:sample_rg.lib
July 31, 2015, CM41-00315-6
257
第 10 章 ライブラリアンの オプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
引数のスタック渡しのライブラリ出力指定オプショ
ン (-Xrp)
10.2.19
-Xrp オプションは , 関数呼び出しインタフェースが引数のスタック渡しのライブラ
リを作成 / 編集する際に指定するオプションです。
-rp, -Xrp どちらの指定もない場合は , 関数呼び出しインタフェースが引数のスタッ
ク渡しのライブラリを作成 / 編集するものとしてライブラリを作成 / 編集します。
■ 引数のスタック渡しのライブラリ出力指定オプション (-Xrp)
【記述形式】
( デフォルト )
-Xrp
【パラメータ】
なし
【説明】
関数呼び出しインタフェースが引数のスタック渡しのライブラリを作成 / 編集する
際に指定するオプションです。
-Xrp オプションを指定すると , 既に指定されている -rp オプションを無効にします。
-Xrp オプションは , 以下のような場合に指定します。
• 引数のスタック渡しのオブジェクトをライブラリに登録する場合
• 引数のスタック渡しのオブジェクトが登録されたライブラリを編集する場合
【例】
flib907s sample.lib -cpu mb90704 -a mod1.obj mod2.obj -rp -Xrp
<注意事項>
以下の場合 , ライブラリアンはエラー (***E4410U: 関数呼び出しインタフェースの異なる
モジュールがあります ( ファイル名 )) を出力します。本エラーが発生した場合 , -rp オプ
ション指定または , 入力オブジェクト , 編集対象ライブラリの関数呼び出しインタフェー
スを修正してください。
• -rp オプション指定時 , 引数のスタック渡しのオブジェクトを登録しようとした場合
• -rp オプション指定時 , 引数のスタック渡しのオブジェクトが登録されたライブラリを
編集しようとした場合
• -Xrp オプション指定時 , 引数のレジスタ渡しのオブジェクトを登録しようとした場合
• -Xrp オプション指定時 , 引数のレジスタ渡しのオブジェクトが登録されたライブラリ
を編集しようとした場合
258
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 11 章
ライブラリアンの
リストフォーマット
この章では , ライブラリアンのリストファイルの構
成について説明します。
11.1 リストファイルの情報内容
11.2 モジュール名リスト
11.3 モジュールごとの詳細情報
11.4 ライブラリ内の外部定義 / 参照シンボル情報
July 31, 2015, CM41-00315-6
259
第 11 章 ライブラリアンの リストフォーマット
11.1 リストファイルの情報内容
Su pp or t
11.1
So ft
Manu al
リストファイルの情報内容
ライブラリアンのリストファイルは , ライブラリファイルの内容を以下の 5 つの分
類で出力します。
• モジュール名
• モジュールごとのセクション情報
• モジュールごとの外部定義シンボル情報
• モジュールごとの外部参照シンボル情報
• モジュール全体の外部定義 / 参照シンボル情報
リスト出力を行うためには , -m オプションおよび -dt オプションの指定が必要です。
■ リストファイルの構成
図 11.1-1 にリストファイルの構成を示します。
図 11.1-1 リストファイルの構成
<リストヘッダ>
-mのみ
・ライブラリファイル名
・登録モジュール数/外部定義シンボル数
・CPU情報など
<モジュール数>
-mのみ
・登録モジュール名
<モジュールごとのセクション情報>
-dt s指定
<モジュールごとの外部参照シンボル名情報>
-dt r指定
<モジュールごとの外部定義シンボル名情報>
-dt d指定
.
.
.
<モジュール全体の外部定義/参照シンボル名情報>
260
-dt a指定
CM41-00315-6, July 31, 2015
第 11 章 ライブラリアンの リストフォーマット
11.2 モジュール名リスト
Support
Soft
Ma nual
モジュール名リスト
11.2
ライブラリアンのデフォルトリスト出力 (-dt オプション指定なしのとき ) では , ライ
ブラリファイル中の登録モジュール名だけを表示します。
■ リスト出力概要
-m オプションが指定された場合 , ライブラリファイルの内容を表示します。
ライブラリアンリストの形式は , 図 11.2-1 のとおりです。
図 11.2-1 ライブラリアンリストの形式 ( デフォルト )
*1
*2
*3
*4
*5
*6
*7
Library File Name
: sample.lib
Number of Modules : 3
Number of Symbols : 9
Librarian Name : F2MC-16 Family SOFTUNE Librarian
Library Creation Date 2003-09-09 11:47:59
Library Revision Date 2003-09-09 11:47:59
[ Module Name ]
ModuleA
ModuleB
ModuleC
[ Entry Date ]
2003-03-01 14:23:50
1997-04-17 09:41:15
2003-03-01 14:23:50
[ Creation Date ]
2003-03-19 10:03:21
1996-10-07 20:18:58
2003-02-23 15:15:00
*1: ライブラリファイル名
*2: ライブラリファイルに登録されているモジュールの数 (10 進数 )
*3: ライブラリファイルに登録されている外部定義シンボルの数 (10 進数 )
*4: ライブラリアンの名前
*5: ライブラリファイルを最初に作成した日時
*6: ライブラリファイルの最新更新日時……新規作成時は *5 と同じ
*7: Module Name ] 登録モジュール名 ( アルファベット順 )
モジュール名は ( ページ幅 -48) 文字を 1 行に表示します。デフォルト (-pw 70) の場
合は , 22 文字です。
[ Entry Date ] モジュールがライブラリファイルに登録された日時
[ Creation Date ] モジュールが作成された日時
July 31, 2015, CM41-00315-6
261
第 11 章 ライブラリアンの リストフォーマット
11.3 モジュールごとの詳細情報
Su pp or t
So ft
Manu al
モジュールごとの詳細情報
11.3
モジュールごとの詳細情報には以下の 3 つがあり , 出力指示は -dt オプションで行い
ます。
• セクション情報 (-dt s)
• 外部定義シンボル情報 (-dt d)
• 外部参照シンボル情報 (-dt r)
■ リスト出力概要
図 11.3-1 にライブラリアンリストの形式 ( 詳細指定時 ) を示します。
図 11.3-1 ライブラリアンリストの形式 ( 詳細指定時 )
Library File Name
: sample.lib
Number of Modules : 3
Number of Symbols : 3
Librarian Name : F2MC-16 Family SOFTUNE Librarian
Library Creation Date 2003-09-09 11:57:57
Library Revision Date 2003-09-09 11:57:57
*1
*2
*3
[ Module Name ]
ModuleA
-- Section -code
data
-- Ext_Ref Symbol(s) -p_text
-- Ext_Def Symbol(s) -prtext
[ Module Name ]
[ Entry Date ]
2003-09-09 11:57:57
-- Type -CODE
DATA
[ Creation Date ]
2003-09-09 11:57:34
-- Size -0x000002E8
0x0000006A
[ Entry Date ]
[ Creation Date ]
tx_len
:
:
*1: -dt オプションの s パラメータにより出力されます。
モジュール内のセクションの情報です。
セクション名 , セクション属性 , サイズを表示します。
セクション名は , ( ページ幅 -50) 文字を 1 行に表示します。
*2: -dt オプションの r パラメータにより出力されます。
モジュール内の外部参照シンボル名を 1 行に 2 シンボルずつ表示します。
*3: -dt オプションの d パラメータにより出力されます。
モジュール内の外部定義シンボル名を 1 行に 2 シンボルずつ表示します。
外部シンボル名は (( ページ幅 -12)/2) 文字を 1 行に表示します。
262
CM41-00315-6, July 31, 2015
第 11 章 ライブラリアンの リストフォーマット
11.4 ライブラリ内の外部定義 / 参照シンボル情報
Support
Soft
Ma nual
ライブラリ内の外部定義 / 参照シンボル情報
11.4
ライブラリファイルに登録されているすべてのモジュールに関する , 外部定義シンボ
ルおよび外部参照シンボルの情報を表示できます。出力指示は -dt オプションで行い
ます。(-dt a)
■ リスト出力概要
図 11.4-1 にライブラリアンリストの形式 ( 詳細指定時 ) を示します。
図 11.4-1 ライブラリアンリストの形式 ( 詳細指定時 )
Library File Name
: sample.lib
Number of Modules : 3
Number of Symbols : 3
Librarian Name : F2MC-16 Family SOFTUNE Librarian
Library Creation Date 2003-09-09 12:58:30
Library Revision Date 2003-09-09 12:58:30
[ Module Name ]
ModuleA
*1
*2
:
:
[ ALL Ext_Def Symbol(s) ]
chr1get
prtext
[ ALL Ext_Ref Symbol(s) ]
chr_get
[ Entry Date ]
2003-09-09 12:58:30
[ Creation Date ]
2003-09-09 11:57:34
p_text
tx_len
*1: -dt オプションの a パラメータにより出力されます。
ライブラリファイル内全体の外部定義シンボル名の一覧を , 1 行に 2 シン ボルずつ
表示します。
*2: ライブラリファイル内で対応する外部定義シンボルのない外部参照シンボルの一
覧を , 1 行に 2 シンボルずつ表示します。
外部シンボル名は (( ページ幅 -12)/2) 文字を 1 行に表示します。
July 31, 2015, CM41-00315-6
263
第 11 章 ライブラリアンの リストフォーマット
11.4 ライブラリ内の外部定義 / 参照シンボル情報
Su pp or t
264
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 12 章
ライブラリアンの制限事項
および Q &A
この章では , ライブラリアンの制限事項や使用上の
Q &A について述べます。
12.1 ライブラリアンの制限事項
12.2 ライブラリアンの使用上の Q &A
July 31, 2015, CM41-00315-6
265
第 12 章 ライブラリアンの制限事項および Q &A
12.1 ライブラリアンの制限事項
Su pp or t
12.1
So ft
Manu al
ライブラリアンの制限事項
ライブラリアンを使用する上で , 1 つのライブラリファイルに登録可能なモジュール
数や外部シンボル数の制限や , 注意しなくてはならない事柄を説明します。
■ ライブラリアンの制限事項
処理能力に関しては , 以下の 2 つの制限事項があります。
• 1 つのライブラリファイルに登録可能なモジュール数
: 最大 65535
• 1 つのライブラリファイルに登録可能な外部定義シンボル数 : 最大 65535
■ 必要なディスク容量についての注意
既存のライブラリファイルの編集を行い , バックアップファイルを作成するときは , 新
しく作成するライブラリファイルと既存ライブラリが格納できるだけの十分な空き容
量があることを確認のうえ編集作業を行ってください。
■ オプションの指定に関する注意
ライブラリファイルの内容検査 (-c) およびファイル内容の最適化 (-O) の両オプション
は , それぞれ単独で指定してください。
ほかのオプションとの併用はできません。
266
CM41-00315-6, July 31, 2015
第 12 章 ライブラリアンの制限事項および Q &A
12.2 ライブラリアンの使用上の Q &A
Support
12.2
Soft
Ma nual
ライブラリアンの使用上の Q &A
ライブラリアンの使用上に関する Question と Answer を示します。
■ ライブラリファイルの作成に関する Q &A
Q.
ライブラリファイルに登録できるファイル形式は何ですか ?
A.
アセンブラが出力する , オブジェクトモジュールです。
これは , デフォルト拡張子が , (.obj) で作成されるファイルです。
例.
fasm907s file1
→ file1.obj 出力
fasm907s file2
→ file2.obj 出力
flib907s libfile -a file1.obj,file2.obj
Q.
自作したライブラリファイルからの取り込みモジュールに障害があるようなので,デバッグし
たいのですがシンボル情報が使えません。
A.
デバッグ情報付きのオブジェクトモジュールでないと,デバッグ時にシンボル情報の使用はで
きません。
デバッグ情報付きで作成したオブジェクトモジュールに差し替える必要があります。
デバッグの必要がありそうなオブジェクトモジュールをライブラリ化して使用する場合には,
あらかじめデバッグ情報付で登録 (-g オプション ) しておくと良いでしょう。
デバッグが終了した時点で , デバッグ情報を削除 (-O オプション ) できます。
例.
fasm907s file1 -g
flib907s libfile -r file1 -g
flib907s libfile -O
Q.
汎用に作成したサブルーチンをライブラリにまとめたいと思っていますがオブジェクトモ
ジュールの数が非常に多く , 全部のファイル名を指定するのが面倒です。
A.
オブジェクトモジュールのライブラリへの追加 (-a オプション ) と置換 (-r オプション ) には ,
ワイルドカード指定ができます。
例.
flib907s
July 31, 2015, CM41-00315-6
→ デバッグ情報付
→ デバッグ情報付
→ デバッグ情報無
file1.obj
出力
libfile.lib 出力
libfile.lib 出力
libfile -a "*.obj" → 拡張子 ".obj" のファイルをすべて登録
267
第 12 章 ライブラリアンの制限事項および Q &A
12.2 ライブラリアンの使用上の Q &A
Su pp or t
268
So ft
Manu al
Q.
以前に作成したライブラリファイルの内容がわからなくなってしまいました。どんなモ
ジュールが登録されているか調べる方法がありますか ?
A.
ライブラリファイルの内容は , -m オプションで見ることができます。"-m ファイル名 " を指定
すれば , デフォルト拡張子が (.mp2) のリストファイルが作成されます。
-m オプションで出力される内容では情報不足の場合 , -dt オプションを併用してより詳細な情
報を得ることができます。
例.
flib907s libfile -m libdoc → リストファイル libdoc.mp2
flib907s libfile -m libdoc -dt a,s
→ 詳細情報を含んだリストファイル libdoc.mp2
出力
出力
Q.
ライブラリファイルの内容を確認したいのですが , ファイルにとるほどではないので , 画面上
に出力することはできますか ?
A.
-m オプションのファイル名指定のかわりにハイフン (-) を指定すると標準出力への表示にな
ります。
例.
flib907s
flib907s
flib907s
Q.
ライブラリファイルの内容をリスト出力したところ , 文字数の多いシンボル名の表示が 2 行
に渡ってしまい見にくいのですが ?
A.
-pw オプションで , 1 行に表示する桁数を増やしてください。デフォルトは 70 桁なので , 2 行
目に表示された部分が4文字ならその倍の8を加えた78桁以上を指定すれば1行に収まります。
例.
flib907s
Q.
ライブラリファイル中のモジュールを新しいモジュールと入れ替えたところ幾つか間違えて
登録してしまったことに気づきました。置換前のライブラリファイルもバックアップをとっ
ておらず , 復旧するのに苦労しました。
A.
ライブラリアンでは , -b オプションの指定により 1 世代分のバックアップファイル
( 拡張子 ".bak") を作成できます。
ライブラリファイルの編集を行う場合は,予め元のライブラリのバックアップをとっておくこ
とが望ましいですが , 必要に応じて -b オプションを指定してください。
例.
flib907s
libfile -m libfile -m - -dt a,s
libfile -a file3.obj -m -
libfile -m libdoc -pw 80
libfile -r file1,file2 -d mod4 -b
CM41-00315-6, July 31, 2015
Support
第 IV 部
Soft
Ma nual
オブジェクト形式コンバータ編
この部では , オブジェクト形式コンバータの種類 , オプション一覧 , 機能説明 , オブ
ジェクト形式の変換について説明します。
第 13 章 オブジェクト形式 コンバータの仕様
第 14 章 オブジェクト形式コンバータの共通オプション
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
第 17 章 バイナリコンバータ (m2bs, h2bs)
第 18 章 その他のコンバータ
第 19 章 オブジェクト形式コンバータの制限事項および Q &A
July 31, 2015, CM41-00315-6
269
Su pp or t
270
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 13 章
オブジェクト形式
コンバータの仕様
この章では , オブジェクト形式コンバータの概要と
種類を説明します。
オブジェクト形式コンバータはオブジェクト形式
を変換するツールです。
13.1 オブジェクト形式コンバータの概要
13.2 オブジェクト形式コンバータの種類
13.3 オブジェクト形式コンバータの実行
July 31, 2015, CM41-00315-6
271
第 13 章 オブジェクト形式 コンバータの仕様
13.1 オブジェクト形式コンバータの概要
Su pp or t
13.1
So ft
Manu al
オブジェクト形式コンバータの概要
オブジェクト形式コンバータは以下のファイル形式を処理の対象としています。
• リンカ出力の絶対形式ロードモジュール
• S フォーマット
• HEX フォーマット
• バイナリデータファイル
■ オブジェクト形式コンバータの概要
オブジェクト形式コンバータには , ロードモジュールコンバータ , アジャスタ ( 整形
ツール ), バイナリコンバータ , コンバータの 4 種類があります。
● ロードモジュールコンバータ
ロードモジュールコンバータはリンカ出力の絶対形式ロードモジュールを汎用フォー
マットに変換する際に用います。
図 13.1-1 に , オブジェクト形式コンバータの相互関係を示します。
図 13.1-1 ロードモジュールコンバータの入出力
絶対形式
ロードモジュール
(.abs)
f2ms
f2hs
f2is
f2es
Sフォーマット
S1/S2/S3
HEXフォーマット
HEX8/HEX16/HEX32
HEX8フォーマット
(HEX8形式のみ)
HEX16フォーマット
(HEX16形式のみ)
(.mhx)
272
(.hex)
(.ihx)
(.ehx)
CM41-00315-6, July 31, 2015
第 13 章 オブジェクト形式 コンバータの仕様
13.1 オブジェクト形式コンバータの概要
Support
Soft
Ma nual
● アジャスタ , バイナリコンバータ
アジャスタは S フォーマットや HEX フォーマットの整形をする際に , バイナリコン
バータは S フォーマットや HEX フォーマットをバイナリに変換する際に用います。
図 13.1-2 に , アジャスタ , バイナリコンバータの入出力を示します。
図 13.1-2 アジャスタ , バイナリコンバータの入出力
Sフォーマット
HEXフォーマット
(.mhx)
(.hex)
m2ms
m2bs
整形済み
Sフォーマット
バイナリ
フォーマット
(.ahx)
h2hs
h2bs
整形済み
HEXフォーマット
(.bin)
バイナリ
フォーマット
(.ahx)
(.bin)
● コンバータ
コンバータは S フォーマットと HEX8/HEX16 フォーマットの相互変換する際に用いま
す。
図 13.1-3 に , コンバータの入出力を示します。
図 13.1-3 コンバータの入出力
Sフォーマット
HEX8フォーマット
(.mhx)
HEX8/HEX16
フォーマット
(.ihx)
(.ehx)
m2is
m2es
i2ms
e2ms
HEX8フォーマット
HEX16フォーマット
Sフォーマット
Sフォーマット
(.ihx)
(.ehx)
July 31, 2015, CM41-00315-6
(.mhx)
(.mhx)
273
第 13 章 オブジェクト形式 コンバータの仕様
13.2 オブジェクト形式コンバータの種類
Su pp or t
13.2
So ft
Manu al
オブジェクト形式コンバータの種類
オブジェクト形式コンバータの各コマンド名は , x2ys のように命名されており , 2
の前の x が入力ファイルのオブジェクト形式を , 後の y が出力ファイルのオブジェ
クト形式を示しています。
x と y の部分のアルファベット 1 文字は , 以下の形式を示しています。
• f
: リンカ出力の絶対形式ロードモジュール
• m
: S フォーマット
• h
: HEX フォーマット (HEX8/HEX16/HEX32)
• b
: バイナリデータ形式
• i
: HEX8 フォーマット (HEX8)
• e
: HEX16 フォーマット (HEX16)
■ ロードモジュールコンバータの種類
オブジェクト形式の変換は , 表 13.2-1 のコマンドで行います。
S フォーマットへの変換には f2ms を使用します。
また , HEX フォーマットへの変換には f2hs を使用します。
f2is を用いれば HEX8 フォーマットへ , f2es を使用した場合 HEX16 フォーマットへ変
換可能ですが , HEX8/HEX16/HEX32 に対応した f2hs を使用してください。
表 13.2-1 ロードモジュールコンバータのコンバート内容
コマンド名
コ ン バー ト 内容
f2ms
絶対形式ロードモジュール → S フォーマット
f2hs
絶対形式ロードモジュール → HEX8/HEX16/HEX32 フォーマット
f2is
絶対形式ロードモジュール → HEX8 フォーマット
f2es
絶対形式ロードモジュール → HEX16 フォーマット
■ フォーマットアジャスタ
フォーマットアジャスタは, SフォーマットのオブジェクトファイルやHEXフォーマッ
トのオブジェクトファイルを整形します。詳しくは ,「第 16 章 フォーマットアジャス
タ (m2ms, h2hs)」を参照してください。
■ バイナリコンバータ
S フォーマットや HEX フォーマットのオブジェクトファイルをバイナリデータ ( メモ
リイメージ ) へ変換しファイルへ出力します。詳しくは「第 17 章 バイナリコンバー
タ (m2bs, h2bs)」を参照してください。
274
CM41-00315-6, July 31, 2015
第 13 章 オブジェクト形式 コンバータの仕様
13.2 オブジェクト形式コンバータの種類
Support
Soft
Ma nual
■ その他のコンバータの種類
オブジェクト形式の変換は , 表 13.2-2 のコマンドで行います。
表 13.2-2 その他のコンバータのコンバート内容
コマンド名
July 31, 2015, CM41-00315-6
コ ン バ― ト 内容
m2is
S フォーマット
→ HEX8 フォーマット
m2es
S フォーマット
→ HEX16 フォーマット
i2ms
HEX8 フォーマット
→ S フォーマット
e2ms
HEX16 フォーマット
→ S フォーマット
275
第 13 章 オブジェクト形式 コンバータの仕様
13.3 オブジェクト形式コンバータの実行
Su pp or t
13.3
So ft
Manu al
オブジェクト形式コンバータの実行
オブジェクト形式コンバータの実行は , コマンド名の後に , 入力ファイル名を指定す
るだけで実行できます。
■ オブジェクト形式コンバータのコマンド実行
各コマンドとも , コマンド名の後に , 入力ファイル名を指定するだけで実行できます。
x2ys < 入力ファイル名 > [ オプション ]
指定された < 入力ファイル名 > を x 形式として処理し , y 形式ファイルを作成します。
各オブジェクト形式をファイル名から識別できるように,オブジェクト形式コンバータ
では以下に示すデフォルト拡張子を使用します。
• 絶対形式ロードモジュール
: .abs
• S フォーマット
: .mhx, ahx
• HEX8/HEX16/HEX32
: .hex, aix
• バイナリデータ形式
: .bin
• HEX8
: .ihx
• HEX16
: .ehx
バイナリコンバータおよびアジャスタの実行の際は , 必ず -ran オプションが必要です。
詳しくは「16.3.2 出力範囲指定 (-ran)」を参照してください。
【例】
f2ms sample
リンカ出力の絶対形式ロードモジュール sample.abs を入力して , S フォーマットの
sample.mhx ファイルを出力します。
276
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 14 章
オブジェクト形式コンバー
タの共通オプション
この章では , オブジェクト形式コンバータの各共通
オプションについて詳しく説明します。
14.1 オブジェクト形式コンバータのオプション一覧
14.2 出力ファイル名の変更 (-o)
14.3 パディング (-p)
July 31, 2015, CM41-00315-6
277
第 14 章 オブジェクト形式コンバータの共通オプション
14.1 オブジェクト形式コンバータのオプション一覧
Su pp or t
14.1
So ft
Manu al
オブジェクト形式コンバータのオプション一覧
オブジェクト形式コンバータは , コマンド名の後に入力ファイル名を指定するだけで
実行できますが , それに加えていくつかのオプションが使用できます。
■ オブジェクト形式コンバータの共通オプションの種類
オブジェクト形式コンバータの各コマンドでは,以下のオプションを共通に使用できま
す。
表 14.1-1 にオブジェクト形式コンバータの共通オプション一覧を示します。
表 14.1-1 オブジェクト形式コンバータの共通オプション一覧
機能
オプション
出力ファイル名の変更
-o
パディングデータ指定
-p
デフォルトオプションファイル読込み抑止指定
備考
-Xdof
* 共通オプション
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
-cmsg
* 共通オプション
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
オプションファイル読込み指定
終了メッセージ表示指定
終了メッセージ表示抑止指定
オプションに関する簡単な説明は , コマンド名のみの入力 , もしくは -help オプション
で表示できます。
x2ys
x2ys -help
278
CM41-00315-6, July 31, 2015
第 14 章 オブジェクト形式コンバータの共通オプション
14.2 出力ファイル名の変更 (-o)
Support
14.2
Soft
Ma nual
出力ファイル名の変更 (-o)
コンバート後の出力ファイルの作成ディレクトリおよびファイル名をデフォルトか
ら変更します。
■ 出力ファイル名の変更 (-o)
【記述形式】
-o < オブジェクトファイル名 >
【パラメータ】
< オブジェクトファイル名 >
出力ファイルの名前
【説明】
コンバート後の出力ファイル名を変更したいときに指定します。
パス名付きで指定することで , 出力先ディレクトリも変更できます。
本オプションを省略した場合は , 入力ファイル名の拡張子を変換後のフォーマット
のデフォルト拡張子に直したものを出力ファイル名とします。
< オブジェクトファイル名 > 指定で拡張子を省略した場合も , デフォルト拡張子を
付加します。
各フォーマットのデフォルト拡張子は , 以下の 6 つです。
• 絶対形式ロードモジュール
: .abs
• S フォーマット
: .mhx .ahx
• HEX8/HEX16/HEX32
: .hex .aix
• バイナリデータファイル
: .bin
• HEX8
: .ihx
• HEX16
: .ehx
【例 1】
(-o オプションを使用しない例 )
f2ms ccp903
絶対形式ロードモジュール ccp903.abs を入力し , S フォーマットの ccp903.mhx を出
力します。上記と同等の指定例を 4 つ示します。
f2ms ccp903.abs -o ccp903.mhx
f2ms ccp903.abs -o ccp903
f2ms ccp903
-o ccp903.mhx
f2ms ccp903
-o ccp903
【例 2】
f2ms ccp903 -o ccp903.hex
出力ファイル名を , ccp903.hex に変更します。
July 31, 2015, CM41-00315-6
279
第 14 章 オブジェクト形式コンバータの共通オプション
14.2 出力ファイル名の変更 (-o)
Su pp or t
So ft
Manu al
【例 3】
f2ms ccp903 -o ..\hex\ccp903m.hex
出 力 先 デ ィ レ ク ト リ を , カ レ ン ト か ら ..\hex に 変 更 し , 出 力 フ ァ イ ル 名 を ,
ccp903m.hex に変更します。
<注意事項>
バイナリコンバータで , -sp オプションを指定した場合は , < オブジェクトファイル名 > の
評価が異なります。< オブジェクトファイル名 > の指定には , 拡張子は含まれないものと
し , < オブジェクトファイル名 > で指定したファイル名に無条件に拡張子を付加します。
例えば , オブジェクトファイル名に "binary.bin" と指定されていれば出力ファイル名は
"binary.bin.b01", "binary.bin.b02",…, "binary.bin.bxx" となります。
280
CM41-00315-6, July 31, 2015
第 14 章 オブジェクト形式コンバータの共通オプション
14.3 パディング (-p)
Support
14.3
Soft
Ma nual
パディング (-p)
任意のアドレス範囲を , 指定した値のデータで埋めます。
ロードモジュールコンバータ (f2ms, f2hs) の整形オプション指定時 , バイナリコン
バータ , アジャスタでは , ファイルにデータの存在しない箇所が指定した値のデータ
で埋まります。
■ パディング (-p)
【記述形式】
-p < 値 >, < 開始アドレス >, < 終了アドレス >
【パラメータ】
<値>
1 バイトのデータ
< 開始アドレス >
< 値 > を設定する開始アドレス。
* f2ms, f2hs の整形指定 (-adjust) 時 , バイナリコンバータ , アジャスタでは指定しま
せん。
< 終了アドレス >
< 値 > を設定する終了アドレス。
* f2ms, f2hs の整形指定 (-adjust) 時 , バイナリコンバータ , アジャスタでは指定しま
せん。
【説明】
指定したアドレス範囲を , 指定した値のデータで埋めます。
ロードモジュールコンバータ (f2ms, f2hs) で整形指定 (-adjust) 時やバイナリコンバー
タおよびアジャスタでは < 値 > の設定のみを行います。
ロードモジュールコンバータ (f2ms, f2hs) で整形指定 (-adjust) 時やバイナリコンバー
タおよびアジャスタでは , ファイルにデータの存在しない箇所が指定した値のデー
タで埋まります。
【例 1】
f2ms ccp903 -p 0xEF,0x1FE4,0x1FFF
絶対形式ロードモジュールから , S フォーマットにコンバートします。
その際 , 0x1FE4 番地から 0x1FFF 番地までを , 0xEF というデータで S フォーマット
ファイルの最後尾に追加作成します。
【例 2】
f2ms ccp903 -p 0xEF,0x1FE4,0x1FFF -adjust
整形指定 (-adjust) 時に , パディングオプション (-p) で開始 / 終了アドレスが指定さ
れているのでエラーになります。
f2ms ccp903 -p 0xEF -adjust
絶対形式ロードモジュールから , S フォーマットにコンバートします。
July 31, 2015, CM41-00315-6
281
第 14 章 オブジェクト形式コンバータの共通オプション
14.3 パディング (-p)
Su pp or t
So ft
Manu al
その際 , データが存在しない箇所を , 0xEF というデータで埋めます。
【例 3】
m2bs ccp903 -ran 0x0,0x1FFF -p 0xEF
S フォーマットから , 0x0 番地から 0x1FFF 番地までの範囲をバイナリイメージにコ
ンバートします。
その際 , S フォーマットにデータが存在しない箇所を , 0xEF というデータで埋めま
す。
282
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 15 章
ロードモジュールコンバー
タ (f2ms, f2hs, f2is, f2es)
この章では , ロードモジュールコンバータについて
説明します。
15.1 ロードモジュールコンバータの概要
15.2 ロードモジュールコンバータのオプション一覧
15.3 ロードモジュールコンバータのオプション詳細
15.4 f2ms( 絶対形式ロードモジュール→ S フォーマット変換 )
15.5 f2hs( 絶対形式ロードモジュール→ HEX フォーマット変換 )
15.6 f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変換 ),
f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変換 )
July 31, 2015, CM41-00315-6
283
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.1 ロードモジュールコンバータの概要
Su pp or t
15.1
So ft
Manu al
ロードモジュールコンバータの概要
ロードモジュールコンバータは , 絶対形式ロードモジュールを汎用フォーマットであ
る S フォーマットや HEX フォーマットに変換します。
■ ロードモジュールコンバータの概要
ロードモジュールコンバータは,絶対形式ロードモジュールを汎用フォーマットである
S フォーマットや HEX フォーマットに変換します。
S フォーマットに変換するには f2ms を用います。また , HEX フォーマットに変換する
には f2hs を用います。
f2is は HEX8 フォーマットに , f2es は HEX16 フォーマットに変換しますが , f2hs を用い
れば HEX8/HEX16/HEX32 のすべての HEX フォーマットに変換可能です。
図 15.1-1 に示すように , f2ms, f2hs では整形指定オプション (-adjust) を指定することで ,
アジャスタと連携動作し出力ファイルの整形を行うことが可能です。
図 15.1-1 ロードモジュールコンバータの概要
絶対形式
ロードモジュール
絶対形式
ロードモジュール
(.abs)
f2ms
(.abs)
f2hs
連携
m2ms
h2hs
整形済み
Sフォーマット
(.mhx)
284
連携
整形済み
HEXフォーマット
(.hex)
CM41-00315-6, July 31, 2015
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.2 ロードモジュールコンバータのオプション一覧
Support
15.2
Soft
Ma nual
ロードモジュールコンバータのオプション一覧
ここでは , ロードモジュールコンバータのオプション名と , 機能概要を一覧で示しま
す。
■ ロードモジュールコンバータのオプション一覧
表 15.2-1 に , ロードモジュールコンバータのオプション一覧を示します。
表 15.2-1 ロードモジュールコンバータのオプション一覧
機能
オプション
備考
出力ファイル名の変更
-o
* コンバータ共通オプション
パディングデータ指定
-p
* コンバータ共通オプション
S1 フォーマット出力指定
-S1
f2ms のみ
S2 フォーマット出力指定
-S2
f2ms のみ
S3 フォーマット出力指定
-S3
f2ms のみ
HEX8 フォーマット出力指定
-I16
f2hs のみ
HEX16 フォーマット出力指定
-I20
f2hs のみ
HEX32 フォーマット出力指定
-I32
f2hs のみ
-entry
f2hs のみ
スタートアドレスレコード出力抑止指定
-Xentry
f2hs のみ
整形指定
-adjust
f2ms, f2hs のみ
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
-cmsg
* 共通オプション
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
スタートアドレスレコード出力指定
オプションファイル読込み指定
終了メッセージ表示指定
終了メッセージ表示抑止指定
July 31, 2015, CM41-00315-6
285
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
15.3
So ft
Manu al
ロードモジュールコンバータのオプション詳細
ここでは , ロードモジュールコンバータの各オプションについて説明します。
なお , リンケージキットで共通のオプションは「第 3 章 共通オプション」で , コン
バータで共通のオプションは「第 14 章 オブジェクト形式コンバータの共通オプ
ション」で , 説明しています。
■ 出力 S フォーマット指定 (-S1/-S2/-S3)
S フォーマットで出力する際に使用するレコードを指定します。詳細は「15.3.1 出力 S
フォーマット指定 (-S1/-S2/-S3)」の説明を参照してください。
■ 出力 HEX フォーマット指定 (-I16/-I20/-I32)
HEX フォーマットで出力する際に使用するレコードを指定します。詳細は「15.3.2 出
力 HEX フォーマット指定 (-I16/-I20/-I32)」の説明を参照してください。
■ スタートアドレス出力指定 (-entry)
HEX フォーマットで出力する際にスタートセグメントアドレスレコードやスタートリ
ニアアドレスレコードを出力します。詳細は「 15.3.3 スタートアドレスレコード出力
指定 (-entry)」の説明を参照してください。
■ スタートアドレス出力抑止指定 (-Xentry)
スタートアドレスレコード出力指定を取り消す際に指定します。詳細は「 15.3.4 スター
トアドレスレコード出力抑止指定 (-Xentry)」の説明を参照してください。
■ 整形指定 (-adjust)
S フォーマットや HEX フォーマットを出力した後にアジャスタの起動を指定します。
詳細は「 15.3.5 整形指定 (-adjust)」の説明を参照してください。
286
CM41-00315-6, July 31, 2015
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Support
15.3.1
Soft
Ma nual
出力 S フォーマット指定 (-S1/-S2/-S3)
データを出力する際に使用するフォーマットを指定します。
■ 出力 S フォーマット指定 (-S1/-S2/-S3)
【記述形式】
-S1
-S2
-S3
【パラメータ】
なし
【説明】
データ内容を出力する際に使用するフォーマットを指定します。
f2ms は , データ内容を S1 レコード , S2 レコード , S3 レコードを用いて出力します。
-S1, -S2, -S3 の指定は後指定が有効になります。また , -S1, -S2, -S3 のオプションが
指定されない場合 , f2ms はデータのアドレスに合わせ , S1/S2/S3 の混在で出力しま
す。
【注意】
本オプションによる指定と , 出力範囲が矛盾する場合 , エラーを出力し処理を行い
ません。
-S1,-S2,-S3 いずれも指定しない場合 , ターミネータレコードは S9 レコードになり ,
実行開始アドレスは 0x0000 になります。
本オプションの指定により , 出力に使用するターミネータレコード (S9 レコード , S8
レコード , S7 レコード ) も変化します ( 表 15.3-1 参照 )。
表 15.3-1 出力 S フォーマット指定一覧
指定
出力可能範囲
ターミネータ
レコード
-S1
0x0000 ~ 0xFFFF
S9 レコード
-S2
0x000000 ~ 0xFFFFFF
S8 レコード
-S3
0x00000000 ~
0xFFFFFFFF
S7 レコード
指定なし
0x0000 ~ 0xFFFFFFFF
S9 レコード
July 31, 2015, CM41-00315-6
備考
実行開始アドレスは 0x0000
287
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
15.3.2
So ft
Manu al
出力 HEX フォーマット指定 (-I16/-I20/-I32)
データを出力する際に使用する HEX フォーマットを指定します。
■ 出力 HEX フォーマット指定 (-I16/-I20/-I32)
【記述形式】
-I16
-I20
-I32
【パラメータ】
なし
【説明】
データ内容を出力する際に使用する HEX フォーマットを指定します。
f2hsは,データ内容をHEX8, HEX16, HEX32のどれか1つの形式を用いて出力します。
-I16, -I20, -I32 の指定は後指定が有効になります。また , -I16, -I20, -I32 のオプション
が指定されない場合 , f2hs はデータのアドレスに合わせ , HEX8/HEX16/HEX32 の混
在で出力します。
【注意】
本オプションによる指定と , 出力範囲が矛盾する場合 , エラーを出力し処理を行い
ません。
表 15.3-2 出力 HEX フォーマット指定一覧
288
指定
出力可能範囲
備考
-I16
0x0000 ~ 0xFFFF
HEX8 フォーマット
-I20
0x00000 ~ 0xFFFFF
HEX16 フォーマット
-I32
0x00000000 ~ 0xFFFFFFFF
HEX32 フォーマット
CM41-00315-6, July 31, 2015
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Support
15.3.3
Soft
Ma nual
スタートアドレスレコード出力指定 (-entry)
データを出力する際にスタートセグメントアドレスレコードまたはスタートリニア
アドレスレコードを出力します。
本オプションは f2hs でのみ指定できます。
■ スタートアドレスレコード出力指定 (-entry)
【記述形式】
-entry
【パラメータ】
なし
【説明】
スタートセグメントアドレスレコードまたは , スタートリニアアドレスレコードの
出力を行います。
入力ファイルにスタートアドレス情報がない場合は , 警告 (W1504U: 入力ファイル
にスタートアドレス情報がありません ) を出力します。
スタートアドレスレコードは , 出力 HEX フォーマット指定オプション (-I16/-I20/I32) の指定と , 入力データ範囲によって以下のように出力されます。
表 15.3-3 HEX フォーマットスタートアドレスレコードの出力
出力 HEX フォーマット指定
-I16
-I20
入力データ範囲
出力するスタートアドレスレコード
-
警告 (W1503U: -I16 指定時に -entry オプ
ションが指定されました ) が出力され , ス
タートアドレスレコードは出力しませ
ん。
0x0 ~ 0xFFFFF
スタートセグメントアドレスレコード
0x0 ~ 0xFFFFF
スタートセグメントアドレスレコード
0x100000~0xFFFFFFFF
スタートリニアアドレスレコード
-I32
出力 HEX フォーマット指定オプションを省略した場合は , HEX32 フォーマット出
力指定オプション (-I32) 指定時と同じ処理になります。
【例】
f2hs ccp903.abs -entry -I16
HEX8 フォーマット出力オプション (-I16) が指定されているため , 警告 (W1503U: I16 指定時に -entry オプションが指定されました ) が出力され , スタートアドレスレ
コードは出力されません。
f2hs ccp903.abs -entry -I20
スタートセグメントアドレスレコードを出力します。
f2hs ccp903.abs -entry -I32
July 31, 2015, CM41-00315-6
289
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
So ft
Manu al
入力ファイルのデータ範囲が 0x0 ~ 0xFFFFF のとき , スタートセグメントアドレス
レコードを出力します。
入力ファイルのデータ範囲が 0x100000 ~ 0xFFFFFFFF のとき , スタートリニアアド
レスレコードを出力します。
290
CM41-00315-6, July 31, 2015
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Support
15.3.4
Soft
Ma nual
スタートアドレスレコード出力抑止指定 (-Xentry)
スタートセグメントアドレスレコードまたはスタートリニアアドレスレコードの出
力を抑止します。
本オプションは f2hs でのみ指定できます。
■ スタートアドレスレコード出力抑止指定 (-Xentry)
【記述形式】
-Xentry
【パラメータ】
なし
【説明】
スタートセグメントアドレスレコードまたは , スタートリニアアドレスレコードの
出力の出力を抑止します。
本オプションは, スタートアドレスレコード出力指定 (-entry)を取り消すときに使用
します。
【例】
f2hs -entry ccp903.abs -I20 -Xentry
スタートアドレスレコード出力指定 (-entry) を取り消し , スタートアドレスレコード
は出力されません。
July 31, 2015, CM41-00315-6
291
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
15.3.5
So ft
Manu al
整形指定 (-adjust)
フォーマット変換後にフォーマットアジャスタを自動的に呼び出し , データ出力形式
を整形します。
■ 整形指定 (-adjust)
【記述形式】
-adjust
【パラメータ】
なし
【説明】
ロードモジュールをフォーマット変換後にフォーマットアジャスタを自動で呼び
出し整形を行います。
整形対象となる開始 / 終了アドレスは , 自動的に設定されます。
本オプションを指定した場合には , パディング (-p) オプションで開始 / 終了アドレ
スのパラメータ指定を行うとエラーになります。
本オプションを指定した場合には , フォーマットアジャスタのオプションも指定可
能となります。
【例】
f2ms ccp903 -p 0xEF,0x1FE4,0x1FFF -adjust
パディングオプションに開始 / 終了アドレスが指定されているためエラーになりま
す。
f2ms ccp903 -p 0xEF -adjust
絶対形式ロードモジュールから , 整形済み S フォーマットにコンバートします。
その際 , データが存在しない箇所を 0xEF というデータで埋めます。
292
CM41-00315-6, July 31, 2015
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.4 f2ms( 絶対形式ロードモジュール→ S フォーマット変換 )
Support
15.4
Soft
Ma nual
f2ms( 絶対形式ロードモジュール→ S フォーマット変換 )
リンカ出力の絶対形式ロードモジュールを S フォーマットに形式変換します。
0 ~ 0xFFFFFFFF 番地のデータが変換対象になります。
f2ms コマンドは , SOFTUNE V5/V6 系の絶対形式ロードモジュールも処理できま
す。
■ f2ms( 絶対形式ロードモジュール→ S フォーマット変換 )
【機能】
f2ms コマンドは , リンカ出力の絶対形式ロードモジュールからオブジェクトデータ
部を読み込み , S フォーマットファイルに形式変換します。
図 15.4-1 f2ms( 絶対形式ロードモジュール→ S フォーマット変換 )
絶対形式
ロードモジュール
f2ms
(.abs)
Sフォーマット
(.mhx)
【アドレス】
S フォーマットで表現できるアドレスの最大値を示します。
S1 タイプ 0xFFFF
S2 タイプ 0xFFFFFF
S3 タイプ 0xFFFFFFFF
リンカ出力の絶対形式ロードモジュールは , 0 ~ 0xFFFFFFFF の範囲のアドレスを
表せます。
S フォーマットも同様のアドレス範囲をサポートしていますので , データの欠落な
くコンバートを行うことができます。
f2ms は , 入力データの割り付けアドレスに応じて , 以下のレコードを出力します。
0x00000000 ~ 0x0000FFFF : S1
0x00010000 ~ 0x00FFFFFF : S2
0x01000000 ~ 0xFFFFFFFF : S3
July 31, 2015, CM41-00315-6
293
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.5 f2hs( 絶対形式ロードモジュール→ HEX フォーマット変
換)
Su pp or t
15.5
So ft
Manu al
f2hs( 絶対形式ロードモジュール→ HEX フォーマット変換 )
リンカ出力の絶対形式ロードモジュールを HEX フォーマットに形式変換します。
0 ~ 0xFFFFFFFF 番地のデータが変換対象になります。
f2hs コマンドは , SOFTUNE V5/V6 系の絶対形式ロードモジュールも処理できます。
■ f2hs( 絶対形式ロードモジュール→ HEX フォーマット変換 )
【機能】
f2hs コマンドは , リンカ出力の絶対形式ロードモジュールからオブジェクトデータ
部を読み込み , HEX フォーマットファイルに形式変換します。
図 15.5-1 f2hs( 絶対形式ロードモジュール→ HEX フォーマット変換 )
絶対形式
ロードモジュール
f2hs
(.abs)
HEXフォーマット
(.hex)
【アドレス】
HEX フォーマットで表現できるアドレスの最大値を示します。
HEX8 タイプ 0xFFFF
HEX16 タイプ 0xFFFFF
HEX32 タイプ 0xFFFFFFFF
リンカ出力の絶対形式ロードモジュールは , 0 ~ 0xFFFFFFFF の範囲のアドレスを
表せます。
HEX フォーマットも同様のアドレス範囲をサポートしていますので , データの欠落
なくコンバートを行うことができます。
f2hs は , 入力データの割り付けアドレスに応じて , 以下の形式で出力します。
0x00000000 ~ 0x0000FFFF : HEX8
0x00010000 ~ 0x000FFFFF : HEX16
0x00100000 ~ 0xFFFFFFFF : HEX32
294
CM41-00315-6, July 31, 2015
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.6 f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変
換 ), f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変
Support
15.6
Soft
Ma nual
f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変換 ),
f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変換 )
f2is はリンカ出力の絶対形式ロードモジュールを HEX8 フォーマットに , f2es はリ
ンカ出力の絶対形式ロードモジュールを HEX16 フォーマットに変換します。
f2is では 0 ~ 0xFFFF 番地のデータが変換対象に , f2es では 0 ~ 0xFFFFF 番地の
データが変換対象になります。
f2is, f2es コマンドは , SOFTUNE V5/V6 系の絶対形式ロードモジュールも処理でき
ます。
f2is, f2es は , 旧版との互換性維持のためリンケージキットに含まれています。
HEX フォーマットへの変換には f2hs を使用されることを推奨いたします。
■ f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変換 )
【機能】
f2is コマンドは , リンカ出力の絶対形式ロードモジュールからオブジェクトデータ
部を読み込み , HEX8 フォーマットファイルに形式変換します。
図 15.6-1 f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変換 )
絶対形式
ロードモジュール
(.abs)
f2is
HEX8フォーマット
(.ihx)
【説明】
f2is では「第 14 章 オブジェクト形式コンバータの共通オプション」で示す共通オ
プションが使用可能です。
【アドレス】
HEX8 フォーマットで表現できるアドレスの最大値は , 0xFFFF です。
<注意事項>
リンカ出力の絶対形式ロードモジュールは , 0 ~ 0xFFFFFFFF のアドレスを表せますが ,
HEX8 フォーマットへコンバートすると 0x10000 以上のアドレスに割り付けられたデー
タは切捨てられます。
コンバート元のアドレス範囲に気をつけて使用してください。
HEX8 フォーマットファイルは , データレコードとトレーラレコードで構成されます。
July 31, 2015, CM41-00315-6
295
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.6 f2is( 絶対形式ロードモジュール→ HEX8 フォーマット変
換 ), f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変
Su pp or t
So ft
Manu al
■ f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変換 )
【機能】
f2es コマンドは , リンカ出力の絶対形式ロードモジュールからオブジェクトデータ
部を読み込み , HEX16 フォーマットファイルに形式変換します。
図 15.6-2 f2es( 絶対形式ロードモジュール→ HEX16 フォーマット変換 )
絶対形式
ロードモジュール
(.abs)
f2es
HEX16フォーマット
(.ehx)
【説明】
f2es では「第 14 章 オブジェクト形式コンバータの共通オプション」で示す共通オ
プションが使用可能です。
【アドレス】
HEX16 フォーマットで表現できるアドレスの最大値は , 0xFFFFF です。
<注意事項>
リンカ出力の絶対形式ロードモジュールは , 0 ~ 0xFFFFFFFF のアドレスを表せますが ,
HEX16フォーマットへコンバートすると0x100000以上のアドレスに割り付けられたデー
タは切捨てられます。
コンバート元のアドレス範囲に気をつけて使用してください。
HEX16 フォーマットでは , 0x10000 以上のアドレスを表現するために拡張セグメントア
ドレスレコードを使用します。
ファイル中の拡張セグメントアドレスレコードは , 以下の拡張セグメントアドレスレコー
ドが現れるまで有効です。拡張セグメントアドレスレコードなしにデータが現れたときに
は , 拡張セグメントアドレス指定が 0 であったとしてアドレス計算を行います。
HEX16 フォーマットのファイルの先頭には , スタートアドレスレコードが作成されます。
296
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 16 章
フォーマットアジャスタ
(m2ms, h2hs)
この章では , フォーマットアジャスタの変換形式を
説明します。
16.1 フォーマットアジャスタの概要
16.2 フォーマットアジャスタのオプション一覧
16.3 フォーマットアジャスタのオプション詳細
July 31, 2015, CM41-00315-6
297
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.1 フォーマットアジャスタの概要
Su pp or t
16.1
So ft
Manu al
フォーマットアジャスタの概要
フォーマットアジャスタは , S フォーマットや HEX フォーマットで作成したデータ
をアドレス昇順に並び替え , 1 レコードに含むデータの数を指定した値に揃える働き
をします。
■ フォーマットアジャスタの概要
フォーマットアジャスタは , フォーマットのファイル 1 レコードに含むデータの数を指
定の値に揃え , 形式を整えます。図 16.1-1 にフォーマットアジャスタの概念図を示し
ます。
図 16.1-1 フォーマットアジャスタの概要
モトローラ
Sフォーマット
ファイル
m2ms
(.ahx)
(.mhx)
HEXフォーマット
ファイル
整形済み
Sフォーマット
h2hs
(.hex)
整形済み
HEXフォーマット
ファイル
(.aix)
入力するフォーマット中にデータが存在しない箇所は , 0xFF( デフォルト値 ) で埋めら
れます。
出力するファイルはメモリ内容をそのまま S フォーマットや HEX フォーマットに変換
したものと同じです。
入力ファイル中にデータが存在しない個所を特定の値で埋めるには , パディングオプ
ション (-p オプション ) を用います。オプションの使用方法については ,「14.3 パディ
ング (-p)」を参照してください。
298
CM41-00315-6, July 31, 2015
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.1 フォーマットアジャスタの概要
Support
Soft
Ma nual
■ 動作例
本ツールは , 以下のように作成したフォーマットファイルの 1 レコードあたりのデータ
長が一定でないような場合に , 1 レコードに含むデータ長を統一できます。
図 16.1-2 フォーマットアジャスタの動作例
変換前
S007000054455354B8
S20CFF00000109572C160C2D2CEC
S209FF0008020406080AD1
S20FFF000D020406080A0C0E1012141660
S20CFF00180109572C160C2D2CD4
S209FF0020020406080AB9
S20FFF0025020406080A0C0E1012141648
S20CFF00300109572C160C2D2CBC
S209FF0038020406080AA1
S20FFF003D020406080A0C0E1012141630
S20CFF00480109572C160C2D2CA4
S209FF0050020406080A89
S20FFF0055020406080A0C0E1012141618
S804000000FB S007000054455354B8
S31500FF00000109572C160C2D2C020406080A020406B9
S31500FF0010080A0C0E101214160109572C160C2D2C5B
S31500FF0020020406080A020406080A0C0E1012141629
S31500FF00300109572C160C2D2C020406080A02040689
S31500FF0040080A0C0E101214160109572C160C2D2C2B
S31500FF0050020406080A020406080A0C0E10121416F9
変換後
■ フォーマットアジャスタの機能
フォーマットアジャスタには以下の機能があります。
• データをアドレス昇順に並び替えます。
• 指定したアドレス範囲内にデータの欠落がある場合 , そこの部分は起動時に指定し
たデータを埋め込みます ( デフォルト値は 0xff)。
• レコードの開始アドレスは , 起動時に指定した出力データ長で整合をとった値を使
用します。
• 出力指定の開始アドレスが , 起動時のデータ長の指定値で整合をとって余りがある
場合 ( レコード内データ長が 16 バイトで開始アドレスが 16 の倍数と異なるような
場合 ), 出力情報の最初に表れるレコードは , 指定開始アドレスからデータ長の指定
値で整合を取ったアドレスまでのデータを格納します。
• 2 番目以降のレコード開始アドレスが , 指定長で整合を取ったアドレスとなります。
• 入力する情報中に , 複数のターミネータレコードが存在する場合 , 最後に表れたター
ミネータレコードのエントリアドレスを変換して出力します。それ以外のターミ
ネータレコードは削除されます。
• 変換元データに設定してあるエントリアドレスの値が , 変換後のデータのアドレス
範囲に含まれない場合 , 変換後のターミネータレコードには 0 を設定します。
July 31, 2015, CM41-00315-6
299
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.1 フォーマットアジャスタの概要
Su pp or t
So ft
Manu al
以下にアドレス範囲 0xff0008 ~ 0xff004a を , レコード長 16 で変換した例を示します。
図 16.1-3 フォーマットアジャスタの動作例
変換前
S007000054455354B8
S20CFF00000109572C160C2D2CEC
S209FF0008020406080A D1
S20FFF000D020406080A0C0E10121416 60
S20CFF00180109572C160C2D2C D4
S209FF0020020406080A B9
S20FFF0025020406080A0C0E10121416 48
S20CFF00300109572C160C2D2C BC
S209FF0038020406080A A1
S20FFF003D020406080A0C0E10121416 30
S20CFF00480109572C160C2D2CA4
S209FF0050020406080A89
S20FFF0055020406080A0C0E1012141618
S804000000FB S007000054455354B8
S30D00FF0008020406080A020406 C1
S31500FF0010080A0C0E101214160109572C160C2D2C 5B
S31500FF0020020406080A020406080A0C0E10121416 29
S31500FF00300109572C160C2D2C020406080A020406 89
S31500FF0040080A0C0E10121416010957 D7
S70500000000FA
変換後
300
CM41-00315-6, July 31, 2015
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.2 フォーマットアジャスタのオプション一覧
Support
16.2
Soft
Ma nual
フォーマットアジャスタのオプション一覧
ここでは , フォーマットアジャスタのオプション名と , 機能概要を一覧で示します。
■ フォーマットアジャスタのオプション一覧
表 16.2-1 に , フォーマットアジャスタのオプション一覧を示します。
表 16.2-1 フォーマットアジャスタのオプション一覧
機能
オプション
備考
出力ファイル名の変更
-o
* コンバータ共通オプション
パディングデータ指定
-p
* コンバータ共通オプション
出力データ長指定
-len
デフォルト 16
出力範囲指定
-ran
必須
S1 フォーマット出力指定
-S1
m2ms のみ
S2 フォーマット出力指定
-S2
m2ms のみ
S3 フォーマット出力指定
-S3
m2ms のみ
HEX8 フォーマット出力指定
-I16
h2hs のみ
HEX16 フォーマット出力指定
-I20
h2hs のみ
HEX32 フォーマット出力指定
-I32
h2hs のみ
開始アドレス変更指定
-ST
-ST
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
-cmsg
* 共通オプション
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
オプションファイル読込み指定
終了メッセージ表示指定
終了メッセージ表示抑止指定
July 31, 2015, CM41-00315-6
301
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Su pp or t
16.3
So ft
Manu al
フォーマットアジャスタのオプション詳細
ここでは , フォーマットアジャスタの各オプションについて説明します。
なお , リンケージキットで共通のオプションは「第 3 章 共通オプション」で , コン
バータで共通のオプションは「第 14 章 オブジェクト形式コンバータの共通オプ
ション」で , 説明しています。
■ 出力レコードデータ長指定 (-len)
出力レコードデータ長の指定です。詳細は「 16.3.1 出力レコード内データ長指定 (-len)」
の説明を参照してください。
■ 出力範囲指定 (-ran)
フォーマットの整形を行う範囲の指定です。詳細は「 16.3.2 出力範囲指定 (-ran)」の
説明を参照してください。
■ 出力 S フォーマット指定 (-S1/-S2/-S3)
m2ms で S フォーマットで出力する際に使用するレコードを指定します。詳細は「16.3.3
出力 S フォーマット指定 (-S1/-S2/-S3)」の説明を参照してください。
■ 出力 HEX フォーマット指定 (-I16/-I20/-I32)
h2hs で HEX フォーマットで出力する際に使用するレコードを指定します。詳細は
「16.3.4 出力 HEX フォーマット指定 (-I16/-I20/-I32)」の説明を参照してください。
■ レコード開始アドレス変更指定 (-ST)
出力する際に使用するレコードの開始アドレスを変更します。詳細は「 16.3.5 開始ア
ドレス変更指定 (-ST)」の説明を参照してください。
302
CM41-00315-6, July 31, 2015
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Support
16.3.1
Soft
Ma nual
出力レコード内データ長指定 (-len)
出力するの 1 レコードに出力するデータの数を指定します。
■ 出力レコード内データ長指定 (-len)
【記述形式】
-len < データ長 >
【パラメータ】
< データ長 >
16/32/64/128 の 4 種類から選択します。
【説明】
整形する際の , 1 レコードに出力するデータのバイト数を指定します。
データ長は , 16/32/64/128 の 4 種類が指定できます。
当オプションの指定を省略した場合 , 16 が指定されたものと仮定して処理します。
【注意】
本指定は 1 レコード内に含むデータのバイト数を指定するものであり , レコード長
自体を指定するものではありません。
【例】
m2ms sfmtfile.mhx -len 32
sfmtfile.mhx を整形し , 1 レコードあたり 32 バイトのデータを出力します。
m2ms sfmtfile.mhx
(-len 指定を省略した例 )
sfmtfile.mhx を整形し , 1 レコードあたり 16 バイトのデータを出力します。
m2ms sfmtfile.mhx -len 96
指定可能範囲外のデータ長が指示されたため , エラーとなります。
m2ms sfmtfile.mhx -len
( パラメータをすべて省略した例 )
データ長の指定が省略されているのでエラーになります。
July 31, 2015, CM41-00315-6
303
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Su pp or t
16.3.2
So ft
Manu al
出力範囲指定 (-ran)
整形する範囲をアドレスで指定します。
■ 出力範囲指定 (-ran)
【記述形式】
-ran < 開始アドレス > [, < 終了アドレス >]
【パラメータ】
< 開始アドレス >
開始アドレス
< 終了アドレス >
終了アドレス
【説明】
整形する範囲をアドレスで指定します。
コンバート実行時は , 当オプションの指定が必ず必要です。
開始アドレス , 終了アドレスは , 0x0 ~ 0xffffffff の範囲で指定します。
終了アドレスの指定は省略できます。終了アドレスを省略した場合 , 開始アドレス
から 64KB 分を整形します。
変換サイズが 2G バイト以上になるような値は指定できません。
【例】
m2ms sfmtfile.mhx
(-ran オプションを使用しない例 )
出力範囲が指定されていないのでエラーになります。
m2ms sfmtfile.mhx -ran 0xD000,0xFFFF
sfmtfile.mhx 中の 0xD000 ~ 0xFFFF 番地までのデータを整形します。
m2ms sfmtfile.mhx -ran 0xD000
( 終了アドレスを省略した例 )
sfmfile.mhx 中の 0xD000 番地から 64K バイト分 (0x0D000 ~ 0x1CFFF) のデータを整
形します。
m2ms sfmtfile.mhx -ran 0xFFFF,0xD000
開始アドレスより低位なアドレスが終了アドレスとして指定されているためエ
ラーになります。
m2ms sfmtfile.mhx -ran
( パラメータをすべて省略した例 )
開始アドレスが省略されているのでエラーになります。
304
CM41-00315-6, July 31, 2015
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Support
16.3.3
Soft
Ma nual
出力 S フォーマット指定 (-S1/-S2/-S3)
データを出力する際に使用する S フォーマットを指定します。
S フォーマットアジャスタ (m2ms) のオプションです。
■ 出力 S フォーマット指定 (-S1/-S2/-S3)
【記述形式】
-S1
-S2
-S3
【パラメータ】
なし
【説明】
データ内容を出力する際に使用するレコードを指定します。
S フォーマットアジャスタは , データ内容を S1 レコード , S2 レコード , S3 レコード
のどれか 1 つを用いて出力します。
S1 レコードと S2 レコードの両方を用いて出力を行うようなことはありません。
-S1, -S2, -S3 の指定は後指定が有効になります。また , -S1, -S2, -S3 のオプションが
指定されない場合 , S フォーマットアジャスタはデータ内容を S3 レコードで出力し
ます。
【注意】
本オプションによる指定と , 出力範囲が矛盾する場合 , S フォーマットアジャスタは
エラーを出力し処理を行いません。
本オプションの指定により , 出力に使用するターミネータレコード (S9 レコード , S8
レコード , S7 レコード ) も変化します ( 表 16.3-1 参照 )。
表 16.3-1 出力レコード指定一覧
July 31, 2015, CM41-00315-6
指定
出力可能範囲
ターミネータレコード
-S1
0x0000 ~ 0xFFFF
S9 レコード
-S2
0x000000 ~ 0xFFFFFF
S8 レコード
-S3
0x00000000 ~ 0xFFFFFFFF
S7 レコード
備考
( デフォルト )
305
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Su pp or t
So ft
Manu al
【例】
m2ms sfmtfile.mhx -ran 0xD000,0x10000 -S1
出力範囲が , S1 レコードで表現できない 0x10000 までのためエラーになります。
m2ms sfmtfile.mhx -ran 0xE000,0xFFFF -S1
0xE000 ~ 0xFFFF の内容が S1 レコードを用いて整形出力されます
m2ms sfmtfile.mhx -ran 0xE000,0xFFFF -S2
0xE000 ~ 0xFFFF の内容が S2 レコードを用いて整形出力されます
m2ms sfmtfile.mhx -ran 0xE000,0xFFFF -S3
0xE000 ~ 0xFFFF の内容が S3 レコードを用いて整形出力されます
306
CM41-00315-6, July 31, 2015
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Support
16.3.4
Soft
Ma nual
出力 HEX フォーマット指定 (-I16/-I20/-I32)
データを出力する際に使用する HEX フォーマットを指定します。
HEX フォーマットアジャスタジャスタ (h2hs) のオプションです。
■ 出力 HEX フォーマット指定 (-I16/-I20/-I32)
【記述形式】
-I16
-I20
-I32
【パラメータ】
なし
【説明】
データ内容を出力する際に使用するレコードを指定します。
HEX フォーマットアジャスタは , データ内容を HEX8 フォーマット , HEX16 フォー
マット , HEX32 フォーマットのどれか 1 つを用いて出力します。
-I16, -I20, -I32 の指定は後指定が有効になります。
また , -I16, -I20, -I32 のオプションが指定されない場合 , HEX フォーマットアジャス
タはデータ内容を HEX32 フォーマットで出力します。
【注意】
本オプションによる指定と , 出力範囲が矛盾する場合 , HEX フォーマットアジャス
タはエラーを出力し処理を行いません。
【例】
h2hs hfmtfile.hex -ran 0xD000,0x10000 -I16
出力範囲が , HEX8 で表現できない 0x10000 までのためエラーになります。
h2hs hfmtfile.hex -ran 0xE000,0xFFFF -I16
0xE000 ~ 0xFFFF の内容が HEX8 フォーマットを用いて整形出力されます。
h2hs hfmtfile.hex -ran 0xE000,0xFFFF -I20
0xE000 ~ 0xFFFF の内容が HEX16 フォーマットを用いて整形出力されます。
h2hs hfmtfile.hex -ran 0xE000,0xFFFF -I32
0xE000 ~ 0xFFFF の内容が HEX32 フォーマットを用いて整形出力されます。
July 31, 2015, CM41-00315-6
307
第 16 章 フォーマットアジャスタ (m2ms, h2hs)
16.3 フォーマットアジャスタのオプション詳細
Su pp or t
16.3.5
So ft
Manu al
開始アドレス変更指定 (-ST)
データ内容を出力する際に使用する開始アドレスを指定します。
データのアドレスを変更する場合に使用します。
■ 開始アドレス変更指定 (-ST)
【記述形式】
-ST < 開始アドレス >
【パラメータ】
< 開始アドレス >
開始アドレス
【説明】
データ内容を出力する際に使用する開始アドレスを指定します。
フォーマットアジャスタは , 通常出力範囲指定 (-ran) で指定された開始アドレスを
用いて開始アドレスの決定を行います。
本オプションが指定されると , 出力する際に開始アドレスの変更を行います。
【例】
m2ms sfmtfile.mhx -ran 0xD000,0xFFFF -ST 0x0000
sfmtfile.mhx 中の 0xD000 ~ 0xFFFF 番地までのデータを整形し , 0x0000 番地からの
データとして出力します。
m2ms sfmtfile.mhx -ran 0xD000,0xFFFF -ST 0x10000
sfmtfile.mhx 中の 0xD000 ~ 0xFFFF 番地までのデータを整形し , 0x10000 番地からの
データとして出力します。
m2ms sfmtfile.mhx -ran 0xD000,0xFFFF -ST
( パラメータを省略した例 )
開始アドレスが省略されているのでエラーになります。
308
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 17 章
バイナリコンバータ
(m2bs, h2bs)
この章では , バイナリコンバータの変換形式を説明
します。
17.1 バイナリコンバータの概要
17.2 バイナリコンバータのオプション一覧
17.3 バイナリコンバータのオプション詳細
July 31, 2015, CM41-00315-6
309
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.1 バイナリコンバータの概要
Su pp or t
17.1
So ft
Manu al
バイナリコンバータの概要
バイナリコンバータは , S フォーマットまたは HEX フォーマットで出力されたファ
イルをバイナリデータファイルへ変換するコンバータです。
単にバイナリデータへ変換するだけでなく複数のファイルへ分割して出力するスプ
リットモードなどをサポートしています。
■ バイナリコンバータの概要
バイナリコンバータは , リンケージキットで作成された S フォーマットや HEX フォー
マットのオブジェクトファイルをバイナリデータ ( メモリイメージ ) へ変換しファイル
へ出力します。
S フォーマットをバイナリデータに変換するには m2bs を用い , HEX フォーマットをバ
イナリデータに変換するには h2bs を用います。
入力ファイル (S フォーマットファイルまたは HEX フォーマット ) は複数個指定する
ことが可能です。また , 変換後のバイナリデータを , 指定バイトごとに複数のファイル
に分割して出力すること ( 以降 , スプリットモードとよびます ) も可能です。
図 17.1-1 バイナリコンバータの概要
Sフォーマット
ファイル
m2bs
(.mhx)
HEXフォーマット
ファイル
(.hex)
バイナリデータ
ファイル
(.bin)
h2bs
バイナリデータ
ファイル
(.bin)
<注意事項>
入力ファイル中にデータが存在しない箇所は , 0xFF( デフォルト値 ) で埋められ , 出力さ
れるバイナリデータファイルはメモリ内容をそのままファイルへ出力したものと同じで
す。
入力ファイル中にデータが存在しない箇所を特定の値で埋めるには , パディングオプショ
ン (-p) を用います。オプションの使用方法については ,「14.3 パディング (-p)」を参照し
てください。
出力バイナリファイルのデフォルト拡張子は , .bin です。なお , スプリットモード使用時
は無条件に拡張子 .bxx(xx は 2 桁の番号 (01 ~ 16)) が付加されます。
310
CM41-00315-6, July 31, 2015
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.1 バイナリコンバータの概要
Support
Soft
Ma nual
■ スプリットモードの概要
スプリットモードとは,バイナリコンバータにより変換されたメモリイメージを指定バ
イトごとに複数のバイナリデータファイルへ出力することを示します。
図 17.1-2 にスプリットモードの概略図を示します。図 17.1-2 では 2 つのファイルに 1
バイトごと交互に出力していますが , スプリットモードでは , 最大 16 個のファイルに
指定バイトごとに交互に出力することが可能です。
スプリットモードを使用するには , -sp オプションを用いて行います。-sp オプションの
使用方法については ,「 17.3.2 スプリットモード指定 (-sp)」を参照してください。
図 17.1-2 スプリットモードの概要図
入力ファイル
バイナリコンバータ
メモリイメージ変換
0x00
0x01
0x08
0x09
0x02
0x03
0x04
バイナリデータ
ファイル1
0x05
0x06
0x07
バイナリデータ
ファイル2
バイナリデータファイル1の内容
0x00
0x02
0x04
0x06
0x08
バイナリデータファイル2の内容
0x01
July 31, 2015, CM41-00315-6
0x03
0x05
0x07
0x09
311
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.2 バイナリコンバータのオプション一覧
Su pp or t
17.2
So ft
Manu al
バイナリコンバータのオプション一覧
ここでは , バイナリコンバータのオプション名と , 機能概要を一覧で示します。
■ バイナリコンバータのオプション一覧
表 17.2-1 に , バイナリコンバータのオプション一覧を示します。
表 17.2-1 バイナリコンバータのオプション一覧
機能
オプション
備考
出力ファイル名の変更
-o
*コンバータ共通オプション
パディングデータ指定
-p
*コンバータ共通オプション
出力範囲指定
-ran
スプリットモード指定
-sp
スプリットモード抑止指定
マップリストファイル作成指定
-Xsp
-m
マップリストファイル作成抑止指定
-Xm
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
-cmsg
* 共通オプション
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
オプションファイル読込み指定
終了メッセージ表示指定
終了メッセージ表示抑止指定
312
必須
CM41-00315-6, July 31, 2015
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
17.3
Soft
Ma nual
バイナリコンバータのオプション詳細
ここでは , バイナリコンバータの各オプションについて説明します。
なお , リンケージキットで共通のオプションは「第 3 章 共通オプション」で , コン
バータで共通のオプションは「第 14 章 オブジェクト形式コンバータの共通オプ
ション」で , 説明しています。
■ 出力範囲指定 (-ran)
SフォーマットやHEXフォーマットからバイナリイメージへ変換する範囲の指定です。
詳細は「 17.3.1 出力範囲指定 (-ran)」の説明を参照してください。
■ スプリットモード指定 (-sp)
バイナリイメージをスプリットモードで出力する場合に指定します。詳細は「 17.3.2
スプリットモード指定 (-sp)」の説明を参照してください。
■ スプリットモード抑止指定 (-Xsp)
スプリットモード指定 (-sp) を無効にするための指定です。詳細は「 17.3.3 スプリット
モード抑止指定 (-Xsp)」の説明を参照してください。
■ マップリストファイルの作成指定 (-m)
コンバート時の情報をマップリストファイルに出力する場合に指定します。詳細は
「 17.3.4 マップリストファイルの作成指定 (-m)」の説明を参照してください。
■ マップリストファイルの作成抑止指定 (-Xm)
マップリストファイルの作成指定 (-m) を無効にするための指定です。詳細は「 17.3.5
マップリストファイルの作成抑止指定 (-Xm)」の説明を参照してください。
July 31, 2015, CM41-00315-6
313
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
17.3.1
So ft
Manu al
出力範囲指定 (-ran)
バイナリイメージへ変換する範囲をアドレスで指定します。
バイナリコンバータは本オプションの指定が必ず必要です。
■ 出力範囲指定 (-ran)
【記述形式】
-ran < 開始アドレス > [, < 終了アドレス >]
【パラメータ】
< 開始アドレス >
開始アドレス
< 終了アドレス >
終了アドレス
【説明】
バイナリイメージへ変換する範囲をアドレスで指定します。
コンバート実行時は , 本オプションの指定が必ず必要です。
開始アドレス , 終了アドレスは , 0x0 ~ 0xFFFFFFFF の範囲で指定します。
終了アドレスの指定は省略できます。終了アドレスを省略した場合 , 開始アドレス
から 64K バイト分がバイナリに変換されます。
変換サイズが 2G バイト以上になるような値は指定できません。
【例 1】
m2bs sfmtfile.mhx
(-ran オプションを使用しない例 )
出力範囲が指定されていないのでエラーになります。
【例 2】
m2bs sfmtfile.mhx -ran 0xD000,0xFFFF
sfmtfile.mhx 中の 0xD000 ~ 0xFFFF 番地までのデータを抜き出してバイナリイメー
ジファイルにします。
【例 3】
m2bs sfmtfile.mhx -ran 0xD000
( 終了アドレスを省略した例 )
sfmfile.mhx 中の 0xD000 番地から 64K バイト分 (0x0D000 ~ 0x1CFFF) のデータを抜
き出してバイナリイメージファイルにします。
【例 4】
m2bs sfmtfile.mhx -ran 0xFFFF,0xD000
開始アドレスより低位なアドレスが終了アドレスとして指定されているためエ
ラーになります。
【例 5】
m2bs sfmtfile.mhx -ran
( パラメータをすべて省略した例 )
開始アドレスが省略されているのでエラーになります。
314
CM41-00315-6, July 31, 2015
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
17.3.2
Soft
Ma nual
スプリットモード指定 (-sp)
バイナリイメージをスプリットモードで出力する場合に指定します。
■ スプリットモード指定 (-sp)
【記述形式】
-sp < 出力ファイル数 > [, < バイト数 >]
【パラメータ】
< 出力ファイル数 >
出力先ファイルを幾つに分割するかを指定します。2 ~ 16 の間で指定が可能です。
< バイト数 >
スプリットの単位をバイト数で指定します。0x01 ~ 0xFFFFFFFF の間で指定が可能
です。
【説明】
本オプションは , 複数のファイルに交互にデータを出力するオプションです。例え
ば , 32 ビット単位のデータをデータ幅が 16 ビットの ROM2 個を用いて構成するの
で , 2 つのファイルに 2 バイトごと交互にデータを出力したい場合などに用います。
< バイト数 > には , 出力ファイルのうち 1 つでも 0 バイト出力になるような値は指
定できません。
< バイト数 > は省略が可能です。省略された場合 , スプリット単位はデフォルトで
1 バイトに設定されます。
本オプションを使用すれば , 64K バイトの範囲を 32K バイトづつの 2 つのバイナリ
イメージファイルにすることも可能です。ただし , 本オプションは , あくまで複数
のファイルに , データを交互に出力するためのものです。65K バイトの範囲を 32K
バイトづつの 2 つに分割するようにパラメータ指定を行うと , 最後の 1K バイトは
前半のファイルに出力されます。
本オプションを指定すると出力ファイルに拡張子として".bxx"(xxは2桁の番号01~
16) が無条件に付加されます。
【例 1】
m2bs sfmtfile.mhx
(-sp オプションを使用しない例 )
sfmtfile.bin にバイナリイメージが出力されます。
【例 2】
m2bs sfmtfile.mhx -sp 2
sfmtfile.b00 と sfmtfile.b01 に 1 バイトごと交互にバイナリイメージが出力されます。
【例 3】
m2bs sfmtfile.mhx -sp 2,2
sfmtfile.b00 と sfmtfile.b01 に 2 バイトごと交互にバイナリイメージが出力されます。
July 31, 2015, CM41-00315-6
315
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
17.3.3
So ft
Manu al
スプリットモード抑止指定 (-Xsp)
-Xsp オプションは , スプリットモード指定 (-sp) を無効にします。
■ スプリットモード抑止指定 (-Xsp)
【記述形式】
-Xsp
【パラメータ】
なし
【説明】
本オプションは , -sp 指定を無効にする場合に指定します。
本オプションはデフォルトですので特に指定する必要はありません。
【例】
m2bs ccp903.mhx -ran 0xE000,0xFFFF
m2bs cpp903.mhx -Xsp -ran 0xE000,0xFFFF
デフォルト処理では , スプリットモードでは動作しません。
上記指定はどちらも同じです。
m2bs -f option.file ccp903 -Xsp
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。
option.file 内に -sp オプションがある場合 , option.file の内容を変更せずコマンドライ
ン上で -Xsp オプション指定を行えば -sp オプションを取り消すことができます。
316
CM41-00315-6, July 31, 2015
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
17.3.4
Soft
Ma nual
マップリストファイルの作成指定 (-m)
コンバート時の情報をマップリストファイルに出力します。
■ マップリストファイルの作成指定 (-m)
【記述形式】
-m < マップリストファイル名 >
【パラメータ】
< マップリストファイル名 >
出力マップリストファイル名
【説明】
コンバート時の情報をマップリストファイルに出力します。
マップリストファイルには , コンバート時の情報が出力されます。出力される情報
には以下があります。項目 4. は -sp オプションが指定された場合にのみ出力されま
す。
1. 入力ファイル名情報
2. 出力ファイル名情報
3. 出力範囲情報
4. スプリット単位情報
5. パディングデータ値情報
< マップリストファイル > の拡張子を省略した場合 , デフォルト拡張子 ".mp3" が付
加されます。
【例 1】
m2bs sfmtfile.mhx -ran 0x10000,0x1FFFF
(-m オプションの指定がない例 )
-m オプションの指定がないのでマップリストファイルの作成は行われません。
【例 2】
m2bs sfmtfile.mhx -ran 0x10000,0x1FFFF -m logfile
logfile.mp3 にコンバート時の情報が出力されます。
図 17.3-1 logfile.mp3 の内容例 1
Input file
Output file
Convert range
Padding data
:sfmtfile.mhx
:sfmtfile.bin
:0x00010000 - 0x0001FFFF
:0xFF
【例 3】
m2bs sfmtfile.mhx -ran 0x10000,0x1FFFF -m logfile -sp 2,2
logfile.mp3 にコンバート時の情報が出力されます。
July 31, 2015, CM41-00315-6
317
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
So ft
Manu al
図 17.3-2 logfile.mp3 の内容例 2
Input file
Output file
Convert range
Split byte
Padding data
318
:sfmtfile.mhx
:sfmtfile.b01
:sfmtfile.b02
:0x00010000 - 0x0001FFFF
:2
:0xFF
CM41-00315-6, July 31, 2015
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
17.3.5
Soft
Ma nual
マップリストファイルの作成抑止指定 (-Xm)
-Xm オプションは , マップリストファイルの作成を抑止します。
■ マップリストファイルの作成抑止指定 (-Xm)
【記述形式】
-Xm
【パラメータ】
なし
【説明】
本オプションは , -m 指定を無効にする場合に指定します。
本オプションはデフォルトですので特に指定する必要はありません。
【例 1】
m2bs ccp903.mhx -ran 0xE000,0xFFFF
m2bs ccp903.mhx -Xm -ran 0xE000,0xFFFF
デフォルト処理では , マップリストファイルを出力しません。
上記指定はどちらも同じです。
【例 2】
m2bs -f option.file ccp903 -Xm
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。
option.file 内に -m オプションがある場合 , option.file の内容を変更せずコマンドライ
ン上で -Xm オプション指定を行えば -m オプションを取り消すことができます。
July 31, 2015, CM41-00315-6
319
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
320
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 18 章
その他のコンバータ
この章では , その他のコンバータの各コマンドを詳
しく説明します。
18.1 m2is(S フォーマット→ HEX8 フォーマット変換 )
18.2 m2es(S フォーマット→ HEX16 フォーマット変換 )
18.3 i2ms(HEX8 フォーマット→ S フォーマット変換 )
18.4 e2ms(HEX16 フォーマット→ S フォーマット変換 )
July 31, 2015, CM41-00315-6
321
第 18 章 その他のコンバータ
18.1 m2is(S フォーマット→ HEX8 フォーマット変換 )
Su pp or t
18.1
So ft
Manu al
m2is(S フォーマット→ HEX8 フォーマット変換 )
S フォーマットを HEX8 フォーマットに形式変換します。
0 ~ 0xFFFF 番地のデータが変換対象になります。
■ m2is(S フォーマット→ HEX8 フォーマット変換 )
【機能】
m2is コマンドは , S フォーマットファイルから HEX8 フォーマットへの変換を行い
ます。
図 18.1-1 m2is(S フォーマット→ HEX8 フォーマット変換 )
Sフォーマット
ファイル
(.mhx)
m2is
HEX8フォーマット
ファイル
(.ihx)
<注意事項>
S フォーマットは , 0 ~ 0xFFFFFFFF のアドレスを表せますが , HEX8 フォーマットへコ
ンバートすると 0x10000 以上のアドレスに割り付けられたデータは切捨てられます。
コンバート元のアドレス範囲に気をつけて使用してください。
HEX8 フォーマットのファイルは , データレコードとトレーラレコードで構成されますの
で , S フォーマットのスタートアドレス情報は失われます。
322
CM41-00315-6, July 31, 2015
第 18 章 その他のコンバータ
18.2 m2es(S フォーマット→ HEX16 フォーマット変換 )
Support
18.2
Soft
Ma nual
m2es(S フォーマット→ HEX16 フォーマット変換 )
S フォーマットを HEX16 フォーマットに形式変換します。
0 ~ 0xFFFFF 番地のデータが変換対象になります。
■ m2es(S フォーマット→ HEX16 フォーマット変換 )
【機能】
m2es コマンドは , S フォーマットファイルから HEX16 フォーマットへの変換を行
います。
図 18.2-1 m2es(S フォーマット→ HEX16 フォーマット変換 )
Sフォーマット
ファイル
(.mhx)
m2es
HEX16フォーマット
ファイル
(.ehx)
<注意事項>
S フォーマットは , 0 ~ 0xFFFFFFFF のアドレスを表せますが , HEX16 フォーマットへ
コンバートすると 0x100000 以上のアドレスに割り付けられたデータは切捨てられます。
コンバート元のアドレス範囲に気をつけて使用してください。
July 31, 2015, CM41-00315-6
323
第 18 章 その他のコンバータ
18.3 i2ms(HEX8 フォーマット→ S フォーマット変換 )
Su pp or t
18.3
So ft
Manu al
i2ms(HEX8 フォーマット→ S フォーマット変換 )
HEX8 フォーマットを S フォーマットに形式変換します。
0 ~ 0xFFFF 番地のデータが変換対象になります。
■ i2ms(HEX8 フォーマット→ S フォーマット変換 )
【機能】
i2ms コマンドは , HEX8 フォーマットから S フォーマットファイルへの変換を行い
ます。
図 18.3-1 i2ms(HEX8 フォーマット→ S フォーマット変換 )
HEX8フォーマット
ファイル
(.ihx)
i2ms
Sフォーマット
ファイル
(.mhx)
<注意事項>
S フォーマットは , 0 ~ 0xFFFFFFFF のアドレスを表せますが , HEX8 フォーマットは
0x10000 以上のアドレスを表現できません。コンバート後の S フォーマットファイルは ,
S2, S3, S7, S8 タイプなしで作成されます。
HEX8 フォーマットはスタートアドレスの情報がありません。変換後スタートアドレスは
0 とします。
324
CM41-00315-6, July 31, 2015
第 18 章 その他のコンバータ
18.4 e2ms(HEX16 フォーマット→ S フォーマット変換 )
Support
18.4
Soft
Ma nual
e2ms(HEX16 フォーマット→ S フォーマット変換 )
HEX16 フォーマットを S フォーマットに形式変換します。
0 ~ 0xFFFFF 番地のデータが変換対象になります。
■ e2ms(HEX16 フォーマット→ S フォーマット変換 )
【機能】
e2ms コマンドは , HEX16 フォーマットから S フォーマットファイルへの変換を行
います。
図 18.4-1 e2ms(HEX16 フォーマット→ S フォーマット変換 )
HEX16フォーマット
ファイル
(.ehx)
e2ms
Sフォーマット
ファイル
(.mhx)
<注意事項>
S フォーマットは , 0 ~ 0xFFFFFFFF のアドレスを表せますが , HEX16 フォーマットは
0x100000 以上のアドレスを表現できません。コンバート後の S フォーマットファイルは ,
S7, S3 タイプなしで作成されます。
HEX16 フォーマットのスタートアドレス情報は , S9 または S8 タイプに設定されます。
July 31, 2015, CM41-00315-6
325
第 18 章 その他のコンバータ
18.4 e2ms(HEX16 フォーマット→ S フォーマット変換 )
Su pp or t
326
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
第 19 章
オブジェクト形式コンバー
タの制限事項および Q &A
この章では , オブジェクト形式コンバータの制限事
項や使用上の Q &A について述べます。
19.1 オブジェクト形式コンバータの制限事項
19.2 オブジェクト形式コンバータの使用上の Q &A
July 31, 2015, CM41-00315-6
327
第 19 章 オブジェクト形式コンバータの制限事項および Q &A
19.1 オブジェクト形式コンバータの制限事項
Su pp or t
19.1
So ft
Manu al
オブジェクト形式コンバータの制限事項
バイナリコンバータおよびアジャスタには , いくつかの制限があります。その他のオ
ブジェクト形式コンバータは使用する上で , 処理上の制限事項は設けておりません。
オブジェクト形式コンバータが実行に使用できるメモリを使いきってしまうまで処
理可能です。
■ オブジェクト形式コンバータの制限事項
オブジェクト形式コンバータは , 表 19.1-1 に示す制限があります。
ただし , 最大限界値まで処理が可能なわけではありません。
オブジェクト形式コンバータは動的にメモリ獲得を行いながら処理を行います。
処理に必要なメモリ獲得ができなくなった場合には,メモリ不足のエラーメッセージを
通知し , 処理を中断します。
表 19.1-1 オブジェクトオブジェクト形式コンバータの制限一覧
項目
制限値
備考
オプションファイル数
無制限
メモリ依存
オプションファイル内の行数
無制限
メモリ依存
オプションファイル内の 1 行の文字数
無制限
メモリ依存
オプションファイルのネスト
不可
入力ファイル数 (m2bs, m2ms, h2bs, h2hs)
64 個
入力ファイル数 ( 上記以外のコンバータ )
1個
入出力ファイルサイズ
無制限
OS 依存
入出力ファイル行数
無制限
OS 依存
ファイル名文字数
無制限
OS 依存
最大メモリアドレス
0xffffffff
最大変換サイズ (m2bs, m2ms, h2bs, h2hs)
2GB-1
メモリ依存
■ バイナリコンバータ , アジャスタの制限事項
入力ファイルは合計で 64 個まで指定できます。
入力ファイルが複数指定された場合 , 指定された順に処理します。
入力ファイル中で , 同じアドレスに対するデータが存在する場合は , 後から出てきた
データで上書きされます。
1 度に変換できるサイズは , 最大 2G-1 バイトまでです。
328
CM41-00315-6, July 31, 2015
第 19 章 オブジェクト形式コンバータの制限事項および Q &A
19.2 オブジェクト形式コンバータの使用上の Q &A
Support
19.2
Soft
Ma nual
オブジェクト形式コンバータの使用上の Q &A
オブジェクト形式コンバータの使用に関する Question と Answer を示します。
■ オブジェクト形式コンバータの使用上の Q &A
Q.
多数のコンバータがありますが , どれを使用すれば良いのですか ?
A.
コンバータの使用目的は , リンカ出力の絶対形式ロードモジュールファイルを ROM ライタで
読み込み可能なオブジェクト形式に変換することです。
32bit のアドレス空間に完全に対応しているのは f2ms と f2hs ですので , S フォーマットへ変換
の際は f2ms を , HEX フォーマットへ変換の際は f2hs の使用を推奨します。
その他のコンバートツールは , 必要に応じて御使用ください。
例.
f2ms absfile.abs - > S フォーマット absfile.mhx 出力
Q.
バイナリコンバータやフォーマットアジャスタ使用時に , "F9001U: メモリが足りません " と
エラー出力され , 変換できません。どうすれば良いのですか ?
A.
バイナリコンバータやフォーマットアジャスタは,動作時に変換する領域と同じサイズのメモ
リを確保します。このため , 1 度に広大な範囲をメモリイメージに変換しようとすると
"F9001U: メモリが足りません " とエラー出力され処理が中断される可能性があります。
この様な場合には , 変換したい領域を連続する複数の領域に分割し , それぞれのメモリイメー
ジを作成後 , ファイルを連結して 1 つのバイナリイメージにしてください。
0xC00000 ~ 0xFFFFFF までのバイナリイメージ領域を変換する場合
・十分に使用メモリが確保できる場合 ( 通常 )
① m2bs absfile.mhx -ran 0xC00000,0xFFFFFF
例.
・"F9001U: メモリが足りません " とエラー出力された場合
① m2bs absfile.mhx -ran 0xC00000,0xDFFFFF -o absfile1.bin
② m2bs absfile.mhx -ran 0xE00000,0xFFFFFF -o absfile2.bin
③ copy /b absfile1.bin + absfile2.bin absfile.bin
July 31, 2015, CM41-00315-6
329
第 19 章 オブジェクト形式コンバータの制限事項および Q &A
19.2 オブジェクト形式コンバータの使用上の Q &A
Su pp or t
330
So ft
Manu al
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
付録
付録では , リンケージキットのエラーメッセージ ,
HEX フォーマットおよび S フォーマットのレコー
ド形式などを記載しています。
付録 A リンケージキットのエラーメッセージ
付録 B HEX フォーマット
付録 C S フォーマット
付録 D リンカのオプション一覧表
付録 E ライブラリアンのオプション一覧表
付録 F オブジェクト形式コンバータのコマンドおよびオプ
ション一覧表
付録 G OS による仕様の相違点
付録 H F2MC-16LX スタンバイモード遷移命令チェックツー
ル
付録 I SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a)
の仕様の差異について
付録 J SOFTUNE ライブラリアン (flib907s) と旧版ライブラ
リアン (lib907a) の仕様の差異について
付録 K SOFTUNE ロードモジュールコンバータ (f2ms, f2hs)
と旧版ロードモジュールコンバータ (lmc907a) の仕様
の差異について
付録 L SOFTUNE 言語ツール移行時のオブジェクト同一性確
認方法
付録 M 関数呼び出しインタフェース変更ガイド
付録 N 主な変更内容
July 31, 2015, CM41-00315-6
331
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
付録 A
So ft
Manu al
リンケージキットのエラーメッセージ
リンケージキットの各ツールが出力するエラーメッセージの分類と表示形式につい
て詳しく説明します。
■ リンケージキットのエラーメッセージ分類
エラーメッセージは , 重要度に応じて以下の 4 つのレベルに分類されています。
● インフォメーション
処理を確認する目的で , ユーザにその内容を通知するものです。エラーではありません
ので , 正しい処理結果が得られています。
● 警告
エラーよりは軽微であり , 出力結果はほとんど問題なく使用できます。場合により ,
ユーザの意図と異なる処理が行われている可能性もあります。メッセージ内容を確認
した上で , 出力結果が使用可能か否かを判断してください。
● エラー
処理は実行しますが , 正しい結果は得られないレベルの問題が発生しています。エラー
の原因を取り除いて , 再実行する必要があります。
● 致命的エラー
処理の実行が不可能なエラーです。ユーザの誤指定が原因のほか , 実行環境の問題で発
生します。
332
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
■ リンケージキットのエラーメッセージの表示形式
エラーメッセージは , 各ツールとも以下の形式で出力します。
図 A-1 リンケージキットのエラーメッセージの表示形式
*** ファイル名(行番号) XnnnnT: メッセージ文(補助メッセージ)
各 部
説 明
ファイル名(行番号)
エラーの発生したソースファイル名と, ソース行番号
この情報は, リンカの一部のメッセージでのみ出力されます。
X
エラーのレベルを以下の4つの英字1文字で表します。
I … インフォメーション
E … エラー
W … 警告メッセージ
F … 致命的なエラー
nnnn
エラー番号
エラー番号と, エラーレベルは以下の対応関係があります。
0000~0999 … I
1000~1999 … W
4000~4999 … E
9000~9999 … F
T
ツール識別を以下の英字1文字で表します。
L … リンカ
U … ライブラリアン, オブジェクト形式コンバータ
メッセージ文
エラーメッセージ本文(日本語/英語の選択が可能)
補助メッセージ
エラーについてのより詳細な情報
エラー発生原因となったシンボル名などを表示します。
エラーメッセージ本文中に出力されることもあります。
【例】
*** sample.c(234) E4329L: Value out of range (0xFFFE37D4)
ソースファイル名と行番号の表示も行われている例です。
*** E4402U: Duplicated module name (date.obj setdate)
ソースファイル名と行番号の表示が行われない例です。
*** F9001U: Insufficient memory
ソースファイル名と行番号および補助メッセージの表示は行われない例です。
July 31, 2015, CM41-00315-6
333
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
■ リンカのエラーメッセージ
このライブラリは使用されませんでした ( ファイル名 )
I0301L
Unused library ( ファイル名 )
リンク処理で使用されなかったライブラリがあります。
-w オプションで 2 を指定したときに通知されるメッセージです。
デバッグ情報が存在しません ( ファイル名 )
I0302L
Debug information not exist( ファイル名 )
入力ファイルにデバッグ情報が含まれていません。
-w オプションで 2 を指定したときに通知されるメッセージです。
W1351 より軽微です。単にデバッグ情報が存在しないことを通知するだけです。
デバッグ情報を取り除きました
I0303L
Removed debug information
デバッグ情報を取り去って出力ファイルを作成しました。
-w オプションで 2 を指定したときに通知されるメッセージです。
このファイルは警告レベルエラーを含んでいます ( ファイル名 )
I0304L
File include WARNING level error ( ファイル名 )
ここで示されたファイルは , 以前のリンク時に警告メッセージがあったものです。
-w オプションで 2 を指定したときに通知されるメッセージです。
境界調整を無視しました
I0305L
Ignore address alignment
-pkオプションの指定により,リンク時にバウンダリ調整を無視して配置を行いました。
-w オプションで 2 を指定したときに通知されるメッセージです。
領域 " 領域名 " で , セクション最適化配置を行います
I0306L
Section allocated automatically in " 領域名 " area
ここで示された領域でセクション最適化配置を行いました。
-w オプションで 2 を指定したときに通知されるメッセージです。
334
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
下位互換 CPU タイプのオブジェクトです ( ファイル名 )
I0307L
Lower compatible cpu type object ( ファイル名 )
ここで示されたファイルは , 下位互換性のある異なる CPU タイプのモジュールです。
-w オプションで 2 を指定したときに通知されるメッセージです。
I0312L
S.C.F チェックで < 警告メッセージ数 > 個のワーニングが出力され
ました
Total warning message of S.C.F check : < 警告メッセージ数 >
本メッセージは , F2MC-16LX スタンバイモード遷移命令チェックツールが出力した警
告メッセージ (W1378L, W1379L) の個数を示します。
本メッセージは , W1378L, W1379L が出力された場合 , 必ず出力されます。
互換性のある CPU タイプのオブジェクトです ( ファイル名 )
I0313L
Compatible CPU type object ( ファイル名 )
ここで示されたファイルは , 互換性のある異なる CPU タイプのモジュールです。
-w オプションで 2 を指定したときに通知されるメッセージです。
ROM領域に書込み可能セクションが配置されました(セクション名)
W1301L
Writable section located in ROM area ( セクション名 )
ROM 領域として設定したアドレス範囲に書込み可能セクションを配置しました。
セクション配置指定を見直してください。
W1303L
RAM エリアに初期値のあるセクションが配置されました ( セクショ
ン名 )
Section with initial data located in RAM area( セクション名 )
RAM 領域として設定したアドレス範囲に初期値を含むセクションを配置しました。
セクション配置指定を見直してください。
W1305L
ROM/RAM 領域 ( 領域名 ) の範囲外への配置がありました ( セクショ
ン名 )
Section( セクション名 )located on out of ROM/RAM area( 領域名 )
-ro, または -ra オプションで指定したアドレス範囲を越えて配置されたセクションがあ
ります。セクションマップで確認してください。
リンカのマップリストでは十分な情報が得られない場合は,セクション詳細マップリス
トでより詳細な情報を知ることができます。
July 31, 2015, CM41-00315-6
335
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
最大アドレスを越えました ( セクション名 )
W1306L
Exceeded maximum address( セクション名 )
最大アドレス (0xFFFFFFFF) を超えて配置されたセクションがあります。
セクション名が重複しています ( セクション名 )
W1307L
Duplicate section name exist ( セクション名 )
複数のモジュールに , 名前が同じで属性や型の異なるセクションが存在します。
セクション配置が重複しています ( セクション 1, セクション 2)
W1308L
Overlap located section ( セクション 1, セクション 2)
セクションが重複して配置されました。場合によってはプログラムの作動に支障を来
たしますので , 注意が必要です。
オプションで回避することを推奨します。
W1314L
絶対セクションに対して配置アドレスが指定されました ( セクショ
ン名 )
Specified address to absolute section( セクション名 )
ここで示されるセクションは , 絶対番地があらかじめ決められていますので , セクショ
ンの再配置指定は無効です。
モード識別 モード時にはライブラリ検索を行いません
W1320L
Not search library at モード識別 mode
ライブラリ検索処理は , 絶対形式ロードモジュールを作成するとき以外行いません。
-r オプション指定時にはライブラリの検索指定は無効です。
補助メッセージのモード識別には , 以下が表示されます。
• 相対形式ロードモジュール出力指定 (-r) 時 : REL
W1321L
モード識別 モード時にはこの ( オプション ) オプションは無視さ
れます
Ignore ( オプション ) Option at モード識別 mode
指定されたリンクモードでは無効となる指定がなされたときに通知されます。
たとえば , 相対形式ロードモジュール出力指定時には , セクション配置処理は行いませ
んので -sc オプションを指定しても無効になります。
336
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
エントリポイントが複数設定されています
W1325L
Entry point already set
複数の入力モジュールにエントリポイントが設定されています。
最初に設定されたエントリポイントが有効になります。
エントリポイントが変更されました
W1326L
Entry point was changed
-e オプションの指定により , 既に設定されているエントリポイントが変更されました。
このシンボルは既に定義されています ( シンボル名 )
W1327L
Duplicate symbol definition ( シンボル名 )
複数の入力モジュールに同じ外部定義シンボルが存在します。
最初に定義されたシンボル値が有効になります。
外部シンボルの型が異なっています ( シンボル名 )
W1328L
Mismatch symbol type ( シンボル名 )
-e オプションによるエントリポイントの設定時に指定された外部定義シンボルが , 関
数名 , 変数名 , アドレスラベル名のいずれでもない場合に通知されます。
E4326 より軽微な場合に検出されます。
ROM 化セクション名が長すぎます ( セクション名 )
W1330L
Too long ROM section name : exceeded 250 character( セクション名 )
ROM → RAM 転送を行うセクション名は , 250 文字以下にしてください。
該当するファイルが見つかりませんでした ( ファイル名 )
W1332L
No match( ファイル名 )argument
ワイルドカードによるファイル指定が行われましたが,該当するファイルがありません
でした。
この指定を無視します。
July 31, 2015, CM41-00315-6
337
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
デバッグ情報が不足しています
W1351L
Debug information not exist
デバッグ情報が不足しているために , リストの一部が作成できません。
コンパイル , アセンブルおよびリンク時にデバッグ情報付加オプション -g を指定して
ください。
モジュール名 の重複がありました ( ファイル名モジュール名 )
W1367L
Duplicated module name( ファイル名モジュール名 )
既にリンク対象となっているモジュール名と同じ名前のモジュール名が存在します。
モジュール名の重複は,絶対アセンブルリスト作成時やデバッグ時に正しくモジュール
名を特定できないなどの問題発生原因になります。
モジュール名の重複が起こらないように変更をお勧めします。
C/C++ コンパイラは , ファイル名から自動的にモジュール名の生成を行います。
ファイル名を変更してください。
-ro オプションで内蔵 ROM 領域の範囲外が指定されています
( 領域名 )
W1368L
The area specified for the ‐ ro option is outside the internal-ROM area
( 領域名 )
-ro オプションで指定した領域が , 内蔵 ROM 領域の範囲外です。
指定範囲が正しいか確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
-ra オプションで内蔵 RAM 領域の範囲外が指定されています ( 領域
名)
W1369L
The area specified for the ‐ ra option is outside the internal-RAM area
( 領域名 )
-ra オプションで指定した領域が , 内蔵 RAM 領域の範囲外です。
指定範囲が正しいか確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
338
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
ROM 領域外への配置です ( セクション名 )
W1370L
The section is placed outside the ROM area( セクション名 )
本来 ROM 領域内に配置されるべきセクションが ROM 領域の範囲外に配置されていま
す。
配置が正しいかマップファイルで確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
RAM 領域外への配置です ( セクション名 )
W1371L
The section is placed outside the RAM area( セクション名 )
本来RAM領域内に配置されるべきセクションがRAM領域の範囲外に配置されています。
配置が正しいかマップファイルで確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
RAM 領域または IO 領域外への配置です ( セクション名 )
W1372L
The section is placed outside the RAM area or the I/O area( セクション名 )
本来 RAM 領域か IO 領域内に配置されるべきセクションが RAM 領域と IO 領域の範囲
外に配置されています。
配置が正しいかマップファイルで確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
IO 領域外への配置です ( セクション名 )
W1373L
The section is placed outside the I/O area( セクション名 )
本来 IO 領域内に配置されるべきセクションが IO 領域の範囲外に配置されています。
配置が正しいかマップファイルで確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
W1375L
-sc オプションで配置指定の行われていないセクションです ( セク
ション名 )
This is the section (section name) for which layout is not specified in the
-sc option.
ユーザにより配置指定が行われていないセクションです。
セクション配置指定 (-sc) オプションを用いて該当セクションの配置指定を行ってくだ
さい。
July 31, 2015, CM41-00315-6
339
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
DIR 属性セクションの合計サイズが 256 バイトを超えました
W1377L
Total size of the DIR attribute sections exceeded 256 bytes
本メッセージは , -check_dirsize オプション指定時に DIR 属性セクション合計サイズが
256 バイトを超えたときに出力されます。
本メッセージが出力された場合 , DIR 属性セクションの合計サイズが 256 バイト以下に
なるようソースを修正してください。
<注意事項>
以下のような場合 , DIR 属性セクションの合計サイズが 256 バイトを超えても問題ありま
せん。本メッセージは無視してください。
• アセンブラソースにおいて複数のダイレクトページを使用している場合
• リアルタイム OS のタスクごとに異なったダイレクトページを使用する場合
DIR 属性セクション合計サイズが 256 バイトを超えても問題ない場合 , 本メッセージは
-Xcheck_dirsize オプションを指定することにより抑止できます。
適切でないスタンバイモード遷移命令列をフェッチ検索で検出しま
した ( 命令パターン , アドレス , ソース名 : 行番号 )
W1378L
The standby mode transition instructions which is not suitable was found
by fetch unit check ( 命令パターン , アドレス , ソース名 : 行番号 )
本エラーメッセージは ,「H.8 スタンバイモード遷移のための低消費電力モード制御レ
ジスタ (LPMCR) へアクセスする際の注意事項」の対応が行われていないスタンバイ
モード遷移命令列を検出した場合に出力します。
本メッセージは , フェッチ単位でのチェックで検出された場合に出力されます。
本メッセージの詳細は ,「H.4 警告メッセージ」を参照してください。
適切でないスタンバイモード遷移命令列をバイト検索で検出しまし
た ( 命令パターン , アドレス , ソース名 : 行番号 )
W1379L
The standby mode transition instructions which is not suitable was found
by byte check ( 命令パターン , アドレス , ソース名 : 行番号 )
本エラーメッセージは ,「H.8 スタンバイモード遷移のための低消費電力モード制御レ
ジスタ (LPMCR) へアクセスする際の注意事項」の対応が行われていないスタンバイ
モード遷移命令列を検出した場合に出力します。
本メッセージは , バイト単位でのチェックで検出された場合に出力されます。
本メッセージの詳細は ,「H.4 警告メッセージ」を参照してください。
340
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
セクションまたはセクショングループ名が見つかりません ( セク
E4302L
ション名 or グループ名 )
Not found section or section group name ( セクション名 or グループ名 )
-sc オプションで指定したセクション名またはグループ名が見つかりません。
ROM/RAM 領域名が定義されていません ( 領域名 )
E4303L
Undefined ROM/RAM area name ( 領域名 )
-sc オプションで指定した ROM/RAM 領域名が定義されていません。
シンボル名が見つかりません ( マングル名 / シンボル名 )
E4304L
Symbol name is not found( マングル名 / シンボル名 )
-df オプションで指定した外部参照シンボルが見つからないときまたは -e オプションで
指定した外部定義シンボルが見つからないときに通知されます。
外部シンボルが定義されていません ( マングル名 / シンボル名 )
E4305L
Unresolved external symbol ( マングル名 / シンボル名 )
本エラーは , 以下の場合に発生します。
(1) 外部シンボルの定義がない
(2) -df オプションで指定した外部定義シンボル名が見つからない
(3) 未使用関数削除機能により , 関数が削除された
(1) と (2) が原因の場合 , 外部定義シンボルを含むモジュールをリンクしてください。
(3) が原因の場合 , 削除された関数を -Xdel オプションで指定してください。
互換性のない CPU タイプのモジュールがあります ( ファイル名 )
E4312L
Uncompatible cpu type module( ファイル名 )
ここで示されるファイルは互換性のないモジュールです。
入力されるモジュールは , ターゲット CPU が同じか互換 CPU でなくてはいけません。
E4313L
関数呼び出しインタフェースの異なるモジュールがあります
( ファイル名 )
The module is different calling interface of a function ( ファイル名 )
本エラーメッセージは , 以下の付表 A-1 に示す条件で出力されます。
July 31, 2015, CM41-00315-6
341
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
付表 A-1 入力オブジェクトと -rp オプションの関係
入力オブジェクトの関数呼び出しインタフェース
「引数のレジスタ渡し」
あり
-rp オプション指定
「引数のスタック渡し」
「引数のレジスタ渡し」の正常な
組み合わせです。
エラーは出力しません。
エラー (E4313L) を出力します。
なし
エラー (E4313L) を出力します。
「引数のスタック渡し」の正常な
組み合わせです。
エラーは出力しません。
本エラーが発生した場合, 付表 A-1 を参照して-rpオプション指定または, 入力オブジェ
クトの関数呼び出しインタフェースを修正してください。
このセクションは存在しません ( セクション名 )
E4319L
Section not exists ( セクション名 )
グループ化オプション (-gr) で指定されたセクションが見つかりません。
ここで示されるセクションが絶対セクションであった場合にも,セクション再配置の対
象にならないため , 当メッセージが通知されます。
外部シンボルの型が異なっています ( マングル名 / シンボル名 )
E4326L
Different symbol type ( マングル名 / シンボル名 )
-e オプションによるエントリポイントの設定時に指定された外部定義シンボルが , 関
数名 , 変数名 , アドレスラベル名のいずれでもない場合に通知されます。
リロケーション情報に誤りがあります
E4327L
Illegal RL information
リロケーション情報に誤りがある場合に検出されます。
値が範囲外です ( 値 )
E4329L
Value out of range ( 値 )
リロケーション演算でオーバフローがありました。
このメッセージには,リロケーション対象となったデータ部の記述を含むソースプログ
ラム名と行番号が表示されますので , プログラムの記述を確認してください。
エディタのタグジャンプが利用できる場合 , 該当するソース行がすぐにわかります。
342
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
0 による除算が行われました
E4330L
Divided by 0
リロケーション演算の除算で除数が 0 になっています。
配置アドレスを指定してください ( セクション名 )
E4331L
Indispensable to locate address ( セクション名 )
-sc オプションによるアドレス指定がないか , 指定のないセクションが見つかった場合
に通知されます。
グループ名は使えません ( グループ名 )
E4332L
Not handling group name ( グループ名 )
-sc オプションでの ROM → RAM 転送セクションの指定時に , グループ名は指定できま
せん。
ROM アドレスが指定されていません ( セクション名 )
E4333L
Not specified ROM address ( セクション名 )
ROM領域に配置すべきリロケーション情報に対し, ROMアドレスの指定がありません。
-sc オプションで ROM アドレスの指定を行ってください。
E4351L
相対アセンブルリストファイルに対するオブジェクトがありません
( ファイル名 )
Relocatable assemble list not correspond to object file( ファイル名 )
補助メッセージに示す相対アセンブルリストファイルに対するオブジェクトが見つか
りません。
リンカは補助メッセージに示すリストファイルの処理を中止し,次のリストファイルの
処理を行います。
相対アセンブルリストファイルがありません ( ファイル名 )
E4352L
Relocatable assemble list file not found ( ファイル名 )
補助メッセージに示す相対アセンブルリストファイルがありません。
リンカは補助メッセージに示すファイル名に対する絶対アセンブルリストファイルを
作成せず , 処理を続行します。
July 31, 2015, CM41-00315-6
343
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
E4354L
So ft
Manu al
相対アセンブルリストファイルの形式が正しくありません ( ファイ
ル名 )
Illegal relocatable assemble list file format ( ファイル名 )
補助メッセージに示す相対アセンブルリストファイルの形式は,リンカで正しく処理で
きるものではありません。
リンカは補助メッセージに示すリストファイルの処理を中止し,次のリストファイルの
処理を行います。
オブジェクトデータが一致していません ( ファイル名 )
E4355L
Object data not correspond ( ファイル名 )
絶対形式ロードモジュールファイルのオブジェクトデータと,補助メッセージに示す相
対形式アセンブルリストのソースデータが一致していません。
アセンブルし直してから , 再度実行してください。
配列の次元数または構造体のネストが多すぎます
E4357L
Too many array dimension or structure nested : exceeded 8
ARRAYリストに出力される配列の次元数または,構造体のネストが8を超えています。
処理は続行しますが , これを超えた部分はリストに出力されません。
ダミーセクションの指定があります。( ファイル名 )
E4362L
DUMMY section specified ( ファイル名 )
補助メッセージに示すファイルでダミーセクションが指定されています。
絶対アセンブルリストを作成する場合にはダミーセクションの記述をしないでくださ
い。
セクションの最大サイズを越えました ( セクション名 )
E4363L
Exceeded maximum section size( セクション名 )
セクションの最大サイズを超えたセクションがあります。セクションには , そのセク
ション種別により最大サイズが制限されるものがあります。それを超えた場合に検出
されます。
セクションの見直しを行ってください。
344
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
バンクの最大アドレスを越えました ( セクション名 )
E4364L
Exceeded maximum bank address( セクション名 )
セクションを指定位置から配置したときにバンクを超えた場合 , 検出されます。
バンク内のセクション構成を見直してください。
E4365L
配置可能なアドレスが領域 " 領域名 " に見つかりません
( セクション名 )
Not found locatable address in 領域名 ( セクション名 )
配置指定領域の該当セクションの配置可能な場所が見つかりません。
領域内のセクション構成を見直してください。
配置可能なアドレスが見つかりません ( セクション名 )
E4366L
Not found locatable address( セクション名 )
全アドレス空間にセクションの配置可能な場所が見つかりません。
プログラム構成を見直してください。
モジュール名の重複がありました ( ファイル名 モジュール名 )
E4367L
Duplicated module name( ファイル名 モジュール名 )
既にリンク対象となっているモジュール名と同じ名前のモジュール名が存在します。
モジュール名の重複はできません。モジュール名を変更してください。
バンク外のシンボルを参照しました ( シンボル名 )
E4368L
Referenced other bank symbol( シンボル名 )
バンク内分岐命令で , 他バンクに定義されているシンボルを参照しました。
該当箇所 ( シンボル ) への分岐が必要な場合には , バンク外への分岐命令を使用してく
ださい。
コンパイルモデルの異なるモジュールがあります ( ファイル名 )
E4369L
Invalid module : conflict compile model( ファイル名 )
コンパイルモデルの異なるモジュールはリンクできません。
July 31, 2015, CM41-00315-6
345
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
CPU 情報ファイルが見つかりません ( ファイル名 )
E4370L
CPU information file not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報ファイルが見つかりません。
下記ファイルが見つからない場合に検出されます。
• %FETOOL% \ LIB \ 907 \ 907.CSV
CPU 情報が見つかりません ( ファイル名 )
E4371L
CPU information not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報が CPU 情報ファイル内に見つかり
ません。
下記ファイル内に指定ターゲットの CPU 情報が見つからない場合に検出されます。
• %FETOOL% \ LIB \ 907 \ 907.CSV
メモリが足りません
F9001L
Insufficient memory
プログラム実行のためにはメモリが不足しています。バッチファイル中でリンカを起
動している場合は , 直接コマンドラインから起動してみてください。
ファイルが見つかりません ( ファイル名 )
F9011L
Input file not found ( ファイル名 )
指定された入力ファイルが見つかりません。
ライブラリファイルが見つかりません ( ファイル名 )
F9012L
Library file not found ( ファイル名 )
ここで示されるファイル名がデフォルトライブラリファイルであるときは , 環境変数
LIB907 が示すディレクトリにライブラリファイルが格納されていないか , 環境変数
FETOOL より導かれるディレクトリにライブラリファイルが格納されていません。
-l, -el オプションで指定したライブラリファイルであるときは , ファイル名指定もしく
は -L オプションで指定の検索パスが間違っていないか確かめてください。
ファイルがオープンできません ( ファイル名 )
F9015L
File open error( ファイル名 )
ここで示されたファイルが出力ファイルである場合 , 1 つのディレクトリが管理できる
ファイルの制限数を超えている可能性があります。不要なファイルを削除するか移動
してください。
346
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
ファイルからの読込みができません ( ファイル名 )
F9016L
File read error ( ファイル名 )
読込み許可のないファイルである可能性があります。
ファイルへの書込みができません ( ファイル名 )
F9017L
File write error ( ファイル名 )
書込み許可のない同名のファイルが存在している可能性があります。
または,ここで示されているファイルを書き込んでいるディスクの容量が不足している
可能性があります。ディスクに空き容量を作ってもう一度リンカを実行してください。
コマンドラインの指定が多すぎます
F9021L
Too many options
コマンドラインに指定した ( オプションファイル中の指定も含む ), 入力ファイル名や
オプションが多すぎます。
リンカの起動を複数回に分けてください。
オプション名の指定に誤りがあります ( オプション )
F9022L
Illegal option name ( オプション )
リンカで使用できるオプションではありません。-help オプションまたは当マニュアル
で確認してください。
パラメータの指定に誤りがあります ( オプション )
F9023L
Illegal option parameter ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
パラメータが不足していたり , 区切り記号の誤りのようなシンタックスに起因するエ
ラーであると思われる場合に通知します。
パラメータの指定に不正な文字があります ( オプション )
F9024L
Illegal character ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
数値の指定方法の誤りなど不正文字の使用によるエラーであると思われる場合に通知
します。
July 31, 2015, CM41-00315-6
347
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
値が範囲外です ( 値 )
F9026L
Specified value out of range ( 値 )
-pl, -pw, -w オプションで許される範囲外の値が指定されています。
オプションファイル中にオプションファイルの指定があります
F9027L
Option file nested
オプションファイルはネストできません。オプションファイル中に記述されている -f
オプションを削除してください。
入力ファイル名の指定がありません
F9030L
Missing input file name
入力ファイルを指定してください。
入出力ファイル名が同じです ( ファイル名 )
F9032L
Output file name same as input one ( ファイル名 )
ここに示された出力ファイル名は , 入力ファイル名と同じ名称ですので処理できませ
ん。
ファイルの形式が正しくありません ( ファイル名 )
F9033L
Illegal file format ( ファイル名 )
以下のどれかの場合に通知されるメッセージです。
• ライブラリファイルの形式が正しくない。
• ライブラリファイル中のオブジェクトモジュールの形式が正しくない。
• 入力ファイルが絶対形式ロードモジュールである。
• 入力モジュールの内容が正しくない。
• 相対形式アセンブルリストファイルの形式が正しくない。
• CPU 情報ファイルの形式が正しくない。
ファイル名またはパス名が重複しています ( ファイル名 )
F9040L
Duplicated file or path name ( ファイル名 )
以下の 3 つのどれかの場合に通知されるメッセージです。
• 同名の入力モジュールファイル名が指定されている。
• -l, -el オプションで同名のライブラリファイル名が指定されている。
• -L オプションで同じライブラリパス名が指定されている。
348
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
セクション名の重複指定があります ( セクション名 )
F9042L
Duplicated section name ( セクション名 )
-sc または -gr オプションで , 同一のセクション名が複数指定されました。
シンボル名の重複指定があります ( シンボル名 )
F9043L
Duplicated symbol name ( シンボル名 )
-el オプションで , 同じ外部参照シンボルが複数指定されています。
セクショングループ名が重複しています ( グループ名 )
F9044L
Duplicated section group name ( グループ名 )
-gr オプションによるグループの設定時に , 同じグループ名が複数使用されました。
該当するファイルが見つかりませんでした ( ファイル名 )
F9047L
No match ファイル名 argument
ワイルドカードによるファイル指定が行われましたが,該当するファイルがありません
でした。
"-cpu" オプションの指定がありません
F9052L
Missing "-cpu" option
-cpu オプションによるターゲット CPU の指定がありません。
"-ro", "-ra" オプションの指定がありません
F9053L
Missing "-ro" or "-ra" option
自動配置を行うのに必要な "-ro", "-ra" オプションが指定されていません。
セクション名が重複しています ( セクション名 )
F9054L
Duplicate section name exist( セクション名 )
複数のモジュールに , 名前が同じで属性や型の異なるセクションが存在します。
絶対アセンブルリスト作成時に出力されます。
July 31, 2015, CM41-00315-6
349
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
CPU 情報ファイルのバージョンが適合しません
F9056L
Mismatch CPU information file version
CPU 情報ファイルが古く適合しません。
最新の CPU 情報ファイルを入手してください。
処理限界数を超えました ( シンボル名 )
F9076L
The number of processing limits was exceeded ( シンボル名 )
本エラーは , 絶対形式アセンブルリスト出力時に , 以下のどれかの数が 1048576 を超え
た場合に発生します。
• リンカ入力モジュール数
• 外部シンボルと静的 (static) シンボルの合計数
• セクションの数
本エラーが発生する場合 , 絶対形式アセンブルリストの出力を抑止してください。
S.C.F チェックプロセスでエラーが発生しました
F9077L
S.C.F check process returns error
S.C.F チェックプロセスでエラーが発生しました。
――――――――――――――――――――――――――――
F9998L
File open failed ( ファイル名 )
リンカが使用するメッセージファイルがオープンできませんでした。
エラーメッセージファイル (lkt907_a.msg, lkt907_e.msg) は , 決められたディレクトリに
格納してください。
プログラム内部エラーが発生しました ( 識別情報 )
F9999L
Internal error ( 識別情報 )
このエラーが出た場合は , 直ちに当社営業担当部門へ連絡してください。
350
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
■ ライブラリアンのエラーメッセージ
外部定義のない外部参照シンボルがあります
I0401U
Reference to undefined symbol
-c オプションにより報告されるメッセージです。ライブラリファイルの外部シンボル
をチェックした結果,当ライブラリファイル中で解決されない外部参照シンボルが含ま
れていることを示しています。当メッセージの出力されるライブラリファイルをリン
カで使用する場合は , どのモジュールの外部定義シンボルが使われるか注意が必要で
す。
デバッグ情報が含まれています
I0402U
Debug information exists
-c オプションにより報告されるメッセージです。当ライブラリファイルにはデバッグ
情報を含むモジュールが含まれています。ライブラリファイル中のデバッグ情報は ,
-O オプションで取り除くことができます。
下位互換 CPU タイプのオブジェクトがあります ( ファイル名 )
I0407U
Lower compatible cpu type object ( ファイル名 )
ここで示されたファイルは , ライブラリファイルと下位互換性のある異なる CPU タイ
プのモジュールを含むオブジェクトファイル , あるいはライブラリファイルです。
互換性のある CPU タイプのオブジェクトです ( ファイル名 )
I0413U
Compatible CPU type object( ファイル名 )
ここで示されたファイルは , ライブラリファイルと互換性のある異なる CPU タイプの
モジュールを含むオブジェクトファイル , あるいはライブラリファイルです。
"-pl" 指定を無視します
W1401U
Ignore "-pl" option
リスト行数指定 (-pl オプション ) がありますが , 対象となるマップリストが出力指定さ
れていません。この指定を無視します。
"-pw" 指定を無視します
W1402U
Ignore "-pw" option
リスト桁数指定 (-pw オプション ) がありますが , 対象となるマップリストが出力指定
されていません。この指定を無視します。
July 31, 2015, CM41-00315-6
351
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
"-g" 指定を無視します
W1403U
Ignore "-g" option
デバッグ情報付ライブラリ作成指定 (-g オプション ) は , モジュールの追加指定 (-a オ
プション ) または置換指定 (-r オプション ) を行うときのみ意味を持ちます。この指定
を無視します。
行うべき処理がありませんでした
W1404U
Nothing to operate
ライブラリファイルの変更またはモジュールの抽出処理がありませんでした。
削除するモジュールがありませんでした ( モジュール名 )
W1405U
Module not exists to delete ( モジュール名 )
-d オプションで指定のモジュールが , ライブラリファイルに含まれていません。
-m オプションで登録されているモジュール名を確かめてください。
抽出するモジュールがありませんでした ( モジュール名 )
W1406U
Module not exists to extract ( モジュール名 )
-x オプションで指定のモジュールが , ライブラリファイルに含まれていません。
-m オプションで登録されているモジュール名を確かめてください。
モジュール名の重複がありました ( ファイル名 モジュール名 )
E4402U
Duplicated module name ( ファイル名 モジュール名 )
既に登録されているモジュールと同じ名前のモジュールを追加登録しようとしまし
た。
1 つのライブラリ中にモジュールの重複はできませんので , ここで示されるモジュール
は登録しません。置き換えるならば , -r オプションを使用してください。
外部定義シンボルの重複がありました ( ファイル名 シンボル名 )
E4403U
Duplicated external definition symbol name ( ファイル名 シンボル名 )
登録されているモジュールには , 外部定義シンボルが含まれていますが , ここで示され
たシンボルは既にライブラリに登録されています。
1 つのライブラリ中に外部定義シンボルの重複はできませんので , ここで示されるシン
ボルを含むモジュールは登録しません。
352
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
登録できないモジュール形式です ( ファイル名 )
E4404U
Invalid module : type ( ファイル名 )
ライブラリファイルに登録できるのは,アセンブラが出力するオブジェクトモジュール
形式だけです。リンカ出力の絶対形式および相対形式ロードモジュールは登録できま
せん。
作成ツールの異なるモジュールがあります ( ファイル名 )
E4405U
Invalid module : conflict tool name ( ファイル名 )
このライブラリアンが処理できるファミリ用アセンブラ出力のオブジェクトファイル
ではありません。または , ほかのファミリ用ライブラリアンで作成されたライブラリ
ファイルが指定されています。
コンパイルモデルの異なるモジュールがあります ( ファイル名 )
E4406U
Invalid module : conflict compile model ( ファイル名 )
コンパイルモデル ( メモリモデルなど ) が異なるモジュールは同じライブラリに登録で
きません。
ターゲット CPU の異なるモジュールがあります ( ファイル名 )
E4407U
Invalid module : conflict CPU type( ファイル名 )
ターゲット CPU の異なるモジュールは同じライブラリに登録できません。
65535 個以上のモジュール登録はできません
E4408U
Too many entry modules : exceed 65535
1 ライブラリは 65535 モジュール以下となるよう , 別ライブラリを作成してください。
65535 個以上の外部シンボル登録はできません
E4409U
Too many entry external symbols : exceed 65535
1 ライブラリは 65535 シンボル以下となるよう , 別ライブラリを作成してください。
E4410U
関数呼び出しインタフェースの異なるモジュールがあります
( ファイル名 )
The module is different calling interface of a function ( ファイル名 )
本エラーメッセージは , 以下の付表 A-2 に示す条件で出力されます。
July 31, 2015, CM41-00315-6
353
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
付表 A-2 入力オブジェクト , 編集対象ライブラリと -rp オプションの関係
入力オブジェクトと編集対象ライブラリの関数呼び出しインタフェース
「引数のレジスタ渡し」
あ
り
-rp オプション指定
な
し
「引数のレジスタ渡し」の正常な
組み合わせです。
エラーは出力しません。
「引数のスタック渡し」
エラー (E4310U) を出力します。
エラー (E4310U) を出力します。 「引数のスタック渡し」の正常な
組み合わせです。
エラーは出力しません。
本エラーが発生した場合, 付表 A-2 を参照して-rpオプション指定または, 入力オブジェ
クト , 編集対象ライブラリの関数呼び出しインタフェースを修正してください。
CPU 情報ファイルが見つかりません ( ファイル名 )
E4470U
CPU information file not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報ファイルが見つかりません。
下記ファイルが見つからない場合に検出されます。
• %FETOOL% \ LIB \ 907 \ 907.CSV
CPU 情報が見つかりません ( ファイル名 )
E4471U
CPU information not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報が CPU 情報ファイル内に見つかり
ません。
下記ファイル内に指定ターゲットの CPU 情報が見つからない場合に検出されます。
• %FETOOL% \ LIB \ 907 \ 907.CSV
メモリが足りません
F9001U
Insufficient memory
プログラム実行のためのメモリが不足しています。
ファイルがオープンできません ( ファイル名 )
F9015U
File open error( ファイル名 )
ここで示されたファイルが出力ファイルである場合 , 1 つのディレクトリが管理できる
ファイルの制限数を超えている可能性があります。不要なファイルを削除するか移動
してください。
354
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
ファイルからの読込みができません ( ファイル名 )
F9016U
File read error ( ファイル名 )
読込み許可のないファイルである可能性があります。
ファイルへの書込みができません ( ファイル名 )
F9017U
File write error ( ファイル名 )
書込み許可のない同名のファイルが存在している可能性があります。
または,ここで示されているファイルを書き込んでいるディスクの容量が不足している
可能性があります。ディスクに空き容量を作ってもう一度ライブラリアンを実行して
ください。
コマンドラインの指定が多すぎます
F9021U
Too many options
コマンドラインに指定した ( オプションファイル中の指定も含む ), 入力ファイル名や
オプションが多すぎます。
ライブラリアンの起動を複数回に分けてください。
オプション名の指定に誤りがあります ( オプション )
F9022U
Illegal option name ( オプション )
オプション名の指定に誤りがあります。
コマンドラインを訂正して再起動してください。
パラメータの指定に誤りがあります ( オプション )
F9023U
Illegal option parameter ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
値が範囲外です ( 値 )
F9026U
Specified value out of range ( 値 )
-pl または -pw オプションのパラメータで指定可能な値ではありません。
-help オプションまたは本マニュアルで確認してください。
オプションファイル中にオプションファイルの指定があります
F9027U
Option file nested
オプションファイルはネストできません。オプションファイル中に記述されている -f
オプションを削除してください。
July 31, 2015, CM41-00315-6
355
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
ファイルの形式が正しくありません ( ファイル名 )
F9033U
Illegal file format ( ファイル名 )
CPU 情報ファイルの形式が正しくないかまたはライブラリファイルの形式が正しくな
い ( ライブラリファイルではない ) か , 登録または置換のために指定した入力ファイル
が , アセンブラ出力のオブジェクト形式ではありません。
異なる形式のファイルを入力したか , もしくはファイルが壊れています。
ライブラリファイル名の指定がありません
F9035U
Missing library file name
ライブラリファイル名の指定がありません。
ライブラリファイル名を指定してください。
ライブラリファイル名が複数指定されています ( ファイル名 )
F9036U
Multiple library file name specified( ファイル名 )
ライブラリファイルは 1 つだけ指定できます。ここに示されたファイル名またはこれ
により前に指定したライブラリファイル名のどちらか 1 つを選択してください。
"-O" 指定時はほかのオプションの指定はできません
F9045U
"-O" option conflict with another option
-O オプション指定時は , ほかのオプションは指定できません。
"-c" 指定時はほかのオプションの指定はできません
F9046U
"-c" option conflict with another option
-c オプションは , ほかのオプションと組合せないでください。
該当するファイルが見つかりませんでした ( ファイル名 )
F9047U
No match ファイル名 argument
ワイルドカードによるファイル指定が行われましたが,該当するファイルがありません
でした。
"-cpu" オプションの指定がありません
F9052U
Missing "-cpu" option
-cpu オプションによるターゲット CPU の指定がありません。
flib907s は , -cpu オプションでターゲット CPU を指定する必要があります。
356
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
CPU 情報ファイルのバージョンが適合しません
F9056U
Mismatch CPU information file version
CPU 情報ファイルが古く適合しません。
最新の CPU 情報ファイルを入手してください。
――――――――――――――――――――――――――――――
F9998U
File open failed ( ファイル名 )
ライブラリファイルが使用するメッセージファイルがオープンできませんでした。
エラーメッセージファイル (lkt907_a.msg, lkt907_e.msg) は , 決められたディレクトリに
格納してください。
プログラム内部エラーが発生しました ( 識別情報 )
F9999U
Internal error ( 識別情報 )
このエラーが出た場合は , 直ちに当社営業担当部門へ連絡してください。
■ コンバータのエラーメッセージ
スタートアドレスレコードを読み飛ばしました
I0501U
Skip start address record
HEX フォーマットにスタートアドレスレコードが含まれていましたが , 不要なので読
み飛ばしました。コンバータの処理には影響なく正しくコンバートは行われます。
このファイルは警告レベルエラーを含んでいます ( ファイル名 )
W1501U
File include WARNING level error ( ファイル名 )
入力に指定したファイルは , リンク時に警告レベルのエラーがあったものです。問題な
いかどうかを確認のうえ使用してください。
出力指定フォーマットで表せないアドレスです ( アドレス )
W1502U
Unable to convert address ( アドレス )
コンバート先のフォーマットでは , 表現できないアドレスのデータがコンバート元の
ファイルに含まれています。ここで示されたアドレスを越えた部分のデータはすべて
捨てられます。
コンバート先のフォーマットを変更してください。
July 31, 2015, CM41-00315-6
357
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
-I16 指定時に -entry オプションが指定されました
W1503U
-entry option was specified at the time of I16 specification
-I16 指定時にスタートアドレス出力指定オプションが指定されました。
入力ファイルにスタートアドレス情報がありません
W1504U
Start address information is not in an input file
入力ロードモジュールファイルにスタートアドレス情報がありません。f2hs は , スター
トアドレスレコードを出力せずに HEX フォーマットを出力します。
メモリが足りません
F9001U
Insufficient memory
プログラム実行のためのメモリが不足しています。
ファイルが見つかりません ( ファイル名 )
F9011U
Input file not found( ファイル名 )
入力ファイルに指定したファイルが見つかりません。
ファイルがオープンできません ( ファイル名 )
F9015U
File open error( ファイル名 )
ここで示されたファイルが出力ファイルである場合 , 1 つのディレクトリが管理できる
ファイルの制限数を超えている可能性があります。不要なファイルを削除するか移動
してください。
ファイルから読込みができません ( ファイル名 )
F9016U
File read error( ファイル名 )
読込み許可のないファイルであるか,もしくはハードウェアに問題があることが考えら
れます。
ファイルへの書込みができません ( ファイル名 )
F9017U
File write error ( ファイル名 )
ここで示されているファイルを書き込んでいるディスクの容量が不足しています。
ディスクに空き容量を作ってもう一度コンバータを実行してください。
358
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
コマンドラインの指定が多すぎます
F9021U
Too many options
コマンドラインに指定 ( オプションファイル中の指定も含む ) した , 入力ファイル名や
オプションが多すぎます。
オプション名の指定に誤りがあります ( オプション )
F9022U
Illegal option name ( オプション )
コンバータで使用できるオプションではありません。-help オプションまたは本マニュ
アルで確認してください。
パラメータの指定に誤りがあります ( オプション )
F9023U
Illegal option parameter ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
値が範囲外です ( 値 )
F9026U
Specified value out of range ( 値 )
オプションで許される範囲外の値が指定されています。
オプションファイル中にオプションファイルの指定があります
F9027U
Option file nested
オプションファイルはネストできません。オプションファイル中に記述されている -f
オプションを削除してください。
F9028U
指定したアドレスは大きすぎます ( オプション : s= アドレス 1e= ア
ドレス 2)
Specified address too large ( オプション : s= アドレス 1e= アドレス 2)
オプションのパラメータで指定したアドレスは,コンバート先のファイルフォーマット
では表せません。指定し直してください。
F9029U
指定アドレスの大小関係が逆です ( オプション : s= アドレス 1e= ア
ドレス 2)
Start address opposite to end one( オプション : s= アドレス 1e= アドレス 2)
オプションのパラメータで指定したアドレスは,スタートアドレスとエンドアドレスの
大小関係が逆です。
July 31, 2015, CM41-00315-6
359
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
入力ファイル名の指定がありません
F9030U
Missing input file name
コンバート元の入力ファイル名を指定してください。
入力ファイル名は既に指定されています ( ファイル名 )
F9031U
Multiple input file name ( ファイル名 )
入力ファイルは 1 つだけ指定できます。ここに示されたファイル名またはこれより前
に指定したファイル名のどちらか 1 つを入力ファイルとしてください。
入出力ファイル名が同じです ( ファイル名 )
F9032U
Output file name same as input one ( ファイル名 )
ここに示された出力ファイル名は , 入力ファイル名と同じ名称ですので処理できませ
ん。
ファイルの形式が正しくありません ( ファイル名 )
F9033U
Illegal file format ( ファイル名 )
入力ファイルは , 処理しようとしているオブジェクト形式ではありません。
異なる形式のファイルを入力したか , もしくはファイルが壊れています。
絶対形式でないファイルは扱えません ( ファイル名 )
F9034U
Not absolute load module file( ファイル名 )
リンカ出力の絶対形式ロードモジュールではないファイルを入力しました。リンカで
絶対形式にしてからコンバータで使用してください。
出力範囲が指定されていません
F9048U
Missing output range
出力範囲の指定が行われていません。
出力範囲指定 (-ran) を指定してください。
出力範囲のサイズが限界値を越えています
F9049U
Output range exceeded
出力範囲が限界値を超えています。
360
CM41-00315-6, July 31, 2015
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
出力ファイルがほかの出力ファイルと同じです ( ファイル名 )
F9050U
Output filename same as other output one( ファイル名 )
出力ファイル名に , ほかの出力ファイル名と同じ名前が指定されています。
出力ファイル名を変更してください。
ファイル名が長すぎます ( ファイル名 )
F9051U
File name too long ( ファイル名 )
ここに示された出力ファイル名の指定が長すぎるため処理ができません。
ファイル名の指定を短くしてください。
――――――――――――――――――――――――――――――
F9998U
File open failed ( ファイル名 )
コンバータが使用するメッセージファイルがオープンできませんでした。
エラーメッセージファイル (lkt_a.msg, lkt_e.msg) は , 決められたディレクトリに格納し
てください。
プログラム内部エラーが発生しました ( 識別情報 )
F9999U
Internal error ( 識別情報 )
このエラーが出た場合は , 直ちに当社営業担当部門へ連絡してください。
July 31, 2015, CM41-00315-6
361
付録
付録 B HEX フォーマット
Su pp or t
付録 B
So ft
Manu al
HEX フォーマット
HEX フォーマットについて説明します。
• HEX8 フォーマット : 8 ビット用に設定されたフォーマット
• HEX16 フォーマット : 16 ビット用に拡張されたフォーマット
• HEX32 フォーマット : 32 ビット用に拡張されたフォーマット
B.1 一般形式
B.2 データレコード (HEX8/HEX16/HEX32) タイプ : 00
B.3 エンドレコード (HEX8/HEX16/HEX32) タイプ : 01
B.4 拡張セグメントアドレスレコード (HEX16/HEX32) タイプ : 02
B.5 スタートセグメントアドレスレコード (HEX16/HEX32) タイプ : 03
B.6 拡張リニアアドレスレコード (HEX32) タイプ : 04
B.7 スタートリニアアドレスレコード (HEX32) タイプ : 05
362
CM41-00315-6, July 31, 2015
付録
付録 B HEX フォーマット
Support
Soft
Ma nual
一般形式
B.1
HEX フォーマットのレコード形式は , (a) ~ (f) で示す 6 つのフィールドで構成され
ます。
各フィールドは , ASCII コードで設定されます。(g) については , 後述します。
■ 一般形式
図 B.1-1 一般形式
:
(a)
l1
(b)
l2
a1
a2
(c)
a3
a4
t1
(d)
t2
d1
d2
d3
d4
d*
d*
d*
d*
(e)
s1
(f)
s2
(g)
(a):
レコードの開始を示し , ":"(0x3A) の文字です。
(b):
(e) のデータ部のバイト数を示します。
実際の 1 バイトデータを当フォーマットでは 2 バイトの ASCII コードで示しますの
で , 上記の図では , d1, d2 を 1 とカウントします。
l1 が上位桁 , l2 が下位桁で , 0 ~ 255 の値が設定できます。
ASCII で "00" ~ "FF", 16 進で "0x3030" ~ "0x4646" になります。
(c):
(e) の内容がオブジェクトデータであるとき , 最初のデータに割り付けられたアドレ
スを示します。
a1 が上位桁 , a4 が下位桁で , 0 ~ 65535 の値が設定できます。
ASCII で "0000" ~ "FFFF", 16 進で "0x30303030" ~ "0x46464646" になります。
(d):
レコードのタイプを示します。
00 : データレコード (HEX8/HEX16/HEX32 形式 )
01 : エンドレコード (HEX8/HEX16/HEX32 形式 )
02 : 拡張セグメントアドレスレコード (HEX16/HEX32 形式 )
03 : スタートセグメントアドレスレコード (HEX16/HEX32 形式 )
04 : 拡張リニアアドレスレコード (HEX32 形式 )
05 : スタートリニアアドレスレコード (HEX32 形式 )
(e):
(d) のレコードタイプごとに異なりますので , 各レコードの説明で示します。
July 31, 2015, CM41-00315-6
363
付録
付録 B HEX フォーマット
Su pp or t
So ft
Manu al
(f):
チェックサムです。(b)(c)(d)(e) の ASCII で表された 2 バイトのデータを 1 バイトの
16 進で表し , 各バイトを符号なしでオーバフローを無視して加算します。
その結果の 2 の補数を求め , 2 バイトの ASCII にして設定します。
s1 が上位桁になります。
2 の補数 : 各ビットの 0 を 1 に , 1 を 0 にした値に 1 を加えた値
(g):
一般に制御コード (CR, LF など ) が付加されます。
このフィールドのデータは , (a) の開始文字 ":" が来るまで読み飛ばします。
(a)(b)(c)(d)(f) のフィールドは必ず存在しますので , 1 レコードの長さは最低 11 バイト ,
最大 521 バイトになります。
【例】
364
:020000020036C6
拡張アドレスレコード
:0600100090D9226BB4FD43
データレコード
:040000035162000541
スタートアドレスレコード
:00000001FF
エンドレコード
CM41-00315-6, July 31, 2015
付録
付録 B HEX フォーマット
Support
B.2
Soft
Ma nual
データレコード (HEX8/HEX16/HEX32) タイプ : 00
d1, d2 が (c) が示すアドレスのバイトデータになり , d3, d4 は , 次のアドレスのバイ
トデータです。
■ データレコード (HEX8/HEX16/HEX32)
図 B.2-1 データレコード (HEX8/HEX16/HEX32)
:
l1
(a)
(b)
l2
a1
(c)
a2
a3
a4
0
(d)
0
d1
d2
d3
d4
d*
d*
d*
d*
(e)
s1
s2
(f)
(g)
(a)(b)(c)(d)(f)(g) については , 一般形式の説明を参照してください。
(e) は , オブジェクトデータで , 実際の 1 バイトデータを 2 バイトの ASCII で表現します。
上記の図では , (c) が示すアドレスのバイトデータは , d1, d2 になります。
同様に d3, d4 は , 次のアドレスのバイトデータです。
July 31, 2015, CM41-00315-6
365
付録
付録 B HEX フォーマット
Su pp or t
B.3
So ft
Manu al
エンドレコード (HEX8/HEX16/HEX32) タイプ : 01
エンドレコードは , 00000001FF で固定です。
最後のレコードとして 1 つだけ存在します。
■ エンドレコード (HEX8/HEX16/HEX32)
図 B.3-1 エンコードレコード (HEX8/HEX16/HEX32)
:
0
(a)
(b)
0
0
(c)
0
0
0
0
(d)
1
F
(f)
F
(g)
(e) のフィールドは , 存在しません。したがって , (b) は 0 を設定します。
(c) は未使用ですが値としては 0 を設定します。
366
CM41-00315-6, July 31, 2015
付録
付録 B HEX フォーマット
Support
B.4
Soft
Ma nual
拡張セグメントアドレスレコード (HEX16/HEX32) タイプ : 02
拡張セグメントアドレスレコードが現れると , 次の拡張セグメントアドレスレコード
が現れるまで , 以降のデータレコードの各バイトデータは , 以下の式に従ってアドレ
スが計算されます。
(( PA × 0x10 ) + ( ( DA + DP ) MOD 0x10000 ) ) MOD 0x100000
• PA: 当レコードの (e) フィールドの値です。
• DA: データレコードの (c) フィールドの値で , ここでは相対アドレス扱いになりま
す。
• DP: データレコードの (e) フィールド中でのデータ位置の先頭データを 0 として
表した値です。
■ 拡張セグメントアドレスレコード (HEX16/HEX32)
図 B.4-1 拡張セグメントアドレスレコード (HEX16/HEX32)
:
0
(a)
(b)
2
0
(c)
0
0
0
0
(d)
2
p1
p2
p3
(e)
p4
s1
s2
(f)
(g)
(e) :
パラグラフアドレスで , 実際の 2 バイトデータを 4 バイトの ASCII で表現します。
上記の図では , p1 が上位桁になります。
(c) :
未使用ですが値としては 0 を設定します。
拡張セグメントアドレスレコードが現れると , 次の拡張セグメントアドレスレコー
ドが現れるまで , 以降のデータレコードの各バイトデータは , 以下の式に従ってア
ドレスが計算されます。
〔( PA × 0x10 ) + [( DA + DP ) MOD 0x10000]〕MOD 0x100000
• PA:
当レコードの (e) フィールドの値です。
• DA:
データレコードの (c) フィールドの値で , ここでは相対アドレス扱いにな
ります。
• DP:
データレコードの (e) フィールド中でのデータ位置の先頭データを 0 とし
て表した値です。
これは , i8086 での物理アドレスを求めるのと同じ方法であり , 拡張アドレスレコー
ドの追加により , 20 ビットのアドレス値まで表現できます。
拡張アドレスレコードよりも前に現れた , データレコードについては , 上記 PA を
0x0000 としてアドレス計算が行われます。
July 31, 2015, CM41-00315-6
367
付録
付録 B HEX フォーマット
Su pp or t
B.5
So ft
Manu al
スタートセグメントアドレスレコード (HEX16/HEX32)
タイプ : 03
プログラムの実行開始番地を指定するためのレコードです。
スタートアドレスは , 以下の式に従って計算されます。
(( PA × 0x10 ) + IP ) MOD 0x100000
• PA: 当レコードの (e1) フィールドの値です。
• IP: 当レコードの (e2) フィールドの値です。
■ スタートセグメントアドレスレコード (HEX16/HEX32)
図 B.5-1 スタートセグメントアドレスレコード (HEX16/HEX32)
:
0
(a)
(b)
4
0
(c)
0
0
0
0
(d)
3
p1
p2
p3
p4
i1
i2
(e)
i3
i4
s1
s2
(f)
(g)
(e) は , 上記の図のように 2 つのフィールドに分かれ , (e1) 部にパラグラフアドレス , (e2)
部にオフセット値が設定されます。
p1, i1 がそれぞれ上位桁になります。
(c) は未使用ですが 0 を設定します。
スタートアドレスは , 以下の式に従って計算されます。
〔( PA × 0x10 ) + IP 〕MOD 0x100000
• PA: 当レコードの (e1) フィールドの値です。
• IP: 当レコードの (e2) フィールドの値です。
当レコードの出現箇所は , エンドレコード以前ならどこでもかまいません。
出現回数は , 0 または 1 になります。
368
CM41-00315-6, July 31, 2015
付録
付録 B HEX フォーマット
Support
B.6
Soft
Ma nual
拡張リニアアドレスレコード (HEX32) タイプ : 04
拡張リニアアドレスレコードが現れると , 次の拡張リニアアドレスレコードが現れる
まで , 以降のデータレコードの各バイトデータは , 以下の式に従ってアドレスが計算
されます。
(( PA × 0x10000 ) + (( DA + DP ) MOD 0x10000 )) MOD 0x100000000
• PA: 当レコードの (e) フィールドの値です。
• DA: データレコードの (c) フィールドの値で , ここでは相対アドレス扱いになりま
す。
• DP: データレコードの (e) フィールド中でのデータ位置の先頭データを 0 として
表した値です。
■ 拡張リニアアドレスレコード (HEX32)
図 B.6-1 拡張リニアアドレスレコード (HEX32)
:
0
(a)
(b)
2
0
(c)
0
0
0
0
(d)
4
p1
p2
p3
(e)
p4
s1
(f)
s2
(g)
(e) :
パラグラフアドレスで , 実際の 2 バイトデータを 4 バイトの ASCII で表現します。
上記の図では , p1 が上位桁になります。
(c) :
未使用ですが値としては 0 を設定します。
リニアアドレスレコードが現れると , 次の拡張リニアアドレスレコードが現れるま
で , 以降のデータレコードの各バイトデータは , 以下の式に従ってアドレスが計算
されます。
〔( PA × 0x10000 ) + [( DA + DP ) MOD 0x10000]〕MOD 0x1000000000
• PA:
当レコードの (e) フィールドの値です。
• DA:
データレコードの (c) フィールドの値で , ここでは相対アドレス扱いにな
ります。
• DP:
データレコードの (e) フィールド中でのデータ位置の先頭データを 0 とし
て表した値です。
これは , i80386 での物理アドレスを求めるのと同じ方法であり , 拡張リニアアドレ
スレコードの追加により , 32 ビットのアドレス値まで表現できます。
拡張リニアアドレスレコードよりも前に現れた , データレコードについては , 上記
PA を 0x0000 としてアドレス計算が行われます。
July 31, 2015, CM41-00315-6
369
付録
付録 B HEX フォーマット
Su pp or t
B.7
So ft
Manu al
スタートリニアアドレスレコード (HEX32) タイプ : 05
プログラムの実行開始番地を指定するためのレコードです。
■ スタートリニアアドレスレコード (HEX32)
図 B.7-1 スタートリニアアドレスレコード (HEX32)
:
0
(a)
(b)
4
0
(c)
0
0
0
0
5
(d)
e1
e2
e3
e4
e5
(e)
e6
e7
e8
s1
s2
(f)
(g)
(e) は , 32bit の実行開始アドレスが設定されます。
e1 が上位桁になります。
(c) は未使用ですが 0 を設定します。
当レコードの出現箇所は , エンドレコード以前ならどこでもかまいません。
出現回数は , 0 または 1 になります。
370
CM41-00315-6, July 31, 2015
付録
付録 C S フォーマット
Support
付録 C
Soft
Ma nual
S フォーマット
S レコードフォーマットは , すべて "S"(0x53) の文字で始まり , S0 から S9 までの 8
タイプがあります (S4 と S6 は使用しません )。
C.1 S0 タイプ ( ヘッダレコード )
C.2 S1 タイプ ( データレコード : 2 バイトアドレス )
C.3 S2 タイプ ( データレコード : 3 バイトアドレス )
C.4 S3 タイプ ( データレコード : 4 バイトアドレス )
C.5 S5 タイプ ( レコード数管理レコード )
C.6 S7 タイプ ( ターミネータレコード )
C.7 S8 タイプ ( ターミネータレコード )
C.8 S9 タイプ ( ターミネータレコード )
July 31, 2015, CM41-00315-6
371
付録
付録 C S フォーマット
Su pp or t
So ft
Manu al
S0 タイプ ( ヘッダレコード )
C.1
当レコードは , コメント記述のために使用します。
■ S0 タイプ ( ヘッダレコード )
図 C.1-1 S0 タイプ ( ヘッダレコード )
S
0
l1
l2
0
0
0
0
c1
c2
c3
c4
c*
c * s1
s2
(a)
(b)
(c)
(d)
(e)
(f)
2バイト
2バイト
4バイト
nバイト
2バイト
当レコードは , 上記の (a) ~ (e) で示す 5 つのフィールドで構成されます。
S0 タイプはヘッダレコードとよばれ , S1 ~ S9 の各レコードに先立ち , ファイルの先頭
に置かれます。各フィールドは , ASCII コードで設定されます。
(a):
タイプフィールドで , ASCII コードで "S0"(0x5330) の文字です。
(b):
(c)(d)(e) のバイト数を示します。
実際の 1 バイトデータを当フォーマットでは 2 バイトの ASCII コードで示しますの
で , ( この部分の文字数 /2) が設定されます。
l1 が上位桁 , l2 が下位桁で , 0 ~ 255 の値が設定できます。
ASCII で "00" ~ "FF", 16 進で "0x3030" ~ "0x4646" になります。
(c):
使用しませんが ASCII で "0000" を設定します。
(d):
バージョン管理情報などのメッセージを設定します。
設定方法は , 下記の例を参照してください。
(e):
チェックサムです。
(b)(c)(d) の ASCII で表された 2 バイトのデータを , 1 バイトの 16 進で表し , 各バイ
トを符号なしでオーバフローを無視して加算します。
その結果の 1 の補数を求め , 2 バイトの ASCII にして設定します。
s1 が上位桁になります。
1 の補数 : 各ビットの 0 を 1 に , 1 を 0 にした値
(f):
一般に制御コード (CR, LF など ) が付加されます。
このフィールドのデータは , (a) の開始文字 "S" が来るまで読み飛ばします。
【例】
S00600004844521B
ASCII文字列の"HDR"を示す
372
CM41-00315-6, July 31, 2015
付録
付録 C S フォーマット
Support
Soft
Ma nual
S1 タイプ ( データレコード : 2 バイトアドレス )
C.2
アドレスが , 2 バイトで表せる (0x0000 ~ 0xFFFF) オブジェクトデータを格納する
レコードです。
■ S1 タイプ ( データレコード : 2 バイトアドレス )
図 C.2-1 S1 タイプ ( データレコード : 2 バイトアドレス )
S
1
l1
l2
a1
a2
a3
a4
d1
d2
d3
d4
d*
d*
s1
s2
(a)
(b)
(c)
(d)
(e)
2バイト
2バイト
4バイト
nバイト
2バイト
(f)
S1 タイプは , 上記の (a) ~ (e) で示す 5 つのフィールドで構成されます。
(a):
タイプフィールドで , ASCII コードで "S1"(0x5331) の文字です。
(b):
(c)(d)(e) のバイト数を示します。
(「付録 C.1 S0 タイプ ( ヘッダレコード )」の説明を参照してください。)
(c):
(d) の最初のデータに割り付けられたアドレスを示します。
a1 が上位桁 , a4 が下位桁で , 0 ~ 65535 の値が設定できます。
ASCII で "0000" ~ "FFFF", 16 進で "0x30303030" ~ "0x46464646" になります。
(d):
オブジェクトデータで , 実際の 1 バイトデータを 2 バイトの ASCII で表現します。
上記の図では , d1, d2 が (c) が示すアドレスのバイトデータになります。
同様に d3, d4 は , 次のアドレスのバイトデータです。
(e):
チェックサムです。
(「付録 C.1 S0 タイプ ( ヘッダレコード )」の説明を参照してください。)
(f):
一般に制御コード (CR, LF など ) が付加されます。
(「付録 C.1 S0 タイプ ( ヘッダレコード )」の説明を参照してください。)
July 31, 2015, CM41-00315-6
373
付録
付録 C S フォーマット
Su pp or t
So ft
Manu al
S2 タイプ ( データレコード : 3 バイトアドレス )
C.3
S2 タイプは , (c) フィールドの大きさが S1 タイプと異なるもので , 3 バイトアドレ
スが必要なオブジェクトデータを格納するためのレコードです。
■ S2 タイプ ( データレコード : 3 バイトアドレス )
図 C.3-1 S2 タイプ ( データレコード : 3 バイトアドレス )
S
2
l1
l2
a1
a2
a3
a4
a5
a6
d1
d2
d3
d4
d*
d*
s1
s2
(a)
(b)
(c)
(d)
(e)
2バイト
2バイト
6バイト
nバイト
2バイト
(f)
S2 タイプは , 上記の (c) フィールドの大きさが S1 タイプと異なるもので , 3 バイトアド
レスが必要なオブジェクトデータを格納するためのレコードです。
374
CM41-00315-6, July 31, 2015
付録
付録 C S フォーマット
Support
Soft
Ma nual
S3 タイプ ( データレコード : 4 バイトアドレス )
C.4
S3 タイプは , (c) フィールドの大きさが S1 タイプと異なるもので , 4 バイトアドレ
スが必要なオブジェクトデータを格納するためのレコードです。
■ S3 タイプ ( データレコード : 4 バイトアドレス )
図 C.4-1 S3 タイプ ( データレコード : 4 バイトアドレス )
S
3
l1
l2
a1
a2
a3
a4
a5
a6
a7
a8
d1
d2
d3
d4
d*
d*
s1
s2
(a)
(b)
(c)
(d)
(e)
2バイト
2バイト
8バイト
nバイト
2バイト
(f)
S3 タイプは , 上記の (c) フィールドの大きさが S1 タイプと異なるもので , 4 バイトアド
レスが必要なオブジェクトデータを格納するためのレコードです。
July 31, 2015, CM41-00315-6
375
付録
付録 C S フォーマット
Su pp or t
C.5
So ft
Manu al
S5 タイプ ( レコード数管理レコード )
ファイル中に含まれるレコードの数を設定します。
当レコードは , なくてもかまいません。出現場所は S0 と S9 の間で任意です。
■ S5 タイプ ( レコード数管理レコード )
図 C.5-1 S5 タイプ ( レコード数管理レコード )
S
5
0
3
n1
n2
n3
n4
s1
s2
(a)
(b)
(c)
(e)
2バイト
2バイト
4バイト
2バイト
(f)
S5 タイプは , 上記の (a) ~ (e) で示す 4 つのフィールドで構成されます。
(a):
タイプフィールドで , ASCII コードで "S5"(0x5335) の文字です。
(b):
(c)(e) のバイト数を示します。
(「付録 C.1 S0 タイプ ( ヘッダレコード )」の説明を参照してください。)
(c):
ファイル中のデータレコード (S1, S2, S3) の数を示します。
n1 が上位桁 , n4 が下位桁で , 0 ~ 65535 の値が設定できます。
ASCII で "0000" ~ "FFFF", 16 進で "0x30303030" ~ "0x46464646" になります。
(d):
フィールドはありません。
(e):
チェックサムです。
(「付録 C.1 S0 タイプ ( ヘッダレコード )」の説明を参照してください。)
(f):
一般に制御コード (CR, LF など ) が付加されます。
(「付録 C.1 S0 タイプ ( ヘッダレコード )」の説明を参照してください。)
376
CM41-00315-6, July 31, 2015
付録
付録 C S フォーマット
Support
C.6
Soft
Ma nual
S7 タイプ ( ターミネータレコード )
ファイルの終了を表すレコードであり , 実行開始アドレス情報も含んでいます。
当レコードは , ファイルの最後に置かれます。
実行開始アドレスの表現に 4 バイト必要な場合のターミネータレコードです。
■ S7 タイプ ( ターミネータレコード )
図 C.6-1 S7 タイプ ( ターミネータレコード )
S
7
0
5
e1
e2
e3
e4
e5
e6
e7
e8
s1
s2
(a)
(b)
(c)
(e)
2バイト
2バイト
8バイト
2バイト
(f)
S7 タイプは , 上記の (a) ~ (e) で示す 4 つのフィールドで構成されます。
(a):
タイプフィールドで , ASCII コードで "S7"(0x5337) の文字です。
(b):
(c)(e) のバイト数を示します。"05" 固定となります。
(c):
実行開始アドレスを示します。
e1 が上位桁 , e8 が下位桁になります。
(d):
フィールドはありません。
(e):
チェックサムです。
(f):
一般に制御コード (CR, LF など ) が付加されます。
July 31, 2015, CM41-00315-6
377
付録
付録 C S フォーマット
Su pp or t
C.7
So ft
Manu al
S8 タイプ ( ターミネータレコード )
S8 タイプは , (c) フィールドの大きさが S7 タイプと異なるもので , 実行開始アドレ
スの表現に 3 バイトが必要な場合のターミネータレコードです。
■ S8 タイプ ( ターミネータレコード )
図 C.7-1 S8 タイプ ( ターミネータレコード )
S
8
0
4
e1
e2
e3
e4
e5
e6
s1
s2
(a)
(b)
(c)
(e)
2バイト
2バイト
6バイト
2バイト
(f)
S8 タイプは , 上記の (c) フィールドの大きさが S7 タイプと異なるもので , 実行開始ア
ドレスの表現に 3 バイトが必要な場合のターミネータレコードです。
378
CM41-00315-6, July 31, 2015
付録
付録 C S フォーマット
Support
C.8
Soft
Ma nual
S9 タイプ ( ターミネータレコード )
S9 タイプは , (c) フィールドの大きさが S7 タイプと異なるもので , 実行開始アドレ
スの表現に 2 バイトが必要な場合のターミネータレコードです。
■ S9 タイプ ( ターミネータレコード )
図 C.8-1 S9 タイプ ( ターミネータレコード )
S
9
0
3
e1
e2
e3
e4
s1
s2
(a)
(b)
(c)
(e)
2バイト
2バイト
4バイト
2バイト
(f)
S9 タイプは , 上記の (c) フィールドの大きさが S7 タイプと異なるもので , 実行開始ア
ドレスの表現に 2 バイトが必要な場合のターミネータレコードです。
July 31, 2015, CM41-00315-6
379
付録
付録 D リンカのオプション一覧表
Su pp or t
付録 D
So ft
Manu al
リンカのオプション一覧表
表 D-1 にリンカのオプション一覧を示します。
■ リンカのオプション一覧
表 D-1 リンカのオプション一覧表 (1 / 3)
機能
380
オプション
備考
出力ロードモジュールファイル名指定
-o
デフォルト
デバッグ情報出力指定
-g
デバッグ情報削除指定
-Xg
デフォルト
絶対形式ロードモジュール出力指定
-a
デフォルト
相対形式ロードモジュール出力指定
-r
ROM 領域のフィル指定
-fill
マップリストファイル名指定
-m
マップリスト出力抑止指定
-Xm
リスト表示の名前省略解除
-dt
メモリ使用情報リスト出力指定
-mmi
リスト行の桁数指定
-pw
デフォルト 132
リスト 1 ページの行数指定
-pl
デフォルト 60
ROM 領域のチェックサム指定
-cs
警告メッセージ出力レベル指定
-w
ROM 領域指定
-ro
RAM 領域指定
-ra
セクション配置
-sc
セクショングループ指定
-gr
レジスタバンク領域の指定
-rg
自動配置指定
-AL
検索ライブラリファイル指定
-l
ライブラリ検索パス指定
-L
シンボル個別のライブラリ指定
-el
ライブラリ検索抑止指定
-nl
デフォルトライブラリ検索抑止指定
-nd
未使用関数削除指定
-lnkopt
デフォルト
デフォルト 0
CM41-00315-6, July 31, 2015
付録
付録 D リンカのオプション一覧表
Support
Soft
Ma nual
表 D-1 リンカのオプション一覧表 (2 / 3)
機能
オプション
備考
C ソース実行開始シンボル指定
-entryc
削除対象外関数指定
-Xdel
未使用関数削除情報ファイル格納パス指定
-ufiin
エントリアドレス指定
-e
外部シンボル値の仮設定
-df
ターゲット CPU 指定
-cpu
CPU 情報ファイル指定
-cif
デバッグ情報存在チェック抑止指定
-NCI0302LIB
内蔵 ROM/RAM 領域の自動設定
-set_rora
内蔵 ROM/RAM 領域自動設定の抑止指定
-Xset_rora
ユーザ指定領域のチェック指定
-check_rora
ユーザ指定領域のチェック抑止指定
-Xcheck_rora
セクション配置領域チェック指定
-check_locate
セクション配置領域チェック抑止指定
-Xcheck_locate
ユーザ指定外セクションのチェック指定
-check_section
ユーザ指定外セクションのチェック抑止指定
-Xcheck_section
デフォルト
スタンバイモード遷移命令チェック指定
-check_SCF
デフォルト
スタンバイモード遷移命令チェック抑止指定
-Xcheck_SCF
フェッチ単位チェックの指定
-Wf
引数のレジスタ渡し用ロードモジュール出力指定
-rp
引数のスタック渡し用ロードモジュール出力指定
-Xrp
デフォルト
DIR 属性セクション合計サイズチェック指定
-check_dirsize
デフォルト
DIR 属性セクション合計サイズチェック抑止指定
-Xcheck_dirsize
サイズ 0 のセクション配置チェック指定
-check_size0_sec
サイズ 0 のセクション配置チェック抑止指定
-Xcheck_size0_sec デフォルト
相対アセンブルリスト入力ディレクトリ指定
-alin
絶対アセンブルリスト出力ディレクトリ指定
-alout
絶対アセンブルリスト出力指定
-als
絶対アセンブルリスト出力モジュール指定
-alsf
絶対アセンブルリスト出力抑止指定
-Xals
ROM/RAM, ARRAY リスト出力指定
-alr
ROM/RAM, ARRAY リスト出力モジュール指定
-alrf
July 31, 2015, CM41-00315-6
デフォルト _main
必須
デフォルト
デフォルト
デフォルト
381
付録
付録 D リンカのオプション一覧表
Su pp or t
So ft
Manu al
表 D-1 リンカのオプション一覧表 (3 / 3)
機能
382
オプション
備考
ROM/RAM, ARRAY リスト出力抑止指定
-Xalr
ROM/RAM, ARRAY リストのシンボルとアドレスの表示位置指定
-na/-an
外部シンボル相互参照情報リスト出力指定
-xl
外部シンボル相互参照情報リストファイル名指定
-xlf
外部シンボル相互参照情報リスト出力抑止指定
-Xxl
ローカルシンボルリスト出力指定
-sl
ローカルシンボルリストファイル名の指定
-slf
ローカルシンボルリスト出力抑止指定
-Xsl
セクション詳細マップリスト出力指定
-ml
セクション詳細マップリストファイル名の指定
-mlf
セクション詳細マップリスト出力抑止指定
-Xml
デフォルトオプションファイル読込み抑止指定
-Xdof
*共通オプション
オプションファイル読込み指定
-f
*共通オプション
ヘルプメッセージ表示指定
-help
*共通オプション
版数 / メッセージ出力指定
-V
*共通オプション
版数 / メッセージ出力抑止
-XV
*共通オプション
終了メッセージ表示指定
-cmsg
*共通オプション
終了メッセージ表示抑止指定
-Xcmsg
*共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
*共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
*共通オプション
CM41-00315-6, July 31, 2015
付録
付録 E ライブラリアンのオプション一覧表
Support
付録 E
Soft
Ma nual
ライブラリアンのオプション一覧表
表 E-1 にライブラリアンのオプション一覧を示します。
■ ライブラリアンのオプション一覧
表 E-1 ライブラリアンのオプション一覧表
機能
オプション
備考
モジュールの追加 ( 登録 )
-a
モジュールの置換 ( 登録 )
-r
モジュールの削除
-d
モジュールの抽出
-x
リストファイルの出力指定
-m
リストファイルの出力抑止指定
-Xm
デフォルト
リストファイルの詳細情報の出力指定
-dt
s, d, r, a
リスト 1 ページの行数指定
-pl
デフォルト 60
リスト 1 行の桁数指定
-pw
デフォルト 70
バックアップファイルの作成
-b
バックアップファイルの作成抑止
-Xb
ライブラリファイルの内容検査
-c
ファイル内容の最適化
-O
デバッグ情報の出力指定
-g
デバッグ情報の出力抑止指定
-Xg
ターゲット CPU 指定
-cpu
CPU 情報ファイル指定
-cif
引数のレジスタ渡し用ライブラリ出力指定
-rp
引数のスタック渡し用ライブラリ出力指定
-Xrp
デフォルト
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
オプションファイル読込み指定
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止指定
-XV
* 共通オプション
終了メッセージ出力指定
-cmsg
* 共通オプション
終了メッセージ出力抑止指定
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
July 31, 2015, CM41-00315-6
デフォルト
必須
383
付録
付録 F オブジェクト形式コンバータのコマンドおよびオプショ
ン一覧表
Su pp or t
付録 F
So ft
Manu al
オブジェクト形式コンバータのコマンドおよびオプ
ション一覧表
表 F-1 にオブジェクト形式コンバータのコマンド一覧を , 表 F-2 にオブジェクト形
式コンバータのオプション一覧を示します。
■ オブジェクト形式コンバータのコマンド一覧
表 F-1 オブジェクト形式コンバータのコマンド一覧
コマンド名
384
機能
f2ms
絶対形式ロードモジュール → S フォーマット
f2hs
絶対形式ロードモジュール → HEX8/HEX16/HEX32 フォーマット
f2is
絶対形式ロードモジュール → HEX8 フォーマット
f2es
絶対形式ロードモジュール → HEX16 フォーマット
m2ms
S フォーマット
→ S フォーマット ( 整形 )
h2hs
HEX フォーマット
→ HEX フォーマット ( 整形 )
m2bs
S フォーマット
→ バイナリデータ ( メモリイメージ )
h2bs
HEX フォーマット
→ バイナリデータ ( メモリイメージ )
m2is
S フォーマット
→ HEX8 フォーマット
m2es
S フォーマット
→ HEX16 フォーマット
i2ms
HEX8 フォーマット
→ S フォーマット
e2ms
HEX16 フォーマット
→ S フォーマット
CM41-00315-6, July 31, 2015
付録
付録 F オブジェクト形式コンバータのコマンドおよびオプショ
ン一覧表
Support
Soft
Ma nual
■ オブジェクト形式コンバータのオプション一覧
表 F-2 オブジェクト形式コンバータのオプション一覧
機能
オプション
出力ファイル名の指定 -o
パディングデータ指定
-p
備考
出力範囲指定
-ran
m2ms, h2hs, m2bs, h2bs のみ必須
スプリットモード指定
-sp
m2bs, h2bs のみ
-Xsp
m2bs, h2bs のみ
-m
m2bs, h2bs のみ
-Xm
m2bs, h2bs のみ
-S1, -S2, -S3
f2ms, m2ms のみ
スプリットモード抑止指定
マップリストファイル作成指定
マップリストファイル作成抑止指定
出力ファイル S フォーマット指定
出力ファイル HEX フォーマット指定
-I16, -I20, -I32
スタートアドレスレコード出力指定
-entry
f2hs のみ
スタートアドレスレコード出力抑止指定
-Xentry
f2hs のみ
整形指定
-adjust
f2ms, f2hs のみ
開始アドレス変更指定
デフォルトオプションファイル読込み抑止指定
-ST
f2hs, h2hs のみ
m2ms, h2hs のみ
-Xdof
* 共通オプション
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
-cmsg
* 共通オプション
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
オプションファイル読込み指定
終了メッセージ表示指定
終了メッセージ表示抑止指定
July 31, 2015, CM41-00315-6
385
付録
付録 G OS による仕様の相違点
Su pp or t
付録 G
So ft
Manu al
OS による仕様の相違点
表 G-1 , 表 G-2 , 表 G-3 に , OS による仕様の相違点を示します。
■ OS による仕様の相違点
表 G-1 OS による仕様の相違点
OS 種別
OS 依存項目
UNIX 系 OS
Windows
ファイル名の大文字 / 小文字の区別
する
しない
ファイル名のデフォルト拡張子
小文字
大文字小文字区別なし
環境変数TMP未指定時の作業ディレクトリ /tmp
カレントディレクトリ
コマンドラインのワイルドカードによる シェルで展開されツールに
ツール内部で展開する。
ファイル指定
渡される。
表 G-2 ワイルドカード展開の違い
OS 種別
ワイルドカードパターン
UNIX 系 OS
Windows
?
任意の 1 文字とマッチする。
ヌル文字または任意の 1 文字とマッチ
する。
*
任意の文字列とマッチする。
任意の文字列とマッチする。
表 G-3 ワイルドカード展開の具体例
OS 種別
ワイルドカードパターン
UNIX 系 OS
a1.obj などがマッチする。
a.obj はマッチしない。
a1.obj などがマッチする。
a.obj もマッチする。
a*
a1.obj, a.obj, a.abs…などがマッチ
する。
a1.obj, a.obj, a.abs…などがマッチ
する。
*
abcz, abc.z などがマッチする。
abcz, abc.z などがマッチする。
a?.obj
386
Windows
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
付録 H
Soft
Ma nual
F2MC-16LX スタンバイモード遷移命令チェックツール
F2MC-16LX スタンバイモード遷移命令チェックツールについて詳しく説明します。
なお , V30L10 以降のリンカでは , -cpu で指定された MB 番号からスタンバイモード
遷移命令チェックが必要な品種か判断し , チェックが必要な品種である場合には , ス
タンバイモード遷移命令チェックツールを用いて自動的にチェックを行います。
H.1 F2MC-16LX スタンバイモード遷移命令チェックツールの概要
H.2 スタンバイモード遷移命令チェックツールの操作方法
H.3 チェック手順
H.4 警告メッセージ
H.5 チェック方法
H.6 検出可能なスタンバイモード遷移命令
H.7 スタンバイモード遷移命令チェックツールの制限事項
H.8 スタンバイモード遷移のための低消費電力モード制御レジスタ (LPMCR) へアク
セスする際の注意事項
July 31, 2015, CM41-00315-6
387
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
H.1
So ft
Manu al
F2MC-16LX スタンバイモード遷移命令チェックツールの概要
ここでは , F2MC-16LX スタンバイモード遷移命令チェックツールの概要について説
明します。
■ スタンバイモード遷移命令チェックツールの概要
スタンバイモード遷移命令チェックツールは , F2MC-16LX ファミリ用に開発したプロ
グラム上のスタンバイモード遷移命令を検出するツールです。
SOFTUNE V3 ツールで作成された絶対形式ロードモジュールファイル (ABS ファイル )
内のコードセクションを検索し , 低消費電力モード制御レジスタ (LPMCR:A0 番地 ) を
アクセスしていると考えられる命令を検出します。検出された低消費電力モード制御
レジスタ (LPMCR:A0 番地 ) をアクセスしていると考えられる命令以降の命令列を
チェックし , 適切でない命令列の場合には警告メッセージを出力します。
警告メッセージが出力された箇所については ,「H.8 スタンバイモード遷移のための低
消費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事項」に適合するか判
断していただき,適合する場合には注意事項に記載されている命令列に変更していただ
く必要があります。注意事項の対応が行なわれたスタンバイモード遷移命令に関しま
しては警告メッセージの出力は行なわれません。
また , スタンバイモード遷移命令チェックツールは , お客様のプログラムを静的に
チェックしますので , お客様のプログラムが実行時にレジスタ間接を用いてスタンバ
イモード遷移を行っている場合など ,低消費電力モード制御レジスタ(LPMCR:A0番地)
をアクセスしていると考えられるコードおよび命令が完全に検出できるわけではあり
ません。このような場合には , お客様にてスタンバイモード遷移命令列を確認していた
だく必要があります。
本スタンバイモード遷移命令チェックツールのチェック処理概要および検出可能なス
タンバイモード遷移命令列については「H.5 チェック方法」および「H.6 検出可能な
スタンバイモード遷移命令」を参照してください。
図 H.1-1 スタンバイモード遷移命令チェックツールの機能
絶対形式
ロードモジュール
入力
(.abs)
スタンバイモード
遷移命令チェック
ツール
(SCF_Check.exe)
検出メッセージ
(コンソール)
388
出力
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
H.2
Soft
Ma nual
スタンバイモード遷移命令チェックツールの操作方法
ここでは , スタンバイモード遷移命令チェックツールの起動方法とオプションについ
て説明します。
■ 起動方法
スタンバイモード遷移命令チェックツールは , 以下に示す手順で操作してください。
【書式】
SCF_Check [ < オプション >] < 絶対形式ロードモジュールファイル名 >
絶対形式ロードモジュールファイルのデフォルト拡張子は ".ABS" です。
【例】
SCF_Check module.abs
SCF_Check -Wf module.abs
【説明】
スタンバイモード遷移命令チェックツールを使用するには , 以下の 3 つの方法があ
ります。
• コマンドラインで使用する。
• SOFTUNE Workbench のカスタマイズビルド機能に登録する。
• SOFTUNE Workbench のツールの起動に登録し , 使用する。
■ オプション
スタンバイモード遷移命令チェックツールには , 以下のオプションがあります。
オプション名
説明
フェッチ単位チェックのみ行う。バイト単位チェックは行わない。
-Wf
■ 警告メッセージの出力先
スタンバイモード遷移命令チェックツールの警告メッセージは,標準出力に出力されま
す。
警告メッセージをファイルに記録したい場合には , OS のリダイレクト機能を用いてく
ださい。
【例】
July 31, 2015, CM41-00315-6
SCF_Check
>check.log module.abs
SCF_Check
>check.log -Wf module.abs
389
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
So ft
Manu al
■ コマンドラインで使用する方法
1. SCF_Check.exe を任意のフォルダにコピーします。
2. MS-DOS プロンプト ( コマンドプロンプト ) を起動します。
3. チェック対象の絶対形式ロードモジュールのあるフォルダに移動し , 以下のように
コマンド入力を行います。
SCF_Check.exe をコピーしたフォルダのフルパス名 \SCF_Check 絶対形式ロードモジュール名
【例】
C:\SCF\SCF_Check module.abs
C:\SCF\SCF_Check -Wf module.abs
【実行例】
図 H.2-1 コマンドラインの実行例
コマンド入力
C:\Softune\470\ABS>scf_check mb90470.abs
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC018B,
cpu.c:70)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC019C,
cpu.c:77)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC01AD,
cpu.c:84)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC01ED,
cpu.c:106)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC01F8,
cpu.c:111)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC0203,
cpu.c:116)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC022E,
cpu.c:133)
*** W1378L:適切でないスタンバイモード遷移命令列をフェッチ検索で検出しました (mov io,#imm8, 00FC0239,
cpu.c:138)
*** I0312L:S.C.Fチェックで8個のワーニングが出力されました
C:\Softune\470\ABS>
■ SOFTUNE Workbench のカスタマイズビルド機能に登録する方法
V30L25 以降の SOFTUNE Workbench をご使用の場合 , 以下に示す方法でカスタマイズ
ビルド機能に登録を行えば , ビルド時やメイク時にロードモジュール作成後に自動で
チェックを行います。
登録方法
1. SCF_Check.exe を任意のフォルダにコピーします。
2. SOFTUNE Workbench を起動し , チェック対象のプロジェクトを開きます。
3. SOFTUNE Workbench の [ プロジェクト (P)] メニューの [ カスタマイズビルドの設定
(Z)] をクリックします。
4. [ カスタマイズビルドの設定 ] ダイアログで , [Linker] の [After] を選択し , 新規作成
ボタンをクリックします。
390
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
Soft
Ma nual
図 H.2-2 カスタマイズビルドの設定 1
5. [ カスタマイズビルドの設定 ] ダイアログの [ タイトル (T)], [ 実行ファイル名 (N)] ,
[ オプション (O)] に以下のように入力し , [ 有効 (E)] と [ アウトプットウィンドウを
使用 (U)] をチェックします。
入力例
備考
タイトル (T)
SCF Check
実行ファイル名 (N)
C:¥SCF¥SCF_Check.exe
スタンバイモード遷移命令チェックツー
ルをフルパスで指定
オプション (O)
%(LOADMODULEFILE)
ロードモジュールファイルを指定 ( ロード
モジュールファイル- >フルパス名を指定)
実行時のディレクトリ(Y)
July 31, 2015, CM41-00315-6
-
指定の必要はありません
391
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
So ft
Manu al
図 H.2-3 カスタマイズビルドの設定 2
6. [OK] ボタンをクリックし , [ カスタマイズビルドの設定 ] を終了します。
使用方法
メイクまたはビルドを実行するとスタンバイモード遷移命令チェックツールが自
動的に実行され , 警告メッセージがある場合には , アウトプットウィンドウに以下
のメッセージが出力されます。
【実行例】
図 H.2-4 カスタマイズビルドでの実行例
チェックツールでの警告メッセージです。
※注意事項: チェックツールにて警告メッセージが出力された場合において
も,エラーがない場合には,"エラーは検出されませんでした。"と
出力されますのでご注意願います。
392
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
Soft
Ma nual
■ SOFTUNE Workbench のツールの起動に登録し , 使用する方法
V30L24 以前の SOFTUNE Workbench をご使用の場合は , 以下に示す方法で「ツールの
設定」で「ツールの起動」に登録を行えば , スタンバイモード遷移命令チェックツール
を Workbench から使用できます。
登録方法
1. SCF_Check.exe を任意のフォルダにコピーします。
2. SOFTUNE Workbench を起動します。
3. SOFTUNE Workbench の [ 環境 (S)] メニューの [ ツールの設定 (O)] をクリックします。
4. [ ツールの設定 ] ダイアログで , [ タイトル (T)], [ 実行ファイル名 (N)] , [ オプション
(O)]に以下のように入力し, [アウトプットウィンドウを使用(U)]をチェックします。
入力例
備考
タイトル (T)
SCF Check
実行ファイル名 (N)
C:¥SCF¥SCF_Check.exe
スタンバイモード遷移命令チェックツー
ルをフルパスで指定
オプション (O)
%a
ロードモジュールファイルを指定
実行時のディレクトリ(Y)
C:¥SCF
実行ファイル名 (N) を設定すると自動で設
定されます。
図 H.2-5 ツールの設定
July 31, 2015, CM41-00315-6
393
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
So ft
Manu al
5. [ ツールの設定 ] ダイアログで , [ 設定 (E)] ボタンをクリックしツールを登録します。
6. [OK] ボタンをクリックし , [ ツールの設定 ] を終了します。
スタンバイモード遷移命令チェックツールを使用する時は , 以下のように行います。
使用方法
SOFTUNE Workbench の [ 環境 ] メニューの [ ツールの起動 ] から , [ ツールの設定 ]
で設定したタイトル名を選択してください。
図 H.2-6 使用方法
【実行例】
図 H.2-7 実行例
チェックツールでの警告メッセージです。
※注意事項: チェックツールにて警告メッセージが出力された場合において
も,エラーがない場合には,"エラーは検出されませんでした。"と
出力されますのでご注意願います。
394
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
H.3
Soft
Ma nual
チェック手順
ここでは , スタンバイモード遷移命令チェックツールを用いたチェックの手順につい
て説明します。
■ チェック手順
スタンバイモード遷移命令チェックツールを使用し,以下に示す手順でチェックを行っ
てください。
手順 1
オプションを指定しないでスタンバイモード遷移命令チェックツー
ルにかける。
冗長なメッセージが出力されるかもしれませんが , フェッチ単位
チェック , バイト単位チェックの両方を行い , 疑わしい箇所をすべて
検出します。
これによりチェックの漏れが無くなります。
( ただし , 実行時のレジスタ間接等の検出は除く )
【例】
SCF_Check module.abs
手順 2
警告メッセージが出力された箇所を見直し , 修正するべきところを
修正する。
冗長な警告メッセージに関しては無視してください。
手順 3
-Wf オプションを指定し , 再度チェックを行う。
問題ないことを確認してください。
【例】
SCF_Check -Wf module.abs
見直し / 修正により警告が出なくなるまで , 手順 2 ~手順 3 を繰り返す。
July 31, 2015, CM41-00315-6
395
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
H.4
So ft
Manu al
警告メッセージ
「スタンバイモード遷移のための低消費電力モード制御レジスタ (LPMCR) へアクセ
スする際の注意事項」の対応が行なわれていない可能性があるスタンバイモード遷
移命令列を検出した場合に出力する警告メッセージについて説明します。
■ 警告メッセージ
本スタンバイモード遷移命令チェックツールは ,「スタンバイモード遷移のための低消
費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事項」の対応が行なわれ
ていないスタンバイモード遷移命令列を検出した場合に,以下のようなメッセージを出
力します。
【書式】
警告メッセージ ( 命令パターン 絶対アドレス ソースファイル名 : 行番号 )
警告メッセージ部には , フェッチ単位チェック , バイト単位チェックの 2 つのチェック
方法のうち , どちらのチェックで見つかったかを示すため , "***" の後に "F" または ,
"B" が付加されます。
【フェッチ単位チェックで見つかった場合の例】
*** W1378L: 適切でないスタンダード遷移命令をフェッチ検索で検出しました
(setb io,#imm8 0x00ffffff source filename:line number)
【バイト単位チェックで見つかった場合の例】
*** W1379L: 適切でないスタンダード遷移命令をバイト検索で検出しました
(setb io,#imm8 0x00ffffff source filename:line number)
【備考】
括弧内の補助情報に示される , ソースファイル名・行番号は , デバッグ情報から取
得しています。
デバッグ情報がない場合はソースファイル名 , 行番号は表示されません。
ソースファイル名,行番号を表示させたい場合は,チェック対象プログラムをデバッ
グ情報付きで再ビルドしてください。
396
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
H.5
Soft
Ma nual
チェック方法
ここでは , チェックの方法について説明します。
■ チェック方法
本ツールは「フェッチ単位チェック」と「バイト単位チェック」の 2 つの方法を用い
てチェックを行っています。
■ フェッチ単位チェック
命令のフェッチを行い , 1 命令ずつ取り出し , チェックを行っていく方法です。
フェッチ単位チェックでは , 命令単位でチェックを行っているため , 誤検出による冗長
な警告メッセージが出力される可能性がありませんが , 反面 , コードセクションに命令
以外のデータが出力されていた場合に正しくチェックできない可能性があります。
【例】
コードセクションのバイトイメージ
0x42
0x6C
0x43
0xA0
オペコード , オペランド (16 進 )
•••
命令
0x42, 0x6C
MOV
A,#0x6C
0x43, 0xA0
MOVX
A,#0xA0
・
・
・
「MOV A,#0x6C」をチェック
「MOVX A,#0xA0」をチェック
・
・
・
フェッチ単位チェックで ,「スタンバイモード遷移のための低消費電力モード制御
レジスタ (LPMCR) へアクセスする際の注意事項」の対応が行なわれていないスタ
ンバイモード遷移命令列が検出されると以下の警告メッセージが出力されます。
*** W1378L: 適切でないスタンダード遷移命令をフェッチ検索で検出しました
(movw io,A, 00F90003 module.c:61)
July 31, 2015, CM41-00315-6
397
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
So ft
Manu al
■ バイト単位チェック
命令に関係なく , 1 バイトデータ単位でチェックを行う方法です。
バイト単位チェックでは , 1 バイトずつアドレス更新しながらバイトパターンでチェッ
クを行っているため , 検出漏れは発生しませんが , 反面 , オペランドをオペコードと判
定する場合が考えられ , 冗長な警告メッセージが出力される可能性があります。
冗長なメッセージが出力される可能性がありますので,警告メッセージが出力された箇
所について,本当にスタンバイモード遷移命令列かどうかの判断はプログラム作成者に
お願いすることになります。
【例】
コードセクションのバイトイメージ
0x42
0x6C
0x43
0xA0
オペコード , オペランド (16 進 )
•••
命令
0x42, 0x6C
MOV
A,#0x6C
0x43, 0xA0
MOVX
A,#0xA0
・
・
・
「0x42」をチェック
「0x6C」をチェック
「0x43」をチェック
「0xA0」をチェック
・
・
・
バイト単位チェックで ,「スタンバイモード遷移のための低消費電力モード制御レ
ジスタ (LPMCR) へアクセスする際の注意事項」の対応が行なわれていないスタン
バイモード遷移命令列が検出されると以下の警告メッセージが出力されます。
*** W1379L: 適切でないスタンダード遷移命令をバイト検索で検出しました
(movw io,A, 00F90003 module.c:61)
398
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
Soft
Ma nual
■ スタンバイモード遷移命令を検出しても警告を出力しない場合
本スタンバイモード遷移命令チェックツールは,スタンバイモード遷移命令を検出した
場合でも , 遷移命令の次の命令が以下の命令列の場合には , 警告メッセージを出力しま
せん。
● スタンバイモード遷移命令の直後に表 H.8-3 の命令が記述されている場合
【例】
MOV
LPMCR,#xxh
; スタンバイモード遷移命令
CLRB
EIRR:0
; 表 H.8-3 の命令
MOV
A,#010H
; 任意の命令
・
・
・
● スタンバイモード遷移命令の直後に対策コードが記述されている場合
対策コード:
スタンバイモード遷移命令の直後に 2 個以上の NOP 命令と JMP 系
命令を記述したもの , JMPP, JCTX, RET, RETP, RETI 命令でも良い。
JMP @(@PC+disp16),JMPP @(@PC+disp16) は除く
【例】
MOV LPMCR,#xxh
; スタンバイモード遷移命令
NOP
; 対策コード 1 個目の NOP
NOP
; 対策コード 2 個目の NOP
JMP LABEL
; 対策コード JMP 系命令
MOV A,#010H
; 任意の命令
・
・
・
July 31, 2015, CM41-00315-6
399
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
H.6
So ft
Manu al
検出可能なスタンバイモード遷移命令
ここでは , 検出可能なスタンバイモード遷移命令について説明します。
■ 検出可能なスタンバイモード遷移命令
本ツールは , スタンバイモード遷移命令に以下に示す命令が使用されていた場合 , その
命令以降の命令をチェックし , 警告メッセージを出力します。
表 H.6-1 スタンバイモード遷移命令 1
命令
mov
mov
movw
mov
movw
io, #imm8
dir,#imm8
io,#imm16
addr16,#imm8
ddr16,#imm16
備考
io, dir, addr16 が 0x00A0 か つ , #imm8,
#imm16 の bit4 が 1 かつ , bit7 が 1 または
bit6が1またはbit3が0のとき検出します。
表 H.6-2 スタンバイモード遷移命令 2
命令
setb
setb
setb
io:bp
dir:bp
addr16:bp
備考
io, dir, addr16 が 0x00A0 かつ , bp が 7 ま
たは 6 のとき検出します。
表 H.6-3 スタンバイモード遷移命令 3
命令
clrb
clrb
clrb
io:bp
dir:bp
addr16:bp
備考
io, dir, addr16 が 0x00A0 かつ , bp が 3 の
とき検出します。
表 H.6-4 スタンバイモード遷移命令 4
命令
mov
mov
mov
movw
movw
movw
or
and
orw
andw
400
io,A
dir,A
addr16,A
io,A
dir,A
addr16,A
addr16,A
addr16,A
addr16,A
addr16,A
備考
io, dir, addr16 が 0x00A0 のとき検出しま
す。
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
Soft
Ma nual
表 H.6-5 スタンバイモード遷移命令 5
命令
movb
movb
movb
io:bp,A
dir:bp,A
addr:bp,A
備考
io, dir, addr16 が 0x00A0 かつ , bp が 3 ま
たは 6 または 7 のとき検出します。
<注意事項>
本スタンバイモード遷移命令チェックツールは静的なチェックのみ行っており , 明らかに
低消費電力モード制御レジスタ (LPMCR/ アドレス 0x00A0) への書込みと判断できる命令
のみ検出します。
実効レジスタに低消費電力モード制御レジスタのアドレス (0x00A0) を設定し , そのレジ
スタを用いたレジスタ間接アドレッシングで , スタンバイモード遷移を行う様なプログラ
ムでは , スタンバイモード遷移命令は検出できません。
検出不可能なスタンバイモード遷移命令については「H.7 スタンバイモード遷移命令
チェックツールの制限事項」の「検出不可能なスタンバイモード遷移命令」を参照してく
ださい。
July 31, 2015, CM41-00315-6
401
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
H.7
So ft
Manu al
スタンバイモード遷移命令チェックツールの制限事項
スタンバイモード遷移命令チェックツールの制限事項について説明します。
■ 制限事項
スタンバイモード遷移命令チェックツールには , 表 H.7-1 に示す制限があります。
表 H.7-1 スタンバイモード遷移命令 5
項
制限内容
検出不可能なスタンバイモード遷移命令
本スタンバイモード遷移命令チェックツールは ,「H.6
検出可能なスタンバイモード遷移命令」で示す命令を用
いてスタンバイモード遷移を行っている場合のみスタ
ンバイモード遷移命令の検出を行います。以下の命令を
用いてスタンバイモード遷移を行っている場合は検出
できませんので十分に注意をしてください。
MOV
MOV
MOV
MOV
MOVW
MOVW
MOVW
チェック可能なファイル
402
eam,#imm8
eam, Ri
eam, A
@RLi+disp8, A
eam, RWi
eam, A
@RLi+disp8, A
本スタンバイモード遷移命令チェックツールは ,
SOFTUNE V3 ツールで作成された絶対形式ロードモ
ジュールのみをチェック対象としています。SOFTUNE
V1( 旧ツール ) で作成された絶対形式ロードモジュール
のチェックにはご使用いただけません。
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
H.8
Soft
Ma nual
スタンバイモード遷移のための低消費電力モード制御レ
ジスタ (LPMCR) へアクセスする際の注意事項
ここでは , スタンバイモード遷移のための低消費電力モード制御レジスタ (LPMCR)
へアクセスする際の注意事項について説明します。
■ 注意事項が適用される対象品種
最新のハードウェアマニュアルおよび正誤表に ,「スタンバイモード遷移のための低消
費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事項」が掲載されている
品種。
■ アセンブラ言語を使用して低消費電力モード制御レジスタ (LPMCR) にアクセスす
る場合
低消費電力モード制御レジスタ (LPMCR) においてスタンバイモードに移行する設定を
行う場合は , 表 H.8-1 の命令を使用してください。
表 H.8-1 の命令によるスタンバイモード遷移命令の直後には必ず下記囲み内の命令列
(NOP,NOP,JMP $+3) を配置してください。なお , 表 H.8-2 のスタンバイ制御マクロ命令
をご使用いただければ以下の命令列が配置されます。したがって , プログラム開発の際
には , スタンバイ制御マクロのご使用を推奨します。
MOV
NOP
NOP
JMP
LPMCR, #H'xx ; 表 H.8-1 の低消費電力モード遷移命令
$+3
MOV
; 次の命令へのジャンプ
A, #H'10
; 任意の命令
囲み内の命令列 (NOP,NOP,JMP $+3) 以外が配置されるとスタンバイモード解除後の動
作は保証されません。
ただし , スタンバイモード遷移命令直後に表 H.8-3 に示した命令が存在する場合のみ ,
囲み内の命令列 (NOP,NOP,JMP $+3) が無くても , スタンバイモード解除後の動作は保
証されます。
July 31, 2015, CM41-00315-6
403
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
So ft
Manu al
表 H.8-1 低消費電力モードに遷移する場合に使用する命令一覧
MOV
io, #imm8
MOV
dir, #imm8
MOV
eam, #imm8
MOV
eam, Ri
MOV
io, A
MOV
dir, A
MOV
addr16, A
MOV
eam, A
MOV
@Rli+disp8,A
MOVW
io, #imm16
MOVW
dir, #imm16
MOVW
eam, #imm16
MOVW
eam, RWi
MOVW
io, A
MOVW
dir, A
MOVW
addr16, A
MOVW
eam, A
MOVW
@Rli+disp8,A
SETB
io:bp
SETB
dir:bp
SETB
addr16:bp
CLRB
io:bp
CLRB
dir:bp
CLRB
addr16:bp
■ スタンバイ制御マクロについて
以下のスタンバイ制御マクロをご使用いただければ,スタンバイモード遷移のための低
消費電力モード制御レジスタ (LPMCR) へアクセスする際の注意事項に対応した命令列
となります。したがって , プログラム開発の際には , スタンバイ制御マクロのご使用を
推奨いたします。
表 H.8-2 スタンバイ制御マクロ
404
IO_STOP_HOLD
低消費電力モード制御レジスタ (LPMCR) の SPL ビット =0, STP ビット =1
に設定します。
ストップモードまたは疑似時計モードに遷移します。
外部端子のレベルを保持します。
IO_STOP_Z
低消費電力モード制御レジスタ (LPMCR) の SPL ビット =1, STP ビット =1
に設定します。
ストップモードまたは疑似時計モードに遷移します。
外部端子のレベルをハイインピーダンスにします。
IO_SLEEP
低消費電力モード制御レジスタ (LPMCR) の SLP ビット =1 に設定します。
スリープモードに遷移します。
IO_TMD_HOLD
低消費電力モード制御レジスタ (LPMCR) の SPL ビット =0, STP ビット =1
に設定します。
時計モードに遷移します。外部端子のレベルを保持します。
IO_TMD_Z
低消費電力モード制御レジスタ (LPMCR) の SPL ビット =1, STP ビット =1
に設定します。
時計モードに遷移します。外部端子のレベルをハイインピーダンスにしま
す。
IO_SET_LPMCR IMM
低消費電力モード制御レジスタ (LPMCR) に IMM に指定した値が設定され
ます。
CM41-00315-6, July 31, 2015
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Support
Soft
Ma nual
表 H.8-3 対象命令一覧
ADDC A
ADDDC A
SUBC A
SUBDC A
ADDW A
SUBW A
DIVU A
MULU A
MULUW A
NOT A
ANDW A
ORW A
XORW A
NOTW A
NEG A
NEGW A
ASRW A
LSRW A / SHRW A
LSLW A / SHLW A
SWAP
SWAPW / XCHW A,T
EXTW
MOV A,Ri
MOV A,ear
MOV A,@RWj
MOV A,@RWj+
MOVX A,Ri
MOVX A,ear
MOVX A,@RWj
MOVX A,@RWj+
MOV @RWj,A
MOV @RWj+,A
MOV Ri,@RWj
MOV Ri,@RWj+
MOV @RWj,Ri
MOV @RWj+,Ri
MOV @RWj,#imm8
MOV @RWj+,#imm8
XCH A,@RWj
XCH A,@RWj+
XCH Ri,@RWj
XCH Ri,@RWj+
MOVW A,RWi
MOVW A,ear
MOVW A,@RWj
MOVW A,@RWj+
MOVW @RWj,A
MOVW @RWj+,A
MOVW RWi,@RWj
MOVW RWi,@RWj+
MOVW @RWj,RWi
MOVW @RWj+,RWi
MOVW @RWj,#imm16
July 31, 2015, CM41-00315-6
MOVW @RWj+,#imm16
XCHW A,@RWj
XCHW A,@RWj+
XCHW RWi,@RWj
XCHW RWi,@RWj+
MOVL A,@RWj
MOVL A,@RWj+
MOVL @RWj,A
MOVL @RWj+,A
ADD A,@RWj
ADD A,@RWj+
ADD @RWj,A
ADD @RWj+,A
ADDC A,@RWj
ADDC A,@RWj+
ADDC A,ear
SUB A,@RWj
SUB A,@RWj+
SUB @RWj,A
SUB @RWj+,A
SUBC A,@RWj
SUBC A,@RWj+
SUBC A,ear
ADDW A,@RWj
ADDW A,@RWj+
ADDW @RWj,A
ADDW @RWj+,A
ADDCW A,@RWj
ADDCW A,@RWj+
ADDCW A,ear
SUBW A,@RWj
SUBW A,@RWj+
SUBW @RWj,A
SUBW @RWj+,A
SUBCW A,@RWj
SUBCW A,@RWj+
SUBCW A,ear
ADDL A,@RWj
ADDL A,@RWj+
SUBL A,@RWj
SUBL A,@RWj+
INC @RWj
INC @RWj+
DEC @RWj
DEC @RWj+
INCW @RWj
INCW @RWj+
DECW @RWj
DECW @RWj+
INCL @RWj
INCL @RWj+
DECL @RWj
DECL @RWj+
CMP A,@RWj
CMP A,@RWj+
CMPW A,@RWj
CMPW A,@RWj+
CMPL A,@RWj
CMPL A,@RWj+
MULU A
MULU A,@RWj
MULU A,@RWj+
MULUW A
MULUW A,@RWj
MULUW A,@RWj+
DIVU A,@RWj
DIVU A,@RWj+
DIVUW A,@RWj
DIVUW A,@RWj+
AND A,@RWj
AND A,@RWj+
AND @RWj,A
AND @RWj+,A
OR A,@RWj
OR A,@RWj+
OR @RWj,A
OR @RWj+,A
XOR A,@RWj
XOR A,@RWj+
XOR @RWj,A
XOR @RWj+,A
NOT @RWj
NOT @RWj+
ANDW A,@RWj
ANDW A,@RWj+
ANDW @RWj,A
ANDW @RWj+,A
ORW A,@RWj
ORW A,@RWj+
ORW @RWj,A
ORW @RWj+,A
XORW A,@RWj
XORW A,@RWj+
XORW @RWj,A
XORW @RWj+,A
NOTW @RWj
NOTW @RWj+
ANDL A,@RWj
ANDL A,@RWj+
ORL A,@RWj
ORL A,@RWj+
XORL A,@RWj
XORL A,@RWj+
NEG @RWj
NEG @RWj+
NEGW A
NEGW @RWj
NEGW @RWj+
NRML A,R0
RORC,A
RORC @RWj
RORC @RWj+
ROLC,A
ROLC @RWj
ROLC @RWj+
JMP @(@RWj)
JMP @(@RWj+)
JMPP @(@RWj)
JMPP @(@RWj+)
CALL @(@RWj)
CALL @(@RWj+)
CALLP @(@RWj)
CALLP @(@RWj+)
CALLP @ear
DBNZ @RWj,REL
DBNZ @RWj+,REL
DWBNZ @RWj,REL
DWBNZ @RWj+,REL
INT9
PUSHW A
PUSHW AH
PUSHW PS
AND CCR,#imm8
OR CCR,#imm8
MOVEA RWi,@RWj
MOVEA RWi,@RWj+
MOVEA A,@RWj
MOVEA A,@RWj+
SETB io:bp
CLRB io:bp
CBNE @RWj,#imm8,rel
CWBNE @RWj,#imm16,rel
MUL A,ear
MUL A,@RWj
MUL A,@RWj+
MULW A,RWi
MULW A,@RWj
MULW A,@RWj+
DIV A,@RWj
DIV A,@RWj+
DIVW A,@RWj
DIVW A,@RWj+
MUL A
MULW A
DIV A
405
付録
付録 H F2MC-16LX スタンバイモード遷移命令チェックツール
Su pp or t
So ft
Manu al
● スタンバイ制御マクロを使用せず, C言語にて低消費電力モード制御レジスタ(LPMCR)にア
クセスする場合
低消費電力モード制御レジスタ (LPMCR) においてスタンバイモードに移行する設定を
行う場合は , 以下の 1. から 3. のどれかの方法でアクセスしてください。
1. スタンバイモードに遷移させる命令を関数化し , スタンバイモード遷移命令の後に
__wait_nop() のビルトイン関数を 2 個挿入してください。関数内で , スタンバイ復帰
の割込み以外の割込みが発生する可能性がある場合は , コンパイル時に最適化を実
施し , LINK/UNLINK 命令の発生を抑止してください。
例 ( 時計モードまたはタイムベースタイマモード遷移関数の場合 )
void enter_watch(){
IO_LPMCR.byte = 0x10;
/* LPMCR の TMD ビットに 0 をセット */
__wait_nop();
__wait_nop();
}
2. スタンバイモードに遷移させる命令を __asm 文で記述し , スタンバイモード遷移命
令の後に 2 個の NOP と JMP 命令を挿入してください。
例 ( スリープモード遷移の場合 )
__asm(" MOV
I:_IO_LPMCR, #H'58"); /* LPMCR の SLP ビットに 1 をセット */
__asm(" NOP");
__asm(" NOP");
__asm(" JMP
$+3");
/* 次の命令へのジャンプ */
3. スタンバイモードに遷移させる命令を #pragma asm ~ #pragma endasm 間に記述し ,
スタンバイモード遷移命令の後に 2 個の NOP と JMP 命令を挿入してください。
例 ( ストップモード遷移の場合 )
#pragma asm
MOV
I:_IO_LPMCR, #H'98
/* LPMCR の STP ビットに 1 をセット */
$+3
/* 次の命令へのジャンプ */
NOP
NOP
JMP
#pragma endasm
406
CM41-00315-6, July 31, 2015
付録
付録 I SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a) の
仕様の差異について
Support
付録 I
Soft
Ma nual
SOFTUNE リンカ (flnk907s) と旧版リンカ
(link907a) の仕様の差異について
ここでは , SOFTUNE リンカ (flnk907s) と , 旧版リンカ (link907a) の仕様の差異に
ついて説明します。
■ はじめに
本資料は , SOFTUNE リンカ (flnk907s) と , 旧版リンカ (link907a) の仕様の差異について
述べたものです。
flnk907s は , link907a に比べて以下の点が変更されています。
• コマンドラインの記述方法
• 絶対アセンブルリスト作成機能のリンカへの取り込み
• 制限事項 ( 入力ファイル数 , セクション数 , シンボル数等 ) の緩和
•
•
•
•
環境変数の強化
外部シンボルの相互参照情報リスト作成機能のサポート
シンボルの詳細情報リスト作成機能のサポート
モジュールごとのセクションマップ作成機能のサポート
■ 絶対アセンブルリスト作成機能
旧版ツールでは別製品としていた ,「絶対アセンブルリスト作成ツール (meal907a)」の
機能をリンカに取り込みました。
図 I-1 絶対アセンブルリスト作成機能
ソースプログラム
アセンブラ(fasm907s)
オブジェクト
モジュール
アセンブルリスト
リンカ(flnk907s)
ロードモジュール
July 31, 2015, CM41-00315-6
リンカ出力リスト
絶対形式
アセンブルリスト
407
付録
付録 I SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a) の
仕様の差異について
Su pp or t
So ft
Manu al
■ コマンド行の差異
起動時のコマンドライン指定の差異を表 I-1 と表 I-2 に示します。
表 I-1 リンカの起動形式
flnk907s
link907a
link907a ファイル名 [ オプション ]...
flnk907s [ オプション ]... [ ファイル名 ]
link907a @ オプションファイル
表 I-2 リンカのオプション指定
flnk907s
link907a
オプションの指定位置
どの位置でも可能
ファイル名指定の後
オプションファイルの指定
-f オプションファイル
@オプションファイル
可
不可
flnk907s
link907a
TMP
TMP
インストールパス指定
FETOOL
-
表示文字コード指定
FELANG
-
デフォルトオプションファイル
の格納パス指定
OPT907
-
ライブラリ検索パス指定
LIB907
LIB907
LIB905
LIB902
オプションファイルの複数指定
■ 環境変数
環境変数の差異を表 I-3 に示します。
表 I-3 環境変数
作業用ディレクトリ指定
■ オプション
オプションの差異を表 I-4 と表 I-5 に示します。
表 I-4 リンカのオプション (1 / 3)
408
flnk907s
link907a
入力ファイル名の指定
不要
-LINK
ロードモジュール出力指定
不要
-OBJECT
ロードモジュール出力抑止
-
-NOOBJECT
出力ロードモジュール名の指定
-o
-NAME
CM41-00315-6, July 31, 2015
付録
付録 I SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a) の
仕様の差異について
Support
Soft
Ma nual
表 I-4 リンカのオプション (2 / 3)
flnk907s
link907a
デバッグ情報出力指定
-g
-DEBUG/-DEV
デバッグ情報出力抑止
-Xg
-NODEBUG
絶対形式ロードモジュール出力
-a
-FORM A
相対形式ロードモジュール出力
-r
-FORM R
マップリストファイル名指定
-m
-LIST
-Xm
-NOLIST
リスト表示部の名前省略解除
-dt
-
簡易リンケージリストの指定
-
-BRIEF
リスト 1 ページの行数指定
-pl
-PAGELENGTH
リスト 1 行の桁数指定
-pw
-PAGEWIDTH
外部シンボル相互参照リスト作成
-xl
-CROSS_REFERENCE
外部シンボル相互参照リストファイル名
指定
-xlf
-
外部シンボル相互参照リスト出力抑止
-Xxl
-NOCROSS_REFERENCE
シンボルリスト出力指定
-sl
-LOCAL_SYMBOL
シンボルリストファイル名指定
-slf
-
シンボルリスト出力抑止指定
-Xsl
-
セクション情報マップ出力指定
-ml
-
セクション情報マップファイル名指定
-mlf
-
セクション情報マップ出力抑止
-Xml
-
-
-[NO]ERRORPRINT
ワーニングレベルの設定
-w
-[NO]WARNING
ROM 領域指定
-ro
-ROM_BANK
RAM 領域指定
-ra
-RAM_BANK
セクション配置順 / アドレス指定
-sc
-LOCATE/-SEGMENT
セクショングループ指定
-gr
-
レジスタバンク領域の設定
-rg
-REGISTER_BANK
自動配置指定
-AL
-AUTO_LOCATE
検索ライブラリファイルの指定
-l
-LIBRARY
ライブラリ検索パスの指定
-L
-
シンボル個別のライブラリ検索
-el
-
マップリスト出力抑止
エラー情報ファイルの出力 / 出力抑止
July 31, 2015, CM41-00315-6
409
付録
付録 I SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a) の
仕様の差異について
Su pp or t
So ft
Manu al
表 I-4 リンカのオプション (3 / 3)
flnk907s
link907a
ライブラリ検索機能抑止
-nl
-
デフォルトライブラリ検索抑止
-nd
-
エントリアドレスの指定
-e
-
外部シンボル値の設定
-df
-
-
-RETCODE
オプションファイルの終了
不要
-END
ヘルプの表示
-help
-
ターゲット CPU の指定
-cpu
-CPU
-Xdof
-
-V/-XV
-
ワーニング時の復帰値の変更 / 変更抑止
-cwno/-Xcwno
-
終了メッセージの表示 / 非表示
-cmsg/-Xcmsg
-
不要
-END
ステータスコードのファイル出力
デフォルトオプションファイル入力抑止
起動メッセージの表示 / 非表示
記述終了指定
表 I-5 絶対形式アセンブルリスト出力関連
410
flnk907s
meal907a
入力ディレクトリ指定
-alin
-INPUT
出力ディレクトリ指定
-alout
-OUTPUT
リスト出力指定
-als
-
リスト出力モジュール指定
-alsf
-LIST
リスト出力抑止指定
-Xals
-NOLIST
ROM/RAM, ARRAY リスト出力指定
-alr
-ROM_RAM_LIST
ROM/RAM, ARRAYリスト出力モジュール指定
-alrf
-ROM_RAM_LIST
ROM/RAM, ARRAY リスト出力抑止指定
-Xalr
-NOROM_RAM_LIST
ROM/RAM, ARRAY リスト表示位置指定
-na
-an
-NAME_ADDRESS
-ADDRESS_NAME
CM41-00315-6, July 31, 2015
付録
付録 I SOFTUNE リンカ (flnk907s) と旧版リンカ (link907a) の
仕様の差異について
Support
Soft
Ma nual
■ 制限事項の緩和
処理限界の差異を表 I-6 に示します。
表 I-6 処理限界
flnk907s
link907a
入力ファイル数
65535
1024
結合モジュール数
65535
3000
結合セクション数
65535
8192
外部定義シンボル数
65535
65535
外部参照シンボル数
65535
65535
July 31, 2015, CM41-00315-6
411
付録
付録 J SOFTUNE ライブラリアン (flib907s) と旧版ライブラリ
アン (lib907a) の仕様の差異について
Su pp or t
付録 J
So ft
Manu al
SOFTUNE ライブラリアン (flib907s) と旧版ライブラ
リアン (lib907a) の仕様の差異について
ここでは , SOFTUNE ライブラリアン (flib907s) と旧版ライブラリアン (lib907a) の
仕様の差異について説明します。
■ はじめに
本資料は , SOFTUNE ライブラリアン (flib907s) と , 旧版ライブラリアン (lib907a) の仕
様の差異について述べたものです。
■ コマンド行の差異
起動時のコマンドライン指定の差異を表 J-1 と表 J-2 に示します。
表 J-1 ライブラリアンの起動形式
flib907s
lib907a
flib907s [ オプション ]... [ ファイル名 ]
lib907a ファイル名 [ オプション ]...
lib907a @ オプションファイル
表 J-2 ライブラリアンのオプション指定
flib907s
lib907a
オプションの指定位置
どの位置でも可能
ファイル名指定の後
オプションファイルの指定
-f オプションファイル
@オプションファイル
可
不可
flib907s
lib907a
TMP
TMP
インストールパス指定
FETOOL
-
表示文字コード指定
FELANG
-
デフォルトオプションファイル
の格納パス指定
OPT907
-
オプションファイルの複数指定
■ 環境変数
環境変数の差異を表 J-3 に示します。
表 J-3 環境変数
作業用ディレクトリ指定
412
CM41-00315-6, July 31, 2015
付録
付録 J SOFTUNE ライブラリアン (flib907s) と旧版ライブラリ
アン (lib907a) の仕様の差異について
Support
Soft
Ma nual
■ オプション
オプションの差異を表 J-4 に示します。
表 J-4 ライブラリアンのオプション
flib907s
lib907a
ライブラリファイル作成
-a
-CREATE(-C)
モジュールの追加
-a
-APPEND(-A)
モジュールの置換
-r
-REPLACE(-R)
モジュールの削除
-d
-DELETE(-D)
モジュールの選択
-
-SELECT(-S)
モジュールの抽出
-x
-EXTRACT(-X)
バックアップファイルの作成 / 作成抑止
-b/-Xb
-
デバッグ情報の出力 / 出力抑止
-g/-Xg
-
リストファイルの出力
-m { ファイル名 |-}
- は標準出力
モジュール名リスト出力
-LIST(-L) ファイル名 [, キー
ワード ...]
キーワード
常に出力
[NO]MODULE
セグメント情報リスト出力
-dt s
[NO]SEGMENT
外部定義シンボル情報出力
-dt d -dt a
[NO]PUBLIC
外部参照シンボル情報出力
-dt r -dt a
[NO]EXTRN
リストファイルの出力抑止
-Xm
相互参照リストの作成
-
-CROSS_REFERENCE(-XR)
リスト 1 ページの行数指定
-pl
-
リスト 1 行の桁数指定
-pw
-
.LIB ファイルの内容検査
.LIB ファイル内容の最適化
-c
-
-O
-
エラー情報ファイルの出力 / 出力抑止
-
-[NO]ERRORPRINT (-[NO]RP)
ステータスコードのファイル出力
-
-RETCODE(-RC)
オプションファイルの終了
不要
ヘルプの表示
-help
ターゲット CPU の指定
-cpu
CPU タイプチェック抑止
-END(E)
-CPU
-
-NOCPUTYPECHECK (-NCTC)
-Xdof
-
-V/-XV
-
ワーニング時の復帰値の変更 / 変更抑止
-cwno/-Xcwno
-
終了メッセージの表示 / 非表示
-cmsg/-Xcmsg
-
デフォルトオプションファイル入力抑止
起動メッセージの表示 / 非表示
July 31, 2015, CM41-00315-6
413
付録
付録 J SOFTUNE ライブラリアン (flib907s) と旧版ライブラリ
アン (lib907a) の仕様の差異について
Su pp or t
So ft
Manu al
■ 制限事項の緩和
処理限界の差異を表 J-5 に示します。
表 J-5 処理限界
414
flib907s
lib907a
入力ファイル数
65535
255
結合モジュール数
65535
255
結合セクション数
65535
255
外部定義シンボル数
65535
1536
外部参照シンボル数
65535
1536
CM41-00315-6, July 31, 2015
付録
付録 K SOFTUNE ロードモジュールコンバータ (f2ms, f2hs) と
旧版ロードモジュールコンバータ (lmc907a) の仕様の差異につ
Support
付録 K
Soft
Ma nual
SOFTUNE ロードモジュールコンバータ (f2ms, f2hs)
と旧版ロードモジュールコンバータ (lmc907a) の仕
様の差異について
ここでは , SOFTUNE ロードモジュールコンバータ (f2ms, f2hs) と旧版ロードモ
ジュールコンバータ (lmc907a) の仕様の差異について説明します。
■ はじめに
本資料は , SOFTUNE ロードモジュールコンバータ (f2ms, f2hs) と , 旧版ロードモジュー
ルコンバータ (lmc907a) の仕様の差異について述べたものです。
■ コマンド行の差異
起動時のコマンドライン指定の差異を表 K-1 と表 K-2 に示します。
表 K-1 ロードモジュールコンバータの起動形式
f2ms, f2hs
lmc907a
S
f2ms [オプション]... [ファイル名]
lmc907a ファイル名[オプション]...
HEX
f2hs [ オプション ]... [ ファイル名 ]
lmc907a @ オプションファイル
表 K-2 ロードモジュールコンバータのオプション指定
f2ms, f2hs
lmc907a
オプションの指定位置
どの位置でも可能
ファイル名指定の後
オプションファイルの指定
-f オプションファイル
@オプションファイル
可
不可
f2ms, f2hs
lmc907a
TMP
TMP
インストールパス指定
FETOOL
-
表示文字コード指定
FELANG
-
OPT
-
オプションファイルの複数指定
■ 環境変数
環境変数の差異を表 K-3 に示します。
表 K-3 環境変数
作業用ディレクトリ指定
デフォルトオプションファイル
の格納パス指定
July 31, 2015, CM41-00315-6
415
付録
付録 K SOFTUNE ロードモジュールコンバータ (f2ms, f2hs) と
旧版ロードモジュールコンバータ (lmc907a) の仕様の差異につ
Su pp or t
So ft
Manu al
■ オプション
オプションの差異を表 K-4 に示します。
表 K-4 ロードモジュールコンバータのオプション
f2ms, f2hs
lmc907a
S フォーマットへ変換
f2ms を使用
-FORM(-F) M
HEX フォーマットへ変換
f2hs を使用
-FORM(-F) I
出力ファイル名の指定
-o
-OUTPUT(-O)
出力レコード長の変更
別ツール (m2ms, h2hs) を使用
-LENGTH(-L)
エラー情報ファイルの出力 /
出力抑止
-
-[NO]ERRORPRINT (-[NO]RP)
ステータスコードのファイル
出力
-
-RETCODE(-RC)
オプションファイルの終了
不要
-END(E)
ヘルプの表示
-help
-
デフォルトオプションファイル
入力抑止
-Xdof
-
起動メッセージの表示 / 非表示
-V/-XV
-
ワーニング時の復帰値の変更 /
変更抑止
-cwno/-Xcwno
-
終了メッセージの表示 / 非表示
-cmsg/-Xcmsg
-
■ 変換ツールの追加
SOFTUNE ツールで追加した変換ツールを表 K-5 に示します。
表 K-5 ロードモジュール変換ツール一覧
416
SOFTUNE ツール
旧 16 系ツール
絶対形式ロードモジュール → S フォーマット
f2ms
lmc907a -FORM M
絶対形式ロードモジュール → HEX フォーマット
f2hs
lmc907a -FORM I
絶対形式ロードモジュール → HEX16 フォーマット
f2es
lmc907a -FORM I
絶対形式ロードモジュール → HEX8 フォーマット
f2is
-
S フォーマット → S フォーマット
m2ms
-
HEX フォーマット → HEX フォーマット
h2hs
-
S フォーマット → バイナリ
m2bs
-
HEX フォーマット → バイナリ
h2bs
-
S フォーマット → HEX16 フォーマット
m2es
-
S フォーマット → HEX8 フォーマット
m2is
-
HEX16 フォーマット → S フォーマット
e2ms
-
HEX8 フォーマット → S フォーマット
i2ms
-
CM41-00315-6, July 31, 2015
付録
付録 L SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Support
付録 L
Soft
Ma nual
SOFTUNE 言語ツール移行時のオブジェクト同一性
確認方法
ここでは , SOFTUNE 言語ツール移行時のオブジェクト同一性確認方法について説
明します。
■ はじめに
本資料は , 旧 16 アセンブラ (asm907a) 用のソースプログラムを新アセンブラ (fasm907s)
に移植した際 , 新 / 旧両絶対形式ファイルがバイナリレベルで完全に一致しているかど
うかを調べようとする手順を説明したものです。
■ 比較手順の概略
以下に手順を図示します。
図 L-1 比較手順の概略図
旧絶対形式
ファイル
新絶対形式
ファイル
旧オブジェクト用
ロードモジュール
コンバータ(lmc907a)
新オブジェクト用
ロードモジュール
コンバータ(f2ms)
Sフォーマット
ファイル
Sフォーマット
ファイル
Sフォーマット
アジャスタ(m2ms)
Sフォーマット
アジャスタ(m2ms)
整形済み
Sフォーマット
ファイル
整形済み
Sフォーマット
ファイル
アドレス昇順にソート
1レコードのデータ数を一定化
ファイル比較ツール(fc.exe)
比較リスト
この情報を元に判断します。
新/旧ツールで作成した絶対形式オブジェクトデータを, Sフォーマットに変換します。
S フォーマットアジャスタを用いて S レコードを整形します。
ファイル比較ツールを用いて整形済み S フォーマットファイルを比較します。
July 31, 2015, CM41-00315-6
417
付録
付録 L SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Su pp or t
So ft
Manu al
<注意事項>
1 行目の S0 レコードと , 最終行の S7 レコードに関しては , 違いがあっても無視してくだ
さい。
■ 実施例
旧アセンブラで作成した絶対形式ファイルを "old.abs", 新アセンブラで作成した絶対形
式ファイルを "new.abs" として説明します。
>lmc907a old.abs -o old.mhx
→ 旧絶対形式ファイルを S フォーマットに変換します。
>m2ms old.mhx -o old.ahx -ran 0xff00,0xffff -S3
→ 旧 S フォーマットをソートします。
>f2ms new.abs -o new.mhx
→ 新絶対形式ファイルを S フォーマットに変換します。
>m2ms new.mhx -o new.ahx -ran 0xff00,0xffff -S3
→ 新 S フォーマットをソートします。
>fc old.ahx new.ahx
→ ファイルを比較します。
比較結果につぎのような違いが表示されることがありますが , レコードの先頭が "S0"
あるいは "S7" から始まるデータである場合は無視してください。
このレコードはコメントを表すため , 一致する必要はありません。
【出力例】
>fc old.ahx new.ahx
***** old.ahx
S0080000746573743106
***** new.ahx
S0080000544553543285
*****
<注意事項>
F2MC-16 ファミリが持つ 16M バイトすべてのメモリ空間に渡るデータを , 一度に m2ms
で処理しようとすると , 実行が遅くなる場合があります。
このような場合には , -ran オプションを使用して , ファイルを分割してください。
比較するデータが大きい場合にも , 同様に分割することをお勧めします。
418
CM41-00315-6, July 31, 2015
付録
付録 L SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Support
Soft
Ma nual
■ データに差異が生じている場合
以下に FC の出力例を示します。この情報を元に差異が生じた個所を特定します。
【出力例】
>fc old.ahx new.ahx
***** old.ahx
S31500FF0000000102032C37060708090A0B0C0D0E0F19
***** new.ahx
S31500FF0000000102030405060708090A0B0C0D0E0F73
*****
● S3 レコードからアドレスを求めます。
S3 レコードは以下のフォーマットを持ちます。
S3
データレコード長 (1Byte)
アドレス (4Byte)
↑
データ
CS
↑
S3 はデータレコードを表します。
↑
データの開始アドレスを表します。
チェックサム
* "S3" レコード以外は無視してください。
これより差異が生じているデータのアドレスを求めることができます。
S31500FF0000000102030405060708090A0B0C0D0E0F73
このレコードのデータは 0x00ff0000 番地から配置されています。
これより差異が生じているデータ "0405" は 0xff0005 番地と , 0xff0006 番地に配置され
ているものであることが判ります
● リンクマップを使った問題モジュールの特定
リンクマップを使って , 前述の S3 レコードから求めたアドレスがどのモジュールで記
述されているかを特定します。
リンク時に -mlf オプションと -als オプションの指定が必要です。
mlfオプションは詳細マップ情報を, als オプションは絶対アセンブルリストを作成しま
す。
【出力例】
>flnk907s main sub1 -AL 2
-mlf main.mpm -als
-ro rom=0xff00/0xffff-ra rom=0/0xff
詳細マップ情報 (main.mpm)
Section Mapping List
Module(s)
1. main
2. sub1
S_Addr. -E_Addr. Size
Section Type
00FF0000-00FF000F 00000010 CONST
P RI
00FF0010-00FF001F 00000010 CONST
P RI
Al
02
02
M.No
1
2
Sec.(Top 80)
data
data
この詳細マップ情報により , 該当するアドレス 0xff05, 0xff06 はモジュール番号 1 番
July 31, 2015, CM41-00315-6
419
付録
付録 L SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Su pp or t
So ft
Manu al
"main" というモジュールで定義されていることが判ります。
● 問題個所の特定
リンク時に作成しておいた絶対アセンブルリストから問題の箇所を特定します。
絶対アセンブルリスト (main.als)
SN LOC
OBJ
<main.asm>
MODULE NAME =
da
da
da
da
420
test
00FF00 -------- <data >--------00FF00 00 01 02 03 2C 37 06
00FF07 07 08 09 0A 0B 0C 0D
00FF0E 0E 0F
==
LLINE
=====
1
2
3
4
5
6
7
8
9
SOURCE
.TITLE main
.PROGRAM
main
.SECTION
data,CONST,ALIGN=2
.DATA.B 0,1,2,3,44,55
,6,7,8,9,10,11,12,13,14,15
;data
ends
.END
CM41-00315-6, July 31, 2015
付録
付録 M 関数呼び出しインタフェース変更ガイド
Support
付録 M
Soft
Ma nual
関数呼び出しインタフェース変更ガイド
関数呼び出しインタフェースを変更した場合 , 一部のレジスタの使用方法や関数の
引数の受け渡し方法が変わります。このため , 従来の関数呼び出しインタフェース
( 以降「引数のスタック渡し」とよぶ ) と新しいインタフェース ( 以降「引数のレジ
スタ渡し」とよぶ ) が混在した場合 , 正しく動作しません。
ここでは , プログラムを新しい関数呼び出しインタフェースへ変更する方法と , その
際に注意すべき点について説明します。
■ 新しい関数呼び出しインタフェース
F2MC-16 ファミリ SOFTUNE では , 関数の引数をスタックで受け渡す従来の関数呼び
出しインタフェース (「引数のスタック渡し」) に加え , 関数の引数をレジスタ (RW0,
RW1) で受け渡す新しい関数呼び出しインタフェース (「引数のレジスタ渡し」) をサ
ポートしました。
関数呼び出しインタフェースを「引数のレジスタ渡し」にすると , 一部の引数はレジス
タで受け渡されます。引数がレジスタで受け渡されることにより , コードサイズおよび
スタック使用量が削減され , 実行速度を改善することができます。
しかし ,「引数のレジスタ渡し」と「引数のスタック渡し」とでは引数の受け渡し方法
とレジスタの使用方法が異なっているため , 関数呼び出しインタフェースの異なるオブ
ジェクトを混在して使用するとプログラムが正しく動作しません。このため ,
Workbench/ アセンブラ / リンカ / ライブラリアンは関数呼び出しインタフェースに関す
る矛盾を検出したときに , 警告またはエラーメッセージを出力します。
新しい関数呼び出しインタフェースの詳細または , 使用方法については , 以下のマニュ
アルを参照してください。
• F2MC-16 ファミリ SOFTUNE C コンパイラマニュアル
「関数呼び出しインタフェース ( 引数のレジスタ渡し )」
「スタックフレーム ( 引数のレジスタ渡し )」
「引数 ( 引数のレジスタ渡し )」
「引数の拡張形式 ( 引数のレジスタ渡し )」
「呼び出し手続き ( 引数のレジスタ渡し )」
「レジスタ ( 引数のレジスタ渡し )」
「戻り値 ( 引数のレジスタ渡し )」
• F2MC-16 ファミリ SOFTUNE アセンブラマニュアル
「-rp, -Xrp」
「.REG_PASS 命令」
• F2MC-16 ファミリ SOFTUNE リンケージキットマニュアル
「リンカでの関数呼び出しインタフェースの異なるオブジェクトの混在について」
「引数のレジスタ渡し用ロードモジュール指定オプション (-rp)」
「引数のスタック渡し用ロードモジュール指定オプション (-Xrp)」
「ライブラリアンでの関数呼び出しインタフェースの異なるオブジェクトの混在に
ついて」
July 31, 2015, CM41-00315-6
421
付録
付録 M 関数呼び出しインタフェース変更ガイド
Su pp or t
So ft
Manu al
「引数のレジスタ渡し用ライブラリ出力指定オプション (-rp)」
「引数のスタック渡し用ライブラリ出力指定オプション (-Xrp)」
• F2MC-16 ファミリ SOFTUNE Workbench 操作マニュアル
「プロジェクトの登録」
「プロジェクトの設定」-「一般」
■ 関数呼び出しインタフェースの変更の流れ
関数呼び出しインタフェースを「引数のスタック渡し」から「引数のレジスタ渡し」へ
変更するときは , 以下の手順で行ってください。
図 M-1 関数呼び出しインタフェースの変更の流れ
アセンブラソースを修正してください。 例) startup.asm
(「アセンブラソースの修正」を参照してください)
Workbenchを使用してビルドしていますか?
Yes
No
プロジェクトの関数呼び出しインタ
フェースを「引数のレジスタ渡し」
に変更して再ビルドしてください。
(「Workbenchでの変更」を参照し
てください)
コンパイラ/アセンブラ/リンカ/ライ
ブラリアンすべてに-rpオプションを
指定して再ビルドしてください。
(「Workbenchを使用しない場合の変
更」 を参照してください)
■ 関数呼び出しインタフェースの変更の詳細
● アセンブラソースの修正
関数呼び出しインタフェースを「引数のスタック渡し」から「引数のレジスタ渡し」へ
変更するときは , 以下の手順でアセンブラソースの修正を行ってください。
1) .REG_PASS 擬似命令の記述
アセンブラは , -rp オプションが指定されたとき , 引数のレジスタ渡し用オブジェク
トを出力します。しかし , -rp オプションの指定のみでは , 入力アセンブラソースが ,
引数のレジスタ渡し用か引数のスタック渡し用かを判別できません。
REG_PASS 擬似命令は , アセンブラソースが引数のレジスタ渡し用アセンブラソー
ス で あ る こ と を 示 す 擬 似 命 令 で す。ア セ ン ブ ラ は , -rp オ プ シ ョ ン 指 定 時 に
.REG_PASS 擬似命令の記述がないアセンブラソースをアセンブルするとエラーを
出力します。引数スタック渡し用アセンブラソースを引数のレジスタ渡し用アセ
ンブラソースに変更する場合 , .REG_PASS 擬似命令を記述してください。記述位
置は , .END 擬似命令以前であればどの位置でも記述可能です。
【.REG_PASS 擬似命令の記述例】
.PROGRAM
422
_func
CM41-00315-6, July 31, 2015
付録
付録 M 関数呼び出しインタフェース変更ガイド
Support
.TITLE
Soft
Ma nual
_func
; register argument passing
.REG_PASS
:
2) 引数の受け渡し方法の変更
アセンブラソースに , 引数を持つ関数の定義および , 引数を持つ関数の呼び出しが
あるとき,引数の受け渡し方法を「引数のレジスタ渡し」に変更する必要があります。
C コンパイラのアセンブラ記述機能 (asm 文 ) で , 引数を持つ関数の定義および , 引
数を持つ関数の呼び出しを行う場合にも , 同様な修正が必要です。
引数の受け渡し方法を「引数のレジスタ渡し」に変更する場合は , F2MC-16 ファミ
リ SOFTUNE C コンパイラマニュアル「引数 ( 引数のレジスタ渡し )」の表にした
がって変更してください。
【引数を持つ関数の定義の修正例】
( 引数のスタック渡し )
( 引数のレジスタ渡し )
_func:
LINK
MOVW
ADDW
ADDW
MOVW
_func:
LINK
MOVW
MOVW
ADDW
ADDW
MOVW
#0
A,
A,
A,
_var,
@RW3+4
@RW3+6
@RW3+8
A
:
#0
RW4,
A,
A,
A,
_var,
@RW3+4
RW0
RW1
RW4
A
:
【引数を持つ関数の呼び出しの修正例】
( 引数のスタック渡し )
:
MOVW
PUSHW
MOVW
PUSHW
MOVW
PUSHW
CALL
ADDSP
:
( 引数のレジスタ渡し )
A,
#3
A
A,
#2
A
A,
#1
A
_func
#6
:
MOVW
PUSHW
MOVW
MOVW
MOVW
MOVW
CALL
POPW
:
A,
A
A,
RW1,
A,
RW0,
_func
AH
#3
#2
A
#1
A
補足 ) 「引数のスタック渡し」と「引数のレジスタ渡し」のアセンブラソースの兼
用方法
既定義マクロ "__REG_PASS__" を使用することで ,「引数のスタック渡し」と「引
数のレジスタ渡し」で兼用のアセンブラソースを作成できます。
既定義マクロ "__REG_PASS__" は , -rp オプションを指定してアセンブルされた場
合に 1 を設定し , -rp オプションが指定されずにアセンブルされた場合に 0 を設定し
ます。
【既定義マクロ "__REG_PASS__" の記述例】
July 31, 2015, CM41-00315-6
.PROGRAM
_func
.TITLE
_func
423
付録
付録 M 関数呼び出しインタフェース変更ガイド
Su pp or t
So ft
Manu al
#if __REG_PASS__
; register argument passing
.REG_PASS
#endif
:
<注意事項>
関数呼び出しインタフェースが「引数のレジスタ渡し」のとき , レジスタ RW0, RW1 の
関数からの復帰時の値は保証されません。関数呼び出しをまたがってこれらのレジスタを
使用しないようにしてください。
● Workbench での変更
プロジェクトの関数呼び出しインタフェースを「引数のスタック渡し」に変更してく
ださい。
関数呼び出しインタフェースで ,「引数のレジスタ渡し」が選択された場合は , コンパ
イラ / アセンブラ / リンカおよびライブラリアン起動時に -rp オプションが自動的に適
用されます。
1) 現在のプロジェクトの設定を変更する場合
[ プロジェクトの設定 ] ダイアログにおいてプロジェクトの関数呼び出しインタ
フェースを「引数のレジスタ渡し」に変更してください。
図 M-2 プロジェクトの設定ダイアログ
2) 新規に作成するプロジェクトの設定を変更する場合
プロジェクトの [ 新規作成 ] ダイアログでは , デフォルトとして「引数のスタック
渡し」が選択されます。関数呼び出しインタフェースを「引数のレジスタ渡し」に
424
CM41-00315-6, July 31, 2015
付録
付録 M 関数呼び出しインタフェース変更ガイド
Support
Soft
Ma nual
変更してください。
図 M-3 プロジェクトの新規作成ダイアログ
<注意事項>
関数呼び出しインタフェースとして「引数のレジスタ渡し」を選択した場合 , デバッガの
操作にいくつかの制限があります。これらの制限は , 引数を持つ関数から呼び出され , コ
ンパイラの最適化により LINK/UNLINK 命令が出力されない関数をデバッグする時の制限
になります。
• ステップアウト (GO/RETURN コマンド ) の操作
親関数の取得ができなくなるため , 正常にプログラムの実行が停止しません。
• コールスタック (SHOW CALLS コマンド ) の操作
親関数の取得ができなくなるため , その関数以降の親関数が正しく表示されません。
• UP コマンドの操作
親関数の取得ができなくなるため , その関数以降の親関数へ正しくスコープを移すこ
とができません。
July 31, 2015, CM41-00315-6
425
付録
付録 M 関数呼び出しインタフェース変更ガイド
Su pp or t
So ft
Manu al
● Workbench を使用しない場合の変更
1) Workbench を使用しない場合の変更
Workbench を使用しない場合は , コンパイラ / アセンブラ / リンカ / ライブラリアン
すべてに -rp オプションを指定してください。
2) コンパイル / アセンブル時の変更
関数のプロトタイプ宣言がない関数を呼び出す場合の動作は保証できないため , す
べての関数について関数のプロトタイプ宣言を行ってください。
引数レジスタ退避域は , スタックで渡された仮引数領域とは連続しません。連続す
ることを期待するようなプログラムは正しく動作しないため , そのようなプログラ
ムがある場合は修正をしてください。
可変個引数は , 従来の関数呼び出しインタフェースと同様にすべての引数がスタッ
ク渡しとなるため修正の必要はありません。
3) リンクおよびライブラリ作成時の変更
「引数のレジスタ渡し」用に以下の C ライブラリを追加しました。
「引数のレジスタ渡し」をお使いになる場合には , 以下の "_rp" 付きのライブラリを
リンクしてお使いください。
• lib/907/lib9*_rp.lib: 48 ファイル
426
CM41-00315-6, July 31, 2015
付録
付録 M 関数呼び出しインタフェース変更ガイド
Support
Soft
Ma nual
■ 警告とエラーメッセージ
Workbench/ アセンブラ / リンカ / ライブラリアンで , 関数呼び出しインタフェースに関
する矛盾を検出した場合 , 以下の警告または , エラーメッセージを出力します。
● Workbench の警告メッセージ
• プロジェクト追加時
I0227W
ワークスペース内に関数呼び出しインタフェースが異なるプロジェクト
が存在します。
関数呼び出しインタフェースが異なるプロジェクトで作成したオブジェ
クト同士は混在できません。処理を続行しますか ?
YES:プロジェクトを追加する。
NO :プロジェクトを追加しない。
• プロジェクト間の依存関係 ( サブプロジェクト ) 設定時
I0228W
プロジェクト間の関数呼び出しインタフェースが異なります。
関数呼び出しインタフェースが異なるプロジェクトで作成したオブジェ
クト同士は混在できません。処理を続行しますか ?
YES:プロジェクト間の依存関係を設定する。
NO :プロジェクト間の依存関係を設定しない。
• 関数呼び出しインタフェース変更時
I0229W
関数呼び出しインタフェースを変更する場合は , 使用するアセンブラ
ソース , オブジェクト , ライブラリの関数呼び出しインタフェースが統
一されている必要があります。関数呼び出しインタフェースが統一され
ていないプログラムの動作は保証されません。
この変更はプロジェクト内のすべてのプロジェクト構成に反映されま
す。変更しますか ?
YES:関数呼び出しインタフェースを変更する。
NO :関数呼び出しインタフェースを変更しない。
July 31, 2015, CM41-00315-6
427
付録
付録 M 関数呼び出しインタフェース変更ガイド
Su pp or t
So ft
Manu al
● アセンブラのエラーメッセージ
E4718A
関数呼び出しインタフェースが違います
本エラーメッセージは , 以下の付表 M-1 に示す条件で出力されます。
付表 M-1 .REG_PASS 擬似命令の記述と -rp オプションの関係
.REG_PASS 擬似命令の記述
あり
あり
「引数のレジスタ渡し」の正常な
組み合わせです。
エラーは出力しません。
-rp オプション指定
なし
エラー (E4718A) を出力します。
なし
エラー (E4718A) を出力します。
「引数のスタック渡し」の正常な
組み合わせです。
エラーは出力しません。
本エラーが発生した場合は , 付表 M-1 を参照して -rp オプション指定または , アセンブラソースの .
REG_PASS 擬似命令の記述を修正してください。
● リンカのエラーメッセージ
E4313L
関数呼び出しインタフェースの異なるモジュールがあります
( ファイル名 )
本エラーメッセージは , 以下の付表 M-2 に示す条件で出力されます。
付表 M-2 入力オブジェクトと -rp オプションの関係
入力オブジェクトの関数呼び出しインタフェース
「引数のレジスタ渡し」
「引数のスタック渡し」
あり
「引数のレジスタ渡し」の正常な
組み合わせです。
エラーは出力しません。
エラー (E4313L) を出力します。
なし
エラー (E4313L) を出力します。
「引数のスタック渡し」の正常な
組み合わせです。
エラーは出力しません。
-rp オプション指定
本エラーが発生した場合 , 付表 M-2 を参照して -rp オプション指定または , 入力オブジェクトの関数呼
び出しインタフェースを修正してください。
428
CM41-00315-6, July 31, 2015
付録
付録 M 関数呼び出しインタフェース変更ガイド
Support
Soft
Ma nual
● ライブラリアンエラーメッセージ
E4410U
関数呼び出しインタフェースの異なるモジュールがあります
( ファイル名 )
本エラーメッセージは , 以下の付表 M-3 に示す条件で出力されます。
付表 M-3 入力オブジェクト , 編集対象ライブラリと -rp オプションの関係
入力オブジェクトと編集対象ライブラリの
関数呼び出しインタフェース
「引数のレジスタ渡し」
あり
「引数のレジスタ渡し」の正常な
組み合わせです。
エラーは出力しません。
なし
エラー (E4410U) を出力します。
-rp オプション指定
「引数のスタック渡し」
エラー (E44410U) を出力します。
「引数のスタック渡し」の正常な
組み合わせです。
エラーは出力しません。
本エラーが発生した場合 , 付表 M-3 を参照して -rp オプション指定または , 入力オブジェクト , 編集対
象ライブラリの関数呼び出しインタフェースを修正してください。
<注意事項>
関数呼び出しインタフェースの異なるオブジェクトをリンクすることはできません。以下
の弊社提供オブジェクトの関数呼び出しインタフェースは ,「引数のスタック渡し」のみ
となっているため注意してください。
• モニタデバッガ
July 31, 2015, CM41-00315-6
429
付録
付録 N 主な変更内容
Su pp or t
付録 N
So ft
Manu al
主な変更内容
ページ
場所
変更箇所
Revision 5.1
-
-
社名変更および記述フォーマットの変換
Revision 5.2
8
1.5 起動メッセージ
社名部分を削除
34
3.2.4
社名部分を削除
89
5.14
5.14 未使用関数削除を追加
93
6.1
表 6.1-1 に未使用関数削除機能関連オプションとして ,
-lnkopt -entryc -Xdel -ufiin を追加
93
6.1
-Xcheck_dirsize の備考欄を削除
95
6.2
■未使用関数削除機能関連オプションを追加
100
6.2.5
【説明】内に -AL オプション指定に関する記載を追加
125
6.2.20
【説明】内に相対形式のロードモジュール作成時の AL オプション指定に関する記載を追加
132
6.2.26
6.2.26 未使用関数削除指定 (-lnkopt) を追加
134
6.2.27
6.2.27 C ソースのプログラム実行開始シンボル指定
(-entryc) を追加
135
6.2.28
6.2.28 削除対象外関数指定 (-Xdel) を追加
136
6.2.29
6.2.29 未使用関数削除情報ファイル格納パス指定
(-ufiin) を追加
192
7.2.2
S-Addr E-Addr Size に未使用関数削除時の表示
193
7.2.2
■ 未使用関数削除機能により削除されたセクションの
マップリスト表示例を追加
196
7.2.4
Symbol Value に未使用関数削除時の表示
197
7.2.4
■ 削除された関数のシンボルリスト表示例追加
201
7.3.2
*2 のアドレスに未使用関数削除時の表示を追加
202
7.3.2
例 2 を追加
203
7.3.3
*2 のロケーションに未使用関数削除時の表示を追加
204
7.3.3
例 2 を追加
207
7.3.5
*3 の値に未使用関数削除時の表示を追加
208
7.3.5
例 2 を追加
209
7.4
図 7.4-1 に未使用関数として削除された例を追加
209
7.4
● type/value に未使用関数削除時の表示を追加
Revision 6.0
430
CM41-00315-6, July 31, 2015
付録
付録 N 主な変更内容
Support
ページ
場所
Soft
Ma nual
変更箇所
210
7.5
図 7.5-1 の func2 を未使用関数として削除された例に
変更
211
7.5
● val に未使用関数削除時の表示を追加
211
7.5
注意事項を● val から全体の注意事項に変更
212
7.6
図 7.6-1 に未使用関数として削除された例を追加
212
7.6
● S.Addr.-E.Addr. と ● Size に未使用関数削除時の表
示を追加
287
15.3.1
【説明】の記載内容を変更
287
15.3.1
【注意】に -S1, -S2, -S3 いずれも指定しない場合を追加
287
15.3.1
表 15.3-1 に「指定なし」を追加
341
付録 A E4305L 枠外
未使用関数削除機能の場合を追加
380, 381
付録 D
表 D-1 に -lnkopt -entryc -Xdel -ufiin を追加
July 31, 2015, CM41-00315-6
431
付録
付録 N 主な変更内容
Su pp or t
432
So ft
Manu al
CM41-00315-6, July 31, 2015
索引
Support
Soft
Ma nual
索引
A
-a
絶対形式ロードモジュールの出力指定 (-a) ........99
モジュールの追加 ( 登録 )(-a) .............................239
-adjust
整形指定 (-adjust) ..........................................286, 292
-AL
-AL 1 が指定された場合の配置例 ........................68
-AL 2 が指定された場合の配置例 ........................70
自動配置指定 (-AL) ..............................................125
-alin
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................167
-alout
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................168
-alr
ROM/RAM,ARRAY リスト出力指定 (-alr) ........172
-alrf
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................173
-als
絶対アセンブルリスト出力指定 (-als) ...............169
-alsf
絶対アセンブルリスト出力モジュール指定
(-alsf) .................................................................170
-an
ROM/RAM,ARRAY リストのシンボルとアドレス
の表示位置指定 (-na,-an) ...............................175
ARRAY リスト
ROM/RAM,ARRAY リスト .................................201
ROM/RAM,ARRAY リスト出力指定 (-alr) ........172
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................173
ROM/RAM,ARRAY リスト出力抑止指定
(-Xalr) ...............................................................174
ROM/RAM,ARRAY リストのシンボルとアドレス
の表示位置指定 (-na,-an) ...............................175
B
-b
バックアップファイルの作成 (-b) ......................248
-check_rora
ユーザ指定領域のチェック指定
(-check_rora) ....................................................144
-check_SCF
スタンバイモード遷移命令チェック指定
(-check_SCF) ....................................................154
-check_section
ユーザ指定外セクションのチェック指定
(-check_section) ............................................... 151
-check_size0_sec
サイズ 0 のセクション配置チェック指定
(-check_size0_sec) ...........................................164
-cif
CPU 情報ファイル指定 (-cif) ......................140, 255
-cmsg
終了メッセージ表示指定 (-cmsg) .........................36
-cmsg オプション
-cmsg オプション ....................................................29
終了メッセージと -cmsg オプション ..................... 9
CPU
-cpu オプションとオブジェクト混在可能
CPU 一覧 ...................................................87, 232
CPU 情報ファイル ..................................................86
CPU 情報ファイル指定 (-cif) ......................140, 255
CPU 情報ファイル名 .............................................. 86
ターゲット CPU 指定 (-cpu) ........................139, 254
-cpu
ターゲット CPU 指定 (-cpu) ........................139, 254
-cpu オプション
-cpu オプションとオブジェクト混在可能
CPU 一覧 ...................................................87, 232
CPU 情報ファイル
CPU 情報ファイル ..................................................86
CPU 情報ファイル名 .............................................. 86
CPU 情報ファイル指定
CPU 情報ファイル指定 (-cif) ......................140, 255
-cs
ROM 領域のチェックサム指定 (-cs) .................. 109
-cwno
ワーニング発生時の終了コードを 1 にする指定
(-cwno) ...............................................................38
-cwno オプション
-cwno オプション ................................................... 29
C ソース
C ソースのプログラム実行開始シンボル指定
(-entryc) ...........................................................134
C
D
-c
ライブラリファイルの内容検査 (-c) ..................250
-check_dirsize
DIR 属性セクション合計サイズチェック指定
(-check_dirsize) ................................................162
-check_locate
セクション配置領域チェック指定
(-check_locate) .................................................147
July 31, 2015, CM41-00315-6
-d
モジュールの削除 (-d) .........................................241
-df
外部シンボル値の仮設定 (-df) ............................138
DIR 属性セクション
DIR 属性セクション
合計サイズチェックについて ........................ 85
DIR 属性セクションの配置について .................. 83
433
索引
Su pp or t
DIR 属性セクション合計サイズチェック指定
DIR 属性セクション合計サイズチェック指定
(-check_dirsize) ................................................162
DIR 属性セクション合計サイズチェック抑止指定
DIR 属性セクション合計サイズチェック抑止指定
(-Xcheck_dirsize) .............................................163
-dt
リスト表示の名前の省略解除 (-dt) ....................105
リストファイルの詳細情報の出力指定
(-dt) ...................................................................245
E
-e
エントリアドレスの指定 (-e) ..............................137
e2ms
e2ms(HEX16 フォーマット
→ S フォーマット変換 ) ................................325
-el
シンボル個別のライブラリの指定 (-el) .............129
-entry
スタートアドレス出力指定 (-entry) ...................286
スタートアドレスレコード出力指定
(-entry) ..............................................................289
-entryc
C ソースのプログラム実行開始シンボル指定
(-entryc) ............................................................134
F
-f
オプションファイルからの読込み指定
(-f) .......................................................................31
f2es
f2es( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................296
f2hs
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................294
f2is
f2is( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................295
f2ms
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ................................293
FELANG
FELANG .............................................................13, 15
FETOOL
FETOOL .............................................................13, 16
-fill
ROM 領域のフィル指定 (-fill) .............................101
-f オプション
-f オプション ...........................................................29
G
So ft
Manu al
H
-help
ヘルプメッセージの表示 (-help) .......................... 33
-help オプション
-help オプション ..................................................... 29
HEX16
エンドレコード (HEX8/HEX16/HEX32) ............366
拡張セグメントアドレスレコード
(HEX16/HEX32) .............................................. 367
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................. 368
データレコード (HEX8/HEX16/HEX32) ............365
HEX16 フォーマット
e2ms(HEX16 フォーマット
→ S フォーマット変換 ) ............................... 325
f2es( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ...................... 296
m2es(S フォーマット
→ HEX16 フォーマット変換 ) ...................... 323
HEX32
エンドレコード (HEX8/HEX16/HEX32) ............366
拡張セグメントアドレスレコード
(HEX16/HEX32) .............................................. 367
拡張リニアアドレスレコード (HEX32) ............369
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................. 368
スタートリニアアドレスレコード
(HEX32) ...........................................................370
データレコード (HEX8/HEX16/HEX32) ............365
HEX8
エンドレコード (HEX8/HEX16/HEX32) ............366
データレコード (HEX8/HEX16/HEX32) ............365
HEX8 フォーマット
f2is( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................ 295
i2ms(HEX8 フォーマット
→ S フォーマット変換 ) ............................... 324
m2is(S フォーマット
→ HEX8 フォーマット変換 ) ........................ 322
HEX フォーマット
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) .......................... 294
出力 HEX フォーマット指定
(-I16/-I20/-I32) ......................... 286, 288, 302, 307
I
-I
出力 HEX フォーマット指定
(-I16/-I20/-I32) ......................... 286, 288, 302, 307
i2ms
i2ms(HEX8 フォーマット
→ S フォーマット変換 ) ............................... 324
L
-g
デバッグ情報の出力指定 (-g) ........................97, 252
-L
セクショングループの指定 (-gr) ........................122
-l
ライブラリ検索パスの指定 (-L) .........................128
-gr
検索ライブラリファイルの指定 (-l) .................. 127
434
CM41-00315-6, July 31, 2015
索引
Support
Soft
-len
出力レコードデータ長指定 (-len) .......................302
出力レコード内データ長指定 (-len) ...................303
LIB907
LIB907 ......................................................................17
LIB907 ( ライブラリファイル検索ディレクトリ )
.............................................................................13
-lnkopt
未使用関数削除指定 (-lnkopt) .............................132
LPMCR
アセンブラ言語を使用して低消費電力モード制御
レジスタ
(LPMCR) にアクセスする場合 .....................403
Ma nual
OPT( デフォルトオプションファイル
格納ディレクトリ ) .......................................... 13
OPT907
OPT907 ..................................................................... 18
OPT907 ( デフォルトオプションファイル
格納ディレクトリ ) .......................................... 13
OS
OS による仕様の相違点 ...................................... 386
P
-p
パディング (-p) ..................................................... 281
-pl
M
リスト 1 ページの行数指定 (-pl) ................108, 246
-pw
リスト 1 行の桁数指定 (-pw) ..............................247
リスト行の桁数指定 (-pw) ..................................107
-m
マップリストファイルの作成指定
(-m) ...........................................................313, 317
マップリストファイル名の指定 (-m) ................103
リストファイルの出力指定 (-m) ........................243
m2es
m2es(S フォーマット
→ HEX16 フォーマット変換 ) ......................323
m2is
m2is(S フォーマット
→ HEX8 フォーマット変換 ) ........................322
-ml
セクション詳細マップリスト出力指定
(-ml) ..................................................................183
-mlf
セクション詳細マップリストファイル名の指定
(-mlf) .................................................................184
-mmi
メモリ使用情報リストの出力指定
(-mmi) ...............................................................106
N
-na
ROM/RAM,ARRAY リストのシンボルとアドレス
の表示位置指定 (-na,-an) ...............................175
-NCI0302LIB
デバッグ情報存在チェック抑止指定
(-NCI0302LIB) .................................................141
-nd
デフォルトライブラリ検索の抑止指定
(-nd) ..................................................................131
-nl
ライブラリ検索の抑止指定 (-nl) ........................130
O
-O
ファイル内容の最適化 (-O) .................................251
-o
出力ファイル名の変更 (-o) ..................................279
出力ロードモジュールファイル名指定
(-o) ......................................................................96
OPT
OPT ...........................................................................19
July 31, 2015, CM41-00315-6
R
-r
相対形式ロードモジュールの出力指定
(-r) ..................................................................... 100
モジュールの置換 ( 登録 )(-r) ............................. 240
-ra
RAM 領域の指定 (-ra) .......................................... 118
RAM
RAM 領域の指定 (-ra) .......................................... 118
ROM/RAM,ARRAY リスト ................................. 201
ROM/RAM,ARRAY リスト出力指定
(-alr) .................................................................. 172
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) ................................................................. 173
ROM/RAM,ARRAY リスト出力抑止指定
(-Xalr) ...............................................................174
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ............... 175
ROM/RAM 領域の設定とセクション配置 ..........79
ROM/RAM 領域名 ..................................................86
ROM および RAM 領域の指定 ............................. 56
ROM → RAM 転送セクション ............................. 80
ROM → RAM 転送セクションの使用方法 ......... 80
ROM → RAM 転送セクションの注意 ................. 81
内蔵 ROM/RAM 領域自動設定の抑止指定 ......... 86
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) ......................................................143
内蔵 ROM/RAM 領域の自動設定
(-set_rora) .........................................................142
-ran
出力範囲指定 (-ran) ...................... 302, 304, 313, 314
-rg
レジスタバンク領域の指定 (-rg) ........................ 123
-ro
ROM 領域の指定 (-ro) .......................................... 117
ROM
ROM/RAM,ARRAY リスト ................................. 201
ROM/RAM,ARRAY リスト出力指定
(-alr) .................................................................. 172
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) ................................................................. 173
435
索引
Su pp or t
So ft
Manu al
ROM/RAM,ARRAY リスト出力抑止指定
(-Xalr) ...............................................................174
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ...............175
ROM/RAM 領域の設定とセクション配置 ..........79
ROM/RAM 領域名 ..................................................86
ROM および RAM 領域の指定 .............................56
ROM 化支援 .............................................................56
ROM 領域の指定 (-ro) ..........................................117
ROM 領域のチェックサム指定 (-cs) ..................109
ROM 領域のフィル指定 (-fill) .............................101
ROM → RAM 転送セクション .............................80
ROM → RAM 転送セクションの
使用方法 ............................................................80
ROM → RAM 転送セクションの注意 .................81
内蔵 ROM/RAM 領域自動設定の
抑止指定 ............................................................86
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) .......................................................143
内蔵 ROM/RAM 領域の自動設定
(-set_rora) .........................................................142
ROM/RAM,ARRAY リスト出力指定
ROM/RAM,ARRAY リスト出力指定
(-alr) ..................................................................172
ROM/RAM,ARRAY リスト出力モジュール指定
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................173
ROM/RAM,ARRAY リスト出力抑止指定
ROM/RAM,ARRAY リスト出力抑止指定
(-Xalr) ...............................................................174
ROM 化支援
ROM 化支援 .............................................................56
ROM → RAM 転送セクション
ROM → RAM 転送セクション .............................80
ROM → RAM 転送セクションの
使用方法 ............................................................80
ROM → RAM 転送セクションの注意 .................81
-rp
引数のレジスタ渡しのライブラリ出力指定
オプション (-rp) ..............................................256
引数のレジスタ渡しのロードモジュール出力指定
オプション (-rp) ..............................................160
S7 タイプ
S7 タイプ ( ターミネータレコード ) ................. 377
S8 タイプ
S8 タイプ ( ターミネータレコード ) ................. 378
S9 タイプ
S9 タイプ ( ターミネータレコード ) ................. 379
-sc
セクション配置順 / アドレスの指定 (-sc) ......... 119
-set_rora
内蔵 ROM/RAM 領域の自動設定
(-set_rora) .........................................................142
-sl
ローカルシンボル情報リスト出力指定
(-sl) ................................................................... 180
-slf
ローカルシンボル情報リストファイル名の指定
(-slf) .................................................................. 181
SOFTUNE Workbench
SOFTUNE Workbench のカスタマイズビルド機能
に登録する方法 .............................................. 390
SOFTUNE Workbench のツールの起動に登録し ,
使用する方法 ..................................................393
-sp
スプリットモード指定 (-sp) ........................313, 315
-ST
開始アドレス変更指定 (-ST) ............................... 308
レコード開始アドレス変更指定 (-ST) ............... 302
S フォーマット
e2ms(HEX16 フォーマット
→ S フォーマット変換 ) ............................... 325
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ............................... 293
i2ms(HEX8 フォーマット
→ S フォーマット変換 ) ............................... 324
m2es(S フォーマット
→ HEX16 フォーマット変換 ) ...................... 323
m2is(S フォーマット
→ HEX8 フォーマット変換 ) ........................ 322
出力 S フォーマット指定
(-S1/-S2/-S3) ............................. 286, 287, 302, 305
S
TMP
TMP( ワークディレクトリ ) ........................... 13, 14
T
-S
出力 S フォーマット指定
(-S1/-S2/-S3) .............................286, 287, 302, 305
S0 タイプ
S0 タイプ ( ヘッダレコード ) ..............................372
S1 タイプ
S1 タイプ ( データレコード : 2 バイトアドレス )
..........................................................................373
S2 タイプ
S2 タイプ ( データレコード : 3 バイトアドレス )
...........................................................................374
S3 タイプ
S3 タイプ ( データレコード : 4 バイトアドレス )
...........................................................................375
S5 タイプ
S5 タイプ ( レコード数管理レコード ) ..............376
436
U
-ufiin
未使用関数削除情報ファイル格納パス指定
(-ufiin) .............................................................. 136
V
-V
版数 / メッセージ出力指定 (-V) ...........................34
-V オプション
-V オプション ......................................................... 29
起動メッセージと -V オプション .......................... 8
CM41-00315-6, July 31, 2015
索引
Support
Soft
W
-w
警告メッセージ出力レベルの指定 (-w) .............116
-Wf
フェッチ単位チェックの指定 (-Wf) ..................158
X
-x
モジュールの抽出 (-x) ..........................................242
-Xalr
ROM/RAM,ARRAY リスト出力抑止指定
(-Xalr) ...............................................................174
-Xals
絶対アセンブルリスト出力抑止指定
(-Xals) ...............................................................171
-Xb
バックアップファイルの作成抑止 (-Xb) ...........249
-Xcheck_dirsize
DIR 属性セクション合計サイズチェック抑止指定
(-Xcheck_dirsize) .............................................163
-Xcheck_locate
セクション配置領域チェック抑止指定
(-Xcheck_locate) ...............................................150
-Xcheck_rora
ユーザ指定領域のチェック抑止指定
(-Xcheck_rora) ..................................................146
-Xcheck_SCF
スタンバイモード遷移命令チェック抑止指定
(-Xcheck_SCF) .................................................156
-Xcheck_section
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................153
-Xcheck_size0_sec
サイズ 0 のセクション配置チェック抑止指定
(-Xcheck_size0_sec) .........................................166
-Xcmsg
終了メッセージ表示抑止指定 (-Xcmsg) ..............37
-Xcmsg オプション
-Xcmsg オプション .................................................29
-Xcwno
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno) .............................................................39
-Xcwno オプション
-Xcwno オプション .................................................29
-Xdel
削除対象外関数指定 (-Xdel) ................................135
-Xdof
デフォルトオプションファイル抑止指定
(-Xdof) ................................................................30
-Xdof オプション
-Xdof オプション ....................................................29
-Xentry
スタートアドレス出力抑止指定
(-Xentry) ...........................................................286
スタートアドレスレコード出力抑止指定
(-Xentry) ...........................................................291
-Xg
デバッグ情報の削除指定 (-Xg) .............................98
デバッグ情報の出力抑止指定 (-Xg) ...................253
July 31, 2015, CM41-00315-6
Ma nual
-xl
外部シンボル相互参照情報リスト出力指定
(-xl) ................................................................... 177
-xlf
外部シンボル相互参照情報リストファイル名の
指定 (-xlf) .........................................................178
-Xm
マップリスト出力の抑止指定 (-Xm) ................. 104
マップリストファイルの作成抑止指定
(-Xm) ........................................................313, 319
リストファイルの出力抑止指定 (-Xm) ............. 244
-Xml
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................185
-Xrp
引数のスタック渡しのライブラリ出力指定
オプション (-Xrp) ...........................................258
引数のスタック渡しのロードモジュール出力指定
オプション (-Xrp) ...........................................161
-Xset_rora
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) ......................................................143
-Xsl
ローカルシンボル情報リスト出力抑止指定
(-Xsl) ................................................................. 182
-Xsp
スプリットモード抑止指定 (-Xsp) .............313, 316
-XV
版数 / メッセージ出力抑止 (-XV) ........................ 35
-XV オプション
-XV オプション ......................................................29
-Xxl
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................ 179
437
索引
Su pp or t
Manu al
あ
え
アジャスタ
バイナリコンバータ ,
アジャスタの制限事項 ..................................328
アセンブラ言語
アセンブラ言語を使用して低消費電力モード制御
レジスタ (LPMCR) にアクセスする場合
..........................................................................403
アセンブルソースリスト
アセンブルソースリストの形式 .........................203
アセンブルリスト
アセンブルリスト内の
エラーメッセージ ..........................................199
絶対アセンブルリスト作成機能 .........................407
絶対アセンブルリスト出力指定 (-als) ...............169
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................168
絶対アセンブルリスト出力モジュール指定
(-alsf) .................................................................170
絶対アセンブルリスト出力抑止指定
(-Xals) ...............................................................171
絶対アセンブルリストの形式 .............................198
絶対形式アセンブルリスト .................................188
絶対形式アセンブルリスト
出力関連オプション ........................................95
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................167
アドレスレコード
拡張セグメントアドレスレコード
(HEX16/HEX32) ..............................................367
拡張リニアアドレスレコード (HEX32) .............369
スタートセグメントアドレスレコード
(HEX16/HEX32) ..............................................368
スタートリニアアドレスレコード
(HEX32) ...........................................................370
エラーメッセージ
アセンブルリスト内の
エラーメッセージ .......................................... 199
警告とエラーメッセージ .................................... 427
コンバータのエラーメッセージ ........................ 357
ライブラリアンのエラーメッセージ ................ 351
リンカのエラーメッセージ ................................334
リンケージキットのエラーメッセージの
表示形式 .......................................................... 333
リンケージキットの
エラーメッセージ分類 ..................................332
エントリアドレス
エントリアドレス / シンボル値の設定 ............... 54
エントリアドレスの指定 (-e) ..............................137
エントリアドレス指定
エントリアドレス指定 .......................................... 58
エンドレコード
エンドレコード (HEX8/HEX16/HEX32) ............366
い
一般形式
一般形式 .................................................................363
引数
引数のスタック渡しのライブラリ出力指定
オプション (-Xrp) ...........................................258
引数のスタック渡しのロードモジュール出力指定
オプション (-Xrp) ...........................................161
引数のレジスタ渡しのライブラリ出力指定
オプション (-rp) ..............................................256
引数のレジスタ渡しのロードモジュール出力指定
オプション (-rp) ..............................................160
インタフェース
新しい関数呼び出しインタフェース .................421
関数呼び出しインタフェースの
変更の詳細 ......................................................422
関数呼び出しインタフェースの
変更の流れ ......................................................422
ライブラリアンでの関数呼び出しインタフェース
の異なるオブジェクトの混在 ......................233
リンカでの関数呼び出しインタフェースの異なる
オブジェクトの混在 ........................................88
438
So ft
お
オブジェクト
-cpu オプションとオブジェクト混在可能
CPU 一覧 ...................................................87, 232
オブジェクト形式コンバータの
使用上の Q &A ............................................... 329
オブジェクト形式コンバータの制限事項 ........328
オブジェクト内容リスト出力関連オプション
............................................................................95
ライブラリアンでのオブジェクト混在 ............232
ライブラリアンでの関数呼び出しインタフェース
の異なるオブジェクトの混在 ...................... 233
リンカでの関数呼び出しインタフェースの異なる
オブジェクトの混在 ........................................ 88
オブジェクト形式コンバータ
オブジェクト形式コンバータの
オプション一覧 .............................................. 385
オブジェクト形式コンバータの概要 ................ 272
オブジェクト形式コンバータの共通
オプションの種類 .......................................... 278
オブジェクト形式コンバータの
コマンド一覧 ..................................................384
オブジェクト形式コンバータの
コマンド実行 ..................................................276
オブジェクト形式コンバータの使用上の
Q &A ................................................................ 329
オブジェクト形式コンバータの制限事項 ........328
オブジェクト混在
オブジェクト混在 ..................................................87
ライブラリアンでのオブジェクト混在 ............232
オブジェクト混在可能 CPU 一覧
-cpu オプションとオブジェクト混在可能
CPU 一覧 ...................................................87, 232
オブジェクト内容リスト出力関連オプション
オブジェクト内容リスト
出力関連オプション ........................................ 95
オブジェクトファイル
オブジェクトファイルフォーマット上の
制限事項 .......................................................... 216
入力オブジェクトファイルの指定 ...................... 55
CM41-00315-6, July 31, 2015
索引
Support
Soft
オプション
-cmsg オプション ....................................................29
-cpu オプションとオブジェクト混在可能
CPU 一覧 ....................................................87, 232
-cwno オプション ....................................................29
-f オプション ...........................................................29
-help オプション .....................................................29
-V オプション .........................................................29
-Xcmsg オプション .................................................29
-Xcwno オプション .................................................29
-Xdof オプション ....................................................29
-XV オプション .......................................................29
引数のスタック渡しのライブラリ出力指定
オプション (-Xrp) ...........................................258
引数のスタック渡しのロードモジュール出力指定
オプション (-Xrp) ...........................................161
引数のレジスタ渡しのライブラリ出力指定
オプション (-rp) ..............................................256
引数のレジスタ渡しのロードモジュール出力指定
オプション (-rp) ..............................................160
オブジェクト形式コンバータの共通オプションの
種類 ..................................................................278
オブジェクト内容リスト出力関連オプション
............................................................................95
オプション .....................................389, 408, 413, 416
オプション一覧 .....................................................236
オプション形式 .......................................................22
オプションの指定に関する注意 .........................266
起動メッセージと -V オプション ..........................8
終了メッセージと -cmsg オプション .....................9
出力モジュールに関するオプション ...................95
出力リストに関するオプション ...................95, 238
絶対形式アセンブルリスト出力関連オプション
............................................................................95
相反関係にあるオプションの指定例 ...................25
その他のオプション .............................................238
その他のリンク制御オプション ...........................95
配置 / 結合オプション ...........................................95
ファイル検索 , 保護に関するオプション ..........238
包含関係にあるオプションの指定例 ...................25
未使用関数削除機能関連オプション ...................95
ライブラリ制御オプション ...................................95
ライブラリの作成 , 編集に関するオプション
..........................................................................238
オプション一覧
オブジェクト形式コンバータの
オプション一覧 ..............................................385
オプション一覧 .....................................................236
共通オプション一覧 ...............................................28
バイナリコンバータのオプション一覧 .............312
フォーマットアジャスタの
オプション一覧 ..............................................301
ライブラリアンのオプション一覧 .....................383
リンカのオプション一覧 ...............................92, 380
ロードモジュールコンバータの
オプション一覧 ..............................................285
オプションパラメータ
オプションパラメータでの数値表現 ...................23
オプションファイル
オプションファイル ...............................................42
オプションファイルからの読込み指定
(-f) .......................................................................31
オプションファイル指定による実行 ...................42
July 31, 2015, CM41-00315-6
Ma nual
オプションファイル中の継続指定 ...................... 43
オプションファイル中のコメント指定 ..............44
オプションファイルの記述例 ..............................45
か
開始アドレス変更指定
開始アドレス変更指定 (-ST) ............................... 308
外部シンボル相互参照情報リスト
外部シンボル相互参照情報リスト .................... 188
外部シンボル相互参照情報リスト出力指定
外部シンボル相互参照情報リスト出力指定
(-xl) ................................................................... 177
外部シンボル相互参照情報リスト出力抑止指定
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................ 179
外部シンボル相互参照情報リストファイル
外部シンボル相互参照情報リストファイル
..........................................................................209
外部シンボル相互参照情報リストファイル名
外部シンボル相互参照情報リストファイル名の
指定 (-xlf) .........................................................178
外部シンボル値
外部シンボル値の仮設定 (-df) ............................138
外部シンボル値の設定 .......................................... 58
拡張セグメントアドレスレコード
拡張セグメントアドレスレコード
(HEX16/HEX32) .............................................. 367
拡張リニアアドレスレコード
拡張リニアアドレスレコード (HEX32) ............369
格納ディレクトリ
OPT( デフォルトオプションファイル格納
ディレクトリ ) ..................................................13
OPT907 ( デフォルトオプションファイル格納
ディレクトリ ) ..................................................13
格納パス指定
未使用関数削除情報ファイル格納パス指定
(-ufiin) ...............................................................136
カスタマイズビルド機能
SOFTUNE Workbench のカスタマイズビルド機能
に登録する方法 .............................................. 390
仮設定
外部シンボル値の仮設定 (-df) ............................138
環境変数
環境変数 ................................................ 408, 412, 415
関数
削除された関数のシンボルリスト
表示例 .............................................................. 197
削除対象外関数指定 (-Xdel) ................................135
未使用関数削除機能 .............................................. 89
未使用関数削除機能により削除されたセクション
のマップリスト表示例 ..................................193
未使用関数削除指定 (-lnkopt) ............................. 132
未使用関数削除情報ファイル格納パス指定
(-ufiin) .............................................................. 136
未使用関数とは ......................................................89
関数呼び出しインタフェース
新しい関数呼び出しインタフェース ................ 421
関数呼び出しインタフェースの
変更の詳細 ......................................................422
関数呼び出しインタフェースの
変更の流れ ......................................................422
439
索引
Su pp or t
ライブラリアンでの関数呼び出しインタフェース
の異なるオブジェクトの混在 ......................233
リンカでの関数呼び出しインタフェースの異なる
オブジェクトの混在 ........................................88
緩和
制限事項の緩和 .............................................411, 414
き
記述例
オプションファイルの記述例 ...............................45
起動メッセージ
起動メッセージ .........................................................8
起動メッセージと -V オプション ..........................8
起動メッセージ表示の選択 ...................................55
行数指定
リスト 1 ページの行数指定 (-pl) ................108, 246
強制終了
強制終了 .....................................................................6
共通オプション
オブジェクト形式コンバータの共通オプションの
種類 ..................................................................278
共通オプション一覧
共通オプション一覧 ...............................................28
共有結合
セクションの共有結合 ...........................................61
く
グループ化
セクションのグループ化 .......................................56
クロスリファレンスリスト
クロスリファレンスリストの形式 .....................207
け
警告
警告とエラーメッセージ .....................................427
警告チェックレベル
警告チェックレベルの選択 ...................................55
警告メッセージ
警告メッセージ .....................................................396
警告メッセージの出力先 .....................................389
警告メッセージ出力レベル
警告メッセージ出力レベルの指定 (-w) .............116
継承
デバッグ情報の継承 ...............................................55
継続指定
オプションファイル中の継続指定 .......................43
桁数指定
リスト 1 行の桁数指定 (-pw) ...............................247
リスト行の桁数指定 (-pw) ...................................107
結合
セクションの結合 / 配置に関する制御 ...............54
配置 / 結合オプション ...........................................95
結合順序
セクションの結合順序が指定された場合の
配置例 ................................................................64
セクションの結合順序が指定されなかった場合の
配置例 ................................................................63
440
So ft
Manu al
結合属性
セクションの結合属性 .......................................... 60
検索
検索ライブラリの指定 .......................................... 72
検索ライブラリファイル指定 ..............................57
シンボルごとの検索ライブラリファイル
指定 .................................................................... 57
デフォルトライブラリ検索の抑止指定
(-nd) .................................................................. 131
ファイル検索 , 保護に関するオプション ......... 238
ライブラリ検索の抑止 .......................................... 57
ライブラリ検索の抑止指定 (-nl) ........................ 130
ライブラリ検索パス指定 ...................................... 57
ライブラリの検索に関する制御 .......................... 54
検索順序
ライブラリファイルの検索順序 .......................... 72
検索ディレクトリ
LIB907 ( ライブラリファイル検索ディレクトリ )
............................................................................. 13
検索パス
ライブラリ検索パスの指定 (-L) .........................128
検索ライブラリファイル
検索ライブラリファイルの指定 (-l) .................. 127
検索ライブラリファイル指定
検索ライブラリファイル指定 ..............................57
シンボルごとの検索ライブラリファイル指定
............................................................................57
検索例
ライブラリファイルが
1 つの場合の検索例 1 ...................................... 73
ライブラリファイルが
1 つの場合の検索例 2 ...................................... 74
ライブラリファイルが
1 つの場合の検索例 3 ...................................... 75
ライブラリファイルが
複数の場合の検索例 1 ..................................... 76
ライブラリファイルが
複数の場合の検索例 2 ..................................... 77
こ
構成文字種
識別子の構成文字種 .............................................. 11
コマンド
オブジェクト形式コンバータの
コマンド実行 ..................................................276
コマンド一覧
オブジェクト形式コンバータの
コマンド一覧 ..................................................384
コマンド行
コマンド行の差異 ................................408, 412, 415
コマンドライン
コマンドラインで使用する方法 ........................ 390
コマンドラインの形式 ............................................ 5
コマンドラインの指定例 ...................................... 26
コメント指定
オプションファイル中のコメント指定 ..............44
混在
ライブラリアンでのオブジェクト混在 ............232
ライブラリアンでの関数呼び出しインタフェース
の異なるオブジェクトの混在 ...................... 233
CM41-00315-6, July 31, 2015
索引
Support
Soft
コントロールリスト部
コントロールリスト部の
リスト出力フォーマット ..............................190
コントロールリスト部のリスト表示例 .............191
コンバータ
オブジェクト形式コンバータの使用上の
Q &A ................................................................329
オブジェクト形式コンバータの制限事項 .........328
コンバータのエラーメッセージ .........................357
その他のコンバータの種類 .................................275
さ
差異
データに差異が生じている場合 .........................419
最適化
ファイル内容の最適化 (-O) .................................251
削除された関数
削除された関数のシンボルリスト表示例 .........197
削除指定
未使用関数削除指定 (-lnkopt) .............................132
削除対象外
削除対象外関数指定 (-Xdel) ................................135
し
識別子
識別子の区別 ...........................................................11
識別子の構成文字種 ...............................................11
識別子文字数の制限 ...............................................11
識別名表示
リスト出力時の識別名表示 ...................................11
実施例
実施例 .....................................................................418
指定
削除対象外関数指定 (-Xdel) ................................135
指定例
コマンドラインの指定例 .......................................26
相反関係にあるオプションの指定例 ...................25
包含関係にあるオプションの指定例 ...................25
自動設定
内蔵 ROM/RAM 領域の自動設定
(-set_rora) .........................................................142
自動配置
セクションの自動配置 ...........................................66
自動配置指定
自動配置指定 (-AL) ..............................................125
終了コード
終了コードの値と終了状態 .....................................7
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno) .............................................................39
ワーニング発生時の終了コードを 1 にする指定
(-cwno) ................................................................38
終了メッセージ
終了メッセージ .........................................................9
終了メッセージと -cmsg オプション .....................9
終了メッセージ表示指定 (-cmsg) .........................36
終了メッセージ表示の選択 ...................................55
終了メッセージ表示抑止指定 (-Xcmsg) ..............37
終了メッセージ表示指定
終了メッセージ表示指定 (-cmsg) .........................36
July 31, 2015, CM41-00315-6
Ma nual
終了メッセージ表示抑止指定
終了メッセージ表示抑止指定 (-Xcmsg) ..............37
出力 HEX フォーマット指定
出力 HEX フォーマット指定
(-I16/-I20/-I32) ......................... 286, 288, 302, 307
出力 S フォーマット指定
出力 S フォーマット指定
(-S1/-S2/-S3) ............................. 286, 287, 302, 305
出力指定
絶対形式ロードモジュールの出力指定
(-a) ......................................................................99
相対形式ロードモジュールの出力指定
(-r) ..................................................................... 100
メモリ使用情報リストの出力指定
(-mmi) ...............................................................106
出力ディレクトリ
絶対アセンブルリスト出力ディレクトリ指定
(-alout) .............................................................. 168
出力範囲指定
出力範囲指定 (-ran) ...................... 302, 304, 313, 314
出力ファイル名
出力ファイル名の変更 (-o) ................................. 279
出力フォーマット
コントロールリスト部の
リスト出力フォーマット ..............................190
出力フォーマットの指定 ...................................... 55
シンボルリスト部の
リスト出力フォーマット ..............................196
マップリスト部の
リスト出力フォーマット ..............................192
メモリ使用情報リスト部の
リスト出力フォーマット ..............................194
出力メッセージ
出力メッセージに関する指定 ..............................95
出力モジュール
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) ................................................................. 173
出力モジュールに関するオプション .................. 95
出力リスト
出力リストに関するオプション ..................95, 238
出力レコードデータ長指定
出力レコードデータ長指定 (-len) ...................... 302
出力レコード内データ長指定
出力レコード内データ長指定 (-len) .................. 303
出力レベル
警告メッセージ出力レベルの指定 (-w) ............116
出力ロードモジュールファイル
出力ロードモジュールファイル名の指定 ..........55
出力ロードモジュールファイル名指定
出力ロードモジュールファイル名指定
(-o) ......................................................................96
省略解除
リスト表示の名前の省略解除 (-dt) .................... 105
初期値付変数
初期値付変数の扱い ............................................ 218
シンボル
シンボルごとの検索ライブラリファイル指定
............................................................................57
シンボル個別のライブラリの指定 (-el) ............129
シンボル指定
C ソースのプログラム実行開始シンボル指定
(-entryc) ...........................................................134
441
索引
Su pp or t
シンボル値
エントリアドレス / シンボル値の設定 ...............54
外部シンボル値の仮設定 (-df) ............................138
外部シンボル値の設定 ...........................................58
シンボルリスト表示例
削除された関数のシンボルリスト表示例 .........197
シンボルリスト部
シンボルリスト部の
リスト出力フォーマット ..............................196
シンボルリスト部のリスト表示例 .....................197
す
スタートアドレス出力指定
スタートアドレス出力指定 (-entry) ...................286
スタートアドレス出力抑止指定
スタートアドレス出力抑止指定 (-Xentry) ........286
スタートアドレスレコード出力指定
スタートアドレスレコード出力指定
(-entry) ..............................................................289
スタートアドレスレコード出力抑止指定
スタートアドレスレコード出力抑止指定
(-Xentry) ...........................................................291
スタートセグメントアドレスレコード
スタートセグメントアドレスレコード
(HEX16/HEX32) ..............................................368
スタートリニアアドレスレコード
スタートリニアアドレスレコード
(HEX32) ...........................................................370
スタンバイ制御マクロ
スタンバイ制御マクロについて .........................404
スタンバイモード遷移命令
検出可能なスタンバイモード遷移命令 .............400
スタンバイモード遷移命令を検出しても警告を
出力しない場合 ..............................................399
スタンバイモード遷移命令チェック指定
スタンバイモード遷移命令チェック指定
(-check_SCF) ....................................................154
スタンバイモード遷移命令チェックツール
スタンバイモード遷移命令チェックツールの
概要 ..................................................................388
スタンバイモード遷移命令チェック抑止指定
スタンバイモード遷移命令チェック抑止指定
(-Xcheck_SCF) .................................................156
スプリット
スプリットモード指定 (-sp) ........................313, 315
スプリットモード抑止指定 (-Xsp) .............313, 316
スプリットモード
スプリットモードの概要 .....................................311
スプリットモード指定
スプリットモード指定 (-sp) ........................313, 315
スプリットモード抑止指定
スプリットモード抑止指定 (-Xsp) .............313, 316
せ
整形指定
整形指定 (-adjust) ..........................................286, 292
セクション
DIR 属性セクション合計サイズチェック指定
(-check_dirsize) ................................................162
442
So ft
Manu al
DIR 属性セクション合計サイズチェックについて
............................................................................85
DIR 属性セクション合計サイズチェック抑止指定
(-Xcheck_dirsize) .............................................163
DIR 属性セクションの配置について .................. 83
ROM/RAM 領域の設定とセクション配置 ..........79
ROM → RAM 転送セクション ............................. 80
ROM → RAM 転送セクションの使用方法 ......... 80
ROM → RAM 転送セクションの注意 ................. 81
サイズ 0 のセクション配置チェック指定
(-check_size0_sec) ...........................................164
サイズ 0 のセクション配置チェック抑止指定
(-Xcheck_size0_sec) .........................................166
セクション種別と配置先 ...................................... 69
セクション詳細マップリスト ............................188
セクション詳細マップリスト出力指定
(-ml) .................................................................. 183
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................185
セクション詳細マップリストファイル名の指定
(-mlf) ................................................................. 184
セクション情報リストの形式 ............................205
セクション内容種別 .............................................. 59
セクションの共有結合 .......................................... 61
セクションのグループ化 ...................................... 56
セクションの結合 / 配置に関する制御 ............... 54
セクションの結合順序が指定された場合の
配置例 ................................................................ 64
セクションの結合順序が指定されなかった場合の
配置例 ................................................................ 63
セクションの結合属性 .......................................... 60
セクションの識別 ..................................................60
セクションの自動配置 .......................................... 66
セクションの単純連結結合 ..................................61
セクションの配置順と
配置アドレスの指定 ........................................ 56
セクションの配置属性 .......................................... 59
セクションのリンク .............................................. 62
セクション配置順 / アドレスの指定 (-sc) ......... 119
セクション配置詳細情報リストファイル ........212
セクション配置領域チェック指定
(-check_locate) ................................................. 147
セクション配置領域チェック抑止指定
(-Xcheck_locate) .............................................. 150
セクション名 .......................................................... 59
ユーザ指定外セクションのチェック指定
(-check_section) ............................................... 151
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................153
セクショングループ
セクショングループの指定 (-gr) ........................ 122
セクショングループの指定がある場合の
配置例 ................................................................ 65
セクション種別
セクション種別と配置先 ...................................... 69
セクション詳細マップリスト
セクション詳細マップリスト ............................188
セクション詳細マップリスト出力指定
セクション詳細マップリスト出力指定
(-ml) .................................................................. 183
セクション詳細マップリスト出力抑止指定
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................185
CM41-00315-6, July 31, 2015
索引
Support
Soft
セクション詳細マップリストファイル名
セクション詳細マップリストファイル名の指定
(-mlf) .................................................................184
セクション情報リスト
セクション情報リストの形式 .............................205
セクション配置詳細情報リストファイル
セクション配置詳細情報リストファイル .........212
セクション配置チェック指定
サイズ 0 のセクション配置チェック指定
(-check_size0_sec) ............................................164
セクション配置チェック抑止指定
サイズ 0 のセクション配置チェック抑止指定
(-Xcheck_size0_sec) .........................................166
セクション配置領域チェック指定
セクション配置領域チェック指定
(-check_locate) .................................................147
セクション配置領域チェック抑止指定
セクション配置領域チェック抑止指定
(-Xcheck_locate) ...............................................150
絶対アセンブルリスト
絶対アセンブルリストの形式 .............................198
絶対アセンブルリスト作成機能
絶対アセンブルリスト作成機能 .........................407
絶対アセンブルリスト出力指定
絶対アセンブルリスト出力指定 (-als) ...............169
絶対アセンブルリスト出力ディレクトリ指定
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................168
絶対アセンブルリスト出力モジュール指定
絶対アセンブルリスト出力モジュール指定
(-alsf) .................................................................170
絶対アセンブルリスト出力抑止指定
絶対アセンブルリスト出力抑止指定
(-Xals) ...............................................................171
絶対形式アセンブルリスト
絶対形式アセンブルリスト .................................188
絶対形式アセンブルリスト出力関連オプション
絶対形式アセンブルリスト
出力関連オプション ........................................95
絶対形式ロードモジュール
f2es( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................296
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................294
f2is( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................295
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ................................293
絶対形式ロードモジュールの出力指定
(-a) .......................................................................99
遷移命令
検出可能なスタンバイモード遷移命令 .............400
スタンバイモード遷移命令チェック指定
(-check_SCF) ....................................................154
スタンバイモード遷移命令チェックツールの
概要 ..................................................................388
スタンバイモード遷移命令チェック抑止指定
(-Xcheck_SCF) .................................................156
スタンバイモード遷移命令を検出しても警告を
出力しない場合 ..............................................399
July 31, 2015, CM41-00315-6
Ma nual
そ
相互参照情報
外部シンボル相互参照情報リスト .................... 188
外部シンボル相互参照情報リスト出力指定
(-xl) ................................................................... 177
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................ 179
外部シンボル相互参照情報リストファイル
..........................................................................209
外部シンボル相互参照情報リストファイル名の
指定 (-xlf) .........................................................178
相対アセンブルリスト入力ディレクトリ指定
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................ 167
相対形式ロードモジュール
相対形式ロードモジュールの出力指定
(-r) ..................................................................... 100
相反関係
相反関係にあるオプションの指定例 .................. 25
た
ターゲット CPU 指定
ターゲット CPU 指定 (-cpu) ........................139, 254
ターミネータレコード
S7 タイプ ( ターミネータレコード ) ................. 377
S8 タイプ ( ターミネータレコード ) ................. 378
S9 タイプ ( ターミネータレコード ) ................. 379
ダイレクトページ
ダイレクトページについて ..................................83
単純連結結合
セクションの単純連結結合 ..................................61
ち
チェックサム指定
ROM 領域のチェックサム指定 (-cs) .................. 109
チェックツール
スタンバイモード遷移命令チェックツールの
概要 .................................................................. 388
つ
ツール
SOFTUNE Workbench のツールの起動に登録し ,
使用する方法 ..................................................393
て
低消費電力モード制御レジスタ
アセンブラ言語を使用して低消費電力モード
制御レジスタ (LPMCR) にアクセスする場合
..........................................................................403
ディスク容量
必要なディスク容量についての注意 ................ 266
ディレクトリ
LIB907 ( ライブラリファイル検索ディレクトリ )
............................................................................13
OPT( デフォルトオプションファイル
格納ディレクトリ ) .......................................... 13
443
索引
Su pp or t
OPT907 ( デフォルトオプションファイル格納
ディレクトリ ) ..................................................13
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................168
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................167
データレコード
S1 タイプ ( データレコード : 2 バイトアドレス )
..........................................................................373
S2 タイプ ( データレコード : 3 バイトアドレス )
...........................................................................374
S3 タイプ ( データレコード : 4 バイトアドレス )
...........................................................................375
データレコード (HEX8/HEX16/HEX32) ............365
デバッグ情報
デバッグ情報の継承 ...............................................55
デバッグ情報の削除 .....................................226, 230
デバッグ情報の削除指定 (-Xg) .............................98
デバッグ情報の出力指定 (-g) ........................97, 252
デバッグ情報の出力抑止指定 (-Xg) ...................253
デバッグ情報存在チェック抑止指定
デバッグ情報存在チェック抑止指定
(-NCI0302LIB) .................................................141
デフォルトオプションファイル
OPT( デフォルトオプションファイル
格納ディレクトリ ) ..........................................13
OPT907 ( デフォルトオプションファイル
格納ディレクトリ ) ..........................................13
デフォルトオプションファイル ...........................46
デフォルトオプションファイル抑止指定
デフォルトオプションファイル抑止指定
(-Xdof) ................................................................30
デフォルトライブラリ検索
デフォルトライブラリ検索の抑止指定
(-nd) ..................................................................131
転送セクション
ROM → RAM 転送セクション .............................80
ROM → RAM 転送セクションの使用方法 .........80
ROM → RAM 転送セクションの注意 .................81
な
内蔵 ROM
内蔵 ROM/RAM 領域自動設定の抑止指定 .........86
内蔵 ROM/RAM
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) .......................................................143
内蔵 ROM/RAM 領域の自動設定
(-set_rora) .........................................................142
内蔵 ROM/RAM 領域自動設定
内蔵 ROM/RAM 領域自動設定の抑止指定 .........86
に
入出力ファイル
入出力ファイル / メッセージに関する制御 .......53
入力オブジェクトファイル
入力オブジェクトファイルの指定 .......................55
入力ディレクトリ
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................167
444
So ft
Manu al
は
配置
DIR 属性セクションの配置について .................. 83
ROM/RAM 領域の設定と
セクション配置 ................................................ 79
セクションの結合 / 配置に関する制御 ............... 54
配置 / 結合オプション ...........................................95
配置 / 結合オプション
配置 / 結合オプション ...........................................95
配置アドレス
セクションの配置順と
配置アドレスの指定 ........................................ 56
配置アドレスの決定方法 ................................ 67, 70
配置順
セクションの配置順と
配置アドレスの指定 ........................................ 56
配置属性
セクションの配置属性 .......................................... 59
配置例
-AL 1 が指定された場合の配置例 ........................ 68
-AL 2 が指定された場合の配置例 ........................ 70
セクショングループの指定がある場合の
配置例 ................................................................ 65
セクションの結合順序が指定された場合の
配置例 ................................................................ 64
セクションの結合順序が指定されなかった場合の
配置例 ................................................................ 63
バイト単位チェック
バイト単位チェック ............................................ 398
バイナリコンバータ
バイナリコンバータ ............................................ 274
バイナリコンバータ ,
アジャスタの制限事項 ..................................328
バイナリコンバータのオプション一覧 ............312
バイナリコンバータの概要 ................................310
パス指定
ライブラリ検索パス指定 ...................................... 57
バックアップファイル
バックアップファイルの作成 (-b) .....................248
バックアップファイルの作成抑止 (-Xb) ..........249
パディング
パディング (-p) ..................................................... 281
版数 / メッセージ出力指定
版数 / メッセージ出力指定 (-V) ...........................34
版数 / メッセージ出力抑止
版数 / メッセージ出力抑止 (-XV) ........................ 35
ひ
比較手順
比較手順の概略 ....................................................417
表示指定
終了メッセージ表示指定 (-cmsg) .........................36
表示抑止指定
終了メッセージ表示抑止指定 (-Xcmsg) ..............37
表示例
コントロールリスト部のリスト表示例 ............191
削除された関数の
シンボルリスト表示例 ..................................197
シンボルリスト部のリスト表示例 .................... 197
マップリスト部のリスト表示例 ........................ 193
CM41-00315-6, July 31, 2015
索引
Support
Soft
未使用関数削除機能により削除されたセクション
のマップリスト表示例 ..................................193
メモリ使用情報リスト部のリスト表示例 .........195
ふ
ファイル検索
ファイル検索 , 保護に関するオプション ..........238
ファイル名
ファイル名の文字コード .......................................12
ファイル名の文字数 ...............................................12
フィル指定
ROM 領域のフィル指定 (-fill) .............................101
フェッチ
フェッチ単位チェックの指定 (-Wf) ..................158
フェッチ単位チェック
フェッチ単位チェック .........................................397
フェッチ単位チェックの指定 (-Wf) ..................158
フォーマットアジャスタ
フォーマットアジャスタ .....................................274
フォーマットアジャスタの
オプション一覧 ..............................................301
フォーマットアジャスタの概要 .........................298
フォーマットアジャスタの機能 .........................299
プログラム実行開始
C ソースのプログラム実行開始シンボル指定
(-entryc) ...........................................................134
へ
ヘッダ
ヘッダ形式 .............................................................200
ヘッダレコード
S0 タイプ ( ヘッダレコード ) ..............................372
ヘルプメッセージ
ヘルプメッセージ ...................................................10
ヘルプメッセージの表示 (-help) ...........................33
変換
e2ms(HEX16 フォーマット
→ S フォーマット変換 ) ................................325
f2es( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................296
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................294
f2is( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................295
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ................................293
i2ms(HEX8 フォーマット
→ S フォーマット変換 ) ................................324
m2es(S フォーマット
→ HEX16 フォーマット変換 ) ......................323
m2is(S フォーマット
→ HEX8 フォーマット変換 ) ........................322
変換ツール
変換ツールの追加 .................................................416
ほ
包含関係
包含関係にあるオプションの指定例 ...................25
July 31, 2015, CM41-00315-6
Ma nual
保護
ファイル検索 , 保護に関するオプション ......... 238
ま
マクロ
スタンバイ制御マクロについて ........................ 404
マップリスト
セクション詳細マップリスト ............................188
セクション詳細マップリスト出力指定
(-ml) .................................................................. 183
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................185
未使用関数削除機能により削除されたセクション
のマップリスト表示例 ..................................193
マップリスト出力
マップリスト出力の抑止指定 (-Xm) ................. 104
マップリスト表示例
未使用関数削除機能により削除されたセクション
のマップリスト表示例 ..................................193
マップリスト部
マップリスト部の
リスト出力フォーマット ..............................192
マップリスト部のリスト表示例 ........................ 193
マップリストファイル
セクション詳細マップリストファイル名の指定
(-mlf) ................................................................. 184
マップリストファイルの作成指定
(-m) ...........................................................313, 317
マップリストファイルの作成抑止指定
(-Xm) ........................................................313, 319
マップリストファイル名の指定 (-m) ................ 103
み
未使用関数
未使用関数削除機能関連オプション .................. 95
未使用関数削除機能により削除されたセクション
のマップリスト表示例 ..................................193
未使用関数削除情報ファイル格納パス指定
(-ufiin) .............................................................. 136
め
命令
検出可能なスタンバイモード遷移命令 ............400
スタンバイモード遷移命令チェック指定
(-check_SCF) ....................................................154
スタンバイモード遷移命令チェックツールの
概要 .................................................................. 388
スタンバイモード遷移命令チェック抑止指定
(-Xcheck_SCF) ................................................. 156
スタンバイモード遷移命令を検出しても警告を
出力しない場合 .............................................. 399
メッセージ
入出力ファイル / メッセージに関する
制御 .................................................................... 53
メモリ使用情報リスト
メモリ使用情報リストの出力指定
(-mmi) ...............................................................106
445
索引
Su pp or t
Manu al
メモリ使用情報リスト部
メモリ使用情報リスト部の
リスト出力フォーマット ..............................194
メモリ使用情報リスト部の
リスト表示例 ..................................................195
読込み指定
オプションファイルからの読込み指定
(-f) ....................................................................... 31
予約シンボル
リンカの予約シンボル ........................................ 216
も
ら
モード
スプリットモード指定 (-sp) ........................313, 315
スプリットモードの概要 .....................................311
スプリットモード抑止指定 (-Xsp) .............313, 316
モジュール
モジュールの削除 (-d) ..........................................241
モジュールの置換 ( 登録 )(-r) ..............................240
モジュールの抽出 (-x) ..........................................242
モジュールの追加 ( 登録 )(-a) .............................239
モジュール抽出
ライブラリファイル内の
モジュール抽出 ......................................226, 229
ライブラリ
検索ライブラリの指定 .......................................... 72
シンボル個別のライブラリの指定 (-el) ............129
ライブラリ検索の抑止 .......................................... 57
ライブラリ検索パス指定 ...................................... 57
ライブラリの検索に関する制御 .......................... 54
ライブラリの作成 ,
編集に関するオプション ..............................238
ライブラリアン
ライブラリアンでのオブジェクト混在 ............232
ライブラリアンでの関数呼び出しインタフェース
の異なるオブジェクトの混在 ...................... 233
ライブラリアンのエラーメッセージ ................ 351
ライブラリアンのオプション一覧 .................... 383
ライブラリアンの制限事項 ................................266
ライブラリアンの役割 ........................................ 224
ライブラリ検索
ライブラリ検索の抑止指定 (-nl) ........................ 130
ライブラリ検索パス
ライブラリ検索パスの指定 (-L) .........................128
ライブラリ検索パス指定
ライブラリ検索パス指定 ...................................... 57
ライブラリ出力指定オプション
引数のスタック渡しのライブラリ
出力指定オプション (-Xrp) ........................... 258
引数のレジスタ渡しのライブラリ
出力指定オプション (-rp) ..............................256
ライブラリ制御オプション
ライブラリ制御オプション ..................................95
ライブラリファイル
LIB907 ( ライブラリファイル検索ディレクトリ )
............................................................................13
検索ライブラリファイル指定 ..............................57
検索ライブラリファイルの指定 (-l) .................. 127
シンボルごとの検索ライブラリファイル指定
............................................................................57
ライブラリファイル内の
モジュール抽出 ......................................226, 229
ライブラリファイルが
1 つの場合の検索例 1 ...................................... 73
ライブラリファイルが
1 つの場合の検索例 2 ...................................... 74
ライブラリファイルが
1 つの場合の検索例 3 ...................................... 75
ライブラリファイルが
個別に指定された場合の処理 ........................ 78
ライブラリファイルが
複数の場合の検索例 1 ..................................... 76
ライブラリファイルが
複数の場合の検索例 2 ..................................... 77
ライブラリファイルの検索順序 .......................... 72
ライブラリファイルの作成に関する
Q &A ................................................................ 267
ライブラリファイルの新規作成 ................226, 227
ゆ
ユーザ指定外セクション
ユーザ指定外セクションのチェック指定
(-check_section) ................................................151
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................153
ユーザ指定領域
ユーザ指定領域のチェック指定
(-check_rora) .....................................................144
ユーザ指定領域のチェック抑止指定
(-Xcheck_rora) ..................................................146
よ
抑止指定
DIR 属性セクション合計サイズチェック抑止指定
(-Xcheck_dirsize) .............................................163
サイズ 0 のセクション配置チェック抑止指定
(-Xcheck_size0_sec) .........................................166
スタンバイモード遷移命令チェック抑止指定
(-Xcheck_SCF) .................................................156
セクション配置領域チェック抑止指定
(-Xcheck_locate) ...............................................150
デバッグ情報存在チェック抑止指定
(-NCI0302LIB) .................................................141
デフォルトオプションファイル抑止指定
(-Xdof) ................................................................30
デフォルトライブラリ検索の抑止指定
(-nd) ..................................................................131
内蔵 ROM/RAM 領域自動設定の抑止指定 .........86
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) .......................................................143
マップリスト出力の抑止指定 (-Xm) ..................104
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................153
ユーザ指定領域のチェック抑止指定
(-Xcheck_rora) ..................................................146
ライブラリ検索の抑止指定 (-nl) ........................130
446
So ft
CM41-00315-6, July 31, 2015
索引
Support
Soft
ライブラリファイルの内容検査 (-c) ..................250
ライブラリファイルの
内容チェック ..........................................226, 231
ライブラリファイルの内容表示 .................226, 231
ライブラリファイルの編集 .........................226, 227
り
リスト
リスト 1 ページの行数指定 (-pl) ........................108
リスト行
リスト行の桁数指定 (-pw) ...................................107
リスト出力概要
リスト出力概要 .....................................261, 262, 263
リスト出力関連オプション
オブジェクト内容リスト出力関連オプション
............................................................................95
リスト出力フォーマット
コントロールリスト部の
リスト出力フォーマット ..............................190
シンボルリスト部の
リスト出力フォーマット ..............................196
マップリスト部の
リスト出力フォーマット ..............................192
メモリ使用情報リスト部の
リスト出力フォーマット ..............................194
リスト表示
リスト表示の名前の省略解除 (-dt) ....................105
リスト表示例
コントロールリスト部のリスト表示例 .............191
削除された関数の
シンボルリスト表示例 ..................................197
シンボルリスト部のリスト表示例 .....................197
マップリスト部のリスト表示例 .........................193
未使用関数削除機能により削除されたセクション
のマップリスト表示例 ..................................193
メモリ使用情報リスト部の
リスト表示例 ..................................................195
リストファイル
リストファイルの形式変更 ...................................55
リストファイルの構成 .........................................260
リストファイルの出力指定 (-m) ........................243
リストファイルの出力抑止指定 (-Xm) ..............244
リストファイルの詳細情報の出力指定
(-dt) ...................................................................245
リストファイル名の指定 .......................................55
リンカ
リンカでの関数呼び出しインタフェースの異なる
オブジェクトの混在 ........................................88
リンカのエラーメッセージ .................................334
リンカのオプション一覧 ...............................92, 380
リンカの概要 ...........................................................52
リンカの使用上の Q &A ......................................217
リンカの制限事項 .................................................216
リンカの予約シンボル .........................................216
リンク制御オプション
その他のリンク制御オプション ...........................95
リンクリストファイル
リンクリストファイル .........................................188
リンクリストファイルの構成 .............................189
July 31, 2015, CM41-00315-6
Ma nual
リンケージキット
リンケージキットのエラーメッセージの
表示形式 .......................................................... 333
リンケージキットの
エラーメッセージ分類 ..................................332
リンケージキットのサポート範囲 ........................ 4
れ
レコード
S0 タイプ ( ヘッダレコード ) ............................. 372
S1 タイプ ( データレコード : 2 バイトアドレス )
........................................................................... 373
S2 タイプ ( データレコード : 3 バイトアドレス )
........................................................................... 374
S3 タイプ ( データレコード : 4 バイトアドレス )
........................................................................... 375
S5 タイプ ( レコード数管理レコード ) ............. 376
S7 タイプ ( ターミネータレコード ) ................. 377
S8 タイプ ( ターミネータレコード ) ................. 378
S9 タイプ ( ターミネータレコード ) ................. 379
拡張セグメントアドレスレコード
(HEX16/HEX32) .............................................. 367
拡張リニアアドレスレコード (HEX32) ............369
出力レコードデータ長指定 (-len) ...................... 302
出力レコード内データ長指定 (-len) .................. 303
スタートアドレスレコード出力指定
(-entry) .............................................................. 289
スタートアドレスレコード出力抑止指定
(-Xentry) ...........................................................291
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................. 368
スタートリニアアドレスレコード
(HEX32) ...........................................................370
レコード開始アドレス変更指定 (-ST) ............... 302
レコード開始アドレス変更指定
レコード開始アドレス変更指定 (-ST) ............... 302
レコード数管理レコード
S5 タイプ ( レコード数管理レコード ) ............. 376
レジスタ
アセンブラ言語を使用して低消費電力モード
制御レジスタ (LPMCR) にアクセスする場合
..........................................................................403
レジスタバンク
レジスタバンク領域の指定 (-rg) ........................ 123
ろ
ローカルシンボル情報リスト
ローカルシンボル情報リスト ............................188
ローカルシンボル情報リスト出力指定
ローカルシンボル情報リスト出力指定
(-sl) ................................................................... 180
ローカルシンボル情報リスト出力抑止指定
ローカルシンボル情報リスト出力抑止指定
(-Xsl) ................................................................. 182
ローカルシンボル情報リストファイル
ローカルシンボル情報リストファイル ............210
ローカルシンボル情報リストファイル名
ローカルシンボル情報リストファイル名の指定
(-slf) .................................................................. 181
447
索引
Su pp or t
ロードモジュール
f2es( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................296
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................294
f2is( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................295
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ................................293
引数のスタック渡しのロードモジュール出力指定
オプション (-Xrp) ...........................................161
引数のレジスタ渡しのロードモジュール出力指定
オプション (-rp) ..............................................160
出力ロードモジュールファイル名指定
(-o) ......................................................................96
絶対形式ロードモジュールの出力指定
(-a) .......................................................................99
相対形式ロードモジュールの出力指定
(-r) .....................................................................100
ロードモジュールコンバータ
ロードモジュールコンバータの
オプション一覧 ..............................................285
ロードモジュールコンバータの概要 .................284
ロードモジュールコンバータの種類 .................274
ロードモジュール出力指定オプション
引数のスタック渡しのロードモジュール出力指定
オプション (-Xrp) ...........................................161
引数のレジスタ渡しのロードモジュール出力指定
オプション (-rp) ..............................................160
ロードモジュールファイル
出力ロードモジュールファイル名の指定 ...........55
448
So ft
Manu al
わ
ワークディレクトリ
TMP( ワークディレクトリ ) ........................... 13, 14
ワーニング
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno) .............................................................39
ワーニング発生時の終了コードを 1 にする指定
(-cwno) ...............................................................38
CM41-00315-6, July 31, 2015
Support
Soft
Ma nual
奥付
CM41-00315-6
Spansion • SOFTWARE SUPPORT MANUAL
F2MC-16 ファミリ
SOFTUNETM リンケージキット マニュアル
V3 対応
2015 年 7 月 Rev. 6.0
発行
Spansion Inc.
編集
コーポレートコミュニケーション部
July 31, 2015, CM41-00315-6
449
Su pp or t
So ft
Manu al
免責事項
本資料に記載された製品は、通常の産業用 , 一般事務用 , パーソナル用 , 家庭用などの一般的用途 ( ただし、用途の限定はあ
りません ) に使用されることを意図して設計・製造されています。(1) 極めて高度な安全性が要求され、仮に当該安全性が
確保されない場合、社会的に重大な影響を与えかつ直接生命・身体に対する重大な危険性を伴う用途 ( 原子力施設における
核反応制御 , 航空機自動飛行制御 , 航空交通管制 , 大量輸送システムにおける運行制御 , 生命維持のための医療機器 , 兵器シ
ステムにおけるミサイル発射制御等をいう ) 、ならびに (2) 極めて高い信頼性が要求される用途 ( 海底中継器 , 宇宙衛星等を
いう ) に使用されるよう設計・製造されたものではありません。上記の製品の使用法によって惹起されたいかなる請求また
は損害についても、Spansion は、お客様または第三者、あるいはその両方に対して責任を一切負いません。半導体デバイス
はある確率で故障が発生します。当社半導体デバイスが故障しても、結果的に人身事故 , 火災事故 , 社会的な損害を生じさ
せないよう、お客様において、装置の冗長設計 , 延焼対策設計 , 過電流防止対策設計 , 誤動作防止設計などの安全設計をお
願いします。本資料に記載された製品が、外国為替及び外国貿易法、米国輸出管理関連法規などの規制に基づき規制され
ている製品または技術に該当する場合には、本製品の輸出に際して、同法に基づく許可が必要となります。
商標および注記
このドキュメントは、断りなく変更される場合があります。本資料には Spansion が開発中の Spansion 製品に関する情報が
記載されている場合があります。Spansion は、それらの製品に対し、予告なしに仕様を変更したり、開発を中止したりする
権利を有します。このドキュメントに含まれる情報は、現状のまま、保証なしに提供されるものであり、その正確性 , 完全
性 , 実施可能性および特定の目的に対する適合性やその市場性および他者の権利を侵害しない事を保証するものでなく、ま
た、明示 , 黙示または法定されているあらゆる保証をするものでもありません。Spansion は、このドキュメントに含まれる
情報を使用することにより発生したいかなる損害に対しても責任を一切負いません。
Copyright © 2004-2015 Cypress All rights reserved.
商標:Spansion®, Spansion ロゴ ( 図形マーク ), MirrorBit®, MirrorBit® EclipseTM, ORNANDTM 及びこれらの組合せは、米国・
日本ほか諸外国における Spansion LLC の商標です。第三者の社名・製品名等の記載はここでは情報提供を目的として表記
したものであり、各権利者の商標もしくは登録商標となっている場合があります。
450
CM41-00315-6, July 31, 2015