構文

-a

ツール

ielfdumparm

説明

このオプションは--all --no_strtabのショートカットとして使用します。

構文

‑‑all

ツール

ielfdumparm

説明

このオプションは、入力ファイルの汎用属性に加え、すべてのELFセクションの内容を出力に含めるときに使用します。セクションは、インデックスの順に出力されます。ただし、再配置可能セクションについては、そのセクションが再配置用に保持しているセクションの直後に各再配置可能セクションが出力されます。

デフォルトでは、セクションの内容は出力に含まれません。

構文

‑‑bin[=range]

パラメータ

ielftoolアドレス範囲の指定を参照してください。

ツール

ielftool

説明

出力ファイルのフォーマットをロウバイナリに設定します。バイナリフォーマットにはアドレス情報はなく、ロウバイトだけが含まれています。範囲が指定されていない場合は、出力ファイルには、ELFファイルの内容になる一番小さいアドレスから、内容になる一番大きいアドレスのすべてのバイトが含まれています。範囲が指定されている場合は、範囲のバイトが含まれます。両方の場合も、内容のないギャップは、ゼロとして生成されます。

構文

‑‑bin-multi[=range[;range...]]

パラメータ

ielftoolアドレス範囲の指定を参照してください。

ツール

ielftool

説明

このオプションを使用して、1つまたは複数のロウバイナリ出力ファイルを生成します。範囲が指定されていない場合は、ロウバイナリ出力ファイルは、ELFファイルの内容のそれぞれの範囲に生成されます。範囲が指定されると、ロウバイナリ出力ファイルは、コンテンツのあるそれぞれの指定した範囲に生成されます。それぞれの場合も、各出力ファイルの名前には、その範囲の開始アドレスが含まれます。例えば、出力ファイルがout.binと指定されて範囲0x0-0x1Fと0x8000-0x8147が出力されるとき、out-0x0.binとout-0x8000.binという名前のファイルが2つになります。

構文

‑‑code

ツール

ielfdumparm

説明

このオプションを使用して、実行可能コード（ELFセクション属性SHF_EXECINSTRを持つセクション）を含むすべてのセクションをダンプします。

構文

‑‑create libraryfileobjectfile1 ... objectfileN

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、一連のオブジェクトファイル（モジュール）および/またはアーカイブツールから新しいライブラリをビルドするときに使用します。モジュールは、コマンドラインで指定した順序でライブラリに追加されます。

コマンドラインでコマンドを指定しない場合、デフォルトで--createが使用されます。

構文

‑‑delete libraryfile objectfile1 ... objectfileN
-d libraryfile objectfile1 ... objectfileN

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、オブジェクトファイル（モジュール）を既存のライブラリから削除するときに使用します。コマンドラインで指定したオブジェクトファイルがすべてライブラリから削除されます。

構文

‑‑disasm_data

ツール

ielfdumparm

説明

このコマンドを使用して、コードセクションであるかのように、ダンパーをダンプデータセクションに指示します。

構文

‑‑edit steering_file

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則を参照してください。

ツール

isymexport

説明

このオプションは、ステアリングファイルを指定するときに使用します。ステアリングファイルでは、isymexportの出力ファイルに含めるシンボルの選択を制御できるほか、必要に応じて、シンボルの名前を変更することもできます。

関連項目

ステアリングファイル.

構文

‑‑export_locals [=symbol_prefix]

パラメータ

ツール

isymexport

説明

このオプションを使用して、ROMイメージファイルからローカルシンボルと絶対シンボルをエクスポートします。エクスポートしたシンボルのデフォルト名はLOCAL_filename_symbolnameです。オプションパラメータsymbol_prefixを使用して、LOCALを自分のカスタムプレフィックスと置き換えます。

例

ROM イメージファイルからエクスポートすると、ソースファイル myFile.cのシンボル symb は、LOCAL_myFile_c_symb になります。

構文

