realview compilation tools...

RealView® Compilation Toolsバージョン 4.0

エッセンシャルガイド

Copyright © 2002-2008 ARM Limited. All rights reserved.ARM DUI 0202IJ

RealView Compilation Toolsエッセンシャルガイド

Copyright © 2002-2008 ARM Limited. All rights reserved.

リリース情報

本書には以下の変更が加えられています。

著作権

® または ™ のマークが付いた言葉およびロゴは、この著作権情報で別段に規定されている場合を

除き、 ARM Limited の EU またはその他の国における登録商標および商標です。本書に記載され

ている他の製品名は、各社の所有する商標です。

本書に記載されている情報の全部または一部、ならびに本書で紹介する製品は、著作権所有者の

文書による事前の許可を得ない限り、転用・複製することを禁じます。

本書に記載されている製品は、今後も継続的に開発・改良の対象となります。本書に含まれる製

品およびその利用方法についての情報は、 ARM が利用者の利益のために提供するものです。し

たがって当社では、製品の市販性または利用の適切性を含め、暗示的・明示的に関係なく一切の

責任を負いません。

本書は、本製品の利用者をサポートすることだけを目的としています。本書に記載されている情

報の使用、情報の誤りまたは省略、あるいは本製品の誤使用によって発生したいかなる損失・損

傷についても、 ARM Limited は一切責任を負いません。

ARM という用語が使用されている場合、 “ARM または必要に応じてその子会社” を指します。

変更履歴

日付発行機密保持ステータス変更

2002 年 8 月 A 非機密扱い第 1.2 版

2003 年 1 月 B 非機密扱い第 2.0 版

2003 年 9 月 C 非機密扱い RealView Developer Suite 向けリリース 2.0.1

2004 年 1 月 D 非機密扱い RealView Developer Suite 向けリリース 2.1

2004 年 12 月 E 非機密扱い RealView Developer Suite 向けリリース 2.2

2005 年 5 月 F 非機密扱い RealView Developer Suite 向けリリース 2.2SP1

2006 年 3 月 G 非機密扱い RealView Development Suite 向けリリース 3.0

2007 年 3 月 H 非機密扱い RealView Development Suite 向けリリース 3.1

2008 年 9 月 I 非機密扱い RealView Development Suite v4.0 向けリリース 4.0

ii Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential

機密保持ステータス

本書は非機密扱いであり、本書を使用、複製、および開示する権利は、 ARM および ARM が本書

を提供した当事者との間で締結した契約の条項に基づいたライセンスの制限により異なります。

アクセス制限は、 ARM 社内による分類です。

製品ステータス

本書の情報は終版であり、開発済み製品に対応しています。

Web アドレス

http://www.arm.com

ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. iiiNon-Confidential

目次RealView Compilation Toolsエッセンシャルガイド

序章本書について ............................................................................................... viiiフィードバック ............................................................................................. xii

第 1 章はじめに1.1 RealView Compilation Tools について ........................................................ 1-21.2 RVCT で使用する環境変数 ......................................................................... 1-71.3 追加の詳細情報 ........................................................................................... 1-9

第 2 章アプリケーションの作成2.1 ARM Compilation Tools の使用 .................................................................. 2-22.2 ARM コンパイラの使用 .............................................................................. 2-32.3 ARM リンカの使用 ..................................................................................... 2-72.4 ARM アセンブラの使用 .............................................................................. 2-82.5 fromelf ユーティリティの使用 .................................................................... 2-92.6 ARM Workbench IDE の使用 .................................................................... 2-10

第 3 章 RVCT v4.0 と RVCT v3.1 の相違点3.1 RealView Compilation Tools v4.0 の概要 .................................................... 3-23.2 RVCT v4.0 のドキュメントの変更点 .......................................................... 3-3

ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. vNon-Confidential

3.3 RVCT v4.0 における ARM コンパイラの変更点 ........................................ 3-43.4 RVCT v4.0 におけるライブラリサポートの変更点 .................................... 3-73.5 RVCT v4.0 における ARM リンカの変更点 ............................................... 3-83.6 RVCT v4.0 における ARM アセンブラの変更点 ........................................ 3-93.7 RVCT v4.0 における fromelf ユーティリティの変更点 ............................ 3-103.8 RVCT v4.0 での使用が制限される機能 .................................................... 3-123.9 RVCT v4.0 で廃止された機能 .................................................................. 3-133.10 RVCT v4.0 と従来のオブジェクトおよびライブラリとの互換性 ............ 3-14

付録 A 以前のリリースについてA.1 RVCT v3.1 と RVCT v3.0 の相違点 ........................................................... A-2A.2 RVCT v3.0 と RVCT v2.2 の相違点 ......................................................... A-12A.3 RVCT v2.2 SP1 と RVCT v2.2 の相違点 .................................................. A-24A.4 RVCT v2.2 と RVCT v2.1 の相違点 ......................................................... A-26A.5 RVCT v2.1 と RVCT v2.0 の相違点 ......................................................... A-39A.6 RVCT v2.0 と RVCT v1.2 の相違点 ......................................................... A-44

vi Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential

序章

本章では、『RealView Compilation Tools エッセンシャルガイド』について概説

します。以下のセクションから構成されています。

• 「本書について」（ページ viii）

• 「フィードバック」（ページ xii）

ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. viiNon-Confidential

序章

本書について

本書では、 ARM® RealView® Compilation Tools （RVCT）の概要について説明し

ます。

対象読者

本書は、 RVCT を使用してアプリケーションを作成している開発者を対象と

しています。したがって、本書の内容は、経験豊富なソフトウェア開発者を想定して記述されています。

本書の構成

本書は以下の章と付録から構成されています。

第 1 章はじめに

RVCT の概要について説明します。 RVCT のコンポーネントとそ

のオンラインマニュアルを紹介します。

第 2 章アプリケーションの作成

RVCT を使用したアプリケーションの作成方法の概要について説

明します。

第 3 章 RVCT v4.0 と RVCT v3.1 の相違点

新のリリースの RVCT と以前のリリースの RVCT との相違点

について説明します。

付録 A 以前のリリースについて

この付録では、以前のリリースの RVCT 間の相違点について説

明します。

本書では、 ARM ソフトウェアがデフォルトの場所にインストールされている

ことを前提としています。例えば、 Windows 環境では、デフォルトの場所は volume:\Program Files\ARM になります。パス名を参照する際、 install_directory の部分をこの場所に読み替えて下さい。例えば、本書では、install_directory\Documentation\... のようなパス名が使用されます。 ARM ソフトウェアを別の場所にインストールした場合は、ファイルパスの見方を変える必要があります。

viii Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential

序章

表記規則

本書では以下の表記規則を使用しています。

italic 重要事項、重要用語、相互参照、引用箇所を斜体で記載し

ています。

bold メニュー名などのユーザインタフェース要素を太字で記載

しています。また、必要に応じて記述リスト内の重要箇所、 ARM プロセッサの信号名、重要用語、および専門用

語にも太字を使用しています。

monospace コマンド、ファイル名、プログラム名、ソースコードな

ど、キーボードから入力可能なテキストを示しています。

monospace コマンドまたはオプションに使用可能な略語を示します。

コマンド名またはオプション名をすべて入力する代わりに、下線部分の文字だけを入力することができます。

monospace italic コマンドまたは関数の引数で、特定の値に置き換えること

が可能なものを示しています。

monospace bold サンプルコード以外に使用される言語キーワードを示して

います。

参考資料

このセクションでは、 ARM プロセッサファミリのコード開発関連情報を提供

している ARM Limited の出版物を紹介します。

ARM Limited は自社出版物の定期的な更新・修正を行っています。新の正

誤表、追補表、および ARM に関する FAQ については、

http://infocenter.arm.com/help/index.jsp をご覧下さい。

ARM の出版物

本書では、 RVCT の概要について説明します。このほか、本製品には以下の

マニュアルが同梱されています。

• 『RealView Compilation Tools コンパイラユーザガイド』（ARM DUI 0205）。本書では、 ARM コンパイラ armcc の基本関数とコンパイラ固有の機能に

ついて説明しています。また、 NEON™ ベクトル化コンパイラと、自動

ベクトル化機能の使用方法についても説明しています。

ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. ixNon-Confidential

序章

• 『RealView Compilation Tools コンパイラリファレンスガイド』（ARM DUI 0348）。本書には、 ARM コンパイラの参照情報とコマンドラインオプ

ションの説明が記載されています。また、 ARM コンパイラにおける C や C++ の実装についても説明しています。

• 『RealView Compilation Tools ライブラリ / 浮動小数点サポートガイド』

（ARM DUI 0349）。本書では、ARM の C ライブラリおよび C++ ライブラ

リ、 ISO 標準への準拠、ターゲット依存関数のカスタマイズ、およびア

プリケーション固有の要件について説明します。また、 ARM における

浮動小数点演算のサポートについても説明します。

• 『RealView Compilation Tools アセンブラガイド』（ARM DUI 0204）。本書

には、 ARM アセンブラ armasm についての参照およびチュートリアル情

報が記載されています。

• 『RealView Compilation Tools リンカユーザガイド』（ARM DUI 0206）。本

書には、 ARM リンカ armlink に関するユーザ情報が記載されています。

また、スキャッタロードについても概説します。

• 『RealView Compilation Tools リンカリファレンスガイド』（ARM DUI 0381）。本書には、コマンドラインオプションとステアリングファイル

の参照情報が記載されています。また、 ARM アーキテクチャ用ベース

プラットフォーム ABI （BPABI）と System V 共有ライブラリおよび実行

可能ファイルについても説明されています。

• 『RealView Compilation Tools ユーティリティガイド』（ARM DUI 0382）。本書には、 ARM ライブラリアン armar および ARM イメージ変換ユー

ティリティ fromelf のコマンドラインオプションと実用サンプルが記載

されています。

• 『RealView Compilation Tools デベロッパガイド』（ARM DUI 0203）。本書

では、 ARM ファミリのプロセッサをターゲットとしたコードの記述に

関するチュートリアル情報を提供しています。

• 『ARM Workbench IDE ユーザガイド』（ARM DUI 0330）では、統合開発環

境（IDE）を使用して ARM ターゲット用のプロジェクトを設定および

ビルドする方法について説明します。

準拠する基本標準、ソフトウェアインタフェース、および ARM でサポート

されている標準に関する詳細については、install_directory\Documentation\Specifications\... を参照して下さい。

x Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential

序章

特定の ARM 製品に関する情報については、以下のマニュアルを参照して下

さい。

• 『ARM アーキテクチャリファレンスマニュアル』（ARMv7-A および ARMv7-R エディション）（ARM DDI 0406）

• 『ARM7-M アーキテクチャリファレンスマニュアル』（ARM DDI 0403）

• 『ARM6-M アーキテクチャリファレンスマニュアル』（ARM DDI 0419）

• 『ARM アーキテクチャリファレンスマニュアル』（ARM DDI 0100）

• お使いのハードウェアデバイスの ARM データシートまたはテクニカル

リファレンスマニュアル

ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. xiNon-Confidential

序章

フィードバック

ARM Limited では RealView Compilation Tools および本書に関するフィード

バックをお待ちしております。

RealView Compilation Tools に関するフィードバック

RVCT に関して問題がある場合は、購入元にお問い合わせ下さい。このとき、

迅速かつ適切な対応をさせて頂くために、以下の情報をご用意下さい。

• お名前と会社名

• 製品のシリアル番号

• 使用しているリリースのバージョン番号や日付など、ツールのバージョン文字列

• プラットフォームの詳細（ハードウェアプラットフォーム、オペレーティングシステムの種類とバージョンなど）

• 問題を再現するサイズの小さな独立したサンプルコード

• 操作の目的と実際の動作に関する詳しい説明

• 使用したコマンド（コマンドラインオプションを含む）

• 問題を例示するサンプル出力

本書に関するフィードバック

本書に関するご意見につきましては、以下の内容を記載した電子メールを [email protected] までお送り下さい。

• マニュアル名

• 文書番号

• 問題のあるページ番号

• 問題点の簡潔な説明

補足すべき点や改善すべき点についてのご提案もお待ちしております。

xii Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential

第 1 章はじめに

本章では、 ARM® RealView® Compilation Tools （RVCT）の概要と、収録されて

いるソフトウェアコンポーネントとマニュアルについて説明します。以下のセクションから構成されています。

• 「RealView Compilation Tools について」（ページ 1-2）

• 「RVCT で使用する環境変数」（ページ 1-7）

• 「追加の詳細情報」（ページ 1-9）

ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. 1-1Non-Confidential

はじめに

1.1 RealView Compilation Tools について

RVCT は、サポートドキュメントとサンプルを備えたツールスイートです。

これらのツールを使用すると、 ARM プロセッサファミリ用のアプリケーショ

ンを記述してビルドすることができます。

RVCT を使用すると、 C、 C++、または ARM のアセンブリ言語でソフトウェ

アプログラムをビルドできます。

1.1.1 RVCT のコンポーネント

このセクションでは、 RVCT コンポーネントの概要について説明します。

開発ツール

RVCT には、以下の開発者向けツールが収録されています。

armcc ARM コンパイラ。 C コードと C++ コードをコンパイルします。

armasm ARM と Thumb® に対応しているアセンブラ。ARM および Thumb アセンブリ言語によるソースファイルをアセンブルします。

armlink ARM リンカ。 1 つまたは複数のオブジェクトファイルの内容と、

1 つまたは複数のオブジェクトライブラリから選択された部分を

結合し、実行可能プログラムを生成します。

Rogue Wave C++ ライブラリ

Rogue Wave ライブラリは、標準 C++ ライブラリを実装したもの

です。 Rogue Wave ライブラリの詳細については、 CD-ROM に収

録されている HTML 形式のマニュアルを参照して下さい。

C++ ライブラリ

ARM C++ ライブラリには、以下の関数が用意されています。

• C++ コンパイル時に使用するヘルパ関数

• Rogue Wave ライブラリでサポートされていないその他の C++ 関数

C ライブラリ ARM C ライブラリは、C 標準および C++ 標準で定義されている

ライブラリ機能を実装したものです。詳細については、『ライブラリ / 浮動小数点サポートガイド』の 2-2 ページの「C および C++ ライブラリについて」を参照して下さい。

1-2 Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential

はじめに

C マイクロライブラリ

ARM C マイクロライブラリ（microlib）には、高度に適化され

た一連の関数が用意されています。これらの関数は、システムの深部に組み込まれ、極めて小容量のメモリに収める必要があるアプリケーションで使用されます。詳細については、『ライブラリ / 浮動小数点サポートガイド』の「3. C マイクロライブラ

リ」の章を参照して下さい。

fromelf ARM イメージ変換ユーティリティ。逆アセンブリおよびコード

サイズやデータサイズなど、入力イメージに関するテキスト情報を生成することもできます。

armar ARM ライブラリアン。 ELF 形式のオブジェクトファイルをアー

カイブやライブラリにまとめて保存するために使用します。これにより、複数の ELF ファイルの代わりにライブラリやアーカ

イブをリンカに渡すことができます。さらに高度なアプリケーション開発でこのアーカイブを使用してサードパーティに配布することもできます。

注 RealView Development Suite （RVDS）は 64 ビットの Linux プラットフォームを

サポートするようになりましたが、 RVCT ツールがこれを利用できるように

特別にビルドされたわけではありません。 RVCT のファイル I/O ルーチンで

は、標準のシステムコールが 32 ビットの（signed） int に収まるファイルサイ

