3 objcopy
objcopy [-F bfdname|--target=bfdname]
[-I bfdname|--input-target=bfdname]
[-O bfdname|--output-target=bfdname]
[-B bfdarch|--binary-architecture=bfdarch]
[-S|--strip-all]
[-g|--strip-debug]
[-K symbolname|--keep-symbol=symbolname]
[-N symbolname|--strip-symbol=symbolname]
[--strip-unneeded-symbol=symbolname]
[-G symbolname|--keep-global-symbol=symbolname]
[-L symbolname|--localize-symbol=symbolname]
[-W symbolname|--weaken-symbol=symbolname]
[-w|--wildcard]
[-x|--discard-all]
[-X|--discard-locals]
[-b byte|--byte=byte]
[-i interleave|--interleave=interleave]
[-j sectionname|--only-section=sectionname]
[-R sectionname|--remove-section=sectionname]
[-p|--preserve-dates]
[--debugging]
[--gap-fill=val]
[--pad-to=address]
[--set-start=val]
[--adjust-start=incr]
[--change-addresses=incr]
[--change-section-address section{=,+,-}val]
[--change-section-lma section{=,+,-}val]
[--change-section-vma section{=,+,-}val]
[--change-warnings] [--no-change-warnings]
[--set-section-flags section=flags]
[--add-section sectionname=filename]
[--rename-section oldname=newname[,flags]]
[--change-leading-char] [--remove-leading-char]
[--srec-len=ival] [--srec-forceS3]
[--redefine-sym old=new]
[--redefine-syms=filename]
[--weaken]
[--keep-symbols=filename]
[--strip-symbols=filename]
[--strip-unneeded-symbols=filename]
[--keep-global-symbols=filename]
[--localize-symbols=filename]
[--weaken-symbols=filename]
[--alt-machine-code=index]
[--prefix-symbols=string]
[--prefix-sections=string]
[--prefix-alloc-sections=string]
[--add-gnu-debuglink=path-to-file]
[--only-keep-debug]
[--writable-text]
[--readonly-text]
[--pure]
[--impure]
[-v|--verbose]
[-V|--version]
[--help] [--info]
infile [outfile]
gnu objcopyユーティリティは,オブジェクトファイルの内容
を別のファイルにコピーします.objcopyはオブジェクトファイルの
読み書きにgnu bfdを使用します.コピー先のオブジェクトファイル
に,コピー元のオブジェクトファイルとは異なるフォーマットで書き出すこと
が可能です.objcopyの正確な動作は,コマンドラインオプションで
制御されます.objcopyは,完全にリンクされているファイルを,二
つの書式間でコピー可能であるべきだということに注意してください.しかし,
再配置可能なオブジェクトファイルを二つのフォーマットの間でコピーするこ
とは,期待したようには動作しません.
objcopyは,その変換を行うために一時ファイルを作成し,その後で
それを削除します.objcopyは,そのすべての変換作業でbfdを
使用します.それは,bfdで記述されているすべてのフォーマットにアク
セスするので,明示的に伝えること無く,ほとんどのフォーマットを認識する
ことが可能です.See BFD.
objcopyは,`srec'出力ターゲットを使用することで,
S-recordを生成するために使用することが可能です(例えば,-O
srecを使用してください).
objcopyは,`binary'の出力ターゲットを使用することで,生
のバイナリファイルを生成するために使用することが可能です(例えば,
-O binaryを使用してください).objcopyが生のバイナリ
ファイルを生成するとき,それは本質的に,入力オブジェクトファイルの内容
のメモリダンプを生成します.すべてのシンボルと再配置の情報は削除されま
す.メモリダンプは,出力ファイルにコピーされる最抵位のセクションのロー
ドアドレスから開始します.
S-recordや生のバイナリファイルを生成するとき,デバッグ情報を含むセクショ
ンを削除するため,-Sを使用すると便利かもしれません.場合によっ
ては,バイナリファイルに必要のない情報を含むセクションを削除するため,
-Rが役に立つでしょう.
注意—objcopyは,入力ファイルのエンディアンを変更することが
できません.入力フォーマットにエンディアンがある場合,(持たないフォーマッ
トもあります),objcopyは,入力ファイルを同じエンディアンを持
つ,またはエンディアンを持たないフォーマットのファイル(例えば
`srec')だけにコピーすることが可能です.
- infile
- outfile
-
それぞれ入力と出力のファイルです.outfileを指定しない場合,
objcopyは結果的に破壊される一時ファイルを作成し,
infileに名前を変更します.
- -I bfdname
- --input-target=bfdname
-
ソースファイルのオブジェクトのフォーマットを,それを導き出すのではなく,
bfdnameと考えます.詳細は,See Target Selection.
- -O bfdname
- --output-target=bfdname
-
出力ファイルを,オブジェクトファイルのフォーマットbfdnameを用いて
書き出します.詳細は,See Target Selection.
- -F bfdname
- --target=bfdname
-
入出力両方のファイルに対し,オブジェクトのフォーマットとして
bfdnameを使用します.すなわち,単純に元ファイルからコピー先のファ
イルに,変換せずにデータを転送します.詳細は,See Target Selection.
- -B bfdarch
- --binary-architecture=bfdarch
-
生の入力ファイルをオブジェクトファイルに変換するとき役に立ちます.この
状況では,出力先のアーキテクチャはbfdarchに設定されるはずです.入
力ファイルに既知のbfdarchがある場合,このオプションは無視されます.
変換処理で作成される特殊なシンボルを参照することで,このバイナリデータ
をプログラム内部でアクセスすることが可能です.これらのシンボルは,
`_binary_objfile_start',`_binary_objfile_end',
そして`_binary_objfile_size'という名前です.例えば,画像ファ
イルをオブジェクトファイルに変換した後,これらのシンボルを使用してコー
ド内でアクセスすることが可能です.
- -j sectionname
- --only-section=sectionname
-
指名されたセクションのみ,入力ファイルから出力ファイルへコピーします.
このオプションは,一回以上与えてもかまいません.このオプションを不適切
に使用すると,出力ファイルが使用不可能になることに注意してください.
- -R sectionname
- --remove-section=sectionname
-
指名されている,あらゆるsectionnameセクションを出力ファイルから削
除します.このオプションは,一回以上与えてもかまいません.このオプショ
ンを不適切に使用すると,出力ファイルが使用不可能になることに注意してく
ださい.
- -S
- --strip-all
-
再配置の情報ととシンボルの情報を,ソースファイルからコピーしません.
- -g
- --strip-debug
-
デバッグのシンボルやセクションをソースファイルからコピーしません.
- --strip-unneeded
-
再配置の処理に不要な,すべてのシンボルを削除します.
- -K symbolname
- --keep-symbol=symbolname
-
ソースファイルからシンボルsymbolnameのみコピーします.このオプショ
ンは,一回以上与えてもかまいません.
- -N symbolname
- --strip-symbol=symbolname
-
ソースファイルからシンボルsymbolnameをコピーしません.このオプショ
ンは,一回以上与えてもかまいません.
- --strip-unneeded-symbol=symbolname
-
再配置で必要でない限り,シンボルsymbolnameを,ソースファイルから
コピーしません.このオプションは,一回以上与えてもかまいません.
- -G symbolname
- --keep-global-symbol=symbolname
-
グローバルなsymbolnameシンボルのみ保持します.すべての他のシンボ
ルをそれらが外部から見えないようにファイルローカルにします.このオプショ
ンは一回以上与えてもかまいません.
- -L symbolname
- --localize-symbol=symbolname
-
外部から見えないようにするため,シンボルsymbolnameをファイルでロー
カルにします.このオプションは,一回以上与えてもかまいません.
- -W symbolname
- --weaken-symbol=symbolname
-
シンボルsymbolnameをweakにします.このオプションは,一回以上与え
てもかまいません.
- -w
- --wildcard
-
コマンドラインオプションで使用するため,symbolnameでの正規表現を
許可します.疑問符(?),アスタリスク(*),バックスラッシュ(\),そして角括
弧([])オペレータを,シンボル名の任意の場所に使用することが可能です.シ
ンボル名の最初の文字が感嘆符(!)の場合,シンボルに対するスイッチの意味を
反対にします.例えば,以下を考えます.
-w -W !foo -W fo*
これで,objcopyは,シンボル“foo”以外の,“fo”で始まるすべ
てのシンボルをweakにします.
- -x
- --discard-all
-
ソースファイルからグローバルでないシンボルをコピーしません.
- -X
- --discard-locals
-
コンパイラが生成したローカルなシンボルをコピーしません.(これらは通常,
`L'または`.'ではじまります.)
- -b byte
- --byte=byte
-
入力ファイルのbyteバイトごとのバイトのみ保持します(ヘッダデータは
影響されません).byteは,0からinterleave-1までの範囲が可能
で,interleaveは,-iや--interleaveオプションで
与えられる,またはデフォルトの4になります.このオプションは,プログラマ
ブルromにファイルを作成するとき便利です.それは特に,
srec
出
力ターゲットとともに使用されます.
- -i interleave
- --interleave=interleave
-
interleaveバイトごとに一つだけコピーします.-bや
--byteオプションを用いてそのバイトを選択してください.デフォル
トは4です.objcopyは,-bや--byteを指定して
いない場合,このオプションを無視します.
- -p
- --preserve-dates
-
出力ファイルのアクセスと編集の日付を入力ファイルと同じに設定します.
- --debugging
-
可能な場合,デバッグ情報を変換します.特定のデバッグフォーマットのみサ
ポートされていて,そして,変換処理は時間がかかるため,これはデフォルト
ではありません.
- --gap-fill val
-
valを用いてセクション間のギャップを補充します.このオプションはセ
クションのload address (LMA)に適用されます.それは,lower
addressでセクションの大きさを増加し,そして,valを用いて作成され
る余分な空間で補充することで動作します.
- --pad-to address
-
出力ファイルをload address addressまでパディングします.これは,
最後のセクションの大きさを増加することで動作します.余分な空間は,
--gap-fillで指定された値(デフォルトはゼロ)で補充されます.
- --set-start val
-
新しいファイルの開始アドレスをvalに設定します.すべてのオブジェク
トファイルのフォーマットが,開始アドレスの設定をサポートするわけではあ
りません.
- --change-start incr
- --adjust-start incr
-
開始アドレスをincrを加えることで変更します.すべてのオブジェクト
ファイルのフォーマットが,開始アドレスの設定をサポートするわけではあり
ません.
- --change-addresses incr
- --adjust-vma incr
-
開始アドレスのように,incrを加えることで,VMAとLMAアドレスを変更
します.オブジェクトファイルのフォーマットによっては,セクションアドレ
スを任意に変更できないものもあります.これはセクションを再配置しないこ
とに注意してください.セクションが特定のアドレスにロードされていること
をプログラムが期待し,セクションが異なるアドレスにロードされるように変
更するために,このオプションが使用された場合,プログラムは失敗するかも
しれません.
- --change-section-address section{=,+,-}val
- --adjust-section-vma section{=,+,-}val
-
sectionで指名されたVMAアドレスとLMAアドレスの両方を設定または変更
します.`='が使用された場合,セクションのアドレスは,val に
設定されます.それ以外の場合,valは,セクションアドレスに加えられ
る,またはそれから引かれます.上記の--change-addresses以下のコ
メントを参照してください.入力ファイルにsectionが存在しない場合,
--no-change-warningsが使用されていない限り,警告が発せられます.
- --change-section-lma section{=,+,-}val
-
指名されたsectionのLMAアドレスを設定または変更します.LMAアドレス
は,プログラムロード時にセクションがメモリにロードされるアドレスです.
通常これはVMAと同じで,それは,プログラムの実行時のセクションのアドレス
ですが,システムによっては,特にプログラムがROMに保存されるものでは,二
つが異なる可能性があります.`='が使用されている場合,セクションの
アドレスは,valに設定されます.それ以外の場合,valはセクショ
ンアドレスに加えられる,またはそれから引かれます.上記の
--change-addresses以下のコメントを参照してください.
sectionが入力ファイルに存在しない場合,
--no-change-warningsが使用されていない限り,警告が発せられます.
- --change-section-vma section{=,+,-}val
-
指名されたsectionのVMAアドレスを設定または変更します.VMAアドレス
は,プログラムの実行を開始したときにセクションが位置するアドレスです.
通常これはLMAと同じで,それは,セクションがメモリにロードされるアドレス
ですが,システムによっては,特にプログラムがROMに保存されるものでは,二
つのアドレスが異なる可能性があります.`='が使用されている場合,セ
クションのアドレスは,valに設定されます.それ以外の場合,
valはセクションアドレスに加えられる,またはそれから引かれます.上
記の--change-addresses以下のコメントを参照してください.
sectionが入力ファイルに存在しない場合,
--no-change-warningsが使用されていない限り,警告が発せられます.
- --change-warnings
- --adjust-warnings
-
--change-section-addressや--change-section-lmaや
--change-section-vmaが使用されていて,指名されたセクションが存
在しない場合,警告を発します.これはデフォルトです.
- --no-change-warnings
- --no-adjust-warnings
-
--change-section-addressや--change-section-lmaや
--change-section-vmaが使用されていて,指名されたセクションが存
在しない場合でも警告を発しません.
- --set-section-flags section=flags
-
指名したセクションのフラグを設定します.flags引数は,カンマで分け
られたフラグ名の文字列です.認識される名前は,`alloc',
`contents',`load',`noload',`readonly',
`code',`data',`rom',`share',そして`debug'
です.`contents'フラグを内容のないセクションに対し設定可能ですが,
内容のあるセクションの`contents'フラグとしての意味がありません—
その代わりにセクションを削除します.すべてのフラグがすべてのオブジェク
トファイルのフォーマットに意味があるわけではありません.
- --add-section sectionname=filename
-
ファイルをコピーしている間に,指名されたsectionnameの新しいセクショ
ンを追加します.新しいセクションの内容はファイルfilenameからもた
らされます.セクションの大きさは,ファイルの大きさになります.このオプ
ションは,任意の名前を持つセクションをサポート可能なファイルのフォーマッ
トでのみ動作します.
- --rename-section oldname=newname[,flags]
-
セクションの名前をoldnameからnewnameに変更し,オプションで
セクションのフラグをflagsに,処理中に変更します.名前の変更を実行
するためにリンカスクリプトを使用すると,オブジェクトファイルとして出力
が抑制されリンクされた実行形式にはならないので,これには利点があります.
このオプションは,`.data'いう名前のセクションを常に作成するので,
入力フォーマットがバイナリのとき,特に役に立ちます.例えば,バイナリデー
タを含んでいる`.rodata'いう名前のセクションを作成したい場合,それ
を達成するために以下のコマンドラインを使用することが可能でしょう.
objcopy -I binary -O <output_format> -B <architecture> \
--rename-section .data=.rodata,alloc,load,readonly,data,contents \
<input_binary_file> <output_object_file>
- --change-leading-char
-
オブジェクトファイルのフォーマットには,シンボルの開始時に特別な文字を
使用するものもあります.そのような文字で最もよくあるのはアンダースコア
で,それはコンパイラがすべてのシンボルの前によく追加するものです.この
オプションは,objcopyに,オブジェクトファイルのフォーマットを
変換している間にすべてのシンボルに前置される文字を変更するよう伝えます.
オブジェクトファイルのフォーマットが同じ前置文字を使用している場合,こ
のオプションは効果がありません.それ以外の場合,それは適切に,文字を加
えたり,文字を削除したり,文字を変更したりします.
- --remove-leading-char
-
グローバルシンボルの最初の文字が,オブジェクトファイルのフォーマットで
使用されているシンボルに前置される特殊な文字の場合,その文字を削除しま
す.そのような文字で最もよくあるのはアンダースコアです.このオプション
は,すべてのグローバルシンボルから前置されるアンダースコアを削除します.
シンボル名に対して異なる規則を持つ,異なるファイルフォーマットのオブジェ
クト同士をリンクしたい場合,これは役に立つはずです.これは
--change-leading-charとは異なり,出力ファイルのオブジェクトファ
イルのフォーマットに依存せず,それは適切なときは常にシンボル名を変更し
ます.
- --srec-len=ival
-
srec出力でのみ意味があります.生成されているSrecordの最大長を
ivalに設定します.この長さは,両方のアドレス,データ,そしてcrc
フィールドをカバーします.
- --srec-forceS3
-
srec出力でのみ意味があります.S1/S2レコードの生成を避け,S3のみのレコー
ドのフォーマットを作成します.
- --redefine-sym old=new
-
シンボル名をoldからnewに変更します.ソースを持っていない二
つのものを一緒にリンクしようとし,名前の衝突があるとき便利です.
- --redefine-syms=filename
-
ファイルfilenameにリストアップされているそれぞれのシンボル対
"old new"に,--redefine-symを適用します.
filenameは単純なフラットファイルで,一行ごとに一つのシンボルの組
を書きます.行コメントはハッシュ文字(#)で始めることが可能です.このオプ
ションは,一回以上与えてもかまいません.
- --weaken
-
ファイルのすべてのグローバルシンボルをweakにします.リンカに対し
-Rオプションを使用している他のオブジェクトに対してリンクするオ
ブジェクトを構築するとき,これは便利です.このオプションは,weakなシン
ボルをサポートしているオブジェクトファイルを使用しているときだけ効果が
あります.
- --keep-symbols=filename
-
--keep-symbolオプションを,ファイルfilenameにリストアッ
プされているそれぞれのシンボルに適用します.filenameは単なるフラッ
トなファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ
文字(#)で始めることが可能です.このオプションは一回以上与えてもかまいま
せん.
- --strip-symbols=filename
-
--strip-symbolオプションを,ファイルfilenameにリストアッ
プされているそれぞれのシンボルに適用します.filenameは単なるフラッ
トなファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ
文字(#)で始めることが可能です.このオプションは一回以上与えてもかまいま
せん.
- --strip-unneeded-symbols=filename
-
ファイルfilenameにリストアップされているそれぞれのシンボルに,に
--strip-unneeded-symbolを適用します.filenameは単純なフ
ラットファイルで,一行ごとに一つのシンボルを書きます.行コメントはハッ
シュ文字(#)で始めることが可能です.このオプションは一回以上与えてもかま
いません.
- --keep-global-symbols=filename
-
--keep-global-symbolオプションを,ファイルfilenameにリス
トアップされているそれぞれのシンボルに適用します.filenameは単な
るフラットなファイルで,一行に一つのシンボル名があります.行のコメント
はハッシュ文字(#)で始めることが可能です.このオプションは一回以上与えて
もかまいません.
- --localize-symbols=filename
-
--localize-symbolオプションを,ファイルfilenameにリスト
アップされているそれぞれのシンボルに適用します.filenameは単なる
フラットなファイルで,一行に一つのシンボル名があります.行のコメントは
ハッシュ文字(#)で始めることが可能です.このオプションは一回以上与えても
かまいません.
- --weaken-symbols=filename
-
--weaken-symbolオプションを,ファイルfilenameにリストアッ
プされているそれぞれのシンボルに適用します.filenameは単なるフラッ
トなファイルで,一行に一つのシンボル名があります.行のコメントはハッシュ
文字(#)で始めることが可能です.このオプションは一回以上与えてもかまいま
せん.
- --alt-machine-code=index
-
出力アーキテクチャに代替のマシンコードがある場合,デフォルトのものの代
わりにindex番目のコードを使用します.マシンに公式のコードが割り当
てられていて,ツールチェーンが新しいコードに適用するのですが,他のアプ
リケーションはまだ使用されているオリジナルのコードに依存している状況で
は,これは役に立ちます.
- --writable-text
-
出力テキストを書き込み可能で印をつけます.このオプションは,すべてのオ
ブジェクトファイルのフォーマットで意味があるわけではありません.
- --readonly-text
-
出力テキストを書き込み禁止で印をつけます.このオプションは,すべてのオ
ブジェクトファイルのフォーマットで意味があるわけではありません.
- --pure
-
出力ファイルを必須ページとして印をつけます.このオプションは,すべての
オブジェクトファイルのフォーマットで意味があるわけではありません.
- --impure
-
出力ファイルをimpure(不純)として印をつけます.このオプションは,すべて
のオブジェクトファイルのフォーマットで意味があるわけではありません.
- --prefix-symbols=string
-
出力ファイルのすべてのシンボルにstringを前置します.
- --prefix-sections=string
-
出力ファイルのすべてのセクション名にstringを前置します.
- --prefix-alloc-sections=string
-
出力ファイルのすべてのアロケートされたセクション名にstringを前置
します.
- --add-gnu-debuglink=path-to-file
-
path-to-fileへの参照を含み,それを出力ファイルに追加す
る,.gnu_debuglinkセクションを作成します.
- --only-keep-debug
-
--strip-debugでstripされるセクションを削除し,デバッグセクショ
ンを残しながら,ファイルをstripします.
このオプションの目的は,二つの部分の実行形式を作成するために
--add-gnu-debuglinkを組み合わせで使用します.一つは,RAMと配布
物にスペースが無い場合のstripされたバイナリで,二番目のデバッグ情報ファ
イルは,デバッグ能力が要求される場合だけ必要になります.これらのファイ
ルを作成するための推奨手順は以下の通りです.
- 通常の実行形式のリンク.
foo
と仮定します.
- デバッグ情報を含んでいるファイルを作成するために
objcopy
--only-keep-debug foo foo.dbg
の実行.
- stripされた実行形式を作成するために
objcopy --strip-debug foo
の実
行.
- stripされた実行形式にデバッグ情報を追加リンクするために
objcopy
--add-gnu-debuglink=foo.dbg foo
を実行.
注意 - デバッグ情報ファイルに対する拡張として,.dbg
の選択は任意
です.また,--only-keep-debug
の段階はオプションです.代わりに以
下のようにすることも可能です.
- 通常の実行形式のリンク.
foo
をfoo.full
へコピー.
strip --strip-debug foo
の実行.
objcopy --add-gnu-debuglink=foo.full foo
の実行.
つまり,--add-gnu-debuglinkで示されるファイルは,完全な実行形
式です.--only-keep-debugスイッチファイルを生成する必要はあり
ません.
- -V
- --version
-
objcopyのバージョンナンバーを表示します.
- -v
- --verbose
-
冗長な出力です.修正されたすべてのオブジェクトファイルをリストアップし
ます.アーカイブの場合,`objcopy -v'は,アーカイブのすべてのメンバー
をリストアップします.
- --help
-
objcopyへのオプションの概要を表示します.
- --info
-
すべてのアーキテクチャと利用可能なオブジェクトのフォーマットを示すリス
トを表示します.