‑‑extract libraryfile [objectfile1 ... objectfileN]
-x libraryfile [objectfile1 ... objectfileN]

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、オブジェクトファイル（モジュール）を既存のライブラリから抽出するときに使用します。オブジェクトファイルのリストを指定すると、これらのファイルのみ抽出されます。オブジェクトファイルのリストを指定しない場合には、ライブラリ内のすべてのオブジェクトファイルが抽出されます。

構文

‑‑fake_time

ツール

iarchive

説明

このオプションを使用して同じタイムスタンプのライブラリファイルを生成します。使用した値は0x5CF00000で、おおよそ2019年5月30日18:08:32（正確な時間は設定した時間により異なります）です。このオプションでは、同じオブジェクトファイルに同じライブラリを生成できます。このオプションを使用しない場合、タイムスタンプは、同じ入力ファイルから一意のライブラリファイルを生成します。

構文

‑‑fill [v;]pattern;range[;range...]

パラメータ

ielftoolアドレス範囲の指定も参照してください。

ツール

ielftool

説明

このオプションは、1つ以上の範囲のすべてのギャップにパターンを埋め込むときに使用します。パターンは、式または16進数文字列のいずれかです。この内容は、フィルパターンが開始アドレスから終了アドレスまで繰り返し埋め込まれように計算されます。そして、実際の内容でパターンが上書きされます。

アライメントを考慮することもできます。ハーフワードまたはワードアクセスでアクセスするフィルを生成する場合、フィルター範囲のアドレスがハーフワードまたはワードと一致しているようにしてください。

--fillオプションがコマンドラインで複数回使用される場合、フィル範囲がそれぞれと重複することはできません。

構文

‑‑front_headers

ツール

ielftool

説明

このオプションを使用して、プログラムとセクションヘッダがファイルの最後ではなく最初にあるELFを出力します。

構文

‑‑ihex

ツール

ielftool

説明

出力ファイルのフォーマットを32ビットリニアなIntel拡張hexに設定します。hexadecimal textフォーマットは、Intelによって定義されています。

構文

‑‑ihex-len=length

パラメータ

ツール

ielftool

説明

Intel Hexレコードのデータバイト数を最大に設定します。このオプションは、‑‑ihexオプションと組み合わせてのみ使用できます。デフォルトでは、Intel Hexレコードのデータバイト数は16です。

構文

‑‑json

ツール

ielfdumparm

説明

ielfdumparm からの出力を JSON 形式 でフォーマットするには、このオプションを使用します。情報は、‑‑json オプションなしの場合と同じで、単に機械可読形式で出力されるだけです。ただし、重要な違いは、--all、-a、および同様のオプションの動作です。--json オプションがない場合、最初のダンプは ELF ヘッダからの情報であり、その後のダンプは各セクションごとに順番に行われます。--json オプションを使用すると、1 つの大きなオブジェクトが生成されます。

JSON 形式にはすべてのフィールドの説明が含まれており、出力の説明が必要な場合に推奨されます。

関連項目

‑‑just_json

構文

‑‑json_schema

ツール

ielfdumparm

説明

ielfdumparm からの出力は、オプション ‑‑json を使用して JSON 形式で生成できます。JSON スキーマを生成するには、このオプションを使用します。スキーマにはすべてのフィールドの説明が含まれています。

関連項目

‑‑json

構文

--just_json

ツール

ielfdumparm

説明

ielfdumparm からの出力を JSON 形式でフォーマットするには、--json オプションのように出力を機械可読にする他のオプションを暗黙的に設定せずに、このオプションを使用します。

関連項目

‑‑json

構文

‑‑no_bom

ツール

iarchive、ielfdumparm、iobjmanip、およびisymexport

説明

このオプションを使用して、UTF-8出力ファイルを生成するときに、バイトオーダーマーク(BOM)を省略します。

関連項目

‑‑text_out および テキストエンコーディング

構文

‑‑no_header

ツール