ズで使用されます。つまり、イメージサイズは、 2GB を超えるメモリ容量を

備えた 64 ビットプラットフォームまたはコンピュータ上でビルドする場合

も、大 2GB に制限されていることになります。サイズがこの制限値を超え

ると、メモリが不足していることを示すエラーメッセージがリンカによって返されます。その結果、十分なメモリがあるにもかかわらず、アプリケーションがメモリにアクセスできないために混乱を引き起こすことがあります。

標準への準拠

RVCT では、以下の標準に準拠しています。各標準ごとに、準拠のレベルが

記載されています。

ar UNIX 方式のオブジェクトコードアーカイブは armar によって生

成され、 armlink によって使用されます。 armar では、 ar 形式のほ

とんどのオブジェクトコードアーカイブをリストして抽出する


はじめに

ことができます。また、 armlink では、シンボルテーブルのメン

バを含んでいる場合、別のアーカイブユーティリティで作成された ar 形式のアーカイブを使用することができます。

DWARF 3 DWARF 3 （DWARF Debugging Standard バージョン 3）のデバッグ

テーブルは、 RVDS のすべてのツールでサポートされています。

DWARF 2 DWARF 2 デバッグテーブルは、 RVCT に収録されているすべて

のツールでサポートされています。また、 RealView Debugger など、 ELF や DWARF 2 と互換性のある ARM 製のデバッガでもサ

ポートされています。

ISO C ARM コンパイラでは、 ISO C 1990 および 1999 ソースが入力とし

てサポートされています。詳細については、『コンパイラユーザガイド』の「ソース言語モード」を参照して下さい。

ISO C++ ARM コンパイラでは、 ISO C++ 2003 ソースが入力としてサポー

トされています。

ELF ARM コード生成ツールは、再配置可能なファイルと実行ファイ

ルを ELF 形式で生成します。 fromelf ユーティリティを使用する

と、 ELF ファイルを別の形式のファイルに変換することができ

ます。

注 DWARF 2 および DWARF 3 標準には、フレームデータのデバッグなど、一部

あいまいな領域があります。そのため、 ARM コード生成ツールによって生成

された DWARF をサードパーティ製のデバッガで使用できるかどうか、また

はサードパーティ製のデバッガによって生成された DWARF を RealView Debugger で使用できるかどうかについての保証はありません。

ARM アーキテクチャ用 ABI （基本標準）への準拠

ARM アーキテクチャ用 ABI （アプリケーションバイナリインタフェース）は標準の集合です。オープンな標準と ARM アーキテクチャ固有の標準があり

ます。これらの標準により、ベアメタルから ARM Linux などの主要なオペ

レーティングシステムまで、 ARM ベースの実行環境におけるバイナリコード

や開発ツールの相互動作が管理されます。

この標準に準拠すると、プロデューサの異なる ARM および Thumb のオブ

ジェクトやオブジェクトライブラリを連動させることができます。


はじめに

ARM アーキテクチャ用 ABI （基本標準）（BSABI）は、以下の仕様から構成さ

れています。

AADWARF ARM アーキテクチャ DWARF 標準。この ABI では、 DWARF 3 標準を使用して、オブジェクトのプロデューサとデバッガ間のやり取りを規定しています。

AAELF ARM アーキテクチャ ELF 標準。汎用的な ELF 標準をベースと

し、プロデューサとコンシューマ間でのリンク可能ファイルと実行可能ファイルのやり取りを規定しています。

AAPCS ARM アーキテクチャ向けプロシージャコール標準。実行時の関

数間の制御とデータのやり取りを規定しています。 RVCT でサ

ポートされている主要な実行環境の種類ごとに、 AAPCS のバリ

アントが用意されています。

BPABI ARM アーキテクチャ用ベースプラットフォーム ABI。静的なリ

ンカによって生成された実行可能ファイルや共有オブジェクトファイルの形式と内容を規定しています。ポストリンクを使用して、プラットフォーム固有の実行ファイルをサポートします。プラットフォーム ABI を派生させるのに使用する基本標準を提

供します。

CLIBABI ARM アーキテクチャ用 C ライブラリ ABI。 ABI と C ライブラリ

の関係を定義しています。

CPPABI ARM アーキテクチャ用 C++ ABI。 IA-64 向けに開発された汎用的

な C++ ABI をベースとし、独立した C++ コンパイラ間のイン

ターワークを規定しています。

EHABI ARM アーキテクチャ用例外処理 ABI。例外がどのようにスロー

され処理されるのかについて、言語に依存しない側面と C++ 固有の側面の両方から定義しています。

RTABI ARM アーキテクチャ用ラインタイム ABI。個別に作成されたオ

ブジェクトが浮動小数点とコンパイラヘルパ関数のサポートにおいて実行環境に何を期待できるかをを規定しています。

基本標準、ソフトウェアインタフェース、および ARM でサポートされてい

る標準の詳細については、install_directory\Documentation_Specifications_4.0\PDF を参照して下さい。

新版の詳細については、 http://www.arm.com を参照して下さい。


はじめに

以前のリリースの RVCT から新バージョンの RVCT にアップグレードする

場合は、 ARM 仕様の新版を使用して下さい。

支援ソフトウェア

シミュレーション環境または ARM コアベースのハードウェアでプログラム

をデバッグするには、 RealView Debugger などの適切なデバッガを使用しま

す。このデバッガは、 GCC 3.4 または RVCT v2.2 以上で生成された ELF、DWARF 2、および DWARF 3 と互換性があります。

シミュレーション環境でプログラムをデバッグするには、 RealView ARMulator® ISS または Instruction Set System Model （ISSM）支援ソフトウェア

を使用します。 RealView Armulator ISS は、 RVDS に付属する命令セットシ

ミュレータ（ISS）の 1 つです。 RVISS は、デバッガと通信し、デバッガと同

じホストコンピュータで実行したり、デバッガを実行しているコンピュータとは異なるリモートのシステムで実行したりすることができます。詳細については、『RealView ARMulator ISS ユーザガイド』を参照して下さい。

本リリースでは、 Cortex™ プロセッサ用のシミュレータモデルが使用できるよ

うになりました。これらのモデルには、 RealView Debugger の ISSM デバッグ

インタフェースを使用してアクセスできます。

サンプルコード

本書では、 RVDS に付属のサンプルを参照します。これらは、サンプルディ

レクトリの install_directory\RVDS\Examples にあります。収録されているサン

プルの概要については、『RealView Development Suite スタートガイド』を参照

して下さい。


はじめに

1.2 RVCT で使用する環境変数

表 1-1 に RVCT で使用する環境変数を示します。

表 1-1 RVCT で使用する環境変数

環境変数設定

ARMROOT インストールディレクトリルート（install_directory）。デフォルトは C:\Program Files\ARM です。

ARMLMD_LICENSE_FILE ARM RealView ライセンスファイルの場所。この環境変数の情報については、

『ARM ツール用 FLEXnet ライセンス管理ガイド』を参照して下さい。

RVCT40_ASMOPT 標準メークファイルの外部で使用される追加の ARM アセンブラオプション。以下

に例を示します。

--licretry

リストされるオプションは、メークファイルの armasm コマンドで指定されるオプ

ションの前に表示されます。したがって、この環境変数でリストされるオプションは、メークファイルで指定されるオプションによってオーバーライドされます。

RVCT40_CCOPT 標準メークファイルの外部で使用される追加の ARM コンパイラオプション。以下

に例を示します。

--licretry

リストされるオプションは、メークファイルの armcc コマンドで指定されるオプ


RVCT40_FROMELFOPT 標準メークファイルの外部で使用される追加の ARM fromelf オプション。以下に

例を示します。

--licretry

リストされるオプションは、メークファイルの fromelf コマンドで指定されるオプ


RVCT40_LINKOPT 標準メークファイルの外部で使用される追加の ARM リンカオプション。以下に例

を示します。

--licretry

リストされるオプションは、メークファイルの armlink コマンドで指定されたオプ


RVCT40BIN RVCT プログラム実行可能ファイル：

install_directory\RVCT\Programs\...\win_32-pentium


はじめに

RVCT40INC ARM コンパイラのインクルードファイル：

install_directory\RVCT\Data\...\include\windows

RVCT40LIB ARM コンパイラのライブラリファイル：

install_directory\RVCT\Data\...\lib

RVDS_PROJECT プロジェクトテンプレートディレクトリを識別します。

RVDS_PROJECT_WORKDIR プロジェクト作業ディレクトリを識別します。

表 1-1 RVCT で使用する環境変数（続き）

環境変数設定


はじめに

1.3 追加の詳細情報

インストールのタイプに応じて、付属マニュアルには、ブラウザベースの HTML 形式と PDF 形式があります。

注 RVDS マニュアルで使用されている ARM 用語の用語集は、『RealView Development Suite スタートガイド』に付属しています。

付属マニュアルをすべてインストールした場合、これらのマニュアルには以下のいずれかの方法でアクセスできます。

• プラットフォームに応じて、付属マニュアルを表示するには、以下の操作を実行します。

— Windows 環境では、以下の順に選択します。

［スタート］ → ［すべてのプログラム］ → ［ARM］ → ［Help viewer v1.0］

— Red Hat Linux 環境では、以下の順に選択します。

［スタート］メニュー → ［プログラム］ → ［ARM］ → ［Help viewer v1.0］

これによってスタンドアロンのビューアが表示され、そこでは以下の操作を実行できます。

— HTML 形式で RVDS マニュアルを表示する

— すべてのマニュアルまたはマニュアルのサブセットでテキスト検索を実行する

— 各マニュアルに対応する PDF ファイルにアクセスする

注スタンドアロンビューアから PDF マニュアルを表示する場合、すべて

の PDF マニュアルを検索することはできません。

• プラットフォームに応じて、 PDF マニュアルを表示するには、以下の操

作を実行します。

— Windows 環境では、以下の順に選択します。

［スタート］ → ［すべてのプログラム］ → ［ARM］ → ［RealView Development Suite v4.0］ → ［RVDS v4.0 Documentation Suite］


はじめに

— Red Hat Linux 環境では、以下の順に選択します。

［スタート］メニュー → ［プログラム］ → ［ARM］ → ［RealView Development Suite v4.0］ → ［RVDS v4.0 Documentation Suite］

これによって、 PDF 形式の RVDS マニュアルへのリンクを含んだ PDF マニュアルが表示されます。すべての PDF マニュアルに対し、テキス

ト検索を実行することもできます。

Rogue Wave C++ ライブラリに関するマニュアルは、すべてのサポートされて

いるプラットフォームで HTML 形式で用意されています。標準インストール

では、デフォルトで、このマニュアルがインストールされます。詳細については、「Rogue Wave のマニュアル」を参照して下さい。

1.3.1 Rogue Wave のマニュアル

RVCT の Rogue Wave Standard C++ ライブラリのマニュアルは、製品 CD-ROM に HTML 形式で収録されています。これらのマニュアルを表示するには、標

準の Web ブラウザを使用します。例えば、

install_directory\Documentation\RogueWave\1.0\release\stdref\index.htm ファイル

を選択すると、 Rogue Wave の HTML 形式のマニュアルが表示されます。

図 1-1 （ページ 1-11）を参照して下さい。この場合、 install_directory は D:\ARM です。


はじめに

図 1-1 Rogue Wave の HTML マニュアル


はじめに


第 2 章アプリケーションの作成

本章では、 ARM® RealView® Compilation Tools を使用してアプリケーションを

作成する方法について説明します。以下のセクションから構成されています。

• 「ARM Compilation Tools の使用」（ページ 2-2）

• 「ARM コンパイラの使用」（ページ 2-3）

• 「ARM アセンブラの使用」（ページ 2-8）

• 「ARM リンカの使用」（ページ 2-7）

• 「fromelf ユーティリティの使用」（ページ 2-9）

• 「ARM Workbench IDE の使用」（ページ 2-10）


アプリケーションの作成

2.1 ARM Compilation Tools の使用

通常、アプリケーション開発には、以下のファイルや作業が必要になります。

• メインアプリケーションの C/C++ ソースコード（armcc）

• 割り込みサービスルーチンなど、ハードウェアに近いコンポーネントのアセンブリソースコード（armasm）

• すべてのオブジェクトをリンクしてイメージを生成（armlink）

• イメージをフラッシュメモリ用の形式（プレーンバイナリ形式、 Intel Hex 形式、 Motorola-S 形式）に変換（fromelf）

図 2-1 に、通常のアプリケーション開発で ARM Compilation Tools が互いにど

のようにリンクしているかを示します。

図 2-1 一般的なツール使用の流れ図

Flash format

.s

armcc

armasm

C/C++ ARM and Thumb

Assemblycode

armlink fromelf

ImageObject codeSource code

code

data

debug

Plain binaryIntel Hex

Motorola-S

.ocodedata

debug

.ocodedata

debug

.c



2.2 ARM コンパイラの使用

ARM コンパイラ（armcc）を使用すると、 C および C++ ソースコードを ARM および Thumb コードにコンパイルできます。

通常、 ARM コンパイラを起動するには以下のように入力します。

armcc [options] ifile_1 ... ifile_n

複数の入力ファイルを指定できます。

ARM および Thumb コードのコンパイルについて、および指定したファイル

名拡張子によってコンパイラの起動コンフィギュレーションがどのように調整されるかについては、『コンパイラユーザガイド』の「第 2 章 ARM コンパ

イラの使い方」の章を参照して下さい。

2.2.1 Dhrystone サンプルのビルド

さまざまなアプリケーションの C ソースコードのサンプルが、サンプルディ

レクトリにインストールされています。各サンプルには readme.txt ファイル

が付属しており、サンプルコードの説明と、コードのビルド方法が記載されています。

例えば、 Dhrystone ベンチマークプログラムのソースコードは、サンプルディ

レクトリの ...\dhrystone にインストールされています。このプログラムは、

システムの整数処理のパフォーマンス測定に使用できます。

Dhrystone のサンプルをビルドするには

1. 以下のコマンドを使用して、 C ファイル dhry_1.c と dhry_2.c をコンパイ

ルします。

armcc -c -W --debug -O3 -Otime --no_inline --no_multifile -DMSC_CLOCK \ dhry_1.c dhry_2.c

一般的に使用されるオプションは以下のとおりです。

-c コンパイルのみ（リンクなし）を行うようにコンパ

イラに指示します。

--debug ソースレベルのデバッグを行うためのデバッグテー

ブルを追加するようにコンパイラに指示します。

-O3 高度な適化を使用してコードを生成するようにコ

ンパイラに指示します。

-Otime サイズではなく速度を重視してコードを適化する

ようにコンパイラに指示します。



Dhrystone ベンチマークの考え方を踏襲するには、--no_inline および --no_multifile オプションが必要です。

• 関数のインライン化を無効にするには、--no_inline が必要です。

Dhrystone ではプロシージャをマージしません。

• マルチファイルのコンパイルを無効にするには、--no_multifile が必

要です。 Dhrystone では 2 つのソースファイルを別々にコンパイル

する必要があります。

以下のオプションも、 Dhrystone ビルドファイルのビルドに使用されま

す。

-W すべての警告メッセージを無効にするようにコンパ

イラに指示します。

-DMSC_CLOCK タイミングの測定に C ライブラリ関数 clock() を使用

するようにコンパイラに指示します。

コンパイラオプションの詳細については、『コンパイラリファレンスガイド』の「第 2 章コンパイラのコマンドラインオプション」の章を参

