h8300-hms-objcopy - クラウドでオンライン

プログラム：

NAME

objcopy-オブジェクトファイルをコピーして翻訳します

SYNOPSIS

オブジェクトコピー [-F 友人名⎪--target =友人名]
[-I 友人名⎪--input-target =友人名]
[-O 友人名⎪--output-target =友人名]
[-B BFDARCH⎪--binary-architecture =BFDARCH]
[-S⎪--strip-all]
[-g⎪--strip-debug]
[-K シンボル名⎪--keep-symbol =シンボル名]
[-N シンボル名⎪--strip-symbol =シンボル名]
[--strip-unneeded-symbol =シンボル名]
[-G シンボル名⎪--keep-global-symbol =シンボル名]
[-L シンボル名⎪--localize-symbol =シンボル名]
[-W シンボル名⎪--weaken-symbol =シンボル名]
[-w⎪-ワイルドカード]
[-x⎪-破棄-すべて]
[-X⎪--discard-locals]
[-b バイト⎪--byte =バイト]
[-i 間を空ける⎪--インターリーブ=間を空ける]
[-j セクション名⎪--only-section =セクション名]
[-R セクション名⎪--remove-section =セクション名]
[-p⎪--preserve-dates]
[-デバッグ]
[--gap-fill =ヴァル]
[--pad-to =住所]
[--set-start =ヴァル]
[--adjust-start =増加]
[--change-addresses =増加]
[--変更セクションアドレス {=、+、-}ヴァル]
[--変更セクション-lma {=、+、-}ヴァル]
[--change-セクション-vma {=、+、-}ヴァル]
[-変更-警告] [-変更なし-警告]
[--set-section-flags =フラグ]
[-追加-セクション セクション名=ファイル名]
[-名前の変更-セクション 古い名前=新しい名前[,フラグ]]
[--先頭文字の変更] [--先頭の文字を削除]
[--srec-len =ival] [--srec-forceS3]
[--redefine-sym 古い=新製品]
[--redefine-syms =ファイル名]
[- 弱める]
[--keep-symbols =ファイル名]
[--strip-symbols =ファイル名]
[--strip-unneeded-symbols =ファイル名]
[--keep-global-symbols =ファイル名]
[--localize-symbols =ファイル名]
[--weaken-symbols =ファイル名]
[--alt-machine-code =index]
[--prefix-symbols =文字列]
[--prefix-sections =文字列]
[--prefix-alloc-sections =文字列]
[--add-gnu-debuglink =ファイルへのパス]
[--デバッグのみを保持する]
[-書き込み可能-テキスト]
[-読み取り専用-テキスト]
[- ピュア]
[-不純]
[-v⎪-詳細]
[-V⎪- バージョン]
[ - 助けて] [- 情報]
ファイル内 [アウトファイル]

DESCRIPTION

GNU オブジェクトコピー ユーティリティは、オブジェクトファイルの内容を別のファイルにコピーします。 オブジェクトコピー 使用されます
オブジェクトファイルの読み取りと書き込みを行うGNUBFDライブラリ。 目的地を書ける
ソースオブジェクトファイルとは異なる形式のオブジェクトファイル。 正確な動作
of オブジェクトコピー コマンドラインオプションによって制御されます。 ご了承ください オブジェクトコピー ことができるようになります
任意のXNUMXつの形式間で完全にリンクされたファイルをコピーします。 ただし、再配置可能オブジェクトをコピーする
XNUMXつの形式の間のファイルは、期待どおりに機能しない場合があります。

オブジェクトコピー 翻訳を行うための一時ファイルを作成し、後でそれらを削除します。
オブジェクトコピー BFDを使用してすべての翻訳作業を行います。 すべてのフォーマットにアクセスできます
BFDで記述されているため、明示的に通知されることなくほとんどの形式を認識できます。

オブジェクトコピー の出力ターゲットを使用してSレコードを生成するために使用できます レク （例：使用 -O
レク).

オブジェクトコピー の出力ターゲットを使用して生のバイナリファイルを生成するために使用できます バイナリ
（例：使用 -O バイナリ）。 いつ オブジェクトコピー 生のバイナリファイルを生成します、それは本質的に
入力オブジェクトファイルの内容のメモリダンプを生成します。 すべての記号と
再配置情報は破棄されます。 メモリダンプはロードアドレスから始まります
出力ファイルにコピーされた最下位セクションの。

Sレコードまたは生のバイナリファイルを生成する場合は、次を使用すると役立つ場合があります。 -S 削除する
デバッグ情報を含むセクション。 ある場合には -R 削除すると便利になります
バイナリファイルに必要のない情報を含むセクション。