ielfdumparm

説明

デフォルトでは、実際のファイル内容の前に標準のリストヘッダが追加されます。このオプションを使用して、リストヘッダの出力を無効化します。

構文

‑‑no_rel_sections

ツール

ielfdumparm

説明

デフォルトでは、再配置可能なファイルのセクションの内容が出力として生成された場合、関連のセクションがあればそれもまた必ず出力に含まれます。このオプションを使用して、再配置セクションの出力を無効化します。

構文

‑‑no_strtab

ツール

ielfdumparm

説明

このオプションを使用して、文字列のテーブルセクション(SHT_STRTAB型のセクション)のダンプを無効にします。

構文

‑‑no_utf8_in

ツール

ielfdumparm

説明

通常、ダンパーはIARツールによって生成されたELFファイルが、UTF-8テキストエンコードを使用するかどうかを決定し、正しい出力を生成できます。IARツールでなはいもので生成されたELFファイルには、ダンパーは、このオプションが使用されてない限り、UTF-8エンコードを想定します。この場合、エンコードは現在のシステムのデフォルトロケールに従うように想定されます。

関連項目

テキストエンコーディング

構文

‑‑offset [-]offset

パラメータ

ツール

ielftool

説明

このオプションを使用して、生成された出力ファイルの各出力レコードのアドレスにオフセットを追加または差し引きします。オプションはMotorola S-records、Intel Hex、TI-Txt、Simple-Codeでのみ動作します。オプションはELFファイルまたはバイナリファイル（--binアドレス情報を含まない）を生成するときには影響しません。このオプションでは、エントリーポイントを含むすべてのコンテンツは変更されません。出力フォーマットのアドレスのみです。

例

‑‑offset 0x30000

これはすべてのアドレスに0x30000オフセットを追加します。結果として、アドレス0x4000にリンクされたコンテンツは0x34000に配置されます。

構文

-o {filename|directory} 
‑‑output {filename|directory} 

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則を参照してください。

ツール

iarchiveとielfdumparm.

説明

iarchive

デフォルトでは、iarchiveは、iarchiveコマンドの後の最初の引数を、作成するライブラリファイルの名前であるとみなします。このオプションは、ライブラリ用に別のファイル名を明示的に指定する場合に使用します。

ielfdumparm

デフォルトでは、ダンプ結果の出力先はコンソールになります。このオプションは、出力先をファイルに変更するときに使用します。出力ファイルのデフォルト名は、入力ファイル名にファイル名拡張子idを追加したものです。

また、入力ファイル名の後にファイルやディレクトリを指定して、出力ファイルを指定することもできます。

構文

‑‑parity{symbol[+offset]|address}:size,algo:flashbase[:flags];range[;range...]

パラメータ

ツール

ielftool

説明

指定範囲にパリティバイトを生成するときに使用します。この範囲は左から右の順になり、奇数または偶数のアルゴリズムを使用してパリティビットが生成されます。パリティビットは最終的に指定のシンボル内に格納され、アプリケーションからアクセスできるようになります。

構文

‑‑ram_reserve_ranges[=symbol_prefix]

パラメータ

ツール

isymexport

説明

このオプションを使用して、イメージが使用するRAMのエリアについてシンボルを生成します。各エリアにシンボルが1つ生成されます。各シンボルの名前はエリア名に基づき、オプションのパラメータsymbol_prefixがプレフィックスとして付きます。

あるエリアをカバーするシンボルをこの方法で生成すると、影響を受けるアドレスにリンカで他の内容を配置しないように防ぐことができます。これは、既存のイメージに対するリンク処理の際に役立ちます。

‑‑ram_reserve_rangesと‑‑reserve_rangesを同時に使用する場合、RAMエリアは ‑‑ram_reserve_rangesオプションからプレフィックスを、RAM以外のエリアは‑‑reserve_ranges オプションからプレフィックスをそれぞれ取得します。

関連項目