照して下さい。

注 --arm は、デフォルトのコンパイラオプションです。詳細については、

「「ARM コードのコンパイル」」を参照して下さい。

2. ファイルをリンクします。「ARM リンカの使用」（ページ 2-7）を参照し

て下さい。

3. RealView Debugger などの互換性のあるデバッガを使用して、イメージ

をロードして実行します。

dhry_1.c と dhry_2.c の内容、および Dhrystone のパフォーマンスの計算方法の

詳細については、サンプル付属の readme.txt ファイルを参照して下さい。

2.2.2 ARM コードのコンパイル

以下のコンパイラオプションを使用すると、 ARM コードが生成されます。

--arm Tnumb コードではなく ARM コードを優先して生成するようにコ

ンパイラに指示します。ただし、 #pragma thumb を使用すると、こ

のオプションはオーバーライドされます。これはデフォルトのコンパイラオプションです。



--arm_only ARM コードのみを生成するようにコンパイラに指示します。コ

ンパイラは、 Thumb コードがターゲットアーキテクチャに存在

しない場合と同様に動作します。 #pragma thumb 宣言は無視されま

す。

関連項目

• 『コンパイラユーザガイド』の「#pragma thumb」（ページ 4-79）

• 『コンパイラリファレンスガイド』の「--arm」（ページ 2-9）

• 『コンパイラリファレンスガイド』の「--arm_only」（ページ 2-17）



2.2.3 Thumb コードのコンパイル

Thumb バージョンをビルドするには、以下のコマンドを使用します。

armcc --thumb ...

各項目には以下の意味があります。

--thumb ARM コードではなく Thumb コードを優先して生成するよ

うにコンパイラに指示します。ただし、 #pragma arm を使用

すると、このオプションはオーバーライドされます。

関連項目

• 『コンパイラユーザガイド』の「#pragma arm」（ページ 4-63）

• 『コンパイラリファレンスガイド』の「--thumb」（ページ 2-136）



2.3 ARM リンカの使用

リンカは、複数のオブジェクトファイルの内容をオブジェクトライブラリの選択した部分と結合して、イメージファイルまたはオブジェクトファイルを生成します。

通常、 ARM リンカを起動するには以下のように入力します。

armlink [options] file_1 ... file_n

詳細については、『リンカユーザガイド』の「第 2 章 ARM リンカの使い方」

の章を参照して下さい。

2.3.1 Dhrystone サンプルのリンク

Dhrystone サンプルプログラムのオブジェクトファイルをリンクするには、次

のコマンドを使用します。

armlink dhry_1.o dhry_2.o -o dhrystone.axf --info totals

各項目には以下の意味があります。

-o 出力ファイルとして dhrystone.axf を指定します。

--info totals 入力オブジェクトとライブラリについて、コードとデータ

のサイズの合計を表示するようにリンカに指示します。



2.4 ARM アセンブラの使用

ARM アセンブラ（armasm）を使用するための基本的な構文を以下に示します。

armasm [options] inputfile

例えば、 myfile.s というファイル内のコードをアセンブルし、生成されるオブ

ジェクトファイル内にデバッグ情報を含めるには、以下のように入力します。

armasm --debug myfile.s

これにより、 myfile.o というオブジェクトファイルが生成されます。

オプションと構文の詳細については、『アセンブラガイド』の「コマンド構文」（ページ 3-2）を参照して下さい。

2.4.1 アセンブラソースからのサンプルのビルド

サンプルディレクトリには、アセンブリ言語コードのサンプルがインストールされています。各サンプルには readme.txt ファイルが付属しており、サン

プルコードの説明と、コードのビルド方法が記載されています。例えば、単純なプログラム word.s のコードは、サンプルディレクトリの ...\asm にインス

トールされています。

サンプルをビルドするには

1. 以下のコマンドを使用して、ソースファイルをアセンブルします。

armasm --debug word.s

2. 以下のコマンドを使用して、ファイルをリンクします。

armlink word.o -o word.axf

3. RealView Debugger などの互換性のあるデバッガを使用して、イメージ

をロードしてテストします。

プログラムをステップスルーし、レジスタがどのように変更されるかを調べます。この方法の詳細については、デバッガのマニュアルを参照して下さい。



2.5 fromelf ユーティリティの使用

ARM fromelf ユーティリティには以下の特徴があります。

• ELF 実行可能形式の実行可能イメージを他のファイル形式に変換しま

す。

• 出力ファイル内にデバッグ情報を含めるかどうかを制御します。

• ELF イメージや ELF オブジェクトファイルを逆アセンブルします。

• サードパーティに配信されるイメージとオブジェクトの知的所有権を保護します。

• ELF イメージや ELF オブジェクトファイルに関する情報を出力します。

詳細については、『ユーティリティガイド』の「第 2 章 fromelf ユーティリ

ティの使用」の章を参照して下さい。

2.5.1 fromelf サンプルの使用

以下に、 fromelf ユーティリティの使用例を示します。

fromelf --text -c -s --output=outfile.lst infile.axf

逆アセンブルされたコードと ELF イメージのシンボルテーブル

を含むプレーンテキスト形式の出力ファイルを生成します。

fromelf --bin --16x2 --output=outfile.bin infile.axf

2 バンク、 16 ビットメモリ幅のメモリコンフィギュレーションを

持つターゲットシステム向けに、バイナリ形式で 2 つのファイル

（outfile0.bin および outfile1.bin）を生成します。

2 番目の使用例で生成される出力ファイルは、フラッシュメモリデバイスへ

の直接書き込みに適しています。



2.6 ARM Workbench IDE の使用

ARM Workbench IDE により、グラフィカルユーザインタフェースを使用して

ソフトウェア開発プロジェクトを管理できます。 ARM Workbench は、ソフト

ウェア開発とすべての RealView ツールのコンパイルおよびデバッグテクノロ

ジが組み合わされた統合開発環境を実現します。このワークベンチには、いくつかの作業プロジェクトが一式、試用サンプルとして用意されています。これらのサンプルプロジェクトを使用するには、ワークベンチを起動し、サンプルをワークスペースにインポートする必要があります。詳細については、『ARM Workbench IDE ユーザガイド』を参照して下さい。


第 3 章 RVCT v4.0 と RVCT v3.1 の相違点

本章では、 ARM® RealView® Compilation Tools （RVCT） v4.0 と RVCT v3.1 の主

な相違点について説明します。以下のセクションから構成されています。

• 「RealView Compilation Tools v4.0 の概要」（ページ 3-2）

• 「RVCT v4.0 のドキュメントの変更点」（ページ 3-3）

• 「RVCT v4.0 における ARM コンパイラの変更点」（ページ 3-4）

• 「RVCT v4.0 におけるライブラリサポートの変更点」（ページ 3-7）

• 「RVCT v4.0 における ARM リンカの変更点」（ページ 3-8）

• 「RVCT v4.0 における ARM アセンブラの変更点」（ページ 3-9）

• 「RVCT v4.0 における fromelf ユーティリティの変更点」（ページ 3-10）

• 「RVCT v4.0 での使用が制限される機能」（ページ 3-12）

• 「RVCT v4.0 で廃止された機能」（ページ 3-13）

• 「RVCT v4.0 と従来のオブジェクトおよびライブラリとの互換性」（ペー

ジ 3-14）

RVCT の以前のリリース間の相違点については、「付録 A 以前のリリースにつ

いて」を参照して下さい。


RVCT v4.0 と RVCT v3.1 の相違点

3.1 RealView Compilation Tools v4.0 の概要

RVCT v4.0 と RVCT v3.1 のも重要な相違点を以下に示します。

• Cortex™-A9 （RVDS Professional エディションのみ）および Cortex-R4F プロセッサがサポートされました。サポートされているアーキテクチャおよびプロセッサの詳しいリストを参照するには、 --cpu=list コマンドラ

インオプションを使用して下さい。

• RVCT および CodeSourcery ツールを使用した Linux アプリケーションの

ビルドのサポートが強化されました。

• シンボルの可視性が強化されました。

• fromelf 機能が強化されました。

• リンカのコールグラフ機能が強化されました。

• 事前リンクに適したイメージの生成がサポートされました。

• アーキテクチャを認識した逆アセンブリがサポートされました。

• Cortex™-M3 プロセッサの初期のビットバンディングがサポートされまし

た。

• Cortex™-M1 プロセッサの浮動小数点性能が改善されました。

• コード適化が強化されました。

• プロファイラによる適化がサポートされました。

• リンク時のコード生成がサポートされました。



3.2 RVCT v4.0 のドキュメントの変更点

RVCT v4.0 ではドキュメントに以下の変更が加えられました。

• 『リンカ / ユーティリティガイド』の内容が以下のマニュアルに分割さ

れました。

— リンカユーザガイド

— リンカリファレンスガイド

— ユーティリティガイド

• 『NEON™ ベクトル化コンパイラガイド』が、『コンパイラユーザガイド』

と『コンパイラリファレンスガイド』に組み込まれました。

• 『デベロッパガイド』が新の ARM アーキテクチャおよびプロセッサを

反映して再編成され、更新されました。

• --licretry オプションの説明が記載されました。このオプションは、

ARM アセンブラ、 ARM コンパイラ、 ARM リンカ、および fromelf ユー

ティリティでサポートされています。

• すべてのドキュメントが、関連ツールの機能を反映して更新されました。

このリリースのツールに加えられた変更の詳細については、本章の後半のセクションを参照して下さい。



3.3 RVCT v4.0 における ARM コンパイラの変更点

RVCT v4.0 ではコンパイラに以下の変更が加えられました。

• Cortex-A9 および Cortex-R4F プロセッサについて --cpu=Cortex-A9 および --cpu=Cortex-R4F スイッチを使用できるようになりました。『コンパイラ

リファレンスガイド』の「コマンドラインオプション」（ページ 2-2）を参照して下さい。

• 多くの新しい組み込み関数が追加されました。『コンパイラユーザガイド』の「コンパイラ組み込み関数」（ページ 4-2）を参照して下さい。

• ARM コードのみを出力し、 #pragma thumb 宣言を無視するようにコンパイ

ラに指示する --arm_only コマンドラインオプションが追加されました。

『コンパイラリファレンスガイド』の「コマンドラインオプション」（ページ 2-2）を参照して下さい。

• Linux アプリケーションのビルドに役立つ以下のコマンドラインオプ

ションが追加されました。

— --arm_linux

— --arm_linux_config_file

— --arm_linux_configure

— --arm_linux_paths

— --configure_cpp_headers

— --configure_extra_includes

— --configure_extra_libraries

— --configure_gcc

— --configure_gld

— --configure_sysroot

— --shared

— --translate_g++

— --translate_gcc

— --translate_gld

• --fpu コマンドラインオプションに、以下のオプションが追加されまし

た。

— vfpv3_fp16

— vfpv3_d16

— vfpv3_d16_fp16



— softvfp+vfpv3_fp16

— softvfp+vfpv3_d16

— softvfp+vfpv3_d16_fp16

対応する事前定義のマクロも追加されました。『コンパイラユーザガイド』の「浮動小数点演算の使用」（ページ 5-36）を参照して下さい。

• Cortex-M3 プロセッサのビットバンディングを可能にするため __attribute__((bitband)) 型属性が追加されました。『コンパイラリファレ

ンスガイド』の「型属性」（ページ 4-47）を参照して下さい。

• Cortex-M1 プロセッサの浮動小数点性能が改善されました。単精度演算

は 6 倍以上、倍精度演算は 3.5 倍以上速度が改善されました。

• 明示的または暗黙的に dllexport とマークされたオブジェクトおよび機

能に使用される ELF シンボルの可視性が変更されました。 RVCT v3.1 では STV_DEFAULT セクション（プリエンプティブ）で定義されるシンボル

が、 RVCT v4.0 では STV_PROTECTED セクション（エクスポートされ非プリ

エンプティブ）で定義されます。ただし、 COMDAT セクションで定義され

るシンボルはそのまま STV_DEFAULT セクションで定義されます。

--no_hide_all コンパイラオプションは引き続き、 STV_HIDDEN ではなく STV_DEFAULT シンボルを可視化するので、シンボルをエクスポートするこ

とと同義ではなくなります。

• 新しい --retain コンパイラオプションを使用すると、コンパイラが実行

するコード変換を制限できます。例えば、インライン関数が未使用の場合、それらを削除しないようにすることができます。以下の属性も用意されています。

— __attribute__((notailcall))

— __attribute__((nomerge))

『コンパイラリファレンスガイド』の「--retain=option」（ページ 2-126）を参照して下さい。

『コンパイラリファレンスガイド』の「関数属性」（ページ 4-35）を参

照して下さい。

• プロファイラによる適化では、 ARM Profiler によって生成されたアプ

リケーションプロファイルを利用します。新しい --profile オプション

を使用してコンパイラやリンカにプロファイルを入力すると、サイズが小さくパフォーマンスの優れたコードを生成できます。



• 新しい --ltgc コンパイラおよびリンカオプションを使用するとリンク時

のコード生成を実行できるので、以下の適化が実現されます。

— モジュールをまたがったインライン化によるパフォーマンスの向上

— ベースアドレスの共有によるコードサイズの縮小

詳細については、『コンパイラユーザガイド』の「関数のインライン展開」（ページ 5-20）を参照して下さい。

• その他にも、次のコマンドラインオプションが追加されました。

— --compatible

— --device

— --fp16_format

— --library_interface=rvct_c90

— --licretry

• GNU ライブラリヘッダファイルとの互換性を確保する関数が追加され

ました。『コンパイラリファレンスガイド』の「GNU 組み込み関数」（ページ 4-126）を参照して下さい。



3.4 RVCT v4.0 におけるライブラリサポートの変更点

マイクロライブラリと標準ライブラリとの機能的な相違点が縮小されました。ワイド文字 IO もサポートされています。詳細については、『ライブラリ / 浮動

小数点サポートガイド』を参照して下さい。



3.5 RVCT v4.0 における ARM リンカの変更点

RVCT v4.0 ではリンカに以下の変更が加えられました。

• 以下のコマンドラインオプションが追加されました。

--[no_]add_needed

--arm_only

--arm_linux

--[no_]combreloc

--device

--filtercomment

--info=visibility

--no_largeregions

--licretry

--ltcg

--max_open_files

--[no_]muldefweak

--[no_]prelink_support

--profile

--section_index_display=type

以下も参照して下さい。

• 『リンカユーザガイド』の「コマンドラインオプションの使用」（ペー

ジ 2-7）

• 『リンカリファレンスガイド』の「第 2 章リンカコマンドラインオプ

ション」



3.6 RVCT v4.0 における ARM アセンブラの変更点

RVCT v4.0 ではアセンブラに以下の変更が加えられました。

• 以下の NEON™ 命令と VFP 命令が追加されました。

— 半精度拡張を備えた VCVT

— 半精度拡張を備えた VCVTB および VCVTT

『アセンブラガイド』の「NEON 汎用データ処理命令」（ページ 5-43）お

よび「VFP 命令」（ページ 5-111）を参照して下さい。

• Cortex-A9 をサポートするため PLDW 命令が追加されました。詳細につい

ては、『アセンブラガイド』の「PLD、 PLDW、 PLI」（ページ 4-26）を

参照して下さい。

• 以下のディレクティブで、シンボル型がサポートされました。

— EXPORT

— EXTERN

— GLOBAL

— IMPORT

• 以下のコマンドラインスイッチが追加されました。

— --arm_only