ノート - -オブジェクトコピー 入力ファイルのエンディアンを変更することはできません。 入力の場合
フォーマットにはエンディアンがあります（一部のフォーマットにはエンディアンがありません）、 オブジェクトコピー 入力をファイルにコピーすることしかできません
同じエンディアンを持っているか、エンディアンを持たないフォーマット（例： レク).

OPTIONS

ファイル内
アウトファイル
それぞれ入力ファイルと出力ファイル。 指定しない場合 アウトファイル, オブジェクトコピー
一時ファイルを作成し、結果の名前を破壊的に名前変更します。 ファイル内.

-I 友人名
--input-target =友人名
ソースファイルのオブジェクト形式は次のようになります。 友人名、しようとするのではなく
それを推測します。

-O 友人名
--output-target =友人名
オブジェクト形式を使用して出力ファイルを書き込みます 友人名.

-F 友人名
--target =友人名
　 友人名 入力ファイルと出力ファイルの両方のオブジェクト形式として。 つまり、単に
変換せずにソースから宛先にデータを転送します。

-B BFDARCH
--binary-architecture =BFDARCH
生のバイナリ入力ファイルをオブジェクト ファイルに変換するときに役立ちます。 この場合
出力アーキテクチャは次のように設定できます BFDARCH. 次の場合、このオプションは無視されます。
入力ファイルには既知の BFDARCH。 プログラム内でこのバイナリ データにアクセスするには、次のようにします。
変換プロセスによって作成された特殊なシンボルを参照します。 これらは
シンボルは_binary_と呼ばれますオブジェクトファイル_start、_binary_オブジェクトファイル_endと
_バイナリ_オブジェクトファイル_サイズ。 たとえば、画像ファイルをオブジェクトファイルに変換して
次に、これらの記号を使用してコードでアクセスします。

-j セクション名
--only-section =セクション名
指定されたセクションのみを入力ファイルから出力ファイルにコピーします。 このオプションは
複数回与えられる。 このオプションを不適切に使用すると、
出力ファイルは使用できません。

-R セクション名
--remove-section =セクション名
名前の付いたセクションをすべて削除します セクション名 出力ファイルから。 このオプションを指定できます
一回以上。 このオプションを不適切に使用すると、出力ファイルが作成される可能性があることに注意してください
使用できません。

-S
--strip-all
ソースファイルから再配置およびシンボル情報をコピーしないでください。

-g
--strip-debug
ソースファイルからデバッグシンボルまたはセクションをコピーしないでください。

-ストリップ-不要
再配置処理に必要のないすべてのシンボルを削除します。

-K シンボル名
--keep-symbol =シンボル名
シンボルのみをコピー シンボル名 ソースファイルから。 このオプションは、
一度。

-N シンボル名
--strip-symbol =シンボル名
シンボルをコピーしないでください シンボル名 ソースファイルから。 このオプションはもっと与えられるかもしれません
一度より。

--strip-unneeded-symbol =シンボル名
シンボルをコピーしないでください シンボル名 ソースファイルから必要な場合を除き、
移転。 このオプションは複数回指定できます。

-G シンボル名
--keep-global-symbol =シンボル名
シンボルのみを保持 シンボル名 グローバル。 他のすべてのシンボルをファイルに対してローカルにし、次のようにします。
それらは外部からは見えません。 このオプションは複数回指定できます。

-L シンボル名
--localize-symbol =シンボル名
シンボルを作る シンボル名 ファイルに対してローカルであるため、外部からは見えません。 この
オプションは複数回指定できます。

-W シンボル名
--weaken-symbol =シンボル名
シンボルを作る シンボル名 弱い。 このオプションは複数回指定できます。

-w
-ワイルドカード
で正規表現を許可する シンボル名■他のコマンドラインオプションで使用されます。 NS
疑問符（？）、アスタリスク（*）、円記号（\）、角括弧（[]）の演算子は次のことができます。
シンボル名のどこでも使用できます。 シンボル名の最初の文字が
感嘆符（！）を押すと、その記号のスイッチの意味が逆になります。 にとって
例：

-w -W！foo -W fo *

シンボルを除いて、「fo」で始まるすべてのシンボルを objcopy に弱体化させます。
「ふー」。

-x
-破棄-すべて
非グローバルシンボルをソースファイルからコピーしないでください。

-X
--discard-locals
コンパイラによって生成されたローカルシンボルをコピーしないでください。 （これらは通常、 L or ..)

