3.2MB - Spansion

本ドキュメントはCypress (サイプレス) 製品に関する情報が記載されております。
F2MC®-8L/8FX ファミリ
SOFTUNE® リンケージキットマニュアル
V3 対応
Support Soft Manual
Publication Number CM25-00321
Revision 5.0
Issue Date September 1, 2014
F2MC®-8L/8FX ファミリ
SOFTUNE® リンケージキットマニュアル
V3 対応
Support Soft Manual
Support
Soft
Ma nual
はじめに
■ 本書の目的と対象読者
本書は , Spansion SOFTUNE リンケージキットの機能および使用方法を説明したもので
す。
本書は , F2MC-8L/8FX ファミリマイクロプロセッサを使用した応用プログラムを開発
する技術者を対象にしています。本書をご一読ください。
リンケージキットはリンカ , ライブラリアン , コンバータの 3 種類のプログラムで構成
されています。
■ 商標
F2MC は , Spansion LLC の登録商標です。
Microsoft, MS-DOS, Windows, Windows NT は , 米国 Microsoft Corporation の米国および
その他の国における登録商標です。
その他の記載されている社名および製品名などの固有名詞は , 各社の商標または登録
商標です。
■ 本書の全体構成
本書は , 以下に示す 4 部と付録の構成となっています。
第 I 部 リンケージキット編
この部では , リンケージキットに含まれるツールの概要と , ツール全体に共通する
項目について説明します。
第 II 部 リンカ編
この部では , リンカの仕様 , オプションおよび出力リストなどについて説明します。
第 III 部 ライブラリアン編
この部では , ライブラリアンの仕様 , オプションおよび出力リストなどについて説
明します。
第 IV 部 オブジェクト形式コンバータ編
この部では , オブジェクト形式コンバータの種類 , オプション一覧 , 機能説明および
オブジェクト形式の変換について説明します。
付録
付録では , リンケージキットのエラーメッセージ , HEX フォーマット , および S
フォーマットレコード形式などを記載しています。
September 1, 2014, CM25-00321-5
i
Su pp or t
ii
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
目次
第I部
リンケージキット編.................................................................................. 1
第1章
リンケージキットの仕様............................................................................ 3
1.1 リンケージキットの概要 ........................................................................................................ 4
1.2 起動方法 ................................................................................................................................. 5
1.3 強制終了 ................................................................................................................................. 7
1.4 終了コード.............................................................................................................................. 8
1.5 起動メッセージ ...................................................................................................................... 9
1.6 終了メッセージ .................................................................................................................... 10
1.7 ヘルプメッセージ ................................................................................................................. 11
1.8 識別子 ................................................................................................................................... 12
1.9 ファイル名規則 .................................................................................................................... 13
1.10 環境変数 ............................................................................................................................... 14
1.10.1
TMP ( ワークディレクトリ ) ...................................................................................... 15
1.10.2
FELANG ..................................................................................................................... 16
1.10.3
FETOOL ..................................................................................................................... 17
1.10.4
LIB896 ........................................................................................................................ 18
1.10.5
OPT896 ...................................................................................................................... 19
1.10.6
OPT ............................................................................................................................ 20
第2章
2.1
2.2
2.3
2.4
2.5
第3章
オプション ............................................................................................... 21
オプション............................................................................................................................ 22
オプションパラメータでの数値表現 .................................................................................... 23
オプション指定時の注意と評価 ........................................................................................... 24
包含 / 相反関係にあるオプションの指定.............................................................................. 25
コマンドラインの指定例 ...................................................................................................... 26
共通オプション ........................................................................................ 27
3.1 共通オプション一覧 ............................................................................................................. 28
3.2 共通オプション詳細 ............................................................................................................. 29
3.2.1
デフォルトオプションファイル抑止指定 (-Xdof)....................................................... 31
3.2.2
オプションファイルからの読込み指定 (-f)................................................................. 32
3.2.3
ヘルプメッセージの表示 (-help)................................................................................. 34
3.2.4
版数 / メッセージ出力指定 (-V) .................................................................................. 35
3.2.5
版数 / メッセージ出力抑止 (-XV)................................................................................ 36
3.2.6
終了メッセージ表示指定 (-cmsg)............................................................................... 37
3.2.7
終了メッセージ表示抑止指定 (-Xcmsg) ..................................................................... 38
3.2.8
ワーニング発生時の終了コードを 1 にする指定 (-cwno)........................................... 39
3.2.9
ワーニング発生時の終了コードを 0 にする指定 (-Xcwno) ........................................ 40
第4章
4.1
4.2
4.3
オプションファイル................................................................................. 41
オプションファイルの概要................................................................................................... 42
オプションファイル中での継続指定 .................................................................................... 44
オプションファイル中のコメント指定................................................................................. 45
September 1, 2014, CM25-00321-5
iii
Su pp or t
4.4
4.5
So ft
Manu al
オプションファイルの記述例 ............................................................................................... 46
デフォルトオプションファイル ........................................................................................... 47
第 II 部
リンカ編.................................................................................................. 49
第5章
リンカの仕様............................................................................................ 51
5.1 リンカの概要 ........................................................................................................................ 52
5.2 リンカの機能 ........................................................................................................................ 53
5.2.1
入出力ファイル / メッセージに関する制御 ................................................................ 55
5.2.2
セクションの結合 / 配置に関する制御 ....................................................................... 57
5.2.3
ライブラリの検索に関する制御 ................................................................................. 58
5.2.4
エントリアドレス / シンボル値の設定 ....................................................................... 59
5.3 セクションの種類 ................................................................................................................. 60
5.4 セクションの結合 ................................................................................................................. 62
5.5 セクションの配置 ................................................................................................................. 63
5.5.1
セクションの結合順序が指定されなかった場合の配置例.......................................... 64
5.5.2
セクションの結合順序が指定された場合の配置例 .................................................... 65
5.5.3
セクショングループの指定がある場合の配置例 ........................................................ 66
5.6 セクションの自動配置.......................................................................................................... 67
5.6.1
-AL 1 が指定された場合のセクションの自動配置...................................................... 68
5.6.2
-AL 2 が指定された場合のセクションの自動配置...................................................... 71
5.7 ライブラリの検索 ................................................................................................................. 74
5.7.1
ライブラリファイルが 1 つの場合の検索例 1 ............................................................ 76
5.7.2
ライブラリファイルが 1 つの場合の検索例 2 ............................................................ 77
5.7.3
ライブラリファイルが 1 つの場合の検索例 3 ............................................................ 78
5.7.4
ライブラリファイルが複数の場合の検索例 1 ............................................................ 79
5.7.5
ライブラリファイルが複数の場合の検索例 2 ............................................................ 80
5.7.6
ライブラリファイルが個別に指定された場合の処理................................................. 81
5.8 ROM/RAM 領域 .................................................................................................................... 82
5.9 ROM → RAM 転送セクション.............................................................................................. 83
5.10 CPU 情報ファイル................................................................................................................ 86
5.11 リンカでのオブジェクト混在 ............................................................................................... 87
第6章
リンカのオプション................................................................................. 89
6.1 リンカのオプション一覧 ...................................................................................................... 90
6.2 リンカのオプション詳細 ...................................................................................................... 93
6.2.1
出力ロードモジュールファイル名指定 (-o)................................................................ 94
6.2.2
デバッグ情報の出力指定 (-g) ..................................................................................... 96
6.2.3
デバッグ情報の削除指定 (-Xg) ................................................................................... 97
6.2.4
絶対形式ロードモジュールの出力指定 (-a)................................................................ 98
6.2.5
相対形式ロードモジュールの出力指定 (-r)................................................................. 99
6.2.6
ROM 領域のフィル指定 (-fill).................................................................................... 100
6.2.7
マップリストファイル名の指定 (-m)........................................................................ 103
6.2.8
マップリスト出力の抑止指定 (-Xm)......................................................................... 104
6.2.9
リスト表示の名前の省略解除 (-dt) ........................................................................... 105
6.2.10
メモリ使用情報リストの出力指定 (-mmi) ................................................................ 106
6.2.11
リスト行の桁数指定 (-pw) ........................................................................................ 107
6.2.12
リスト 1 ページの行数指定 (-pl)............................................................................... 108
6.2.13
ROM 領域のチェックサム指定 (-cs)......................................................................... 109
iv
CM25-00321-5, September 1, 2014
Support
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
第7章
7.1
7.2
Soft
Ma nual
警告メッセージ出力レベルの指定 (-w) .................................................................... 116
ROM 領域の指定 (-ro)............................................................................................... 117
RAM 領域の指定 (-ra) ............................................................................................... 118
セクション配置順 / アドレスの指定 (-sc)................................................................. 119
セクショングループの指定 (-gr)............................................................................... 122
レジスタバンク領域の指定 (-rg)............................................................................... 123
自動配置指定 (-AL) ................................................................................................... 125
検索ライブラリファイルの指定 (-l).......................................................................... 127
ライブラリ検索パスの指定 (-L)................................................................................ 128
シンボル個別のライブラリの指定 (-el) .................................................................... 129
ライブラリ検索の抑止指定 (-nl) ............................................................................... 130
デフォルトライブラリ検索の抑止指定 (-nd)............................................................ 131
エントリアドレスの指定 (-e) ................................................................................... 132
外部シンボル値の仮設定 (-df) .................................................................................. 133
ターゲット CPU 指定 (-cpu)..................................................................................... 134
CPU 情報ファイル指定 (-cif) .................................................................................... 135
デバッグ情報存在チェック抑止指定 (-NCI0302LIB)................................................ 136
内蔵 ROM/RAM 領域の自動設定 (-set_rora) ............................................................ 137
内蔵 ROM/RAM 領域自動設定の抑止指定 (-Xset_rora) ........................................... 138
ユーザ指定領域のチェック指定 (-check_rora)......................................................... 139
ユーザ指定領域のチェック抑止指定 (-Xcheck_rora) ............................................... 141
セクション配置領域チェック指定 (-check_locate) .................................................. 142
セクション配置領域チェック抑止指定 (-Xcheck_locate) ........................................ 145
ユーザ指定外セクションのチェック指定 (-check_section) ..................................... 146
ユーザ指定外セクションのチェック抑止指定 (-Xcheck_section)............................ 148
オブジェクト混在チェック指定 (-objmixchk)........................................................... 149
オブジェクト混在チェック抑止指定 (-Xobjmixchk) ................................................. 150
相対アセンブルリスト入力ディレクトリ指定 (-alin) ............................................... 151
絶対アセンブルリスト出力ディレクトリ指定 (-alout) ............................................. 152
絶対アセンブルリスト出力指定 (-als) ...................................................................... 153
絶対アセンブルリスト出力モジュール指定 (-alsf) ................................................... 154
絶対アセンブルリスト出力抑止指定 (-Xals) ............................................................ 155
ROM/RAM, ARRAY リスト出力指定 (-alr) ............................................................... 156
ROM/RAM, ARRAY リスト出力モジュール指定 (-alrf) ............................................ 157
ROM/RAM, ARRAY リスト出力抑止指定 (-Xalr)...................................................... 158
ROM/RAM, ARRAY リストのシンボルとアドレスの表示位置指定 (-na, -an) ......... 159
外部シンボル相互参照情報リスト出力指定 (-xl) ...................................................... 161
外部シンボル相互参照情報リストファイル名の指定 (-xlf)....................................... 162
外部シンボル相互参照情報リスト出力抑止指定 (-Xxl) ............................................ 163
ローカルシンボル情報リスト出力指定 (-sl) ............................................................. 164
ローカルシンボル情報リストファイル名の指定 (-slf).............................................. 165
ローカルシンボル情報リスト出力抑止指定 (-Xsl).................................................... 166
セクション詳細マップリスト出力指定 (-ml) ............................................................ 167
セクション詳細マップリストファイル名の指定 (-mlf)............................................. 168
セクション詳細マップリスト出力抑止指定 (-Xml) .................................................. 169
リンカの出力リストファイル ................................................................ 171
リンカの出力するリストファイルの種類 ........................................................................... 172
リンクリストファイル........................................................................................................ 173
September 1, 2014, CM25-00321-5
v
Su pp or t
So ft
Manu al
7.2.1
コントロールリスト ................................................................................................. 174
7.2.2
マップリスト ............................................................................................................ 176
7.2.3
メモリ使用情報リスト ............................................................................................. 178
7.2.4
シンボルリスト ........................................................................................................ 180
7.3 絶対アセンブルリストファイル ......................................................................................... 181
7.3.1
ヘッダ , インフォメーションリスト......................................................................... 183
7.3.2
ROM/RAM, ARRAY リスト ...................................................................................... 184
7.3.3
アセンブルソースリスト .......................................................................................... 186
7.3.4
セクション情報リスト ............................................................................................. 188
7.3.5
クロスリファレンスリスト ...................................................................................... 189
7.4 外部シンボル相互参照情報リストファイル ....................................................................... 190
7.5 ローカルシンボル情報リストファイル............................................................................... 191
7.6 セクション配置詳細情報リストファイル ........................................................................... 192
第8章
8.1
8.2
リンカの制限事項および Q&A............................................................... 195
リンカの制限事項 ............................................................................................................... 196
リンカの使用上の Q&A ...................................................................................................... 197
第 III 部
ライブラリアン編 ................................................................................. 199
第9章
ライブラリアンの仕様 ........................................................................... 201
9.1
9.2
9.3
9.4
9.5
9.6
9.7
ライブラリアンの機能........................................................................................................ 202
ライブラリアンの機能分類................................................................................................. 203
ライブラリファイルの作成編集 ......................................................................................... 204
ライブラリファイル内のモジュール抽出 ........................................................................... 206
ライブラリのデバッグ情報の削除...................................................................................... 207
ライブラリファイルの内容チェックと表示 ....................................................................... 208
ライブラリアンでのオブジェクト混在............................................................................... 209
第 10 章
ライブラリアンのオプション ................................................................ 211
10.1 ライブラリアンのオプション一覧...................................................................................... 212
10.2 ライブラリアンのオプション詳細...................................................................................... 214
10.2.1
モジュールの追加 ( 登録 )(-a)................................................................................... 215
10.2.2
モジュールの置換 ( 登録 )(-r).................................................................................... 217
10.2.3
モジュールの削除 (-d) .............................................................................................. 218
10.2.4
モジュールの抽出 (-x) .............................................................................................. 219
10.2.5
リストファイルの出力指定 (-m)............................................................................... 220
10.2.6
リストファイルの出力抑止指定 (-Xm) ..................................................................... 221
10.2.7
リストファイルの詳細情報の出力指定 (-dt)............................................................. 222
10.2.8
リスト 1 ページの行数指定 (-pl)............................................................................... 223
10.2.9
リスト 1 行の桁数指定 (-pw) .................................................................................... 224
10.2.10
バックアップファイルの作成 (-b) ............................................................................ 225
10.2.11
バックアップファイルの作成抑止 (-Xb)................................................................... 226
10.2.12
ライブラリファイルの内容検査 (-c)......................................................................... 227
10.2.13
ファイル内容の最適化 (-O) ...................................................................................... 228
10.2.14
デバッグ情報の出力指定 (-g) ................................................................................... 229
10.2.15
デバッグ情報の出力抑止指定 (-Xg).......................................................................... 230
10.2.16
ターゲット CPU 指定 (-cpu)..................................................................................... 231
10.2.17
CPU 情報ファイル指定 (-cif) .................................................................................... 232
vi
CM25-00321-5, September 1, 2014
Support
10.2.18
10.2.19
第 11 章
11.1
11.2
11.3
11.4
Soft
Ma nual
オブジェクト混在チェック指定 (-objmixchk)........................................................... 233
オブジェクト混在チェック抑止指定 (-Xobjmixchk) ................................................. 234
ライブラリアンのリストフォーマット .................................................. 235
リストファイルの情報内容................................................................................................. 236
モジュール名リスト ........................................................................................................... 237
モジュールごとの詳細情報................................................................................................. 238
ライブラリ内の外部定義 / 参照シンボル情報..................................................................... 239
第 12 章
ライブラリアンの制限事項および Q&A ................................................ 241
12.1 ライブラリアンの制限事項................................................................................................. 242
12.2 ライブラリアンの使用上の Q&A ........................................................................................ 243
第 IV 部
オブジェクト形式コンバータ編............................................................ 245
第 13 章
オブジェクト形式コンバータの仕様...................................................... 247
13.1 オブジェクト形式コンバータの概要 .................................................................................. 248
13.2 オブジェクト形式コンバータの種類 .................................................................................. 250
13.3 オブジェクト形式コンバータの実行 .................................................................................. 252
第 14 章
オブジェクト形式コンバータの共通オプション.................................... 253
14.1 オブジェクト形式コンバータのオプション一覧 ................................................................ 254
14.2 出力ファイル名の変更 (-o) ................................................................................................. 255
14.3 パディング (-p) ................................................................................................................... 257
第 15 章
ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es) .......................... 259
15.1 ロードモジュールコンバータの概要 .................................................................................. 260
15.2 ロードモジュールコンバータのオプション一覧 ................................................................ 261
15.3 ロードモジュールコンバータのオプション詳細 ................................................................ 262
15.3.1
出力 S フォーマット指定 (-S1/-S2/-S3) ................................................................... 263
15.3.2
出力 HEX フォーマット指定 (-I16/-I20/-I32) ............................................................ 264
15.3.3
スタートアドレスレコード出力指定 (-entry) ........................................................... 265
15.3.4
スタートアドレスレコード出力抑止指定 (-Xentry).................................................. 267
15.3.5
整形指定 (-adjust) ..................................................................................................... 268
15.4 f2ms ( 絶対形式ロードモジュール→ S フォーマット変換 ) ............................................... 269
15.5 f2hs ( 絶対形式ロードモジュール→ HEX フォーマット変換 ) ........................................... 270
15.6 f2is ( 絶対形式ロードモジュール→ HEX8 フォーマット変換 ),
f2es ( 絶対形式ロードモジュール→ HEX16 フォーマット変換 ) ....................................... 271
第 16 章
フォーマットアジャスタの仕様 (m2ms,h2hs)...................................... 273
16.1 フォーマットアジャスタの概要 ......................................................................................... 274
16.2 フォーマットアジャスタのオプション一覧 ....................................................................... 277
16.3 フォーマットアジャスタのオプション詳細 ....................................................................... 278
16.3.1
出力レコード内データ長指定 (-len) ......................................................................... 279
16.3.2
出力範囲指定 (-ran) .................................................................................................. 280
16.3.3
出力 S フォーマット指定 (-S1/-S2/-S3) ................................................................... 281
16.3.4
出力 HEX フォーマット指定 (-I16/-I20/-I32) ............................................................ 283
16.3.5
開始アドレス変更指定 (-ST) .................................................................................... 284
September 1, 2014, CM25-00321-5
vii
Su pp or t
第 17 章
So ft
Manu al
バイナリコンバータ (m2bs, h2bs)........................................................ 285
17.1 バイナリコンバータの概要................................................................................................. 286
17.2 バイナリコンバータのオプション一覧............................................................................... 288
17.3 バイナリコンバータのオプション詳細............................................................................... 289
17.3.1
出力範囲指定 (-ran) .................................................................................................. 290
17.3.2
スプリットモード指定 (-sp) ..................................................................................... 292
17.3.3
スプリットモード抑止指定 (-Xsp)............................................................................ 293
17.3.4
マップリストファイルの作成指定 (-m) .................................................................... 294
17.3.5
マップリストファイルの作成抑止指定 (-Xm) .......................................................... 296
第 18 章
18.1
18.2
18.3
18.4
その他のコンバータ............................................................................... 297
m2is (S フォーマット→ HEX8 フォーマット変換 ) ........................................................... 298
m2es (S フォーマット→ HEX16 フォーマット変換 ) ........................................................ 299
i2ms (HEX8 フォーマット→ S フォーマット変換 ) ........................................................... 300
e2ms (HEX16 フォーマット→ S フォーマット変換 ) ........................................................ 301
第 19 章
オブジェクト形式コンバータの制限事項および Q&A........................... 303
19.1 オブジェクト形式コンバータの制限事項 ........................................................................... 304
19.2 オブジェクト形式コンバータの使用上の Q&A .................................................................. 305
付録
付録 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
付録 I
viii
............................................................................................................... 307
リンケージキットのエラーメッセージ ......................................................................... 308
HEX フォーマット........................................................................................................ 337
一般形式...................................................................................................................... 338
データレコード (HEX8/HEX16/HEX32) タイプ:00 .................................................. 339
エンドレコード (HEX8/HEX16/HEX32) タイプ:01 .................................................. 340
拡張セグメントアドレスレコード (HEX16/HEX32) タイプ:02 ............................... 341
スタートセグメントアドレスレコード (HEX16/HEX32) タイプ:03 ........................ 342
拡張リニアアドレスレコード (HEX32) タイプ:04 ................................................... 343
スタートリニアアドレスレコード (HEX32) タイプ:05 ............................................ 344
S レコード形式.............................................................................................................. 345
S0 タイプ ( ヘッダレコード )...................................................................................... 346
S1 タイプ ( データレコード:2 バイトアドレス ) ...................................................... 347
S2 タイプ ( データレコード:3 バイトアドレス ) ...................................................... 348
S3 タイプ ( データレコード:4 バイトアドレス ) ...................................................... 349
S5 タイプ ( レコード数管理レコード ) ....................................................................... 350
S7 タイプ ( ターミネータレコード )........................................................................... 351
S8 タイプ ( ターミネータレコード )........................................................................... 352
S9 タイプ ( ターミネータレコード )........................................................................... 353
リンカのオプション一覧表 ........................................................................................... 354
ライブラリアンのオプション一覧表 ............................................................................. 357
オブジェクト形式コンバータのコマンドおよびオプション一覧表 .............................. 359
OS による仕様の相違点 ................................................................................................ 361
SOFTUNE 言語ツール移行時のオブジェクト同一性確認方法 ..................................... 362
比較手順の概略 ........................................................................................................... 363
実施例 ......................................................................................................................... 364
データに差異が生じている場合.................................................................................. 365
SOFTUNE リンカ (FLNK896S) と旧版リンカ (LINK96) の仕様の差異について .......... 367
CM25-00321-5, September 1, 2014
Support
付録 J
付録 K
索引
Soft
Ma nual
SOFTUNE ライブラリアン (FLIB896S) と
旧版ライブラリアン (LIB96) の仕様の差異について..................................................... 372
主な変更内容 ................................................................................................................. 375
............................................................................................................... 377
September 1, 2014, CM25-00321-5
ix
Su pp or t
x
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
第I部
Soft
Ma nual
リンケージキット編
リンケージキットに含まれるツールの概要と , ツール全体に共通する項目について
説明します。
第 1 章 リンケージキットの仕様
第 2 章 オプション
第 3 章 共通オプション
第 4 章 オプションファイル
September 1, 2014, CM25-00321-5
1
Su pp or t
2
So ft
Manu al
CM25-00321-5, September 1, 2014
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 環境変数
September 1, 2014, CM25-00321-5
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
絶対形式アセンブルリスト
.als
.abs
リンカ出力リスト
ROM化オブジェクト形式
.mpx
.mpm
.mps
.mhx
.ihx
.ehx
.hex
デバッガ
4
ROMライタ
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.2 起動方法
Support
1.2
Soft
Ma nual
起動方法
リンケージキット ( リンカ , ライブラリアン , オブジェクト形式コンバータ ) を実行
するための , コマンドラインの形式および指定方法について説明します。
■ コマンドラインの形式
SOFTUNE リンケージキットのコマンドラインの指定方法 ( 起動コマンドシンタックス )
は , 次のとおりです。
• コマンドラインの指定方法 : コマンド名に続けて , ファイル名とオプションを必要
なだけ繰り返し指定する。
以下の説明では , オプションの指定をコマンド名の次にしてありますが , オプションの
記述位置は , ファイル名の前後どちらでもかまいません。オプションについて , 詳しく
は「第 2 章 オプション」を参照してください。
● リンカ
flnk896s [ オプション ] … < ファイル名 > …
コマンド名 flnk896s は , 使用するツールのターゲット CPU 毎に異なります。
以下にターゲット CPU 毎のコマンド名を示します。
< ファイル名 > には , 入力するオブジェクトモジュールファイル名を指定します。
複数のファイル名を指定するときは , スペースを入れます。
また ,*.obj のようにワイルドカードの使用もできます。ファイル名のワイルドカード
の展開は OS に依存しますので ,「付録 G OS による仕様の相違点」を参考にしてくだ
さい。
リンカでは ,-cpu オプションでターゲット CPU の指定が必要です。リンク処理実行の
際は , 必ず -cpu オプションを指定してください。
● ライブラリアン
flib896s [ オプション ] … < ファイル名 >
コマンド名 flib896s は , 使用するツールのターゲット CPU 毎に異なります。
< ファイル名 > には , 編集対象のライブラリファイルを指定します。
ライブラリアンでは ,-cpu オプションでターゲット CPU の指定が必要です。ライブラ
リ処理実行の際は , 必ず -cpu オプションを指定してください。
September 1, 2014, CM25-00321-5
5
第 1 章 リンケージキットの仕様
1.2 起動方法
Su pp or t
So ft
Manu al
● オブジェクト形式コンバータ
コマンド名 [ オプション ] … < ファイル名 >
< ファイル名 > には , それぞれのツールの機能に応じたオブジェクト形式のファイル名
を指定します。以下の 3 形式のファイルが対象となります。
• リンカ出力の絶対形式ロードモジュール
• S フォーマット
• HEX フォーマット
6
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.3 強制終了
Support
1.3
Soft
Ma nual
強制終了
プログラムの実行を途中で止めたい場合は , CTRL キーを押しながら , C キーを押
す ( 以降 , "CTL-C を押す " と記述します ) ことにより行えます。CTL-C が押される
と , プログラムの実行が中断されます。
■ 強制終了
CTL-C により , プログラム処理を中止した場合 , 出力結果のファイルは正しく作成され
ません。リンケージキットが実行時に使用する作業ファイルは消去されます。
September 1, 2014, CM25-00321-5
7
第 1 章 リンケージキットの仕様
1.4 終了コード
Su pp or t
1.4
So ft
Manu al
終了コード
リンケージキットの各ツールは , その処理の終了状態を終了コードとして OS に返し
ます。
■ 終了コードの値と終了状態
リンケージキットの各ツールは , その処理の終了状態 ( 正常に終了したかまたはエラー
が発生したかなどの状態 ) を終了コードとして OS に返します。終了コードと処理の終
了状態の関係を , 表 1.4-1 に示します。
表 1.4-1 終了コードと処理の終了状態
終了コード
8
処理の終了状態
0
正常に終了または警告レベルのエラーがあったとき
1
-cwno オプション指定時で , 警告レベルのエラーがあったとき
2
正しい出力結果を作成できないようなエラーがあったとき
3
処理の続行が不可能となる致命的エラーがあったとき
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.5 起動メッセージ
Support
1.5
Soft
Ma nual
起動メッセージ
リンケージキットは , -V オプションで起動メッセージの表示を行います。デフォル
ト処理では , 起動メッセージの表示は行いません。
■ 起動メッセージと -V オプション
リンケージキットは , デフォルト処理では , 処理中に検出されたエラーに関するメッ
セージを表示しますが , 起動を示すメッセージは表示しません。起動時にメッセージ表
示を行いたい場合は ,-V オプションを用います。
また ,-V オプションを無効にしたい場合は ,-V オプションの後に -XV オプションを指
定します。詳しくは「3.2.4 版数 / メッセージ出力指定 (-V)」,「3.2.5 版数 / メッセー
ジ出力抑止 (-XV)」を参照してください。
■ 起動メッセージ
起動メッセージは , プログラム名と版数 , 著作権表示で構成されます。
September 1, 2014, CM25-00321-5
9
第 1 章 リンケージキットの仕様
1.6 終了メッセージ
Su pp or t
1.6
So ft
Manu al
終了メッセージ
リンケージキットは , -cmsg オプションで終了メッセージの表示を行います。デ
フォルト処理では , 終了メッセージの表示は行いません。
■ 終了メッセージと -cmsg オプション
リンケージキットは , デフォルト処理では , 処理中に検出されたエラーに関するメッ
セージを表示しますが , 終了を示すメッセージは表示しません。終了時にメッセージ表
示を行いたい場合は ,-cmsg オプションを用います。
また ,-cmsg オプションを無効にしたい場合は ,-cmsg オプションより後に -Xcmsg オプ
ションを指定します。詳しくは「3.2.6 終了メッセージ表示指定 (-cmsg)」,「3.2.7 終了
メッセージ表示抑止指定 (-Xcmsg)」を参照してください。
■ 終了メッセージ
終了メッセージは , ツール名 , エラーの有無を表示します。
以下に , 終了メッセージ例を示します。
エラーがない場合
プログラム名 COMPLITED FOUND NO ERROR
エラーがあった場合
プログラム名 COMPLITED FOUND ERROR
10
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.7 ヘルプメッセージ
Support
1.7
Soft
Ma nual
ヘルプメッセージ
ヘルプメッセージとして表示されるメッセージは , 以下の 2 種類です。
• コマンドラインの記述形式
• 起動時オプションの一覧
■ ヘルプメッセージ
起動時にコマンド名以外何も指定しなかった場合または -help オプションを指定したと
き , コマンドラインの記述形式と起動時オプションの一覧を表示して終了します。詳し
くは「3.2.3 ヘルプメッセージの表示 (-help)」を参照してください。
● ヘルプメッセージの例
以下に , リンカの場合 ( 英文 ) のヘルプメッセージの例を示します。
図 1.7-1 ヘルプメッセージの例
usage : flnk896s [-option...] object [object...]
*1
---------options :
-------- linker mode option --------r
:relocatable linking mode
-a
:absolute linking mode(default)
-------- library option --------l filename [, ...]
-nl
-nd
:set library file name
*2
:not search library file
:not search default library file
:
:
( 例の説明 )
*1: コマンドラインシンタックス ( 起動方法 ) の表示。
*2: オプションの一覧および , 簡単な説明。
なお , メッセージは , 環境変数 FELANG(「1.10.2 FELANG」参照 ) 設定により , 日本語
で表示することも可能です。
September 1, 2014, CM25-00321-5
11
第 1 章 リンケージキットの仕様
1.8 識別子
Su pp or t
1.8
So ft
Manu al
識別子
リンケージキットでプログラム作成時などに扱う識別子には , 以下の 7 種類があり
ます。
• ファイル名
• モジュール名
• オプション名
• セクション名
• グループ名
• ROM/RAM 領域名
• シンボル名
■ 識別子の構成文字種
識別子に使用可能な文字種は , 以下のとおりです。
• 英字
• 数字
• アンダースコア (_)
先頭文字に数字の使用は許されません。
また , ファイル名に使用可能な文字の種類は , 動作 OS に準拠します。したがって , ファ
イル名から作られるモジュール名も同等です。
■ 識別子の区別
英字の大文字小文字は区別されます。
■ 識別子文字数の制限
識別子の文字数は , 255 文字 (255 バイト ) 以内です。これを超える長さの文字列は , 255
バイトで打ち切ります。
■ リスト出力時の識別名表示
リンケージキットが作成する各種リストファイル中では , 常に 255 文字までの識別子の
名前全部を表示するようにはしていません。
長い識別子の名前は , 先頭の 20 文字程度のみを出力し , 残りの部分は表示していない
ものもあります。
1 行の中に表示される文字数は , リストのページ幅指定の変更で増減しますので , 見や
すいフォーマットを選択できます。
また , 複数行にわたりますが , 省略せずに表示するオプションも用意してあります。
12
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.9 ファイル名規則
Support
1.9
Soft
Ma nual
ファイル名規則
入出力ファイルのファイル名は , OS での使用制限に準じています。
ファイル名は , オブジェクトモジュール中にも設定されますので , 文字数やコード系
に注意する必要がある場合があります。
■ ファイル名の文字数
入出力ファイルのファイル名は ,OS での使用制限に準じています。
■ ファイル名の文字コード
C やアセンブラのソースファイル名は , 出力されるオブジェクトモジュール内に , ソー
スファイル名情報として設定されるほか , モジュール名としても設定されます。
モジュール名には ,「1.8 識別子」で示されるように英字 , 数字 , アンダースコア (_) し
か使用できません。したがって , 漢字や空白を用いたファイル名では , アセンブル時に ,
モジュール名を指定するなどの工夫が必要です。
● ファイル名として使用できる文字
(Windows 版 )
英字 , 数字 , 仮名文字 , シフト JIS 漢字コードおよび下記以外の記号が使用できます。
\/ :;,*?" <>|
空白を含むファイル名を指定する場合には , ファイル名を二重引用符 (") で括ってくだ
さい。
環境変数に空白を含むディレクトリ名を指定する場合には , 二重引用符 (") で括らない
でください。
September 1, 2014, CM25-00321-5
13
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
So ft
Manu al
1.10 環境変数
リンケージキットでは , 以下の 6 種類の環境変数をサポートしています。
• TMP
• FELANG
• FETOOL
• LIB896
• OPT896
• OPT
■ TMP( ワークディレクトリ )
TMP は , 作業用ディレクトリを指定します。詳しくは「1.10.1 TMP ( ワークディレク
トリ )」を参照してください。
■ FELANG
FELANG は , メッセージの言語の選択 , 指定を行います。詳しくは「1.10.2 FELANG」
を参照してください。
■ FETOOL
FETOOL は , 開発ツールをインストールしたディレクトリを指定します。詳しくは
「1.10.3 FETOOL」を参照してください。
■ LIB896( ライブラリファイル検索ディレクトリ )
LIB896は,ライブラリを格納したディレクトリを指定します。詳しくは,「1.10.4 LIB896」
を参照してください。
■ OPT896( デフォルトオプションファイル格納ディレクトリ )
OPT896 は , リンカおよびライブラリアンのデフォルトオプションファイルを格納した
ディレクトリを指定します。詳しくは ,「1.10.5 OPT896」を参照してください。
■ OPT( デフォルトオプションファイル格納ディレクトリ )
OPT は , オブジェクトツールのデフォルトオプションファイルを格納したディレクト
リを指定します。詳しくは ,「1.10.6 OPT」を参照してください。
14
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10.1
Soft
Ma nual
TMP ( ワークディレクトリ )
TMP( ワークディレクトリ ) は , リンケージキットが実行時に使用する作業用のディ
レクトリを指定します。
TMP の記述形式 , 説明 , 指定例を示します。
■ TMP( ワークディレクトリ )
【記述形式】
SET TMP=< パス名 >
【説明】
リンケージキットが実行時に使用する作業用のディレクトリを指示します。
この環境変数 TMP は , ほかの開発ツール (C コンパイラやアセンブラなど ) でも使
用されます。
環境変数 TMP の設定がないときはカレントディレクトリを使用します。
【例】
SET TMP=G:\WORK
September 1, 2014, CM25-00321-5
15
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
1.10.2
So ft
Manu al
FELANG
FELANG は , ヘルプメッセージおよびエラーメッセージ表示のメッセージ言語の選
択 , 指定を行います。
FELANG の記述形式 , 説明 , 指定例を示します。
■ FELANG
【記述形式】
SET FELANG={ASCII|EUC|SJIS}
ASCII : 英語 ASCII コード ( デフォルト )
EUC : 日本語 EUC コード
SJIS
: 日本語 SJIS コード
【説明】
ヘルプメッセージおよびエラーメッセージ表示の日本語 / 英語 ( メッセージ言語 ) の
選択 , 指定を行います。
指定がない場合は , 英語のメッセージ (ASCII 指定 ) が選択されます。日本語環境の
ないシステムで ,EUC または SJIS 以外のコード系をご使用の場合には ,FELANG 環
境変数の設定を行わないか ,ASCII を指定してください。
この環境変数 FELANG は , ほかの開発ツール (C コンパイラやアセンブラなど ) で
も使用されます。
【例】
SET FELANG=ASCII
16
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10.3
Soft
Ma nual
FETOOL
FETOOL は , リンケージキットをインストールした親ディレクトリを指定します。
FETOOL の記述形式 , 説明 , 指定例などを示します。
■ FETOOL
【記述形式】
SET FETOOL=< パス名 >
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
リンケージキットをインストールしたディレクトリを指定します。
リンケージキットは , ここで指定したディレクトリを起点として , メッセージファ
イルやライブラリファイルの格納ディレクトリを知り , 実行に必要なファイルをア
クセスします。
指定がない場合は , 実行されたロードモジュールのあるディレクトリの親ディレク
トリとなります。
この環境変数 FETOOL は , ほかの開発ツール (C コンパイラやアセンブラなど ) で
も使用されます。
【例】
SET FETOOL=D:\Softune
【推奨ディレクトリ構造】
図 1.10-1 推奨ディレクトリ構造
\ Softune
\ BIN
リンケージキットのロードモジュールを格納
\ LIB
ターゲットCPUに依存しないメッセージファイルを格納
\ 896
ライブラリファイルおよびメッセージファイルを格納
【補足】
リンケージキットは , 上記のようなディレクトリ構造に各ファイルを格納して実行
されることを前提に作成されています。
FETOOL 環境変数は ,"Softune" ディレクトリのパスをリンケージキットに知らせる
ものです。
September 1, 2014, CM25-00321-5
17
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
1.10.4
So ft
Manu al
LIB896
LIB896( ライブラリファイル検索ディレクトリ ) は , リンカが検索するライブラリ
ファイルを格納したディレクトリを指定します。
LIB896 の記述形式 , 説明 , 指定例などを示します。
■ LIB896
【記述形式】
SET LIB896=< パス名 > [ ;< パス名 > … ]
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
リンカが検索するライブラリファイルを格納したディレクトリを指定します。
通常は ,C ライブラリを格納したディレクトリを指定しておきます。
複数の検索パスを指定する場合は ,< パス名 > を次の記号で区切ります。
• セミコロン (;)
複数指定時の検索順は , 指定した順となります。
環境変数名 LIB896 は , 使用するリンカにより異なります。
【例】
SET LIB896=D:\Softune\LIB\896
【補足】
環境変数 FETOOL が指定されている場合 , 前項で説明したディレクトリ構造のライ
ブラリ格納ディレクトリも検索されますので , 環境変数 LIB896 の設定を行わなく
ても C ライブラリは検索されます。
ライブラリ検索パスは , リンカ実行時のオプション -L でも指定できます。
これらの複合指定によるライブラリ検索パスの優先順位は次のようになります。
1. リンカのオプション -L で指定されたディレクトリ
2. 環境変数 LIB896 で指定されたディレクトリ
3. 環境変数 FETOOL より導かれるディレクトリ (%FETOOL%\LIB\896)
ユーザがライブラリを作成した場合などは ,C ライブラリとの検索順に注意してパ
スの指定を行ってください。
18
CM25-00321-5, September 1, 2014
第 1 章 リンケージキットの仕様
1.10 環境変数
Support
1.10.5
Soft
Ma nual
OPT896
OPT896( デフォルトオプションファイル格納ディレクトリ ) は , リンカおよびライ
ブラリアンのデフォルトオプションファイルを格納したディレクトリを指定します。
OPT896 の記述形式 , 説明 , 指定例などを示します。
■ OPT896
【記述形式】
SET OPT896=< パス名 >
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
リンカおよびライブラリアンで使用するデフォルトオプションファイルを格納し
たディレクトリを指定します。
環境変数名 OPT896 は , 使用するツールのターゲット CPU 毎に異なります。
この環境変数は省略できます。
省略した場合は,開発環境ディレクトリ内のデフォルトオプションファイルを参照しま
す。
開発環境ディレクトリ内のデフォルトオプションファイルは次のとおりです。
● リンカ
%FETOOL%\LIB\896\FLNK896.OPT
● ライブラリアン
%FETOOL%\LIB\896\FLIB896.OPT
【例】
SET OPT896=D:\Softune\LIB\896
September 1, 2014, CM25-00321-5
19
第 1 章 リンケージキットの仕様
1.10 環境変数
Su pp or t
1.10.6
So ft
Manu al
OPT
OPT( デフォルトオプションファイル格納ディレクトリ ) は , オブジェクトツールの
デフォルトオプションファイルを格納したディレクトリを指定します。
OPT の記述形式 , 説明 , 指定例などを示します。
■ OPT
【記述形式】
SET OPT=< パス名 >
< パス名 > には , ドライブ名を含めて指定してください。
【説明】
オブジェクトツールで使用するデフォルトオプションファイルを格納したディレ
クトリを指定します。
この環境変数は省略できます。
省略した場合は , 開発環境ディレクトリ内のデフォルトオプションファイルを参照
します。
開発環境ディレクトリ内のデフォルトオプションファイルは次のとおりです。
● オブジェクトツール
• %FETOOL%\LIB\F2M.OPT
• %FETOOL%\LIB\F2H.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
• %FETOOL%\LIB\M2B.OPT
• %FETOOL%\LIB\M2M.OPT
• %FETOOL%\LIB\H2B.OPT
• %FETOOL%\LIB\H2H.OPT
【例】
SET OPT=D:\Softune\LIB
20
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第2章
オプション
リンケージキットのオプションについて説明しま
す。
2.1 オプション
2.2 オプションパラメータでの数値表現
2.3 オプション指定時の注意と評価
2.4 包含 / 相反関係にあるオプションの指定
2.5 コマンドラインの指定例
September 1, 2014, CM25-00321-5
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=0x0100
22
CM25-00321-5, September 1, 2014
第 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 は同じ。
September 1, 2014, CM25-00321-5
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=0x8000
-sc DATA=0x200: セクション配置指定 ( リンカ )
-sc DATA=0x200 -sc CODE=0x8000 としても , セクション配置は個々に独立のため
同等の指定となります。
24
CM25-00321-5, September 1, 2014
第 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 は取り消され , リスト出力は行われま
せん。
September 1, 2014, CM25-00321-5
25
第 2 章 オプション
2.5 コマンドラインの指定例
Su pp or t
2.5
So ft
Manu al
コマンドラインの指定例
コマンドライン指定例を 3 種類示し , 説明します。
■ コマンドラインの指定例
【例 1】
flnk896s
flnk896s file1.obj file2.obj -g -a -help
コマンド名だけの指定の場合 , もしくは , 途中で , オプションがわからなくなったと
きなど , -help オプション HELP を指定すると , 簡単なヘルプメッセージを表示しま
す。
【例 2】
flib896s
sys.lib
-m sys.mp2
…
*1
flib896s
-m sys.mp2
sys.lib
…
*2
オプションの指定位置は決まっていませんので , コマンドラインで自由に記述でき
ます。
*1 と *2 の指定はどちらも有効であり , 同等の指定です。
【例 3】
flnk896s *.obj -g -o sample.abs
ワイルドカードを使用した , 複数入力ファイル名の指定。
26
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第3章
共通オプション
リンケージキットには , どのツールにも共通して使
用できるオプションがあります。これらのオプ
ションは , C コンパイラやアセンブラにも用意され
ています。
リンケージキットの共通オプションについて説明
します。また , ツール固有のオプションについて
は , それぞれの部で説明します。
3.1 共通オプション一覧
3.2 共通オプション詳細
September 1, 2014, CM25-00321-5
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
備考
デフォルト
デフォルト
デフォルト
CM25-00321-5, September 1, 2014
第 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)」を参照して
ください。
September 1, 2014, CM25-00321-5
29
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
So ft
Manu al
■ -Xcwno オプション
プログラムでワーニングが発生した場合に , 終了コードとして , OS に 0 を返します。
詳しくは , 「3.2.9 ワーニング発生時の終了コードを 0 にする指定 (-Xcwno)」を参照し
てください。
30
CM25-00321-5, September 1, 2014
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.1
Soft
Ma nual
デフォルトオプションファイル抑止指定 (-Xdof)
デフォルトオプションファイルの読込みを取り消します。
本オプションの指定がない場合 , デフォルトオプションファイルは常に読み込まれ
ます。
■ デフォルトオプションファイル抑止指定 (-Xdof)
【記述形式】
-Xdof
【パラメータ】
なし
【説明】
デフォルトオプションの読込みを取り消します。
本オプションの指定がない場合 , デフォルトオプションファイルは常に読み込まれ
ます。
デフォルトオプションファイルに関しては , 「4.5 デフォルトオプションファイル」
を参照してください。
【注意】
本オプションは , コマンドラインでの指定のみ有効です。
【例】
flnk896s test.obj -Xdof
September 1, 2014, CM25-00321-5
31
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.2
So ft
Manu al
オプションファイルからの読込み指定 (-f)
-f オプションは , オプションを記述したファイルからオプションを読み込むことを指
示します。また , このファイル内容を , コマンドラインに指定されたものと同等に扱
います。
■ オプションファイルからの読込み指定 (-f)
【記述形式】
-f < オプションファイル名 >
【パラメータ】
< オプションファイル名 > オプションや入力ファイルを記述したファイル名
【説明】
< オプションファイル名 > で指定したファイルに , オプションや入力ファイル名を
記述しておきます。
オプションを記述したファイルから , オプションを読み込むことを指示します。
このファイル内容を , コマンドラインでの指定と同様に評価し , 処理します。
ファイル名の拡張子は , デフォルトで決められたものはありません。
【注意】
オプションファイル内では , -f オプション自身の指定はできません。
オプションファイルは , 1 行に最大 1023 文字まで記述できます。
【例 1】
f2ms -V -f optfile.f2m
optfile.f2m の内容
#
# from FJ-OMF to Motorola-S
#
ccp903.abs
# IN ABS-LM
-o ccp903.mhx
# OUT Motorola-S
これは , 以下のようにコマンドラインで指定したのと同等です。
f2ms -V ccp903.abs -o ccp903.mhx
32
CM25-00321-5, September 1, 2014
第 3 章 共通オプション
3.2 共通オプション詳細
Support
Soft
Ma nual
【例 2】
flib896s syslib.lib -f objfile.opt
syslib.lib に登録するモジュールを objfile.opt に記述し , ライブラリアンはこのファイ
ル内容を参照してライブラリファイルを作成します。
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
ライブラリ名指定まで含め , 次のように指定することもできます。
flib896s -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 回指定することも可能です。
flib896s 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
September 1, 2014, CM25-00321-5
33
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.3
So ft
Manu al
ヘルプメッセージの表示 (-help)
-help オプションは , プログラムを実行せずにヘルプメッセージを表示することを指
示します。コマンドラインの指定形式と , オプションの概要を表示します。
■ ヘルプメッセージの表示 (-help)
【記述形式】
-help
【パラメータ】
なし
【説明】
-help オプションは , コマンドラインの指定形式とオプション一覧を簡単に表示しま
す。
ヘルプメッセージは標準出力 (stdout) に出力されます。
コマンド名だけの指定時にも , 同じヘルプメッセージが出力されます。
入力ファイル名やほかのオプションが指定されている場合にも , 本オプションが指
定されていると , プログラムを実行せずにヘルプメッセージのみ表示します。
34
CM25-00321-5, September 1, 2014
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.4
Soft
Ma nual
版数 / メッセージ出力指定 (-V)
-V オプションでは , プログラムの起動時のメッセージの出力を行います。
■ 版数 / メッセージ出力指定 (-V)
【記述形式】
-V
【パラメータ】
なし
【説明】
-Vオプションは, 起動メッセージの出力を行うようにする指定です。なお , リンケー
ジキットの各ツールは , デフォルト実行では起動メッセージを出力しません。起動
メッセージ出力は , 必ずこの -V オプションを使って行います。
起動メッセージには , プログラム版数 , 著作権表示などが含まれます。
メッセージは標準出力 (stdout) に出力します。
【例 1】
flnk896s ccp903
本オプションを指定しない場合 , 実行開始時にメッセージを出力しません。
終了時は , OS のプロンプトが出て , 次のコマンド入力待ちになるだけです。
【例 2】
flib896s -V
-V オプションだけが指定された場合 , プログラム名 , プログラム版数 , コピーライ
トメッセージを表示したのち , 直ちにプログラムを終了します。
September 1, 2014, CM25-00321-5
35
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.5
So ft
Manu al
版数 / メッセージ出力抑止 (-XV)
-XV オプションは , -V オプションを無効にします。これにより , プログラムの起動
メッセージの出力を行わないようにします。
■ 版数 / メッセージ出力抑止 (-XV)
【記述形式】
-XV
【パラメータ】
なし
【説明】
リンケージキットの各ツールは , デフォルト実行では起動メッセージを出力しませ
んので , 起動メッセージを出力させるには -V オプションを指定します。
-XV オプションは , -V 指定を無効にするときに指定します。
【例 1】
flnk896s ccp903
flnk896s ccp903 -XV
デフォルト処理では , 実行開始時にメッセージを出力しません。
上記指定はどちらも同じです。
【例 2】
f2ms -f lkit.opt
ccp903
-XV
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。lkit.opt 内に -V オプションがある場合 , lkit.opt の内容を
変更せずコマンドライン上で -XV 指定を行えば , -V オプションを取り消すことがで
きます。
36
CM25-00321-5, September 1, 2014
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.6
Soft
Ma nual
終了メッセージ表示指定 (-cmsg)
終了メッセージを表示します。
■ 終了メッセージ表示指定 (-cmsg)
【記述形式】
-cmsg
【パラメータ】
なし
【説明】
プログラムの終了メッセージを表示します。
リンケージキットはデフォルトでは , プログラムの終了メッセージの表示を行いま
せん。
【例 1】
flnk896s ccp903
本オプションを指定しない場合 , 終了時にメッセージを出力しません。
終了時は , OS のプロンプトが出て , 次のコマンド入力待ちになるだけです。
【例 2】
f2ms ccp903 -cmsg
F2MS COMPLITED FOUND NO ERROR
終了時に , 終了メッセージ ( プログラム名 , エラーの有無 ) を表示します。
September 1, 2014, CM25-00321-5
37
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.7
So ft
Manu al
終了メッセージ表示抑止指定 (-Xcmsg)
終了メッセージの表示を抑止します。
■ 終了メッセージ表示抑止指定 (-Xcmsg)
【記述形式】
-Xcmsg
【パラメータ】
なし
【説明】
終了メッセージの表示を抑止します。
リンケージキットは , デフォルトでプログラムの終了メッセージの表示を行いませ
ん。
本オプションはプログラムの終了メッセージの表示オプション (-cmsg) を取り消す
場合に使用します。
【例 1】
flnk896s ccp903
flnk896s ccp903 -Xcmsg
デフォルト処理では , 終了時にメッセージを出力しません。
上記指定はどちらも同じです。
【例 2】
f2ms -f lkit.opt
ccp903
-Xcmsg
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。lkit.opt 内に -cmsg オプションがある場合 , lkit.opt の内容
を変更せずコマンドライン上で -Xcmsg 指定を行えば , -cmsg オプションを取り消す
ことができます。
38
CM25-00321-5, September 1, 2014
第 3 章 共通オプション
3.2 共通オプション詳細
Support
3.2.8
Soft
Ma nual
ワーニング発生時の終了コードを 1 にする指定
(-cwno)
プログラム実行時にワーニングのみが発生した場合の終了コードを 1 に変更します。
■ ワーニング発生時の終了コードを 1 にする指定 (-cwno)
【記述形式】
-cwno
【パラメータ】
なし
【説明】
プログラム実行時にワーニングのみが発生した場合の終了コードを 1 に変更しま
す。
SOFTUNE リンケージキットでは , 通常ワーニングのみが発生した場合の終了コー
ドは 0 です。
【例 1】
flnk896s ccp903 -cwno
プログラム実行時にワーニングのみ発生した場合 , OS への終了コードが 1 になりま
す。
【例 2】
flnk896s ccp903
プログラム実行時にワーニングのみの発生の場合, OSへの終了コードはデフォルト
である 0 のままです。
September 1, 2014, CM25-00321-5
39
第 3 章 共通オプション
3.2 共通オプション詳細
Su pp or t
3.2.9
So ft
Manu al
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno)
終了メッセージの表示を抑止します。
■ ワーニング発生時の終了コードを 0 にする指定 (-Xcwno)
【記述形式】
-Xcwno
【パラメータ】
なし
【説明】
プログラム実行時にワーニングのみが発生した場合の終了コードをデフォルトで
ある 0 に戻します。
SOFTUNE リンケージキットでは , 通常ワーニングのみが発生した場合の終了コー
ドは 0 です。
本オプションはワーニング発生時の終了コードを 1 にするオプション (-cwno) を取
り消す場合に使用します。
【例 1】
flnk896s ccp903
flnk896s ccp903 -Xcwno
デフォルト処理では , ワーニング発生時の終了コードは 0 です。
上記指定はどちらも同じです。
【例 2】
f2ms -f lkit.opt
ccp903
-Xcwno
オプションファイルを利用した実行時 , オプションファイル内の指定を一時的に変
更したい場合があります。lkit.opt 内に -cwno オプションがある場合 , lkit.opt の内容
を変更せずコマンドライン上で -Xcwno 指定を行えば , -cwno オプションを取り消す
ことができます。
40
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第4章
オプションファイル
リンケージキットのオプションファイルについて
説明します。
4.1 オプションファイルの概要
4.2 オプションファイル中での継続指定
4.3 オプションファイル中のコメント指定
4.4 オプションファイルの記述例
4.5 デフォルトオプションファイル
September 1, 2014, CM25-00321-5
41
第 4 章 オプションファイル
4.1 オプションファイルの概要
Su pp or t
4.1
So ft
Manu al
オプションファイルの概要
オプションファイルは , コマンドライン入力を簡略化するために , あらかじめ処理に
必要なファイル名やオプションを記述しておくファイルです。
■ オプションファイル
オプションファイルは , コマンドラインで指定する入力ファイル名やオプションを記
述したファイルです。
記述シンタックスは , コマンドライン上での指定方法と同じです。
ただし , オプションファイル中では , 次の 2 項目が加わります。
• コメント文が記述できる。
• 任意区切り位置で改行可能である。
コメント文は , コメント記号 (#) で始まり , 改行で終了します。
コメント文および改行記号は , コマンドライン上でのスペースと同等に扱われます。
■ オプションファイル指定による実行
コマンドラインの指定だけでは入力できる文字数に制限があるため , 指定するファイ
ル名やオプションが多い場合には指定しきれなくなります。また , 毎回そのような指定
を行うことは , 効率の低下と入力ミスによる誤動作の原因になります。
処理が定型化してきたり , 指定するオプションやファイル名が多いとき , 毎回コマンド
ライン入力を行う手間を省くために , ファイルに記述された内容を , コマンドラインで
の指定と同等に扱い処理することができます。その際 , 処理に必要なファイル名やオプ
ションを , テキストエディタを使いオプションファイルに作成しておき , -f オプション
を用いて実行します。
【例】
flib896s -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
42
CM25-00321-5, September 1, 2014
第 4 章 オプションファイル
4.1 オプションファイルの概要
Support
Soft
Ma nual
この例では , オプションだけではなく , 編集対象のライブラリファイル (prg.lib) の記述
も行っています。
このように , オプションファイル中には , (-f オプション , -Xdof オプションの指定を除
き ) コマンドラインで記述することのできるすべての指定が同じ形式で記述できます。
September 1, 2014, CM25-00321-5
43
第 4 章 オプションファイル
4.2 オプションファイル中での継続指定
Su pp or t
4.2
So ft
Manu al
オプションファイル中での継続指定
オプションファイル中では , オプションやパラメータの区切りの箇所で改行し , 継続
して指定を行うことができます。
■ オプションファイル中の継続指定
オプションファイルにオプションやファイル名を記述していると, オプションが1行に
記述しきれなかったり , 見やすさのため複数行に渡って記述したいと思うことがあり
ます。
このため , オプションファイル中では , オプションやパラメータの区切りの箇所で改行
できるようにしています。以下に , オプションファイルの記述例を 2 つ示します。
【例 1 オプションファイルの内容を 1 行で記述した場合の例】
-a mod01, mod02, obj03, obj04
【例 2 オプションファイルの内容を 2 行で記述した場合の例】
-a mod01, mod02,
obj03, obj04
44
# the continued line
CM25-00321-5, September 1, 2014
第 4 章 オプションファイル
4.3 オプションファイル中のコメント指定
Support
4.3
Soft
Ma nual
オプションファイル中のコメント指定
オプションファイル中には , コメントを入れることができます。
■ オプションファイル中のコメント指定
オプションファイル中にコメントを入れる場合 , コメント開始記号には (#) を使用しま
す。
【例 オプションファイルの内容にコメントを入れた場合の例】
下線部分がコメントです。
# Example of Library Options
syslib.lib
-a mod01, mod02, obj03, obj04
September 1, 2014, CM25-00321-5
# INDICATES LIBRARY FILE
# Add Modules
45
第 4 章 オプションファイル
4.4 オプションファイルの記述例
Su pp or t
4.4
So ft
Manu al
オプションファイルの記述例
オプションファイルの記述例として , コマンドラインでの -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
-aの後ろで改行パラ
メータ全部を継続
mod01,mod02,obj03,obj04
46
同じ
CM25-00321-5, September 1, 2014
第 4 章 オプションファイル
4.5 デフォルトオプションファイル
Support
4.5
Soft
Ma nual
デフォルトオプションファイル
オプションファイル機能の 1 つですが , 起動時オプション "-f" を指定しなくてもあ
らかじめ指定されているオプションファイルを読込み実行します。
この機能をデフォルトオプションファイルといいます。
■ デフォルトオプションファイル
デフォルトオプションファイルは , オプションファイル機能の 1 つですが , 起動時オプ
ション "-f" を指定しなくてもあらかじめ指定されているオプションファイルを読込み
実行します。この機能をデフォルトオプションファイルといいます。
デフォルトオプションファイルは , 常にプログラムの起動時に読み込まれますので ,
ユーザの環境にあった起動時オプションをあらかじめ指定しておくことができます。
デフォルトオプションファイル機能を抑止するには , 起動時オプション "-Xdof" を指定
します。
このオプションが指定されると , デフォルトオプションファイルは読み込まれません。
デフォルトオプションファイル名は , 表 4.5-1 で示すように決まっています。
表 4.5-1 リンケージキットのデフォルトオプションファイル名
ツール名
プログラム名
オプションファイル名
リンカ
flnk896s
flnk896.opt
ライブラリアン
flib896s
flib896.opt
f2ms
f2m.opt
f2hs
f2h.opt
f2is
f2i.opt
f2es
f2e.opt
m2is
m2i.opt
m2es
m2e.opt
i2ms
i2m.opt
e2ms
e2m.opt
m2bs
m2b.opt
m2ms
m2m.opt
h2bs
h2b.opt
h2hs
h2h.opt
オブジェクト形式
コンバータ
デフォルトオプションファイルの参照手順を次に示します。
September 1, 2014, CM25-00321-5
47
第 4 章 オプションファイル
4.5 デフォルトオプションファイル
Su pp or t
So ft
Manu al
● 環境変数 "OPT896" または "OPT" が設定されている場合
環境変数で設定されているディレクトリのファイルを参照します。
• リンカ , ライブラリアン
- %OPT896%\ デフォルトオプションファイル
• オブジェクトツール
- %OPT%\ デフォルトオプションファイル
● 環境変数 "OPT896" または "OPT" が設定されていない場合
開発環境ディレクトリ内のデフォルトオプションファイルを参照します。
• リンカ , ライブラリアン
- %FETOOL%\LIB\896\ デフォルトオプションファイル
• オブジェクトツール
- %FETOOL%\LIB\ デフォルトオプションファイル
<注意事項>
デフォルトオプションファイルが見つからない場合 , リンケージキットはエラーメッセー
ジを表示しません。
48
CM25-00321-5, September 1, 2014
Support
第 II 部
Soft
Ma nual
リンカ編
リンカの仕様 , オプションおよび出力リストなどについて説明します。
第 5 章 リンカの仕様
第 6 章 リンカのオプション
第 7 章 リンカの出力リスト ファイル
第 8 章 リンカの制限事項および Q&A
September 1, 2014, CM25-00321-5
49
Su pp or t
50
So ft
Manu al
CM25-00321-5, September 1, 2014
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 CPU 情報ファイル
5.11 リンカでのオブジェクト混在
September 1, 2014, CM25-00321-5
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)
オブジェクト
内容リスト
(.rel)
絶対形式
ロード
モジュール
(.abs)
52
アセンブル
リスト
(.mp1)
(.mpx)
(.mps)
(.mpm)
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2
Soft
Ma nual
リンカの機能
リンカには多くの機能がありますが , 大きく分けると次の 4 つに分類できます。
• 入出力ファイル / メッセージに関する制御
• セクションの結合 / 配置に関する制御
• ライブラリの検索に関する制御
• エントリアドレス / シンボル値の設定
■ 入出力ファイル / メッセージに関する制御
入出力ファイルとその制御の概要について説明します。詳しくは「5.2.1 入出力ファイ
ル / メッセージに関する制御」を参照してください。
• 入力ファイルは , 次の 4 つです。
- 「アセンブラ出力オブジェクトモジュールファイル」
- 「リストファイル」
- 「リンカ出力の相対形式ロードモジュールファイル」
- 「ライブラリファイル」
• オブジェクトモジュールファイルとロードモジュールファイルは , コマンドライン
またはオプションファイル中に記述した順に処理されます。
• 出力ファイルは , 次の 3 つです。
- 最終目的となる「絶対形式ロードモジュールファイル」
- 再入力可能な「相対形式ロードモジュールファイル」
- 「リンクマップリストファイル」
• 出力ロードモジュールの形式(絶対/相対)指定や, 出力ファイル名の変更ができます。
• マップリストは 1 ページの行数やページ幅の変更ができます。
• オプションを指定することにより , 次の 4 つのファイルを出力することができます。
これらのファイルを出力するには,リンク時のロードモジュールの形式を絶対指定にす
る必要があります。
- アセンブラが出力したリストファイルを絶対形式にした「絶対形式アセンブルリ
ストファイル」
- 各モジュールで使用している外部シンボルについてモジュール間の定義 / 参照の
相互参照を表示した「外部シンボル相互参照情報リスト」
- モジュールごとに使用したローカルシンボルに関する情報を表示した「ローカル
シンボル情報リスト」
- 各モジュール内のセクション配置アドレスを表示した「セクション詳細マップリ
スト」
• メッセージにはプログラム版数などの情報を含む起動メッセージ , 簡単な使用方法
を示すヘルプメッセージおよびエラーメッセージがあります。起動メッセージ出力
の有無を選択したり , ワーニング検出レベルの選択ができます。
September 1, 2014, CM25-00321-5
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
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2.1
Soft
Ma nual
入出力ファイル / メッセージに関する制御
リンカの機能のうち , 入出力ファイル / メッセージに関する制御を行うそれぞれの機
能について説明します。
■ 入力オブジェクトファイルの指定
リンカの入力となるファイルは , アセンブラ出力のオブジェクトモジュールファイルと ,
リンカ出力の相対形式ロードモジュールファイルです。
入力するファイルすべてを指定します。ワイルドカードを使用することで簡単に指定
が行えます。
■ 出力ロードモジュールファイル名の指定
リンク後に生成される出力ロードモジュールファイル名は , デフォルトではリンカが
最初に入力したモジュールのファイル名をもとに作られます。
デフォルトファイル名は , リンク結果の全体を示す名称としては不適当である場合が
多いので , このデフォルト出力ファイル名を変更するための機能です。
特に , ワイルドカードを使用してファイル名を指定した場合には , 出力ファイル名がわ
かりにくくなりますので , 出力ファイル名の指定を行うことを推奨します。
■ デバッグ情報の継承
デバッグのためには , シンボル情報やソースファイルに関する情報が必要です。
C およびアセンブラで , デバッグ情報作成の指定 (-g オプション ) を行うと , オブジェ
クトモジュール中にデバッグ情報が作成されます。
リンカでは , このデバッグ情報を継承してロードモジュール中に出力するか , 削除する
かを選択できます。
■ 出力フォーマットの指定
リンクした結果として , 絶対形式ロードモジュールを生成するのか , 相対形式ロードモ
ジュールを生成するのかを指定する機能です。
■ リストファイル名の指定
リストファイルは出力オブジェクトファイル名をもとに作成されますが , このデフォ
ルトファイル名を変更するための機能です。
■ リストファイルの形式変更
リストファイル作成ではページ制御を行っていますが , 1 ページの行数や 1 行の文字数
を変更することができます。
また , シンボル名の文字数が長いときは 1 行に表示できる範囲で打ち切っていますが ,
ユーザの定義どおりの名称で表示するように指示することができます。
September 1, 2014, CM25-00321-5
55
第 5 章 リンカの仕様
5.2 リンカの機能
Su pp or t
So ft
Manu al
■ 警告チェックレベルの選択
警告は軽微なエラーであり , リンク処理が継続できる程度の不都合が発生した場合に
通知されるメッセージですが , 修正を要するものと , そのままで特に問題のないものと
があります。これらのチェックレベルを選択することができます。
■ 起動メッセージ表示の選択
起動時のツール名と著作権の表示を行うか否かを選択できます。
■ 終了メッセージ表示の選択
終了メッセージの表示を行うか否かを選択できます。
56
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2.2
Soft
Ma nual
セクションの結合 / 配置に関する制御
リンカの機能のうち , セクションの結合 / 配置に関する制御を行うそれぞれの機能に
ついて説明します。
■ ROM および RAM 領域の指定
ROM 領域と RAM 領域のアドレス範囲を指定して領域名称を定義すると , セクション
の配置指定時にアドレス指定の代わりにこの領域名称を用いることができ , 範囲外へ
の配置に対するチェックが可能になります。
セクションの自動配置を行う場合には , この領域指定範囲内に配置します。
■ セクションの配置順と配置アドレスの指定
すべてのセクションは任意の順序で , 任意の領域に配置できます。セクション名の指定
には , ワイルドカードが使用できます。
また , セクション内容種別を付加した指定が可能なので , ワイルドカードと組み合わせ
ることで同じ内容種別 (code, data など ) のセクションだけを集めることもできます。
■ セクションのグループ化
リンカは , セクション単位に結合と配置を行いますが , 多くのセクション名を使ってプ
ログラムを作成した場合 , セクションの配置指定が煩雑になります。
複数セクションにグループ名を付け , 連続領域に集めることで , そのまとまりをあたか
も 1 つのセクションのように扱うことができます。
■ ROM 化支援
Cでのプログラム開発においては初期値付変数が生成され, その変数の書換えなどの処
理を行うことが頻繁にあります。
組込み用のアプリケーションにおいては , 初期値データは ROM に置き , 実行前に RAM
へデータを転送しないと使用できないことになります。
このような使用を可能にするための機能です。詳しくは「5.9 ROM → RAM 転送セク
ション」を参照してください。
September 1, 2014, CM25-00321-5
57
第 5 章 リンカの仕様
5.2 リンカの機能
Su pp or t
5.2.3
So ft
Manu al
ライブラリの検索に関する制御
リンカの機能のうち , ライブラリの検索に関する制御を行うそれぞれの機能につい
て説明します。
■ ライブラリ検索パス指定
ライブラリの検索パスは , 通常 C ライブラリを格納したディレクトリを環境変数で指
定しておきますが , ユーザが自身で作成したライブラリを別のディレクトリに格納し
た場合などに指定します。
■ 検索ライブラリファイル指定
C コンパイラが提供する実行時ライブラリ以外に , ユーザが独自に作ったライブラリ
ファイルの名前を検索対象ライブラリとして指定します。
■ シンボルごとの検索ライブラリファイル指定
複数のライブラリファイルの検索を行うリンク処理において , ライブラリ間に同一の
外部シンボルが含まれていることが分かっている場合 , どのライブラリのモジュール
とリンクするかを明確に指定するために使用します。
■ ライブラリ検索の抑止
デフォルトライブラリの検索を禁止したり , すべてのライブラリ検索を行わないよう
にすることができます。
58
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.2 リンカの機能
Support
5.2.4
Soft
Ma nual
エントリアドレス / シンボル値の設定
リンクの機能のうち , エントリアドレス / シンボル値の設定に関する機能について説
明します。
■ エントリアドレス指定
プログラムの実行開始アドレスを , 出力ロードモジュール中に設定する機能です。
■ 外部シンボル値の設定
プログラムが未完成であるか , 外部シンボル名を間違えているかなどが原因で , リンク
後に定義されていない外部シンボルがある場合はエラーとなります。
このエラーを一時的に取り除き , とりあえず実行可能なロードモジュールを作成した
い場合に仮の値を設定する機能です。
September 1, 2014, CM25-00321-5
59
第 5 章 リンカの仕様
5.3 セクションの種類
Su pp or t
5.3
So ft
Manu al
セクションの種類
リンカが結合処理を行うときの最小単位はセクションです。
セクションはプログラムでの使用目的の違いにより , 配置や結合の方法に特長があ
ります。
セクション名 , 内容種別 , 配置属性 , 結合属性などについて説明します。
■ セクション名
セクションを識別するために付けた名前です。
■ セクション内容種別
使用目的の違いによるセクション内容種別には以下の 7 つがあります。
実行 , Read, Write の属性は , アセンブラが決定します。表 5.3-1 にセクションの種別を
示します。
表 5.3-1 セクションの種別
種別
説明
属性
CODE
プログラムコード領域
実行 , Read
DATA
変数領域
Read, Write
CONST
初期値付変数領域
Read
STACK
スタック領域
Read, Write
IO
I/O 領域
Read, Write
DIR
direct 領域
Read, Write
DIRCONST
初期値付 direct 領域
Read
■ セクションの配置属性
セクションの配置に関する属性は , 再配置可能か否かの 2 種類あります。表 5.3-2 にセ
クションの配置属性を示します。
表 5.3-2 セクションの配置属性
属性
60
説 明
ABS
絶対番地の指定されたセクションです。
REL
再配置可能なセクションです。
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.3 セクションの種類
Support
Soft
Ma nual
■ セクションの結合属性
セクションの結合に関する属性は , 共有か連結かの 2 種類あります。表 5.3-3 にセク
ションの結合属性を示します。
表 5.3-3 セクションの結合属性
属性
説 明
PUBLIC
次々に連続して結合されます。
COMMON
同じアドレスに重ねあわせて結合されます。
■ セクションの識別
リンカでは , セクション名と内容種別と結合属性が同一で , REL 属性のセクションを同
一セクションとして扱います。
ABS 属性セクションは , リンカの配置処理の対象にはなりません。
リンカは , セクション名によってセクションの識別を行いますので , 同じセクション名
で内容種別や属性の異なるセクションは定義しないでください。
September 1, 2014, CM25-00321-5
61
第 5 章 リンカの仕様
5.4 セクションの結合
Su pp or t
5.4
So ft
Manu al
セクションの結合
リンカでは , 「複数のオブジェクトを結合する」という表現を多く用いますが , 正確
には「オブジェクト中のセクションを結合する」という意味です。
セクションの結合方法には , 単純連結結合 (PUBLIC) と共有結合 (COMMON) があり
ます。
■ セクションの単純連結結合
同じセクション名と内容種別を持ち , 結合属性が PUBLIC である REL セクションは単
純連結結合を行います。
図 5.4-1 に , 2 つのオブジェクトファイル中の同一セクションの単純連結結合の概要を
示します。
結合後の全体のサイズは , A-1 と A-2 のサイズの合計に , バウンダリ調整により生じた ,
A-1 と A-2 の間の隙間分のサイズを加えたものとなります。
図 5.4-1 セクションの単純連結結合
セクションA-1
セクションA-2
セクションA-1
セクションA-2
■ セクションの共有結合
同じセクション名と内容種別を持ち , 結合属性が COMMON である REL セクションは
共有結合を行います。
初期値のない , データセクションでの使用が考えられます。
図 5.4-2 に , 2 つのオブジェクトファイル中の同一セクションの共有結合の概要を示し
ます。
結合後の全体のサイズは , A-1 と A-2 のサイズのうち大きい方になります。
図 5.4-2 セクションの共有結合
セクションA-1
セクションA-2
A-1
セクションA-2
62
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.5 セクションの配置
Support
5.5
Soft
Ma nual
セクションの配置
リンカは , 同一のセクションを結合したのちそれぞれのセクションの配置アドレス
を決定します。ここでは , ユーザがアドレス指定をした場合を含めて , リンカのセク
ション配置の方法を説明します。
■ セクションのリンク
結合と配置処理は , 相対セクションのみが対象となります。
絶対セクションは , 結合・配置の対象にはなりません。
セクションの結合・配置は , 以下のような手順で行います。
1. それぞれのオブジェクトモジュールから同一セクションを集める。
2. 集めた同一セクション同士を , 結合属性に従って結合する。
3. 同一セクションを結合したものを配置する。
セクション配置順序に関係するオプションが指定されている場合はそれに従って行わ
れ , 指定がない場合はオブジェクトファイル中での出現順がそのまま配置の順番にな
ります。
詳しくは , 「5.5.1 セクションの結合順序が指定されなかった場合の配置例」, 「5.5.2
セクションの結合順序が指定された場合の配置例」, 「5.5.3 セクショングループの指
定がある場合の配置例」を参照してください。
September 1, 2014, CM25-00321-5
63
第 5 章 リンカの仕様
5.5 セクションの配置
Su pp or t
5.5.1
So ft
Manu al
セクションの結合順序が指定されなかった場合の配
置例
セクションの結合順序が指定されなかった場合の配置例を図 5.5-1 に示し , この図に
従って説明します。
■ セクションの結合順序が指定されなかった場合の配置例
オブジェクトファイルの入力順が , モジュール 1 → 2 → 3 であるとき , セクションの出
現順は A → B → C となるので , 配置アドレスも低い方から順に A → B → C となります。
図 5.5-1 セクションの結合順序が指定されなかった場合の配置例
モジュール1
モジュール2
モジュール3
ロードモジュール
1
A
2
A
3
A
ール
A-1
B
B
A-2
A-3
C
C
B
C-1
C-2
(注) セクションA,CはPUBLIC属性を持ち,セクションBは
COMMON属性を持つとした場合。
64
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.5 セクションの配置
Support
5.5.2
Soft
Ma nual
セクションの結合順序が指定された場合の配置例
セクションの結合順序が指定された場合の配置例を図 5.5-2 に示し , この図に従って
説明します。
■ セクションの結合順序が指定された場合の配置例
オブジェクトファイルの入力順が , モジュール 1 → 2 → 3 であるとき , セクションの出
現順は A → B → C であるが , 配置順として A → C → B が指定された場合。
図 5.5-2 セクションの結合順序が指定された場合の配置例
モジュール1
モジュール2
モジュール3
ロードモジュール
1
A
2
A
3
A
ール
A-1
B
B
A-2
A-3
C
C
C-1
C-2
B
(注) セクションA,CはPUBLIC属性を持ち,セクションBは
COMMON属性を持つとした場合。
September 1, 2014, CM25-00321-5
65
第 5 章 リンカの仕様
5.5 セクションの配置
Su pp or t
5.5.3
So ft
Manu al
セクショングループの指定がある場合の配置例
セクショングループの指定がある場合の配置例を図 5.5-3 に示し , この図に従って説
明します。
■ セクショングループの指定がある場合の配置例
グループ指定がある場合は , それぞれのグループに属するセクションは連続した領域
に配置されます。セクションの出現順は , A → B → C → D → E → F ですが , F は C の
所属するグループ (C → D → F) に含まれているので , E の前に配置されます。
図 5.5-3 セクショングループの指定がある場合の配置例
モジュール1
モジュール2
モジュール3
ロードモジュール
A
2
A
3
A
ール
A-1
B
B
A-2
A-3
C
C
B
D
C-1
E
E
F
C-2
F
D
F-2
F-3
E
(注) セクションB,EはCOMMON属性を持ち,ほかのセクションは
PUBLIC属性とする。
配置順序指定はなく,セクションC,D,Fが,同一グルー
プにグループ化される場合。
66
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.6 セクションの自動配置
Support
5.6
Soft
Ma nual
セクションの自動配置
通常リンカは , ユーザの配置指定に従って , セクション配置アドレスの決定を行いま
す。しかし , -AL オプションを指定することで , セクション配置アドレスの決定を自
動的にリンカに任せることが可能です。
-ra, -ro オプションで指定した領域内へセクション配置を行うとき , アブソリュート
セクションが存在していれば , 配置アドレスが重ならないように , リロケータブルセ
クションの配置を行います。このとき , アライメント値およびサイズの大きいセク
ションから順に配置し , 空き領域が最小となるような最適配置を行います。
■ セクションの自動配置
本リンカは , 以下に示す 2 つのタイプのセクションの自動配置をサポートしています。
• -AL 1 が指定された場合のセクションの自動配置
• -AL 2 が指定された場合のセクションの自動配置
セクションの自動配置の詳細については , 「5.6.1 -AL 1 が指定された場合のセクショ
ンの自動配置」, 「5.6.2 -AL 2 が指定された場合のセクションの自動配置」をご参照く
ださい。
September 1, 2014, CM25-00321-5
67
第 5 章 リンカの仕様
5.6 セクションの自動配置
Su pp or t
5.6.1
So ft
Manu al
-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
配置先は , 配置可能で最小の空きエリアが選択されます。
68
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.6 セクションの自動配置
Support
Soft
Ma nual
■ -AL 1 が指定された場合の配置例
リンカのオプション指定と各セクションの内容が , 下記例 ( 図 5.6-1, 表 5.6-3) の場合の
配置例を示します。
図 5.6-1 リンカのオプション指定
-ro ROM=0x8000/0x88FF
-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
0x1120 ~ 0x121F
0
0x0100
図 5.6-2 に , -AL 1 が指定された場合の配置例を示します。
このように , -AL 1 を使用すると , リンカが指定された領域内で , アブソリュートセク
ションと重ならないように , また空き領域が最小となるような最適配置を行います。
September 1, 2014, CM25-00321-5
69
第 5 章 リンカの仕様
5.6 セクションの自動配置
Su pp or t
So ft
Manu al
図 5.6-2 -AL 1 が指定された場合の配置例
0x8000
0x8100
0x8120
code4
code6
AbsSec
0x8220
0x8420
0x8620
0x87A0
0x88A0
0x88FF
code5
code3
code1
code2
未使用(空き)
-sc で指定された領域
70
CM25-00321-5, September 1, 2014
第 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
■ 配置アドレスの決定方法
-AL 2 が指定された場合 , リンカは , 表 5.6-5 に示す順にセクション配置アドレス決定を
行います。
表 5.6-5 で示す順のように , 自動配置よりもユーザ指定が優先されるようになっていま
す。
なお , リンカは , 配置可能な場所を検索する場合 , 常に低位アドレスから検索を行いま
す。
September 1, 2014, CM25-00321-5
71
第 5 章 リンカの仕様
5.6 セクションの自動配置
Su pp or t
So ft
Manu al
表 5.6-5 セクション配置先
順番
処理対象のセクション
配置先と配置方法
ABS 属性を持つセクション
セクションが持つアドレスに配置す
る。
2
-rg オプションで指定されたレジス
タバンク
該当するレジスタバンク領域に配置
する。
-sc オプションで , "-sc Section=
0x0100" のように , 配置アドレスの
指定が行われているセクション
指定されたアドレスに配置する。
3
4
-sc オプションで , "-sc Section=ROM"
のように , 配置領域の指定が行われ
ているセクション
指定された領域内で , ほかのセク
ションと重ならないように , 配置可
能な場所を検索して配置する。
配置に関する指定が行われていない
セクション
表 5.6-4 に従って配置領域の決定を
行い , その領域内で , ほかのセク
ションと重ならないように , 配置可
能な場所を検索して配置する。
1
5
■ -AL 2 が指定された場合の配置例
リンカのオプション指定と各モジュールに含まれるセクションが , 下記例 ( 図 5.6-3, 表
5.6-6) の場合の配置例を示します。
レジスタバンク 0 の領域は 0x0180 ~ 0x018F の 16 バイトとします。
図 5.6-3 リンカのオプション指定
file1.obj, file2.obj, file3.obj
-ro ROM=0x8000/0xFFFF
-ra RAM=0x000000/0x0007FF
-sc ivect=0xFF00
-AL 2
表 5.6-6 各モジュールに含まれるセクション (1 / 2)
モジュール
file1.obj
file2.obj
72
セクション名
種別
配置属性
アドレス
サイズ
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
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.6 セクションの自動配置
Support
Soft
Ma nual
表 5.6-6 各モジュールに含まれるセクション (2 / 2)
モジュール
file3.obj
セクション名
種別
配置属性
アドレス
サイズ
p3
CODE
REL
-
0x1000
d2
CONST
REL
-
0x0300
p2
CODE
ABS
0x9000
0x0C00
d4
DATA
REL
-
0x0100
図 5.6-4 に , -AL 2 が指定された場合の配置例を示します。
このように , -AL 2 を使用すると , リンカが適当に指定された領域内でセクションの自
動配置を行うので , ユーザはプログラムの動作上必要な , 最小限の領域指定やセクショ
ン配置指定で済み , セクションの配置を指定する手間を軽減できます。
図 5.6-4 -AL 2 が指定された場合の配置例
0x0000
0x8000
i1
0x00C0
0x0180
0x0190
0x0200
0x8F00
未使用 ( 空き )
0x9000
未使用 ( 空き )
p2
レジスタバンク0
0x9C00
未使用 ( 空き )
0x0380
0x0580
d2
d1
d3
0x0480
p1
0x8C00
0x0080
p4
0xAC00
p3
0xBC00
d4
未使用 ( 空き )
stk
未使用 ( 空き )
0xFF00
ivect
0x07FF
0xFFFF
RAM領域
September 1, 2014, CM25-00321-5
ROM領域
73
第 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.21 検索ライブラリファイルの指定 (-l)」を
参照してください。
● -el オプションによる指定
ライブラリファイルは複数個指定することができます。
異なるライブラリファイルに , 同一名の外部定義シンボルが含まれている場合もあり
ます ( 原因の判りにくい障害を招く恐れがありますので , 極力避けてください )。
-el オプションは , シンボルごとにシンボル検索を行うライブラリファイル名を特定す
るための指定です。詳しくは「6.2.23 シンボル個別のライブラリの指定 (-el)」を参照
してください。
74
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
Soft
Ma nual
■ ライブラリファイルの検索順序
リンカは , まず -el オプションで指定のあるシンボルについてシンボル参照を解決し ,
次に -l オプションで指定された順にライブラリの検索を行い , 最後にデフォルトライ
ブラリを検索します。ライブラリファイルから , モジュールの取り込みがなくなるまで ,
この一連の検索が続けられます。
September 1, 2014, CM25-00321-5
75
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7.1
So ft
Manu al
ライブラリファイルが 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}
X
参照 (S1)
参照 (S2)
Y
定義{S2}
A
定義{S1}
オブジェクトモジュールXとYを結合した結果,
X内の外部参照シンボル(S2)は,Y内の外部定
義シンボル{S2}によって解決されます。
X内の外部参照シンボル(S1)が未解決なので
ライブラリを検索します。
モジュールAに,外部定義シンボル{S1}が含
まれているので,このモジュールを新たにリンク
します。
A
定義
{S1}
これで,未解決の外部参照シンボルはなくなっ
たので,モジュールX,Y,Aから成るロードモ
ジュールを作成してリンク処理を終了します。
B
定義
{S2}
ランブラリ中のモジュールBに外部定義シンボル
{S2}がありますが,既にリンクされたモジュー
ルYに存在しているため,(S2)に関してはライ
ブラリ検索の対象になりません。
:
(注) 図中の( )で括ったシンボル名は"参照"を,{ }で括ったシンボル名は
"定義"を表します。
76
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
5.7.2
Soft
Ma nual
ライブラリファイルが 1 つの場合の検索例 2
ライブラリファイルが 1 つの場合の検索例は 3 つあります。このうち 1 つを図 5.7-2
に示し , この図に従って説明します。
■ ライブラリファイルが 1 つの場合の検索例 2
図 5.7-2 ライブラリファイルが 1 つの場合の検索例 2
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
参照 (S2)
オブジェクトY
Y
参照(S2)
+
抽出モジュール
Y
参照(S2)
A
定義{S1}
A
定義{S1}
ライブラリファイル
B
定義{S2}
シンボルテーブル
{S1}→ A
{S2}→ B
:
A
定義
{S1}
B
定義
{S2}
:
X
参照 (S1)
参照 (S2)
B
定義{S2}
オブジェクトモジュールXとYを結合した結果,
X,Y内の外部参照シンボル(S1)と(S2)は,
共に未解決となります。
ライブラリを検索し,モジュールAに外部定義
シンボル{S1}が,モジュールBに外部定義シン
ボル{S2}が含まれているので,この2つのモ
ジュールを新たにリンクします。
これで,未解決の外部参照シンボルはなくなっ
たので,モジュールX,Y,A,Bから成るロードモ
ジュールを作成してリンク処理を終了します。
(注) 図中の( )で括ったシンボル名は"参照"を,{ }で括ったシンボル名は
"定義"を表します。
September 1, 2014, CM25-00321-5
77
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7.3
So ft
Manu al
ライブラリファイルが 1 つの場合の検索例 3
ライブラリファイルが 1 つの場合の検索例は 3 つあります。このうち 1 つを図 5.7-3
に示し , この図に従って説明します。
■ ライブラリファイルが 1 つの場合の検索例 3
図 5.7-3 ライブラリファイルが 1 つの場合の検索例 3
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
+
Y
1)
参照(S2)
オブジェクトY
Y
参照(S1)
ライブラリファイル
X
参照 (S1)
抽出モジュール
A
定義{S1}
参照(S2)
A
定義{S1}
参照(S2)
B
定義{S2}
シンボルテーブル
{S1}→ A
{S2}→ B
:
A
定義
参照
{S1}
(S2)
B参照 (S
定義 {S2}
:
B
定義{S2}
オブジェクトモジュールXとYを結合した結果,
X,Y内の外部参照シンボル(S1)が未解決とな
ります。
ライブラリを検索し,モジュールAに外部定義
シンボル{S1}が含まれているので,このモ
ジュールを新たにリンクします。
この結果,外部参照シンボル(S2)が新たな
未解決シンボルとなったため,もう一度ライブ
ラリを検索し,{S2}の定義されているモジュー
ルBをリンクします。
これで,未解決の外部参照シンボルはなくなっ
たので,モジュールX,Y,A,Bから成るロードモ
ジュールを作成してリンク処理を終了します。
(注) 図中の( )で括ったシンボル名は"参照"を,{ }で括ったシンボル名は
"定義"を表します。
78
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
5.7.4
Soft
Ma nual
ライブラリファイルが複数の場合の検索例 1
ライブラリファイルが複数の場合の検索例は 2 つあります。このうち 1 つを図 5.7-4
に示し , この図に従って説明します。
■ ライブラリファイルが複数の場合の検索例 1
図 5.7-4 ライブラリファイルが複数の場合の検索例 1
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
+
Y
参照(S3)
オブジェクトY
Y
参照(S3)
抽出モジュール
A
定義{S1}
ライブラリファイル1
シンボルテーブル
{S1}→ A
{S2}→ B
:
A
定義
{S1}
X
参照 (S1)
A
定義{S1}
C
定義{S3}
C
定義{S3}
検索対象のライブラリファイルが複数ある場合,
指定された順にライブラリ検索を行います。
X,Yモジュールのリンク後,未解決シンボルの
(S1)と(S3)が残ります。
ライブラリ1,ライブラリ2の順で検索します。
B
定義
{S2}
:
ライブラリファイル2
シンボルテーブル
{S3}→ C
:
C
定義
{S3}
ライブラリ1の検索で{S1}の定義のあるモ
ジュールAをリンクします。
次に(S3)についてライブラリ1を検索します
が,見つからないのでライブラリ1の検索を終了
し,ライブラリ2を検索します。
{S3}がモジュールCで定義されていますので,
このモジュールをリンクします。
(注) 図中の( )で括ったシンボル名は"参照"を,
{ }で括ったシンボル名は"定義"を表します。
:
September 1, 2014, CM25-00321-5
79
第 5 章 リンカの仕様
5.7 ライブラリの検索
Su pp or t
5.7.5
So ft
Manu al
ライブラリファイルが複数の場合の検索例 2
ライブラリファイルが複数の場合の検索例は 2 つあります。このうち 1 つを図 5.7-5
に示し , この図に従って説明します。
■ ライブラリファイルが複数の場合の検索例 2
図 5.7-5 ライブラリファイルが複数の場合の検索例 2
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
+
X
参照 (S1)
A
定義{S1}
ライブラリファイル1
抽出モジュール
シンボルテーブル
{S1}→ A
{S2}→ B
:
A
定義
B
定義
{S1}
{S2}
:
ライブラリファイル2
シンボルテーブル
{S1}→ C
:
C
定義
{S1}
A
定義{S1}
検索対象のライブラリファイルが複数ある場合,
指定された順にライブラリ検索を行います。
複数のライブラリファイルに同一名の外部シンボ
ル含まれているような場合,先に検索したライブラ
リ中のモジュールをリンクします。
Xモジュールの未解決シンボル(S1)の解決のた
めに,ライブラリ1,ライブラリ2の順で検索しま
す。
ライブラリ1の検索で{S1}の定義のあるモ
ジュールAをリンクします。
この時点で,未解決シンボルはなくなりましたの
で,ライブラリの検索は終了します。
この場合,ライブラリ2の検索は行われません。
(注) 図中の( )で括ったシンボル名は"参照"を,
{ }で括ったシンボル名は"定義"を表します。
:
80
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.7 ライブラリの検索
Support
5.7.6
Soft
Ma nual
ライブラリファイルが個別に指定された場合の処理
ライブラリファイルが個別に指定された場合の処理を図 5.7-6 に示し , この図に従っ
て説明します。
■ ライブラリファイルが個別に指定された場合の処理
図 5.7-6 ライブラリファイルが個別に指定された場合の処理
リンク後の
ロードモジュール
オブジェクトX
X
参照 (S1)
参照 (S2)
ライブラリファイル1
シンボルテーブル
{S1}→ A
{S2}→ B
:
A
定義
:
{S1}
B
定義
{S2}
:
ライブラリファイル2
シンボルテーブル
{S2}→ C
:
C
定義
:
{S2}
:
September 1, 2014, CM25-00321-5
+
抽出モジュール
C
定義{S2}
X
参照 (S1)
参照 (S2)
C
定義{S2}
A
定義{S1}
A
定義{S1}
ライブラリファイルが個別に指定された外部参照
シンボルは,ます最初に検索されます。
ここでは,(S2)シンボルをライブラリ2から取
り込むように指定されたものとします。
(S2)についてライブラリ2を検索し,モジュー
ルCをリンクします。
(S1)の解決に,ライブラリファイル1を検索
し,モジュールAをリンクします。
ライブラリファイル1中の{S2}は,検索対象に
なりません。
(注)
・図中の( )で括ったシンボル名は"参照"を,
{ }で括ったシンボル名は"定義"を表します。
・指定されたライブラリに,検索対象の外部定義
シンボルが見つからなかった場合,この例のよ
うにほかの検索対象ライブラリ中に該当するシ
ンボルがあればシンボル解決が行われますので
注意してください。
81
第 5 章 リンカの仕様
5.8 ROM/RAM 領域
Su pp or t
5.8
So ft
Manu al
ROM/RAM 領域
組込み用のアプリケーション開発では , 使用することのできる ROM および RAM の
サイズや , アドレス範囲に制約があるものです。
リンク時に , リンカにこの領域を通知しておくことで , サイズオーバや使用できない
アドレスへのセクション配置についてのチェックができます。
セクションの自動配置を行う場合には , この領域指定範囲内に配置します。
■ ROM/RAM 領域の設定とセクション配置
リンカのセクション配置は , 【例 1】に示すようにセクション名 (CODE) と , 配置する
先頭アドレス (0x8000) を指定するといった方法で行います。
【例 1】
-sc CODE=0x8000, DATA=0x0180
セクションの終了アドレスは , リンク結果の出力であるマップリストにより確認する
必要があります。
本リンカでは , セクション配置の先頭アドレスと終了アドレスを指定することで , 決め
られた範囲内に配置されたか否かをチェックする機能を備えています。
まず , 【例 2】に示すように -ro および -ra オプションにより , 配置アドレス範囲を決め
て , 領域名と対応づけます。
【例 2】
-ro CodeA=0x8000/0xAFFF
-ra DataA=0x0100/0x57F
領域名 CodeA は , 0x8000 ~ 0xAFFF のアドレス範囲を示します。
領域名 DataA は , 0x0100 ~ 0x057F のアドレス範囲を示します。
領域名を使用したセクション配置指定は , 【例 3】のようになります。
【例 3】
-sc CODE=CodeA, DATA=DataA
領域名を使用したセクション配置では , 指定したアドレス範囲内に配置されたか否か
をチェックできます。
82
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.9 ROM → RAM 転送セクション
Support
5.9
Soft
Ma nual
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=0x0080, [email protected]=0xC000
ここで, 上のように, RAM側(0x0080)にINITを配置するように指定し, ROM側(0xC000)
にもセクション名の先頭に @ マークを付加して INIT を配置するように指定します。
このように配置指定を行うと INIT は ROM → RAM 転送セクションとして処理され , 図
5.9-1 のような配置になり , INIT のアドレス解決は RAM 側で行われ , 初期値データは
ROM 側に配置されます。
September 1, 2014, CM25-00321-5
83
第 5 章 リンカの仕様
5.9 ROM → RAM 転送セクション
Su pp or t
So ft
Manu al
図 5.9-1 ROM → RAM 転送セクションの配置例
0x0080
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
ld
@val1, r2
ld
@val2, r3
val3:
84
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.9 ROM → RAM 転送セクション
Support
Soft
Ma nual
.section
Prog2, code
ldi
@val3, r13
cmp
#0, r13
.end
上記プログラムでは , 初期値付変数が記述されているセクション init, 変数領域が記述
されているセクション Data, プログラムコードが記述されているセクション Prog1,
Prog2 があります。
それぞれのセクションのアセンブル後の実行 , Read, Write の可 / 不可は , 表 5.9-1 のよ
うになります。
表 5.9-1 アセンブル後の各セクションの属性
セクション名
実行
Read
Write
init
×
○
○
Data
×
○
○
Prog1
○
○
×
Prog2
○
○
×
○ … 可 × … 不可
ここで , リンク時に , init と Prog1 の ROM → RAM 転送セクション指定を行うと , それ
ぞれのセクションのリンク後の実行 , Read, Write の可 / 不可は , 表 5.9-2 のようになり
ます。
表 5.9-2 リンク後の各セクションの属性
セクション名
実行
Read
Write
備考
init(RAM 側 )
×
○
○
init(ROM 側 )
×
○
×
Data
×
○
○
Prog1(RAM 側 )
○
○
○
Write が可に変更された
Prog1(ROM 側 )
○
○
×
リンカにより用意された ROM 側のセク
ション
Prog2
○
○
×
リンカにより用意された ROM 側のセク
ション
Write が不可に変更された
○ … 可 × … 不可
September 1, 2014, CM25-00321-5
85
第 5 章 リンカの仕様
5.10 CPU 情報ファイル
Su pp or t
So ft
Manu al
5.10 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 情報ファイル名
896.csv
● 検索ディレクトリ
%FETOOL%\LIB\896
■ 内蔵 ROM/RAM 領域自動設定の抑止指定
リンカは , デフォルトで -cpu オプションから CPU を特定し , CPU 情報ファイルから該
当するチップの情報を抽出し , ROM/RAM 領域を自動的に設定します。
本機能を抑止したい場合は , -Xset_rora オプションを指定します。
<注意事項>
CPU 情報ファイルが見つからない場合または CPU 情報ファイル内に該当 MB 番号の情報
が存在しない場合 , リンカはエラーを出力します。
86
CM25-00321-5, September 1, 2014
第 5 章 リンカの仕様
5.11 リンカでのオブジェクト混在
Support
Soft
Ma nual
5.11 リンカでのオブジェクト混在
リンカ (flnk896s) では , -cpu オプションで指定したターゲット CPU と互換性のな
いオブジェクトやライブラリの混在が起こった場合 , エラーを出力します。
■ リンカでのオブジェクト混在
F2MC-8FX では , DIVU 命令の動作が従来の F2MC-8L と異なります。( 表 5.11-1 参照 )
表 5.11-1 DIVU 命令の動作比較
F2MC-8L
T(16bit) ÷ AL(8bit) = AL(8bit)…TL(8bit)
F2MC-8FX
T(16bit) ÷ A(16bit) = A(16bit)…T(16bit)
このため , リンカ (flnk896s) では , F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェク
トが混在してリンクされた場合 , エラーを出力します。
ただし , DIVU 命令を含まない場合 , F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェ
クトの混在リンクが可能になります。
F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェクトの混在リンクを行う場合 , オブ
ジェクト混在チェック抑止指定オプション (-Xobjmixchk) を指定してください。
<注意事項>
DIVU 命令のある F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェクトの混在リンクを
行うことは , 思わぬ不具合の原因になります。
F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェクトの混在リンクを行う場合 , DIVU 命
令の有無に十分注意してください。
September 1, 2014, CM25-00321-5
87
第 5 章 リンカの仕様
5.11 リンカでのオブジェクト混在
Su pp or t
88
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第6章
リンカのオプション
リンカの各オプションについて詳しく説明します。
6.1 リンカのオプション一覧
6.2 リンカのオプション詳細
September 1, 2014, CM25-00321-5
89
第 6 章 リンカのオプション
6.1 リンカのオプション一覧
Su pp or t
6.1
So ft
Manu al
リンカのオプション一覧
リンカの動作を細かく指示するために , オプションがあります。
■ リンカのオプション一覧
リンカのオプション一覧を , 表 6.1-1 に示します。
表 6.1-1 リンカのオプション一覧 (1 / 3)
機能
出力ロードモ
ジュールに関す
る指定
入
出
力
制
御
オ
プ
シ
ョ 出力リストに関
ン する指定
出力メッセージ
に関する指定
配置 / 結合オプショ
ン
ライブラリ制御オプ
ション
90
オプション
備考
出力ロードモジュールファイル名指定
-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
デフォルト
デフォルト
デフォルト 0
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.1 リンカのオプション一覧
Support
Soft
Ma nual
表 6.1-1 リンカのオプション一覧 (2 / 3)
機能
その他のリンク制御
オプション
絶対形式アセンブル
リスト出力関連オプ
ション
September 1, 2014, CM25-00321-5
備考
オプション
エントリアドレス指定
-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
デフォルト
オブジェクト混在チェック指定
-objmixchk
デフォルト
オブジェクト混在チェック抑止指定
-Xobjmixchk
相対アセンブルリスト入力ディレクト
リ指定
-alin
絶対アセンブルリスト出力ディレクト
リ指定
-alout
絶対アセンブルリスト出力指定
-als
絶対アセンブルリスト出力モジュール
指定
-alsf
絶対アセンブルリスト出力抑止指定
-Xals
ROM/RAM, ARRAY リスト出力指定
-alr
ROM/RAM, ARRAY リスト出力モ
ジュール指定
-alrf
ROM/RAM, ARRAY リスト出力抑止指
定
-Xalr
ROM/RAM, ARRAY リストのシンボル
とアドレスの表示位置指定
-na/-an
必須
デフォルト
デフォルト
デフォルト
91
第 6 章 リンカのオプション
6.1 リンカのオプション一覧
Su pp or t
So ft
Manu al
表 6.1-1 リンカのオプション一覧 (3 / 3)
機能
オブジェクト内容リ
スト出力関連オプ
ション
共通オプション
92
オプション
外部シンボル相互参照情報リスト出力
指定
-xl
外部シンボル相互参照情報リストファ
イル名指定
-xlf
外部シンボル相互参照情報リスト出力
抑止指定
-Xxl
ローカルシンボルリスト出力指定
-sl
ローカルシンボルリストファイル名の
指定
-slf
ローカルシンボルリスト出力抑止指定
-Xsl
セクション詳細マップリスト出力指定
-ml
セクション詳細マップリストファイル
名の指定
-mlf
セクション詳細マップリスト出力抑止
指定
-Xml
デフォルトオプションファイル読込み
抑止指定
-Xdof
オプションファイル読込み指定
-f
ヘルプメッセージ表示指定
-help
版数 / メッセージ出力指定
-V
版数 / メッセージ出力抑止
-XV
終了メッセージ表示指定
-cmsg
終了メッセージ表示抑止指定
-Xcmsg
ワーニング発生時の終了コードを 1 に
する指定
-cwno
ワーニング発生時の終了コードを 0 に
する指定
-Xcwno
備考
デフォルト
デフォルト
デフォルト
CM25-00321-5, September 1, 2014
第 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 エントリアドレスの指定 (e)」~「6.2.40 オブジェクト混在チェック抑止指定 (-Xobjmixchk)」で説明します。
■ 絶対形式アセンブルリスト出力関連オプション
絶対形式アセンブルリスト出力に関するオプションの詳細を「6.2.41 相対アセンブル
リスト入力ディレクトリ指定 (-alin)」~「6.2.49 ROM/RAM, ARRAY リストのシンボ
ルとアドレスの表示位置指定 (-na, -an)」で説明します。
■ オブジェクト内容リスト出力関連オプション
オブジェクト内容リスト出力に関するオプションの詳細を「6.2.50 外部シンボル相互
参照情報リスト出力指定 (-xl)」~「6.2.58 セクション詳細マップリスト出力抑止指定
(-Xml)」で説明します。
September 1, 2014, CM25-00321-5
93
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.1
So ft
Manu al
出力ロードモジュールファイル名指定 (-o)
リンク結果のロードモジュールファイル名を指定します。このオプションが指定さ
れないときは , 最初に入力したファイル名から出力ファイル名を作ります。
■ 出力ロードモジュールファイル名指定 (-o)
【記述形式】
-o < ロードモジュールファイル名 > ( デフォルト )
【パラメータ】
< ロードモジュールファイル名 >
出力ロードモジュールファイル名です。
【説明】
リンク結果の出力ロードモジュールファイル名を指定します。
本オプション指定がない場合は , リンカが最初に入力したファイル名をもとに , リ
ンクモードに応じた拡張子を付加した名称で出力ファイルを作ります。
リンクモード
デフォルト拡張子
絶対形式出力 (-a オプション )
.abs
相対形式出力 (-r オプション )
.rel
< ロードモジュールファイル名 > の指定で拡張子を省略した場合も , リンクモード
の違いにより同様の拡張子が付加されます。
【例 1】
flnk896s putc.obj,getc.obj
ファイル名 putc.abs でロードモジュールファイルを作成します。
【例 2】
flnk896s *.obj -o outfile
ファイル名 outfile.abs でロードモジュールファイルを作成します。
この例のように , 入力オブジェクトファイル指定にワイルドカードを使用する場合
には , 本オプションを使用して出力ファイル名を明確にしておくことをお勧めしま
す。
94
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 3】
flnk896s *.obj -o outfile.
ファイル名 outfile. でロードモジュールファイルを作成します。
ファイル名の最後にピリオドがある場合は , 拡張子ありとみなします。
【例 4】
flnk896s *.obj -r -o outfile.rel
ファイル名 outfile.rel で相対形式ロードモジュールファイルを作成します。
September 1, 2014, CM25-00321-5
95
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.2
So ft
Manu al
デバッグ情報の出力指定 (-g)
C コンパイラやアセンブラで , デバッグ情報の出力指定をして作られたオブジェクト
モジュールには , デバッガで利用するためのデバッグ情報が含まれています。
デバッグ情報をリンク後も継承して使用するためには , -g オプションを指定します。
■ デバッグ情報の出力指定 (-g)
【記述形式】
-g
【パラメータ】
なし
【説明】
リンカは , 入力するオブジェクトモジュールファイルまたは相対形式ロードモ
ジュールファイルにデバッグ情報が含まれている場合 , デフォルト出力ではデバッ
グ情報を削除します。
出力ロードモジュールファイル中にデバッグ情報を残したい場合に , 本オプション
を使用します。
リンカは , デバッグ情報を新たに作り出すことはありませんので , 入力ファイルに
デバッグ情報が含まれていない場合は , 指定することに意味はありません。
デバッグ時にシンボリックデバッグを行いたい場合には , C コンパイラ~アセンブ
ラ~リンカのすべてのツールで -g オプションの指定をしてください。
【例】
flnk896s -f rllnk.opt b1 b2
96
rllnk.opt
-r
# relocatable LM output
-g
# debug info.
-pw 100
# page width
-o rel1.rel
# output filename
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.3
Soft
Ma nual
デバッグ情報の削除指定 (-Xg)
C コンパイラやアセンブラで , デバッグ情報の出力指定をして作られたオブジェクト
モジュールには , デバッガで利用するためのデバッグ情報が含まれています。
デバッグ情報をリンク後に取り去るためには , -Xg オプションを指定します。または ,
-g オプションの指定を行わないようにします。
■ デバッグ情報の削除指定 (-Xg)
【記述形式】
-Xg ( デフォルト )
【パラメータ】
なし
【説明】
リンカは , 入力するオブジェクトモジュールファイルまたは相対形式ロードモ
ジュールファイルにデバッグ情報が含まれている場合 , デフォルト出力ではデバッ
グ情報を削除しますので , 本オプションを指定する必要はありません。
オプションファイルを利用したリンクにおいて , オプションファイル中に -g オプ
ションがある場合など , -g オプションを無効にするときに使用します。
【例】
flnk896s -f rllnk.opt b1 b2 -Xg
September 1, 2014, CM25-00321-5
rllnk.opt
-r
# relocatable LM output
-g
# debug info.
-pw 100
# page width
-o rel1.rel
# output filename
97
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.4
So ft
Manu al
絶対形式ロードモジュールの出力指定 (-a)
-a オプションは , リンカの最終目的ファイルである , 絶対形式のロードモジュールを
作成することを指示するオプションです。
■ 絶対形式ロードモジュールの出力指定 (-a)
【記述形式】
-a ( デフォルト )
【パラメータ】
なし
【説明】
絶対形式のロードモジュールファイル出力を指示します。
リンカのデフォルト出力は絶対形式ですので , 通常使用することはありません。
-r オプション指定を打ち消し -a 指定に変更する場合に指定します。
絶対形式の出力ファイルは , 以下の名前で作成されます。
• -o オプション指定がないとき : 最初に指定された入力ファイルの拡張子を ".abs" と
した名称。
• -o オプション指定があるとき : 指定された名称。拡張子指定がないときは , ".abs" を
付加した名称。
【例】
flnk896s a1 a2 a3 -r -o a123.abs -a
コマンドラインの途中の -r オプションを無効にします。
出力ロードモジュールファイルは , 絶対形式で作成されます。
98
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
相対形式ロードモジュールの出力指定 (-r)
6.2.5
-r オプションは , 再入力可能な相対形式ロードモジュールを作成することを指示する
オプションです。相対形式のロードモジュールは , アドレス解決を行わないで複数
のモジュールを 1 つのファイルにまとめた形式を持っています。
■ 相対形式ロードモジュールの出力指定 (-r)
【記述形式】
-r
【パラメータ】
なし
【説明】
相対形式のロードモジュールファイル出力を指示します。
リンカのデフォルト出力 ( 絶対形式 ) を変更するときに指定します。
-a オプションのあとに -r オプションを指定すると , -a オプションを無効にすること
ができます。
相対形式のロードモジュールは , アドレス解決を行わないで複数のオブジェクトモ
ジュールを 1 つのファイルにまとめた形式です。リンカへの再入力が可能であり ,
以降のリンク処理で指定する入力ファイル数を少なくできることが利点ですが , こ
の中のモジュールに変更が生じた場合には , ライブラリ形式ファイルと異なり差し
替えることはできません。
このオプションが指定された場合 , 絶対形式アセンブルリスト , オブジェクト内容
リストに関するオプションはすべて無視され , それらのファイルは出力されませ
ん。
出力ファイルは , 以下の名前で作成されます。
• -o オプション指定がないとき : 最初に指定された入力ファイルの拡張子を ".rel" とし
た名称。
• -o オプション指定があるとき : 指定された名称。拡張子指定がないときは , ".rel" を
付加した名称。
【例】
flnk896s a1 a2 a3 -r -o a123.rel
リンカの出力オブジェクトを相対形式にします。
<注意事項>
最初に指定された入力ファイルが , 拡張子 ".rel" であるとき , 出力ファイル名が同じにな
ります。この場合 , 入力ファイルの内容は保存されませんので , 不都合がある場合には ,
-o オプションで出力ファイル名の指定をしてください。
September 1, 2014, CM25-00321-5
99
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.6
So ft
Manu al
ROM 領域のフィル指定 (-fill)
-fill オプションは指定した領域を指定した値で埋めるオプションです。
■ ROM 領域のフィル指定 (-fill)
【記述形式】
-fill < スタートアドレス >/< エンドアドレス >, < フィル値 > [/< ビット幅 >] [/< エンディアン >]
【パラメータ】
< スタートアドレス >
値を埋める領域の開始アドレスを指定します。このパラメータは省略できません。
< エンドアドレス >
値を埋める領域の終了アドレスを指定します。このパラメータは省略できません。
< フィル値 >
スタートアドレスとエンドアドレスで指定した領域のオブジェクトデータが存在
しない箇所を埋める値を指定します。このパラメータは省略できません。
< ビット幅 >
フィル値のビット幅を 8, 16 または 32 のいずれかで指定します。このパラメータは
省略できます。省略時のビット幅は 8 です。
8 : 8 ビット
16 : 16 ビット
32 : 32 ビット
< エンディアン >
フィル値のエンディアンを B または L で指定します。このパラメータは省略できま
す。省略時のエンディアンは B です。
B: ビッグエンディアン
L: リトルエンディアン
【説明】
スタートアドレスとエンドアドレスで指定した領域のオブジェクトデータが存在
しない箇所が指定したフィル値で埋められます。
値を埋める領域が複数ある場合 , -fill オプションを複数指定してください。
値を埋める領域が重なった場合 , 重なった領域は後に指定した -fill オプションの
フィル値で埋められます。
-cs オプションの値を埋める領域と -fill オプションの値を埋める領域が重なった場
合 , 重なった領域は常に -fill オプションのフィル値で埋められます。
本オプションは , 絶対形式ロードモジュール作成時に有効となります。
相対形式ロードモジュール作成時は , 以下の警告メッセージが出力され , 本オプ
ションの指定は無視されます。
100
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
[ 警告メッセージ ]
*** W1321L: REL モード時には (-fill) オプションは無視されます。
【例】
以下のような指定を行った場合 , 各領域は図 6.2-1 のようにフィル値で埋められま
す。
flnk896s -fill 0x5000/0x6FFF, 0x0055AAFF/32/B -fill 0x7000/0x8FFF, 0x1234/16/L
-fill 0x8000/0x8FFF, 0x5678/16/B
図 6.2-1 フィル領域指定例
flnk896s
-fill 0x5000/0x6FFF,0x0055AAFF/32/B
-fill 0x7000/0x8FFF,0x1234/16/L
-fill 0x8000/0x8FFF,0x5678/16/B
①
②
③
フィル領域
フィル領域配置イメージ
0x5000
①の指定領域
①の指定領域
①で指定したフィル値で埋められます。
(0x00,0x55,0xAA,0xFF,0x00,0x55,0xAA,
0xFF,・・・)
②の指定領域
②で指定したフィル値で埋められます。
0x34,0x12,0x34,0x12,・・・
③の指定領域
③で指定したフィル値で埋められます。
0x56,0x78,0x56,0x78,・・・
0x6FFF
0x7000
0x7FFF
0x8000
②の指定領域
③の指定領域
0x8FFF
②と③のフィル対象領域は重なっています。
③のフィル領域指定が②より後に行われているため,
重なっている領域は③で指定したフィル値で埋められます。
September 1, 2014, CM25-00321-5
101
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
オブジェクトデータと値を埋める領域が重なる場合 , 図 6.2-2 のように , 各領域が
フィル値で埋められた後 , オブジェクトデータが配置されます。
図 6.2-2 最終的なオブジェクトデータ
オブジェクトデータ配置前
オブジェクトデータ配置後
0x5000
フィル領域配置後に
セクションを配置する。
オブジェクトデータ
オブジェクトデータ
0x6FFF
0x7000
0x7FFF
0x8000
オブジェクトデータ
オブジェクトデータ
0x8FFF
102
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.7
Soft
Ma nual
マップリストファイル名の指定 (-m)
リンカが出力するマップリストファイルのファイル名を指定します。
このオプションが指定されないときは , 出力ロードモジュールファイル名からファ
イル名を作ります。
■ マップリストファイル名の指定 (-m)
【記述形式】
-m < マップリストファイル名 > ( デフォルト )
【パラメータ】
< マップリストファイル名 >
出力マップリストファイル名パラメータは省略できません。
【説明】
リンカは , デフォルトでマップリストファイルを出力します。このとき , 出力ロー
ドモジュールファイルの拡張子を , ".mp1" とした名称のファイルが作られます。
-m オプションは , デフォルトのマップリストファイル名を変更したいときに使用し
ます。
-Xm オプションの後に -m オプションを指定すると , -Xm オプションを無効にする
ことができます。
【例】
flnk896s a1 a2 a3 -r -o a123.rel -m a123.map
リンカが出力するマップリストファイル名を a123.map にします。
September 1, 2014, CM25-00321-5
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 オプションは無効になります。
【例】
flnk896s a1 a2 a3 -r -o a123.rel -Xm
マップリストファイルの作成は行わないようにします。
104
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.9
Soft
Ma nual
リスト表示の名前の省略解除 (-dt)
リンカのマップリスト , オブジェクト内容リストには , セクション名やシンボル名な
ど名前の表示がありますが , デフォルトでのリスト出力では見やすさを考慮して , 長
い名前は途中までを表示するようにしています。
このオプションは , 名前を省略せずに出力することを指示します。
マップリストの表示フォーマットについては , 「7.2 リンクリストファイル」を参照
してください。
■ リスト表示の名前の省略解除 (-dt)
【記述形式】
-dt
【パラメータ】
なし
【説明】
マップリスト , オブジェクト内容リストで表示されるシンボル名およびセクション
名を途中で省略せずに表示します。この場合 , 1 つのシンボル名 , セクション名は数
行に渡って表示されます。
デフォルト出力では 80 文字程度の表示ができますが , リスト 1 行の表示桁数を小さ
な値に設定したときに表示可能な文字数も減りますので , シンボル名およびセク
ション名の省略表示が起こりえます。
【例】
flnk896s a1 a2 a3 -o a123.abs -m a123.map -dt
使用されているシンボル名およびセクション名は , 省略することなくリストに表示
します。
September 1, 2014, CM25-00321-5
105
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
メモリ使用情報リストの出力指定 (-mmi)
6.2.10
リンカが出力するマップリストファイルの中にメモリ使用情報を出力するように指
示します。
■ メモリ使用情報リストの出力指定 (-mmi)
【記述形式】
-mmi
【パラメータ】
なし
【説明】
リンカが , デフォルトで出力するマップリストファイルの中に , オプションで指定
された ROM 領域と RAM 領域の使用状況を示すメモリ使用情報リストを出力しま
す。
使用可能領域 , 使用した領域や領域内ギャップの位置とサイズなどの情報を表示し
ます。
【例】
flnk896s l0mp00 im_lnk -mmi
-ra RAM1=0x0080/0x02FF,RAM2=0x0300/0x047F
-ro ROM1=0xC000/0xCFFF,ROM2=0xD000/0xFFFF -AL 2
<注意事項>
-mmi が指定されていても , 以下の場合は出力を行いません。
• メモリ領域の設定がない (-ra, -ro の指定がない )。
• マップリストファイルの出力が有効になっていない。
106
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
リスト行の桁数指定 (-pw)
6.2.11
リンカ出力のマップリスト , オブジェクト内容リストは , デフォルトでは 1 行に 132
桁までを表示します。このオプションは , 1 行の表示桁数を変更するときに指定しま
す。
■ リスト行の桁数指定 (-pw)
【記述形式】
-pw < 桁数 > ( デフォルト :132)
【パラメータ】
< 桁数 >
1 行に表示する桁数。70 ~ 1023 の範囲で指定します。
【説明】
リンクリストファイル , オブジェクト内容リストの 1 行の長さの指定を行います。
この指定がない場合は , 132 桁になります。
【例】
flnk896s a1 a2 a3 -o a123.abs -m a123.map -dt -pw 80
リスト行の表示桁数を 80 にします。
< 注意事項 >
以下のリストは -pw オプションで 1 行の桁数を指定できます。
• リンクマップリスト (.mp1)
• セクション詳細マップリスト (.mpm)
以下のリストは -pw オプションで 1 行の桁数を指定できません。
• 絶対形式アセンブルリスト (.als)
• 外部シンボル相互参照情報リスト (.mpx)
• ローカルシンボル情報リスト (.mps)
September 1, 2014, CM25-00321-5
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 の指定は , ページ制御を行わないようにするものです。
【例】
flnk896s 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
CM25-00321-5, September 1, 2014
第 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
です。
September 1, 2014, CM25-00321-5
109
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【説明】
スタートアドレスとエンドアドレスで指定した領域に対して , 指定した演算方法に
よるチェックサム演算が行われます。結果はマップファイルに出力されます。この
とき , チェックサム演算の対象領域のオブジェクトデータが存在しない箇所は ,
チェックサム演算の前にフィル値で埋められます。
マップファイルへの出力例を図 6.2-3 に示します。図 6.2-3 の S_Addr., E_Addr.,
Algorithm および Value は , それぞれスタートアドレス , エンドアドレス , チェック
サム演算方法およびチェックサム演算の結果に該当します。
図 6.2-3 マップファイルへの出力例
Check Sum(s)
S_Addr.
-E_Addr.
0x00007000-0x00007FFF
Algorithm
Value
SUM32=1
0x92DA8F5B
複数の領域をまとめてチェックサム演算する場合は , 1 つの -cs オプションに複数の
領域を指定してください。複数の領域を指定する場合は , スタートアドレスとエン
ドアドレスのペアをカンマで区切って指定してください。
複数の領域を個別にチェックサム演算を行う場合は, -csオプションを複数記述して
ください。
チェックサム演算の対象領域が重なった場合 , 重なった領域は後に指定した -cs オ
プションのフィル値で埋められます。
-cs オプションの値を埋める領域と -fill オプションの値を埋める領域が重なった場
合 , 重なった領域は常に -fill オプションのフィル値で埋められます。
本オプションは , 絶対形式ロードモジュール作成時に有効となります。
相対形式ロードモジュール作成時は , 以下の警告メッセージが出力され , 本オプ
ションの指定は無視されます。
[ 警告メッセージ ]
*** W1321L: REL モード時には (-cs) オプションは無視されます。
110
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 1】
flnk896s -cs 0x7000/0x7FFF, SUM32, 0x7F
32 ビット単純加算で 0x7000/0x7FFF の領域のチェックサム演算を行います。
チェックサム演算の対象領域でオブジェクトデータがない箇所は 0x7F で埋められ
ます ( 図 6.2-4 参照 )。
図 6.2-4 チェックサム演算の例 1
チェックサム演算領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0x7000
オブジェクトデータ
オブジェクトデータがない箇所は,
0x7Fで埋められた後,チェックサム
演算が行われます。
チェックサム
演算対象領域
オブジェクトデータ
0x7FFF
0xFFFF
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
0x00007000-0x00007FFF
September 1, 2014, CM25-00321-5
Algorithm
SUM32=0
Value
0x252B7378
111
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例 2】
flnk896s -fill 0x7000/0x7FFF, 0xFF/8 -cs 0x6000/0x8FFF, SUM16=2, 0x7F
16 ビット単純加算 ( 補数 2) で 0x6000/0x8FFF の領域のチェックサム演算を行います。
-cs と -fill を同時に指定した場合 , オブジェクトデータがなくフィル指定されていな
い箇所が 0x7F で埋められた後にチェックサム演算が行われます ( 図 6.2-5 参照 )。
図 6.2-5 チェックサム演算の例 2
チェックサム演算
領域の設定
フィル対象
領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0x6000
オブジェクトデータ
0x6FFF
0x7000
チェックサム
演算対象領域
フィル対象領域
0x7FFF
0x8000
オブジェクトデータがなく,
フィル指定がない箇所は,
0x7Fで埋められた後,
チェックサム演算が行われます。
オブジェクトデータ
オブジェクトデータ
0x8FFF
0x7000~0x7FFFは,フィルオプションにより
0xFFで埋められます。
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
0x00006000-0x00008FFF
112
Algorithm
SUM16=2
Value
0xCA64
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 3】
flnk896s -cs 0x6000/0x6FFF, 0x8000/0x8FFF, CRC16, 0x7F
16 ビット巡回冗長検査 (CRC16) で 0x6000/0x6FFF と 0x8000/0x8FFF の領域のチェッ
クサム演算を行います ( 図 6.2-6 参照 )。
図 6.2-6 チェックサム演算の例 3
チェックサム演算領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
0x6000
チェックサム
演算対象領域
オブジェクトデータ
0x6FFF
0x8000
それぞれの領域のオブジェクトデータが
ない箇所が0x7Fで埋められた後, チェッ
クサム演算が行われます。
この2つの領域は, まとめてチェックサム
演算されます。
オブジェクトデータ
チェックサム
演算対象領域
0x8FFF
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
0x00006000-0x00006FFF
0x00008000-0x00008FFF
September 1, 2014, CM25-00321-5
Algorithm
CRC16=0x8005
Value
0xEB83
113
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例 4】
flnk896s -cs 0x6000/0x6FFF, CRC16, 0x7F -cs 0x8000/0x8FFF, CRC32, 0xFF
16 ビット巡回冗長検査 (CRC16) で 0x6000/0x6FFF の領域のチェックサム演算を行
います。
また , 32 ビット巡回冗長検査 (CRC32) で 0x8000/0x8FFF の領域のチェックサム演算
を行います ( 図 6.2-7 参照 )。
図 6.2-7 チェックサム演算の例 4
チェックサム演算領域の設定
セクション配置後の
オブジェクトデータ
オブジェクトデータ
オブジェクトデータがない箇所が
0x7Fで埋められた後, チェックサム
演算が行われます。
0x6000
チェックサム
演算対象領域
オブジェクトデータ
0x6FFF
オブジェクトデータ
0x8000
チェックサム
演算対象領域
オブジェクトデータがない箇所が
0xFFで埋められた後, チェックサム
演算が行われます。
0x8FFF
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
Algorithm
Value
0x00006000-0x00006FFF CRC16=0x8005
0xA1A9
0x00008000-0x00008FFF CRC32=0x04C11DB7 0xF154670A
114
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
【例 5】
flnk896s -cs 0x7000/0x8FFF, SUM16=1, 0x7F -cs 0x8000/0x8FFF, SUM32=2, 0xFF
16 ビット単純加算で 0x7000/0x8FFF の領域のチェックサム演算を行います。
0x7000/
0x7FFF の領域でオブジェクトデータがない箇所は 0x7F で埋められます。
また , 32 ビット単純加算で 0x8000/0x8FFF の領域のチェックサム演算を行います。
0x8000/0x8FFF の領域でオブジェクトデータがない箇所は 0xFF で埋められます ( 図
6.2-8 参照 )。
図 6.2-8 チェックサム演算の例 5
セクション配置後の
オブジェクトデータ
チェックサム演算領域の設定
オブジェクトデータ
オブジェクトデータがない箇所が
0x7Fで埋められた後, チェックサム
演算が行われます。
0x7000
オブジェクトデータ
チェックサム
演算対象領域
0x8000
オブジェクトデータ
チェックサム
演算対象領域
オブジェクトデータがない箇所が
0xFFで埋められた後, チェックサム
演算が行われます。
0x8FFF
チェックサム演算対象領域が重なった場合, 後で指定した
-csオプションのフィル値が有効となります。
マップリスト出力
Check Sum(s)
S_Addr.
-E_Addr.
0x00006000-0x00008FFF
0x00008000-0x00008FFF
September 1, 2014, CM25-00321-5
Algorithm
SUM16=1
SUM32=2
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 リンケージキットのエラーメッセージ」を参照してください。
【例】
flnk896s a1 a2 a3 -o a123.abs -w 2 -Xm
すべてのメッセージを出力します。
116
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.15
Soft
Ma nual
ROM 領域の指定 (-ro)
プログラムで使用する予定の ROM 領域を定義することにより , セクションの配置を
行うときのアドレス指定を簡略化します。
また , プログラムサイズのチェックも可能にします。
■ ROM 領域の指定 (-ro)
【記述形式】
-ro < 領域名 >=< スタートアドレス >/< エンドアドレス >
[,< 領域名 >=< スタートアドレス >/< エンドアドレス >] …
【パラメータ】
< 領域名 >
設定するアドレス領域を示す名前
< スタートアドレス >
設定するアドレス領域の先頭アドレス
< エンドアドレス >
設定するアドレス領域の最終アドレス
【説明】
ROM 領域の定義を行います。領域は , 必要に応じていくつでも定義できます。
スタートアドレスとエンドアドレスを指定して , その領域に名前を付けます。
このオプションで定義した領域名は , セクション配置オプションで使用します。
-roオプションの定義だけではリンカの動作には何の効果も及ぼさないので, 必ずセ
クション配置オプションでのアドレス指定パラメータに , ここで定義した領域名を
使うことになります。
【例】
flnk896s *.obj -o ap.abs -ro RomA=0x8000/0x9FFF -sc code=RomA •••
セクション名 code のセクションを , 0x8000 ~ 0x9FFF のアドレスに配置することを
指定します。
0x8000 番地から順に配置し , 0x9FFF 番地を越えた場合には警告メッセージを出力
します。
September 1, 2014, CM25-00321-5
117
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.16
So ft
Manu al
RAM 領域の指定 (-ra)
プログラムで使用する予定の RAM 領域を定義することにより , セクションの配置を
行うときのアドレス指定を簡略化します。
また , プログラムサイズのチェックも可能にします。
■ RAM 領域の指定 (-ra)
【記述形式】
-ra < 領域名 >=< スタートアドレス >/< エンドアドレス >
[,< 領域名 >=< スタートアドレス >/< エンドアドレス >] …
【パラメータ】
< 領域名 >
設定するアドレス領域を示す名前
< スタートアドレス >
設定するアドレス領域の先頭アドレス
< エンドアドレス >
設定するアドレス領域の最終アドレス
【説明】
RAM 領域の定義を行います。領域は , 必要に応じていくつでも定義できます。
スタートアドレスとエンドアドレスを指定して , その領域に名前を付けます。
このオプションで定義した領域名は , セクション配置オプションで使用します。
-ra オプションの定義だけではリンカの動作には何の効果も及ぼさないので , 必ずセ
クション配置オプションでのアドレス指定パラメータに , ここで定義した領域名を
使うことになります。
【例】
flnk896s *.obj -o ap.abs -ra RamD=0x0100/0x01FF -sc data=RamD •••
セクション名 data のセクションを , 0x0100 ~ 0x1FF のアドレスに配置することを指
定します。
0x0100 番地から順に配置し , 0x01FF 番地を越えた場合には警告メッセージを出力
します。
118
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.17
Soft
Ma nual
セクション配置順 / アドレスの指定 (-sc)
セクション配置の開始アドレスおよび配置順をリンカに指示します。
■ セクション配置順 / アドレスの指定 (-sc)
【記述形式】
-sc < セクション名リスト > [/< 内容種別 >]
[={< アドレス > | < 領域名 >} ] [, ••• ]
【パラメータ】
< セクション名リスト >
セクション名またはセクショングループ名リストセクション名の指定には , ワイル
ドカードが使えます。複数指定するときは , + 記号で連結します。
< 内容種別 >
code, data, stack, const, dir, dirconst, IO, dir, dirconst
< アドレス >
配置先頭アドレス
< 領域名 >
ROM/RAM 指定オプションで指定した領域名
【説明】
セクション配置の順序指定および配置アドレスの指定を行います。
セクション配置の順序は , パラメータに記述された順序に従います。
アドレスまたは領域名指定がない場合は , 0 番地から配置します。
セクション名の先頭に @ マークを付けると , 実行時にデータを ROM から RAM に
転送して動作する ROM → RAM 転送セクションの ROM 側のアドレス指定になりま
す。
ワイルドカードを使用する場合は , 以下の文字で囲んでください。ただし , オプショ
ンファイル中ではワイルドカードを "( ダブルクォート ) で囲まないでください。
September 1, 2014, CM25-00321-5
119
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例 1】
flnk896s *.obj -o ap.abs -sc "*/code"=0xC100,D=0x0100 •••
図 6.2-9 にこの場合の配置例を示します。
0xC100 番地から内容種別が code のセクションを配置し , 0x0100 番地からセクショ
ン D を配置します。
図 6.2-9 セクションの配置例 1
0x0100
D
0xC100
内容種別がcodeの
セクション
【例 2】
flnk896s
*.obj -o ap.abs -ro ROM=0x8000/0xFFFF -ra RAM=0x0100/0x087F -sc
P+code+text1=ROM,D=RAM
図 6.2-10 にこの場合の配置例を示します。
ROM/RAM オプションを使用したセクション配置指定の場合 , 配置終了アドレスの
チェックが行えます。
図 6.2-10 セクションの配置例 2
0x0100
0x087F
D
0x8000
P
CODE
text1
0xFFFF
120
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
< セクション名リスト > に使用できるワイルドカード文字は "*" のみで , 記述パター
ンは以下の 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, _ など
~*~
-sc "ab_*_1/code"
マッチする
ab_XX_1, ab_ _1 など
マッチしない
aab_XX_11, ab_1 など
September 1, 2014, CM25-00321-5
説明
内容種別が code であるすべて
のセクションとマッチします。
内容種別が code であり , セク
ション名の先頭 3 文字が "ab_"
であるすべてのセクションと
マッチします。
内容種別が code であり , セク
ション名の最後の 2 文字が "_1"
であるすべてのセクションと
マッチします。
内容種別が code であり , セク
ション名の先頭 3 文字が "ab_"
で , かつ最後の 2 文字が "_1" で
あるすべてのセクションとマッ
チします。
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】
flnk896s *.obj -o ap.abs -ro ROM=0x8000/0xFFFF -ra RAM=0x0100/0x57F •••
-gr romG=P+CODE+text1 -sc romG=ROM,D=RAM •••
グループ化オプションを使用した場合は , セクション名を幾つも指定するかわりに ,
その全体をグループ名で代表することができます。
【例 2】
flnk896s *.obj -o ap.abs -gr cdgrp="*/code" -sc cdgrp=0x8000
内容種別が code であるセクションをすべて結合して cdgrp というグループ名を付け
ます。それを -sc オプションで 0x8000 番地に配置します。
122
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.19
Soft
Ma nual
レジスタバンク領域の指定 (-rg)
プログラムで使用するレジスタバンク領域の指定を行います。
■ レジスタバンク領域の指定 (-rg)
【記述形式】
-rg < レジスタバンク番号 >
[{,< レジスタバンク番号 > | -< レジスタバンク番号 >} ] …
【パラメータ】
< レジスタバンク番号 >
設定するレジスタバンクの番号を指定します。
【説明】
プログラムで使用するレジスタバンク領域の設定を行います。
プログラム中で汎用レジスタを使用する場合には , 本オプションで領域の確保が必
要です。
連続するレジスタバンク番号を指定する場合には , "3-8" のようにハイフンを用いて
一括指定が可能です ( この場合 , レジスタバンク 3, 4, 5, 6, 7, 8 を指定 )。
本指定が行われない場合 , リンカはレジスタバンク領域の確保を行いません。
September 1, 2014, CM25-00321-5
123
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
表 6.2-1 に -rg オプションで確保される領域を示します。
表 6.2-1 レジスタバンク番号と領域
番号
確保される領域
番号
確保される領域
0
0x0100 ~ 0x0107
16
0x0180 ~ 0x0187
1
0x0108 ~ 0x010F
17
0x0188 ~ 0x018F
2
0x0110 ~ 0x0117
18
0x0190 ~ 0x0197
3
0x0118 ~ 0x011F
19
0x0198 ~ 0x019F
4
0x0120 ~ 0x0127
20
0x01A0 ~ 0x01A7
5
0x0128 ~ 0x012F
21
0x01A8 ~ 0x01AF
6
0x0130 ~ 0x0137
22
0x01B0 ~ 0x01B7
7
0x0138 ~ 0x013F
23
0x01B8 ~ 0x01BF
8
0x0140 ~ 0x0147
24
0x01C0 ~ 0x01C7
9
0x0148 ~ 0x014F
25
0x01C8 ~ 0x01CF
10
0x0150 ~ 0x0157
26
0x01D0 ~ 0x01D7
11
0x0158 ~ 0x015F
27
0x01D8 ~ 0x01DF
12
0x0160 ~ 0x0167
28
0x01E0 ~ 0x01E7
13
0x0168 ~ 0x016F
29
0x01E8 ~ 0x01EF
14
0x0170 ~ 0x0177
30
0x01F0 ~ 0x01F7
15
0x0178 ~ 0x017F
31
0x01F8 ~ 0x01FF
【例】
flnk896s *.obj -o ap.abs -rg 0, 1, 5-7 •••
レジスタバンク領域 0, 1, 5, 6, 7 を確保します。
124
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.20
Soft
Ma nual
自動配置指定 (-AL)
セクションの自動配置の指定を行います。
■ 自動配置指定 (-AL)
【記述形式】
-AL { 0 | 1 | 2 }
【パラメータ】
<0>
自動配置を行いません。( デフォルト )
<1>
領域内にアブソリュートセクションが存在するとき , そのセクションと重複しない
ように配置します。
<2>
セクションの属性から , ROM 領域に配置すべきか , RAM 領域に配置すべきかを判
断し , それぞれの領域内の空き領域に配置します。
(link907a 自動配置互換 )
【説明】
セクションの自動配置の指定を行います。
• パラメータ 1 の場合 : -ra, -ro オプションで指定した領域内へセクション配置を行う
とき , アブソリュートセクションが存在していれば , 配置アドレスが重ならないよ
うに , リロケータブルセクションの配置を行います。このとき , アライメント値お
よびサイズの大きいセクションから順に配置し , 空き領域が最小となるような最適
配置を行います。
• パラメータ 2 の場合 : -sc オプションで配置指定が行われなかったセクションに対し
て , セクションの属性から , ROM 領域に配置すべきか , RAM 領域に配置すべきかを
判断し , それぞれの領域内の空き領域に配置します。
「5.6 セクションの自動配置」を合わせて参照してください。
【例】
flnk896s -AL 1 -ro ROM=0x8000/0x8FFF -sc code1+code2+code3=ROM ...
ただし , 各セクションは以下のようなものであるとします。
• code1 : リロケータブル , サイズ =0x18
• code2 : リロケータブル , サイズ =0x10
• code3 : リロケータブル , サイズ =0x30
• AbsSec : アブソリュート , アドレス範囲 =0x8010 ~ 0x8017
September 1, 2014, CM25-00321-5
125
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
この場合の , リンクマップを示します。
S_Addr. -E_Addr Size
00008000-0000800F
00008010-00008017
00008018-00008047
00008048-0000805F
Section Type
00000010
00000008
00000030
00000018
AL
CODE
CODE
CODE
CODE
Sec
P
N
P
P
R-XI
R-XI
R-XI
R-XI
02 REL code2
00 ABS AbsSec
02 REL code3
02 REL code1
<注意事項>
-AL 1 が指定されていても , 以下の場合は自動配置を行いません。
• 領域の設定がない (-ra, -ro の指定がない )。
• -sc のアドレス指定で領域名を使用していない。
• 指定した領域内に配置されるアブソリュートセクションがない。
-AL 2 を指定した場合 , 以下の場合はエラーになりリンク処理を行いません。
• 領域の設定がない (-ra, -ro の指定がない )。
-w 2 を指定すると自動配置機能が働いた場合メッセージが出力されます。
126
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.21
Soft
Ma nual
検索ライブラリファイルの指定 (-l)
デフォルトライブラリ以外に検索すべきライブラリを指示します。複数のライブラ
リファイルがある場合 , 検索順に指定します。
■ 検索ライブラリファイルの指定 (-l)
【記述形式】
-l < ライブラリファイル名 > [, … ]
【パラメータ】
< ライブラリファイル名 >
検索するライブラリファイル名を記述します。パス名付の指定も可能。ワイルド
カード使用可能。
【説明】
指定された順に , ライブラリファイルを検索します。
デフォルトライブラリより先に , ここで指定したライブラリが検索されます。
パス名なしでライブラリファイルを指定した場合に検索されるディレクトリは , -L
オプションで指定したディレクトリ , 環境変数 LIB896 で指定のディレクトリ , 環境
変数 FETOOL より導かれるシステムライブラリパスの順になります。
カレントディレクトリは検索しません。カレントディレクトリを検索対象にしたい
ときは , -L オプションまたは環境変数 LIB896 にピリオド (.) を指定してください。
-nl オプションより後で , -l オプションを指定することで -nl オプションを無効にす
ることができます。
ワイルドカードを使用する場合は , "( ダブルクォート ) で囲んでください。ただし ,
オプションファイル中ではワイルドカードを "( ダブルクォート ) で囲まないでくだ
さい。
【例】
flnk896s *.obj -o ap.abs -l ..\lib\com.lib,libu
flnk896s *.obj -o ap.abs -l "p*.lib"
ファイル名の先頭 1 文字が "p" であるすべてのライブラリファイルが検索対象にな
ります。
September 1, 2014, CM25-00321-5
127
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.22
So ft
Manu al
ライブラリ検索パスの指定 (-L)
ライブラリファイルを検索するパス名の指定を行います。
■ ライブラリ検索パスの指定 (-L)
【記述形式】
-L < ライブラリパス名 > [, … ]
【パラメータ】
< ライブラリパス名 >
ライブラリファイルを格納したパス名
【説明】
-l オプションで指定したライブラリファイルが , どのディレクトリにあるのかをリ
ンカに指示します。
通常は , 本オプションを指定しなくてもよいように環境変数 LIB896 を設定してお
きます。
LIB896 で指定したパスには , C コンパイラに付属の C ライブラリを格納しますので ,
特別にユーザが作成したライブラリを別ディレクトリで管理したいような場合に ,
-L オプションを使用してください。
複数のパスが指定された場合は , 指定順に検索します。
ライブラリファイルは , まずここで指定されたパスから探し , なければ環境変数
LIB896 で指定されたパス , 環境変数 FETOOL より導かれるシステムライブラリパ
スの順で検索します。
ライブラリファイルの指定で , パス名まで含めて指定された場合は , そのパスだけ
を検索します。
-nl オプションがある場合は , ライブラリ検索を行わないので -L オプションは無効
になります。
【例】
flnk896s *.obj -o ap.abs -L C:\usr\usrlib -l com.lib,libu
128
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.23
Soft
Ma nual
シンボル個別のライブラリの指定 (-el)
外部参照シンボルの値の解決に使用するライブラリファイルを特定することができ
ます。
■ シンボル個別のライブラリの指定 (-el)
【記述形式】
-el < シンボル名リスト >=< ライブラリファイル名 > [, … ]
【パラメータ】
< シンボル名リスト >
外部参照シンボル名を記述します。
複数シンボルを指定する場合は , / で区切ります。
< ライブラリファイル名 >
検索対象とするライブラリファイル名
パス名付の指定も可能です。なお , ワイルドカードは使用できません。
【説明】
本オプションで指定した外部参照シンボルの値の解決に使用するライブラリファ
イルを特定します。
同じ外部定義シンボル名を含むモジュールが , 複数ライブラリに存在しているのが
分かっており , リンカが標準で行うライブラリ検索順では希望しないモジュールが
結合されてしまうときに使用します。
この機能を使用せざるを得ないのは , 複数のライブラリを使用するときにライブラ
リの作成方法に問題があるためです。思わぬ障害混入の原因を含んでいますので ,
できれば使用しないことが望ましいものです。
ライブラリファイルの作り直しを検討してください。
なお , パス名指定なしでライブラリファイル名を指定した場合の検索ディレクトリ
は , -l オプションと同じです。
【例】
flnk896s *.obj -o sp.abs -L C:\usr\usrlib -l libu,sublib -el sym1=sublib
September 1, 2014, CM25-00321-5
129
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.24
So ft
Manu al
ライブラリ検索の抑止指定 (-nl)
ライブラリファイルの検索を行わないことを指示します。
■ ライブラリ検索の抑止指定 (-nl)
【記述形式】
-nl
【パラメータ】
なし
【説明】
ライブラリファイルの検索を行わないようにします。
【例 1】
flnk896s -L C:\usr\usrlib -l libu,sublib *.obj -o ap.abs -nl
先に指定した -L, -l, -el オプションを無効にし , デフォルトライブラリも含めて , ラ
イブラリの検索を行わないようにします。
【例 2】
flnk896s -l libl *.obj -o ap.abs -nl -l lib2
一度指定した lib1.lib をキャンセルして , lib2.lib を検索するように指定し直すことが
できます。
この例のように , 複数の -l オプションの間に -nl オプションを指定すると , -nl の指
定以前に指定していた -l オプションはすべてキャンセルされます。しかし , -L オプ
ションの指定 , -el オプション指定 , -nd オプション指定およびデフォルトライブラ
リの検索は -nl 指定以前の設定状態になります。
したがって , この例の場合は , lib2.lib とデフォルトライブラリを検索します。
130
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.25
Soft
Ma nual
デフォルトライブラリ検索の抑止指定 (-nd)
デフォルトライブラリとは , C コンパイラが使用することを仮定したライブラリファ
イルであり , オブジェクトファイル中にそのライブラリファイル名が設定されてい
ます。
このデフォルトライブラリファイルの検索を行わないことを指示します。
■ デフォルトライブラリ検索の抑止指定 (-nd)
【記述形式】
-nd
【パラメータ】
なし
【説明】
デフォルトライブラリファイルの指定を無効とし , 検索しないようにします。
【例】
flnk896s -L C:\usr\usrlib -l libu,sublib *.obj -o ap.abs -nd
-l オプションで指定したライブラリのみを検索し , デフォルトライブラリの検索は
行わないようにします。
September 1, 2014, CM25-00321-5
131
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.26
So ft
Manu al
エントリアドレスの指定 (-e)
ユーザプログラムの実行開始アドレスを , 外部定義シンボルで指定します。
■ エントリアドレスの指定 (-e)
【記述形式】
-e < シンボル名 >
【パラメータ】
< シンボル名 >
エントリポイントのシンボル名
外部定義シンボル以外は指定できません。
【説明】
ユーザプログラムの実行開始アドレスを , 外部定義シンボルで指定したものに変更
します。
実行開始アドレスは , アセンブラの .end 疑似命令で指定できます。
エントリポイントは , シュミレータデバッガで , 実行開始時の PC( プログラムカウ
ンタ ) の初期値として設定されます。
【例】
flnk896s *.obj -o ap.abs -e ProgStart
132
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.27
Soft
Ma nual
外部シンボル値の仮設定 (-df)
ユーザプログラム未定義シンボルの値を強制的に定義します。
■ 外部シンボル値の仮設定 (-df)
【記述形式】
-df < シンボル名 >={< 数値 > | < 外部定義シンボル名 >}
【パラメータ】
< シンボル名 >
外部参照シンボルのシンボル名
< 数値 >
定義する値
< 外部定義シンボル名 >
値の定義されている外部シンボル名
【説明】
未定義の外部参照シンボルの値を強制的に定義します。
リンカはリロケーション解決にこの値を用いてオブジェクトデータを作成します
が , 出力する絶対形式ロードモジュールファイル中のシンボル情報には影響を与え
ません。
デバッガなどでロードした場合 , ここで指定したシンボル名は未定義のままです。
【例】
flnk896s -L \usr\usrlib -l libu,sublib *.obj -o ap.abs -df Sym1=100
Sym1 が定義されていないとき , 値を 100 とします。
September 1, 2014, CM25-00321-5
133
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
ターゲット CPU 指定 (-cpu)
6.2.28
ターゲット CPU の指定を行います。
リンクを行うプログラムのターゲット CPU を MB 番号で指定します。
■ ターゲット CPU 指定 (-cpu)
【記述形式】
-cpu <MB 番号 >
【パラメータ】
<MB 番号 >
ターゲット CPU の MB 番号
【説明】
リンクを行うプログラムのターゲット CPU を MB 番号で指定します。
【例】
flnk896s *.obj -o ap.abs -cpu MB89051
flnk896s *.obj -o ap.abs -cpu MB89P133A
<注意事項>
リンク処理を実行する際には , 本オプションでターゲット CPU の指定が必要です。
このオプションの省略はできません。
134
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
CPU 情報ファイル指定 (-cif)
6.2.29
リンカで使用する CPU 情報ファイルを指定します。
■ CPU 情報ファイル指定 (-cif)
【記述形式】
-cif <CPU 情報ファイル名 >
【パラメータ】
<CPU 情報ファイル名 >
リンカで使用する CPU 情報ファイル
【説明】
リンカで使用する CPU 情報ファイルを指定しま す。
【例】
flnk896s *.obj -o ap.abs -cpu MB89051
-cif C:\Softune\lib\896\cpu_info\MB89051.csv
<注意事項>
SOFTUNE Tools は , CPU 情報ファイルを参照して , CPU に関する情報を取得します。
関連するツール間で異なる CPU 情報ファイルを参照した場合 , 作成するプログラムに問
題が発生する可能性があります。
SOFTUNE Tools に標準で添付されている CPU 情報ファイルは , 以下の場所にあります。
インストール先ディレクトリ \lib\896\896.csv
コンパイラ・アセンブラパックを異なるディレクトリにインストールし , SOFTUNE
Workbench を使用せずにコンパイラ , アセンブラおよびリンケージキットを使用する場
合 , 各ツールに対して同一の CPU 情報ファイルを参照するように -cif で指定してくださ
い。
September 1, 2014, CM25-00321-5
135
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.30
So ft
Manu al
デバッグ情報存在チェック抑止指定 (-NCI0302LIB)
ライブラリファイルのモジュールに対するデバッグ情報存在チェックを抑止します。
■ デバッグ情報存在チェック抑止指定 (-NCI0302LIB)
【記述形式】
-NCI0302LIB
【パラメータ】
なし
【説明】
デバッグ情報出力指定 (-g) と警告レベル 2(-w 2) を指定してリンカを動作させると ,
リンカはデバッグ情報が存在しないモジュールに対して , 次のインフォメーション
を出力します。
I0302L: デバッグ情報が存在しません ( モジュール名 )
本オプションを指定すると , リンカはライブラリファイルから抽出したモジュール
に対して , 上記インフォメーションメッセージの出力を行いません。
【例】
flnk896s -cpu MB89051 -g -w 2 test.obj -l lib896c.lib
*** I0302L: デバッグ情報が存在しません (C:\Softune\lib\896\lib896c.lib)
*** I0302L: デバッグ情報が存在しません (C:\Softune\lib\896\lib896c.lib)
・
・
・
→ インフォメーション I0302L が出力されます。
flnk896s -cpu MB89051 -g -w 2 test.obj -l lib896c.lib -NCI0302LIB
→ インフォメーション I0302L は出力されません。
136
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.31
Soft
Ma nual
内蔵 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 オプションで使用可能です。
【例】
flnk896s *.obj -o ap.abs -cpu MB89121 -set_rora
September 1, 2014, CM25-00321-5
137
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.32
So ft
Manu al
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora)
CPU 情報ファイルからターゲット CPU の内蔵 ROM/RAM 領域情報の設定を抑止し
ます。
■ 内蔵 ROM/RAM 領域自動設定の抑止指定 (-Xset_rora)
【記述形式】
-Xset_rora
【パラメータ】
なし
【説明】
CPU 情報ファイルからターゲット CPU の内蔵 ROM/RAM 領域情報の設定を抑止し
ます。
【例】
flnk896s *.obj -o ap.abs -cpu MB89121 -Xset_rora
138
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.33
Soft
Ma nual
ユーザ指定領域のチェック指定 (-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 内に
プログラムが収まっているかのチェックも行えます。
【例】
flnk896s -cpu MB89051 -check_rora -ro ROM = 0x8000/0xFFFF
-ra RAM = 0x80/87F ...
→ 正常範囲指定 警告はありません。
flnk896s -cpu MB89135L -check_rora -ro ROM = 0x8000/0xFFFF
-ra RAM = 0x80/0x87F ...
W1368L: -ro オプションで内蔵 ROM 領域の範囲外が指定されています (ROM)
September 1, 2014, CM25-00321-5
139
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
W1369L: -ra オプションで内蔵 RAM 領域の範囲外が指定されています (RAM)
→下線部の指定が範囲外のため警告が出力されます。
flnk896s -cpu MB89F051 -check_rora -ro ROM = 0x8000/0xFFFF
-ra RAM1 = 0x80/0x87F ...
→ 正常範囲指定 警告はありません。
<注意事項>
• ワーニング出力抑止 (-w 0) が指定されている場合でも本オプションが指定されている
場合は警告が出力されます。
• 本オプションは , 絶対形式ロードモジュール作成時のみ有効です。
リロケータブルロードモジュール作成時は , 本オプションは無視されます。
• 本オプションは CPU 情報ファイル内の内蔵 ROM 情報および内蔵 RAM 情報を用いて
います。したがって , CPU 情報ファイル内に該当情報が存在しない場合には警告は出
力されません。
-cpu オプションで正確な MB 番号指定を行ってください。
140
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.34
Soft
Ma nual
ユーザ指定領域のチェック抑止指定 (-Xcheck_rora)
指定した ROM 領域 , RAM 領域 (-ro, -ra オプション ) と内蔵 ROM 領域または内蔵
RAM 領域のチェックを抑止します。
-check_rora オプションを取り消す際に用います。
■ ユーザ指定領域のチェック抑止指定 (-Xcheck_rora)
【記述形式】
-Xcheck_rora
【パラメータ】
なし
【説明】
指定の ROM 領域 , RAM 領域 (-ro, -ra オプション ) と内蔵 ROM, 内蔵 RAM のアドレ
スのチェックを抑止します。
-check_rora オプションを取り消す際に用います。
【例】
flnk896s -cpu MB89135L -check_rora -ro ROM = 0x8000/0xFFFF
-ra RAM = 0x80/0x87F ...
W1368L: -ro オプションで内蔵 ROM 領域の範囲外が指定されています (ROM)
W1369L: -ra オプションで内蔵 RAM 領域の範囲外が指定されています (RAM)
→下線部の指定が範囲外のため警告が出力されます。
flnk896s -cpu MB89135L -check_rora -ro ROM = 0x8000/0xFFFF
-ra RAM1 = 0x80/0x87F -Xcheck_rora ...
→下線部の指定が範囲外ですが , -Xcheck_rora でチェック抑止を行っているため警
告は出力されません。
September 1, 2014, CM25-00321-5
141
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.35
So ft
Manu al
セクション配置領域チェック指定 (-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 領域または I/O 領域外への配置です ( セクション名 )
W1373L: I/O 領域外への配置です ( セクション名 )
142
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
以下にセクションタイプとチェック領域を示します。
チェック対象領域
セクションタイプ
-check_rora オプション指定あり
-check_rora オプション指定なし
ROM 領域に配置されるべきセクション
-ro 指定領域外かつ内蔵 ROM 領域
外に配置されているセクションに対
して警告出力。
CODE
CONST
-ro 指定領域外に配置されているセ
クションに対して警告出力。
DIRCONST
ROM → RAM
転送元セクション
RAM 領域に配置されるべきセクション
-ra 指定領域外かつ内蔵 RAM 領域
外に配置されているセクションに対
して警告出力。
STACK
DIR
-ra 指定領域外に配置されているセ
クションに対して警告出力。
ROM → RAM
転送先セクション
RAM 領域または I/O 領域に配置されるべきセクション
-ra 指定領域外かつ内蔵 RAM 領域 ,
内蔵 I/O 領域外に配置されているセ
クションに対して警告出力。
DATA
-ra 指定領域外に配置されているセ
クションに対して警告出力。
I/O 領域に配置されるべきセクション
内蔵 I/O 領域外に配置されているセ
クションに対して警告出力。
IO
内蔵 I/O 領域外に配置されているセ
クションに対して警告出力。
シングルチップモードでご使用の場合は , -check_rora と併せて指定することで , 内蔵メ
モリ領域外にプログラムが配置されていないことをチェックできます。
また , その他の場合でも ROM 領域指定 , RAM 領域指定 (-ro, -ra オプション ) と併せて
指定することでメモリ領域外にプログラムが配置されていないことをチェックできま
す。
【例】
下図のようなメモリマップでDATA タイプのDATA_A, DATA_B, DATA_C とCODE
タイプの CODE_D, CODE_E, CODE_F と STACK タイプの STACK_G が配置されて
いる場合のチェックは次のようになります。
flnk896s -cpu MB89051 -check_locate -ro ROM = 0x8000/0xFFFF
-ra RAM=0x0080/0x087F ...
W1371L: RAM 領域外への配置です (STACK_G)
W1372L: RAM 領域または I/O 領域外への配置です (DATA_C)
W1370L: ROM 領域外への配置です (CODE_D)
W1370L: ROM 領域外への配置です (CODE_E)
September 1, 2014, CM25-00321-5
143
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
0x0000
So ft
Manu al
I/O
DATA_A
0x0080
RAM
内蔵RAM 2K
DATA_B
CODE_D
0x0880
STACK_G
アクセス禁止
DATA_C
0x8000
CODE_E
ROM
内蔵ROM 32K
CODE_F
0xFFFF
DATA_A は内蔵 I/O 領域内に配置されているので警告は出力されません。
DATA_B は -ra で指定した領域内に配置されているので警告は出力されません。
DATA_C は -ra で指定した領域外から配置されているので警告が出力されます。
CODE_D は -ro で指定した領域外に配置されているので警告が出力されます。
CODE_E は -ro で指定した領域内に配置されているので警告は出力されません。
CODE_F は -ro で指定した領域外に配置されているので警告が出力されます。
STACK_G は -ra で指定した領域外に配置されているので警告が出力されます。
<注意事項>
• ワーニング出力抑止 (-w 0) が指定されている場合でも本オプションが指定されている
場合は警告が出力されます。
• 本オプションは , 絶対形式ロードモジュール作成時のみ有効です。
リロケータブルロードモジュール作成時は , 本オプションは無視されます。
• 本オプションの使用にあたっては , -ro, -ra オプションを用いた領域指定を行う必要が
あります。
• リンカ処理対象外である ABS 属性のセクションに対してもチェックを行います。
144
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.36
Soft
Ma nual
セクション配置領域チェック抑止指定
(-Xcheck_locate)
セクション配置領域チェックを抑止します。
-check_locate オプションを取り消す際に使用します。
■ セクション配置領域チェック抑止指定 (-Xcheck_locate)
【記述形式】
-Xcheck_locate
【パラメータ】
なし
【説明】
セクション配置領域チェックを抑止します。
-check_locate オプションを取り消す際に用います。
September 1, 2014, CM25-00321-5
145
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.37
So ft
Manu al
ユーザ指定外セクションのチェック指定
(-check_section)
ユーザにより配置指定が行われていないセクションが存在しないかチェックを行い
ます。
■ ユーザ指定外セクションのチェック指定 (-check_section)
【記述形式】
-check_section
【パラメータ】
なし
【説明】
ユーザにより配置指定が行われていないセクションが存在しないかチェックを行
います。
リンカは本オプションが指定されている場合 , セクション配置指定 (-sc) オプション
で指定されていないセクションに対して次の警告を出力します。
W1375L: -scオプションで配置指定の行われていないセクションです(セクション名)
本オプションが指定されていない場合 , リンカはチェックを行いません。
【例】
CODE, INIT, CONST, DATA, STACK のセクションを持つオブジェクトをリンクし
た場合の動作を示します。
flnk896s -cpu MB89051 -check_section
-ro ROM=0x8000/0xFFFF
-ra RAM=0x0080/0x087F
-sc CODE+CONST=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
W1375L: -sc オプションで配置指定の行われていないセクションです (INIT)
→ セクション INIT に対して配置指定が行われていません。
-check_section オプションが指定されているため , セクション INIT に対して警告が
出力されます。
flnk896s -cpu MB89051 -check_section
-ro ROM=0x8000/0xFFFF
-ra RAM=0x0080/0x087F
-gr ROMGROUP=CODE+CONST -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
146
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
Soft
Ma nual
W1375L: -sc オプションで配置指定の行われていないセクションです (CODE)
W1375L: -sc オプションで配置指定の行われていないセクションです (INIT)
W1375L: -sc オプションで配置指定の行われていないセクションです (CONST)
→ セクション CODE, CONST は -gr でグループ化されていますが , -sc オプション配
置指定を行っていないため CODE, CONST セクションに対して警告が出力されま
す。
flnk896s -cpu MB89051 -check_section
-ro ROM=0x8000/0xFFFF
-ra RAM=0x0080/0x087F
-sc *=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
→ ワイルドカードでセクション名を指定したことにより , セクション DATA,
STACK 以外の全てのセクションに対して配置指定が行われています。
すべてのセクションに対して配置指定が行われているため警告は出力されません。
<注意事項>
• ソースプログラム中で配置アドレス指定が行われているセクションはチェック対象外
です。
• -grオプションでセクショングループ指定を行っていても , -scオプションで配置指定を
行っていない場合は警告が出力されます。
• -sc オプションのセクション名にワイルドカードを用いて指定した場合 , ワイルドカー
ドに一致したセクションは全て配置指定が行われています。
したがって , ワイルドカードに一致したセクションに対して警告は出力されません。
セクション名をワイルドカードで指定する際には注意を行ってください。
September 1, 2014, CM25-00321-5
147
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.38
So ft
Manu al
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section)
ユーザにより配置指定が行われていないセクションの存在チェックを抑止します。
-check_section オプションを取り消す際に用います。
■ ユーザ指定外セクションのチェック抑止指定 (-Xcheck_section)
【記述形式】
-Xcheck_section
【パラメータ】
なし
【説明】
配置指定が行われていないセクションの存在チェックを抑止します。
-check_section オプションを取り消す際に用います。
本オプションがデフォルトです。
【例】
CODE, INIT, CONST, DATA, STACK のセクションを持つオブジェクトをリンクし
た場合の動作を示します。
flnk896s -cpu MB89051 -check_section
-ro ROM=0x8000/0xFFFF
-ra RAM=0x0080/0x087F
-sc CODE+CONST=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
→ セクション INIT に対して配置指定が行われていません。
-Xcheck_sectionでチェック指定の取り消しを行っているため警告は出力されません。
flnk896s -cpu MB89051 -check_section
-ro ROM=0x8000/0xFFFF
-ra RAM=0x0080/0x087F
-sc CODE+CONST=ROM -sc DATA=RAM1 -sc STACK=RAM2 object1 object2 …
→ セクションINITに対して配置指定が行われていませんが, -check_sectionでチェッ
ク指定を行っていないため警告は出力されません。
リンカのデフォルト動作です。
148
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.39
Soft
Ma nual
オブジェクト混在チェック指定 (-objmixchk)
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを行います。
オブジェクトが混在している場合 , エラーを出力します。
■ オブジェクト混在チェック指定 (-objmixchk)
【記述形式】
-objmixchk
【パラメータ】
なし
【説明】
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを行います。
オブジェクト混在チェックは , デフォルトで動作します。
オブジェクトが混在している場合 , エラー (E4312L: 互換性のない CPU タイプのモ
ジュールがあります ( ファイル名 )) となります。
【例】
flnk896s -cpu MB89051 -o loadmodule.abs obj_1.obj obj_2.obj obj_3.obj ...
flnk896s -cpu MB89051 -objmixchk -o loadmodule.abs obj_1.obj obj_2.obj obj_3.obj ...
obj_1.obj, obj_3.obj が F2MC-8FX オブジェクトである場合 , 以下のようなエラーを出
力します。
*** E4312L: 互換性のない CPU タイプのモジュールがあります (obj_1.obj)
*** E4312L: 互換性のない CPU タイプのモジュールがあります (obj_3.obj)
September 1, 2014, CM25-00321-5
149
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.40
So ft
Manu al
オブジェクト混在チェック抑止指定 (-Xobjmixchk)
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを抑止します。
本オプションはオブジェクトを混在させる場合に指定します。
■ オブジェクト混在チェック抑止指定 (-Xobjmixchk)
【記述形式】
-Xobjmixchk
【パラメータ】
なし
【説明】
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを抑止します。
本オプションはオブジェクトを混在させる場合に指定します。
【例】
flnk896s -cpu MB89051 -objmixchk -o loadmodule.abs obj_1.obj obj_2.obj obj_3.obj
-Xobjmixchk ...
flnk896s -Xobjmixchk -cpu MB89051 -objmixchk -o loadmodule.abs obj_1.obj obj_2.obj obj_3.obj ...
F2MC-8L オブジェクトと F2MC-8FX オブジェクトが混在している場合でも , エラー
を出力せずに処理を行います。
150
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.41
Soft
Ma nual
相対アセンブルリスト入力ディレクトリ指定 (-alin)
相対アセンブルリストファイルが格納されているディレクトリを指定します。
このオプションがない場合は , オブジェクトモジュールと同じ場所となります。
■ 相対アセンブルリスト入力ディレクトリ指定 (-alin)
【記述形式】
-alin < パス名 >
【パラメータ】
< パス名 >
相対アセンブルリストファイルが格納されているディレクトリ
【説明】
絶対アセンブルリストファイルを出力するときに , 使用するオプションです。
相対アセンブルリストファイルが格納されているディレクトリを指定します。
本オプションの指定がない場合は , オブジェクトモジュールと同じ場所になりま
す。
-alf オプションで , 相対アセンブルリストファイルをパス名付きで指定している場
合には , -alf オプション指定のパスを優先します。
【例】
flnk896s *.obj -o ap.abs -alin d:\F2MC8L -alf swctr1.lst,mstdef.lst
flnk896s *.obj -o ap.abs -alalf d:\F2MC8L\swctrl.lst,d:\F2MC8L\mstdef.lst
上記の 2 つの例は同じ意味です。
September 1, 2014, CM25-00321-5
151
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.42
So ft
Manu al
絶対アセンブルリスト出力ディレクトリ指定 (-alout)
絶対アセンブルリストファイルを出力するディレクトリを指定します。
■ 絶対アセンブルリスト出力ディレクトリ指定 (-alout)
【記述形式】
-alout < パス名 >
【パラメータ】
< パス名 >
絶対アセンブルリストファイルを出力するディレクトリ
【説明】
絶対アセンブルリストファイルを出力するディレクトリを指定します。
本オプションの指定がない場合は , カレントディレクトリとなります。
【例】
flnk896s *.obj -o ap.abs -alin d:\F2MC8L -alf swctrl.lst,mstdef.lst
-alout d:\F2MC8L\als
152
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.43
Soft
Ma nual
絶対アセンブルリスト出力指定 (-als)
絶対アセンブルリストファイルの出力を指定します。
すべのオブジェクトモジュールに対する出力指示です。
■ 絶対アセンブルリスト出力指定 (-als)
【記述形式】
-als
【パラメータ】
なし
【説明】
すべてのモジュールに対して絶対アセンブルリストを作成することを指示します。
本オプションの指定がないときは , 絶対アセンブルリストの作成を行いません。
前に指定した , -alsf, -Xals を無効にします。
【例】
flnk896s *.obj -o ap.abs -als
September 1, 2014, CM25-00321-5
153
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.44
So ft
Manu al
絶対アセンブルリスト出力モジュール指定 (-alsf)
絶対アセンブルリストファイルを出力するモジュールを指定します。
オブジェクトモジュールに対する選択出力指示を行います。
■ 絶対アセンブルリスト出力モジュール指定 (-alsf)
【記述形式】
-alsf < 相対アセンブルリストファイル名 > [, … ]
【パラメータ】
< 相対アセンブルリストファイル名 >
絶対アセンブルリスト作成の元になる相対アセンブルリストファイル名
ファイル名の指定にはワイルドカードが使えます。
【説明】
絶対アセンブルリストを作成するモジュールを選択します。
モジュールの指定は , 相対アセンブルリストファイル名で行います。拡張子を省略
した場合には , ".lst" を仮定します。
指定されなかったモジュールは , 絶対アセンブルリストの作成を行いません。
本オプションは , 複数に分けて指定することができます。
前に指定した , -als, -Xals を無効にします。
-alin オプションより相対アセンブルリストの格納パスを指定できますので , 本オプ
ション指定時にはパス指定を省略することが可能です。
【例】
flnk896s *.obj -o ap.abs -alsf swctrl.lst,mstdef.lst
flnk896s *.obj -o ap.abs -alsf swctrl.lst -alsf mstdef.lst
flnk896s *.obj -o ap.abs -alsf swctrl -alsf mstdef
上記の 3 つの例は同じ意味です。
154
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.45
Soft
Ma nual
絶対アセンブルリスト出力抑止指定 (-Xals)
すべてのモジュールに対して絶対アセンブルリストを作成しないことを指示します。
■ 絶対アセンブルリスト出力抑止指定 (-Xals)
【記述形式】
-Xals ( デフォルト )
【パラメータ】
なし
【説明】
すべてのモジュールに対して絶対アセンブルリストを作成しないことを指示しま
す。
本オプションはデフォルトです。
前に指定した , -als, -alsf を無効にするときに使用します。
【例】
flnk896s *.obj -o ap.abs -alf sectrl.lst,mstdef.lst -Xals
September 1, 2014, CM25-00321-5
155
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.46
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) を指定してください。
【例】
flnk896s *.obj -o ap.abs -als -alr -g
flnk896s *.obj -o ap.abs -alr -g
上記の 2 つの例は同じ意味です。
156
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.47
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 を無効にします。
【例】
flnk896s *.obj -o ap.abs -alsf swctrl.lst,mstdef.lst -alrf swctrl.lst,mstdef.lst
flnk896s *.obj -o ap.abs -alsf swctrl.lst -alrf mstdef.lst,mstdef.lst
flnk896s *.obj -o ap.abs -alrf swctrl -alrf mstdef
上記の 3 つの例は同じ意味です。
September 1, 2014, CM25-00321-5
157
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.48
So ft
Manu al
ROM/RAM, ARRAY リスト出力抑止指定 (-Xalr)
すべての絶対アセンブルリストに ROM/RAM, ARRAY リストを付加しないことを指
定します。
■ ROM/RAM, ARRAY リスト出力抑止指定 (-Xalr)
【記述形式】
-Xalr ( デフォルト )
【パラメータ】
なし
【説明】
すべての絶対アセンブルリストにROM/RAM, ARRAYリストを付加しないことを指
定します。
本オプションは , デフォルトですので特に指定する必要はありません。
前に指定した , -alr, -alrf を無効にします。
【例】
flnk896s *.obj -o ap.abs -als -alr -Xalr
flnk896s *.obj -o ap.abs -als -Xalr
上記の 2 つの例は同じ意味です。
158
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.49
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オプションを取り消すときに指定
します。
【例】
flnk896s *.obj -o ap.abs -alr -na
flnk896s *.obj -o ap.abs -alr
上記の 2 つの例は同じ意味です。
【記述形式】
-an
【パラメータ】
なし
【説明】
ROM/RAM, ARRAY リストのシンボルとアドレスを ADDRESS, NAME の順に出力
します。
シンボルはアドレス順に出力します。
-na オプション ( デフォルト ) を変更するときに使用します。
ROM/RAM, ARRAY リストが出力指定されたモジュールに対してのみ有効です。
September 1, 2014, CM25-00321-5
159
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
So ft
Manu al
【例】
flnk896s *.obj -o ap.abs -alr -na -an
flnk896s *.obj -o ap.abs -alr -an
上記の 2 つの例は同じ意味です。
160
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.50
Soft
Ma nual
外部シンボル相互参照情報リスト出力指定 (-xl)
外部シンボル相互参照情報リストファイルを出力指定します。
■ 外部シンボル相互参照情報リスト出力指定 (-xl)
【記述形式】
-xl
【パラメータ】
なし
【説明】
外部シンボル相互参照情報リストファイルを作成することを指示します。
本オプションの指定がないときは , 外部シンボル相互参照情報リストファイルの作
成を行いません。
【例】
flnk896s *.obj -o ap.abs -xl
September 1, 2014, CM25-00321-5
161
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.51
So ft
Manu al
外部シンボル相互参照情報リストファイル名の指定
(-xlf)
外部シンボル相互参照情報リストファイルの出力先ディレクトリやファイル名を変
更したいときに使用します。
■ 外部シンボル相互参照情報リストファイル名の指定 (-xlf)
【記述形式】
-xlf < 出力ファイル名 >
【パラメータ】
< 出力ファイル名 >
出力ファイル名を指定します。出力先のディレクトリを変更するときは前にパス名
を付けます。
【説明】
指定した名前で外部シンボル相互参照情報リストファイルを作成します。
本オプションを使用する場合 , -xl オプションは省略できます。
< 出力ファイル名 > 指定で拡張子を省略した場合は , デフォルト拡張子 ".mpx" が付
加されます。
本オプションの指定がない場合は , 絶対形式ロードモジュールファイル名の拡張子
を ".mpx" に直したものを , 出力ファイル名とします。
【例】
flnk896s *.obj -o ap.abs -xl -xlf ccp903.mpx
flnk896s *.obj -o ap.abs -xlf ccp903
上記の 2 つの例は同じ意味です。
162
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.52
Soft
Ma nual
外部シンボル相互参照情報リスト出力抑止指定 (-Xxl)
外部シンボル相互参照情報リストファイルを出力抑止指定します。
■ 外部シンボル相互参照情報リスト出力抑止指定 (-Xxl)
【記述形式】
-Xxl ( デフォルト )
【パラメータ】
なし
【説明】
外部シンボル相互参照情報リストファイルの出力抑止を指示します。
本オプションは , デフォルトですので特に指定する必要はありません。
前に指定した , -xl, -xlf を無効にします。
【例】
flnk896s *.obj -o ap.abs -xl -Xxl
flnk896s *.obj -o ap.abs -Xxl
flnk896s *.obj -o ap.abs
上記の 3 つの例は同じ意味です。
September 1, 2014, CM25-00321-5
163
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.53
So ft
Manu al
ローカルシンボル情報リスト出力指定 (-sl)
ローカルシンボル情報リストファイルを出力指定します。この場合 , コンパイル , ア
センブル , リンク時にデバッグ情報が出力されていることが必要です。
■ ローカルシンボル情報リスト出力指定 (-sl)
【記述形式】
-sl
【パラメータ】
なし
【説明】
ローカルシンボル情報リストファイルを作成することを指示します。
本オプションの指定がないときは , ローカルシンボル情報リストファイルの作成を
行いません。
ローカルシンボル情報リストファイルを出力するためには , コンパイル , アセンブ
ル , リンク時にデバッグ情報出力オプション (-g) を指定してください。
【例】
flnk896s *.obj -o ap.abs -sl -g
164
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.54
Soft
Ma nual
ローカルシンボル情報リストファイル名の指定 (-slf)
ローカルシンボル情報リストファイルの出力先ディレクトリやファイル名を変更し
たいときに使用します。
■ ローカルシンボル情報リストファイル名の指定 (-slf)
【記述形式】
-slf < 出力ファイル名 >
【パラメータ】
< 出力ファイル名 >
出力ファイル名を指定します。出力先のディレクトリを変更するときは前にパス名
を付けます。
【説明】
指定した名前でローカルシンボル情報リストファイルを作成します。
本オプションを使用する場合 , -sl オプションは省略できます。
< 出力ファイル名 > 指定で拡張子を省略した場合は , デフォルト拡張子 ".mps" が付
加されます。
本オプションの指定がない場合は , 絶対形式ロードモジュールファイル名の拡張子
を ".mps" に直したものを , 出力ファイル名とします。
【例】
flnk896s *.obj -o ap.abs -sl -slf ccp903.mps -g
flnk896s *.obj -o ap.abs -slf ccp903 -g
上記の 2 つの例は同じ意味です。
September 1, 2014, CM25-00321-5
165
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.55
So ft
Manu al
ローカルシンボル情報リスト出力抑止指定 (-Xsl)
ローカルシンボル情報リストファイルを出力抑止指定します。
■ ローカルシンボル情報リスト出力抑止指定 (-Xsl)
【記述形式】
-Xsl ( デフォルト )
【パラメータ】
なし
【説明】
ローカルシンボル情報リストファイルの出力抑止を指示します。
本オプションは , デフォルトですので特に指定する必要はありません。
前に指定した , -sl, -slf を無効にします。
【例】
flnk896s *.obj -o ap.abs -sl -Xsl
flnk896s *.obj -o ap.abs -Xsl
flnk896s *.obj -o ap.abs
上記の 3 つの例は同じ意味です。
166
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.56
Soft
Ma nual
セクション詳細マップリスト出力指定 (-ml)
セクション詳細マップリストファイルを出力指定します。
■ セクション詳細マップリスト出力指定 (-ml)
【記述形式】
-ml
【パラメータ】
なし
【説明】
セクション詳細マップリストファイルを作成することを指示します。
本オプションの指定がないときは , セクション詳細マップリストファイルの作成を
行いません。
【例】
flnk896s *.obj -o ap.abs -ml
September 1, 2014, CM25-00321-5
167
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
6.2.57
So ft
Manu al
セクション詳細マップリストファイル名の指定 (-mlf)
セクション詳細マップリストファイルの出力先ディレクトリやファイル名を変更し
たいときに使用します。
■ セクション詳細マップリストファイル名の指定 (-mlf)
【記述形式】
-mlf < 出力ファイル名 >
【パラメータ】
< 出力ファイル名 >
出力ファイル名を指定します。出力先のディレクトリを変更するときは前にパス名
を付けます。
【説明】
指定した名前でセクション詳細マップリストファイルを作成します。
本オプションを使用する場合 , -ml オプションは省略できます。
< 出力ファイル名 > 指定で拡張子を省略した場合は , デフォルト拡張子 ".mpm" が付
加されます。
本オプションの指定がない場合は , 絶対形式ロードモジュールファイル名の拡張子
を ".mpm" に直したものを , 出力ファイル名とします。
【例】
flnk896s *.obj -o ap.abs -ml -mlf ccp903.mpm
flnk896s *.obj -o ap.abs -mlf ccp903
上記の 2 つの例は同じ意味です。
168
CM25-00321-5, September 1, 2014
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Support
6.2.58
Soft
Ma nual
セクション詳細マップリスト出力抑止指定 (-Xml)
セクション詳細マップリストファイルを出力抑止指定します。
■ セクション詳細マップリスト出力抑止指定 (-Xml)
【記述形式】
-Xml
( デフォルト )
【パラメータ】
なし
【説明】
セクション詳細マップリストファイルの出力をすることを抑止指示します。
本オプションは , デフォルトですので特に指定する必要はありません。
前に指定した , -ml, -mlf を無効にします。
【例】
flnk896s *.obj -o ap.abs -ml -Xml
flnk896s *.obj -o ap.abs -Xml
flnk896s *.obj -o ap.abs
上記の 3 つの例は同じ意味です。
September 1, 2014, CM25-00321-5
169
第 6 章 リンカのオプション
6.2 リンカのオプション詳細
Su pp or t
170
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第7章
リンカの出力リスト
ファイル
リンカの出力する各リストファイルのフォーマッ
ト , 情報の見方について説明します。
7.1 リンカの出力するリストファイルの種類
7.2 リンクリストファイル
7.3 絶対アセンブルリストファイル
7.4 外部シンボル相互参照情報リストファイル
7.5 ローカルシンボル情報リストファイル
7.6 セクション配置詳細情報リストファイル
September 1, 2014, CM25-00321-5
171
第 7 章 リンカの出力リスト ファイル
7.1 リンカの出力するリストファイルの種類
Su pp or t
7.1
So ft
Manu al
リンカの出力するリストファイルの種類
リンカが出力するリストファイルは以下の 5 つです。
• リンクリストファイル
• 絶対形式アセンブルリスト
• 外部シンボル相互参照情報リスト
• ローカルシンボル情報リスト
• セクション詳細マップリスト
これらのファイルは , リンカ起動時のオプションで , 出力するかどうか選択できま
す。
■ リンクリストファイル
リンクリストファイルは , リンカ起動時のオプションや入力モジュール名 , モジュール
リンク後のセクションと外部シンボルの情報が出力されます。
■ 絶対形式アセンブルリスト
絶対形式アセンブルリストは , モジュールリンク後の情報をもとに , アセンブラが出力
した相対形式のアセンブルリストを絶対形式で表示したリストです。
アセンブラ言語レベルでのデバッグを行う場合に参照することができ , リンクリスト
ではわからない機械語の 1 ステップ単位のアドレスを知ることができます。
■ 外部シンボル相互参照情報リスト
外部シンボル相互参照情報リストは , リンク後の各モジュールの外部定義シンボルと
外部参照シンボルのモジュール間相互参照の情報が出力されます。
■ ローカルシンボル情報リスト
ローカルシンボル情報リストは , リンク後の各モジュールごとのローカルシンボルを
含んだ変数や関数などの情報を出力します。
■ セクション詳細マップリスト
セクション詳細マップリストは , リンク後の各モジュールごとのセクション配置の情
報を作成します。
172
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
7.2
Soft
Ma nual
リンクリストファイル
リンクリストファイルは , 情報内容により 4 つの部分に分かれています。
• コントロールリスト
• マップリスト
• メモリ使用情報リスト
• 外部シンボルリスト
ここでは , それぞれに出力される項目を説明します。
■ リンクリストファイルの構成
リンカのリストファイルは , 4 つの部分に分かれています。
● コントロールリスト
• 指定されたオプション
• 入力オプション
• エラーメッセージ
● マップリスト
• セクション名
• セクション属性
• リンク後のセクション配置アドレス
● メモリ使用情報リスト
• ROM/RAM 使用情報
• 領域内情報
• 総合評価値情報
● 外部シンボルリスト
• 外部シンボル名
• 定義 , 参照の種別
• シンボルの値
各リストの境界には , 改ページの制御文字が出力されます。
September 1, 2014, CM25-00321-5
173
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
So ft
Manu al
コントロールリスト
7.2.1
コントロールリストには , リンカを実行したときに指定したオプションと , 入力モ
ジュール名を表示します。また , リンク処理中に発見したエラーも表示します。
■ コントロールリスト部のリスト出力フォーマット
以下にコントロールリスト部のリスト出力フォーマットを示します。
F2MC-8L/8FX 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 **』を表示します。
174
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ コントロールリスト部のリスト表示例
以下にコントロールリスト部のリスト表示例を示します。
F2MC-8L/8FX SOFTUNE Linker
Control List
2003-08-08 11:04:51
Page:
1
Option File(s)
** no use **
Control(s)
-g
-a
-l usrlb.lib
-ro prog=0x8000/0xFFFF
-ra data= 0x0080/0x047F
-sc P+code=prog, D+data+S=data
-cpu MB89PV630
Input
1
2
3
Module(s)
pca02.obj(pca01)
pcasb.obj(pcasb)
xccdef.obj(xccdef)
Error(s)
** Nothing **
September 1, 2014, CM25-00321-5
175
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
7.2.2
So ft
Manu al
マップリスト
マップリストには , セクションの名前 , 内容種別 , 属性と結合後のセクション配置ア
ドレスを表示します。
■ マップリスト部のリスト出力フォーマット
マップリスト部のリスト出力フォーマットを以下に示します。
F2MC-8L/8FX Family SOFTUNE Linker Mapping List YYYY-MM-DD hh:mm:ss Page:2
①
マップ情報表示エリア
ページヘッダ
先頭行にリンカ名,リスト名,日時,ページ番号を表示します。
① マップ情報表示エリア
マップ情報は,開始アドレス順,ただし,開始アドレスが同じ場合はセ
クション出現順に表示されます。
S-Addr : セクションの開始アドレス(16進)
E-Addr : セクションの終了アドレス(16進)
Size : セクションのサイズ (16進)
Section : セクション内容種別
セクションの内容種別を表示します。
CODE
プログラムセクション
DATA
データセクション
CONST
初期値付データセクション
STACK
スタックセクション
DIR
directセクション
DIRCONST
初期値付directセクション
IO
IOセクション
セクション種別の後に,結合属性を表示します。
P 単純連結結合
C 共有結合
N 結合なし
type : セクションの属性
左から順に,以下の属性を表示します。
R/- Read可/不可
W/- Write可/不可
X/- 実行可/不可
I/- 初期値あり/なし
Al : セクション配置時の境界調整数(16進)
境界調整数が0x100以上の場合は,"**"と表示されます。
Sec.(Top **): セクション名
ROM→RAM転送セクションで生成されたセクションには先頭に"#"が
表示されます。
"**"は,指定されたページ幅でセクション名が何桁表示できるかか
を示します。
(注)セクションサイズが0のセクションの終了アドレスは,『........』
で表示します。
176
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ マップリスト部のリスト表示例
下にマップリスト部のリスト表示例を示します。
F2MC-8L/8FX SOFTUNE Linker
S-Addr.
00000000
00000080
00000080
00000400
00008007
00008008
000089E2
-
E-Addr.
0000007F
00000099
........
0000047F
000089E1
........
00008A44
September 1, 2014, CM25-00321-5
Mapping List
Size
00000080
0000001A
00000000
00000080
000009DB
00000000
00000063
Section
IO
DATA
DATA
STACK
CODE
DATA
CONST
2003-08-08
type
N
P
P
N
P
P
P
Al
RW-RW-RW-RW-R-XI
R--R--I
11:04:51
00
01
02
00
01
02
01
Page: 2
Sec.(Top 81)
ABS IO
REL DATA
REL INIT
ABS STACK
REL CODE
REL #INIT
REL CONST
C
177
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
So ft
Manu al
7.2.3 メモリ使用情報リスト
メモリ使用情報リストには , RAM 指定領域と ROM 指定領域の領域名 , 空きまたは
オーバ領域サイズ , 指定領域の先頭・終端アドレスなどを表示します。
■ メモリ使用情報リスト部のリスト出力フォーマット
メモリ使用情報リスト部のリスト出力フォーマットを以下に示します。
F2MC-8L/8FX Family SOFTUNE Linker ROM/RAM Used Info List YYYY-MM-DD hh:mm:ss Page: 3
S_Addr. -E_Addr. Size
Remain
Name/State
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つの情報
を表示します。
1.指定領域の合計値(Total)
2.使用した領域の合計値(Used)(注意:ギャップ領域を含む)
3.空きまたはオーバ領域の合計値(Remainder)
178
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Support
Soft
Ma nual
■ メモリ使用情報リスト部のリスト表示例
メモリ使用情報リスト部のリスト表示例を示します。
F2MC-8L/8FX Family SOFTUNE Linker ROM/RAM Used Info List 2003-08-04 12:59:23 Page: 3
S_Addr.
-E_Addr. Size
Remain
Name/State
# 00000080-00000200 00000181 --------- RAM_1
00000080-00000105 00000086 +000000FB
00000080-00000087 00000008 --------- USED
00000088-000000FF 00000078 --------- GAP
00000100-00000105 00000006 --------- USED
00000106-00000200 000000FB --------- FREE
# 00000300-0000087F 00000580 --------- RAM_2
00000300-0000097F 00000680 -00000100
** Not Locate ** 00000680 --------- DATA_3
C
←オプションで指定したメモリ領域
←配置したセクションに対するメモリ状況
RAM_1領域の情報
←(*1)
←配置できなかったセクション情報(*2)
00000300-0000087F 00000580 --------- FREE
RAM_2領域の情報
# 00000080-0000087F 00000800 --------- _RAM_1_
00000080-........ 00000000 +00000800
00000080-0000087F 00000800 --------- FREE
RAM -- Total(00000F01) Used(00000706) Remainder(+000007FB)
# 00008007-0000A000 00001FFA --------- ROM_1
00008007-0000AF8A 00002F84 -00000F8A
←全RAM領域の情報
←(*3)
ROM_1領域の情報
00008007-0000A000 00001FFA --------- USED
# 00008000-0000FFFF 00008000 --------- ROM_2
00008000-........ 00000000 +00008000
00008000-0000FFFF 00008000 --------- FREE
ROM_2領域の情報
ROM -- Total(00009FFA) Used(00002F84) Remainder(+00007076)
←全ROM領域の情報
説明
(*1) : 自動配置オプションによりメモリ領域にセクションを配置しようとして配置できなかったセクショ
ンがあるメモリ領域の情報は,そのセクションのサイズを加えた状態を示しています。(数値表現
として0xFFFFFFFFを超えた場合,その数値の下位32bit分が表示されます。)
(*2) : 自動配置オプションのモード2が指定された場合の配置できなかったセクションは,(ROM領域,
RAM領域のどちらかの)最後に指定されたメモリ領域に対して表示を行います。
(*3) : ユーザ配置指定が行われたセクションは,そのセクションの先頭アドレスが含まれるメモリ領域に
含みます。
September 1, 2014, CM25-00321-5
179
第 7 章 リンカの出力リスト ファイル
7.2 リンクリストファイル
Su pp or t
7.2.4
So ft
Manu al
シンボルリスト
シンボルリストには , 外部シンボル名 , 定義 , 参照の種別 , シンボルの値を表示しま
す。
■ シンボルリスト部のリスト出力フォーマット
F2MC-8L/8FX Family SOFTUNE Linker Symbol List YYYY-MM-DD hh:mm:ss Page: 4
Symbol Value
Type Def. Symbol Name (Top **)
C
(1) Symbol list display area
ページヘッダ
先頭行にリンカ名,リスト名,日時,ページ番号を表示します。
① シンボルリスト表示エリア
Symbol Value : シンボルアドレス or シンボル値
(16進)
Type : シンボル種別
次のいずれかが表示されます。
Addr.
シンボルはアドレスレベルです。
EQU
シンボルはEQU定義シンボルです。
bit
シンボルはビット属性です。
Def. : シンボルの定義
次のいずれかが表示されます。
OM/LM入力オブジェクトモジュールまたは相対形式ロードモジュール中で定
義されています。
LIB 結合されたライブラリ中で定義されています。
user -df オプションにより値を仮設定されたシンボルです。
Symbol Name : シンボル名
"**"は,指定されたページ幅でシンボル名が何桁表示できるかを示します。
(注)シンボルが,参照されている場合は,そのままシンボル名を表示し,参照されて
いない場合は,シンボル名の先頭に"@"を付けて表示します。
■ シンボルリスト部のリスト表示例
以下にシンボルリスト部のリスト表示例を示します。
F2MC-8L/8FX Family SOFTUNE Linker Symbol List
Symbol Value
0000800F(ABS)
00008041(ABS)
00008032(ABS)
00008064(ABS)
180
Type
Addr.
Addr.
Addr.
Addr.
Def.
OM/LM
OM/LM
OM/LM
OM/LM
2003-08-04 12:59:23
Symbol Name (Top **)
_c01
_main
_func_01
_func_02
Page: 4
C
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
7.3
Soft
Ma nual
絶対アセンブルリストファイル
リンカが出力する絶対形式アセンブルリストは , 以下により構成されています。
• ヘッダ
• インフォメーションリスト
• ROM/RAM, ARRAY リスト
• アセンブルソースリスト
• セクション情報リスト
• クロスリファレンスリスト
ここでは , それぞれに出力される項目を説明します。
■ 絶対アセンブルリストの形式
● ヘッダ
各ページの先頭に出力されます。
● インフォメーションリスト
アセンブラが出力したインフォメーションリストをそのまま出力します。
● ROM/RAM, ARRAY リスト
• ROM/RAM リスト : ROM/RAM 領域に配置されているグローバルシンボルの名前 ,
絶対アドレス情報などが出力されます。
• ARRAY リスト : 配列要素の名前 , 構造体のメンバ名 , 絶対アドレス情報などが出力
されます。
オプション -alr を指定すると , ROM/RAM, ARRAY リストを表示します。-Xalr を指定
すると ROM/RAM, ARRAY リストは表示されません。
● アセンブルソースリスト
アセンブルソースリストは , ソースプログラムをアセンブルしたときの様々な情報を
行単位に表示したものです。エラー情報 , ロケーション , オブジェクトコードなどが表
示されます。
● セクション情報リスト
ソースプログラム内で定義されたセクションの名前 , 属性などが表示されます。
● クロスリファレンスリスト
ソースプログラム内で使用しているシンボル名の定義 , 参照関係を行番号で示します。
リストの構成は , 図 7.3-1 のようになっています。
September 1, 2014, CM25-00321-5
181
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
So ft
Manu al
図 7.3-1 アセンブルリストの構成
インフォメーションリスト
(ROM/RAMリスト)
(ARRAYリスト)
-alr 指定
アセンブルソースリスト
セクション情報リスト
クロスリファレンスリスト
■ アセンブルリスト内のエラーメッセージ
アセンブル時に発生したエラーがもし , アセンブルリスト上にあれば , エラーメッセー
ジがそのまま表示されます。
182
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
7.3.1
Soft
Ma nual
ヘッダ , インフォメーションリスト
ヘッダは 4 行で構成されています。
また , リストの 1 ページ目には , ヘッダに続いてインフォメーションリスト ( アセン
ブラ起動時の指定内容 , エラー数 , ワーニング数 , ソースファイル名 , インクルード
ファイル名 , オプションファイル名など ) が表示されています。
■ ヘッダ形式
ヘッダは 4 行より構成されています。各ページの先頭に表示されます。1 ~ 2 行目はア
センブルリスト全体を通じて共通の形式をもち , 3 行目は各ソースプログラムで異なり
ます。ヘッダの形式を以下に示します。
【1 ~ 2 行目】
F2MC-8L/8FX Family SOFTUNE LinkerVxxLxx yyyy-mm-dd hh:mm:ss Page: xxxx
ツール名
絶対アセンブルリスト 作成年月日 ページ番号
【3 行目】
- 各リスト名 - ( モジュール名 )
元のアセンブルリストの内容がそのまま表示されます。
【4 行目】
空白行が出力されます。
September 1, 2014, CM25-00321-5
183
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
7.3.2
So ft
Manu al
ROM/RAM, ARRAY リスト
ROM/RAM, ARRAY リストは , C ソースプログラム内で記述されるシンボルについ
ての情報を示すものです。
ROM/RAM, ARRAY リストを出力するには , コンパイル , アセンブル時にデバッグ情
報が出力指定されていることが必要です。
■ ROM/RAM, ARRAY リスト
ROM/RAM, ARRAY リストの形式を以下に示します。
- ROM/RAM LISTING - (モジュール名)
NAME
--- 名前 --*1
ADDRESS
xxxxxxxx
*2
VALUE KIND
xxxxxxxx x
*3
*4
MEMORY
xxx
*5
ARRAYリストの形式を以下に示します。
- ARRAY LISTING - (モジュール名)
NAME
--- 名前 --*1
ADDRESS
xxxxxxxx
*2
VALUE
xxxxxxxx
*3
*1:シンボル名
プログラム内で記述されているシンボルの名前を表示します。
ARRAYリストの場合は配列,構造体の要素すべてを表示します。
*2:アドレス
絶対アドレスを16進で表示します。
シンボル名とアドレスの表示位置はオプションで変更できます。
-naを指定するとシンボル名,アドレスの順で,-anを指定するとアドレ
ス,シンボル名の順に表示します。
詳細は,「6.2.47 ROM/RAM,ARRAYリストのシンボルとアドレスの表
示位置指定(-na,-an)」を参照してください。
*3:値
シンボルに初期値が代入されている場合はその値を10進で表示しま
す。
*4:シンボルの種別
以下があります。
L :変数値
F :関数名
T :タグ名参照
*5:メモリ配置
シンボルが配置されているメモリ領域を表示します。
ROM:ROM領域
RAM:RAM領域
184
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
Soft
Ma nual
【例 1】
- ROM/RAM LISTING - ( sample1 )
NAME
ADDRESS
_func_01
_func_02
_symbol_01
_symbol_02
_struct_03_0003
0000800F
00008032
00000086
00000082
0000062E
VALUE
000016
000100
KIND
MEMORY
F
F
L
L
T
ROM
ROM
RAM
RAM
RAM
【例 2】
- ARRAY LISTING - ( src_0001 )
NAME
ADDRESS
VALUE
_array_1[0]
_array_1[1]
_array_2[0].val_1
_array_2[0].val_2
_array_2[0].val_3
_array_3[0][0]
_array_3[0][1]
00000088
0000008C
00000092
00000094
00000096
0000009E
000000A0
0
1500
100
317
65
200
30
September 1, 2014, CM25-00321-5
185
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
7.3.3
So ft
Manu al
アセンブルソースリスト
アセンブルソースリストはロケーション部分が絶対アドレス , オブジェクトコード
部分がリンク後の確定したコードで表示されます。
■ アセンブルソースリストの形式
アセンブルソースリストの形式を以下に示します。
- SOURCE LISTING - (モジュール名)
SN LOC
OBJ
LINE
SOURCE
xx xxxxxxxx xxxxxxxxxxxxxxx x xxxxx x -------------*1 *2
*3
*4 *5
*6 *7
上に示す形式の1行目の部分をソースリストヘッダと呼びます。ソース
リストヘッダは各ページごとに表示されます。
*1:セクション頭文字
セクション名の先頭2文字までを表示します。
*2:ロケーション
32ビットのロケーション値を16進で表示します。
*3:オブジェクトコード
リンク後の決定したオブジェクトコードを16進で表示します。1行に
すべて表示できないときは複数行で表示します。
*4:オブジェクトコードの種類
オブジェクトコードに含まれる値の属性を次の優先順位で表示します。
I
:外部参照値
S
:セクション値
空白 :絶対値
相対アセンブルリストに表示されている"R"は絶対アセンブルリ
ストでは絶対値に変換されるため表示されません。
*5:行番号
行番号を10進5桁で表示します。
*6:プリプロセッサおよび最適コードチェックの処理状況表示
プリプロセッサ
X :アセンブル対象外となった行
& :マクロ展開行
最適コードチェック
x
:最適化で削除された命令
C :最適化で別の命令に置き換えたことを示す
O :最適化で新たに生成した命令
V :最適化で下方の命令と入れ替えたことを示す(Aと対)
A :最適化で情報の命令と入れ替えたことを示す(Vと対)
*7:ソース行
ソースプログラムの1行を表示します。リスト1行におさまらない場
合複数行で表示します。
186
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
Soft
Ma nual
【例】
SN LOC OBJ
IN 0080 -----------<INIT>-----------IN 0080 0001
LLINE
32
33
SOURCE
.SECTION INIT, DATA,ALIGN=1
.DATA.H 1
CO 8007 -----------<CODE>-----------CO 8007 41
CO 8008 F1
CO 8009 318033
62
63
64
65
.SECTION CODE,CODE,ALIGN=1
PUSHW IX
MOVW A, SP
CALL _abs_01_0002A
行番号
ソースプログラム
オブジェクトコード:リンク後の確定した値で表示します。
ロケーションカウンタ:16ビットの絶対アドレスで表示します。
セクション頭文字:セクション名の先頭2文字までを表示します。
September 1, 2014, CM25-00321-5
187
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Su pp or t
So ft
Manu al
セクション情報リスト
7.3.4
セクション情報リストは , プログラム内で定義されるセクションについての情報を
示しているものです。
セクション情報リストは , 改ページを行い , 新しいページから表示します。
■ セクション情報リストの形式
セクション情報リストの形式を以下に示します。
F2MC-8L/8FX Family SOFTUNE Linker VxxLxx yyyy-mm-dd hh:mm:ss Page: xxxx
- SECTION LISTING - (モジュール名)
NO
xx
*1
SECTION-NAME
SIZE
ATTRIBUTES
--------セクション名-------- xxxxxxxx xxx xxx xxxx=xxxx
*2
*3
*4
*5
*1:セクション出現番号
0から始まります。オブジェクトファイル中のセクション番号に相当します。
*2:セクション名
定義されたセクション名を出現順に表示します。
*3:セクションサイズ
セクションのサイズを16進32ビット長で表示します。
*4:セクションタイプ
セクションの種別を表示します。種別には次があります。
CODE
:コードセクション
DATA
:データセクション
CONST
:初期値付きデータセクション
COMMON :共有セクション
STACK
:スタックセクション
DIR
:directセクション
DIRCONST :初期値付きdirectセクション
IO
:IOセクション
*5:セクション配置形式
相対アセンブルリストの表示をそのまま出力します。
アセンブル時に相対セクションならばALIGN値を表示します。絶対セクションな
らばLOCATE値を表示します。
【例】
F2MC-8L/8FX Family SOFTUNE LinkerV30L12
- SECTION LISTING - ( src_0001 )
NO SECTION-NAME
Page:
5
SIZE ATTRIBUTES
0 DATA . . . . . . . 04F0
1 CODE . . . . . . . 0033
2 INIT . . . . . . . 0008
188
2003-08-05 13:23:19
DATA
CODE
DATA
REL ALIGN=1
REL ALIGN=1
REL ALIGN=4
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.3 絶対アセンブルリストファイル
Support
7.3.5
Soft
Ma nual
クロスリファレンスリスト
クロスリファレンスリストは , プログラム内で記述される名前についての情報とそ
の定義と参照の関係を示すものです。
クロスリファレンスリストは , 改ページを行い , 新しいページから表示します。
■ クロスリファレンスリストの形式
クロスリファレンスリストの形式を以下に示します。
F2MC-8L/8FX Family SOFTUNE Linker VxxLxx
yyyy-mm-dd hh:mm:ss Page: xxxx
- CROSSREFERENCE LISTING - (モジュール名)
NAME
ATTRIB. VALUE DEFINITION/REFERENCE
--------名前-------- xxxx/xxxx xxxxxxxx xxx xxx xxx
*1
*2
*3
*4
*1:名前
シンボル名,セクション名を,大文字,小文字,アルファベット順に表示します。
*2:シンボル種別
シンボルの種別を以下の形式で表示します。
:絶対シンボル
ABS
:相対シンボル
REL
:絶対シンボル(外部定義指定)
ABS/EXP
:相対シンボル(外部定義指定)
REL/EXP
:外部参照シンボル
IMP
SECT/ABS :絶対セクション
SECT/REL :相対セクション
UNDEFINED :未定義シンボル
:レジスタシンボル
REGLIST
*3:値
シンボルが値を持つ場合,その値を32ビットの絶対アドレスで表示します。
*4:定義,参照行番号
シンボルを定義している行と参照している行を示します。
シンボルが定義されている行番号の後ろにシャープ記号"#"が付けられます。
【例】
F2MC-8L/8FX Family SOFTUNE LinkerV30L12
- CROSSREFERENCE LISTING - ( src_0001 )
2003-08-05 15:09:52
NAME
ATTRIB.
VALUE
DEFINITION/REFERENCES
CODE
L_22
L_23
L_func_0001
_abs_01_0002
_func_0001
.SECT/REL
REL
RELv
REL
IMP
.REL/EXP
8007
00008028
0000802C
0000802F
18
51
54
60
19
27
September 1, 2014, CM25-00321-5
00008007
#
#
#
#
#
Page:
5
44
50
37
26
189
第 7 章 リンカの出力リスト ファイル
7.4 外部シンボル相互参照情報リストファイル
Su pp or t
7.4
So ft
Manu al
外部シンボル相互参照情報リストファイル
外部シンボル相互参照情報リストファイルは , リンク後の各オブジェクトモジュー
ルの外部定義シンボルと外部参照シンボルのモジュール間の相互参照情報を表示し
ます。
■ 外部シンボル相互参照情報リストファイル
外部シンボル相互参照情報リストの出力形式を示します。
External Symbol Cross Reference List yyyy-mm-dd hh:mm:ss Page: 1
Module(s)
1. module01
2. module02
:
15. module15
External symbol Cross Reference List yyyy-mm-dd hh:mm:ss Page: 2
--- symbol --- --- type/value ----- module (No.) --_extsym1
Addr. 0x0000008E
1# 2 4 8 14
_extsym2
Addr. 0x00000090
1 5# 6 7 11 15
_extsym3
Addr. 0x00000092
1# 3 12 13
_extsym7
???? 0x00000000
258
_func_01
Addr. 0x00008007
1# 4 8
_func_02
Addr. 0x0000803F
1# 9 10 14
_func_03
Addr. 0x00008097
2# 7 15
n1m
EQU 0xFFFFFFFF
3# 5 8 12 15
n1p
EQU 0x00000001
3 7# 9 10 13
○
Module(s)
1から始まる通し番号を付けて,モジュール名を示します。
○ symbol
シンボル名を表示します(デフォルト最大20文字)。
○ type/value
typeには以下があります。
・Addr. :アドレス
・EQU :EQUシンボル
・Bit
:ビットシンボル
・???? :未定義
valueは,値を示します。ビットシンボルの場合,括弧内にビットポジ
ションを示します。
○ module (No.)
定義/参照のあったモジュールを番号で示します。#記号は定義モジュー
ルです。
190
CM25-00321-5, September 1, 2014
第 7 章 リンカの出力リスト ファイル
7.5 ローカルシンボル情報リストファイル
Support
7.5
Soft
Ma nual
ローカルシンボル情報リストファイル
ローカルシンボル情報リストファイルは , 絶対形式ロードモジュールを構成する
個々のモジュールごとのローカルシンボルを含んだ変数や関数などの情報を表示し
ます。
このリストはデバッグ情報をもとに作成されますので , コンパイル , アセンブル時に ,
-g オプションを指定してください。
■ ローカルシンボル情報リストファイル
ローカルシンボル情報リストの出力形式を示します。
Local Symbol List
Module(s)
1. module01
2. module02
:
15. module15
yyyy-mm-dd hh:mm:ss
Page: 1
Local Symbol List
yyyy-mm-dd hh:mm:ss
Page: 2
=== Module No. 1 (module01) ===
--- symbol --- -- kind -- --- val --C
func1
Func. g 0x8007
localstatic1
Var.
s 0x0080
=== Module No. 2 (src_0002) ===
--- symbol ---- kind -- --- val --C
func2
Func. g 0x8056
static_symbol_01
loc.
s 0x0100
global_symbol>
Var.
g 0x0102
○
Module(s)
1から始まる通し番号を付けて,モジュール名を示します。
○ symbol
シンボル名を表示します。
関数内で使用しているシンボルは,3カラム目から表示します。
シンボル名の先頭から最大20文字迄がリストの1行に表示されます。
○ Kind
以下のシンボル種別を表示します。
Var.
:変数(C)
Func. :関数(C)
loc.
:ローカル(C)
Addr. :アドレス(ASM)
EQU :EQUシンボル(ASM)
bit
:bitシンボル(ASM)
???? :未定義
s
:static(C)
g
:global(C)
valueは,値を示します。
○ val
シンボルの値を示します。
(注)構造体の詳細情報(メンバ名)や,typedef定義などは表示しません。
September 1, 2014, CM25-00321-5
191
第 7 章 リンカの出力リスト ファイル
7.6 セクション配置詳細情報リストファイル
Su pp or t
7.6
So ft
Manu al
セクション配置詳細情報リストファイル
セクション配置詳細リストファイルは , 絶対形式ロードモジュールを構成する個々
のモジュールごとのセクション配置の情報を作成します。
マップリストファイルに 1 つにまとまったセクション全体のマップリストが表示さ
れますが , さらに詳しいセクション配置情報を知ることができます。
■ セクション配置詳細情報リストファイル
セクション配置詳細情報リストの出力形式を示します。
Section Mapping List
yyyy-mm-dd hh:mm:ss
Page:
1
Module(s)
1. module01
2. module02
:
4. module15
Section Mapping List
yyyy-mm-dd hh:mm:ss
Page:
2
S_Addr. -E_Addr.
00000080-0000008D
0000008E-00000093
00000094-000000AD
000000AE-000000D5
00000400-0000047F
00008007-0000806A
0000806B-000080A6
000080A7-000080D5
000080D6-000081E9
000081EA-000081F7
Size
0000000E
00000006
0000001A
00000028
00000080
00000064
0000003C
0000002F
00000114
0000000E
Section
DATA
DATA
DATA
DATA
STACK
CODE
CODE
CODE
CODE
DATA
P
P
P
P
N
P
P
P
P
P
Type
RW-RW-RW-RW-RW-R-XI
R-XI
R-XI
R-XI
R---
Al M. No.
01
4
01
2
01
3
01
4
01
6
01
1
01
2
01
3
01
4
01
4
Sec.(Top 80)
INIT
DATA
DATA
DATA
STACK
CODE
CODE
CODE
CODE
#INIT
C
● Module(s)
1 から始まる通し番号を付けて , モジュール名を示します。
● S_Addr. -E_Addr.
セクションの開始と終了アドレスです。
アドレスがほかと重なっているセクションは, 開始アドレスの前に(*)が付加されます。
サイズ 0 のセクションの場合 , 終了アドレスの表示は「........」になります。
● Size
許されるアドレス空間をオーバフローしているセクションは , サイズの最大値 +1 を表
示します。
192
CM25-00321-5, September 1, 2014
第 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 へ転送される初期値
付きデータの配置されたセクションであることを示します。
September 1, 2014, CM25-00321-5
193
第 7 章 リンカの出力リスト ファイル
7.6 セクション配置詳細情報リストファイル
Su pp or t
194
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第8章
リンカの制限事項および
Q&A
リンカの制限事項や使用上の Q&A について述べま
す。
8.1 リンカの制限事項
8.2 リンカの使用上の Q&A
September 1, 2014, CM25-00321-5
195
第 8 章 リンカの制限事項および Q&A
8.1 リンカの制限事項
Su pp or t
8.1
So ft
Manu al
リンカの制限事項
リンカを使用する上で , 処理可能な入力ファイル数やセクション数など , 特に制限値
は設けていません。しかし , 入力ファイル数およびライブラリファイル数にはオブ
ジェクトフォーマット上に制限があります。
■ リンカの制限事項
リンカは , 入力ファイル数やセクション数 , シンボル数などに処理制限を設けていませ
ん。リンカの内部処理で , セクション名やシンボル名などの登録が必要になれば , 動的
にメモリ獲得を行い , リンカが実行に使用できるメモリを使いきってしまうまで処理
可能です。
処理限界に達すると , メモリ不足のメッセージを通知し , リンカの処理を終了します。
■ リンカの予約シンボル
リンカは , ROM → RAM 転送機能を用いたセクションごとに "_ROM_ セクション名 ",
"_RAM_ セクション名 " でシンボルの自動生成を行います。
したがって , 同名のシンボルがユーザプログラム内で定義されていると , "W1327L: こ
のシンボルは既に定義されています ( シンボル名 )" が発生します。ユーザは "_ROM_
セクション名 ", "_RAM_ セクション名 " でシンボル定義を行わないでください。
■ オブジェクトファイルフォーマット上の制限事項
リンカでの制限は , 上記のとおりですが , オブジェクトファイルで管理できるシンボル
数などに以下の制限があります。
入力ファイル数
65535 個
セクション数 (1 ファイルあたり )
65535 個
外部定義シンボル数 (1 ファイルあたり )
65535 個
外部参照シンボル数 (1 ファイルあたり )
65535 個
<注意事項>
ここでのファイルは , オブジェクトファイルのことです。相対形式ロードモジュールファ
イルの場合は , それらを作成するときに入力したオブジェクトファイルの総数として換算
してください。
196
CM25-00321-5, September 1, 2014
第 8 章 リンカの制限事項および Q&A
8.2 リンカの使用上の Q&A
Support
8.2
Soft
Ma nual
リンカの使用上の Q&A
リンカの使用に関する Question と Answer を示します。
■ リンカの使用上の Q&A
● ワイルドカードの使用
Q.
入力するオブジェクトモジュールファイル数が非常に多いのですが , ワイルドカードは使用
できますか ?
A.
コマンドライン上では , 入力ファイルの指定にワイルドカードを使用すると , リンカが展開
して実行します。オプションファイル中にも入力ファイル名の指定ができますが , ここでも
ワイルドカードが利用できます。下記の例を参考にして , 使用してください。
例.
flnk896s *.obj -o outfile.abs
flnk896s mactrl.obj xz???.obj
Q.
セクション配置指定時 , セクション名にワイルドカードが使用できますが , どのように使用
したらよいですか ?
A.
内容種別が同じセクションをまとめたいとき , または多数のセクション名を用いてプログラ
ムを作成したときに使用すると便利な場合があります。セクション名を命名するときに , リ
ンカでワイルドカードが使用できることを考慮して , キーワードとなる文字を決めておくこ
とが必要になるかもしれません。
例.
内容種別が data のセクションとして , DTdata1, DTdata2, DTdata3, DTdata4 ...
内容種別が code のセクションとして , CDprog1, CDprog2, CDprog3, CDprog4, ...
のような名前でセクション名定義をしているとします。この場合 , 下記のような指定方法が
選択できます。(-sc オプションの部分のみ示します )
-sc DTdata1+DTdata2+Dtdata3+DTdata4=0x0100,
CDprog1+CDprog2+Cdprog3+CDprog4=0x8000
-sc DT*=0x0100,CD*=0x8000
-sc */data=0x0100,*/code=0x8000
September 1, 2014, CM25-00321-5
197
第 8 章 リンカの制限事項および Q&A
8.2 リンカの使用上の Q&A
Su pp or t
So ft
Manu al
■ 初期値付変数の扱い
Q.
C コンパイラを使用した組み込み用のプログラム開発においては , 初期値付変数が生成され
ますが , このデータはプログラム実行時に書換えられるため , 実行時は RAM 上になくてはな
りません。
プログラム作成時の手順と注意事項を教えてください。
A.
組み込み用のプログラムでは , 初期値付変数は最初 ROM にあり , 参照するときには RAM
になくてはなりません。したがって , プログラムでの参照アドレスは RAM にし , アプリ
ケーション実行前に ROM から RAM への初期値データを転送するしくみを実現しておかな
いとプログラムの実行ができないことになります。
リンカがサポートする ROM → RAM 転送セクション機能を用いることでこのしくみが実現
されています。
C コンパイラが生成する初期値付変数は , 名前が INIT のセクションにまとめられます。
プログラム作成中は , 初期値付変数の総バイト数と RAM のサイズに注意する以外は特に気
を付けることはありません。
ROM → RAM 転送セクション機能については「5.9 ROM → RAM 転送セクション」を参照
ください。
ユーザは , 初期値データの転送プログラムをアセンブラなどで記述する必要があります。
例に「初期値データ転送のプログラム例」を示します。
例.
[ 初期値データ転送のプログラム例 ]
.import _ROM_INIT, _RAM_INIT
.section
.section
MOVW
MOVW
MOVW
JMP
INIT, data
start, code
IX, #_ROM_INIT
EP, #_RAM_INIT
A,#sizeof(INIT)
END_CHK
MOV
MOV
INCW
INCW
XCH
DECW
A, @IX + 0
@EP, A
IX
EP
A, T
A
…… ①
…… ②
LOOP:
END_CHK:
BNZ
LOOP
① _ROM_INIT は , ROM 上の INIT セクション ( 転送元 ) の先頭アドレスを示すシンボルで
す。_RAM_INIT は , RAM 上の INIT セクション ( 転送先 ) の先頭アドレスを示すシンボ
ルです。これらのシンボルは , リンカの ROM → RAM 転送セクション機能で自動的に生
成されます。.import 命令を使用して宣言しておいてください。
②セクションサイズ ( 転送サイズ ) の抽出のため , 内容のない INIT セクションを定義します。
198
CM25-00321-5, September 1, 2014
Support
第 III 部
Soft
Ma nual
ライブラリアン編
ライブラリアンの仕様 , オプション , 出力リストなどについて説明します。
第 9 章 ライブラリアンの仕様
第 10 章 ライブラリアンのオプション
第 11 章 ライブラリアンのリストフォーマット
第 12 章 ライブラリアンの制限事項および Q&A
September 1, 2014, CM25-00321-5
199
Su pp or t
200
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第9章
ライブラリアンの仕様
ライブラリアンの機能と各機能概要を説明します。
ライブラリファイルを作成するツールです。
9.1 ライブラリアンの機能
9.2 ライブラリアンの機能分類
9.3 ライブラリファイルの作成編集
9.4 ライブラリファイル内のモジュール抽出
9.5 ライブラリのデバッグ情報の削除
9.6 ライブラリファイルの内容チェックと表示
9.7 ライブラリアンでのオブジェクト混在
September 1, 2014, CM25-00321-5
201
第 9 章 ライブラリアンの仕様
9.1 ライブラリアンの機能
Su pp or t
9.1
So ft
Manu al
ライブラリアンの機能
ライブラリアンは , アセンブラが出力した複数のオブジェクトモジュールをまとめて ,
1 つのライブラリファイルを作成するツールです。
■ ライブラリアンの役割
プログラムを開発する場合は , ソースプログラムを機能単位などによりモジュール分
割し , モジュールごとにコンパイル , アセンブルを行います。
コンパイルおよびアセンブルした結果は, リンカによって1つに結合し目的とするプロ
グラムを作成します。
ライブラリアンは , アセンブラが出力した複数のオブジェクトモジュールをまとめて
ライブラリファイルを作成するツールです。
プログラムを構成する複数のモジュールを , そのプログラム専用のライブラリファイ
ルに登録することにより , 一括して管理することができます。
よく利用するモジュールをまとめて登録し , 汎用ライブラリファイルを作成しておけば ,
ほかのプログラムへの流用が容易に行えます。C のライブラリは , このようにして利用
されている良い例です。
ライブラリファイルは , ライブラリアンによってモジュール単位に追加 , 削除 , 置換な
どの編集が行えるため , 各モジュールを最新の状態で保管できます。
図 9.1-1 に , ライブラリアンの役割を示します。
図 9.1-1 ライブラリアンの役割
アセンブラ
相対形式
オブジェクト
(.obj)
ライブラリアン
ライブラリ
リンカ
(.lib)
絶対形式
ロードモジュール
(.abs)
202
CM25-00321-5, September 1, 2014
第 9 章 ライブラリアンの仕様
9.2 ライブラリアンの機能分類
Support
9.2
Soft
Ma nual
ライブラリアンの機能分類
ライブラリアンには , 次の 6 つの機能があります。
• ライブラリファイルの新規作成
• ライブラリファイルの編集
• ライブラリファイル内のモジュール抽出
• デバッグ情報の削除
• ライブラリファイルの内容チェック
• ライブラリファイルの内容表示
■ ライブラリファイルの新規作成
オブジェクトモジュールファイルを入力ファイルとして , 新規にライブラリファイル
を作成する機能です。
■ ライブラリファイルの編集
既に作成されているライブラリファイルに , 新たにオブジェクトモジュールを追加し
たり , 不要になったオブジェクトモジュールを削除したりする機能です。
また , ライブラリファイルに登録したモジュールに障害があることが判ったり , 機能の
変更を行う場合 , 修正して差し替える必要があります。この作業は削除と追加でもでき
ますが , 置換を行う機能もあります。
■ ライブラリファイル内のモジュール抽出
ライブラリファイルに登録されているオブジェクトモジュールを抽出し , オブジェク
トモジュールファイルの形式に戻す機能です。
■ デバッグ情報の削除
デバッグ情報付のオブジェクトモジュールが登録されているとき , デバッグ情報のみ
を取り除いて登録しなおします。
■ ライブラリファイルの内容チェック
ライブラリファイルを作っているオブジェクトモジュールの集まりの中で , 外部シン
ボルの定義 / 参照関係がきちんと解決されているかを調べます。
デバッグ情報付のオブジェクトモジュールが登録されているか否かを調べます。
■ ライブラリファイルの内容表示
ライブラリファイルに登録されているモジュール名や , 外部シンボルなどの情報をリ
ストファイルまたは標準出力に出力します。
September 1, 2014, CM25-00321-5
203
第 9 章 ライブラリアンの仕様
9.3 ライブラリファイルの作成編集
Su pp or t
9.3
So ft
Manu al
ライブラリファイルの作成編集
アセンブラが出力した ( 複数の ) オブジェクトモジュールを 1 つにまとめ , ライブラ
リファイルとして登録できます。
また , 既に作成済のライブラリファイルに対して , モジュールの追加 , 削除 , 置換が
できます。
■ ライブラリファイルの新規作成
アセンブラが出力した ( 複数の ) オブジェクトモジュールを 1 つにまとめライブラリ
ファイルとして登録できます ( 図 9.3-1 を参照 )。
図 9.3-1 ライブラリファイルの新規作成
登録対象オブジェクト
モジュールファイル
新規ライブラリ
ファイル
モジュールA
作成
モジュールA
モジュールB
A
モジュールB
モジュールC
モジュールC
■ ライブラリファイルの編集
すでに作成済のライブラリファイルに対して , モジュールの追加 , 削除 , 置換ができま
す。
● モジュールの追加
既存のライブラリファイルにモジュールを追加します ( 図 9.3-2 を参照 )。
図 9.3-2 モジュールの追加
既存ライブラリ
ファイル
モジュール
追加
モジュールD
+
モジュール
モジュール
編集後のライブラリ
ファイル
モジュールA
更新
モジュールB
モジュールC
モジュールD
204
CM25-00321-5, September 1, 2014
第 9 章 ライブラリアンの仕様
9.3 ライブラリファイルの作成編集
Support
Soft
Ma nual
● モジュールの削除
既存のライブラリファイルから不要になったモジュールを削除します ( 図 9.3-3 を参照 )。
図 9.3-3 モジュールの削除
編集後のライブラリ
ファイル
既存ライブラリ
ファイル
モジュールA
モジュールB
削除
更新
モジュールC
モジュールA
モジュールB
モジュールD
モジュールD
● モジュールの置換
既存のライブラリファイル内のモジュールを , 新しいモジュールと置き換えます ( 図
9.3-4 を参照 )。
図 9.3-4 モジュールの置換
編集後のライブラリ
ファイル
既存ライブラリ
ファイル
置換
モジュールA
モジュールB
モジュールB
A
モジュールD
September 1, 2014, CM25-00321-5
更新
モジュールA
ファイル
モジュールB
A
モジュールD
205
第 9 章 ライブラリアンの仕様
9.4 ライブラリファイル内のモジュール抽出
Su pp or t
9.4
So ft
Manu al
ライブラリファイル内のモジュール抽出
ライブラリファイルからモジュールを抽出し , オブジェクトモジュール形式ファイ
ルに戻します。
■ ライブラリファイル内のモジュール抽出
ライブラリファイルからモジュールを抽出し , オブジェクトモジュール形式ファイル
に戻します ( 図 9.4-1 を参照 )。
図 9.4-1 モジュールの抽出
オブジェクト
ファイル
既存ライブラリ
ファイル
モジュールA
モジュールB
A
モジュールD
206
抽出
B.obj
モジュールB
CM25-00321-5, September 1, 2014
第 9 章 ライブラリアンの仕様
9.5 ライブラリのデバッグ情報の削除
Support
9.5
Soft
Ma nual
ライブラリのデバッグ情報の削除
ライブラリに登録されているオブジェクトモジュールにデバッグ情報ブロック付の
ものがある場合 , デバッグ情報部を取り除いて登録しなおします。
■ デバッグ情報の削除
ライブラリに登録されているオブジェクトモジュールにデバッグ情報ブロック付のも
のがある場合 , デバッグ情報部を取り除いて登録しなおします ( 図 9.5-1 を参照 )。
図 9.5-1 デバッグ情報の削除
LHD
LHD
LMD1
LMD2
LMD3
LMD1
LMD2
LMD3
LED1
LED2
LED3
LED1
LED2
LED3
OM1
LED
OM13
OM1デバッグ情報
OM2
OM2
OM3
OM3
LTR
OM3デバッグ情報
LTR
September 1, 2014, CM25-00321-5
デバッグ情報付で登録されたOM1とOM3
からデバッグ情報部を取り除く。
207
第 9 章 ライブラリアンの仕様
9.6 ライブラリファイルの内容チェックと表示
Su pp or t
9.6
So ft
Manu al
ライブラリファイルの内容チェックと表示
次の 2 項目のチェックをします。
• ライブラリ内未解決外部参照シンボルの有無
• デバッグ情報付モジュールの有無
また , ライブラリファイルの作成 / 更新日時 , モジュールの登録日時および各モ
ジュールで定義されている外部定義シンボルの名前などの情報を知ることができま
す。
■ ライブラリファイルの内容チェック
次の 2 項目のチェックをします。
● ライブラリ内未解決外部参照シンボルの有無
リンカでは , ライブラリから取り込んだモジュールに外部参照シンボルが含まれてい
た場合 , まず始めに同じライブラリファイル中で定義シンボルを探します。
したがって , 1 つのライブラリファイル中では , あるモジュール中に外部参照シンボル
がある場合 , 該当する外部定義シンボルを含むモジュールが同じライブラリファイル
内に必ず登録されていることが推奨されます。
1 つのライブラリファイル中での , 外部参照・定義シンボルの対応関係を調べ , 定義の
ない参照シンボルが残っている場合に , 診断メッセージを出力します。
● デバッグ情報付モジュールの有無
デバッグ情報付のオブジェクトモジュールが含まれている場合に , 診断メッセージを
出力します。
-g オプション指定でのライブラリファイルへのモジュール登録処理では , オブジェク
トモジュール中にデバッグ情報が含まれていても , 取り除くことなくそのままライブ
ラリに登録します。
これは , ライブラリに登録したモジュールのデバッグを行うことを考慮したためですが ,
動作確認が済めばデバッグ情報は必要がなくなります。
■ ライブラリファイルの内容表示
ライブラリファイルのモジュール情報および外部定義シンボル情報などを , リスト
ファイルまたは標準出力へ編集出力します。
このリストにより , ライブラリファイルの作成 / 更新日時 , モジュールの登録日時 , お
よび各モジュールで定義されている外部定義シンボルの名前などの情報を知ることが
できます。
表示内容については ,「第 11 章 ライブラリアンのリストフォーマット」で説明します。
208
CM25-00321-5, September 1, 2014
第 9 章 ライブラリアンの仕様
9.7 ライブラリアンでのオブジェクト混在
Support
9.7
Soft
Ma nual
ライブラリアンでのオブジェクト混在
ライブラリアン (flib896s) では , -cpu オプションで指定したターゲット CPU と互換
性のないオブジェクトやライブラリの混在が起こった場合 , エラーを出力します。
■ ライブラリアンでのオブジェクト混在
F2MC-8FX では , DIVU 命令の動作が従来の F2MC-8L と異なります。( 表 9.7-1 参照 )
表 9.7-1 DIVU 命令の動作比較
F2MC-8L
T(16bit) ÷ AL(8bit) = AL(8bit)…TL(8bit)
F2MC-8FX
T(16bit) ÷ A(16bit) = A(16bit)…T(16bit)
このため , ライブラリアン (flib896s) では , F2MC-8L 用オブジェクトと F2MC-8FX 用オ
ブジェクトが混在する場合 , エラーを出力します。
ただし , DIVU 命令を含まない場合 , F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェ
クトの混在が可能になります。
F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェクトの混在させる場合 , オブジェク
ト混在チェック抑止指定オプション (-Xobjmixchk) を指定してください。
<注意事項>
DIVU 命令のある F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェクトの混在させる場
合 , 思わぬ不具合の原因になります。
F2MC-8L 用オブジェクトと F2MC-8FX 用オブジェクトの混在させる場合 , DIVU 命令の有
無に十分注意してください。
September 1, 2014, CM25-00321-5
209
第 9 章 ライブラリアンの仕様
9.7 ライブラリアンでのオブジェクト混在
Su pp or t
210
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 10 章
ライブラリアンのオプション
ライブラリアンの各オプションの形式 , パラメータ ,
注意事項などについて説明します。
10.1 ライブラリアンのオプション一覧
10.2 ライブラリアンのオプション詳細
September 1, 2014, CM25-00321-5
211
第 10 章 ライブラリアンのオプション
10.1 ライブラリアンのオプション一覧
Su pp or t
So ft
Manu al
10.1 ライブラリアンのオプション一覧
ライブラリアンの動作を細かく指示するために , オプションがあります。
■ オプション一覧
オプション名と機能概要を , 表 10.1-1 に示します。
オプションに必要なパラメータや機能の詳細は , 各オプションの説明を参照してくだ
さい。
表 10.1-1 ライブラリアンのオプション一覧 (1 / 2)
機能
ライブラリの
作成 , 編集に
関するオプ
ション
出力リストに
関するオプ
ション
ファイル検索 ,
保護に関する
オプション
その他のオプ
ション
212
備考
オプション
モジュールの追加 ( 登録 )
-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
オブジェクト混在チェック指定
-objmixchk
オブジェクト混在チェック抑止指定
-Xobjmixchk
デフォルト
必須
デフォルト
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.1 ライブラリアンのオプション一覧
Support
Soft
Ma nual
表 10.1-1 ライブラリアンのオプション一覧 (2 / 2)
機能
共通オプショ
ン
オプション
デフォルトオプションファイル読込み抑止指定
-Xdof
オプションファイル読込み指定
-f
ヘルプメッセージ表示指定
-help
版数 / メッセージ出力指定
-V
版数 / メッセージ出力抑止指定
-XV
終了メッセージ出力指定
-cmsg
終了メッセージ出力抑止指定
-Xcmsg
ワーニング発生時の終了コードを 1 にする指定
-cwno
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
September 1, 2014, CM25-00321-5
備考
デフォルト
デフォルト
デフォルト
213
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
10.2 ライブラリアンのオプション詳細
ライブラリアンの各オプションについて説明します。
なお , リンケージキットで共通のオプションは , 「第 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 オブ
ジェクト混在チェック抑止指定 (-Xobjmixchk)」で説明します。
214
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
10.2.1
Soft
Ma nual
モジュールの追加 ( 登録 )(-a)
ライブラリファイルを新規に作成する場合 , 既にあるライブラリファイルにモ
ジュールの追加を行う場合には -a オプションを使用します。
■ モジュールの追加 ( 登録 )(-a)
【記述形式】
-a < オブジェクトモジュールファイル名 > [, … ]
【パラメータ】
< オブジェクトモジュールファイル名 >
アセンブラが出力したオブジェクトモジュールファイル名
【説明】
ライブラリファイルへ登録するモジュールを内容とするファイル名を指定します。
ファイル名に拡張子の指定がないときは , ".obj" を拡張子とします。
登録しようとするモジュールと同じ名前のモジュールが既に登録されている場合 ,
エラーメッセージを出力しモジュールの登録処理は行いません。
同名の外部定義シンボルがある場合も同様に登録処理は行いません。
< オブジェクトモジュールファイル名 > の指定には , ワイルドカードが使用できま
す。
【例 1】
flib896s syslib.lib -a mod1.obj, mod2.obj,modx.obj
オブジェクトモジュールファイル mod1.obj, mod2.obj, modx.obj をライブラリファイ
ル syslib.lib に登録します。
• syslib.lib がないとき : 新規作成
• syslib.lib があるとき : 追加登録
【例 2】
flib896s syslib -a "mod*.obj" -a chksw
カレントディレクトリ中の拡張子 .obj のオブジェクトモジュールファイルの内先頭
3 文字が mod であるものと , chksw.obj を登録します。
September 1, 2014, CM25-00321-5
215
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
<注意事項>
登録可能なモジュール数は , 最大 65535 個です。
ワイルドカードを使用する場合は , < オブジェクトモジュールファイル名 > をカンマで区
切って指定できません。上述の例のように複数の -a オプションに分けて指定してくださ
い。
ワイルドカード指定時は拡張子の補完は行いませんので , 必ず拡張子まで指定してくださ
い。
ファイル名のワイルドカードの展開は , OS に依存しますので , 「付録 G OS による仕様
の相違点」を参考にしてください。
216
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
モジュールの置換 ( 登録 )(-r)
10.2.2
既に作成しているライブラリファイル中のモジュールを新しい同名のモジュールと
置き換えます。
■ モジュールの置換 ( 登録 )(-r)
【記述形式】
-r < オブジェクトモジュールファイル名 > [, … ]
【パラメータ】
< オブジェクトモジュールファイル名 >
アセンブラが出力したオブジェクトモジュールファイル名
【説明】
指定したファイル内のモジュールと同名のモジュールが編集中のライブラリファ
イルに存在する場合はモジュールの置換を行い , 存在しない場合には指定モジュー
ルを登録します。
ファイル名に拡張子の指定がないときは ".obj" が拡張子となります。
< オブジェクトモジュールファイル名 > の指定には , ワイルドカードが使用できま
す。
【例 1】
flib896s syslib.obj -r loadx.obj,loady.obj
loadx.obj および loady.obj 内の 2 つのモジュールを , 編集中のライブラリファイル内
の同名モジュールと置き換えます。
ライブラリファイル中に同名モジュールがない場合には , 追加登録されます。
【例 2】
flib896s syslib.lib -r "load? .obj"
カレントディレクトリ中の拡張子 .obj のオブジェクトモジュールファイルのうち先
頭 4 文字が load であり , その後ろに任意の 1 文字が付くファイル内のモジュールを
置換えの対象とします。
<注意事項>
ワイルドカードを使用する場合は , < オブジェクトモジュールファイル名 > をカンマで区
切って指定できません。複数の -r オプションに分けて指定してください。
ワイルドカード指定時は拡張子の補完は行いませんので , 必ず拡張子まで指定してくださ
い。
ファイル名のワイルドカードの展開は , OS に依存しますので , 「付録 G OS による仕様
の相違点」を参考にしてください。
September 1, 2014, CM25-00321-5
217
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
モジュールの削除 (-d)
10.2.3
ライブラリファイルから不要になったモジュールを取り除きます。
■ モジュールの削除 (-d)
【記述形式】
-d < モジュール名 > [, … ]
【パラメータ】
< モジュール名 >
削除するモジュール名
【説明】
指定したモジュールをライブラリファイルから削除します。
ここでの指定は , ファイル名ではなくモジュール名ですので注意してください。
【例】
flib896s syslib.lib -d inchar, outchar
syslib.lib から , 2 つのモジュール inchar と outchar を削除します。
<注意事項>
アセンブラの疑似命令でモジュール名の指定ができますが , 特別な理由がない限りオブ
ジェクトモジュールファイル名とモジュール名は同じにしてください。異なる名前にする
と , ライブラリの編集作業においては誤りの原因になります。
ファイル名とモジュール名を同じにするためには , 英数字とアンダーバーだけを使用した
ファイル名を用います。
モジュール名を確認したい場合は , リスト出力オプション (-m) を使用してリストファイル
の先頭部分に出力されるモジュール名を参照してください。
218
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
モジュールの抽出 (-x)
10.2.4
ライブラリファイルからモジュールを抽出し , 登録前のオブジェクトモジュール
ファイルに戻します。
■ モジュールの抽出 (-x)
【記述形式】
-x < モジュール名 > [,< オブジェクトモジュールファイル名 >]
【パラメータ】
< モジュール名 >
抽出するモジュール名
< オブジェクトモジュールファイル名 >
抽出モジュールの出力ファイル名
【説明】
指定したモジュールをライブラリファイルから抽出します。
抽出したモジュールは , 登録前と同じ形式のオブジェクトモジュールファイルにな
ります。
< オブジェクトモジュールファイル名 > の指定を省略すると , < モジュール名 > に
拡張子 ".obj" を付けた名前でファイルを作ります。
【例】
flib896s syslib -x add
flib896s syslib.lib -x add,add.obj
既存ライブラリファイルから , モジュール add を抽出し add.obj ファイルを作成しま
す。
flib896s syslib -x add,add.o
既存ライブラリファイルから, モジュールaddを抽出しadd.oファイルを作成します。
<注意事項>
-x オプションは , 抽出したいモジュールの数だけ指定できます。
同じモジュール名が指定された場合は , 後に指定した方が有効になります。以下の例では ,
add.obj は作成されず , addfunc.obj のみ作成されます。
flib896s syslib -x add -x add,addfunc.obj
September 1, 2014, CM25-00321-5
219
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.5
So ft
Manu al
リストファイルの出力指定 (-m)
ライブラリファイルに登録されているモジュール名や外部定義シンボル名などの情
報リスト出力を行います。
■ リストファイルの出力指定 (-m)
【記述形式】
-m {< リストファイル名 > | - }
【パラメータ】
< リストファイル名 >
出力するライブラリアンリストのファイル名を指定。リストを標準出力に出力する
場合にはハイフン (-) を指定。
【説明】
ライブラリファイルに登録されているモジュール名や外部定義シンボル名などの
情報リスト出力を行います。
< リストファイル名 > に拡張子指定がない場合 , ".mp2" を付加します。
本オプションにより出力される情報は登録されているモジュール名だけですが , 後
述の -dt オプションで , より詳しい情報を表示させることができます。
リスト内容は , ライブラリアンの処理終了時の状態を示します。
ほかに編集作業に関するオプションがない場合には , 指定したライブラリファイル
の内容がリストされます。
ライブラリファイルの内容をリストに残さずに画面上で確認したい場合には , パラ
メータにハイフンを指定します。
【例 1】
flib896s syslib.lib -m libx.mp2
syslib.lib に登録されているモジュール名リストを libx.mp2 に出力します。
【例 2】
flib896s syslib -a obj1,obj2 -m libx.lis
obj1.obj と obj2.obj のモジュールを追加した結果作成された syslib.lib の内容を libx.lis
に出力します。
【例 3】
flib896s syslib -m syslib.lib に登録されているモジュール名リストを標準出力に出力します。
220
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
10.2.6
Soft
Ma nual
リストファイルの出力抑止指定 (-Xm)
ライブラリアンにリストファイルを出力しないことを指示します。
■ リストファイルの出力抑止指定 (-Xm)
【記述形式】
-Xm
【パラメータ】
なし
【説明】
リストファイルの出力の抑止を行います。
-m オプションの後に -Xm オプションを指定すると , -m オプションを無効にするこ
とができます。
【例】
flib896s syslib.lib -m libx.mp2 -Xm
リストファイルの作成は行わないようにします。
September 1, 2014, CM25-00321-5
221
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.7
So ft
Manu al
リストファイルの詳細情報の出力指定 (-dt)
-m オプションでリスト出力を行いますが , 登録モジュール名の一覧を表示するだけ
です。
ライブラリに登録されている個々のモジュールごとにセクションや外部シンボルの
情報を得たいときまたはライブラリ全体の外部定義 / 外部参照シンボル情報を得たい
ときは , -dt オプションを使用します。
■ リストファイルの詳細情報の出力指定 (-dt)
【記述形式】
-dt < 情報種別 > [,< 情報種別 >] •••
【パラメータ】
< 情報種別 >
s: モジュールごとにセクション名とそのサイズを出力します。
d: モジュールごとに外部定義シンボルを出力します。
r: モジュールごとに外部参照シンボルを出力します。
a: ライブラリ全体の外部定義シンボルと , ライブラリ内で未解決の外部参照シンボ
ルを出力します。
【説明】
本オプション指定がないとき , リストファイルには登録されているモジュール名だ
けが出力されます。本オプションは , さらに詳しい情報を得たいときに使用します。
< 情報種別 > の指定は省略できません。
< 情報種別 > 指定は , 複数のキーワードをカンマで区切って指定できます。
-m オプションが指定されていない場合 , 本オプション指定は無効になります。
【例 1】
flib896s syslib.lib -m libx.mp2 -dt r,s
外部参照シンボルおよびセクション名を含むリストを libx.mp2 に出力します。
【例 2】
flib896s syslib -m libx.lis -dt s,d,r,a
ライブラリアンが出力可能なすべての情報を libx.lis に出力します。
222
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
10.2.8
Soft
Ma nual
リスト 1 ページの行数指定 (-pl)
リスト 1 ページの出力行数をデフォルト (60 行 ) から変更するときに使用します。
■ リスト 1 ページの行数指定 (-pl)
【記述形式】
-pl < 行数 > ( デフォルト :60)
【パラメータ】
< 行数 >
0, 20 ~ 255 の範囲で指定する。
【説明】
リストファイルの 1 ページに印字する行数を指定します。
0 指定は , リストファイル出力時 , ページ制御を行わないようにします。
-m オプションが指定されていない場合 , 本オプション指定は無効になります。
【例 1】
flib896s syslib.lib -m libx.mp2 -pl 40
リスト 1 ページの行数を , 40 にします。
【例 2】
flib896s syslib.lib -m - -dt s -pl 0
改ページなしで , セクション情報を付加したリストを標準出力に出力します。
September 1, 2014, CM25-00321-5
223
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
リスト 1 行の桁数指定 (-pw)
10.2.9
リスト 1 行の出力桁数をデフォルト (70 文字 ) から変更するときに使用します。
■ リスト 1 行の桁数指定 (-pw)
【記述形式】
-pw < 桁数 > ( デフォルト :70)
【パラメータ】
< 桁数 >
70 ~ 1023 の範囲で指定する。
【説明】
リストファイルの 1 行に印字する桁数を指定します。
長いシンボル名, セクション名, モジュール名がデフォルト桁数では2行以上になっ
て見にくい場合に使用してください。
デフォルト表示桁数 (70) のとき , 1 行内で表示できる文字数は以下のとおりです。
• モジュール名 : 22 文字
• セクション名 : 20 文字
• シンボル名
: 29 文字
-m オプションが指定されていない場合 , 本オプション指定は無効になります。
【例】
flib896s syslib.lib -m libx.mp2 -pw 80
リスト 1 行の桁数を , 80 に変更します。
この場合 , 1 行内で表示できる各名称の文字数は以下のようになります。
• モジュール名 : 32 文字
• セクション名 : 30 文字
• シンボル名
: 34 文字
<注意事項>
ライブラリアンのリストは , -pw オプションでの桁数指定により , 1 行内で表示するモ
ジュール名 , セクション名 , シンボル名の文字数が変わります。
シンボル名は , 1 行を左右 2 つのフィールドに分けて表示しますので , 最も長いシンボル
名の 2 倍 +12 が見やすいリストになります。
224
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
10.2.10
Soft
Ma nual
バックアップファイルの作成 (-b)
ライブラリファイルの編集処理を行うと , ライブラリファイルの内容が変更されま
す。
編集前のライブラリファイルのバックアップを残したい場合に -b オプションを指定
します。
■ バックアップファイルの作成 (-b)
【記述形式】
-b
【パラメータ】
なし
【説明】
ライブラリアンは , モジュールの追加や削除など編集作業を行うと , ファイル内容
が変更されますので元の内容は失われます。
このオプションにより , 元のファイルのバックアップファイルを作成します。
バックアップファイルの拡張子は , ".bak" になります。
バックアップは 1 世代分しか行いませんので , 大事なライブラリファイルを編集す
る場合は , ユーザ自身でバックアップをとってからライブラリアンを使用してくだ
さい。
【例】
flib896s syslib -a putc.obj -b
編集前の syslib.lib を編集後 syslib.bak として残します。
編集後の syslib.lib は , putc.obj と getc.obj が追加されます。
September 1, 2014, CM25-00321-5
225
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.11
So ft
Manu al
バックアップファイルの作成抑止 (-Xb)
バックアップ取得オプションである -b を取り消すときに -Xb オプションを使用しま
す。
■ バックアップファイルの作成抑止 (-Xb)
【記述形式】
-Xb ( デフォルト )
【パラメータ】
なし
【説明】
ライブラリアンは , デフォルト設定で編集対象のライブラリファイルのバックアッ
プは作成しません。これは , -Xb オプションを指定したのと同じです。
本オプションは , -b オプションの指定を無効にする場合に指定します。
【例】
次の 3 つの指定は , すべて同じ処理を行います。
flib896s syslib
-a putc.obj,getc.obj
flib896s syslib
-a putc.obj,getc.obj -Xb
flib896s syslib -b -a putc.obj,getc.obj -Xb
編集前の syslib.lib は , 編集後削除されます。
編集後の syslib.lib には , putc.obj と getc.obj が付加されています。
226
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
ライブラリファイルの内容検査 (-c)
10.2.12
ライブラリファイルの内容の簡単な検査を行うオプションです。
■ ライブラリファイルの内容検査 (-c)
【記述形式】
-c
【パラメータ】
なし
【説明】
次の 2 項目の検査を行います。
● ライブラリ内未解決外部参照シンボルの有無
リンカは , ライブラリから取り込んだモジュールに未解決の外部参照シンボルが含ま
れていた場合 , 同じライブラリファイル中に定義シンボルを含むモジュールがあるこ
とを前提にして , 同じライブラリファイル中でのシンボル解決を優先します。
1 つのライブラリファイル中での , 外部参照 / 定義シンボルの対応関係を調べ , 該当す
る外部定義シンボルのない外部参照シンボルが含まれる場合に , メッセージを出力し
ます。
● デバッグ情報付モジュールの有無
-g オプションを指定したライブラリファイルへのモジュール登録処理では , オブジェ
クトモジュール中のデバッグ情報を取り除くことなくそのままライブラリに登録しま
す。
これは , ライブラリに登録したモジュールのデバッグを行うことを考慮したためです。
動作確認が済めばデバッグ情報は必要がなくなります。
ライブラリ中にデバッグ情報付のモジュールが登録されているか否かを調べ , もしあ
ればメッセージを出力します。
【例】
flib896s syslib.lib -c
syslib.lib の内容をチェックします。
<注意事項>
ライブラリファイルの内容検査 (-c) オプションは , ほかのオプションと共に指定できませ
ん。
上記の指定例のように , 単独で指定してください。
September 1, 2014, CM25-00321-5
227
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
ファイル内容の最適化 (-O)
10.2.13
ライブラリに登録されているオブジェクトモジュールにデバッグ情報があれば取り
除きます。
■ ファイル内容の最適化 (-O)
【記述形式】
-O
【パラメータ】
なし
【説明】
ライブラリに登録されているオブジェクトモジュールにデバッグ情報ブロック付
のものがある場合 , デバッグ情報部を取り除いて登録しなおします。
オブジェクトモジュールファイル中では , デバッグ情報がかなり大きな部分を占め
ていますので , デバッグ情報を削除することでライブラリファイルのサイズをかな
り小さくすることができます。
【例】
flib896s syslib -O
syslib.lib ファイルから , デバッグ情報を削除します。
<注意事項>
ファイル内容の最適化 (-O) オプションは , ほかのオプションと共に指定することはできま
せん。
上記の指定例のように , 単独で指定してください。
228
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
10.2.14
Soft
Ma nual
デバッグ情報の出力指定 (-g)
ライブラリファイルにオブジェクトモジュールを登録するときに , デバッグ情報を
削除しないようにするときに指定します。
■ デバッグ情報の出力指定 (-g)
【記述形式】
-g
【パラメータ】
なし
【説明】
ライブラリアンは , 通常オブジェクトモジュールにデバッグ情報が含まれている場
合 , デバッグ情報を取り去ってライブラリファイルに登録しますが , 本オプション
によりデバッグ情報の有無に関わらず指定されたオブジェクトをそのまま登録し
ます。
ライブラリ作成後にデバッグ情報を削除したい場合には , 最適化オプション -O を使
用してライブラリファイルを作り直すことができます。
【例】
flib896s syslib.lib -a inchar,outchar -g
inchar.obj, outchar.obj に , デバッグ情報が含まれていても削除せずにライブラリファ
イルに登録します。
September 1, 2014, CM25-00321-5
229
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.15
So ft
Manu al
デバッグ情報の出力抑止指定 (-Xg)
デバッグ情報の未削除指定オプションである -g を取り消すときに -Xg オプションを
使用します。
■ デバッグ情報の出力抑止指定 (-Xg)
【記述形式】
-Xg ( デフォルト )
【パラメータ】
なし
【説明】
ライブラリアンは , 通常オブジェクトモジュールにデバッグ情報が含まれている場
合 , デバッグ情報を取り去ってライブラリファイルに登録します。これは , この -Xg
オプションを指定したのと同じです。
本オプションは , -g オプションの指定を打ち消すために指定します。
最適化オプション -Oを使用すれば, ライブラリ作成後にデバッグ情報を一括して削
除することもできます。
【例】
次の 3 つの指定は , すべて同じ処理を行います。
flib896s syslib.lib
-a inchar,outchar
flib896s syslib.lib
-a inchar,outchar -Xg
flib896s syslib.lib -g -a inchar,outchar -Xg
inchar.obj, outchar.obj に含まれているデバッグ情報は , ライブラリファイルに登録し
ません。
230
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
Soft
Ma nual
ターゲット CPU 指定 (-cpu)
10.2.16
ターゲット CPU の指定を行います。
ライブラリファイル化を行うプログラムのターゲット CPU を MB 番号で指定しま
す。
■ ターゲット CPU 指定 (-cpu)
【記述形式】
-cpu <MB 番号 >
【パラメータ】
<MB 番号 >
ターゲット CPU の MB 番号
【説明】
ライブラリファイル化を行うプログラムのターゲット CPU を MB 番号で指定しま
す。
【例】
flib896s syslib.lib -a inchar,outchar -cpu MB89123A
flib896s syslib.lib -a inchar,outchar -cpu MB89051
<注意事項>
ライブラリ化処理を実行する際には , 本オプションでターゲット CPU の指定が必要です。
このオプションの省略はできません。
September 1, 2014, CM25-00321-5
231
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
So ft
Manu al
CPU 情報ファイル指定 (-cif)
10.2.17
ライブラリアンで使用する CPU 情報ファイルを指定します。
■ CPU 情報ファイル指定 (-cif)
【記述形式】
-cif <CPU 情報ファイル名 >
【パラメータ】
<CPU 情報ファイル名 >
ライブラリアンで使用する CPU 情報ファイル
【説明】
ライブラリアンで使用する CPU 情報ファイルを指定します。
【例】
flib896s syslib.lib -a inchar,outchar -cpu MB89123A
-cif C:\Softune\lib\896\cpu_info\MB89051.csv
<注意事項>
SOFTUNE Tools は , CPU 情報ファイルを参照して , CPU に関する情報を取得します。
関連するツール間で異なる CPU 情報ファイルを参照した場合 , 作成するプログラムに問
題が発生する可能性があります。
SOFTUNE Tools に標準で添付されている CPU 情報ファイルは , 以下の場所にあります。
インストール先ディレクトリ \lib\896\896.csv
コンパイラ・アセンブラパックを異なるディレクトリにインストールし , SOFTUNE
Workbench を使用せずにコンパイラ , アセンブラおよびリンケージキットを使用する場
合 , 各ツールに対して同一の CPU 情報ファイルを参照するように -cif で指定してくださ
い。
232
CM25-00321-5, September 1, 2014
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Support
10.2.18
Soft
Ma nual
オブジェクト混在チェック指定 (-objmixchk)
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを行います。
オブジェクトが混在している場合 , エラーを出力します。
■ オブジェクト混在チェック指定 (-objmixchk)
【記述形式】
-objmixchk
【パラメータ】
なし
【説明】
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを行います。
オブジェクト混在チェックは , デフォルトで動作します。
オブジェクトが混在している場合 , エラー (E4407U: ターゲット CPU の異なるモ
ジュールがあります ( ファイル名 )) となります。
【例】
flib896s -cpu MB89051 -o library.lib -a obj_1.obj -robj_2.obj -d obj_3.obj ...
flib896s -cpu MB89051 -objmixchk -o library.lib -a obj_1.obj -robj_2.obj -d obj_3.obj ...
obj_1.obj, obj_3.obj が F2MC-8FX オブジェクトである場合 , 以下のようなエラーを出
力します。
*** E4407U: ターゲット CPU の異なるモジュールがあります (obj_1.obj)
*** E4407U: ターゲット CPU の異なるモジュールがあります (obj_3.obj)
September 1, 2014, CM25-00321-5
233
第 10 章 ライブラリアンのオプション
10.2 ライブラリアンのオプション詳細
Su pp or t
10.2.19
So ft
Manu al
オブジェクト混在チェック抑止指定 (-Xobjmixchk)
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを抑止します。
本オプションはオブジェクトを混在させる場合に指定します。
■ オブジェクト混在チェック抑止指定 (-Xobjmixchk)
【記述形式】
-Xobjmixchk
【パラメータ】
なし
【説明】
F2MC-8L オブジェクトと F2MC-8FX オブジェクトの混在チェックを抑止します。
本オプションはオブジェクトを混在させる場合に指定します。
【例】
flib896s -Xobjmixchk -cpu MB89051 -o library.lib -a obj_1.obj -robj_2.obj -d obj_3.obj ...
flib896s -cpu MB89051 -objmixchk -o library.lib -a obj_1.obj -robj_2.obj -d obj_3.obj -Xobjmixchk
...
F2MC-8L オブジェクトと F2MC-8FX オブジェクトが混在している場合でも , エラー
を出力せずに処理を行います。
234
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 11 章
ライブラリアンのリスト
フォーマット
ライブラリアンのリストファイルの構成について
説明します。
11.1 リストファイルの情報内容
11.2 モジュール名リスト
11.3 モジュールごとの詳細情報
11.4 ライブラリ内の外部定義 / 参照シンボル情報
September 1, 2014, CM25-00321-5
235
第 11 章 ライブラリアンのリストフォーマット
11.1 リストファイルの情報内容
Su pp or t
So ft
Manu al
11.1 リストファイルの情報内容
ライブラリアンのリストファイルは , ライブラリファイルの内容を以下の 5 つの分
類で出力します。
• モジュール名
• モジュールごとのセクション情報
• モジュールごとの外部定義シンボル情報
• モジュールごとの外部参照シンボル情報
• モジュール全体の外部定義 / 参照シンボル情報
リスト出力を行うためには , -m オプションおよび -dt オプションの指定が必要です。
■ リストファイルの構成
図 11.1-1 にリストファイルの構成を示します。
図 11.1-1 リストファイルの構成
<リストヘッダ>
・ライブラリファイル名
・登録モジュール数/外部定義シンボル数など
-mのみ
<モジュール数>
・登録モジュール名
<モジュールごとのセクション情報>
-mのみ
<モジュールごとの外部参照シンボル名情報>
-dt r 指定
<モジュールごとの外部定義シンボル名情報>
-dt d 指定
-dt s 指定
:
:
<モジュール全体の外部定義/参照シンボル名情報>
236
-dt a 指定
CM25-00321-5, September 1, 2014
第 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-8L/8FX Family SOFTUNE Librarian
Library Creation Date 1997-03-01 14:23:50
Library Revision Date 1997-04-17 09:41:15
[ Module Name ]
ModuleA
ModuleB
ModuleC
[ Entry Date ]
1997-03-01 14:23:50
1997-04-17 09:41:15
1997-03-01 14:23:50
[ Creation Date ]
1996-03-19 10:03:21
1996-10-07 20:18:58
1997-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 ]
モジュールが作成された日時
September 1, 2014, CM25-00321-5
237
第 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-8L/8FX Family SOFTUNE Librarian
Library
Creation Date 1997-03-01 14:23:50
Library Revision Date 1997-04-17 09:41:15
[ Module Name ]
ModuleA
[ Entry Date ]
1997-03-01 14:23:50
[ Creation Date ]
1996-03-19 10:03:21
*1
-- Section code
data
-- Type code
data
-- Size 0x000002E8
0x0000006A
*2
-- Ext_Ref Symbol(s) p_text
tx_len
-- Ext_Def Symbol(s) prtext
*3
[ Module Name ]
[ Entry Date ]
:
:
[ Creation Date ]
*1: -dtオプションのsパラメータにより出力されます。
モジュール内のセクションの情報です。
セクション名,セクション属性,サイズを表示します。
セクション名は,(ページ幅-50)文字を1行に表示します。
*2: -dtオプションのrパラメータにより出力されます。
モジュール内の外部参照シンボル名を1行に2シンボルずつ表示します。
*3: -dtオプションのdパラメータにより出力されます。
モジュール内の外部定義シンボル名を1行に2シンボルずつ表示します。
外部シンボル名は((ページ幅-12)/2)文字を1行に表示します。
238
CM25-00321-5, September 1, 2014
第 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-8L/8FX Family SOFTUNE Librarian
Library Creation Date 1997-03-01 14:23:50
Library Revision Date 1997-04-17 09:41:15
[ Module Name ]
ModuleA
[ Entry Date ]
1997-03-01
14:23:50
:
:
[ Creation Date ]
1996-03-19 10:03:21
*1 [ ALL Ext_Def Symbol(s) ]
chr1get
p_text
prtext
*2 [ ALL Ext_Ref Symbol(s) ]
chr_get
tx_len
*1: -dtオプションのaパラメータにより出力されます。
ライブラリファイル内全体の外部定義シンボル名の一覧を,1行に
2シンボルずつ表示します。
*2: ライブラリファイル内で対応する外部定義シンボルのない外部参
照シンボルの一覧を,1行に2シンボルずつ表示します。
外部シンボル名は((ページ幅-12)/2)文字を1行に表示します。
September 1, 2014, CM25-00321-5
239
第 11 章 ライブラリアンのリストフォーマット
11.4 ライブラリ内の外部定義 / 参照シンボル情報
Su pp or t
240
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 12 章
ライブラリアンの制限事項
および Q&A
ライブラリアンの制限事項や使用上の Q&A につい
て述べます。
12.1 ライブラリアンの制限事項
12.2 ライブラリアンの使用上の Q&A
September 1, 2014, CM25-00321-5
241
第 12 章 ライブラリアンの制限事項および Q&A
12.1 ライブラリアンの制限事項
Su pp or t
So ft
Manu al
12.1 ライブラリアンの制限事項
ライブラリアンを使用する上で , 1 つのライブラリファイルに登録可能なモジュール
数や外部シンボル数の制限や , 注意しなくてはならない事柄を説明します。
■ ライブラリアンの制限事項
処理能力に関しては , 以下の 2 つの制限事項があります。
• 1 つのライブラリファイルに登録可能なモジュール数 : 最大 65535
• 1 つのライブラリファイルに登録可能な外部定義シンボル数 : 最大 65535
■ 必要なディスク容量についての注意
既存のライブラリファイルの編集を行い , バックアップファイルを作成するときは , 新
しく作成するライブラリファイルと既存ライブラリが格納できるだけの十分な空き容
量があることを確認のうえ編集作業を行ってください。
■ オプションの指定に関する注意
ライブラリファイルの内容検査 (-c) およびファイル内容の最適化 (-O) の両オプション
は , それぞれ単独で指定してください。
ほかのオプションとの併用はできません。
242
CM25-00321-5, September 1, 2014
第 12 章 ライブラリアンの制限事項および Q&A
12.2 ライブラリアンの使用上の Q&A
Support
Soft
Ma nual
12.2 ライブラリアンの使用上の Q&A
ライブラリアンの使用上に関する Question と Answer を示します。
■ ライブラリファイルの作成に関する Q&A
Q.
ライブラリファイルに登録できるファイル形式は何ですか ?
A.
アセンブラが出力する , オブジェクトモジュールです。
これは , デフォルト拡張子が , (.obj) で作成されるファイルです。
例.
fasm896s file1
→ file1.obj 出力
fasm896s file2
→ file2.obj 出力
flib896s libfile -a file1.obj,file2.obj
Q.
自作したライブラリファイルからの取り込みモジュールに障害があるようなので , デバッグ
したいのですがシンボル情報が使えません。
A.
デバッグ情報付きのオブジェクトモジュールでないと , デバッグ時にシンボル情報の使用は
できません。
デバッグ情報付きで作成したオブジェクトモジュールに差し替える必要があります。
デバッグの必要がありそうなオブジェクトモジュールをライブラリ化して使用する場合には ,
あらかじめデバッグ情報付で登録 (-g オプション ) しておくと良いでしょう。
デバッグが終了した時点で , デバッグ情報を削除 (-O オプション ) することができます。
例.
fasm896s file1 -g
flib896s libfile -r file1 -g
flib896s libfile -O
Q.
汎用に作成したサブルーチンをライブラリにまとめたいと思っていますがオブジェクトモ
ジュールの数が非常に多く , 全部のファイル名を指定するのが面倒です。
A.
オブジェクトモジュールのライブラリへの追加 (-a オプション ) と置換 (-r オプション ) には ,
ワイルドカード指定ができます。
例.
flib896s libfile -a "*.obj" → 拡張子 ".obj" のファイルをすべて登録
September 1, 2014, CM25-00321-5
→ デバッグ情報付
→ デバッグ情報付
→ デバッグ情報無
file1.obj
出力
libfile.lib 出力
libfile.lib 出力
243
第 12 章 ライブラリアンの制限事項および Q&A
12.2 ライブラリアンの使用上の Q&A
Su pp or t
244
So ft
Manu al
Q.
以前に作成したライブラリファイルの内容がわからなくなってしまいました。どんなモ
ジュールが登録されているか調べる方法がありますか ?
A.
ライブラリファイルの内容は , -m オプションで見ることができます。"-m ファイル名 " を指
定すれば , デフォルト拡張子が (.mp2) のリストファイルが作成されます。
-m オプションで出力される内容では情報不足の場合 , -dt オプションを併用してより詳細な情
報を得ることができます。
例.
flib896s libfile -m libdoc
→ リストファイル libdoc.mp2 出力
flib896s libfile -m libdoc -dt a,s → 詳細情報を含んだリストファイル libdoc.mp2
出力
Q.
ライブラリファイルの内容を確認したいのですが , ファイルにとるほどではないので , 画面上
に出力することはできますか ?
A.
-m オプションのファイル名指定のかわりにハイフン (-) を指定すると標準出力への表示にな
ります。
例.
flib896s libfile -m flib896s libfile -m - -dt a,s
flib896s libfile -a file3.obj -m -
Q.
ライブラリファイルの内容をリスト出力したところ , 文字数の多いシンボ名の表示が 2 行に
渡ってしまい見にくいのですが ?
A.
-pw オプションで , 1 行に表示する桁数を増やしてください。デフォルトは 70 桁なので , 2 行
目に表示された部分が 4 文字ならその倍の 8 を加えた 78 桁以上を指定すれば 1 行に収まり
ます。
例.
flib896s libfile -m libdoc -pw 80
Q.
ライブラリファイル中のモジュールを新しいモジュールと入れ替えたところ幾つか間違えて
登録してしまったことに気づきました。置換前のライブラリファイルもバックアップをとっ
ておらず , 復旧するのに苦労しました。
A.
ライブラリアンでは , -b オプションの指定により 1 世代分のバックアップファイル ( 拡張子
".bak") を作成することができます。
ライブラリファイルの編集を行う場合は , 予め元のライブラリのバックアップをとっておく
ことが望ましいですが , 必要に応じて -b オプションを指定してください。
例.
flib896s libfile -r file1,file2 -d mod4 -b
CM25-00321-5, September 1, 2014
Support
第 IV 部
Soft
Ma nual
オブジェクト形式コンバータ編
オブジェクト形式コンバータの種類 , オプション一覧 , 機能説明 , オブジェクト形式
の変換について説明します。
第 13 章 オブジェクト形式 コンバータの仕様
第 14 章 オブジェクト形式コンバータの共通オプション
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
第 16 章 フォーマットアジャスタの仕様 (m2ms,h2hs)
第 17 章 バイナリコンバータ (m2bs, h2bs)
第 18 章 その他のコンバータ
第 19 章 オブジェクト形式コンバータの制限事項および Q&A
September 1, 2014, CM25-00321-5
245
Su pp or t
246
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 13 章
オブジェクト形式
コンバータの仕様
オブジェクト形式コンバータの概要と種類を説明
します。
オブジェクト形式コンバータはオブジェクト形式
を変換するツールです。
13.1 オブジェクト形式コンバータの概要
13.2 オブジェクト形式コンバータの種類
13.3 オブジェクト形式コンバータの実行
September 1, 2014, CM25-00321-5
247
第 13 章 オブジェクト形式 コンバータの仕様
13.1 オブジェクト形式コンバータの概要
Su pp or t
So ft
Manu al
13.1 オブジェクト形式コンバータの概要
オブジェクト形式コンバータは以下のファイル形式を処理の対象としています。
• リンカ出力の絶対形式ロードモジュール
• S フォーマット
• HEX フォーマット
• バイナリデータファイル
■ オブジェクト形式コンバータの概要
オブジェクト形式コンバータには , ロードモジュールコンバータ , アジャスタ ( 整形
ツール ) , バイナリコンバータ , コンバータの 4 種類があります。
● ロードモジュールコンバータ
ロードモジュールコンバータはリンカ出力の絶対形式ロードモジュールを汎用フォー
マットに変換する際に用います。
図 13.1-1 に , ロードモジュールコンバータの入出力を示します。
図 13.1-1 ロードモジュールコンバータの入出力
絶対形式
ロードモジュール
(.abs)
f2ms
f2hs
Sフォーマット
S1/S2/S3
HEX8/HEX16/HEX32
(.mhx)
HEXフォーマット
(.hex)
f2is
f2es
HEX8フォーマット
(HEX8形式のみ)
HEX16フォーマット
(HEX16形式のみ)
(.ihx)
(.ehx)
● アジャスタ , バイナリコンバータ
アジャスタは S フォーマットや HEX フォーマットの整形をする際に , バイナリコン
バータは S フォーマットや HEX フォーマットをバイナリに変換する際に用います。
図 13.1-2 に , アジャスタ , バイナリコンバータの入出力を示します。
248
CM25-00321-5, September 1, 2014
第 13 章 オブジェクト形式 コンバータの仕様
13.1 オブジェクト形式コンバータの概要
Support
Soft
Ma nual
図 13.1-2 アジャスタ , バイナリコンバータの入出力
Sフォーマット
HEXフォーマット
(.mhx)
(.hex)
m2ms
m2bs
h2hs
h2bs
整形済み
Sフォーマット
バイナリ
フォーマット
整形済み
HEXフォーマット
バイナリ
フォーマット
(.ahx)
(.bin)
(.ahx)
(.bin)
● コンバータ
コンバータは S フォーマットと HEX8/HEX16 フォーマットの相互変換する際に用いま
す。
図 13.1-3 に , コンバータの入出力を示します。
図 13.1-3 コンバータの入出力
Sフォーマット
HEX8フォーマット
(.mhx)
(.ihx)
HEX8/HEX16
フォーマット
(.ehx)
m2is
m2es
i2ms
e2ms
HEX8フォーマット
HEX16フォーマット
Sフォーマット
Sフォーマット
(.ihx)
September 1, 2014, CM25-00321-5
(.ehx)
(.mhx)
(.mhx)
249
第 13 章 オブジェクト形式 コンバータの仕様
13.2 オブジェクト形式コンバータの種類
Su pp or t
So ft
Manu al
13.2 オブジェクト形式コンバータの種類
オブジェクト形式コンバータの各コマンド名は , 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)」を参照してください。
250
CM25-00321-5, September 1, 2014
第 13 章 オブジェクト形式 コンバータの仕様
13.2 オブジェクト形式コンバータの種類
Support
Soft
Ma nual
■ その他のコンバータの種類
オブジェクト形式の変換は , 表 13.2-2 のコマンドで行います。
表 13.2-2 その他のコンバータのコンバート内容
コンバ―ト内容
コマンド名
m2is
S フォーマット
→ HEX8 フォーマット
m2es
S フォーマット
→ HEX16 フォーマット
i2ms
HEX8 フォーマット → S フォーマット
e2ms
HEX16 フォーマット → S フォーマット
September 1, 2014, CM25-00321-5
251
第 13 章 オブジェクト形式 コンバータの仕様
13.3 オブジェクト形式コンバータの実行
Su pp or t
So ft
Manu al
13.3 オブジェクト形式コンバータの実行
オブジェクト形式コンバータの実行は , コマンド名の後に , 入力ファイル名を指定す
るだけで実行することができます。
■ オブジェクト形式コンバータのコマンド実行
各コマンドとも , コマンド名の後に , 入力ファイル名を指定するだけで実行することが
できます。
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 ファイルを出力します。
252
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 14 章
オブジェクト形式コンバータ
の共通オプション
オブジェクト形式コンバータの各共通オプション
について詳しく説明します。
14.1 オブジェクト形式コンバータのオプション一覧
14.2 出力ファイル名の変更 (-o)
14.3 パディング (-p)
September 1, 2014, CM25-00321-5
253
第 14 章 オブジェクト形式コンバータの共通オプション
14.1 オブジェクト形式コンバータのオプション一覧
Su pp or t
So ft
Manu al
14.1 オブジェクト形式コンバータのオプション一覧
オブジェクト形式コンバータは , コマンド名の後に入力ファイル名を指定するだけ
で実行できますが , それに加えて幾つかのオプションが使用できます。
■ オブジェクト形式コンバータの共通オプションの種類
オブジェクト形式コンバータの各コマンドでは , 以下のオプションが共通で使用でき
ます。
表 14.1-1 にオブジェクト形式コンバータの共通オプション一覧を示します。
表 14.1-1 オブジェクト形式コンバータの共通オプション一覧
機能
オプション
備考
出力ファイル名の変更
-o
パディングデータ指定
-p
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
オプションファイル読込み指定
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
終了メッセージ表示指定
-cmsg
* 共通オプション
終了メッセージ表示抑止指定
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
オプションに関する簡単な説明は , コマンド名のみの入力 , もしくは -help オプション
で表示できます。
x2ys
x2ys -help
254
CM25-00321-5, September 1, 2014
第 14 章 オブジェクト形式コンバータの共通オプション
14.2 出力ファイル名の変更 (-o)
Support
Soft
Ma nual
14.2 出力ファイル名の変更 (-o)
コンバート後の出力ファイルの作成ディレクトリおよびファイル名をデフォルトか
ら変更します。
■ 出力ファイル名の変更 (-o)
【記述形式】
-o <オブジェクトファイル名>
【パラメータ】
<オブジェクトファイル名>
出力ファイルの名前
【説明】
コンバート後の出力ファイル名を変更したいときに指定します。
パス名付で指定することで , 出力先ディレクトリも変更できます。
本オプションを省略した場合は , 入力ファイル名の拡張子を変換後のフォーマット
のデフォルト拡張子に直したものを出力ファイル名とします。
<オブジェクトファイル名>指定で拡張子を省略した場合も , デフォルト拡張子を
付加します。
各フォーマットのデフォルト拡張子は , 以下の 6 つです。
• 絶対形式ロードモジュール :.abs
• S フォーマット
:.mhx .ahx
• HEX8/HEX16/HEX32
:.hex .aix
• バイナリデータファイル
:.bin
• HEX8
:.ihx
• HEX16
:.ehx
【例 1】
f2ms ccp903
(-o オプションを使用しない例 )
絶対形式ロードモジュール 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
September 1, 2014, CM25-00321-5
255
第 14 章 オブジェクト形式コンバータの共通オプション
14.2 出力ファイル名の変更 (-o)
Su pp or t
So ft
Manu al
【例 2】
f2ms ccp903 -o ccp903.hex
出力ファイル名を , ccp903.hex に変更します。
【例 3】
f2ms ccp903 -o ..\hex\ccp903m.hex
出 力 先 デ ィ レ ク ト リ を , カ レ ン ト か ら ..\hex に 変 更 し , 出 力 フ ァ イ ル 名 を ,
ccp903m.hex に変更します。
<注意事項>
バイナリコンバータで , -sp オプションを指定した場合は , <オブジェクトファイル名>
の評価が異なります。<オブジェクトファイル名>の指定には , 拡張子は含まれないもの
とし , <オブジェクトファイル名>で指定したファイル名に無条件に拡張子を付加しま
す。
例えば , オブジェクトファイル名に "binary.bin" と指定されていれば出力ファイル名は
"binary.bin.b01", "binary.bin.b02", …, "binary.bin.bxx" となります。
256
CM25-00321-5, September 1, 2014
第 14 章 オブジェクト形式コンバータの共通オプション
14.3 パディング (-p)
Support
Soft
Ma nual
14.3 パディング (-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 フォーマット
ファイルの最後尾に追加作成します。
September 1, 2014, CM25-00321-5
257
第 14 章 オブジェクト形式コンバータの共通オプション
14.3 パディング (-p)
Su pp or t
So ft
Manu al
【例 2】
f2ms ccp903 -p 0xEF,0x1FE4,0x1FFF -adjust
整形指定 (-adjust) 時に , パディングオプション (-p) で開始 / 終了アドレスが指定さ
れているのでエラーになります。
f2ms ccp903 -p 0xEF -adjust
絶対形式ロードモジュールから , S フォーマットにコンバートします。
その際 , データが存在しない箇所を , 0xEF というデータで埋めます。
【例 3】
m2bs ccp903 -ran 0x0, 0x1FFF -p 0xEF
S フォーマットから , 0x0 番地から 0x1FFF 番地までの範囲をバイナリイメージにコ
ンバートします。
その際 , S フォーマットにデータが存在しない箇所を , 0xEF というデータで埋めま
す。
258
CM25-00321-5, September 1, 2014
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
フォーマット変換 )
September 1, 2014, CM25-00321-5
259
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.1 ロードモジュールコンバータの概要
Su pp or t
So ft
Manu al
15.1 ロードモジュールコンバータの概要
ロードモジュールコンバータは , 絶対形式ロードモジュールを汎用フォーマットで
ある 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
f2hs
連携
連携
m2ms
h2hs
整形済み
Sフォーマット
整形済み
HEXフォーマット
(.mhx)
260
(.abs)
(.hex)
CM25-00321-5, September 1, 2014
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.2 ロードモジュールコンバータのオプション一覧
Support
Soft
Ma nual
15.2 ロードモジュールコンバータのオプション一覧
ここでは , ロードモジュールコンバータのオプション名と , 機能概要を一覧で示しま
す。
■ ロードモジュールコンバータのオプション一覧
表 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
* 共通オプション
September 1, 2014, CM25-00321-5
261
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
So ft
Manu al
15.3 ロードモジュールコンバータのオプション詳細
ここでは , ロードモジュールコンバータの各オプションについて説明します。
なお , リンケージキットで共通のオプションは「第 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)」の説明を参照してください。
262
CM25-00321-5, September 1, 2014
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Support
Soft
Ma nual
出力 S フォーマット指定 (-S1/-S2/-S3)
15.3.1
データを出力する際に使用するフォーマットを指定します。
■ 出力 S フォーマット指定 (-S1/-S2/-S3)
【記述形式】
-S1
-S2
-S3
【パラメータ】
なし
【説明】
データ内容を出力する際に使用するフォーマットを指定します。
f2ms は , データ内容を S1 レコード , S2 レコード , S3 レコードのどれか 1 つを用い
て出力します。
S1 レコードと S2 レコードの両方を用いて出力を行うようなことはありません。
-S1, -S2, -S3 の指定は後指定が有効になります。また , -S1, -S2, -S3 のオプションが
指定されない場合 , f2ms はデータのアドレスに合わせ , S1/S2/S3 の混在で出力しま
す。
<注意事項>
本オプションによる指定と, 出力範囲が矛盾する場合, エラーを出力し処理を行いません。
本オプションの指定により , 出力に使用するターミネータレコード (S9 レコード , S8 レ
コード , S7 レコード ) も変化します ( 表 15.3-1 参照 )。
表 15.3-1 出力 S フォーマット指定一覧
指定
出力可能範囲
ターミネータレコード
-S1
0x0000 ~ 0xFFFF
S9 レコード
-S2
0x000000 ~ 0xFFFFFF
S8 レコード
-S3
0x00000000 ~ 0xFFFFFFFF
S7 レコード
September 1, 2014, CM25-00321-5
備考
263
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
So ft
Manu al
出力 HEX フォーマット指定 (-I16/-I20/-I32)
15.3.2
データを出力する際に使用する 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 フォーマット指定一覧
指定
264
出力可能範囲
備考
-I16
0x0000 ~ 0xFFFF
HEX8 フォーマット
-I20
0x00000 ~ 0xFFFFF
HEX16 フォーマット
-I32
0x00000000 ~ 0xFFFFFFFF
HEX32 フォーマット
CM25-00321-5, September 1, 2014
第 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 のように出力されます。
表 15.3-3 HEX フォーマットスタートアドレスレコードの出力
出力 HEX フォーマット指定
入力データ範囲
出力するスタートアドレスレコード
-I16
-
警告 (W1503U:-I16 指定時に -entry オプ
ションが指定されました ) が出力され ,
スタートアドレスレコードは出力しま
せん。
-I20
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
スタートセグメントアドレスレコードを出力します。
September 1, 2014, CM25-00321-5
265
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.3 ロードモジュールコンバータのオプション詳細
Su pp or t
So ft
Manu al
f2hs ccp903.abs -entry -I32
入力ファイルのデータ範囲が 0x0 ~ 0xFFFFF のとき , スタートセグメントアドレス
レコードを出力します。
入力ファイルのデータ範囲が 0x100000 ~ 0xFFFFFFFF のとき , スタートリニアアド
レスレコードを出力します。
266
CM25-00321-5, September 1, 2014
第 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) を取り消し, スタートアドレスレコード
は出力されません。
September 1, 2014, CM25-00321-5
267
第 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
絶対形式ロードモジュールから , 整形済みフォーマットにコンバートします。
その際 , データが存在しない箇所を 0xEF というデータで埋めます。
268
CM25-00321-5, September 1, 2014
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.4 f2ms ( 絶対形式ロードモジュール→ S フォーマット変換 )
Support
Soft
Ma nual
15.4 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
September 1, 2014, CM25-00321-5
269
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.5 f2hs ( 絶対形式ロードモジュール→ HEX フォーマット変
換)
Su pp or t
So ft
Manu al
15.5 f2hs ( 絶対形式ロードモジュール→ HEX フォーマット変
換)
リンカ出力の絶対形式ロードモジュールを HEX フォーマットに形式変換します。
0 ~ 0xFFFFFFFF 番地のデータが変換対象になります。
f2hs コマンドは , SOFTUNE V3/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
270
CM25-00321-5, September 1, 2014
第 15 章 ロードモジュールコンバータ (f2ms, f2hs, f2is, f2es)
15.6 f2is ( 絶対形式ロードモジュール→ HEX8 フォーマット変
換 ), f2es ( 絶対形式ロードモジュール→ HEX16 フォーマット
Support
Soft
Ma nual
15.6 f2is ( 絶対形式ロードモジュール→ HEX8 フォーマット変
換 ), f2es ( 絶対形式ロードモジュール→ HEX16 フォー
マット変換 )
f2is はリンカ出力の絶対形式ロードモジュールを HEX8 フォーマットに , f2es はリ
ンカ出力の絶対形式ロードモジュールを HEX16 フォーマットに変換します。
f2is では 0 ~ 0xFFFF 番地のデータが変換対象に , f2es では 0 ~ 0xFFFFF 番地の
データが変換対象になります。
f2is, f2es コマンドは , SOFTUNE V3/V5 系の絶対形式ロードモジュールも処理でき
ます。
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 フォーマットファイルは , データレコードとトレーラレコードで構成されます。
September 1, 2014, CM25-00321-5
271
第 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 フォーマットのファイルの先頭には , スタートアドレスレコードが作成されます。
272
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 16 章
フォーマットアジャスタの
仕様 (m2ms,h2hs)
フォーマットアジャスタの変換形式を説明します。
16.1 フォーマットアジャスタの概要
16.2 フォーマットアジャスタのオプション一覧
16.3 フォーマットアジャスタのオプション詳細
September 1, 2014, CM25-00321-5
273
第 16 章 フォーマットアジャスタの仕様 (m2ms,h2hs)
16.1 フォーマットアジャスタの概要
Su pp or t
So ft
Manu al
16.1 フォーマットアジャスタの概要
フォーマットアジャスタは , S フォーマットや HEX フォーマットで作成したデータ
をアドレス昇順に並び替え , 1 レコードに含むデータの数を指定した値に揃える働き
をします。
■ フォーマットアジャスタの概要
フォーマットアジャスタは, フォーマットのファイル1レコードに含むデータの数を指
定の値に揃え , 形式を整えます。図 16.1-1 にフォーマットアジャスタの概念図を示し
ます。
図 16.1-1 フォーマットアジャスタの概要
Sフォーマット
ファイル
m2ms
(.mhx)
HEXフォーマット
ファイル
整形済み
Sフォーマット
ファイル
(.ahx)
h2hs
(.hex)
整形済み
HEXフォーマット
ファイル
(.aix)
入力するフォーマット中にデータが存在しない箇所は , 0xFF ( デフォルト値 ) で埋めら
れます。
出力するファイルはメモリ内容をそのまま S フォーマットや HEX フォーマットに変換
したものと同じです。
入力ファイル中にデータが存在しない個所を特定の値で埋めるには , パディングオプ
ション (-p オプション ) を用います。オプションの使用方法については , 「14.3 パディ
ング (-p)」を参照してください。
274
CM25-00321-5, September 1, 2014
第 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 を設定します。
September 1, 2014, CM25-00321-5
275
第 16 章 フォーマットアジャスタの仕様 (m2ms,h2hs)
16.1 フォーマットアジャスタの概要
Su pp or t
So ft
Manu al
図 16.1-3にアドレス範囲0xff0008~0xff004aを, レコード長16で変換した例を示します。
図 16.1-3 S フォーマットアジャスタの変換例
変換前
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
変換後
276
CM25-00321-5, September 1, 2014
第 16 章 フォーマットアジャスタの仕様 (m2ms,h2hs)
16.2 フォーマットアジャスタのオプション一覧
Support
Soft
Ma nual
16.2 フォーマットアジャスタのオプション一覧
フォーマットアジャスタのオプション名と , 機能概要を一覧で示します。
■ フォーマットアジャスタのオプション一覧
表 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
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
オプションファイル読込み指定
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
終了メッセージ表示指定
-cmsg
* 共通オプション
終了メッセージ表示抑止指定
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
September 1, 2014, CM25-00321-5
277
第 16 章 フォーマットアジャスタの仕様 (m2ms,h2hs)
16.3 フォーマットアジャスタのオプション詳細
Su pp or t
So ft
Manu al
16.3 フォーマットアジャスタのオプション詳細
フォーマットアジャスタの各オプションについて説明します。
なお , リンケージキットで共通のオプションは「第 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)」の説明を参照してください。
278
CM25-00321-5, September 1, 2014
第 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 ( パラメータをすべて省略した例 )
データ長の指定が省略されているのでエラーになります。
September 1, 2014, CM25-00321-5
279
第 16 章 フォーマットアジャスタの仕様 (m2ms,h2hs)
16.3 フォーマットアジャスタのオプション詳細
Su pp or t
16.3.2
So ft
Manu al
出力範囲指定 (-ran)
整形する範囲をアドレスで指定します。
■ 出力範囲指定 (-ran)
【記述形式】
-ran <開始アドレス> [, <終了アドレス> ]
【パラメータ】
<開始アドレス>
開始アドレス
<終了アドレス>
終了アドレス
【説明】
整形する範囲をアドレスで指定します。
コンバート実行時は , 当オプションの指定が必ず必要です。
開始アドレス , 終了アドレスは , 0x0 ~ 0xffffffff の範囲で指定します。
終了アドレスの指定は省略できます。終了アドレスを省略した場合 , 開始アドレス
から 64K バイト分を整形します。
変換サイズが 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 ( パラメータをすべて省略した例 )
開始アドレスが省略されているのでエラーになります。
280
CM25-00321-5, September 1, 2014
第 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 出力レコード指定一覧
指定
出力可能範囲
ターミネータレコード
-S1
0x0000 ~ 0xFFFF
S9 レコード
-S2
0x000000 ~ 0xFFFFFF
S8 レコード
-S3
0x00000000 ~ 0xFFFFFFFF
S7 レコード
September 1, 2014, CM25-00321-5
備考
( デフォルト )
281
第 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 レコードを用いて整形出力されます。
282
CM25-00321-5, September 1, 2014
第 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 フォーマットを用いて整形出力されます。
September 1, 2014, CM25-00321-5
283
第 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 ( パラメータを省略した例 )
開始アドレスが省略されているのでエラーになります。
284
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 17 章
バイナリコンバータ
(m2bs, h2bs)
バイナリコンバータの変換形式を説明します。
17.1 バイナリコンバータの概要
17.2 バイナリコンバータのオプション一覧
17.3 バイナリコンバータのオプション詳細
September 1, 2014, CM25-00321-5
285
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.1 バイナリコンバータの概要
Su pp or t
So ft
Manu al
17.1 バイナリコンバータの概要
バイナリコンバータは , 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) ) が付加されます。
286
CM25-00321-5, September 1, 2014
第 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 0x02 0x03 0x04 0x05 0x06 0x07
0x08 0x09
バイナリデータ
ファイル1
バイナリデータ
ファイル2
バイナリデータファイル1の内容
0x00 0x02 0x04 0x06 0x08
バイナリデータファイル2の内容
0x01 0x03 0x05 0x07 0x09
September 1, 2014, CM25-00321-5
287
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.2 バイナリコンバータのオプション一覧
Su pp or t
So ft
Manu al
17.2 バイナリコンバータのオプション一覧
バイナリコンバータのオプション名と , 機能概要を一覧で示します。
■ バイナリコンバータのオプション一覧
表 17.2-1 に , バイナリコンバータのオプション一覧を示します。
表 17.2-1 バイナリコンバータのオプション一覧
機能
288
備考
オプション
出力ファイル名の変更
-o
* コンバータ共通オプション
パディングデータ指定
-p
* コンバータ共通オプション
出力範囲指定
-ran
必須
スプリットモード指定
-sp
スプリットモード抑止指定
-Xsp
マップリストファイル作成指定
-m
マップリストファイル作成抑止指定
-Xm
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
オプションファイル読込み指定
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
終了メッセージ表示指定
-cmsg
* 共通オプション
終了メッセージ表示抑止指定
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
CM25-00321-5, September 1, 2014
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
Soft
Ma nual
17.3 バイナリコンバータのオプション詳細
バイナリコンバータの各オプションについて説明します。
なお , リンケージキットで共通のオプションは「第 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)」の説明を参照してください。
September 1, 2014, CM25-00321-5
289
第 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) のデータを抜
き出してバイナリイメージファイルにします。
290
CM25-00321-5, September 1, 2014
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
Soft
Ma nual
【例 4】
m2bs sfmtfile.mhx -ran 0xFFFF,0xD000
開始アドレスより低位なアドレスが終了アドレスとして指定されているためエ
ラーになります。
【例 5】
m2bs sfmtfile.mhx -ran ( パラメータをすべて省略した例 )
開始アドレスが省略されているのでエラーになります。
September 1, 2014, CM25-00321-5
291
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
17.3.2
So ft
Manu al
スプリットモード指定 (-sp)
バイナリイメージをスプリットモードで出力する場合に指定します。
■ スプリットモード指定 (-sp)
【記述形式】
-sp <出力ファイル数> [, <バイト数> ]
【パラメータ】
<出力ファイル数>
出力先ファイルを幾つに分割するかを指定します。2 ~ 16 の間で指定が可能です。
<バイト数>
スプリットの単位をバイト数で指定します。0x01 ~ 0xFFFFFFFF の間で指定が可能
です。
【説明】
本オプションは , 複数のファイルに交互にデータを出力するオプションです。例え
ば , 32 ビット単位のデータをデータ幅が 16 ビットの ROM 2 個を用いて構成するの
で , 2 つのファイルに 2 バイトごと交互にデータを出力したい場合などに用います。
< バイト数 > には , 出力ファイルのうち 1 つでも 0 バイト出力になるような値は指
定できません。
< バイト数 > は省略が可能です。省略された場合 , スプリット単位はデフォルトで
1 バイトに設定されます。
本オプションを使用すれば , 64K バイトの範囲を 32K バイトずつの 2 つのバイナリ
イメージファイルにすることも可能です。ただし , 本オプションは , あくまで複数
のファイルに , データを交互に出力するためのものです。64K バイトの範囲を 32K
バイトずつの 2 つに分割するようにパラメータ指定を行うと , 最後の 1K バイトは
前半のファイルに出力されます。
本オプションを指定すると出力ファイルに拡張子として ".bxx" (xx は 2 桁の番号 01 ~
16) が無条件に付加されます。
【例 1】
m2bs sfmtfile.mhx (-sp オプションを使用しない例 )
sfmtfile.bin にバイナリイメージが出力されます。
【例 2】
m2bs sfmtfile.mhx -sp 2
sfmtfile.b01 と sfmtfile.b02 に 1 バイトごと交互にバイナリイメージが出力されます。
【例 3】
m2bs sfmtfile.mhx -sp 2,2
sfmtfile.b01 と sfmtfile.b02 に 2 バイトごと交互にバイナリイメージが出力されます。
292
CM25-00321-5, September 1, 2014
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
17.3.3
Soft
Ma nual
スプリットモード抑止指定 (-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 オプションを取り消すことができます。
September 1, 2014, CM25-00321-5
293
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
17.3.4
So ft
Manu al
マップリストファイルの作成指定 (-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
294
:
:
:
:
sfmtfile.mhx
sfmtfile.bin
0x00010000 - 0x0001FFFF
0xFF
CM25-00321-5, September 1, 2014
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Support
Soft
Ma nual
【例 3】
m2bs sfmtfile.mhx -ran 0x10000,0x1FFFF -m logfile -sp 2,2
logfile.mp3 にコンバート時の情報が出力されます。
図 17.3-2 logfile.mp3 の内容例 2
Input file
Output file
:
:
:
Convert range :
Split byte
:
Padding data :
September 1, 2014, CM25-00321-5
sfmtfile.mhx
sfmtfile.b01
sfmtfile.b02
0x00010000 - 0x0001FFFF
2
0xFF
295
第 17 章 バイナリコンバータ (m2bs, h2bs)
17.3 バイナリコンバータのオプション詳細
Su pp or t
17.3.5
So ft
Manu al
マップリストファイルの作成抑止指定 (-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 オプションを取り消すことができます。
296
CM25-00321-5, September 1, 2014
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 フォーマット変換 )
September 1, 2014, CM25-00321-5
297
第 18 章 その他のコンバータ
18.1 m2is (S フォーマット→ HEX8 フォーマット変換 )
Su pp or t
So ft
Manu al
18.1 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 フォーマットのスタートアドレス情報は失われます。
298
CM25-00321-5, September 1, 2014
第 18 章 その他のコンバータ
18.2 m2es (S フォーマット→ HEX16 フォーマット変換 )
Support
Soft
Ma nual
18.2 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 以上のアドレスに割り付けられたデータは切り捨てられま
す。
コンバート元のアドレス範囲に気をつけて使用してください。
September 1, 2014, CM25-00321-5
299
第 18 章 その他のコンバータ
18.3 i2ms (HEX8 フォーマット→ S フォーマット変換 )
Su pp or t
So ft
Manu al
18.3 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 とします。
300
CM25-00321-5, September 1, 2014
第 18 章 その他のコンバータ
18.4 e2ms (HEX16 フォーマット→ S フォーマット変換 )
Support
Soft
Ma nual
18.4 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 タイプに設定されます。
September 1, 2014, CM25-00321-5
301
第 18 章 その他のコンバータ
18.4 e2ms (HEX16 フォーマット→ S フォーマット変換 )
Su pp or t
302
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
第 19 章
オブジェクト形式コンバータ
の制限事項および Q&A
オブジェクト形式コンバータの制限事項や使用上
の Q&A について述べます。
19.1 オブジェクト形式コンバータの制限事項
19.2 オブジェクト形式コンバータの使用上の Q&A
September 1, 2014, CM25-00321-5
303
第 19 章 オブジェクト形式コンバータの制限事項および Q&A
19.1 オブジェクト形式コンバータの制限事項
Su pp or t
So ft
Manu al
19.1 オブジェクト形式コンバータの制限事項
バイナリコンバータおよびアジャスタには , いくつかの制限があります。その他の
オブジェクト形式コンバータは使用する上で , 処理上の制限事項は設けておりませ
ん。オブジェクト形式コンバータが実行に使用できるメモリを使いきってしまうま
で処理可能です。
■ オブジェクト形式コンバータの制限事項
オブジェクト形式コンバータは , セクション数 , シンボル数などの処理制限を設けてお
りません。
オブジェクト形式コンバータ内部処理でセクション数やシンボル名などの登録が必要
になれば , 動的にメモリ獲得を行います。
処理限界に達すると,メモリ不足のメッセージを通知しオブジェクト形式コンバータの
処理を終了します。
表 19.1-1 オブジェクト形式コンバータの制限一覧
項目
制限値
備考
オプションファイル数
無制限
メモリ依存
オプションファイル内の行数
無制限
メモリ依存
オプションファイル内の 1 行の文字数
無制限
メモリ依存
オプションファイルのネスト
不可
入力ファイル数 (m2bs, m2ms)
64 個
入力ファイル数 ( 上記以外のコンバータ )
1個
入出力ファイルサイズ
無制限
OS 依存
入出力ファイル行数
無制限
OS 依存
ファイル名文字数
無制限
OS 依存
最大メモリアドレス
0xFFFFFFFF
最大変換サイズ (m2bs, m2ms)
2G バイト~ 1 バイト
メモリ依存
■ バイナリコンバータ , アジャスタの制限事項
入力ファイルは合計で 64 個まで指定できます。
入力ファイルが複数指定された場合 , 指定された順に処理します。
入力ファイル中で , 同じアドレスに対するデータが存在する場合は , 後から出てきた
データで上書きされます。
1 度に変換できるサイズは , 最大 2G バイト~ 1 バイトまでです。
304
CM25-00321-5, September 1, 2014
第 19 章 オブジェクト形式コンバータの制限事項および Q&A
19.2 オブジェクト形式コンバータの使用上の Q&A
Support
Soft
Ma nual
19.2 オブジェクト形式コンバータの使用上の 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
September 1, 2014, CM25-00321-5
305
第 19 章 オブジェクト形式コンバータの制限事項および Q&A
19.2 オブジェクト形式コンバータの使用上の Q&A
Su pp or t
306
So ft
Manu al
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
付録
リンケージキットのエラーメッセージ , HEX
フォーマット , および S フォーマット形式などを
記載しています。
付録 A リンケージキットのエラーメッセージ
付録 B HEX フォーマット
付録 C S レコード形式
付録 D リンカのオプション一覧表
付録 E ライブラリアンのオプション一覧表
付録 F オブジェクト形式コンバータのコマンドおよびオプ
ション一覧表
付録 G OS による仕様の相違点
付録 H SOFTUNE 言語ツール移行時のオブジェクト同一性
確認方法
付録 I
SOFTUNE リンカ (FLNK896S) と旧版リンカ
(LINK96) の仕様の差異について
付録 J SOFTUNE ライブラリアン (FLIB896S) と旧版ライブ
ラリアン (LIB96) の仕様の差異について
付録 K 主な変更内容
September 1, 2014, CM25-00321-5
307
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
付録 A
So ft
Manu al
リンケージキットのエラーメッセージ
リンケージキットの各ツールが出力するエラーメッセージの分類と表示形式につい
て詳しく説明します。
■ リンケージキットのエラーメッセージ分類
エラーメッセージは , 重要度に応じて次の 4 つのレベルに分類されています。
● インフォメーション
処理を確認する目的で , ユーザにその内容を通知するものです。エラーではありません
ので , 正しい処理結果が得られています。
● 警告
エラーよりは軽微であり , 出力結果はほとんど問題なく使用できます。場合により ,
ユーザの意図と異なる処理が行われている可能性もあります。メッセージ内容を確認
した上で , 出力結果が使用可能か否かを判断してください。
● エラー
処理は実行しますが , 正しい結果は得られないレベルの問題が発生しています。エラー
の原因を取り除いて , 再実行する必要があります。
● 致命的エラー
処理の実行が不可能なエラーです。ユーザの誤指定が原因のほか , 実行環境の問題で発
生します。
308
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
■ リンケージキットのエラーメッセージの表示形式
エラーメッセージは , 各ツールとも以下の形式で出力します。
*** ファイル名(行番号) 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
ソースファイル名と行番号および補助メッセージの表示は行われない例です。
■ リンカのエラーメッセージ
このライブラリは使用されませんでした ( ファイル名 )
I0301L
Unused library ( ファイル名 )
リンク処理で使用されなかったライブラリがあります。
-w オプションで 2 を指定したときに通知されるメッセージです。
September 1, 2014, CM25-00321-5
309
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
デバッグ情報が存在しません ( ファイル名 )
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 を指定したときに通知されるメッセージです。
310
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
下位互換 CPU タイプのオブジェクトです ( ファイル名 )
I0307L
Lower compatible cpu type object ( ファイル名 )
ここで示されたファイルは , 下位互換性のある異なる CPU タイプのモジュールです。
-w オプションで 2 を指定したときに通知されるメッセージです。
ROM 領域に書込み可能セクションが配置されました ( セクション名 )
W1301L
Writable section located in ROM area ( セクション名 )
ROM 領域として設定したアドレス範囲に書込み可能セクションを配置しました。
セクション配置指定を見直してください。
RAM エリアに初期値のあるセクションが配置されました ( セクション名 )
W1303L
Section with initial data located in RAM area( セクション名 )
RAM 領域として設定したアドレス範囲に初期値を含むセクションを配置しました。
セクション配置指定を見直してください。
ROM/RAM 領域 ( 領域名 ) の範囲外への配置がありました ( セクション名 )
W1305L
Section( セクション名 )located on out of ROM/RAM area( 領域名 )
-ro, または -ra オプションで指定したアドレス範囲を超えて配置されたセクションがあ
ります。セクションマップで確認してください。
リンカのマップリストでは十分な情報が得られない場合は , セクション詳細マップリ
ストでより詳細な情報を知ることができます。
最大アドレスを越えました ( セクション名 )
W1306L
Exceeded maximum address( セクション名 )
最大アドレスを越えて配置されたセクションがあります。
セクション名が重複しています ( セクション名 )
W1307L
Duplicate section name exist ( セクション名 )
複数のモジュールに , 名前が同じで属性や型の異なるセクションが存在します。
September 1, 2014, CM25-00321-5
311
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
セクション配置が重複しています ( セクション 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 オプションを指定しても無効になります。
エントリポイントが複数設定されています
W1325L
Entry point already set
複数の入力モジュールにエントリポイントが設定されています。
最初に設定されたエントリポイントが有効になります。
312
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
エントリポイントが変更されました
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
ワイルドカードによるファイル指定が行われましたが , 該当するファイルがありませ
んでした。
この指定を無視します。
デバッグ情報が不足しています
W1351L
Debug information not exist
デバッグ情報が不足しているために , リストの一部が作成できません。
コンパイル , アセンブルおよびリンク時にデバッグ情報付加オプション -g を指定して
ください。
September 1, 2014, CM25-00321-5
313
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
-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) が指定されている場合でも本警告は出力されます。
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) が指定されている場合でも本警告は出力されます。
314
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
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 領域内に配置されるべきセクションが RAM 領域の範囲外に配置されています。
配置が正しいかマップファイルで確認をしてください。
ワーニング出力抑止 (-w 0) が指定されている場合でも本警告は出力されます。
W1375L
-sc オプションで配置指定の行われていないセクションです ( セクショ
ン名 )
This is the section (section name) for which layout is not specified in the -sc
option.
ユーザにより配置指定が行われていないセクションです。
セクション配置指定 (-sc) オプションを用いて該当セクションの配置指定を行ってくだ
さい。
E4302L
セクションまたはセクショングループ名が見つかりません ( セクション
名 or グループ名 )
Not found section or section group name ( セクション名 or グループ名 )
-sc オプションで指定したセクション名またはグループ名が見つかりません。
ROM/RAM 領域名が定義されていません ( 領域名 )
E4303L
Undefined ROM/RAM area name ( 領域名 )
-sc オプションで指定した ROM/RAM 領域名が定義されていません。
September 1, 2014, CM25-00321-5
315
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
シンボル名が見つかりません ( シンボル名 )
E4304L
Symbol name is not found( シンボル名 )
-df オプションで指定した外部参照シンボルが見つからないときまたは -e オプションで
指定した外部定義シンボルが見つからないときに通知されます。
外部シンボルが定義されていません ( シンボル名 )
E4305L
Unresolved external symbol ( シンボル名 )
外部定義シンボルの定義がなかったため , リロケーション処理ができませんでした。
-df オプションで指定した外部定義シンボル名が見つからないときにも通知されます。
外部定義シンボルを含むモジュールの結合が必要です。
互換性のない CPU タイプのモジュールがあります ( ファイル名 )
E4312L
Uncompatible cpu type module( ファイル名 )
ここで示されるファイルは互換性のないモジュールです。
入力されるモジュールは , ターゲット CPU が同じか互換 CPU でなくてはいけません。
このセクションは存在しません ( セクション名 )
E4319L
Section not exists ( セクション名 )
グループ化オプション (-gr) で指定されたセクションが見つかりません。
ここで示されるセクションが絶対セクションであった場合にも , セクション再配置の
対象にならないため , 当メッセージが通知されます。
外部シンボルの型が異なっています ( シンボル名 )
E4326L
Different symbol type ( シンボル名 )
-e オプションによるエントリポイントの設定時に指定された外部定義シンボルが , 関
数名 , 変数名 , アドレスラベル名のいずれでもない場合に通知されます。
316
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
リロケーション情報に誤りがあります
E4327L
Illegal RL information
リロケーション情報に誤りがある場合に検出されます。
値が範囲外です ( 値 )
E4329L
Value out of range ( 値 )
リロケーション演算でオーバフローがありました。
このメッセージには , リロケーション対象となったデータ部の記述を含むソースプロ
グラム名と行番号が表示されますので , プログラムの記述を確認してください。
エディタのタグジャンプが利用できる場合 , 該当するソース行がすぐにわかります。
0 による除算が行われました
E4330L
Divide 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 アドレスの指定を行ってください。
September 1, 2014, CM25-00321-5
317
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
E4351L
So ft
Manu al
相対アセンブルリストファイルに対するオブジェクトがありません
( ファイル名 )
Relocatable assemble list not correspond to object file( ファイル名 )
補助メッセージに示す相対アセンブルリストファイルに対するオブジェクトが見つか
りません。
リンカは補助メッセージに示すリストファイルの処理を中止し , 次のリストファイル
の処理を行います。
相対アセンブルリストファイルがありません ( ファイル名 )
E4352L
Relocatable assemble list file not found ( ファイル名 )
補助メッセージに示す相対アセンブルリストファイルがありません。
リンカは補助メッセージに示すファイル名に対する絶対アセンブルリストファイルを
作成せず , 処理を続行します。
相対アセンブルリストファイルの形式が正しくありません ( ファイル名 )
E4354L
Illegal relocatable assemble list file format ( ファイル名 )
補助メッセージに示す相対アセンブルリストファイルの形式は , リンカで正しく処理
できるものではありません。
リンカは補助メッセージに示すリストファイルの処理を中止し , 次のリストファイル
の処理を行います。
オブジェクトデータが一致していません ( ファイル名 )
E4355L
Object data not correspond ( ファイル名 )
絶対形式ロードモジュールファイルのオブジェクトデータと , 補助メッセージに示す
相対形式アセンブルリストのソースデータが一致していません。
アセンブルし直してから , 再度実行してください。
配列の次元数または構造体のネストが多すぎます
E4357L
Too many array dimension or structure nested : exceeded 8
ARRAYリストに出力される配列の次元数または, 構造体のネストが8を越えています。
処理は続行しますが , これを越えた部分はリストに出力されません。
318
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
ダミーセクションの指定があります ( ファイル名 )
E4362L
DUMMY section specified ( ファイル名 )
補助メッセージに示すファイルでダミーセクションが指定されています。
絶対アセンブルリストを作成する場合にはダミーセクションの記述をしないでくださ
い。
セクションの最大サイズを越えました ( セクション名 )
E4363L
Exceeded maximum section size( セクション名 )
セクションの最大サイズを越えたセクションがあります。セクションには , そのセク
ション種別により最大サイズが制限されるものがあります。それを超えた場合に検出
されます。
セクションの見直しを行ってください。
バンクの最大アドレスを越えました ( セクション名 )
E4364L
Exceeded maximum bank address( セクション名 )
セクションを指定位置から配置したときにバンクを越えた場合 , 検出されます。
バンク内のセクション構成を見直してください。
配置可能なアドレスが領域 " 領域名 " に見つかりません ( セクション名 )
E4365L
Not found locatable address in 領域名 ( セクション名 )
配置指定領域の該当セクションの配置可能な場所が見つかりません。
領域内のセクション構成を見直してください。
配置可能なアドレスが見つかりません ( セクション名 )
E4366L
Not found locatable address( セクション名 )
全アドレス空間にセクションの配置可能な場所が見つかりません。
プログラム構成を見直してください。
September 1, 2014, CM25-00321-5
319
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
モジュール名の重複がありました ( ファイル名 モジュール名 )
E4367L
Duplicated module name( ファイル名 モジュール名 )
既にリンク対象となっているモジュール名と同じ名前のモジュール名が存在します。
モジュール名の重複はできません。モジュール名を変更してください。
バンク外のシンボルを参照しました ( シンボル名 )
E4368L
Referenced other bank symbol( シンボル名 )
バンク内分岐命令で , 他バンクに定義されているシンボルを参照しました。
該当箇所 ( シンボル ) への分岐が必要な場合には , バンク外への分岐命令を使用してく
ださい。
CPU 情報ファイルが見つかりません ( ファイル名 )
E4370L
CPU information file not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報ファイルが見つかりません。
下記ファイルが見つからない場合に検出されます。
• flnk896s:%FETOOL%\LIB\896\896.CSV
CPU 情報が見つかりません ( ファイル名 )
E4371L
CPU information not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報が CPU 情報ファイル内に見つかり
ません。
下記ファイル内に指定ターゲットの CPU 情報が見つからない場合に検出されます。
• flnk896s:%FETOOL%\LIB\896\896.CSV
メモリが足りません
F9001L
Insufficient memory
プログラム実行のためにはメモリが不足しています。バッチファイル中でリンカを起
動している場合は , 直接コマンドラインから起動してみてください。
320
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
ファイルが見つかりません ( ファイル名 )
F9011L
Input file not found ( ファイル名 )
指定された入力ファイルが見つかりません。
ライブラリファイルが見つかりません ( ファイル名 )
F9012L
Library file not found ( ファイル名 )
ここで示されるファイル名がデフォルトライブラリファイルであるときは , 環境変数
LIB896 が示すディレクトリにライブラリファイルが格納されていないか , 環境変数
FETOOL より導かれるディレクトリにライブラリファイルが格納されていません。
-l, -el オプションで指定したライブラリファイルであるときは , ファイル名指定もしく
は -L オプションで指定の検索パスが間違っていないか確かめてください。
ファイルがオープンできません ( ファイル名 )
F9015L
File open error ( ファイル名 )
ここで示されたファイルが出力ファイルである場合 , 1 つのディレクトリが管理できる
ファイルの制限数を越えている可能性があります。不要なファイルを削除するか移動
してください。
ファイルからの読込みができません ( ファイル名 )
F9016L
File read error ( ファイル名 )
読込み許可のないファイルである可能性があります。
ファイルへの書込みができません ( ファイル名 )
F9017L
File write error ( ファイル名 )
書込み許可のない同名のファイルが存在している可能性があります。
または , ここで示されているファイルを書き込んでいるディスクの容量が不足してい
る可能性があります。ディスクに空き容量を作ってもう一度リンカを実行してくださ
い。
September 1, 2014, CM25-00321-5
321
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
コマンドラインの指定が多すぎます
F9021L
Too many options
コマンドラインに指定した ( オプションファイル中の指定も含む ), 入力ファイル名や
オプションが多すぎます。
リンカの起動を複数回に分けてください。
オプション名の指定に誤りがあります ( オプション )
F9022L
Illegal option name ( オプション )
リンカで使用できるオプションではありません。-help オプションまたは当マニュアル
で確認してください。
パラメータの指定に誤りがあります ( オプション )
F9023L
Illegal option parameter ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
パラメータが不足していたり , 区切り記号の誤りのようなシンタックスに起因するエ
ラーであると思われる場合に通知します。
パラメータの指定に不正な文字があります ( オプション )
F9024L
Illegal character ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
数値の指定方法の誤りなど不正文字の使用によるエラーであると思われる場合に通知
します。
値が範囲外です ( 値 )
F9026L
Specified value out of range ( 値 )
-pl, -pw, -w オプションで許される範囲外の値が指定されています。
322
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
オプションファイル中にオプションファイルの指定があります
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 オプションで同じライブラリパス名が指定されている。
September 1, 2014, CM25-00321-5
323
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
セクション名の重複指定があります ( セクション名 )
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" オプションが指定されていません。
324
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
CPU 情報ファイルのバージョンが適合しません
F9056L
Mismatch CPU information file version
CPU 情報ファイルが古く適合しません。
最新の CPU 情報ファイルを入手してください。
―――――――――――――――――――――――――――――――
F9998L
File open failed ( ファイル名 )
リンカが使用するメッセージファイルがオープンできませんでした。
エラーメッセージファイル (lkt896_a.msg, lkt896_e.msg は , 決められたディレクトリに
格納してください。
プログラム内部エラーが発生しました ( 識別情報 )
F9999L
Internal error ( 識別情報 )
このエラーが出た場合は , 直ちに当社営業担当部門へ連絡してください。
■ ライブラリアンのエラーメッセージ
外部定義のない外部参照シンボルがあります
I0401U
Reference to undefined symbol
-c オプションにより報告されるメッセージです。ライブラリファイルの外部シンボル
をチェックした結果 , 当ライブラリファイル中で解決されない外部参照シンボルが含
まれていることを示しています。当メッセージの出力されるライブラリファイルをリ
ンカで使用する場合は , どのモジュールの外部定義シンボルが使われるか注意が必要
です。
デバッグ情報が含まれています
I0402U
Debug information exists
-c オプションにより報告されるメッセージです。当ライブラリファイルにはデバッグ
情報を含むモジュールが含まれています。ライブラリファイル中のデバッグ情報は , -O
オプションで取り除くことができます。
September 1, 2014, CM25-00321-5
325
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
下位互換 CPU タイプのオブジェクトがあります ( ファイル名 )
I0407U
Lower compatible cpu type object ( ファイル名 )
ここで示されたファイルは , ライブラリファイルと下位互換性のある異なる CPU タイ
プのモジュールを含むオブジェクトファイル , あるいはライブラリファイルです。
"-pl" 指定を無視します
W1401U
Ignore "-pl" option
リスト行数指定 (-pl オプション ) がありますが , 対象となるマップリストが出力指定さ
れていません。この指定を無視します。
"-pw" 指定を無視します
W1402U
Ignore "-pw" option
リスト桁数指定 (-pw オプション ) がありますが , 対象となるマップリストが出力指定
されていません。この指定を無視します。
"-g" 指定を無視します
W1403U
Ignore "-g" option
デバッグ情報付ライブラリ作成指定 (-g オプション ) は , モジュールの追加指定 (-a オ
プション ) または置換指定 (-r オプション ) を行うときのみ意味を持ちます。この指定
を無視します。
行うべき処理がありませんでした
W1404U
Nothing to operate
ライブラリファイルの変更またはモジュールの抽出処理がありませんでした。
削除するモジュールがありませんでした ( モジュール名 )
W1405U
Module not exists to delete ( モジュール名 )
-d オプションで指定のモジュールが , ライブラリファイルに含まれていません。
-m オプションで登録されているモジュール名を確かめてください。
326
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
抽出するモジュールがありませんでした ( モジュール名 )
W1406U
Module not exists to extract ( モジュール名 )
-x オプションで指定のモジュールが , ライブラリファイルに含まれていません。
-m オプションで登録されているモジュール名を確かめてください。
モジュール名の重複がありました ( ファイル名 モジュール名 )
E4402U
Duplicated module name ( ファイル名 モジュール名 )
既に登録されているモジュールと同じ名前のモジュールを追加登録しようとしまし
た。
1 つのライブラリ中にモジュールの重複はできませんので , ここで示されるモジュール
は登録しません。置き換えるならば , -r オプションを使用してください。
外部定義シンボルの重複がありました ( ファイル名 シンボル名 )
E4403U
Duplicated external definition symbol name ( ファイル名 シンボル名 )
登録されているモジュールには , 外部定義シンボルが含まれていますが , ここで示され
たシンボルは既にライブラリに登録されています。
1 つのライブラリ中に外部定義シンボルの重複はできませんので , ここで示されるシン
ボルを含むモジュールは登録しません。
登録できないモジュール形式です ( ファイル名 )
E4404U
Invalid module : type ( ファイル名 )
ライブラリファイルに登録できるのは , アセンブラが出力するオブジェクトモジュー
ル形式だけです。リンカ出力の絶対形式および相対形式ロードモジュールは登録でき
ません。
作成ツールの異なるモジュールがあります ( ファイル名 )
E4405U
Invalid module : conflict tool name ( ファイル名 )
このライブラリアンが処理できるファミリ用アセンブラ出力のオブジェクトファイル
ではありません。または , ほかのファミリ用ライブラリアンで作成されたライブラリ
ファイルが指定されています。
September 1, 2014, CM25-00321-5
327
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
コンパイルモデルの異なるモジュールがあります ( ファイル名 )
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 シンボル以下となるよう , 別ライブラリを作成してください。
CPU 情報ファイルが見つかりません ( ファイル名 )
E4470U
CPU information file not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報ファイルが見つかりません。
下記ファイルが見つからない場合に検出されます。
• %FETOOL%\LIB\896\896.CSV
CPU 情報が見つかりません ( ファイル名 )
E4471U
CPU information not found ( ファイル名 )
-cpu オプションによる指定ターゲットの CPU 情報が CPU 情報ファイル内に見つかり
ません。
下記ファイル内に指定ターゲットの CPU 情報が見つからない場合に検出されます。
• %FETOOL%\LIB\896\896.CSV
328
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
メモリが足りません
F9001U
Insufficient memory
プログラム実行のためのメモリが不足しています。
ファイルがオープンできません ( ファイル名 )
F9015U
File open error( ファイル名 )
ここで示されたファイルが出力ファイルである場合 , 1 つのディレクトリが管理できる
ファイルの制限数を越えている可能性があります。不要なファイルを削除するか移動
してください。
ファイルからの読込みができません ( ファイル名 )
F9016U
File read error ( ファイル名 )
読込み許可のないファイルである可能性があります。
ファイルへの書込みができません ( ファイル名 )
F9017U
File write error ( ファイル名 )
書込み許可のない同名のファイルが存在している可能性があります。
または , ここで示されているファイルを書き込んでいるディスクの容量が不足してい
る可能性があります。ディスクに空き容量を作ってもう一度リンカを実行してくださ
い。
コマンドラインの指定が多すぎます
F9021U
Too many options
コマンドラインに指定した ( オプションファイル中の指定も含む ), 入力ファイル名や
オプションが多すぎます。
ライブラリアンの起動を複数回に分けてください。
オプション名の指定に誤りがあります ( オプション )
F9022U
Illegal option name ( オプション )
オプション名の指定に誤りがあります。コマンドラインを訂正して再起動してくださ
い。
September 1, 2014, CM25-00321-5
329
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
パラメータの指定に誤りがあります ( オプション )
F9023U
Illegal option parameter ( オプション )
このオプションで指定すべきパラメータに誤りがあります。
値が範囲外です ( 値 )
F9026U
Specified value out of range ( 値 )
-pl または -pw オプションのパラメータで指定可能な値ではありません。
-help オプションまたは本マニュアルで確認してください。
オプションファイル中にオプションファイルの指定があります
F9027U
Option file nested
オプションファイルはネストできません。オプションファイル中に記述されている -f
オプションを削除してください。
ファイルの形式が正しくありません ( ファイル名 )
F9033U
Illegal file format ( ファイル名 )
CPU 情報ファイルの形式が正しくないかまたはライブラリファイルの形式が正しくな
い ( ライブラリファイルではない ) か , 登録または置換のために指定した入力ファイル
が , アセンブラ出力のオブジェクト形式ではありません。
異なる形式のファイルを入力したか , もしくはファイルが壊れています。
ライブラリファイル名の指定がありません
F9035U
Missing library file name
ライブラリファイル名の指定がありません。
ライブラリファイル名を指定してください。
ライブラリファイル名が複数指定されています ( ファイル名 )
F9036U
Multiple library file name specified( ファイル名 )
ライブラリファイルは 1 つだけ指定できます。ここに示されたファイル名またはこれ
により前に指定したライブラリファイル名のどちらか 1 つを選択してください。
330
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
"-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 の指定がありません。
CPU 情報ファイルのバージョンが適合しません
F9056U
Mismatch CPU information file version
CPU 情報ファイルが古く適合しません。
最新の CPU 情報ファイルを入手してください。
―――――――――――――――――――――――――――――――
F9998U
File open failed ( ファイル名 )
ライブラリファイルが使用するメッセージファイルがオープンできませんでした。
エラーメッセージファイル (lkt896_a.msg, lkt896_e.msg は , 決められたディレクトリに
格納してください。
September 1, 2014, CM25-00321-5
331
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
プログラム内部エラーが発生しました ( 識別情報 )
F9999U
Internal error ( 識別情報 )
このエラーが出た場合は , 直ちに当社営業担当部門へ連絡してください。
■ コンバータのエラーメッセージ
スタートアドレスレコードを読み飛ばしました
I0501U
Skip start address record
HEX フォーマットにスタートアドレスレコードが含まれていましたが , 不要なので読
み飛ばしました。コンバータの処理には影響なく正しくコンバートは行われます。
このファイルは警告レベルエラーを含んでいます ( ファイル名 )
W1501U
File include WARNING level error ( ファイル名 )
入力に指定したファイルは , リンク時に警告レベルのエラーがあったものです。問題な
いかどうかを確認のうえ使用してください。
出力指定フォーマットで表せないアドレスです ( アドレス )
W1502U
Unable to convert address ( アドレス )
コンバート先のフォーマットでは , 表現できないアドレスのデータがコンバート元の
ファイルに含まれています。ここで示されたアドレスを越えた部分のデータはすべて
捨てられます。
コンバート先のフォーマットを変更してください。
-I16 指定時に -entry オプションが指定されました
W1503U
-entry option was specified at the time of -I16 specification
-I16 指定時にスタートアドレス出力指定オプションが指定されました。
332
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
Soft
Ma nual
入力ファイルにスタートアドレス情報がありません
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 ( ファイル名 )
ここで示されているファイルを書き込んでいるディスクの容量が不足しています。
ディスクに空き容量を作ってもう一度コンバータを実行してください。
September 1, 2014, CM25-00321-5
333
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
コマンドラインの指定が多すぎます
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)
オプションのパラメータで指定したアドレスは , コンバート先のファイルフォーマッ
トでは表せません。指定し直してください。
334
CM25-00321-5, September 1, 2014
付録
付録 A リンケージキットのエラーメッセージ
Support
F9029U
Soft
Ma nual
指定アドレスの大小関係が逆です ( オプション :s= アドレス 1e= アドレ
ス 2)
Start address opposite to end one( オプション :s= アドレス 1e= アドレス 2)
オプションのパラメータで指定したアドレスは , スタートアドレスとエンドアドレス
の大小関係が逆です。
入力ファイル名の指定がありません
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( ファイル名 )
リンカ出力の絶対形式ロードモジュールではないファイルを入力しました。リンカで
絶対形式にしてからコンバータで使用してください。
September 1, 2014, CM25-00321-5
335
付録
付録 A リンケージキットのエラーメッセージ
Su pp or t
So ft
Manu al
出力範囲が指定されていません
F9048U
Missing output range
出力範囲の指定が行われていません。
出力範囲指定 (-ran) を指定してください。
出力範囲のサイズが限界値を越えています
F9049U
Output range exceeded
出力範囲が限界値を超えています。
出力ファイルがほかの出力ファイルと同じです ( ファイル名 )
F9050U
Output file name same as other output one( ファイル名 )
出力ファイル名に , ほかの出力ファイル名と同じ名前が指定されています。
出力ファイル名を変更してください。
ファイル名が長すぎます ( ファイル名 )
F9051U
File name too long ( ファイル名 )
ここに示された出力ファイル名の指定が長すぎるため処理ができません。
ファイル名の指定を短くしてください。
―――――――――――――――――――――――――――――――
F9998U
File open failed ( ファイル名 )
コンバータが使用するメッセージファイルがオープンできませんでした。
エラーメッセージファイル (lkt_a.msg, lkt_e.msg) は , 決められたディレクトリに格納し
てください。
プログラム内部エラーが発生しました ( 識別情報 )
F9999U
Internal error ( 識別情報 )
このエラーが出た場合は , 直ちに営業部門へ連絡してください。
336
CM25-00321-5, September 1, 2014
付録
付録 B HEX フォーマット
Support
付録 B
Soft
Ma nual
HEX フォーマット
HEX フォーマットについて説明します。
• HEX8 フォーマット :8 ビット用に設定されたフォーマット
• HEX16 フォーマット:16 ビット用に拡張されたフォーマット
• HEX32 フォーマット:32 ビット用に拡張されたフォーマット
■ HEX フォーマット
• 一般形式 (「B.1 一般形式」参照 )
• データレコード (HEX8/HEX16/HEX32) タイプ:00 (「B.2 データレコード (HEX8/
HEX16/HEX32) タイプ:00」参照 )
• エンドレコード (HEX8/HEX16/HEX32) タイプ:01 (「B.3 エンドレコード (HEX8/
HEX16/HEX32) タイプ:01」参照 )
• 拡張セグメントアドレスレコード (HEX16/HEX32) タイプ:02 (「B.4 拡張セグメン
トアドレスレコード (HEX16/HEX32) タイプ:02」参照 )
• スタートセグメントアドレスレコード (HEX16/HEX32) タイプ:03 (「B.5 スタート
セグメントアドレスレコード (HEX16/HEX32) タイプ:03」参照 )
• 拡張リニアアドレスレコード (HEX32) タイプ:04 「
( B.6 拡張リニアアドレスレコー
ド (HEX32) タイプ:04」参照 )
• スタートリニアアドレスレコード (HEX32) タイプ:05 (「B.7 スタートリニアアド
レスレコード (HEX32) タイプ:05」参照 )
September 1, 2014, CM25-00321-5
337
付録
付録 B HEX フォーマット
Su pp or t
So ft
Manu al
一般形式
B.1
HEX フォーマットは , (a) ~ (f) で示す 6 つのフィールドで構成されます。
各フィールドは , ASCII コードで設定されます。(g) については , 後述します。
■ 一般形式
図 B.1-1 一般形式
:
l1
(a)
(b)
l2
a1 a2 a3 a4
t1
(c)
(d)
t2
d1 d2 d3
d4
d*
d*
d*
d*
(e)
s1
s2
(f)
(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)のレコードタイプごとに異なりますので,各レコードの説明で示します。
(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
バイトになります。
【例】
338
:020000020036C6
拡張アドレスレコード
:0600100090D9226BB4FD43
データレコード
:040000035162000541
スタートアドレスレコード
:00000001FF
エンドレコード
CM25-00321-5, September 1, 2014
付録
付録 B HEX フォーマット
Support
Soft
Ma nual
データレコード (HEX8/HEX16/HEX32) タイプ:00
B.2
d1, d2 が (c) が示すアドレスのバイトデータになり , d3, d4 は , 次のアドレスのバイ
トデータです。
■ データレコード (HEX8/HEX16/HEX32)
図 B.2-1 データレコード (HEX8/HEX16/HEX32)
:
l1
(a)
(b)
l2
a1
a2
(c)
a3
a4
0
(d)
0
d1
d2
d3
d4
d*
d*
d*
d*
(e)
s1
(f)
s2
(g)
(a)(b)(c)(d)(f)(g)については,「B.1 一般形式」の説明を参照してください。
(e)は,オブジェクトデータで,実際の1バイトデータを2バイトのASCIIで表現します。
(c)が示すアドレスのバイトデータは,d1,d2になります。
同様にd3,d4は,次のアドレスのバイトデータです。
September 1, 2014, CM25-00321-5
339
付録
付録 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を設定します。
340
CM25-00321-5, September 1, 2014
付録
付録 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
(e)
p2
p3
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としてアドレス計算が行われます。
September 1, 2014, CM25-00321-5
341
付録
付録 B HEX フォーマット
Su pp or t
So ft
Manu al
スタートセグメントアドレスレコード (HEX16/HEX32)
タイプ:03
B.5
プログラムの実行開始番地を指定するためのレコードです。
スタートアドレスは , 次の式に従って計算されます。
( ( 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になります。
342
CM25-00321-5, September 1, 2014
付録
付録 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
(e)
p2
p3
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としてアドレス計算が行われます。
September 1, 2014, CM25-00321-5
343
付録
付録 B HEX フォーマット
Su pp or t
So ft
Manu al
スタートリニアアドレスレコード (HEX32) タイプ:05
B.7
プログラムの実行開始番地を指定するためのレコードです。
■ スタートリニアアドレスレコード (HEX32)
図 B.7-1 スタートリニアアドレスレコード (HEX32)
:
0
(a)
(b)
4
0
(c)
0
0
0
0
(d)
5
e1
e2
e3
e4
e5
e6
(e)
e7
e8
s1
(f)
s2
(g)
(e)は,32bitの実行開始アドレスが設定されます。
e1が上位桁になります。
(c)は未使用ですが0を設定します。
当レコードの出現箇所は,エンドレコード以前ならどこでもかまいません。
出現回数は,0または1になります。
344
CM25-00321-5, September 1, 2014
付録
付録 C S レコード形式
Support
付録 C
Soft
Ma nual
S レコード形式
S レコードフォーマットは , すべて "S" (0x53) の文字で始まり , S0 から S9 までの
8 タイプがあります (S4 と S6 は使用しません )。
■ S レコード形式
• S0 タイプ ( ヘッダレコード ) (「C.1 S0 タイプ ( ヘッダレコード )」参照 )
• S1 タイプ ( データレコード :2 バイトアドレス ) (「C.2 S1 タイプ ( データレコード:
2 バイトアドレス )」参照 )
• S2 タイプ ( データレコード :3 バイトアドレス ) (「C.3 S2 タイプ ( データレコード:
3 バイトアドレス )」参照 )
• S3 タイプ ( データレコード :4 バイトアドレス ) (「C.4 S3 タイプ ( データレコード:
4 バイトアドレス )」参照 )
• S5 タイプ ( レコード数管理アドレス ) 「C.5
(
S5 タイプ ( レコード数管理レコード )」
参照 )
• S7 タイプ ( ターミネータレコード ) 「C.6
(
S7 タイプ ( ターミネータレコード )」参照 )
• S8 タイプ ( ターミネータレコード ) 「C.7
(
S8 タイプ ( ターミネータレコード )」参照 )
• S9 タイプ ( ターミネータレコード ) 「C.8
(
S9 タイプ ( ターミネータレコード )」参照 )
September 1, 2014, CM25-00321-5
345
付録
付録 C S レコード形式
Su pp or t
C.1
So ft
Manu al
S0 タイプ ( ヘッダレコード )
当レコードは , コメント記述のために使用します。
■ 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)
2バイト
2バイト
4バイト
nバイト
2バイト
(f)
当レコードは,上記の(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"を示す
346
CM25-00321-5, September 1, 2014
付録
付録 C S レコード形式
Support
C.2
Soft
Ma nual
S1 タイプ ( データレコード: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タイプ(ヘッダレコード)」の説明を参照してください。)
September 1, 2014, CM25-00321-5
347
付録
付録 C S レコード形式
Su pp or t
C.3
So ft
Manu al
S2 タイプ ( データレコード: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バイトアドレスが必要なオ
ブジェクトデータを格納するためのレコードです。
348
CM25-00321-5, September 1, 2014
付録
付録 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バイトアドレスが必要なオブジェク
トデータを格納するためのレコードです。
September 1, 2014, CM25-00321-5
349
付録
付録 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)~(c),(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タイプ(ヘッダレコード)」の説明を参照してください。)
350
CM25-00321-5, September 1, 2014
付録
付録 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)~(c),(e)で示す4つのフィールドで構成されます。
(a): タイプフィールドで,ASCIIコードで"S7"(0x5337)の文字です。
(b): (c) (e)のバイト数を示します。"05"固定となります。
(c): 実行開始アドレスを示します。
e1が上位桁,e8が下位桁になります。
(d): フィールドはありません。
(e): チェックサムです。
(f): 一般に制御コード(CR,LFなど)が付加されます。
September 1, 2014, CM25-00321-5
351
付録
付録 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バイトが必要な場合のターミネータレコードです。
352
CM25-00321-5, September 1, 2014
付録
付録 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バイトが必要な場合のターミネータレコードです。
September 1, 2014, CM25-00321-5
353
付録
付録 D リンカのオプション一覧表
Su pp or t
付録 D
So ft
Manu al
リンカのオプション一覧表
表 D-1 にリンカのオプション一覧を示します。
■ リンカのオプション一覧
表 D-1 リンカのオプション一覧表 (1 / 3)
機能
354
オプション
備考
出力ロードモジュールファイル名指定
-o
デフォルト
デバッグ情報出力指定
-g
デバッグ情報削除指定
-Xg
デフォルト
絶対形式ロードモジュール出力指定
-a
デフォルト
相対形式ロードモジュール出力指定
-r
マップリストファイル名指定
-m
マップリスト出力抑止指定
-Xm
リスト表示の名前省略解除
-dt
メモリ使用情報リスト出力指定
-mmi
リスト行の桁数指定
-pw
デフォルト 132
リスト 1 ページの行数指定
-pl
デフォルト 60
警告メッセージ出力レベル指定
-w
ROM 領域指定
-ro
RAM 領域指定
-ra
セクション配置
-sc
セクショングループ指定
-gr
レジスタバンク領域の指定
-rg
自動配置指定
-AL
検索ライブラリファイル指定
-l
ライブラリ検索パス指定
-L
シンボル個別のライブラリ指定
-el
ライブラリ検索抑止指定
-nl
デフォルトライブラリ検索抑止指定
-nd
エントリアドレス指定
-e
外部シンボル値の仮設定
-df
デフォルト
デフォルト 0
CM25-00321-5, September 1, 2014
付録
付録 D リンカのオプション一覧表
Support
Soft
Ma nual
表 D-1 リンカのオプション一覧表 (2 / 3)
機能
備考
オプション
ターゲット 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
デフォルト
オブジェクト混在チェック指定
-objmixchk
デフォルト
オブジェクト混在チェック抑止指定
-Xobjmixchk
相対アセンブルリスト入力ディレクトリ指定
-alin
絶対アセンブルリスト出力ディレクトリ指定
-alout
絶対アセンブルリスト出力指定
-als
絶対アセンブルリスト出力モジュール指定
-alsf
絶対アセンブルリスト出力抑止指定
-Xals
ROM/RAM, ARRAY リスト出力指定
-alr
ROM/RAM, ARRAY リスト出力モジュール指定
-alrf
ROM/RAM, ARRAY リスト出力抑止指定
-Xalr
ROM/RAM, ARRAY リストのシンボルとアドレスの表
示位置指定
-na/-an
外部シンボル相互参照情報リスト出力指定
-xl
外部シンボル相互参照情報リストファイル名指定
-xlf
外部シンボル相互参照情報リスト出力抑止指定
-Xxl
ローカルシンボルリスト出力指定
-sl
ローカルシンボルリストファイル名の指定
-slf
ローカルシンボルリスト出力抑止指定
-Xsl
セクション詳細マップリスト出力指定
-ml
セクション詳細マップリストファイル名の指定
-mlf
セクション詳細マップリスト出力抑止指定
-Xml
September 1, 2014, CM25-00321-5
必須
デフォルト
デフォルト
デフォルト
355
付録
付録 D リンカのオプション一覧表
Su pp or t
So ft
Manu al
表 D-1 リンカのオプション一覧表 (3 / 3)
機能
356
オプション
備考
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
オプションファイル読込み指定
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止
-XV
* 共通オプション
終了メッセージ表示指定
-cmsg
* 共通オプション
終了メッセージ表示抑止指定
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
CM25-00321-5, September 1, 2014
付録
付録 E ライブラリアンのオプション一覧表
Support
付録 E
Soft
Ma nual
ライブラリアンのオプション一覧表
表 E-1 にライブラリアンのオプション一覧を示します。
■ ライブラリアンのオプション一覧
表 E-1 ライブラリアンのオプション一覧表 (1 / 2)
機能
備考
オプション
モジュールの追加 ( 登録 )
-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
オブジェクト混在チェック指定
-objmixchk
オブジェクト混在チェック抑止指定
-Xobjmixchk
デフォルトオプションファイル読込み抑止指定
-Xdof
* 共通オプション
オプションファイル読込み指定
-f
* 共通オプション
ヘルプメッセージ表示指定
-help
* 共通オプション
版数 / メッセージ出力指定
-V
* 共通オプション
版数 / メッセージ出力抑止指定
-XV
* 共通オプション
終了メッセージ出力指定
-cmsg
* 共通オプション
September 1, 2014, CM25-00321-5
デフォルト
必須
デフォルト
357
付録
付録 E ライブラリアンのオプション一覧表
Su pp or t
So ft
Manu al
表 E-1 ライブラリアンのオプション一覧表 (2 / 2)
機能
358
オプション
備考
終了メッセージ出力抑止指定
-Xcmsg
* 共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
* 共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
* 共通オプション
CM25-00321-5, September 1, 2014
付録
付録 F オブジェクト形式コンバータのコマンドおよびオプショ
ン一覧表
Support
付録 F
Soft
Ma nual
オブジェクト形式コンバータのコマンドおよびオプ
ション一覧表
表 F-1 にオブジェクト形式コンバータのコマンド一覧を , 表 F-2 にオブジェクト形
式コンバータのオプション一覧を示します。
■ オブジェクト形式コンバータのコマンド一覧
表 F-1 オブジェクト形式コンバータのコマンド一覧
機能
コマンド名
f2ms
絶対形式ロードモジュール → S フォーマット
f2hs
絶対形式ロードモジュール → HEX フォーマット (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 フォーマット
September 1, 2014, CM25-00321-5
359
付録
付録 F オブジェクト形式コンバータのコマンドおよびオプショ
ン一覧表
Su pp or t
So ft
Manu al
■ オブジェクト形式コンバータのオプション一覧
表 F-2 オブジェクト形式コンバータのオプション一覧
機能
360
オプション
備考
出力ファイル名の指定 -o
パディングデータ指定
-p
出力範囲指定
-ran
m2ms, h2hs, m2bs,
h2bs のみ 必須
スプリットモード指定
-sp
m2bs のみ
スプリットモード抑止指定
-Xsp
m2bs のみ
マップリストファイル作成指定
-m
m2bs のみ
マップリストファイル作成抑止指定
-Xm
m2bs のみ
出力ファイル S フォーマット指定
-S1, -S2, -S3
f2ms, m2ms のみ
出力ファイル HEX フォーマット指定
-I16, -I20, -I32
f2hs, h2hs のみ
整形指定
-adjust
f2ms, f2hs のみ
開始アドレス変更指定
-ST
m2ms, h2hs のみ
スタートアドレスレコード出力指定
-entry
f2hs のみ
スタートアドレスレコード出力抑止指定
-Xentry
f2hs のみ
デフォルトオプションファイル読込み抑止指定
-Xdof
*共通オプション
オプションファイル読込み指定
-f
*共通オプション
ヘルプメッセージ表示指定
-help
*共通オプション
版数 / メッセージ出力指定
-V
*共通オプション
版数 / メッセージ出力抑止
-XV
*共通オプション
終了メッセージ表示指定
-cmsg
*共通オプション
終了メッセージ表示抑止指定
-Xcmsg
*共通オプション
ワーニング発生時の終了コードを 1 にする指定
-cwno
*共通オプション
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
*共通オプション
CM25-00321-5, September 1, 2014
付録
付録 G OS による仕様の相違点
Support
付録 G
Soft
Ma nual
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 版
Windows 版
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
September 1, 2014, CM25-00321-5
361
付録
付録 H SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Su pp or t
付録 H
So ft
Manu al
SOFTUNE 言語ツール移行時のオブジェクト同一性
確認方法
旧 8L アセンブラ (asm96) 用のソースプログラムを新アセンブラ (fasm896s) に移植
した際 , 新 / 旧両絶対形式ファイルがバイナリレベルで完全に一致しているかどうか
を調べようとする手順を説明したものです。
H.1 比較手順の概略
H.2 実施例
H.3 データに差異が生じている場合
362
CM25-00321-5, September 1, 2014
付録
付録 H SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Support
H.1
Soft
Ma nual
比較手順の概略
新・旧アセンブラで作成した絶対形式ファイルを , S フォーマットファイルに変換し
て比較します。
■ 比較手順の概略
新・旧アセンブラで作成した絶対形式ファイルを , S フォーマットファイルに変換して
比較します。
[旧絶対形式ファイル]
[新絶対形式ファイル]
Sフォーマットで
作成してください
ロードモジュール
コンバータ
f2ms
[Sフォーマットファイル]
Sフォーマット
アジャスタ
m2ms
アドレス昇順にソート
1レコードのデータ数を
一定にします。
整形した
Sフォーマットファイル
ファイル比較ツール
fc.exe
[比較リスト]
この情報を元に判
断します。
1 行目の S0 レコードと , 最終行の S7 レコードに関しては , 違いがあっても無視してく
ださい。
September 1, 2014, CM25-00321-5
363
付録
付録 H SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Su pp or t
H.2
So ft
Manu al
実施例
旧アセンブラで作成した絶対形式ファイルを "old.mhx", 新アセンブラで作成した絶
対形式ファイルを "new.abs" として説明します。
■ 実施例
旧アセンブラで作成した絶対形式ファイルを "old.mhx", 新アセンブラで作成した絶対
形式ファイルを "new.abs" として説明します。
<注意事項>
旧 8L 用ツールで作成した絶対形式ファイルは , リンク時に "FM" を指定して 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
*****
364
CM25-00321-5, September 1, 2014
付録
付録 H SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Support
H.3
Soft
Ma nual
データに差異が生じている場合
以下に FC の出力例を示します。この情報を元に差異が生じた個所を特定します。
■ データに差異が生じている場合
以下に FC の出力例を示します。この情報を元に差異が生じた個所を特定します。
【出力例】
fc old.ahx new.ahx
***** old.ahx
S3150000FF00000102032C37060708090A0B0C0D0E0F19
***** new.ahx
S3150000FF00000102030405060708090A0B0C0D0E0F73
*****
■ S フォーマットからアドレスを求めます
Sフォーマットは以下のフォーマットを持ちます。
S3
レコード長 (1 byte)
S3 はデータレコード
を表します。
アドレス(4 bytes)
データの開始アドレス
を表します。
データ
CS
チェックサム
(注意事項) "S3"レコード以外は無視してください。
これより差異が生じているデータのアドレスを求めることができます。
S3150000FF00000102030405060708090A0B0C0D0E0F73
このレコードのデータは0x00FF00 番地から配置されています。これより差異が
生じているデータ"0405"は0xFF05 番地と,0xFF06 番地に配置されているもの
であることがわかります。
September 1, 2014, CM25-00321-5
365
付録
付録 H SOFTUNE 言語ツール移行時のオブジェクト同一性確認
方法
Su pp or t
So ft
Manu al
■ リンクマップを使った問題モジュールの特定
リンクマップを使って S3 レコードで求めたアドレスがどのモジュールで記述されてい
るかを特定します。
リンク時に -mlf オプションと -als オプションの指定が必要です。
mlf オプションは詳細マップ情報を , als オプションは絶対アセンブルリストを作成し
ます。
【出力例】
>flnk896s 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
0000FF00 - 0000FF0F
0000FF10 - 0000FF1F
Size
00000010
00000010
Section
CONST P
CONST P
Type
R--I
R--I
AlM.No
021
022
Sec.(Top 80)
data
data
この詳細マップ情報により , 該当するアドレス 0xff05, 0xff06 はモジュール番号 1 番
"main" というモジュールで定義されていることがわかります。
■ 問題個所の特定
リンクマップを使った問題モジュールの特定で作成しておいた絶対アセンブルリスト
から問題の個所を探します。
絶対アセンブルリスト (main.als)
SN LOC OBJ LLINE SOURCE
<main.asm> =====
MODULE NAME = test
da FF00 -----------<data>-----------, CONST, ALIGN=2
da FF00 00 01 02 03 2C 37 06
da FF07 07 08 09 0A 0B 0C 0D
da FF0E 0E 0F
==
366
1
2
3
4
5
6
7
8
9
.TITLE main
.PROGRAM main
.SECTION data
.DATA.B 0,1,2,3, 44,55 ,6,
7,8,9,10,11,12,13,
14,15
;data ends
.END
CM25-00321-5, September 1, 2014
付録
付録 I SOFTUNE リンカ (FLNK896S) と旧版リンカ (LINK96)
の仕様の差異について
Support
付録 I
Soft
Ma nual
SOFTUNE リンカ (FLNK896S) と旧版リンカ
(LINK96) の仕様の差異について
SOFTUNE リンカ (FLNK896S) と , 旧版リンカ (LINK96) の仕様の差異について述べ
たものです。
■ はじめに
FLNK896S は , LINK96 に比べて以下の点が変更されています。
• コマンドラインの記述方法
• 絶対アセンブルリスト作成機能のリンカへの追加
• 制限事項 ( 入力ファイル数 , セクション数 , シンボル数など ) の緩和
• 環境変数の強化
• 外部シンボルの相互参照情報リスト作成機能のサポート
• シンボルの詳細情報リスト作成機能のサポート
• モジュールごとのセクションマップ作成機能のサポート
■ 絶対アセンブルリスト作成機能
本版より「絶対アセンブルリスト作成ツール」の機能をリンカに追加しました。
ソースプログラム
アセンブラ(fasm896s)
アセンブル
リスト
オブジェクト
モジュール
リンカ(flnk896s)
ロードモジュール
September 1, 2014, CM25-00321-5
リンカ出力リスト
絶対形式
アセンブルリスト
367
付録
付録 I SOFTUNE リンカ (FLNK896S) と旧版リンカ (LINK96)
の仕様の差異について
Su pp or t
So ft
Manu al
■ コマンド行の差異
起動時のコマンドライン指定の差異を表 I-1 と表 I-2 に示します。
表 I-1 リンカの起動形式
FLNK896S
LINK96
flnk896S [ オプション ]... [ ファイル名 ]
lnk96 ファイル名 [ オプション ]...
lnk96 @ オプションファイル
表 I-2 リンカのオプション指定
FLNK896S
LINK96
オプションの指定位置
どの位置でも可能
ファイル名指定の後
オプションファイルの指定
-f オプションファイル
@ オプションファイル
オプションファイルの複数指定
可
不可
■ 環境変数
環境変数の差異を表 I-3 に示します。
表 I-3 環境変数
FLNK896S
LINK96
TMP
TMP
インストールパス指定
FETOOL
─
表示文字コード指定
FELANG
─
デフォルトオプションファイルの格納パス指定
OPT896
─
ライブラリ検索パス指定
LIB896
96LIB(MS-DOS)
LIB96(Unix)
作業用ディレクトリ指定
表 I-4 リンカのオプション -1 (1 / 3)
機能
FLNK896S
LINK96
ロードモジュール出力指定
不要
-OJ
ロードモジュール出力抑止
-
-NJ
エラー情報ファイルの出力指定
-
-EP
エラー情報ファイルの出力抑止
-
-NOEP
OS 復帰値のファイル化指定
-
-RC
不要
-END
記述終了指定
368
CM25-00321-5, September 1, 2014
付録
付録 I SOFTUNE リンカ (FLNK896S) と旧版リンカ (LINK96)
の仕様の差異について
Support
Soft
Ma nual
表 I-4 リンカのオプション -1 (2 / 3)
機能
FLNK896S
LINK96
出力ロードモジュールファイル名指定
-o
-OJ
デバッグ情報出力指定
-g
-DBG
デバッグ情報削除指定
-Xg
-
絶対形式ロードモジュール出力指定
-a
-
相対形式ロードモジュール出力指定
-r
-
マップリストファイル名指定
-m
-L
マップリスト出力抑止指定
-Xm
-NL
リスト表示の名前省略解除
-dt
-NP
-mmi
-
リスト行の桁数指定
-pw
-PW
リスト 1 ページの行数指定
-pl
-PL
警告メッセージ出力レベル指定
-w
-NW
ROM 領域指定
-ro
-ROMSIZE
RAM 領域指定
-ra
-RAMSIZE
セクション配置
-sc
-SEG
セクショングループ指定
-gr
-
レジスタバンク領域の指定
-rg
-RG
自動配置指定
-AL
-
検索ライブラリファイル指定
-l
-LIB
ライブラリ検索パス指定
-L
-
シンボル個別のライブラリ指定
-el
-
ライブラリ検索抑止指定
-nl
-
デフォルトライブラリ検索抑止指定
-nd
-
エントリアドレス指定
-e
-
外部シンボル値の仮設定
-df
-
-cpu
-
-NCI0302LIB
-
-set_rora
-
内蔵 ROM/RAM 領域自動設定の抑止指定
-Xset_rora
-
ユーザ指定領域のチェック指定
-check_rora
-
ユーザ指定領域のチェック抑止指定
-Xcheck_rora
-
セクション配置領域チェック指定
-check_locate
-
メモリ使用情報リスト出力指定
ターゲット CPU 指定
デバッグ情報存在チェック抑止指定
内蔵 ROM/RAM 領域の自動設定
September 1, 2014, CM25-00321-5
369
付録
付録 I SOFTUNE リンカ (FLNK896S) と旧版リンカ (LINK96)
の仕様の差異について
Su pp or t
So ft
Manu al
表 I-4 リンカのオプション -1 (3 / 3)
機能
FLNK896S
LINK96
セクション配置領域チェック抑止指定
-Xcheck_locate
-
ユーザ指定外セクションのチェック指定
-check_section
-
-Xcheck_section
-
-objmixchk
-
-Xobjmixchk
-
FLNK896S
LINK96
相対アセンブルリスト入力ディレクトリ指定
-alin
-
絶対アセンブルリスト出力ディレクトリ指定
-alout
-
絶対アセンブルリスト出力指定
-als
-
絶対アセンブルリスト出力モジュール指定
-alsf
-
絶対アセンブルリスト出力抑止指定
-Xals
-
ROM/RAM, ARRAY リスト出力指定
-alr
-
ROM/RAM, ARRAY リスト出力モジュール指定
-alrf
-
ROM/RAM, ARRAY リスト出力抑止指定
-Xalr
-
-na/-an
-
外部シンボル相互参照情報リスト出力指定
-xl
-
外部シンボル相互参照情報リストファイル名指定
-xlf
不要
外部シンボル相互参照情報リスト出力抑止指定
-Xxl
-
ローカルシンボルリスト出力指定
-sl
-SL/-HSL
ローカルシンボルリストファイル名の指定
-slf
-
ローカルシンボルリスト出力抑止指定
-Xsl
-
セクション詳細マップリスト出力指定
-ml
-
セクション詳細マップリストファイル名の指定
-mlf
-
セクション詳細マップリスト出力抑止指定
-Xml
-
デフォルトオプションファイル読込み抑止指定
-Xdof
-
-f
-
ヘルプメッセージ表示指定
-help
-
版数 / メッセージ出力指定
-V
-
ユーザ指定外セクションのチェック抑止指定
オブジェクト混在チェック指定
オブジェクト混在チェック抑止指定
表 I-5 リンカのオプション -2 (1 / 2)
機能
ROM/RAM, ARRAY リストのシンボルとアドレス
の表示位置指定
オプションファイル読込み指定
370
CM25-00321-5, September 1, 2014
付録
付録 I SOFTUNE リンカ (FLNK896S) と旧版リンカ (LINK96)
の仕様の差異について
Support
Soft
Ma nual
表 I-5 リンカのオプション -2 (2 / 2)
機能
FLNK896S
LINK96
-XV
-
-cmsg
-
-Xcmsg
-
ワーニング発生時の終了コードを 1 にする指定
-cwno
-
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
-
版数 / メッセージ出力抑止
終了メッセージ表示指定
終了メッセージ表示抑止指定
■ 制限事項の緩和
表 I-6 処理限界
FLNK896S
LINK96
入力ファイル数
65535
255
結合モジュール数
65535
255
結合セクション数
65535
255
外部定義シンボル数
65535
65534
外部参照シンボル数
65535
65535
September 1, 2014, CM25-00321-5
371
付録
付録 J SOFTUNE ライブラリアン (FLIB896S) と旧版ライブラ
リアン (LIB96) の仕様の差異について
Su pp or t
付録 J
So ft
Manu al
SOFTUNE ライブラリアン (FLIB896S) と旧版ライブ
ラリアン (LIB96) の仕様の差異について
SOFTUNE ライブラリアン (FLIB896S) と , 旧版ライブラリアン (LIB96) の仕様の差
異について述べたものです。
■ コマンド行の差異
起動時のコマンドライン指定の差異を表 J-1 と表 J-2 に示します。
表 J-1 ライブラリアンの起動形式
FLIB896S
LIB96
flib896S [ オプション ]... [ ファイル名 ]
lib96 ファイル名 [ オプション ]...
lib96 @ オプションファイル
表 J-2 ライブラリアンのオプション指定
FLIB896S
LIB96
オプションの指定位置
どの位置でも可能
ファイル名指定の後
オプションファイルの指定
-f オプションファイル
@ オプションファイル
オプションファイルの複数指定
可
不可
■ 環境変数
環境変数の差異を表 J-3 に示します。
表 J-3 環境変数
FLIB896S
LIB96
TMP
TMP
インストールパス指定
FETOOL
─
表示文字コード指定
FELANG
─
デフォルトオプションファイル
の格納パス指定
OPT896
─
ライブラリ検索パス指定
LIB896
─
作業用ディレクトリ指定
372
CM25-00321-5, September 1, 2014
付録
付録 J SOFTUNE ライブラリアン (FLIB896S) と旧版ライブラ
リアン (LIB96) の仕様の差異について
Support
Soft
Ma nual
表 J-4 ライブラリアンのオプション (1 / 2)
機能
オプション
備考
モジュールの選択
-
-S
エラー情報ファイルの出力 / 出力抑止
-
-EP/-NEP
ステータスコードのファイル出力
-
-RETCODE(-RC)
オプションファイルの終了
不要
-E
モジュールの追加 ( 登録 )
-a
-A
モジュールの置換 ( 登録 )
-r
-R
モジュールの削除
-d
-D
モジュールの抽出
-x
-X
リストファイルの出力指定
-m
-L
常に出力
-LM
-Xm
-
-dt
-dt s
-dt d -dt a
-dt r -dt a
-
-LP
-dt r -dt a
相互参照リストの作成
-
-LX
リスト 1 ページの行数指定
-pl
-
リスト 1 行の桁数指定
-pw
-
-b
-
-Xb
-
ライブラリファイルの内容検査
-c
-
ファイル内容の最適化
-O
-
デバッグ情報の出力指定
-g
-
デバッグ情報の出力抑止指定
-Xg
-
ターゲット CPU 指定
-cpu
-
-objmixchk
-
-Xobjmixchk
-
-Xdof
-
-f
-
ヘルプメッセージ表示指定
-help
-
版数 / メッセージ出力指定
-V
-
-XV
-
モジュール名リスト出力
リストファイルの出力抑止指定
リストファイルの詳細情報の出力指定
セグメント情報リスト出力
外部定義シンボル情報出力
外部参照シンボル情報出力
バックアップファイルの作成
バックアップファイルの作成抑止
オブジェクト混在チェック指定
オブジェクト混在チェック抑止指定
デフォルトオプションファイル読込み抑止指定
オプションファイル読込み指定
版数 / メッセージ出力抑止指定
September 1, 2014, CM25-00321-5
373
付録
付録 J SOFTUNE ライブラリアン (FLIB896S) と旧版ライブラ
リアン (LIB96) の仕様の差異について
Su pp or t
So ft
Manu al
表 J-4 ライブラリアンのオプション (2 / 2)
機能
オプション
備考
-cmsg
-
-Xcmsg
-
ワーニング発生時の終了コードを 1 にする指定
-cwno
-
ワーニング発生時の終了コードを 0 にする指定
-Xcwno
-
終了メッセージ出力指定
終了メッセージ出力抑止指定
表 J-5 処理限界
374
FLIB896S
LIB96
入力ファイル数
65535
255
結合モジュール数
65535
255
結合セクション数
65535
255
外部定義シンボル数
65535
4000
外部参照シンボル数
65535
1500
CM25-00321-5, September 1, 2014
付録
付録 K 主な変更内容
Support
付録 K
Soft
Ma nual
主な変更内容
ページ
場所
変更箇所
Revision 4.1
-
-
社名変更および記述フォーマットの変換
Revision 5.0
9
1.5 起動メッセージ
起動メッセージの表示例を削除
■ 起動メッセージ
35
3.2.4 版数 / メッセージ出力
例を削除
指定 (-V)
■ 版数 / メッセージ出力指
定 (-V)
325
付録 A リンケージキットの
お問い合わせ先を訂正
エラーメッセージ
エラーコード : F9999L
332
付録 A リンケージキットの
お問い合わせ先を訂正
エラーメッセージ
エラーコード : F9999U
September 1, 2014, CM25-00321-5
375
付録
付録 K 主な変更内容
Su pp or t
376
So ft
Manu al
CM25-00321-5, September 1, 2014
索引
Support
Soft
Ma nual
索引
A
-a
絶対形式ロードモジュールの出力指定 (-a) ........98
モジュールの追加 ( 登録 )(-a) .............................215
-AL
-AL 1 が指定された場合の配置例 ........................69
-AL 2 が指定された場合の配置例 ........................72
自動配置指定 (-AL) ..............................................125
-alin
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................151
-alout
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................152
-alr
ROM/RAM,ARRAY リスト出力指定 (-alr) ........156
-alrf
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................157
-als
絶対アセンブルリスト出力指定 (-als) ...............153
-alsf
絶対アセンブルリスト出力モジュール指定
(-alsf) .................................................................154
-an
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ...............159
B
-b
バックアップファイルの作成 (-b) ......................225
C
-c
ライブラリファイルの内容検査 (-c) ..................227
-check_locate
セクション配置領域チェック指定
(-check_locate) .................................................142
-check_rora
ユーザ指定領域のチェック指定 (-check_rora)
..........................................................................139
-check_section
ユーザ指定外セクションのチェック指定
(-check_section) ................................................146
-cif
CPU 情報ファイル指定 (-cif) ...............................135
-cmsg
-cmsg オプション ....................................................29
終了メッセージと -cmsg オプション ...................10
終了メッセージ表示指定 (-cmsg) .........................37
CPU
CPU 情報ファイル ..................................................86
CPU 情報ファイル名 ..............................................86
September 1, 2014, CM25-00321-5
ターゲット CPU 指定 (-cpu) ........................134, 231
CPU 情報ファイル
CPU 情報ファイル指定 (-cif) ..............................135
-cs
ROM 領域のチェックサム指定 (-cs) .................. 109
-cwno
-cwno オプション ................................................... 29
ワーニング発生時の終了コードを 1 にする指定
(-cwno) ...............................................................39
D
-d
モジュールの削除 (-d) .........................................218
-df
外部シンボル値の仮設定 (-df) ............................133
-dt
リスト表示の名前の省略解除 (-dt) .................... 105
リストファイルの詳細情報の出力指定 (-dt)
..........................................................................222
E
-e
エントリアドレスの指定 (-e) ..............................132
e2ms
e2ms (HEX16 フォーマット
→ S フォーマット変換 ) ............................... 301
-el
シンボル個別のライブラリの指定 (-el) ............129
F
-f
-f オプション ...........................................................29
オプションファイルからの読込み指定 (-f) ........ 32
f2es
f2es ( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ...................... 272
f2hs
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) .......................... 270
f2is
f2is ( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................ 271
f2ms
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ............................... 269
FELANG
FELANG ............................................................. 14, 16
FETOOL
FETOOL ............................................................. 14, 17
-fill
ROM 領域のフィル指定 (-fill) ............................. 100
377
索引
Su pp or t
G
Manu al
-l
-g
デバッグ情報の出力指定 (-g) ........................96, 229
-gr
セクショングループの指定 (-gr) ........................122
H
-help
-help オプション .....................................................29
ヘルプメッセージの表示 (-help) ...........................34
HEX16
e2ms (HEX16 フォーマット
→ S フォーマット変換 ) ................................301
f2es ( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................272
m2es (S フォーマット
→ HEX16 フォーマット変換 ) ......................299
エンドレコード (HEX8/HEX16/HEX32) ............340
拡張セグメントアドレスレコード
(HEX16/HEX32) ..............................................341
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................342
データレコード (HEX8/HEX16/HEX32) ............339
HEX32
エンドレコード (HEX8/HEX16/HEX32) ............340
拡張セグメントアドレスレコード
(HEX16/HEX32) ..............................................341
拡張リニアアドレスレコード (HEX32) .............343
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................342
スタートリニアアドレスレコード
(HEX32) ...........................................................344
データレコード (HEX8/HEX16/HEX32) ............339
HEX8
f2is ( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................271
i2ms (HEX8 フォーマット
→ S フォーマット変換 ) ................................300
m2is (S フォーマット
→ HEX8 フォーマット変換 ) ........................298
エンドレコード (HEX8/HEX16/HEX32) ............340
データレコード (HEX8/HEX16/HEX32) ............339
HEX フォーマット
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................270
HEX フォーマット ...............................................337
出力 HEX フォーマット指定 (-I16/-I20/-I32)
..................................................................278, 283
検索ライブラリファイルの指定 (-l) .................. 127
-len
出力レコードデータ長指定 (-len) ...................... 278
出力レコード内データ長指定 (-len) .................. 279
LIB896
LIB896 ......................................................................18
LIB896( ライブラリファイル検索ディレクトリ )
............................................................................14
M
-m
マップリストファイルの作成指定 (-m)
..................................................................289, 294
マップリストファイル名の指定 (-m) ................ 103
リストファイルの出力指定 (-m) ........................ 220
m2es
m2es (S フォーマット
→ HEX16 フォーマット変換 ) ...................... 299
m2is
m2is (S フォーマット
→ HEX8 フォーマット変換 ) ........................ 298
-ml
セクション詳細マップリスト出力指定 (-ml)
..........................................................................167
-mlf
セクション詳細マップリストファイル名の指定
(-mlf) ................................................................. 168
-mmi
メモリ使用情報リストの出力指定 (-mmi) ........106
N
-na
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ............... 159
-NCI0302LIB
デバッグ情報存在チェック抑止指定
(-NCI0302LIB) ................................................. 136
-nd
デフォルトライブラリ検索の抑止指定 (-nd)
..........................................................................131
-nl
ライブラリ検索の抑止指定 (-nl) ........................ 130
O
-O
ファイル内容の最適化 (-O) ................................228
-o
I
i2ms
i2ms (HEX8 フォーマット
→ S フォーマット変換 ) ................................300
L
-L
ライブラリ検索パスの指定 (-L) .........................128
378
So ft
出力ファイル名の変更 (-o) ................................. 255
出力ロードモジュールファイル名指定 (-o) .......94
-objmixchk
オブジェクト混在チェック指定 (-objmixchk)
..................................................................149, 233
OPT
OPT ........................................................................... 20
OPT( デフォルトオプションファイル
格納ディレクトリ ) .......................................... 14
OPT896 ..................................................................... 19
CM25-00321-5, September 1, 2014
索引
Support
Soft
Ma nual
OPT896( デフォルトオプションファイル
格納ディレクトリ ) ..........................................14
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) ................................................................. 157
ROM/RAM,ARRAY リスト出力抑止指定 (-Xalr)
........................................................................... 158
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ............... 159
ROM/RAM 領域の設定とセクション配置 ..........82
ROM/RAM 領域名 ..................................................86
ROM および RAM 領域の指定 ............................. 57
ROM 化支援 ............................................................ 57
ROM 領域の指定 (-ro) .......................................... 117
ROM → RAM 転送セクション ............................. 83
ROM → RAM 転送セクションの使用方法 ......... 83
ROM → RAM 転送セクションの注意 ................. 84
内蔵 ROM/RAM 領域自動設定の抑止指定 ......... 86
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) ......................................................138
内蔵 ROM/RAM 領域の自動設定 (-set_rora)
..........................................................................137
OS
OS による仕様の相違点 ......................................361
P
-p
パディング (-p) ......................................................257
-pl
リスト 1 ページの行数指定 (-pl) ................108, 223
-pw
リスト 1 行の桁数指定 (-pw) ...............................224
リスト行の桁数指定 (-pw) ...................................107
Q
Q&A
オブジェクト形式コンバータの使用上の Q&A
..........................................................................305
ライブラリファイルの作成に関する Q&A .......243
リンカの使用上の Q&A .......................................197
R
-r
相対形式ロードモジュールの出力指定 (-r) ........99
モジュールの置換 ( 登録 )(-r) ..............................217
-ra
RAM 領域の指定 (-ra) ..........................................118
RAM
RAM 領域の指定 (-ra) ..........................................118
ROM/RAM,ARRAY リスト .................................184
ROM/RAM,ARRAY リスト出力指定 (-alr) ........156
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................157
ROM/RAM,ARRAY リスト出力抑止指定 (-Xalr)
..........................................................................158
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ...............159
ROM/RAM 領域の設定とセクション配置 ..........82
ROM/RAM 領域名 ..................................................86
ROM および RAM 領域の指定 .............................57
ROM → RAM 転送セクション .............................83
ROM → RAM 転送セクションの使用方法 .........83
ROM → RAM 転送セクションの注意 .................84
内蔵 ROM/RAM 領域自動設定の抑止指定 .........86
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) .......................................................138
内蔵 ROM/RAM 領域の自動設定 (-set_rora)
..........................................................................137
-ran
出力範囲指定 (-ran) .......................278, 280, 289, 290
-rg
レジスタバンク領域の指定 (-rg) ........................123
-ro
ROM 領域の指定 (-ro) ..........................................117
ROM
ROM/RAM,ARRAY リスト .................................184
ROM/RAM,ARRAY リスト出力指定 (-alr) ........156
September 1, 2014, CM25-00321-5
S
S0 タイプ
S0 タイプ ( ヘッダレコード ) ............................. 346
S1 タイプ
S1 タイプ ( データレコード:2 バイトアドレス )
..........................................................................347
S2 タイプ
S2 タイプ ( データレコード:3 バイトアドレス )
..........................................................................348
S3 タイプ
S3 タイプ ( データレコード:4 バイトアドレス )
..........................................................................349
S5 タイプ
S5 タイプ ( レコード数管理レコード ) ............. 350
S7 タイプ
S7 タイプ ( ターミネータレコード ) ................. 351
S8 タイプ
S8 タイプ ( ターミネータレコード ) ................. 352
S9 タイプ
S9 タイプ ( ターミネータレコード ) ................. 353
-sc
セクション配置順 / アドレスの指定 (-sc) ......... 119
-set_rora
内蔵 ROM/RAM 領域の自動設定 (-set_rora)
..........................................................................137
-sl
ローカルシンボル情報リスト出力指定 (-sl)
..........................................................................164
-slf
ローカルシンボル情報リストファイル名の指定
(-slf) .................................................................. 165
-sp
スプリットモード指定 (-sp) ........................289, 292
-ST
開始アドレス変更指定 (-ST) ............................... 284
レコード開始アドレス変更指定 (-ST) ............... 278
S フォーマット
e2ms (HEX16 フォーマット
→ S フォーマット変換 ) ............................... 301
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ............................... 269
379
索引
Su pp or t
i2ms (HEX8 フォーマット
→ S フォーマット変換 ) ................................300
m2es (S フォーマット
→ HEX16 フォーマット変換 ) ......................299
m2is (S フォーマット
→ HEX8 フォーマット変換 ) ........................298
S フォーマットからアドレスを求めます .........365
出力 S フォーマット指定 (-S1/-S2/-S3)
..................................................................278, 281
S レコード
S レコード形式 .....................................................345
T
TMP
TMP( ワークディレクトリ ) ............................14, 15
V
-V
-V オプション .........................................................29
起動メッセージと -V オプション ..........................9
版数 / メッセージ出力指定 (-V) ............................35
W
-w
警告メッセージ出力レベルの指定 (-w) .............116
X
-x
モジュールの抽出 (-x) ..........................................219
-Xalr
ROM/RAM,ARRAY リスト出力抑止指定 (-Xalr)
..........................................................................158
-Xals
絶対アセンブルリスト出力抑止指定 (-Xals)
..........................................................................155
-Xb
バックアップファイルの作成抑止 (-Xb) ...........226
-Xcheck_locate
セクション配置領域チェック抑止指定
(-Xcheck_locate) ...............................................145
-Xcheck_rora
ユーザ指定領域のチェック抑止指定
(-Xcheck_rora) ..................................................141
380
So ft
Manu al
-Xcheck_section
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................148
-Xcmsg
-Xcmsg オプション ................................................. 29
終了メッセージ表示抑止指定 (-Xcmsg) ..............38
-Xcwno
-Xcwno オプション ................................................. 30
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno) .............................................................40
-Xdof
-Xdof オプション ....................................................29
デフォルトオプションファイル抑止指定 (-Xdof)
............................................................................31
-Xg
デバッグ情報の削除指定 (-Xg) ............................ 97
デバッグ情報の出力抑止指定 (-Xg) .................. 230
-xl
外部シンボル相互参照情報リスト出力指定 (-xl)
..........................................................................161
-xlf
外部シンボル相互参照情報リスト
ファイル名の指定 (-xlf) ................................. 162
-Xm
マップリスト出力の抑止指定 (-Xm) ................. 104
マップリストファイルの作成抑止指定 (-Xm)
..................................................................289, 296
リストファイルの出力抑止指定 (-Xm) ............. 221
-Xml
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................169
-Xobjmixchk
オブジェクト混在チェック抑止指定
(-Xobjmixchk) ..........................................150, 234
-Xset_rora
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) ......................................................138
-Xsl
ローカルシンボル情報リスト出力抑止指定
(-Xsl) ................................................................. 166
-Xsp
スプリットモード抑止指定 (-Xsp) .............289, 293
-XV
-XV オプション ......................................................29
版数 / メッセージ出力抑止 (-XV) ........................ 36
-Xxl
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................ 163
CM25-00321-5, September 1, 2014
索引
Support
Soft
Ma nual
あ
え
アジャスタ
バイナリコンバータ , アジャスタの制限事項
..........................................................................304
フォーマットアジャスタ .....................................250
フォーマットアジャスタのオプション一覧
..........................................................................277
フォーマットアジャスタの概要 .........................274
フォーマットアジャスタの機能 .........................275
アセンブルソースリスト
アセンブルソースリストの形式 .........................186
アセンブルリスト
アセンブルリスト内のエラーメッセージ .........182
絶対アセンブルリスト作成機能 .........................367
絶対アセンブルリスト出力指定 (-als) ...............153
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................152
絶対アセンブルリスト出力モジュール指定
(-alsf) .................................................................154
絶対アセンブルリスト出力抑止指定 (-Xals)
..........................................................................155
絶対アセンブルリストの形式 .............................181
絶対形式アセンブルリスト .................................172
絶対形式アセンブルリスト出力関連オプション
............................................................................93
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................151
アドレス
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ...............159
S1 タイプ ( データレコード:2 バイトアドレス )
..........................................................................347
S2 タイプ ( データレコード:3 バイトアドレス )
..........................................................................348
S3 タイプ ( データレコード:4 バイトアドレス )
..........................................................................349
S フォーマットからアドレスを求めます .........365
エントリアドレス / シンボル値の設定 ...............54
エントリアドレス指定 ...........................................59
エントリアドレスの指定 (-e) ..............................132
開始アドレス変更指定 (-ST) ...............................284
拡張セグメントアドレスレコード
(HEX16/HEX32) .............................................341
拡張リニアアドレスレコード (HEX32) .............343
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................342
スタートリニアアドレスレコード
(HEX32) ..........................................................344
セクションの配置順と配置アドレスの指定 .......57
セクション配置順 / アドレスの指定 (-sc) .........119
配置アドレスの決定方法 .................................68, 71
レコード開始アドレス変更指定 (-ST) ...............278
エラーメッセージ
アセンブルリスト内のエラーメッセージ ........182
コンバータのエラーメッセージ ........................ 332
ライブラリアンのエラーメッセージ ................ 325
リンカのエラーメッセージ ................................309
リンケージキットのエラーメッセージの
表示形式 .......................................................... 309
リンケージキットのエラーメッセージ分類 .... 308
エントリアドレス
エントリアドレス / シンボル値の設定 ............... 54
エントリアドレス指定 .......................................... 59
エントリアドレスの指定 (-e) ..............................132
エンドレコード
エンドレコード (HEX8/HEX16/HEX32) ............340
い
一般形式
一般形式 .................................................................338
September 1, 2014, CM25-00321-5
お
オブジェクト
オブジェクト形式コンバータのオプション一覧
..........................................................................360
オブジェクト形式コンバータの概要 ................ 248
オブジェクト形式コンバータの
共通オプションの種類 ..................................254
オブジェクト形式コンバータのコマンド一覧
..........................................................................359
オブジェクト形式コンバータのコマンド実行
..........................................................................252
オブジェクト形式コンバータの使用上の Q&
A ....................................................................... 305
オブジェクト形式コンバータの制限事項 ........304
オブジェクト混在チェック指定 (-objmixchk)
..................................................................149, 233
オブジェクト混在チェック抑止指定
(-Xobjmixchk) ..........................................150, 234
オブジェクト内容リスト出力関連オプション
............................................................................93
オブジェクトファイルフォーマット上の
制限事項 .......................................................... 196
入力オブジェクトファイルの指定 ...................... 55
ライブラリアンでのオブジェクト混在 ............209
リンカでのオブジェクト混在 ..............................87
オプション
-cmsg オプション ....................................................29
-cwno オプション ................................................... 29
-f オプション ...........................................................29
-help オプション ..................................................... 29
-V オプション ......................................................... 29
-Xcmsg オプション ................................................. 29
-Xcwno オプション ................................................. 30
-Xdof オプション ....................................................29
-XV オプション ......................................................29
オブジェクト形式コンバータのオプション一覧
..........................................................................360
オブジェクト形式コンバータの
共通オプションの種類 ..................................254
オブジェクト内容リスト出力関連オプション
............................................................................93
オプション一覧 ....................................................212
オプション形式 ......................................................22
381
索引
Su pp or t
オプション指定時の注意と評価 ...........................24
オプションの指定に関する注意 .........................242
オプションパラメータでの数値表現 ...................23
オプションファイル ...............................................42
オプションファイルからの読込み指定 (-f) ........32
オプションファイル指定による実行 ...................42
オプションファイル中の継続指定 .......................44
オプションファイル中のコメント指定 ...............45
オプションファイルの記述例 ...............................46
起動メッセージと -V オプション ..........................9
共通オプション一覧 ...............................................28
終了メッセージと -cmsg オプション ...................10
出力モジュールに関するオプション ...................93
出力リストに関するオプション ...................93, 214
絶対形式アセンブルリスト出力関連オプション
............................................................................93
相反関係にあるオプションの指定例 ...................25
その他のオプション .............................................214
その他のリンク制御オプション ...........................93
配置 / 結合オプション ...........................................93
バイナリコンバータのオプション一覧 .............288
ファイル検索 , 保護に関するオプション ..........214
フォーマットアジャスタのオプション一覧
..........................................................................277
包含関係にあるオプションの指定例 ...................25
ライブラリアンのオプション一覧 .....................357
ライブラリ制御オプション ...................................93
ライブラリの作成 , 編集に関するオプション
..........................................................................214
リンカのオプション一覧 ...............................90, 354
か
開始アドレス
開始アドレス変更指定 (-ST) ...............................284
レコード開始アドレス変更指定 (-ST) ...............278
外部シンボル
外部シンボル相互参照情報リスト .....................172
外部シンボル相互参照情報リスト出力指定 (-xl)
..........................................................................161
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................163
外部シンボル相互参照情報リストファイル
..........................................................................190
外部シンボル相互参照情報リスト
ファイル名の指定 (-xlf) .................................162
外部シンボル値の仮設定 (-df) ............................133
外部シンボル値の設定 ...........................................59
概要
オブジェクト形式コンバータの概要 .................248
バイナリコンバータの概要 .................................286
フォーマットアジャスタの概要 .........................274
リスト出力概要 .....................................237, 238, 239
リンカの概要 ...........................................................52
拡張セグメントアドレスレコード
拡張セグメントアドレスレコード
(HEX16/HEX32) .............................................341
拡張リニアアドレスレコード
拡張リニアアドレスレコード (HEX32) .............343
環境変数
環境変数 .........................................................368, 373
382
So ft
Manu al
緩和
制限事項の緩和 ....................................................372
き
起動メッセージ
起動メッセージ ........................................................9
起動メッセージと -V オプション .......................... 9
起動メッセージ表示の選択 ..................................56
強制終了
強制終了 .................................................................... 7
共通
オブジェクト形式コンバータの
共通オプションの種類 ..................................254
共通オプション一覧 .............................................. 28
く
クロスリファレンスリスト
クロスリファレンスリストの形式 .................... 189
け
警告
警告チェックレベルの選択 ..................................56
警告メッセージ出力レベルの指定 (-w) ............116
検索
LIB896( ライブラリファイル検索ディレクトリ )
............................................................................14
検索ライブラリの指定 .......................................... 74
検索ライブラリファイル指定 ..............................58
検索ライブラリファイルの指定 (-l) .................. 127
シンボルごとの検索ライブラリファイル指定
............................................................................58
デフォルトライブラリ検索の抑止指定 (-nd)
..........................................................................131
ファイル検索 , 保護に関するオプション ......... 214
ライブラリ検索の抑止 .......................................... 58
ライブラリ検索の抑止指定 (-nl) ........................ 130
ライブラリ検索パス指定 ...................................... 58
ライブラリ検索パスの指定 (-L) .........................128
ライブラリの検索に関する制御 .......................... 54
こ
コマンド
オブジェクト形式コンバータのコマンド一覧
..........................................................................359
オブジェクト形式コンバータのコマンド実行
..........................................................................252
コマンド行の差異 ........................................368, 373
コマンドラインの形式 ............................................ 5
コマンドラインの指定例 ...................................... 26
コメント
オプションファイル中のコメント指定 ..............45
コントロールリスト
コントロールリスト部の
リスト出力フォーマット ..............................174
コントロールリスト部のリスト表示例 ............175
CM25-00321-5, September 1, 2014
索引
Support
Soft
コンバータ
オブジェクト形式コンバータのオプション一覧
..........................................................................360
オブジェクト形式コンバータの概要 .................248
オブジェクト形式コンバータの
共通オプションの種類 ..................................254
オブジェクト形式コンバータのコマンド一覧
..........................................................................359
オブジェクト形式コンバータのコマンド実行
..........................................................................252
オブジェクト形式コンバータの使用上の Q&A
..........................................................................305
オブジェクト形式コンバータの制限事項 .........304
コンバータのエラーメッセージ .........................332
その他のコンバータの種類 .................................251
ロードモジュールコンバータの種類 .................250
さ
差異
コマンド行の差異 .........................................368, 373
データに差異が生じている場合 .........................365
最適化
ファイル内容の最適化 (-O) .................................228
し
識別子
識別子の区別 ...........................................................12
識別子の構成文字種 ...............................................12
識別子文字数の制限 ...............................................12
実施例
実施例 .....................................................................364
自動配置指定
自動配置指定 (-AL) ..............................................125
終了
終了コードの値と終了状態 .....................................8
終了メッセージ .......................................................10
終了メッセージと -cmsg オプション ...................10
終了メッセージ表示指定 (-cmsg) .........................37
終了メッセージ表示の選択 ...................................56
終了メッセージ表示抑止指定 (-Xcmsg) ..............38
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno) .............................................................40
ワーニング発生時の終了コードを 1 にする指定
(-cwno) ................................................................39
出力
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................157
警告メッセージ出力レベルの指定 (-w) .............116
コントロールリスト部のリスト
出力フォーマット ..........................................174
出力 HEX フォーマット指定 (-I16/-I20/-I32)
..................................................................278, 283
出力 S フォーマット指定 (-S1/-S2/-S3)
..................................................................278, 281
出力範囲指定 (-ran) .......................278, 280, 289, 290
出力ファイル名の変更 (-o) ..................................255
出力フォーマットの指定 .......................................55
出力メッセージに関する指定 ...............................93
出力モジュールに関するオプション ...................93
出力リストに関するオプション ...................93, 214
September 1, 2014, CM25-00321-5
Ma nual
出力レコードデータ長指定 (-len) ...................... 278
出力レコード内データ長指定 (-len) .................. 279
出力ロードモジュールファイル名指定 (-o) .......94
出力ロードモジュールファイル名の指定 ..........55
シンボルリスト部のリスト出力フォーマット
..........................................................................180
絶対アセンブルリスト出力ディレクトリ指定
(-alout) .............................................................. 152
絶対アセンブルリスト出力モジュール指定
(-alsf) ................................................................ 154
マップリスト出力の抑止指定 (-Xm) ................. 104
マップリスト部のリスト出力フォーマット
..........................................................................176
メモリ使用情報リスト部のリスト
出力フォーマット .......................................... 178
リスト出力概要 ....................................237, 238, 239
初期値付変数
初期値付変数の扱い ............................................ 198
シンボル
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ............... 159
エントリアドレス / シンボル値の設定 ............... 54
外部シンボル相互参照情報リスト .................... 172
外部シンボル相互参照情報リスト出力指定 (-xl)
..........................................................................161
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................ 163
外部シンボル相互参照情報リストファイル
..........................................................................190
外部シンボル相互参照情報リスト
ファイル名の指定 (-xlf) ................................. 162
外部シンボル値の仮設定 (-df) ............................133
外部シンボル値の設定 .......................................... 59
シンボルごとの検索ライブラリファイル指定
............................................................................58
シンボル個別のライブラリの指定 (-el) ............129
シンボルリスト部のリスト
出力フォーマット .......................................... 180
シンボルリスト部のリスト表示例 .................... 180
リンカの予約シンボル ........................................ 196
す
スタートセグメントアドレスレコード
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................342
スタートリニアアドレスレコード
スタートリニアアドレスレコード (HEX32)
..........................................................................344
スプリット
スプリットモード指定 (-sp) ........................289, 292
スプリットモードの概略 .................................... 287
スプリットモード抑止指定 (-Xsp) .............289, 293
せ
制限
オブジェクト形式コンバータの制限事項 ........304
オブジェクトファイルフォーマット上の
制限事項 .......................................................... 196
識別子文字数の制限 .............................................. 12
制限事項の緩和 ....................................................372
383
索引
Su pp or t
バイナリコンバータ , アジャスタの制限事項
..........................................................................304
ライブラリアンの制限事項 .................................242
リンカの制限事項 .................................................196
セクション
ROM/RAM 領域の設定とセクション配置 ..........82
ROM → RAM 転送セクション .............................83
ROM → RAM 転送セクションの使用方法 .........83
ROM → RAM 転送セクションの注意 .................84
セクショングループの指定 (-gr) ........................122
セクショングループの指定がある場合の配置例
............................................................................66
セクション種別と配置先 .......................................71
セクション詳細マップリスト .............................172
セクション詳細マップリスト出力指定 (-ml)
..........................................................................167
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................169
セクション詳細マップリストファイル名の指定
(-mlf) .................................................................168
セクション情報リストの形式 .............................188
セクション内容種別 ...............................................60
セクションの共有結合 ...........................................62
セクションのグループ化 .......................................57
セクションの結合 / 配置に関する制御 ...............54
セクションの結合順序が指定された場合の
配置例 ................................................................65
セクションの結合順序が
指定されなかった場合の配置例 ....................64
セクションの結合属性 ...........................................61
セクションの識別 ...................................................61
セクションの自動配置 ...........................................67
セクションの単純連結結合 ...................................62
セクションの配置順と配置アドレスの指定 .......57
セクションの配置属性 ...........................................60
セクションのリンク ...............................................63
セクション配置順 / アドレスの指定 (-sc) .........119
セクション配置詳細情報リストファイル .........192
セクション配置領域チェック指定 (-check_locate)
..........................................................................142
セクション配置領域チェック抑止指定
(-Xcheck_locate) ...............................................145
セクション名 ...........................................................60
ユーザ指定外セクションのチェック指定
(-check_section) ................................................146
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................148
絶対アセンブルリスト
絶対アセンブルリスト作成機能 .........................367
絶対アセンブルリスト出力指定 (-als) ...............153
絶対アセンブルリスト出力ディレクトリ指定
(-alout) ..............................................................152
絶対アセンブルリスト出力モジュール指定
(-alsf) .................................................................154
絶対アセンブルリスト出力抑止指定 (-Xals)
..........................................................................155
絶対アセンブルリストの形式 .............................181
絶対形式ロードモジュール
f2es ( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................272
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................270
384
So ft
Manu al
f2is ( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................ 271
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ............................... 269
絶対形式ロードモジュールの出力指定 (-a) ........ 98
そ
相対
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................ 151
相対形式ロードモジュールの出力指定 (-r) ........ 99
相反関係
相反関係にあるオプションの指定例 .................. 25
その他
その他のオプション ............................................ 214
その他のコンバータの種類 ................................251
その他のリンク制御オプション .......................... 93
た
ターゲット
ターゲット CPU 指定 (-cpu) ........................134, 231
ターミネータレコード
S7 タイプ ( ターミネータレコード ) ................. 351
S8 タイプ ( ターミネータレコード ) ................. 352
S9 タイプ ( ターミネータレコード ) ................. 353
ち
注意
ROM → RAM 転送セクションの注意 ................. 84
オプション指定時の注意と評価 .......................... 24
オプションの指定に関する注意 ........................ 242
必要なディスク容量についての注意 ................ 242
て
ディレクトリ
LIB896( ライブラリファイル検索ディレクトリ )
............................................................................14
OPT( デフォルトオプションファイル
格納ディレクトリ ) .......................................... 14
OPT896( デフォルトオプションファイル
格納ディレクトリ ) .......................................... 14
絶対アセンブルリスト出力ディレクトリ指定
(-alout) .............................................................. 152
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................ 151
データ
S1 タイプ ( データレコード:2 バイトアドレス )
..........................................................................347
S2 タイプ ( データレコード:3 バイトアドレス )
..........................................................................348
S3 タイプ ( データレコード:4 バイトアドレス )
..........................................................................349
出力レコードデータ長指定 (-len) ...................... 278
出力レコード内データ長指定 (-len) .................. 279
データに差異が生じている場合 ........................ 365
データレコード (HEX8/HEX16/HEX32) ............339
CM25-00321-5, September 1, 2014
索引
Support
Soft
デバッグ
デバッグ情報存在チェック抑止指定
(-NCI0302LIB) .................................................136
デバッグ情報の継承 ...............................................55
デバッグ情報の削除 .....................................203, 207
デバッグ情報の削除指定 (-Xg) .............................97
デバッグ情報の出力指定 (-g) ........................96, 229
デバッグ情報の出力抑止指定 (-Xg) ...................230
デフォルトオプションファイル
OPT( デフォルトオプションファイル
格納ディレクトリ ) ..........................................14
OPT896( デフォルトオプションファイル
格納ディレクトリ ) ..........................................14
デフォルトオプションファイル ...........................47
デフォルトオプションファイル抑止指定 (-Xdof)
............................................................................31
デフォルトライブラリ
デフォルトライブラリ検索の抑止指定 (-nd)
..........................................................................131
転送
ROM → RAM 転送セクション .............................83
ROM → RAM 転送セクションの使用方法 .........83
ROM → RAM 転送セクションの注意 .................84
と
動作例
動作例 .....................................................................275
な
内蔵 ROM/RAM
内蔵 ROM/RAM 領域自動設定の抑止指定 .........86
内蔵 ROM/RAM 領域自動設定の抑止指定
(-Xset_rora) .......................................................138
内蔵 ROM/RAM 領域の自動設定 (-set_rora)
..........................................................................137
に
入出力
入出力ファイル / メッセージに関する制御 .......53
入力
相対アセンブルリスト入力ディレクトリ指定
(-alin) ................................................................151
入力オブジェクトファイルの指定 .......................55
は
配置
ROM/RAM 領域の設定とセクション配置 ..........82
セクションの結合 / 配置に関する制御 ...............54
セクションの配置順と配置アドレスの指定 .......57
配置 / 結合オプション ...........................................93
配置アドレスの決定方法 .................................68, 71
バイナリコンバータ
バイナリコンバータ .............................................250
バイナリコンバータ , アジャスタの制限事項
..........................................................................304
バイナリコンバータのオプション一覧 .............288
バイナリコンバータの概要 .................................286
September 1, 2014, CM25-00321-5
Ma nual
はじめに
はじめに ................................................................ 367
バックアップファイル
バックアップファイルの作成 (-b) .....................225
バックアップファイルの作成抑止 (-Xb) ..........226
パディング
パディング (-p) ..................................................... 257
パラメータ
パラメータ .............................................................. 22
版数
版数 / メッセージ出力指定 (-V) ...........................35
版数 / メッセージ出力抑止 (-XV) ........................ 36
ひ
比較手順
比較手順の概略 ....................................................363
必要なディスク容量
必要なディスク容量についての注意 ................ 242
ふ
ファイル
CPU 情報ファイル ..................................................86
CPU 情報ファイル名 .............................................. 86
出力ファイル名の変更 (-o) ................................. 255
出力ロードモジュールファイル名指定 (-o) .......94
出力ロードモジュールファイル名の指定 ..........55
入出力ファイル / メッセージに関する制御 .......53
ファイル検索 , 保護に関するオプション ......... 214
ファイル内容の最適化 (-O) ................................228
ファイル名の文字コード ...................................... 13
ファイル名の文字数 .............................................. 13
フォーマット
e2ms (HEX16 フォーマット
→ S フォーマット変換 ) ............................... 301
f2es ( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ...................... 272
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) .......................... 270
f2is ( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................ 271
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ............................... 269
HEX フォーマット ............................................... 337
i2ms (HEX8 フォーマット
→ S フォーマット変換 ) ............................... 300
m2es (S フォーマット
→ HEX16 フォーマット変換 ) ...................... 299
m2is (S フォーマット
→ HEX8 フォーマット変換 ) ........................ 298
S フォーマットからアドレスを求めます ......... 365
オブジェクトファイルフォーマット上の
制限事項 .......................................................... 196
コントロールリスト部のリスト
出力フォーマット .......................................... 174
出力 HEX フォーマット指定 (-I16/-I20/-I32)
..................................................................278, 283
出力 S フォーマット指定 (-S1/-S2/-S3) ......278, 281
出力フォーマットの指定 ...................................... 55
シンボルリスト部のリスト出力フォーマット
..........................................................................180
385
索引
Su pp or t
フォーマットアジャスタ .....................................250
フォーマットアジャスタのオプション一覧
..........................................................................277
フォーマットアジャスタの概要 .........................274
フォーマットアジャスタの機能 .........................275
マップリスト部のリスト出力フォーマット
..........................................................................176
メモリ使用情報リスト部のリスト
出力フォーマット ..........................................178
へ
ヘッダ
S0 タイプ ( ヘッダレコード ) ..............................346
ヘッダ形式 .............................................................183
ヘルプメッセージ
ヘルプメッセージ ...................................................11
ヘルプメッセージの表示 (-help) ...........................34
ほ
包含関係
包含関係にあるオプションの指定例 ...................25
ポート
リンケージキットのサポート範囲 .........................4
ま
マップリスト
セクション詳細マップリスト .............................172
セクション詳細マップリスト出力指定 (-ml)
..........................................................................167
セクション詳細マップリスト出力抑止指定
(-Xml) ...............................................................169
セクション詳細マップリストファイル名の指定
(-mlf) .................................................................168
マップリスト出力の抑止指定 (-Xm) ..................104
マップリストファイルの作成指定 (-m)
..................................................................289, 294
マップリストファイルの作成抑止指定 (-Xm)
..................................................................289, 296
マップリストファイル名の指定 (-m) ................103
マップリスト部のリスト出力フォーマット .....176
マップリスト部のリスト表示例 .........................177
め
メッセージ
アセンブルリスト内のエラーメッセージ .........182
起動メッセージ .........................................................9
起動メッセージと -V オプション ..........................9
起動メッセージ表示の選択 ...................................56
警告メッセージ出力レベルの指定 (-w) .............116
コンバータのエラーメッセージ .........................332
終了メッセージ .......................................................10
終了メッセージと -cmsg オプション ...................10
終了メッセージ表示指定 (-cmsg) .........................37
終了メッセージ表示の選択 ...................................56
終了メッセージ表示抑止指定 (-Xcmsg) ..............38
出力メッセージに関する指定 ...............................93
386
So ft
Manu al
入出力ファイル / メッセージに関する制御 .......53
版数 / メッセージ出力指定 (-V) ...........................35
版数 / メッセージ出力抑止 (-XV) ........................ 36
ライブラリアンのエラーメッセージ ................ 325
リンカのエラーメッセージ ................................309
リンケージキットのエラーメッセージの
表示形式 .......................................................... 309
リンケージキットのエラーメッセージ分類 .... 308
メモリ
メモリ使用情報リストの出力指定 (-mmi) ........106
メモリ使用情報リスト部のリスト
出力フォーマット .......................................... 178
メモリ使用情報リスト部のリスト表示例 ........179
も
モード
スプリットモード指定 (-sp) ........................289, 292
スプリットモードの概略 .................................... 287
スプリットモード抑止指定 (-Xsp) .............289, 293
モジュール
f2es ( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ...................... 272
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) .......................... 270
f2is ( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................ 271
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ............................... 269
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) ................................................................. 157
出力モジュールに関するオプション .................. 93
出力ロードモジュールファイル名指定 (-o) .......94
出力ロードモジュールファイル名の指定 ..........55
絶対アセンブルリスト出力モジュール指定
(-alsf) ................................................................ 154
絶対形式ロードモジュールの出力指定 (-a) ........ 98
相対形式ロードモジュールの出力指定 (-r) ........ 99
モジュールの削除 (-d) .........................................218
モジュールの置換 ( 登録 )(-r) ............................. 217
モジュールの抽出 (-x) .........................................219
モジュールの追加 ( 登録 )(-a) ............................. 215
ライブラリファイル内のモジュール抽出
..................................................................203, 206
リンクマップを使った問題モジュールの特定
..........................................................................366
ロードモジュールコンバータの種類 ................ 250
問題個所
問題個所の特定 ....................................................366
問題モジュール
リンクマップを使った問題モジュールの特定
..........................................................................366
ゆ
ユーザ
ユーザ指定外セクションのチェック指定
(-check_section) ............................................... 146
ユーザ指定外セクションのチェック抑止指定
(-Xcheck_section) .............................................148
ユーザ指定領域のチェック指定 (-check_rora)
..........................................................................139
CM25-00321-5, September 1, 2014
索引
Support
Soft
ユーザ指定領域のチェック抑止指定
(-Xcheck_rora) ..................................................141
ら
ライブラリ
LIB896( ライブラリファイル検索ディレクトリ )
............................................................................14
検索ライブラリの指定 ...........................................74
検索ライブラリファイル指定 ...............................58
検索ライブラリファイルの指定 (-l) ..................127
シンボルごとの検索ライブラリファイル指定
............................................................................58
シンボル個別のライブラリの指定 (-el) .............129
ライブラリ検索の抑止 ...........................................58
ライブラリ検索の抑止指定 (-nl) ........................130
ライブラリ検索パス指定 .......................................58
ライブラリ検索パスの指定 (-L) .........................128
ライブラリ制御オプション ...................................93
ライブラリの検索に関する制御 ...........................54
ライブラリの作成 , 編集に関するオプション
..........................................................................214
ライブラリファイル内のモジュール抽出
..................................................................203, 206
ライブラリファイルが 1 つの場合の検索例 1
............................................................................76
ライブラリファイルが 1 つの場合の検索例 2
............................................................................77
ライブラリファイルが 1 つの場合の検索例 3
............................................................................78
ライブラリファイルが個別に
指定された場合の処理 ....................................81
ライブラリファイルが複数の場合の検索例 1
............................................................................79
ライブラリファイルが複数の場合の検索例 2
............................................................................80
ライブラリファイルの検索順序 ...........................75
ライブラリファイルの作成に関する Q&A .......243
ライブラリファイルの新規作成 .................203, 204
ライブラリファイルの内容検査 (-c) ..................227
ライブラリファイルの内容チェック .........203, 208
ライブラリファイルの内容表示 .................203, 208
ライブラリファイルの編集 .........................203, 204
ライブラリアン
ライブラリアンでのオブジェクト混在 .............209
ライブラリアンのエラーメッセージ .................325
ライブラリアンのオプション一覧 .....................357
ライブラリアンの制限事項 .................................242
ライブラリアンの役割 .........................................202
り
リスト
ROM/RAM,ARRAY リスト .................................184
ROM/RAM,ARRAY リスト出力指定 (-alr) ........156
ROM/RAM,ARRAY リスト出力モジュール指定
(-alrf) .................................................................157
ROM/RAM,ARRAY リスト出力抑止指定 (-Xalr)
..........................................................................158
ROM/RAM,ARRAY リストのシンボルと
アドレスの表示位置指定 (-na,-an) ...............159
September 1, 2014, CM25-00321-5
Ma nual
オブジェクト内容リスト出力関連オプション
............................................................................93
外部シンボル相互参照情報リスト .................... 172
外部シンボル相互参照情報リスト出力指定
(-xl) ................................................................... 161
外部シンボル相互参照情報リスト出力抑止指定
(-Xxl) ................................................................ 163
外部シンボル相互参照情報リストファイル
..........................................................................190
外部シンボル相互参照情報リスト
ファイル名の指定 (-xlf) ................................. 162
コントロールリスト部のリスト
出力フォーマット .......................................... 174
コントロールリスト部のリスト表示例 ............175
出力リストに関するオプション ..................93, 214
シンボルリスト部のリスト出力フォーマット
..........................................................................180
シンボルリスト部のリスト表示例 .................... 180
セクション情報リストの形式 ............................188
セクション配置詳細情報リストファイル ........192
マップリスト部のリスト出力フォーマット
..........................................................................176
マップリスト部のリスト表示例 ........................ 177
メモリ使用情報リストの出力指定 (-mmi) ........106
メモリ使用情報リスト部のリスト
出力フォーマット .......................................... 178
メモリ使用情報リスト部のリスト表示例 ........179
リスト 1 行の桁数指定 (-pw) ..............................224
リスト 1 ページの行数指定 (-pl) ................108, 223
リスト行の桁数指定 (-pw) ..................................107
リスト出力概要 ....................................237, 238, 239
リスト出力時の識別名表示 ..................................12
リスト表示の名前の省略解除 (-dt) .................... 105
リストファイルの形式変更 ..................................55
リストファイルの構成 ........................................ 236
リストファイルの出力指定 (-m) ........................ 220
リストファイルの出力抑止指定 (-Xm) ............. 221
リストファイルの詳細情報の出力指定 (-dt)
..........................................................................222
リストファイル名の指定 ...................................... 55
ローカルシンボル情報リスト ............................172
ローカルシンボル情報リスト出力指定 (-sl) .....164
ローカルシンボル情報リスト出力抑止指定 (-Xsl)
..........................................................................166
ローカルシンボル情報リストファイル ............191
ローカルシンボル情報リストファイル名の指定
(-slf) .................................................................. 165
リンカ
リンカでのオブジェクト混在 ..............................87
リンカのエラーメッセージ ................................309
リンカのオプション一覧 ..............................90, 354
リンカの概要 .......................................................... 52
リンカの使用上の Q&A ...................................... 197
リンカの制限事項 ................................................196
リンカの予約シンボル ........................................ 196
リンクマップ
リンクマップを使った問題モジュールの特定
..........................................................................366
リンクリストファイル
リンクリストファイル ........................................ 172
リンクリストファイルの構成 ............................173
387
索引
Su pp or t
リンケージキット
リンケージキットのエラーメッセージの
表示形式 ..........................................................309
リンケージキットのエラーメッセージ分類 .....308
リンケージキットのサポート範囲 .........................4
れ
レコード
S0 タイプ ( ヘッダレコード ) ..............................346
S1 タイプ ( データレコード:2 バイトアドレス )
..........................................................................347
S2 タイプ ( データレコード:3 バイトアドレス )
..........................................................................348
S3 タイプ ( データレコード:4 バイトアドレス )
..........................................................................349
S5 タイプ ( レコード数管理レコード ) ..............350
S7 タイプ ( ターミネータレコード ) ..................351
S8 タイプ ( ターミネータレコード ) ..................352
S9 タイプ ( ターミネータレコード ) ..................353
S レコード形式 .....................................................345
エンドレコード (HEX8/HEX16/HEX32) ............340
拡張セグメントアドレスレコード
(HEX16/HEX32) ..............................................341
拡張リニアアドレスレコード (HEX32) .............343
出力レコードデータ長指定 (-len) .......................278
出力レコード内データ長指定 (-len) ...................279
スタートセグメントアドレスレコード
(HEX16/HEX32) .............................................342
スタートリニアアドレスレコード (HEX32)
..........................................................................344
データレコード (HEX8/HEX16/HEX32) ............339
レコード開始アドレス変更指定 (-ST) ...............278
レジスタバンク
レジスタバンク領域の指定 (-rg) ........................123
So ft
Manu al
わ
ワークディレクトリ
TMP( ワークディレクトリ ) ........................... 14, 15
ワーニング
ワーニング発生時の終了コードを 0 にする指定
(-Xcwno) .............................................................40
ワーニング発生時の終了コードを 1 にする指定
(-cwno) ...............................................................39
ろ
ローカルシンボル
ローカルシンボル情報リスト .............................172
ローカルシンボル情報リスト出力指定 (-sl) .....164
ローカルシンボル情報リスト出力抑止指定 (-Xsl)
..........................................................................166
ローカルシンボル情報リストファイル .............191
ローカルシンボル情報リストファイル名の
指定 (-slf) .........................................................165
ロードモジュール
f2es ( 絶対形式ロードモジュール
→ HEX16 フォーマット変換 ) ......................272
f2hs( 絶対形式ロードモジュール
→ HEX フォーマット変換 ) ..........................270
f2is ( 絶対形式ロードモジュール
→ HEX8 フォーマット変換 ) ........................271
f2ms( 絶対形式ロードモジュール
→ S フォーマット変換 ) ................................269
出力ロードモジュールファイル名指定 (-o) ........94
出力ロードモジュールファイル名の指定 ...........55
絶対形式ロードモジュールの出力指定 (-a) ........98
相対形式ロードモジュールの出力指定 (-r) ........99
ロードモジュールコンバータの種類 .................250
388
CM25-00321-5, September 1, 2014
Support
Soft
Ma nual
奥付
CM25-00321-5
Spansion • SOFTWARE SUPPORT MANUAL
F2MC®-8L/8FX ファミリ
SOFTUNE® リンケージキットマニュアル
V3 対応
2014 年 9 月 Rev. 5.0
発行
Spansion Inc.
編集
コーポレートコミュニケーション部
September 1, 2014, CM25-00321-5
389
Su pp or t
So ft
Manu al
免責事項
本資料に記載された製品は、通常の産業用 , 一般事務用 , パーソナル用 , 家庭用などの一般的用途 ( ただし、用途の限定はあ
りません ) に使用されることを意図して設計・製造されています。(1) 極めて高度な安全性が要求され、仮に当該安全性が
確保されない場合、社会的に重大な影響を与えかつ直接生命・身体に対する重大な危険性を伴う用途 ( 原子力施設における
核反応制御 , 航空機自動飛行制御 , 航空交通管制 , 大量輸送システムにおける運行制御 , 生命維持のための医療機器 , 兵器シ
ステムにおけるミサイル発射制御等をいう ) 、ならびに (2) 極めて高い信頼性が要求される用途 ( 海底中継器 , 宇宙衛星等を
いう ) に使用されるよう設計・製造されたものではありません。上記の製品の使用法によって惹起されたいかなる請求また
は損害についても、Spansion は、お客様または第三者、あるいはその両方に対して責任を一切負いません。半導体デバイス
はある確率で故障が発生します。当社半導体デバイスが故障しても、結果的に人身事故 , 火災事故 , 社会的な損害を生じさ
せないよう、お客様において、装置の冗長設計 , 延焼対策設計 , 過電流防止対策設計 , 誤動作防止設計などの安全設計をお
願いします。本資料に記載された製品が、外国為替及び外国貿易法、米国輸出管理関連法規などの規制に基づき規制され
ている製品または技術に該当する場合には、本製品の輸出に際して、同法に基づく許可が必要となります。
商標および注記
このドキュメントは、断りなく変更される場合があります。本資料には Spansion が開発中の Spansion 製品に関する情報が
記載されている場合があります。Spansion は、それらの製品に対し、予告なしに仕様を変更したり、開発を中止したりする
権利を有します。このドキュメントに含まれる情報は、現状のまま、保証なしに提供されるものであり、その正確性 , 完全
性 , 実施可能性および特定の目的に対する適合性やその市場性および他者の権利を侵害しない事を保証するものでなく、ま
た、明示 , 黙示または法定されているあらゆる保証をするものでもありません。Spansion は、このドキュメントに含まれる
情報を使用することにより発生したいかなる損害に対しても責任を一切負いません。
Copyright © 2004 - 2014 Spansion All rights reserved.
商標:Spansion®, Spansion ロゴ ( 図形マーク ), MirrorBit®, MirrorBit® EclipseTM, ORNANDTM 及びこれらの組合せは、米国・
日本ほか諸外国における Spansion LLC の商標です。第三者の社名・製品名等の記載はここでは情報提供を目的として表記
したものであり、各権利者の商標もしくは登録商標となっている場合があります。
390
CM25-00321-5, September 1, 2014