— --cpreproc

— --device

— --licretry

詳細については、『アセンブラガイド』の「第 3 章アセンブラに関する

参考情報」の章を参照して下さい。

『アセンブラガイド』の「一般的な情報」（ページ 5-15）も参照して下さい。



3.7 RVCT v4.0 における fromelf ユーティリティの変更点

RVCT v4.0 では fromelf ユーティリティに以下のオプションが追加されまし

た。

• --base

• --bincombined

• --bincombined_base

• --bincombined_padding

• --cad

• --cadcombined

• --compare

• --cpu

• --datasymbols

• --device

• --disassemble

• --emit

• --fpu

• --globalize

• --hide

• --hide_and_localize

• --ignore_section

• --ignore_symbol

• --info=instruction_usage

• --in_place

• --interleave

• --licretry

• --localize

• --privacy

• --qualify

• --reinitialize_workdir

• --relax_section

• --relax_symbol

• --rename

• --show

• --show_and_globalize

• --source_directory



• --strip=symbols

• --strip=localsymbols

• --workdir

以前は説明されていなかったオプション --text -w の説明が記載されました。

アーキテクチャを認識した逆アセンブリがサポートされました。

詳細については、『ユーティリティガイド』の「第 2 章 fromelf ユーティリ

ティの使用」の章を参照して下さい。



3.8 RVCT v4.0 での使用が制限される機能

RVCT v4.0 では以下の機能の使用が制限されています。

• --memaccess コンパイラオプションの使用が制限されています。

• 以下の mathlib 関数の使用が制限されています。

— gamma()

— gamma_r()

— lgamma_r()

— scalb()

— significand()

• 以下の Bessel 関数の使用が制限されています。

— j0()

— j1()

— jn()

— y0()

— y1()

— yn()

• ARM アセンブラオプション -O。小文字ではなく、大文字を使用します。



3.9 RVCT v4.0 で廃止された機能

RVCT v4.0 では以下の機能が廃止されています。

• 廃止されたツールは以下のとおりです。

— armcpp

— tcc

— tcpp

メークファイルでの armcpp、 tcc、または tcpp への参照は、 armcc --cpp、

armcc --thumb、 armcc --thumb --cpp にそれぞれ変更する必要があります。

• C マクロを使用したロケールと CTYPE のカスタマイズは廃止されまし

た。

• ARM アセンブラオプション -D （--depend と同義）が廃止されました。



3.10 RVCT v4.0 と従来のオブジェクトおよびライブラリとの互換性

--apcs /adsabi を使用してコードをビルドせず、 RVCT v4.0 リンカおよび C/C++ ライブラリを使用している場合、 RVCT v2.x および v3.x オブジェクト /ライブラリコードの下位互換性がサポートされます。ただし、上位互換性は保証されていません。

以上のような制限事項があるため、ユーザやサードパーティによって提供されるライブラリを含むプロジェクト全体を RVCT v4.0 を使用して再ビルドす

ることをお勧めします。これは、潜在的な非互換性の問題を回避するためと、適化や拡張機能、 RVCT v4.0 が提供する新機能を十分に活用するためです。


付録 A 以前のリリースについて

この付録では、 ARM® RealView® Compilation Tools （RVCT）の以前のリリース

間の主な相違点について説明します。

以下のセクションから構成されています。

• 「RVCT v3.1 と RVCT v3.0 の相違点」（ページ A-2）


• 「RVCT v2.2 SP1 と RVCT v2.2 の相違点」（ページ A-24）




ARM DUI 0202IJ Copyright © 2002-2008 ARM Limited. All rights reserved. A-1Non-Confidential

以前のリリースについて

A.1 RVCT v3.1 と RVCT v3.0 の相違点

このセクションでは、 RVCT v3.1 と RVCT v3.0 との間の相違点について説明

します。

A.1.1 RVCT v3.1 の概要

• RVCT v3.1 では、以下の新しい --cpu オプションがサポートされました。

— ARMv7 は認定された ARM アーキテクチャではありません。

--cpu=7 は、 ARMv7-A、 ARMv7-R、および ARMv7-M のすべての

アーキテクチャに共通の機能を示します。すなわち、 --cpu=7 とと

もに使用される機能が ARMv7-A、 ARMv7-R、 ARMv7-M のすべて

のアーキテクチャ上に存在します。

— Cortex™ プロセッサ

--cpu=Cortex-R4--cpu=Cortex-M1--Cortex-A8NoNEON

— Marvell Feroceon プロセッサ --cpu=88FRxxx

サポートされるすべてのアーキテクチャとプロセッサのリストを参照するには、 --cpu=list を使用します。詳細については、『コンパイラリファ

レンスガイド』の「--cpu=list」（ページ 2-34）および

「--cpu=name」（ページ 2-35）を参照して下さい。

• RVCT v3.1 では、オプション --apcs=/adsabi が使用できなくなりました。

ADS 互換オブジェクトのコンパイルおよび古い ADS オブジェクトとラ

イブラリのリンクも実行できなくなりました。

• RVCT v3.1 では、 C99 言語が完全にサポートされています（複素数とワ

イド I/O を除く）。詳細については、『コンパイラユーザガイド』の

「C99 の新機能」（ページ 5-51）を参照して下さい。

• RVCT v3.1 では、 NEON™ テクノロジが完全にサポートされています。

詳細については、『コンパイラユーザガイド』の「第 3 章 NEON ベクト

ル化コンパイラの使用」の章および「NEON コンパイラ組み込み関数」（ページ 4-12）を参照して下さい。

• RVCT v3.1 では、システムの深部に組み込まれ、極めて小容量のメモリ

に収める必要があるアプリケーションで使用するために、標準的な C ライブラリの代わりに C マイクロライブラリ（microlib）が用意されてい

A-2 Copyright © 2002-2008 ARM Limited. All rights reserved. ARM DUI 0202IJNon-Confidential


ます。 microlib は ISO C 標準に完全には準拠していません。詳細につい

ては、『ライブラリ / 浮動小数点サポートガイド』の「第 3 章 C マイク

ロライブラリ」の章を参照して下さい。

• RVCT v3.1 では、ロケール関数と CTYPE 関数をカスタマイズするため

のアセンブラマクロが用意されています。詳細については、『ライブラリ / 浮動小数点サポートガイド』の「アセンブラマクロによるロケール

と CTYPE のカスタマイズ」（ページ 2-51）を参照して下さい。

• RVCT v3.1 では、固有のコンパイラ組み込み関数によって、 C および C++ で記述された ARM アーキテクチャベースのプロセッサの低レベル

機能に簡単にアクセスできます。詳細については、『コンパイラユーザガイド』の「命令のコンパイラ組み込み関数」（ページ 4-4）を参照し

て下さい。

• RVCT v3.1 では、 ETSI コンパイラ組み込み関数もサポートされていま

す。詳細については、『コンパイラユーザガイド』の「ETSI の基本操

作」（ページ 4-7）を参照して下さい。

• RVCT v3.1 では、 C55x コンパイラ組み込み関数もサポートされていま

す。詳細については、『コンパイラユーザガイド』の「TI C55x コンパイ

ラ組み込み関数」（ページ 4-10）を参照して下さい。

• RVCT v3.1 では、コールグラフ、スキャッタロードファイル、および実

行領域へのセクション配置のサポートも強化されました。詳細については、『リンカリファレンスガイド』の「--[no_]callgraph」（ページ 2-8）を参照して下さい。

• RVCT v3.1 では、配信可能なイメージおよびオブジェクトの知的所有権

の保護が強化されました。詳細については、「RVCT v3.1 における fromelf ユーティリティの変更点」（ページ A-11）を参照して下さい。

• RVCT v3.1 には、ファイルパスの冗長なパス名情報の除外を制御できる

オプションが用意されています。このオプションは、 ARM コンパイラ、

リンカ、およびアセンブラで使用することができます。詳細については、『リンカリファレンスガイド』の「--[no_]reduce_paths」（ページ 2-52）を参照して下さい。

• RVDS v3.1 には、主なプロジェクト管理機能として Eclipse IDE が含まれ

ています。 Eclipse Plug-in for RVDS には、 RVCT のすべてのオプションを

設定するための統合コンフィギュレーションパネルが用意されています。詳細については、『RealView Development Suite Eclipse Plug-in ユーザ

ガイド』を参照して下さい。



• RVDS v3.1 では、 --verbose コマンドラインオプションで、 stderr ではな

く stdout に診断情報が出力されるように変更されました。この診断情報

をファイルに転送するには、 --errors ではなく --list を使用する必要が

あります。

A.1.2 RVCT v3.1 で廃止された機能

RVCT v3.1 では、以下の相違点に注意して下さい。

• Solaris プラットフォームは、 RVCT v3.1 ではサポートされていません。

• Red Hat Linux Enterprise v3 32 ビットホストプラットフォームは、 RVCT v3.1 ではサポートされていません。

• コンパイラオプション --apcs=/adsabi は、RVCT v3.1 ではサポートされて

いません。

• RVCT v3.0 で使用が制限されていた機能はすべて、 RVCT v3.1 では使用

されなくなりました。詳細については、「RVCT v3.0 での使用が制限され

る機能」（ページ A-15）を参照して下さい。

A.1.3 RVCT v3.1 での使用が制限される機能


• 以下のツール名は使用が制限されています。

— armcpp

— tcc

— tcpp

• .ac や .tc などのファイル拡張子を使用して命令セットを切り替える機能

は使用が制限されています。

• ARMv7-A、 ARMv7-R、 ARMv7-M およびそれ以降のアーキテクチャ向

けにコンパイルするときは、インラインアセンブラの使用が制限されます。 ARMv7-A と ARMv7-R の場合、コンパイラによって警告が生成され

ます。 ARMv6-M と ARMv7-M の場合、 Thumb コードの生成時にコンパ

イラによってエラーが生成されます。

• 以下のオプションは使用が制限されています。

— --split_ldm

— --memaccess



• C マクロを使用したロケールと CTYPE のカスタマイズは、使用が制限


• fromelf オプション --no_comment_section は使用が制限され、説明はド

キュメントに記載されていません。代わりに、--strip=comment オプション

を使用して下さい。

• 以下のアセンブラ機能は使用が制限されています。

— VFP ベクタモードは新しいコードでは使用が制限され、ベクタ表

記は統一アセンブラ言語ではサポートされていません。ベクタ表記を使用するには、古い VFP ニーモニックを使用する必要があり

ます。

— 新の CPU では、ユーザモードでアクセス可能なビットにアクセ

スするための CPSR の使用が制限されています。この場合は、

APSR を使用して下さい。

— ARMv6T2 以降の STC および STC2 での PC 相対アドレシングの使用

が制限されています。

— --checkreglist （代わりに --diag_warning 1206 を使用して下さい）。

— レジスタリスト内のベースレジスタおよびライトバックを指定した 16 ビット LDM および STM の使用が制限されています。

A.1.4 RVCT v3.1 における ARM コンパイラの変更点

RVCT v3.1 のコンパイラでは、以下の相違点に注意して下さい。

• --cpu コマンドラインオプションでは、新しいアーキテクチャおよびプ

ロセッサがサポートされています。詳細については、「RVCT v3.1 の概

要」（ページ A-2）を参照して下さい。

• C コードまたは C++ コードから直接 NEON™ ベクタ命令を生成するため

の --vectorize コマンドラインオプション。詳細については、『コンパイ

ラリファレンスガイド』の「--vectorize, --no_vectorize」（ペー

ジ 2-146）を参照して下さい。

注このオプションを使用するには、 NEON ベクトル化コンパイラライセン

スが必要です。このライセンスは、 RVDS Professional エディションに付

属しています。



• --c99 コマンドラインオプションでは、 C99 言語が完全にサポートされ

ています（複素数とワイド I/O を除く）。

• 関連するランタイムライブラリを選択するための --library_type=lib コマ

ンドラインオプション。詳細については、『コンパイラリファレンスガイド』の「--library_type=lib」（ページ 2-90）を参照して下さい。

• 小容量のグローバル ZI データ項目の配置を制御するための --bss_threshold=num コマンドラインオプション。

• 適化用の診断メッセージを制御するための --diag_suppress=optimizations および --diag_warning=optimizations コマンド

ラインオプション。

• 可変長配列のサポートを制御するための --[no_]vla コマンドラインオプ

ション。

• wchar_t の型を変更するための --wchar16 および --wchar32 コマンドライン

オプション。

• --apcs=/adsabi は、 RVCT v3.1 ではサポートされていません。

• ファイルパスの冗長なパス名情報の除外を制御できる --[no_]reduce_paths オプション。

• C および C++ から SIMD 命令を生成できる NEON™ 組み込み関数が用意


• 選択した Texas Instruments C55x コンパイラ組み込み関数のエミュレー

ションがサポートされています。

• スピーチコーデックを実装するための ETSI の基本操作がサポートされ

ています。

• __attribute__((section("name")))。 --autoat コマンドラインオプションで

使用する配置アドレスをエンコードします。

• 固有のコンパイラ組み込み関数によって、 C および C++ で記述された ARM アーキテクチャベースのプロセッサの低レベル機能に簡単にアク

セスできます。



A.1.5 RVCT v3.1 におけるライブラリサポートの変更点

RVCT v3.1 のライブラリサポートでは、以下の相違点に注意して下さい。

• RVCT v3.1 には、新しいライブラリ命名規則があります。

• RVCT v3.1 では、システムの深部に組み込まれ、極めて小容量のメモリ

に収める必要があるアプリケーションで使用するライブラリがサポートされています。 microlib に新たに導入された一連の関数は、標準に完全

には準拠していませんが、コードサイズがも小さくなるように十分に適化されています。

• RVCT v3.1 では、ロケール関数と CTYPE 関数をカスタマイズするため

のアセンブラマクロが用意されています。


• RVCT ライブラリ / 浮動小数点サポートガイド

A.1.6 RVCT v3.1 における ARM リンカの変更点

RVCT v3.1 のリンカでは、以下の相違点に注意して下さい。

• イメージコードおよびデータサイズを要約するための --info summarysizes 属性。

• --cpu=name コマンドラインオプションを使用すると、選択した ARM プロ

セッサまたはアーキテクチャの上限を指定できます。

• --fpu=name コマンドラインオプションを使用すると、選択した FPU アー

キテクチャの上限を指定できます。

• --bpabi コマンドラインオプションを使用すると、 BPABI 実行可能ファ

イルを生成できます。

• --dll コマンドラインオプションを使用すると、 BPABI DLL を生成でき

ます。

• --predefine="string" コマンドラインオプションを使用すると、スキャッ

タファイルの初の行で指定されているプリプロセッサにコマンドが渡されます。

• --[no_]reduce_paths オプションを使用すると、ファイルパスの冗長なパ

ス名情報の除外を制御できます。



• --autoat コマンドラインオプションを使用すると、実行領域への __at セクションの自動配置を制御できます。

• --verbose コマンドラインオプションを使用すると、 stout に診断結果を

出力できます。この診断情報をファイルに転送するには、--list を使用

する必要があります。詳細については、『リンカリファレンスガイド』の「--verbose」（ページ 2-68）を参照して下さい。

• __at セクションに変数を割り当てるには、

__attribute__((section("name"))) を使用してセクション名を明示的に指定

するか、または __attribute__((at("name"))) を使用してセクション名を自

動的に設定します。詳細については、『リンカユーザガイド』の「領域

アドレスとセクションアドレスの指定の例」（ページ 5-9）を参照して