-b バイト
--byte =バイト
のみ保持 バイト入力ファイルの th バイト (ヘッダー データは影響を受けません)。 バイト できる
0 から 間を空ける-1、ここで 間を空ける によって与えられる -i or
- 間を空ける オプション、またはデフォルトの 4。このオプションは、ファイルを作成する場合に便利です。
プログラムロム。 通常、「srec」出力ターゲットとともに使用されます。

-i 間を空ける
--インターリーブ=間を空ける
すべてのうちのXNUMXつだけをコピーします 間を空ける バイト。 でコピーするバイトを選択します -b or
- バイト オプション。 デフォルトは 4 です。 オブジェクトコピー 指定しない場合、このオプションは無視されます
どちら -b or - バイト.

-p
--preserve-dates
出力ファイルのアクセス日と変更日を次のものと同じに設定します
入力ファイル。

-デバッグ
可能であれば、デバッグ情報を変換します。 これはデフォルトではありません。
特定のデバッグ形式がサポートされており、変換プロセスに時間がかかる場合があります
消費する。

-ギャップフィル ヴァル
セクション間のギャップを次のように埋めます ヴァル。 この操作は、 負荷 住所 （LMA）
セクションの。 これは、セクションのサイズを下に大きくすることによって行われます。
アドレス、およびで作成された余分なスペースを埋める ヴァル.

--パッドへ 住所
出力ファイルをロードアドレスまでパディングします 住所。 これは、
最後のセクションのサイズ。 余分なスペースは、で指定された値で埋められます
-ギャップフィル （デフォルトはゼロ）。

--セットスタート ヴァル
新しいファイルの開始アドレスをに設定します ヴァル。 すべてのオブジェクトファイル形式がサポートしているわけではありません
開始アドレスを設定します。

--変更開始 増加
-調整-開始 増加
追加して開始アドレスを変更します 増加。 すべてのオブジェクトファイル形式が設定をサポートしているわけではありません
開始アドレス。

--アドレス変更 増加
--調整-vma 増加
すべてのセクションのVMAアドレスとLMAアドレス、および開始アドレスを次のように変更します。
追加 増加。 一部のオブジェクトファイル形式では、セクションアドレスを変更できません
任意に。 これはセクションを再配置しないことに注意してください。 プログラムが期待する場合
特定のアドレスにロードされるセクション。このオプションは、
別のアドレスにロードされるようなセクションでは、プログラムが失敗する可能性があります。

--変更セクションアドレス {=、+、-}ヴァル
--調整-セクション-vma {=、+、-}ヴァル
名前付きの VMA アドレスと LMA アドレスの両方を設定または変更します。 。 場合 = is
セクションアドレスは ヴァル。 さもないと、 ヴァル 加算または減算されます
セクションアドレスから。 以下のコメントを参照してください --アドレス変更、 その上。 もしも
が入力ファイルに存在しない場合、警告が発行されます。
-変更なし-警告 使用されている。

--変更セクション-lma {=、+、-}ヴァル
名前付きの LMA アドレスを設定または変更します . LMA アドレスはアドレスです。
プログラムのロード時にセクションがメモリにロードされます。 通常、これは
プログラム実行時のセクションのアドレスである VMA アドレスと同じ
しかし、一部のシステム、特にプログラムが ROM に保持されているシステムでは、この XNUMX つは
違う。 もしも = が使用される場合、セクションアドレスはに設定されます ヴァル。 さもないと、 ヴァル 追加されます
セクションアドレスから、またはセクションアドレスから減算されます。 以下のコメントを参照してください --アドレス変更,
その上。 もし が入力ファイルに存在しない場合、警告が発行されます。
-変更なし-警告 使用されている。

--change-セクション-vma {=、+、-}ヴァル
名前付きの VMA アドレスを設定または変更します . VMA アドレスはアドレス
プログラムの実行が開始されると、セクションはどこに配置されますか。 通常は
これは LMA アドレスと同じで、セクションが配置されるアドレスです。
メモリにロードされますが、一部のシステムでは、特にプログラムが保持されているシステムでは
ROM、XNUMXつは異なる場合があります。 もしも = が使用される場合、セクションアドレスはに設定されます ヴァル.
さもないと、 ヴァル セクションアドレスに加算または減算します。 コメントを見る
下 --アドレス変更、 その上。 もしも 入力ファイルに存在しない、
場合を除き、警告が発せられます。 -変更なし-警告 使用されている。

-変更-警告
-調整-警告
If --変更セクションアドレス or --変更セクション-lma or --change-セクション-vma 使用されている、
指定されたセクションが存在しない場合は、警告を発行します。 これがデフォルトです。

-変更なし-警告
-調整なし-警告
次の場合は警告を発行しないでください --変更セクションアドレス or --adjust-セクション-lma or
--調整-セクション-vma 名前付きセクションが存在しない場合でも使用されます。