‑‑reserve_ranges.

構文

‑‑range start-end

パラメータ

ツール

ielfdumparm

説明

このオプションを使用して、実行可能ファイルのコードをダンプする範囲を指定します。

構文

‑‑raw

ツール

ielfdumparm

説明

デフォルトでは、特定の種類のセクション専用テキストフォーマットを使用して、多数のELFセクションがダンプされます。このオプションは、汎用テキストフォーマットを使用して、選択した各ELFセクションをダンプするときに使用します。

汎用テキストフォーマットを使用する場合、セクション内の各バイトが16進数フォーマットまたは、必要に応じてASCIIテキストにダンプされます。

Syntax

--raw_io

ツール

ielfdumparm

説明

このオプションを使用すると、ielfdumparmは追加の改行文字などを含まない、最大限の機械可読出力を生成します。このオプションは、 ‑‑no_bom オプションも暗黙的に設定することに注意してください。

構文

‑‑remove_file_path

ツール

iobjmanip

説明

このオプションは、iobjmanipで、生成されたオブジェクトファイルからプロジェクトソースツリーのディレクトリ情報を削除するときに使用します。つまり、ELFオブジェクトファイルのファイルシンボルが変更されることになります。

このオプションは、‑‑remove_section ".comment"と組み合わせて使用する必要があります。

構文

‑‑remove_section {section|number}

パラメータ

ツール

iobjmanip

説明

このオプションでは、出力ファイルを作成するときにiobjmanipで指定のセクションを省略します。

構文

‑‑rename_section {oldname|oldnumber}=newname

パラメータ

ツール

iobjmanip

説明

このオプションでは、出力ファイルを作成するときにiobjmanipで指定のセクションをリネームします。

構文

‑‑rename_symbol oldname =newname

パラメータ

ツール

iobjmanip

説明

このオプションでは、出力ファイルを作成するときにiobjmanipで指定のシンボルをリネームします。

構文

‑‑replace libraryfile objectfile1 ... objectfileN
-r libraryfile objectfile1 ... objectfileN

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、既存のライブラリにオブジェクトファイル（モジュール）の置換または追加、およびまたはファイルのアーカイブを行うときに使用します。コマンドラインで指定したモジュールにより、ライブラリ内の同一名の既存のモジュールが置換されます。同一名のファイルが存在しない場合には、コマンドラインで指定したファイルがライブラリに追加されます。

構文

‑‑reserve_ranges[=symbol_prefix]

パラメータ

ツール

isymexport

説明

このオプションを使用して、イメージが使用するROMおよびRAMのエリアについてシンボルを生成します。各エリアにシンボルが1つ生成されます。各シンボルの名前はエリア名に基づき、オプションのパラメータsymbol_prefixがプレフィックスとして付きます。

あるエリアをカバーするシンボルをこの方法で生成すると、影響を受けるアドレスにリンカで他の内容を配置しないように防ぐことができます。これは、既存のイメージに対するリンク処理の際に役立ちます。

‑‑reserve_rangesと‑‑ram_reserve_rangesを同時に使用する場合、RAMエリアは‑‑ram_reserve_rangesオプションからプレフィックスを、RAM以外のエリアは‑‑reserve_rangesオプションからプレフィックスをそれぞれ取得します。

関連項目

‑‑ram_reserve_ranges.

構文

‑‑section sec_number|sec_name[,...]
‑s sec_number|sec_name[,...]

パラメータ

ツール

ielfdumparm

説明

このオプションは、指定した番号のセクションまたは指定した名前のセクションの内容をダンプするときに使用します。選択したセクションに再配置可能セクションが関連付けられている場合には、その内容も出力されます。

このオプションを使用する場合、入力ファイルの一般属性は出力に含まれません。

セクション番号や名前をカンマで区切るか、このオプションを複数回使用することにより、複数のセクション番号や名前を指定できます。指定されたセクションが見つからない場合、その内容は出力から除外されますが、他のすべてのセグメントの内容が含まれます。