下さい。

• スキャッタロードファイルの境界調整のための ALIGN alignment 属性。

• 入力セクションを実行領域に割り当てる際の .ANYnum を使用した優先順

位付け。

• 実行領域の内容を処理するための属性

— ELF ファイルのセクションを初期化するための ZEROPAD 属性。

— パディングバイトの値を設定するための PADVALUE 属性。

— 値を含んでいるリンカ生成領域を作成するための FILL 属性。

• BPABI の異なるアドレシングモードに対応するテーブルを生成するため

の --pltgot=type、 --pltgot_opts=mode、および --info pltgot コマンドライ

ンオプション。


ンドラインオプション。詳細については、『コンパイラリファレンスガイド』の「--library_type=lib」（ページ 2-90）を参照して下さい。

• 以下のコールグラフオプション。

— --callgraph_file=filename は出力ファイルの名前を定義します。

— --callgraph_output=fmt は出力ファイルの種類を定義します。

— --cgfile=opt はコールグラフの内容を制御します。

— --cgsymbol=type はコールグラフの内容を制御します。

— --cgundefined=type はコールグラフの内容を制御します。



• RVCT v3.1 のリンカは、相対ベースアドレス時のロード領域の解釈が異

なっています。以前のロード領域のゼロで初期化された（ZI）データを

考慮してロード領域のベースアドレスを調整することはありません。

例 A-1 に、重複したデータを含むスキャッタファイルを示します。

例 A-1 LR2 の相対ベースアドレスを含むスキャッタファイル

LR1 0x8000{

er_progbits +0{

*(+RO,+RW) ; Takes space in the Load Region}er_zi +0 {

*(+ZI) ; Takes no space in the Load Region}

}LR2 +0 ; Load Region follows immediately from LR1{

er_moreprogbits +0{

file1.o(+RO) ; Takes space in the Load Region}

}

RVCT v3.1 では、データの重複が検出されるとエラーメッセージが表示

されます。これを回避するには、 LR2 のベースアドレスを計算するため

の式がスキャッタファイルに必要です。例 A-2 に修正したスキャッタ

ファイルを示します。

例 A-2 LR2 のベースアドレスを計算したスキャッタファイル

LR1 0x8000{

er_progbits +0{

*(+RO,+RW) ; Takes space in the Load Region}er_zi +0 {

*(+ZI) ; Takes no space in the Load Region}

}



LR2 ImageLimit(er_zi) ; Set the address of LR2 to limit of er_zi{

er_moreprogbits +0{

file1.o(+RO) ; Takes space in the Load Region}

}

A.1.7 RVCT v3.1 における ARM アセンブラの変更点

RVCT v3.1 のアセンブラでは、以下の相違点に注意して下さい。

• --cpu コマンドラインオプションでは、新しいアーキテクチャおよびプ

ロセッサがサポートされています。詳細については、「RVCT v3.1 の概

要」（ページ A-2）を参照して下さい。


ンドラインオプション。

• ファイルパスの冗長なパス名情報の除外を制御できる --[no_]reduce_paths オプション。

• CPSR のユーザモードビットには APSR を使用します。

• VFP ベクタモードは新しいコードでは使用が制限され、ベクタ表記は統

合アセンブラ言語ではサポートされていません。

• Intel Wireless MMX2™ 命令がサポートされています。

• CODEALIGN 属性は、 AREA ディレクティブで設定できます。

• --depend_format=string によって、出力に依存するファイルの形式が変更

されます。

• --no_code_gen オプションは、 --depend とともに使用され、オブジェクト

ファイルは生成されません。

• UND は新しいディレクティブで、アーキテクチャ上で定義されていない

命令をエンコードします。

詳細については、『アセンブラガイド』を参照して下さい。



A.1.8 RVCT v3.1 における fromelf ユーティリティの変更点


• セクションの名前を変更するための --privacy コマンドラインオプショ

ン。

• 配信可能なイメージとオブジェクトの知的所有権を保護するための --strip コマンドラインオプション。


• ユーティリティガイド




このセクションでは、 RVCT v3.0 と RVCTv2.2 の相違点について説明します。

A.2.1 RVCT v3.0 における主な変更点

RVCT v3.0 では、次の点が変更されました。

• RVCT v3.0 では、以下の 2 つの ARMv7 アーキテクチャのプロファイル

がサポートされます。

ARMv7-A

仮想（MMU ベース）メモリシステム向けの、 ARM 命令セッ

トと Thumb-2 命令セットをサポートするシステムに対応する、

Thumb®-2EE が指定されたアプリケーションプロファイル。

ARMv7-M

Thumb-2 のみに対応するマイクロコントローラプロファイル。

RVCT v3.0 では、 ARMv4 以降のすべての ARM アーキテクチャがサポー

トされます。 ARMv4 より前のすべてのアーキテクチャ名は使用されな

くなったため、サポートされていません。

• RVCT v3.0 では、以下の 2 つの ARM Cortex™ プロセッサファミリがサ

ポートされます。

— Cortex™-A8

— Cortex™-M3

サポートされるすべてのアーキテクチャとプロセッサのリストを参照するには、次のコマンドを使用します。

armcc --cpu list

• RVCT v3.0 では、 Advanced SIMD 拡張（NEON™ テクノロジとも呼ばれま

す）および VFPv3 という ARMv7 アーキテクチャの 2 つのコンポーネン

トが先行してサポートされます。つまり、多数の SIMD （単一命令複数

データ処理）命令といくつかの VFPv3 命令を ARM 命令セットと Thumb-2 命令セットの両方で使用できます。

NEON™ は、信号処理アプリケーションおよび組み込みプロセッサを

ターゲットにした、 64 ビットと 128 ビットのハイブリッド SIMD テクノ

ロジです。 NEON はプロセッサの一部として実装されますが、独自の実

行パイプラインと、 ARM のレジスタバンクとは別のレジスタバンクを

持ちます。 NEON 命令は、 ARM と Thumb-2 の両方で使用できます。



サポートされるすべての浮動小数点アーキテクチャのリストを参照するには、次のコマンドを使用します。

armcc --fpu list

• RVCT v3.0 では、 ARMv7 用の Thumb-2 Execution Environment（Thumb-2EE）がサポートされます。 Thumb-2EE 命令セットは、

Thumb-2 をベースに、動的に生成されるコードに合わせた変更や追加が

行われています。

Thumb-2EE 拡張機能により、新しい命令セットの状態として ThumbEE 状態が導入されます。この状態の命令セットは、 Thumb-2 命令セットと

ほぼ同一です。ただし、動作が変更された命令、および新しく使用できるようになった命令があります。

• ARM アセンブラを使用することにより、 Intel® ワイヤレス MMX™ テク

ノロジの命令をアセンブルし、 PXA270 プロセッサなどのコードを開発

できます。

• RVCT v3.0 では、 ARM アーキテクチャ用 ABI （基本標準）［BSABI］の

新のリリースで必要と定義されているように、 DWARF 3 （DWARF Debugging Standard バージョン 3）のデバッグテーブルが完全にサポート

されます。

DWARF 3 はデフォルトの形式で、以下の内容を含んでいます。

— C++ ネームスペースのデバッグの完全なサポート

— デバッグ情報量の拡大

本リリースのコンパイラおよびアセンブラは、以下のように動作します。

— 形式を指定しない場合は、 DWARF 3 が想定されます。

— --debug （-g）を指定すると、デフォルトでは、 DWARF 3 が生成さ

れます。

コマンドラインオプション --dwarf2 は、下位互換性のために引き続きサ


• ARM コンパイラおよびリンカでスレッドローカル記憶域（TLS）をサ

ポートすることにより、プログラムで複数のスレッドを使用できます。以下の 2 つの新しいキーワードを使用して、MPCore™ で TLS をサポート

できます。

— __declspec(thread)

— __thread



• ARM コンパイラでは、ループの展開など、ハイレベルのスカラの適

化が行われるようになりました。これらの拡張機能は、-O3 を指定してコ

ンパイルする際に自動的に呼び出され、小さなサイズのコードを加えることによってパフォーマンスを大幅に向上できます。

• RVCT v3.0 では、整数（int または long long）をゼロで除算すると、デ

フォルトでゼロが返されます。これは、実行時にエラーメッセージを表示してプログラムを終了していた以前の動作からの変更点です。

• RVCT v3.0 では、エラーメッセージおよび警告メッセージに使用される

言語を変更できます。例えば、英語ベースのワークステーションで日本語のメッセージを表示するには、次のコマンドを使用します。

--message_locale ja_JP

• 以前は ARM コンパイラでのみ使用できた --show_cmdline オプションが、

アセンブラ、リンカ、 armar、および fromelf でも使用できるようになり

ました。このオプションを使用すると、コマンドラインがどのように処理されたかを確認できます。コマンドは正規化されて表示されます。また、 via ファイルの内容は展開されます。ただし、このコマンドを使用

してもコマンドラインの偶発的なエラーはトラップされません。

• RVCT v3.0 では、以下の環境変数が導入されます。

— RVCT30_CCOPT

— RVCT30_LINKOPT

— RVCT30_ASMOPT

この変数の値は、 RVCT ごとに、必要に応じて、コマンド文字列の先頭

に挿入されます。環境変数で指定されたオプションは、コマンドラインの引数でオーバーライドできます。

RVCT v3.0 で廃止された機能


• RVCT v2.2 で使用が制限されていたすべての機能およびオプションは、

RVCT v3.0 で廃止されました。これらの機能およびオプションのリスト

については、『コンパイラユーザガイド』の付録 A 「以前のコマンドラ

インオプションの使用」を参照して下さい。

• 1 つ前の RVCT のリリースでは、メッセージオプションを新しいリリー

スに移行できるようにするため、古いコンパイラオプションをサポートしていました。 v3.0 では、これらのオプションは廃止されたため、サ



ポートされていません。詳細については、『コンパイラユーザガイド』の付録 A 「以前のコマンドラインオプションの使用」を参照して下さ

い。

• 複数行にまたがる文字列は ARM コンパイラでサポートされていません。

この動作は、下位互換性のために、これまで GNU モードでサポートさ

れていました。

• コンパイラ固有の以下のプラグマがサポートされなくなりました。

— check_printf_formats、 check_scanf_formats、および check_vprintf_formats

— [no_]debug

• ソフトウェアスタックチェックのサポートが廃止されました。本リリースでは、以下のコンパイラおよびアセンブラのオプションがサポートされていません。

— --apcs /swst

— --apcs /noswst

— --apcs /swstna

以下の項目は使用できなくなりました。

— プラグマ [no_]check_stack

— 事前定義のマクロ __APCS_SWST

ソフトウェアスタックチェックが行われたバージョンのライブラリは提供されなくなりました。

RVCT v3.0 での使用が制限される機能


• ARM コンパイラでは、以前のバージョンの ARM Developer Suite™

（ADS）のアプリケーションバイナリインタフェース（ABI）と互換性

のあるコードをコンパイルするため、オプション --apcs /adsabi がサ

ポートされます。このオプションは RVCT 3.0 では現在使用が制限され

ていて、 RVCT 3.1 では廃止されています。

• 以下のアセンブラオプションは現在使用が制限されていて、 RVCT 3.1 で廃止されています。

— --no_cache

— --no_regs （代わりに --regnames=none を使用して下さい）

— --checkreglist （代わりに --diag_warning 1206 を使用して下さい）



• セクション属性の修飾子（RO、 RW、 ZI、および DBG）とリンカオプション --remove の併用のサポートは、現在制限されていて、今後のリリースで

廃止される予定です。

• C++ コンフィギュレーションオプション --dll_vtbl が、新しいオプショ

ン --export_all_vtbl に置き換わりました。--dll_vtbl は、現在使用が制限

されていて、今後サポートされなくなります。

• --memaccess -UL41 のサポートは現在使用が制限されており、将来のリ

リースでは廃止される予定です。 --memaccess -UL41 は --no_unaligned_access に置き換えられます。

• コンパイラオプション --depend_format=unix は --unix_depend_format に置き

換わりました。このオプションは現在使用が制限されていて、今後のリリースで廃止される予定です。

• RVCT v3.0 では fromelf --text の構文が異なります。以下の形式は現在使

用が制限されていて、今後のリリースで廃止される予定です。

— fromelf --text=xx

— fromelf --text/xx

• ARM では、 __user_stack_slop 関数の使用をお勧めしません。このオプ

ションは現在使用が制限されていて、今後のリリースで廃止される予定です。



• RVCT v3.0 の移植性の高い新機能の一部として、新しいコンパイラオプ

ション --library_interface で、コンパイラの出力が RVCT ライブラリや AEABI 準拠のライブラリと連動するように指定します。例えば、 --library_interface=aeabi_glibc を使用して、 AEABI 準拠の GNU C ライ

ブラリと出力が連動するように指定できます。

• ARM コンパイラでは、スレッドローカル記憶域（TLS）をサポートす

ることにより、プログラムで複数のスレッドを使用できるようになりました。 TLS を使用すると、各スレッドがグローバル変数を変更する場合

がありますが、その変更は該当スレッドのみで認識されます。以下の 2 つのキーワードが使用できるようになりました。

— __declspec(thread) は、変数がスレッドローカルで、スレッドの保

存期間が設定されていることを示します。



— __thread は、 __declspec(thread) と同じ意味です。

• ARMv7 より前の ARM プロセッサでは、SWI 命令または SVC 命令を使用し

てセミホスティング呼び出しを行います。ただし、 Cortex™-M3 プロセッ

サ用にコンパイルしている場合、セミホスティングは BKPT 命令を使用し

て実装されます。

新しいコンパイラ組み込み関数 __semihost() を使用すると、ターゲット

アーキテクチャとは関係のないセミホスティング呼び出しを C または C++ から行うことができます。

• ARM コンパイラでは、ARM 状態および Thumb 状態の両方で Cortex™-A8 プロセッサ用のコードを生成する組み込み関数を提供することで、NEON™ テクノロジをサポートします。

• ARM コンパイラでは、フィードバック適化（FDO ： Feedback Directed Optimization）が実用的ではない場合に分岐予測情報を提供するために GCC builtin 関数 __builtin_expect がサポートされます。この関数は、

GNU モードおよび ARM モードで使用できます。

• ARM コンパイラには、オブジェクトのサイズを表示するための --info totals オプションがあります。このオプションを使用して、コンパイル

されたオブジェクトのコードとデータ（RO データ、 RW データ、 ZI データ、およびデバッグデータ）のサイズを確認します。

• ARM コンパイラには、 Windows 用の新しい --depend_format=string オプ

ションがあります。これにより、 UNIX の一部の make プログラムとの

互換性を確保するために、出力に依存するファイルの形式が UNIX 形式

に変更されます。

• ARM コンパイラでは、C++ ファイルの .cc 拡張子が認識されるようにな

りました。認識されない拡張子が、 filename.cmd のように .c で始まる場

合は、警告メッセージが表示されます。

• GNU コンパイラの拡張機能に対するサポートの一環として、 armcc では、--gnu オプションの使用時に C と C++ 両方の条件を使用できます。条

件付きステートメントの中間にあるオペランドは、結果がテストと同じになる場合は省略できます。例えば、以下のようになります。

i ? i : j

これは、 i が一度だけ評価されるようにテストで値を変更する場合に

も役立ちます。



• RVCT v3.0 では、 POSIX 関数 wcstombs() でマルチバイト文字のシーケン

スをある配列から変換してその文字を別の配列に保存するためのコンパイラおよびライブラリがサポートされます。