--set-section-flags =フラグ
名前付きセクションのフラグを設定します。 の フラグ 引数はカンマ区切りの文字列です
フラグ名の。 認識されている名前は 割り当てる, 中身, 負荷, 無負荷, 読み取り専用,
コード, データ, ROM, シェア, debug。 あなたは設定することができます 中身 セクションのフラグ
内容はありませんが、クリアしても意味がありません 中身 の旗
内容のあるセクション -- 代わりにセクションを削除するだけです。 すべてのフラグがあるわけではありません
すべてのオブジェクト ファイル形式で意味があります。

-追加-セクション セクション名=ファイル名
名前の付いた新しいセクションを追加します セクション名 ファイルのコピー中。 新しい内容
セクションはファイルから取得されます ファイル名。 セクションのサイズはのサイズになります
ファイル。 このオプションは、次のセクションをサポートできるファイル形式でのみ機能します。
任意の名前。

-名前の変更-セクション 古い名前=新しい名前[,フラグ]
セクションの名前を 古い名前 〜へ 新しい名前、オプションでセクションのフラグを次のように変更します
フラグ 過程の中で。 これには、リンカースクリプトを使用して実行するよりも優れています。
出力がオブジェクトファイルとして残り、リンクされないという点で名前を変更します
実行可能ファイル。

このオプションは、入力形式がバイナリの場合に特に役立ちます。
常に.dataというセクションを作成します。 たとえば、代わりに
バイナリデータを含む.rodataというセクションでは、次のコマンドラインを使用できます
それを達成するために：

objcopy-Iバイナリ-O -NS \
-名前の変更-section.data = .rodata、alloc、load、readonly、data、contents \


--先頭文字の変更
一部のオブジェクトファイル形式では、記号の先頭に特殊文字が使用されます。 最も
このような一般的な文字はアンダースコアです。これは、コンパイラがすべての記号の前に追加することがよくあります。
このオプションは オブジェクトコピー すべての記号の主役を変更する場合
オブジェクトファイル形式間で変換します。 オブジェクトファイル形式が同じ先頭を使用する場合
文字の場合、このオプションは効果がありません。 それ以外の場合は、文字を追加するか、
必要に応じて、文字を変更するか、文字を変更します。

--先頭の文字を削除
グローバルシンボルの最初の文字が、使用される特殊シンボルの先頭文字である場合
オブジェクトファイル形式で、文字を削除します。 主要な最も一般的な記号
文字は下線です。 このオプションは、すべてのグローバルから先頭のアンダースコアを削除します
シンボル。 これは、異なるファイルのオブジェクトをリンクする場合に便利です。
シンボル名の規則が異なるフォーマット。 これはとは異なります
--先頭文字の変更 必要に応じて常にシンボル名を変更するため、
出力ファイルのオブジェクトファイル形式に関係なく。

--srec-len =ival
srec出力に対してのみ意味があります。 Srecordsの最大長を設定します
に生産 ival。 この長さは、アドレス、データ、およびcrcフィールドの両方をカバーします。

--srec-forceS3
srec出力に対してのみ意味があります。 S1 / S2レコードの生成を避け、S3のみを作成します
レコード形式。

--redefine-sym 古い=新製品
シンボルの名前を変更する 古いへ 新製品。 これは、リンクを試しているときに役立ちます
ソースがなく、名前の衝突があるXNUMXつのもの。

--redefine-syms =ファイル名
申し込む --redefine-sym 各シンボルペアに "古い 新製品"ファイルに記載されています ファイル名.
ファイル名 は単純なフラットファイルで、XNUMX行にXNUMXつのシンボルペアがあります。 行コメントは
ハッシュ文字によって導入されます。 このオプションは複数回指定できます。

- 弱める
ファイル内のすべてのグローバルシンボルをweakに変更します。 これは、構築するときに役立ちます
を使用して他のオブジェクトに対してリンクされるオブジェクト -R リンカへのオプション。
このオプションは、weakをサポートするオブジェクトファイル形式を使用する場合にのみ有効です。
シンボル。

--keep-symbols =ファイル名
申し込む --keep-シンボル ファイルにリストされている各シンボルのオプション ファイル名. ファイル名 is
XNUMX行にXNUMXつのシンボル名を持つ単純なフラットファイル。 行コメントはによって導入される可能性があります
ハッシュ文字。 このオプションは複数回指定できます。

--strip-symbols =ファイル名
申し込む --ストリップシンボル ファイルにリストされている各シンボルのオプション ファイル名. ファイル名 is
XNUMX行にXNUMXつのシンボル名を持つ単純なフラットファイル。 行コメントはによって導入される可能性があります
ハッシュ文字。 このオプションは複数回指定できます。

