[Index]

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]
        [`-G' symbolname|`--keep-global-symbol='symbolname]
        [`-L' symbolname|`--localize-symbol='symbolname]
        [`-W' symbolname|`--weaken-symbol='symbolname]
        [`-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 ]
        [`--weaken']
        [`--keep-symbols='filename]
        [`--strip-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]
        [`-v'|`--verbose']
        [`-V'|`--version']  
        [`--help'] [`--info']
        infile [outfile]

GNU objcopyユーティリティは，オブジェクトファイルの内容を別のファイルにコピーします．objcopyはオブジェクトファイルの読み書きにGNU BFDを使用します．コピー先のオブジェクトファイルに，コピー元のオブジェクトファイルとは異なるフォーマットで書き出すことが可能です．objcopyの正確な動作は，コマンドラインオプションで制御されます．objcopyは，完全にリンクされているファイルを，二つの書式間でコピー可能であるべきだということに注意してください．しかし，再配置可能なオブジェクトファイルを二つのフォーマットの間でコピーすることは，期待したようには動作しません．

objcopyは，その変換を行うために一時ファイルを作成し，その後でそれを削除します．objcopyは，そのすべての変換作業で BFDを使用します．それは，BFDで記述されているすべてのフォーマットにアクセスするので，明示的に伝えること無く，ほとんどのフォーマットを認識することが可能です．See section `BFD' in Using LD.

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 section 15.1 ターゲットの選択.

-O bfdname

--output-target=bfdname

出力ファイルを，オブジェクトファイルのフォーマットbfdnameを用いて書き出します．詳細は，See section 15.1 ターゲットの選択.

-F bfdname

--target=bfdname

入出力両方のファイルに対し，オブジェクトのフォーマットとして bfdnameを使用します．すなわち，単純に元ファイルからコピー先のファイルに，変換せずにデータを転送します．詳細は，See section 15.1 ターゲットの選択.

-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をコピーしません．このオプションは，一回以上与えてもかまいません．

-G symbolname

--keep-global-symbol=symbolname

グローバルなsymbolnameシンボルのみ保持します．すべての他のシンボルをそれらが外部から見えないようにファイルローカルにします．このオプションは一回以上与えてもかまいません．

-L symbolname

--localize-symbol=symbolname

外部から見えないようにするため，シンボルsymbolnameをファイルでローカルにします．このオプションは，一回以上与えてもかまいません．

-W symbolname

--weaken-symbol=symbolname

シンボルsymbolnameを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に変更します．ソースを持っていない二つのものを一緒にリンクしようとし，名前の衝突があるとき便利です．

--weaken

ファイルのすべてのグローバルシンボルをweakにします．リンカに対し `-R'オプションを使用している他のオブジェクトに対してリンクするオブジェクトを構築するとき，これは便利です．このオプションは，weakなシンボルをサポートしているオブジェクトファイルを使用しているときだけ効果があります．

--keep-symbols=filename

`--keep-symbol'オプションを，ファイルfilenameにリストアップされているそれぞれのシンボルに適用します．filenameは単なるフラットなファイルで，一行に一つのシンボル名があります．行のコメントはハッシュ文字で導入されます．このオプションは一回以上与えてもかまいません．

--strip-symbols=filename

`--strip-symbol'オプションを，ファイルfilenameにリストアップされているそれぞれのシンボルに適用します．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番目のコードを使用します．マシンに公式のコードが割り当てられていて，ツールチェーンが新しいコードに適用するのですが，他のアプリケーションはまだ使用されているオリジナルのコードに依存している状況では，これは役に立ちます．

--prefix-symbols=string