• ARM コンパイラでは、オプション --unaligned_access がサポートされま

す（このオプションは、現在使用が制限されているオプション --memaccess に代わるオプションです）。

• AAPCS では、ビットフィールドをデフォルトで符号なしの値にする必

要がなくなりました。これを受けて、ビットフィールドが符号付きであることを指定する新しいオプション --signed_bitfields が追加されまし

た。デフォルトは、--unsigned_bitfields です。

• ARM コンパイラでは、書き込み先アドレスが不明なすべてのシンボル

について .directive セクションが作成されました。この要件は、 ELF 標準メカニズムによって破棄されました。そのため、 dllimport が指定され

たシンボルの動作が変更されることがあります。以下に例を示します。

__declspec(dllimport) int f();int g() { return f(); }

この例では、 .directive セクションが生成されません。

• コンパイラには、 __user_initial_stackheap() と同じように初期スタック

およびヒープの場所を返す新しい __user_setup_stackheap() 関数が含まれ

ています。テンポラリスタックについては要件がないので、__user_setup_stackheap() では、 __user_initial_stackheap() と比べてコード

サイズが小さくなります。

• ARM コンパイラでは、 gcc でレポートされる形式に一致するメッセージ

を表示するためのコマンドラインオプション --diag_style gnu がサポート

されるようになりました。これは、以前のリリースで使用できる arm 形式および ide 形式に加えて新たに使用できるようになった形式です。

• 各関数の先頭にある組み込みアセンブラの状態は、 #pragma arm プラグマ

および #pragma thumb プラグマで変更されたように、コンパイラの呼び出

しで設定されています。

また、組み込みアセンブラの状態は、関数内部で変更できます（この状態は、現在の関数内でのみ保持されます）。これを行うには、組み込みアセンブラ関数で、明示的な ARM、 THUMB、または CODE16 ディレクティブ

を使用します。





• ARM アーキテクチャ用 C ライブラリ ABI [CLIBABI] では、コンパイラ _AEABI_PORTABILITY_LEVEL でチェックされる適合性のテストについて定義

しています。このテストを利用すると、 CLIBABI の他の実装に対する

コードの移植性を高めることができます。

• ARM アーキテクチャ用 ABI （基本標準）［BSABI］の新版では、

assert() マクロの定義の欠陥が修正され、 1 つの信号適合性の義務が導

入されています。このマクロは、新版で __aeabi_assert() として定義

されています。詳細については、 assert.h を参照して下さい。

• RVCT v3.0 には、スレッドセーフな文字列関数 strlcpy および strlcat のライブラリサポートが用意されています。

• RVCT v3.0 では、新しいライブラリによる __user_initial_stackheap() の実装が用意されています。つまり、 ARM_LIB_STACK、 ARM_LIB_HEAP、

ARM_LIB_STACKHEAP などのディレクティブが含まれた分散ロードファイル

を使用する場合、この関数を再実装する必要はありません。

• RVCT v3.0 の新しいライブラリメカニズムでは、コードで __use_no_heap や __use_no_semihosting などの __use_no_* シンボルを参照する際にシンボ

ルの競合が発生した場合、より詳しいエラーメッセージが表示されます。

• POSIX に完全に準拠するために、 armar では、直前に - がないコマンドラ

インオプションが使用できなくなりました。例えば、以下の形式のコマンドがあるとします。

armar cru lib.a foo.o

この場合、このコマンドは失敗します。以前のバーションの RVCT で生

成したビルドスクリプトやメークファイルを使用している場合、上記のコマンドの変更が必要になることがあります。

• armar では、 gcc でレポートされる形式に一致するメッセージを表示する

ためのコマンドラインオプション --diag_style gnu がサポートされるよう

になりました。これは、以前のリリースで使用できる arm 形式および ide 形式に追加されています。





• 新リリースのリンカでは、 SVr4 のイメージおよび共有ライブラリの

スレッドローカル記憶域（TLS）のみがサポートされます。リンカの実

装の詳細については、 ARM アーキテクチャ用 ABI ［ABI-addenda］の正

誤表および追捕表を参照して下さい。

• RVCT v3.0 には、新しいリンカオプション --compress_debug があります。

これにより、 .debug_* セクションが強制的に圧縮されるため、冗長性が

軽減され、デバッグテーブルのサイズが改善されます。ただし、--compress_debug オプションを使用すると、リンク時間が長くなりま

す。

• RVCT v3.0 には、新しいリンカオプション --info libraries があります。

これにより、リンクステージに対して自動的に選択されたすべてのライブラリの完全パス名が出力されます。このオプションを修飾子 --info_lib_prefix と共に使用すると、特定のライブラリに関する情報を

表示できます。

• RVCT v3.0 には、新しいリンカオプション --no_legacyalign があります。

これにより、リンカではセクションを配置する際に自然配列が使用されます。

• RVCT v3.0 には、新しいリンカオプション --dynamic_debug があります。

これにより、リンカではデバッグセクションのダイナミックな再配置が出力されます。

• RVCT v3.0 には、新しいリンカオプション --show_cmdline があります。こ

のオプションを使用すると、リンカでコマンドラインがどのように処理されたかを確認できます。

• ARM リンカでは、 gcc でレポートされる形式に一致するメッセージを表

示するためのコマンドラインオプション --diag_style gnu がサポートされ

るようになりました。これは、以前のリリースで使用できる arm 形式お

よび ide 形式に追加されています。





• RVCT v3.0 では、 ARMv7 に対する Thumb-2 Execution Environment（Thumb-2EE）アーキテクチャの拡張機能がサポートされます。これは Thumb-2 をベースにしています。主要な相違点は以下のとおりです。

— Thumb 状態と新しい ThumbEE 状態の両方で状態を変更する ENTERX および LEAVEX という新しい命令

— ハンドラに分岐するための新しい HB、 HBL、 HBLP、および HBP 命令

— ロードおよびストアでの NULL ポインタチェック

— 配列の境界をチェックするために追加された ThumbEE 状態の CHKA 命令

— ロード命令、ストア命令、および分岐命令（BX、 BLX、および BXJ）に対するその他の変更

• RVCT v3.0 では、ARMv7 アーキテクチャの 2 つのオプションコンポーネ

ントであるアドバンスト SIMD 拡張機能および VFPv3 の初期サポートが

提供されます。

ARM アドバンスト SIMD 拡張機能の構成は以下のとおりです。

— アドバンスト SIMD レジスタ。このレジスタは、 VFPv3 レジスタ

バンクと同じですが、32 個の 64 ビットレジスタまたは 16 個の 128 ビットレジスタと見なされます。

— アドバンスト SIMD レジスタを要素のベクタと見なす、多数の新

しい命令。

これらの新しい命令は、 ARM 命令セットと Thumb-2 命令セットの

両方で使用できます。

VFPv3 は、 VFPv2 から次のように拡張されています。

— 以前の VFP レジスタバンクの 2 倍にあたる 32 個の 64 ビットレジ

スタへの大幅な拡張。これらのレジスタは、メインの ARM 汎用レ

ジスタを除いたものです。

— よく使用される多数の浮動小数点数値のロードおよび浮動小数点形式と固定小数点形式間の変換を効率良くする複数の新しい命令。

これらの新しい命令は、 ARM 命令セットと Thumb-2 命令セットの

両方で使用できます。



• Advanced SIMD 命令のサポートの一環として、浮動小数点ステータス /制御レジスタ（FPSCR）のビット 27 は、整数の飽和演算で飽和が発生

したときに表示するための累積フラグとして予約されています。

• ARM アセンブラを使用することにより、インテルワイヤレス MMX テクノロジの命令をアセンブルし、 PXA270 プロセッサ用のコードを開発

できます。 2 つの新しいディレクティブが導入され、ロード命令とスト

ア命令の構文がシンボルおよびリテラルをサポートするように変更されました。

• リストをファイルに出力するには、次のオプションを使用します。

--list file

file が指定されていない場合は、--list= を使用して、出力を inputfile.lst に送ります。

注 --list を使用すると、出力を .lst ファイルに送信できます。ただし、こ

の構文は現在使用が制限されているため、この構文を使用するとアセンブラによって警告メッセージが表示されます。

• 以下の 2 つの新しいディレクティブが導入されました。

— RELOC。オブジェクトファイルで ELF の再配置をエンコードしま

す。

— QN。指定した NEON™ クワッドワードレジスタの名前を定義しま

す。

• ARM アセンブラでは、 gcc でレポートされる形式に一致するメッセージ

を表示するためのコマンドラインオプション --diag_style gnu がサポート

されるようになりました。これは、以前のリリースで使用できる arm 形式および ide 形式に加えて新たに使用できるようになった形式です。

• armasm --debug を指定したときに、ローカルシンボルが保持されなくなり

ました。デバッグのためにローカルシンボルを保持する場合は、--keep を指定する必要があります。

• RVCT v2.2 では、 Thumb アセンブラコードでローカルラベルと共に LDR 疑似命令を使用すると、 Thumb のビットが設定されていないアドレスに

なりました。使用中のコードでこの動作が必要な場合は、 armasm

--untyped_local_labels を使用して下さい。





• fromelf ユーティリティでは、 ELF 出力ファイルからコードセクションお

よびデータセクションを削除するための --debugonly オプションがサポー

トされるようになりました。

• RVCT v3.0 では fromelf --text の構文が異なります。以下の形式は現在使

用が制限されていて、今後のリリースで廃止される予定です。

— fromelf --text=xx

— fromelf --text/xx

• RVCT v3.0 には、 fromelf の新しいオプション --show_cmdline があります。

このオプションを使用すると、 fromelf ユーティリティでコマンドライ

ンがどのように処理されたかを確認できます。

• fromelf ユーティリティでは、 gcc でレポートされる形式に一致するメッ

セージを表示するためのコマンドラインオプション --diag_style gnu がサ

ポートされるようになりました。これは、以前のリリースで使用できる arm 形式および ide 形式に追加されています。



A.3 RVCT v2.2 SP1 と RVCT v2.2 の相違点

このセクションでは、 RealView Developer Suite v2.2 Service Pack 1 （SP1）付属

の RVCT v2.2 と、その前のリリースの相違点について説明します。

相違点を以下に示します。

• RVCT v2.2 SP1 では、 ARM1136J(F)-S-rev-1 コアがサポートされます。サ

ポートされるすべてのコアのリストを参照するには、次のコマンドを使用します。

armcc --cpu list

• 共有オブジェクトを作成するときは、 ARM リンカにより提供される次

の新しいオプションを使用します。

— --pt_arm_exidx を使用すると、例外テーブルの場所を記述する PT_ARM_EXIDX プログラムヘッダが作成されます。リンカでは、共有

オブジェクトに PT_ARM_EXIDX プログラムヘッダが含まれていると、

例外がスローされる可能性があると判断します。

— --force_so_throw を使用すると、リンカではすべての共有オブジェ

クトが例外をスローする可能性があると判断します。

これらのコマンドラインオプションの詳細については、『リンカ / ユー

ティリティガイド』の System V 共有ライブラリについて説明した章を

参照して下さい。

• プリプロセッシングディレクティブ #warning がサポートされます。その

結果、コンパイル時にユーザ定義の警告が生成されますが、コンパイルは停止しません。

• キーワード __restrict および __restrict__ は、 restrict の同義語としてサ

ポートされます。本リリースでは、--restrict だけでなくすべてのモード

でこの 2 つのキーワードを使用できます。

• GNU モードと ARM モードの両方で deprecated 関数属性がサポートされ

ます。

int Function_Attributes_deprecated_0(int b) __attribute__ ((deprecated));

• fromelf ユーティリティで、 ELF 出力ファイルから .comment セクションを

削除するための --no_comment_section オプションがサポートされるように

なりました。



• コンパイラオプション --enum_is_int のストレージ型の選択方法が変更さ

れました。列挙子の範囲が signed int の範囲より大きく、 unsigned int の範囲内にある場合、 enum の格納型は unsigned int になります。

以下に例を示します。

enum E { k = 0x8000000 }; /* is treated as unsigned int */

• ARM アセンブリ言語を開発する一環として、 SWI 命令の名前が SVC（スーパーバイザコール）に変更されました。

命令は、元は SWI だったというコメント付きで SVC に逆アセンブルされ

ます。例えば、 fromelf --text -c からは次の出力が生成されます。

...0x00000fbc: e3a00010 .... MOV r0,#0x100x00000fc0: ef123456 V4.. SVC 0x123456 ; formerly SWI...





します。



• 新しい Thumb®-2 命令セットがサポートされます。 Thumb-2 には、多数

の新しい 32 ビット命令と、いくつかの新しい 16 ビット命令が導入され

ました。 ARM1156T2(F)-S など、 Thumb-2 をサポートするプロセッサ上

で、 ARM に匹敵するパフォーマンスと初代 Thumb と同等のコードサイ

ズを両立します。

Thumb-2 命令セットには、以前の 16 ビット Thumb 命令がサブセットと

して含まれています。

• RVCT v2.2 では、新しい ARMv6 コアがサポートされます。例えば、

ARM TrustZone™ テクノロジ向けに適化したソフトウェアが組み込ま

れた ARM1176JZ(F)-S、 ARM968EJ-S、 ARM1156T2(F)-S、 ARM MPCore™ などがサポートされます。

RVCT v2.2 アセンブラでは、 MPCore 命令がサポートされます。

• 新しいアセンブラ構文をサポートすると同時に、従来のコードをアセンブルするため引き続き古い構文もサポートします。

• ARM アーキテクチャ用ベースプラットフォーム ABI ［BPABI］に完全に

準拠しているので、 ARM Linux、 Symbian OS など、さまざまなオペレー

ティングシステムをサポートします。

• ARM アーキテクチャ用 ABI （基本標準）［BSABI］に記載されているよ

うに、 DWARF 3 （Draft Standard 9）デバッグテーブルの初期サポートが

提供されます。コードをコンパイルするときにこの形式を指定するために、新しいコマンドラインオプション --dwarf3 を使用できるようになり

ました。

• コマンドラインオプション --debug または -g を指定すると、現在のコン

パイル用のデバッグテーブルが生成されます。適化オプションを指定する場合は、-Onum を使用します。デフォルトでは、--debug オプションや -g オプションを使用しても、適化の設定に影響しません。



これは、 RVCT v2.2 で動作が変更された点です（RVCT v2.1 では、--debug または -g のみで [--debug|-g] -O0 と同じ意味でした）。この新しいデフォ

ルト動作を除き、適化オプション -Onum、-Ospace、または -Otime の動作

は変更されていません。

• RVCT v2.2 では、コマンドラインオプション --apcs /fpic がサポートされ

ており、 System V の共有ライブラリと互換性があるコードをコンパイル

できます。このオプションを使用すると、相対アドレス参照がプログラムをロードした場所に依存しない、読み出し専用の位置非依存コードが生成されます。

• ARM リンカで、共有ライブラリのビルドと、共有ライブラリに対する

リンクがサポートされます。また、 SVr4 の実行可能ファイルと共有オ

ブジェクトをビルドしたり、コードの生成方法を指定したりするための新しいコマンドラインオプションも使用できます。

• ARM リンカは ARM アーキテクチャ用ベースプラットフォーム ABI ［BPABI］に準拠し、 GNU 拡張シンボルバージョン管理モデルをサポー

トします。

• 浮動小数点演算に関する ARM の実装が、 C99 関数のサポートを強化す