--strip-unneeded-symbols =ファイル名
申し込む --strip-不要な記号 ファイルにリストされている各シンボルのオプション ファイル名.
ファイル名 は単純なフラットファイルで、XNUMX行にXNUMXつのシンボル名が付いています。 行コメントは
ハッシュ文字によって導入されます。 このオプションは複数回指定できます。

--keep-global-symbols =ファイル名
申し込む --keep-グローバルシンボル ファイルにリストされている各シンボルのオプション ファイル名.
ファイル名 は単純なフラットファイルで、XNUMX行にXNUMXつのシンボル名が付いています。 行コメントは
ハッシュ文字によって導入されます。 このオプションは複数回指定できます。

--localize-symbols =ファイル名
申し込む --ローカライズ記号 ファイルにリストされている各シンボルのオプション ファイル名. ファイル名
は単純なフラットファイルで、XNUMX行にXNUMXつのシンボル名が付いています。 行コメントが導入される場合があります
ハッシュ文字で。 このオプションは複数回指定できます。

--weaken-symbols =ファイル名
申し込む --weaken-シンボル ファイルにリストされている各シンボルのオプション ファイル名. ファイル名 is
XNUMX行にXNUMXつのシンボル名を持つ単純なフラットファイル。 行コメントはによって導入される可能性があります
ハッシュ文字。 このオプションは複数回指定できます。

--alt-machine-code =index
出力アーキテクチャに代替マシンコードがある場合は、 index代わりにthコード
デフォルトのものの。 これは、マシンに公式コードが割り当てられている場合に役立ちます。
ツールチェーンは新しいコードを採用しますが、他のアプリケーションは依然として
オリジナルコードを採用。

-書き込み可能-テキスト
出力テキストを書き込み可能としてマークします。 このオプションは、すべてのオブジェクトファイルにとって意味があるわけではありません
フォーマット。

-読み取り専用-テキスト
出力テキストを書き込み禁止にします。 このオプションは、すべてのオブジェクトにとって意味があるわけではありません
ファイル形式。

- ピュア
出力ファイルをデマンドページングとしてマークします。 このオプションは、すべてのオブジェクトにとって意味があるわけではありません
ファイル形式。

-不純
出力ファイルを不純としてマークします。 このオプションは、すべてのオブジェクトファイルにとって意味があるわけではありません
フォーマット。

--prefix-symbols =文字列
出力ファイルのすべての記号の前に 文字列.

--prefix-sections =文字列
出力ファイルのすべてのセクション名の前に 文字列.

--prefix-alloc-sections =文字列
出力ファイルで割り当てられたすべてのセクションのすべての名前の前に 文字列.

--add-gnu-debuglink =ファイルへのパス
への参照を含む.gnu_debuglinkセクションを作成します ファイルへのパス と追加します
それを出力ファイルに。

--デバッグのみを保持する
ファイルを削除し、によって削除されるセクションを削除します --strip-debug &
デバッグセクションを残します。

このオプションは、 --add-gnu-debuglink
XNUMXつの部分からなる実行可能ファイルを作成します。 より少ないスペースを占めるXNUMXつのストリップされたバイナリ
RAMとディストリビューション、そしてXNUMX番目のデバッグ情報ファイルは
デバッグ機能が必要な場合に必要です。 これらを作成するための推奨手順
ファイルは次のとおりです。

1。
「foo」そして...

1。
デバッグ情報を含むファイルを作成します。

1。
実行可能ファイルを削除しました。

1。
デバッグ情報へのリンクを削除された実行可能ファイルに追加します。

注-デバッグ情報ファイルの拡張子として「.dbg」を選択するかどうかは任意です。
また、「-only-keep-debug」ステップはオプションです。 代わりにこれを行うことができます：

1。
1。
1。
1。

つまり、 --add-gnu-debuglink 完全な実行可能ファイルにすることができます。 します
によって作成されたファイルである必要はありません --デバッグのみを保持する スイッチ。

-V
- バージョン
のバージョン番号を表示する オブジェクトコピー.

-v
-詳細
詳細出力：変更されたすべてのオブジェクトファイルを一覧表示します。 アーカイブの場合、 オブジェクトコピー -V
アーカイブのすべてのメンバーを一覧表示します。

- 助けて
オプションの概要を表示する オブジェクトコピー.

- 情報
使用可能なすべてのアーキテクチャとオブジェクト形式を示すリストを表示します。

onworks.net サービスを使用してオンラインで h8300-hms-objcopy を使用する