デフォルトでは、セクションの内容は出力に含まれません。

例

-s 3,17                  /* Sections #3 and #17
-s .debug_frame,42       /* Any sections named .debug_frame and
                            also section #42 */ 

構文

‑‑segment seg_number[,...]
‑g seg_number[,...]

パラメータ

ツール

ielfdumparm

説明

このオプションを使用して、出力に含める特定のセグメント（プログラムヘッダにより示される実行可能イメージの部分）を選択します。指定されたセグメントが見つからない場合、出力から除外されますが、他のすべてのセグメントが含まれます。

セグメント番号をカンマで区切るか、このオプションを複数回使用することにより、複数のセグメント番号を指定できます。

構文

‑‑self_reloc

ツール

ielftool

説明

このオプションは一般的な使用を意図していないため、意図的に文書化されていません。

構文

‑‑show_entry_as name

パラメータ

ツール

isymexport

説明

このオプションを使用して、名前nameの下に入力として与えられたアプリケーションのエントリーポイントエクスポートします。

構文

‑‑silent

ツール

iarchive と ielftool

説明

ツールが標準出力ストリームにメッセージ送信せずに処理を実行するように設定します。

デフォルトでは、ツールによりさまざまなメッセージが標準出力ストリームから送信されます。このオプションを使用して、この動作を回避することができます。ツールはエラーおよびワーニングメッセージをエラー出力ストリームに送信するため、この設定に関係なくそれらは表示されます。

構文

‑‑simple

ツール

ielftool

説明

出力ファイルのフォーマットを簡易コードに設定します。バイナリフォーマットにはアドレス情報が含まれています。

構文

‑‑simple-ne

ツール

ielftool

説明

出力ファイルのフォーマットを簡易コードに設定しますが、エントリレコードは生成されません。

構文

‑‑source

ツール

ielfdumparm

説明

このオプションを使用して、実行可能ファイルからコードをダンプする際、ielftoolが各文のソースをその文のコードより前にインクルードするようにします。これが機能するためには、実行可能イメージをデバッグ情報とともにビルドし、ソースコードが元の場所でアクセス可能な状態でなければなりません。

構文

‑‑srec

ツール

ielftool

説明

出力ファイルのフォーマットをMotorola S-recordsに設定します。hexadecimal textフォーマットは、Motorolaによって定義されています。オプションielftool、‑‑srec-len、および‑‑srec-s3onlyを使用して、使用するフォーマットを変更できます。

構文

‑‑srec-len=length

パラメータ

ツール

ielftool

説明

S-recordのデータバイト数の最大数を設定します。このオプションは、‑‑srecオプションと組み合わせてのみ使用できます。デフォルトでは、S-recordのデータバイト数は16です。

構文

‑‑srec-s3only

ツール

ielftool

説明

S-record出力にレコードのサブセット（すなわちS0、S3、S7レコード）のみが含まれるように制限します。このオプションは、--srecオプションと組み合わせて使用できます。

構文

‑‑strip

ツール

iobjmanip と ielftool。

説明

このオプションでは、出力ファイル を書き込む前に、デバッグ情報を含むすべてのセクションを削除します。iobjmanipはすべてのモジュールローカル関数、変数、およびセクションシンボルの名前も削除します。

構文

‑‑symbols libraryfile

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、指定したライブラリ内のオブジェクトファイル（モジュール）によって定義されるすべての外部シンボルを、そのシンボルを定義しているオブジェクトファイル（モジュール）の名前とともにリストするときに使用します。

出力抑止モード (‑‑silent)の場合、このコマンドは、ライブラリファイルのシンボル関連構文チェックを実行し、エラーと警告のみを表示します。

構文

‑‑text_out{utf8|utf16le|utf16be|locale}

パラメータ

ツール

iarchive、ielfdumparm、iobjmanip、およびisymexport

説明