るように変更されています。これによって動作が大幅に変更された部分では、開発者は新しく導入された互換性モードを使用して、容易にコードを移行して新機能を使用できます。詳細については、「RVCT v2.2 にお

けるライブラリサポートの変更点」（ページ A-33）を参照して下さい。

• 列挙値が範囲外の場合に警告が表示されるようにするため、 ARM コン

パイラの C 言語実装が変更されました。範囲外の値は C++ の場合と同

様に処理されます。つまり、 C を使用している場合、 RVCT の新のリ

リースにアップグレードすると、範囲外の値が含まれた enum 型はサイズ

が変わる可能性があります。

C++、またはコマンドラインオプション --enum_is_int、--strict、--strict_warnings のいずれかを使用している場合、

このような変更はありません。詳細については、「RVCT v2.2 における ARM コンパイラの変更点」（ページ A-31）を参照して下さい。

• マルチスレッド処理のサポートを強化するため、 ARM ライブラリが拡

張されました。 RTOS ベースのシステムを使用する開発者のための変更

です。



• 動的シンボルのエクスポート方法をより制御しやすくするため、 ARM コンパイラに以下の新しいオプションが用意されています。

— --dllexport_all

— --no_hide_all

• RVCT の他のコンポーネントでは実行できない分岐の適化を ARM リンカで実行できます。セクションの後で分岐命令を適化する Tail の呼び出しセクションを処理するため、 2 つの新しいコマンドラインオプ

ションを使用できます。

• RVCT v2.1 で使用が制限されていたオプションは、 v2.2 で使用されなく

なりました（詳細については、「「RVCT v2.2 で廃止された機能」」を参照

して下さい）。

• RVCT v2.1 でサポートされていたオプションの一部は、 v2.2 で使用が制

限されています（詳細については、「RVCT v2.2 での使用が制限される機

能」（ページ A-30）を参照して下さい）。

RVCT v2.2 で廃止された機能


• RVCT v2.1 で使用が制限されていたすべての機能およびオプションは、

RVCT v2.2 で廃止されました。以下に例を示します。

— ARM Object Format （AOF）、 ARM Library Format （ALF）形式のライ

ブラリなど、従来の Software Development Toolkit （SDT）形式

— armlink -help のように、キーワードに単一のダッシュを使用するこ

と

— コンパイラオプション -ansi および -ansic

• -fy、-fd、-Ec、-zo など、 RVCT v2.1 で使用が制限されていた古いコンパイ

ラオプションの名前は、 RVCT v2.2 では廃止されました。

より適切なオプション名が存在する場合は、コンパイラによって警告が表示されます。以下に例を示します。

armcc -zoWarning: X0010W: Old syntax, please use '--split_sections'.

これらの機能およびオプションのリストについては、『コンパイラユーザガイド』の付録 A 「以前のコマンドラインオプションの使用」を参照

して下さい。



• 以下の古い ARM プロセッサおよびアーキテクチャは廃止されました。

— ARM6

— ARMv3 および ARMv3M

サポートされるすべてのコアのリストを参照するには、次のコマンドを使用します。

armcc --cpu list

• 以下の古い浮動小数点アーキテクチャは廃止されました。

— VFPv1 （デフォルトは VFPv2）

— FPA

— ソフト FPA

指定がない場合のデフォルトはソフト VFP です。

サポートされるすべての浮動小数点アーキテクチャのリストを参照するには、次のコマンドを使用します。

armcc --fpu list

• 以下のコンパイラオプションを使用できなくなりました。

— --fpu fpa、--fpu softfpa、および --fpu vfpv1

— --fa

— --cpu 3 および --cpu 3M

— -Oldrd および -Ono_ldrd

— -Wletter および -Eletter

• SXT 命令および UXT 命令（符号拡張またはゼロ拡張）の同義語がサポート

されません。

• FPA レジスタ f0-f7 および F0-F7 が使用されなくなりました。

• 使用が制限されているオプションがある場合に警告メッセージを表示する環境変数 RVCT21_CLWARN がサポートされません。



RVCT v2.2 での使用が制限される機能


• 以前のバージョンの ARM Developer Suite™ （ADS）のアプリケーション

バイナリインタフェース（ABI）と互換性があるコードをコンパイルす

るため、コンパイラオプション --apcs /adsabi がサポートされます。こ

のオプションは現在使用が制限されていて、今後のリリースで廃止される予定です。

• ARM リンカと fromelf では、--no_debug や --nodebug のように無効化オプ

ションを 2 つの形式で使用できます。ただし、--nodebug などの非標準の

形式は現在使用が制限されており、将来サポートされなくなります。使用が制限されている構文を使用すると、警告が表示されます。

• C++ コンフィギュレーションオプション --dll_vtbl が、新しいオプショ

ン --export_all_vtbl に置き換わりました。オプション --dll_vtbl は現在

使用が制限されており、将来サポートされなくなります。

• RVCT アセンブラは Load Register EXclusive 命令を以下の 2 つの形式でサ

ポートします。

— LDREX{B|D|H}{cond} Rd, [Rn]

— LDR{B|D|H}EX{cond} Rd, [Rn]

2 番目の形式は現在使用が制限されていて、今後のリリースで廃止され

る予定です。

逆アセンブラでサポートされるのは初の形式のみです。

• RVCT アセンブラは Store Register EXclusive 命令を以下の 2 つの形式でサ

ポートします。

— STREX{B|D|H}{cond} Rd, [Rn]

— STR{B|D|H}EX{cond} Rd, [Rn]

2 番目の形式は現在使用が制限されていて、今後のリリースで廃止され

る予定です。

逆アセンブラでサポートされるのは初の形式のみです。





• ARM コンパイラには、動的なシンボルのエクスポート方法をより制御

しやすくするため、以下の新しいオプションが用意されています。

— --export_all_vtbl を使用すると、すべての仮想テーブル関数および

キー関数が含まれたクラスの RTTI がエクスポートされます。

— --export_defs_implicitly を使用すると、 dllimport が指定されたプロ

トタイプの定義がエクスポートされます。

• ARM コンパイラには、共有オブジェクトまたは DLL を作成するときに

シンボルを可視化するための、次の新しいオプションが用意されています。

— --dllexport_all を使用すると、他に何も指定しなくても、すべての

グローバルシンボルを動的に可視化できます。

— --no_hide_all を使用すると、すべての extern 定義がエクスポートさ

れ、すべての未定義参照がインポートされます。

• r12 ではなく r7 を使用する点を除き、新しい __swi_indirect_r7 は __swi_indirect_r12 と同様に動作します。 ARM Linux 上の Thumb アプリ

ケーションでは、 __swi_indirect_r7 を使用してカーネルのシステムコー

ルを作成します。

• オーバーロードしたグローバルの operator new を throw() として処理でき

るよう、--force_new_nothrow の動作が拡張されました。

• 列挙値が範囲外の場合に警告が表示されるようにするため、 ARM コン

パイラの C 言語実装が変更されました。

厳密な C では、列挙値は -2147483648 ～ +2147483647 （境界値を含む）

の範囲の int で表現できる必要があります。以前のリリースの RVCT では、--strict オプションを指定した場合を除き、範囲外の値は警告が表示

されることなく int にキャストされました。

RVCT v2.2 ではこのような値は C++ でも同様に、unsigned int、long long、

または unsigned long long として扱われます。つまり、 C を使用している

場合、 RVCT の新のリリースを使用していると、範囲外の値が含まれ

た enum 型はサイズが変わる可能性があります。以下に例を示します。

enum E1 { k1 = 0xffffffff }; /* value == 2147483648u; out-of-range in C *//* C: before 2.2: sizeof(enum E1) == 1 *//* C: 2.2: sizeof(enum E1) == 4 *//* C++: all: sizeof(enum E1) == 4 */



enum E2 { k2 = (int)0xffffffff }; /* value == -1; in range *//* C: before 2.2: sizeof(enum E1) == 1 *//* C: 2.2: sizeof(enum E1) == 1 *//* C++: all: sizeof(enum E1) == 1 */

enum E3 { k3 = -1, k4 = 0xffffffff }; /* value == 2147483648u; out-of-range in C *//* C: before 2.2: sizeof(enum E1) == 1 *//* C: 2.2: sizeof(enum E1) == 8; use long long *//* C++: all: sizeof(enum E1) == 8; use long long */

列挙値が範囲外であることを示す警告が表示されるようにするには、以下のコマンドを使用して警告をエラーに変更します。

armcc --diag_error 66 ...

C++、またはコマンドラインオプション --enum_is_int、--strict、--strict_warnings のいずれかを使用している場合、

このような変更はありません。

• ARM モードと GNU モードの両方で __attribute__ キーワードの使用がサ


• イニシャライザが指定されていない変数を ZI データセクションに配置

することを明示するため、新しい変数属性 zero_init または __zero_init__ がサポートされます。

• 新しいオプション --dwarf3 を使用すると、 C または C++ で記述された

コードのコンパイル時に ARM または Thumb のプログラムを記述するた

めに、 DWARF 3 標準のデバッグテーブルを指定できます。形式を指定

しない場合は、 DWARF 2 が想定されます。

• ARM コンパイラに渡すコマンドラインオプションを指定するための新

しい環境変数 RVCT22_CCOPT がサポートされます。

• RVCT v2.2 では、コマンドラインオプション --apcs /fpic がサポートされ

ており、 System V の共有ライブラリと互換性があるコードをコンパイル

できます。このオプションを使用すると、相対アドレス参照がプログラムをロードした場所に依存しない、読み出し専用の位置非依存コードが生成されます。

• 割り込み処理を制御するための以下の新しい組み込み関数があります。

— __enable_irq() および __disable_irq()

— __enable_fiq() および __disable_fiq()

• また、適化を制御するための新しい以下の組み込み関数もあります。

— __schedule_barrier()

— __force_stores()



— __memory_changed()

• テンプレートパラメータに依存する名前の型の有無を、状況から暗黙的に判断するかどうかを指定する次の新しいオプションがあります。

— --implicit_typename

— --no_implicit_typename

デフォルトは --no_implicit_typename です。

• コンパイラを呼び出すときに、--show_cmdline オプションを使用すると、

コマンドラインがどのように処理されたかを確認できます。コマンドは正規化されて表示されます。また、 via ファイルの内容は展開されます。

ただし、このコマンドを使用してもコマンドラインの偶発的なエラーはトラップされません。

• 適化レベル -O3 での浮動小数点演算に関して、 ISO の C と C++ の標準

に準拠していることが保証されなくなりました。 ISO の C と C++ の標準

に準拠するには、--fpmode=std オプションを使用する必要があります。

• ISO C 標準の規定に従い、 const volatile （および volatile const）データ

は、 RW セクションまたは ZI セクションに配置されるようになりまし

た。これらのデータは、以前は RO セクションに配置されていました。

この仕組みでは、コンパイラによるデータの配置を仮定した場合に、コードに影響する可能性があります。



• 浮動小数点演算に関する ARM の実装が、 C99 関数のサポートを強化す

るように変更されています。これによって動作が大幅に変更された部分では、開発者は新しく導入された互換性モードを使用して、容易にコードを移行して新機能を使用できます。 fplib での新しい（または、動作が

変更された） C99 関数は以下のとおりです。

— ilogb, ilogbf, ilogbl

— logb, logbf, logbl

— scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl

— nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl

mathlib での新しい（または、動作が変更された） C99 関数は以下のとお

りです。

— fpclassify および signbit



— isfinite、 isinf、 isnan、および isnormal

— copysign, copysignf

— isgreater、 isgreaterequal、 isless、 islessequal、 islessgreater、およ

び isunordered

コードを移植しやすくするため、新しい互換性モードを使用することで以下の関数とマクロの動作がエミュレートされます。

— ilogb, ilogbf, ilogbl

— finite

— isnan

注この古い関数のサポートは、今後のリリースで廃止される予定です。こ

れらの関数を使用している場合は、新版のコンパイラの等価な関数に移行することをお勧めします。

• マルチスレッド処理のサポートを強化するため、 ARM ライブラリが拡

張されました。 RTOS ベースのシステムを使用する開発者のための変更

です。

ユーザがオーバーライドできる関数 __user_libspace() が以下の 2 つの

ラッパ関数に分割されました。

__user_perproc_libspace()

プロセス全体で使用される（つまり、すべてのスレッドで共有する）グローバルデータを保存する __user_libspace データ領

域へのポインタを返します。

__user_perthread_libspace()

特定のスレッドのローカルデータを保存する __user_libspace データ領域へのポインタを返します。

この他に、同時アクセスによって共有データが破損しないようにするロックメカニズムを管理するため、ユーザがオーバーライドできる以下の 3 つの新しい関数があります。

_mutex_initialize()

32 ビットワードのポインタを取得し、有効なミューテックス

として初期化します。

int _mutex_initialize(mutex *m);

_mutex_acquire()

この関数の呼び出し側スレッドは、指定されたミューテックスのロックを取得します。



void _mutex_acquire(mutex *m);

_mutex_release()

この関数の呼び出し側スレッドは、指定されたミューテックスを解放します。

void _mutex_release(mutex *m);

上記の変更によって、マルチスレッド環境での一部関数の動作が変更され、マルチプロセスシステムでこれらの関数を開発者がより簡単に使用できるようになりました。

• ARM ライブラリアン armar では、行番号や文字数を含めるなど、診断

メッセージの表示方法を指定するために、コマンドラインオプション --diag_style がサポートされます。

armar --diag_style ide

デフォルトは ARM 形式（つまり、 --diag_style arm）です。



• ARM リンカは ARM アーキテクチャ用ベースプラットフォーム ABI ［BPABI］に準拠し、 GNU 拡張シンボルバージョン管理モデルをサポー

トします。 ARM リンカには、シンボルバージョン管理を制御する次の

新しいオプションがあります。

— --symver_script file を使用すると、暗黙のシンボルバージョン管理

が有効になり、シンボルバージョンスクリプトとして file を入力で

きます。

— --symver_soname を使用すると、暗黙のシンボルバージョン管理およ

びバージョンシンボルが有効になり、静的バインドが行われます。

シンボルにバージョンが定義されていない場合は、リンクしているファイルの SONAME が使用されます。

注一般的に、シンボルバージョン管理は、 DSO または共有ライブラリを

作成したり、それらにリンクしたりするときにのみ有用です。静的リンクには影響しません。

• RVCT の他のコンポーネントでは実行できない分岐の適化を ARM リンカで実行できます。



適化を制御する新しいコマンドラインオプションは、次の 2 つです。

— --inline を使用すると、分岐のインライン化が可能になります。デ

フォルトでは、インライン化は無効です。

— --info inline を使用すると、関数をインラインにするごとに情報が

表示され、インラインの総数を確認できます。

--inline と --feedback file の両方を指定すると、リンカによりインライ

ン化された関数がフィードバックファイルに書き込まれます。

• セクションの後で分岐命令を適化する Tail の呼び出しセクションを

処理するため、次の 2 つの新しいコマンドラインオプションを使用でき

ます。

— --tailreorder を使用すると、可能であれば Tail の呼び出しセクショ

ンをターゲットの上に移動します。

— --info tailreorder を使用すると、移動した Tail の呼び出しセクショ

ンに関する情報が表示されます。

• ARM リンカでのベニア生成を制御するため、次の 2 つのコマンドライ

ンオプションがあります。

— --no_inlineveneer を使用して、インラインベニアを無効にします。

— --no_veneershare を使用すると、ベニアが共有されません。

• ARM リンカで、共有ライブラリのビルドと、共有ライブラリに対する

リンクがサポートされます。また、 SVr4 および BPABI の実行可能ファ

イルと共有オブジェクトである BPABI DLL をビルドしたり、コードの

生成方法を指定したりするための次の新しいコマンドラインオプションも使用できます。

— --sysv を使用すると、SVr4 形式の ELF ファイルをビルドできます。

— --shared を使用すると、 SVr4 共有オブジェクトをビルドできます。

— --soname name を使用すると、共有オブジェクトの SONAME を指定でき

ます。

— --fpic を使用すると、位置非依存コードがリンクされます。

— --init symbol を使用すると、初期化コードを指定できます。

— --fini symbol を使用すると、実行可能ファイルまたは共有オブジェ

クトをアンロードするときにコードを実行できます。

— --linux_abitag id を使用すると、小限の互換性を持つ Linux カー

ネルバージョンを指定できます。



— --dynamiclinker name を使用すると、デフォルトの動的リンカを変更

できます。

• スタートアップシンボルが異なる代替の C ライブラリを使用するため、

新しいリンカオプション --startup を使用できます。同様に、 C++ 初期

化コードには --cppinit オプションを使用できます。

• ARM リンカオプション --symbols を使用すると、リンク手順で使用され

ているローカルおよびグローバルのシンボルの一覧が作成されます。RVCT v2.2 のデフォルトでは、この出力結果にマッピングシンボルが含

まれません。新しいコマンドラインオプション --list_mapping_symbols を使用すると、--symbols の出力結果にマッピングシンボルを含めることが

できます。

• ARMv3 （RVCT v2.2 で使用されなくなりました）を指定するオブジェク

トを検出した場合、そのオブジェクトを ARMv4 にアップグレードして、

ARM ライブラリで使用できるようにします。ターゲットアーキテク

チャレベルを上げた場合は、警告メッセージが表示されます。

• ARM リンカを使用して、スキャッタロード記述ファイルでシンボル名

を使用して入力セクションを参照できます。『リンカ / ユーティリティ

ガイド』の input_symbol_pattern の説明を参照して下さい。



• ARMv6T2 には、 Thumb 命令セットのメジャーアップデートである Thumb-2 が定義されています。 ARM 命令セットとほぼ同一の機能が提

供されます。 16 ビットと 32 ビットの命令を備え、 ARM に類似したパ

フォーマンスと Thumb に類似したコード密度を両立しています。

ARMv6T2 には、 ARM 命令セットの新しい命令も定義されています。

アセンブラでは ARM と Thumb-2 の新しい命令がすべてサポートされま

す。

• ARMv6 アーキテクチャの新しい拡張機能がサポートされます。

— ARMv6Z には、 ARM1176JZ(F)-S コアで使用される ARM Security Extensions （TrustZone）が定義されています。

— ARMv6K には、 ARM MPCore で使用されるシンメトリックマルチ

プロセッサシステム（SMP）の命令が定義されています。



• RVCT v2.2 アセンブラを使用すると、記述したソースコードを ARM または Thumb-2 の命令にアセンブルできます。 Thumb-2 以前のプロセッサ

を使用する場合、同じ言語を使用して Thumb 命令を記述できます。

ただし RVCT v2.2 では、従来のコードをアセンブルするため、古いアセ

ンブリ言語の構文もサポートします。

• 指定されたサイズのメモリブロックを指定されたシンボルに割り当てる COMMON ディレクティブをサポートします。また、メモリをどのように整

列させるかも指定できます。

COMMON symbol{,size{,alignment}}

• DWARF 3 標準のデバッグテーブルを指定するための新しいオプション --dwarf3 があります。デフォルトは DWARF 2 のままです。

• 共有オブジェクトまたは DLL を作成するときにシンボルを可視化する

ため、次の新しいオプションが用意されています。

— --dllexport_all を使用すると、他に何も指定しなくても、すべての

グローバルシンボルを動的に可視化できます。

— --no_hide_all を使用すると、すべての extern 定義がエクスポートさ

れ、すべての未定義参照がインポートされます。

• IMPORT ディレクティブと EXPORT ディレクティブに次の新しい属性を使用

して一定の可視度を設定し、 ELF シンボルを出力できます。

— DYNAMIC

— HIDDEN

— PROTECTED



• fromelf ユーティリティが強化され、--text=/s からの出力で、 GNU 拡張シ

ンボルバージョン管理テーブルをサポートします。シンボルバージョン管理テーブルのデコードを無効にするには、新しい --no_symbolversions オプションを使用します。





します。



• 例外を含め、 C++ が完全にサポートされます。

• ARMv6 コアのサポートが強化されました。サポートされるすべてのコ

アのリストを参照するには、次のコマンドを使用します。

armcc --cpu list

• コンパイラ、リンカ、アセンブラ、および fromelf で、 Microsoft Visual Studio などの IDE との互換性が高い形式で警告およびエラーを生成する

ための、新しい --diag_style オプションがサポートされます。

• コンパイラおよびリンカで、使用されていない仮想関数を生成済み C++ コードから削除する新機能がサポートされます。

• コンパイラで新しい --min_array_alignment オプションがサポートされま

す。

• 次にファイルをコンパイルするときのため、使用していない関数についてコンパイラに通知するリンカフィードバックを使用できます。フィードバックは関数自体のセクション内に配置され、後でリンカによって削除できるようになっています。

• ARM® ツールを使用するとき、 SHF_STRINGS セクションを使用して、複数

のコンパイルユニットで適切な文字列を共有できます。これは、 ARM アーキテクチャ用 ELF 標準［AAELF］によって定義されています。

• VFPv1 のサポートは廃止される予定です。デフォルトは VFPv2 になり

ました。サポートされるすべての FPU のリストを参照するには、次の

コマンドを使用します。

armcc --fpu list

• キーワードで単一ダッシュを使用することが制限され、今後サポートされなくなります。コンパイルツールを使用するときは、ダッシュを 2 つ使用します。



• コンパイルツールで現在使用が制限されているオプション（コンパイラオプション --fpu softfpa など）を使用すると、デフォルトで警告メッ

セージが表示されます。

RVCT v2.1 でこの動作を変更するには、環境変数 RVCT21_CLWARN を次のい

ずれかの値に設定します。

0 古い構文および現在使用が制限されているオプションに対し

て警告を表示します。

1 古い構文を許容して警告を表示せず、現在使用が制限されて

いるオプションに対して警告を表示します。これがデフォルトです。

2 古い構文および現在使用が制限されているオプションを許容

して、警告を表示しません。



• --gnu オプションを指定してコンパイラを実行すると、 GNU 拡張がサ

ポートされます。ただし、このオプションを指定せずにコンパイラを実行しても、いくつかの拡張機能がサポートされます。これらのコンパイルモードを、それぞれ次のように呼びます。

ARM モード

--gnu オプションを指定せずにコンパイルする、デフォルトの

モードです。

GNU モード

--gnu オプションを指定してコンパイルします。

GNU 拡張のすべての機能のリスト、およびそれらの機能をサポートす

るモードと言語の詳細については、『RealView コード生成ツール v2.1 コンパイラ / ライブラリガイド』のコンパイラの参照について説明した章

を参照して下さい。

• Edison Design Group （EDG）のフロントエンドを使用して、 ISO C++ のサポートを強化しました。これにより、コード生成の際に ARM コンパ

イラにプログラム表現を渡す完全な C++ パーサが提供されます。その結

果、 C++ 例外のスローとキャッチがサポートされます。



• マルチファイルコンパイルによって、複数のコンパイルユニットにまたがって適化を実行できます。新しい --multifile オプションを使用する

と、この動作を指定できます。マルチファイルコンパイルを行うには、以下に示すように、コマンドラインで複数のファイルを指定する必要があります。

armcc [options] --multifile ifile_1 ... ifile_n

• マルチファイルコンパイルがデフォルトで可能な新しい -O3 適化レベ

ルが採用されました。

• 新しいオプション --cpu list および --fpu list を使用すると、サポートさ

れている CPU とアーキテクチャについての詳細を表示できます。

• 新しい --min_array_alignment オプションを使用すると、配列の小境界

整列を指定できます。

• 新しい __breakpoint() 組み込み関数が採用されました。

• 戻り値を持たない関数が採用されました。

• --old_cfe オプションは使用されなくなりました。



• C++ のライブラリである Rogue Wave ライブラリおよび C++ ランタイム

ライブラリによって、 C++ 例外がサポートされるようになりました。例

外のサポートを必要としないアプリケーションも、これらの C++ ライブ

ラリで引き続きサポートされます。

• wchar.h のうち、ファイル I/O、および printf と scanf における c99 の 16 進数浮動小数点演算のサポートを除くすべての機能が C ライブラリでサ


• 圧縮アルゴリズムをサポートするため、領域テーブルの新しい形式が採用されました。この新しい形式には ZISection$$Table が含まれていませ

ん。





• ROM サイズを適化するため、読み出し / 書き込みデータの圧縮がデ

フォルトで有効になっています。

• コード用とデータ用に 1 つずつ、計 2 つの RO 実行領域を出力するため

に、新しいオプション --rosplit を使用できます。

• C++ 例外テーブルをサポートするための新しいコマンドラインオプショ

ンを使用できます。新しいオプション --noexceptions を使用すると、

コードで例外が処理されません。

新しいオプション --exceptions_tables=unwind|nounwind を使用すると、入

力ファイルの内容にかかわらず例外テーブルが生成されます。例えば --exceptions_tables=unwind を使用すると、 C 言語およびアセンブリ言語

のオブジェクト用に、デバッグフレームの情報が書き込まれた例外テーブルを作成できます。

• ユーザライブラリの検索場所を指定するための新しいオプション --userlibpath を使用できます。

• リンカでは、オブジェクトファイルのアライメントがより厳密にチェックされます。スタックを 8 バイトで区切る必要があるコードが、スタッ

クの 8 バイトのアライメントを保持するコードによってのみ直接的また

は間接的に呼び出されます。スタックのアライメントが競合しているのが検出された場合、リンカによって次のようなエラーメッセージが表示されます。

Error L6238E: object_name.o(section_name) contains invalid call from ’~PRES8’ function to ’ REQ8’ function_name

外部シンボルのアドレスを参照した場合も、同様の警告メッセージが表示されます。

Warning L6306W: ’ ~PRES8’ section object_name.o(section_name) should not use the address of ’ REQ8’ function_name



• 新しいオプション --cpu list および --fpu list を使用すると、サポートさ

れている CPU とアーキテクチャについての詳細を表示できます。



• 指定されたレジスタの数字を返す新しい単項演算子 :RCONST: が含まれて

います。

• コードを PRES8 としてマークするかどうかを判断するため、スタックポ

インタ（SP）を変更する命令を確認します。この変更は、必要な場合自

動で行われます（詳細については、『RealView コード生成ツール v2.1 アセンブラガイド』のディレクティブ参照について説明した章を参照して下さい）。

• コード内で発生しうるインターロックについての警告を表示できます。この機能を有効にするには、次のコマンドを使用します。

armasm --diag_warning 1563



• ELF イメージをデコードして構造体内外の配列を展開するための新しい --expandarrays オプションを使用できます。

このオプションは、--text -a と一緒に使用する必要があります（単独で

は使用できません）。





します。



• ARM アーキテクチャ v6 がサポートされます。

• ARM アーキテクチャ用 ABI （基本標準）［BSABI］に準拠しています。

詳細については、 http://www.arm.com を参照して下さい。

• 浮動小数点の例外を発生させるには、--fpmode ieee_full を選択する必要

があります。デフォルト設定が --fpmode std であり、そのままでは浮動

小数点の例外が発生しないためです。

• コマンドラインキーワードを示すためには、ダッシュを 2 つ（- - ）使用

します（例：--cpp）。


ARM コンパイラ（armcc）では、次の点が変更されました。

• コマンドラインオプションが変更された RVCT v2.0 コンパイラのフロン

トエンドが新しくなりました。古い ARM コンパイラで使用できたオプ

ションも、後方互換性のためにサポートされます。

• 4 つの独立したコンパイラ armcc、 tcc、 armcpp、および tcpp が 1 つのコン

パイラ armcc に統合されました。ただし、新しいコンパイラに移行しや

すくするため、 RVCT v2.0 コンパイラは個別のコンパイラ名で呼び出す

ことができます。

• ARMv6 をサポートし、 ARMv6 の非境界整列アクセス動作を利用しま

す。

• インラインアセンブラを補完する新しい組み込みアセンブラが採用されました。

• #pragma arm および #pragma thumb を使用して、関数単位で ARM と Thumb® のコンパイルを実行できます。



• --fpmode オプションを使用して、 5 つの浮動小数点モデルを選択できま

す。

• --list オプションの動作が、古いコンパイラと異なります。

• C++ テンプレートインスタンス生成が可能です。

• C++ ネームスペースを使用できます。

• ポインタアライメントのレベルを指定できます。

• C++ をコンパイルするときに ROPI がサポートされなくなりました。

• 診断メッセージを制御および操作できます。また、診断メッセージの番号の付け方が変更されました。メッセージの番号の形式は #nnnn または #nnnn-D です。接尾文字 -D を伴うメッセージのメッセージ番号は、診断

メッセージを操作するオプションで使用できます。

• 新しいインタフェースでは、古いコンパイラオプションの多くがサポートされません。ただし下位互換性のため、--old_cfe オプションを使用す

るとそれらのオプションを使用できます。詳細については、『RealView コード生成ツール v2.0 コンパイラ / ライブラリガイド』の古いコンパイ

ラオプションについて説明した付録を参照して下さい。この付録では、古いコンパイラオプションのうち、新しいコンパイラオプションにマップできるものがある場合、それを示しています。また、『RealView コー

ド生成ツール v2.0 コンパイラ / ライブラリガイド』に記載されている

メッセージについて、この付録では、新しいコンパイラインタフェースで出力される等価なメッセージを示しています。

注 --old_cfe オプションを使用すると、コンパイラにより出力されるメッ

セージに、古い形式で番号が付きます。

その他、新しいプラグマと定義済みマクロの追加、 C と C++ 言語の拡張、お

よび ARM の C のライブラリと C++ のライブラリの変更などが行われました。


ARM リンカ（armlink）では、次の点が変更されました。

• --unresolved オプションが部分リンクに対応しました。



• 新しいステアリングファイルコマンド RESOLVE が追加され、部分リンク

を実行するときに使用されるようになりました。 RESOLVE は、 armlink オプ

ションの --unresolved と用法が似ています。

• オプション --edit が複数のファイルに対応しました。

• バイトをパッドするための値を指定する新しいオプション --pad があり

ます。

• 新しいスキャッタロード属性 EMPTY および ZEROPAD が追加されました。


ARM アセンブラ（armasm）では、次の点が変更されました。

• ARM アーキテクチャ v6 の新しい命令がサポートされます。サチュレー

ト命令、並列命令、パック / 展開命令などがサポートされるようになり

ました。

• ALIGN ディレクティブに、パディングの内容を指定するパラメータが追

加されました。このパラメータはオプションです。

• 新しい AREA ディレクティブ NOALLOC があります。

• 新しい 2 つのディレクティブ ELIF および FRAME RETURN ADDRESS がありま

す。

• 4 つの新しい組み込み変数 {AREANAME}、 {COMMANDLINE}、 {LINENUM}、および {INPUTFILE} があります。


realview compilation tools...

Documents