このオプションを使用して、テキスト出力ファイルを生成するときに使用するのエンコードを指定します。

リストファイルのデフォルトは、メインソースファイルと同じエンコードが使用されます。すべてのその他のテキストファイルのデフォルトは、バイトオーダーマーク(BOM)のあるUTF-8です。

BOMなしのUTF-8エンコードでテキストを出力する場合、オプション--no_bomも使用できます。

関連項目

‑‑no_bom および テキストエンコーディング

構文

‑‑titxt

ツール

ielftool

説明

出力ファイルのフォーマットをTexas Instruments によって定義された 16 進テキスト形式である Texas Instruments TI-TXT に設定します。

構文

‑‑toc libraryfile
-t libraryfile

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、指定したライブラリ内のすべてのオブジェクトファイル（モジュール）をリストするときに使用します。

出力抑止モード (‑‑silent)の場合、このコマンドは、ライブラリファイルの基本的な構文チェックを実行し、エラーと警告のみを表示します。

構文

‑‑update_symbol symbol,{hexstring|(filename)}[,force]

パラメータ

ツール

ielftool

説明

このオプションは、指定したシンボルのELFファイルコンテンツを置換します。ielftoolは、新しいコンテンツのバイト数（16進数文字列で指定されるまたはファイルからの読み取り）が、ELFファイルの現在のシンボルのサイズと一致するかをチェックします。サイズが一致しない場合は、操作が中止されます。

forceパラメータを使用して、ielftoolが、一部のELFシンボルにサイズがなく、サイズが一致しない場合でも、操作を実行します（通常生成されたアセンブラ、またはツールチェーンで生成されたものは、シンボルサイズが設定されません）。処理を強制する場合は、入力として更新しているファイルは破損するので、誤って使用してしまわないように気を付けなければなりません。

構文

‑‑update_typeless_globals[=codeSectionName,dataSectionName]

パラメータ

ツール

iobjmanip

説明

このオプションを使用すると、オブジェクトファイルの関連のグローバルシンボルのタイプを更新します。

ELFタイプ（ELF属性STT_NOTYPE）のないグローバルシンボルは、そのタイプセットがCode (STT_FUNC) または Data (STT_OBJECT)です。パラメータが指定されていない場合は、シンボルを含むセクションの属性は、これがCodeまたはDataセクションなのかを決定するために使用されます。

オプションのセクション名が使用される場合は、dataSectionNameと一致するセクションのシンボルは、Dataとして扱われます。同様に、codeSectionNameと一致するセクションのシンボルは、Codeとして扱われます。セクションがdataSectionNameまたはcodeSectionNameのどちらにも一致しない場合は、ワーニングが生成され、セクションのシンボルは更新されません。

構文

‑‑utf8_text_in

ツール

iarchive、ielfdumparm、iobjmanip、およびisymexport

説明

このオプションを使用して、ツールは、バイト オーダーマーク(BOM)のないテキスト入力ファイルを読み込むとき、UTF-8 エンコードを使用できることを指定します。

関連項目

テキストエンコーディング

構文

‑‑verbose
-V (iarchive only)

ツール

iarchive と ielftool。

説明

このオプションは、診断メッセージのほかに、実行された操作をツールで報告するときに使用します。

構文

‑‑version

ツール

iarchive、ielfdumparm、ielftool、iobjmanip、isymexport

説明

このオプションを使用して、バージョン情報をコンソールに送信してから終了するようツールに指示します。

構文

‑‑vtoc libraryfile

パラメータ

ファイル名またはディレクトリをパラメータとして指定する場合の規則も参照してください。

ツール

iarchive

説明

このコマンドは、指定したライブラリ内のすべてのオブジェクトファイル（モジュール）の名前、サイズ、変更日時をリストするときに使用します。

出力抑止モード (‑‑silent)の場合、このコマンドは、ライブラリファイルの基本的な構文チェックを実行し、エラーと警告のみを表示します。