日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
OBJCOPY(1) FreeBSD 一般コマンドマニュアル OBJCOPY(1)
名称
objcopy, objcopy -- オブジェクトファイルをコピーして変換する
書式
objcopy [-I objformat | -s objformat | --input-target=objformat]
[-K symbolname | --keep-symbol=symbolname]
[-L symbolname | --localize-symbol=symbolname]
[-N symbolname | --strip-symbol=symbolname]
[-O objformat | --output-target=objformat]
[-R sectionname | --remove-section=sectionname] [-S | --strip-
all] [-V | --version] [-W symbolname | --weaken-
symbol=symbolname] [-X | --discard-locals] [-d | -g | --strip-
debug] [-h | --help] [-j sectionname | --only-
section=sectionname] [-p | --preserve-dates] [-w | --wildcard]
[-x | --discard-all] [--add-gnu-debuglink=filename] [--add-
section sectionname=filename] [--adjust-section-vma
section{+|-|=}val | --change-section-address section{+|-|=}val]
[--adjust-start=increment | --change-start=increment] [--adjust-
vma=increment | --change-addresses=increment] [--adjust-
warnings | --change-warnings] [--change-section-
lma section{+|-|=}val] [--change-section-vma section{+|-|=}val]
[--extract-dwo] [--gap-fill=val] [--globalize-
symbol=ar symbolname] [--globalize-symbols=filename] [--localize-
hidden] [--localize-symbols=filename] [--no-adjust-
warnings | --no-change-warnings] [--only-keep-debug] [--pad-
to=address] [--prefix-alloc-sections=string] [--prefix-
sections=string] [--prefix-symbols=string] [--rename-
section oldname=newname[,flags]] [--set-section-
flags sectionname=flags] [--set-start=address] [--srec-forceS3]
[--srec-len=val] [--strip-dwo] [--strip-symbols=filename]
[--strip-unneeded] infile [outfile]
解説
objcopy ユーティリティは、指定されたコマンド行オプションにしたがって、引
数 infile によって指定されたバイナリオブジェクトの内容を変換して、引数
outfile によって指定されたバイナリのオブジェクトにコピーします。引数
outfile が指定されないなら、objcopy は、一時ファイルを作成し、その後
infile としてそれの名前を変更します。
objcopy ユーティリティは、次のオプションをサポートしています:
-I objformat | -s objformat | --input-target=objformat
引数 infile によって指定された入力ファイルは、引数 objformat に
よって指定されたオブジェクト形式であることを指定します。
-K symbolname | --keep-symbol=symbolname
引数 symbolname によって指定されたシンボルを出力にコピーします。
-L symbolname | --localize-symbol=symbolname
引数 symbolname によって指定されたシンボルを出力ファイルにローカ
ルにします。
-N symbol | --strip-symbol=symbolname
引数 symbolname によって指定されたたシンボルを出力にコピーしませ
ん。
-O objformat | --output-target=objformat
引数 objformat で指定されたオブジェクト形式を使用して出力ファイル
に書き込みます。引数 objformat elftc_bfd_find_target(3) によって
認識されたターゲット名の 1 つであるべきです。
-R sectionname | --remove-section=sectionname
出力ファイルから名前 sectionname があるあらゆるセクションを削除し
ます。
-S | --strip-all
シンボルとリロケーション情報をターゲットファイルにコピーしませ
ん。
-V | --version
バージョン識別子を印刷 (表示) し、終了します。
-W symbolname | --weaken-symbol=symbolname
引数 symbolname によって指定されたシンボルを出力でウィークとして
マークします。
-X | --discard-locals
コンパイラ生成のローカルなシンボルを出力にコピーしません。
-d | -g | --strip-debug
デバッグ情報をターゲットファイルにコピーしません。
-h | --help
ヘルプメッセージを表示して、終了します。
-j sectionname | --only-section=sectionname
引数 sectionname によって指定されたセクションだけを出力にコピーし
ます。
-p | --preserve-dates
出力ファイルのアクセス時刻と更新時刻を入力のそれらの時刻と同じに
設定します。
-w | --wildcard
シンボルを指定するためにシェルスタイルのパターンを使用します。次
のメタ文字は、パターンに認識されています:
! これがパターンの最初の文字であるなら、パターン照合の意味を
逆にします。
* シンボル名のあらゆる文字列に一致します。
? シンボル名の 0 または 1 文字に一致します。
[ 文字クラスの開始を示します。
\ パターンの次の文字の特別な意味を取り除きます。
] 文字クラスの終わりを示します。
-x | --discard-all
グローバルでないシンボルを出力にコピーしません。
--add-gnu-debuglink=filename
filename のデバッグデータを参照する出力ファイルの .gnu_debuglink
セクションを作成します。
--add-section sectionname=filename
名前 sectionname で新しいセクションを出力ファイルに追加します。セ
クションの内容は、引数 filename によって指定されたファイルから取
られます。セクションのサイズは、ファイル filename のバイト数で
す。
--adjust-section-vma section{+|-|=}val | --change-section-address
section{+|-|=}val
指定されたオペレータに依存して、引数 section によって指定されたセ
クションの仮想メモリアドレスとロードメモリアドレスの両方を増加、
減少または設定します。引数 val は、アドレスのための要求された増
加、減少、または新しい値を指定します。
--adjust-start=increment | --change-start=increment
引数 increment で指定された値によって出力 ELF オブジェクトのエン
トリポイントアドレスを増加します。
--adjust-vma=increment | --change-addresses=increment
引数 increment によって指定された値によってすべてのセクションの仮
想メモリアドレスとロードメモリアドレスを増加します。
--adjust-warnings | --change-warnings
セクションがオプション --change-section-address, --change-
section-lma によって指定したか、または、--change-section-vma が、
入力オブジェクトに存在しないなら、警告を発行します。これは、デ
フォルトです。
--change-section-lma section{+|-|=}val
引数 section によって指定されたセクションのロードメモリアドレスを
変更するか、または設定します。指定されたオペレータに依存して、引
数 val の値は、増加、減少またはロードメモリアドレスの新しい値とし
て使用されます。
--change-section-vma section{+|-|=}val
引数 section によって指定されたセクションの仮想メモリアドレスを変
更するか、または設定します。指定されたオペレータに依存して、引数
val の値は、増加、減少または仮想メモリアドレスの新しい値として使
用されます。
--extract-dwo
.dwo デバッグセクションだけを出力ファイルにコピーします。
--gap-fill=val
引数 val によって指定されたバイト値でセクションの間のギャップを満
たします。
--globalize-symbol=symbolname
それが定義されるファイルの外側で見ることができるように、グローバ
ルな引数 symbolname によって指定されたシンボルを作成します。
--globalize-symbols=filename
グローバルな filename によって指定されたファイルにリストされた各
シンボルを作成します。
--localize-hidden
すべての隠されたシンボルを出力ファイルにローカルにします。これ
は、シンボルを内部の可視性に含めます。
--localize-symbols=filename
ローカルな filename によって指定されたファイルにリストされた各シ
ンボルを出力ファイルに作成します。
--no-adjust-warnings | --no-change-warnings
セクションがオプション --change-section-address, --change-
section-lma によって指定したか、または、--change-section-vma が入
力オブジェクトに見つからないなら、警告を発行しません。
--only-keep-debug
デバッグ情報だけを出力ファイルにコピーします。
--pad-to=address
最も高いロードメモリアドレスでセクションのサイズを増加させること
によって引数 address によって指定された値に出力オブジェクトのロー
ドメモリアドレスに詰め物をします。
--prefix-alloc-sections=string
string ですべての割り付けられたセクションのセクション名を前に置き
ます。
--prefix-sections=string
string ですべてのセクションのセクション名を前に置きます。
--prefix-symbols=string
string ですべてのシンボルのシンボル名を前に置きます。
--rename-section oldname=newname[,flags]
オプションでセクションフラグを引数 flags によって指定されたセク
ションフラグに変更して、引数によって指定されたセクションの名前を
oldname から newname に変更します。引数 flags のための許可された
値は、下記のオプション --set-section-flags と同様です。
--set-section-flags sectionname=flags
引数 sectionname によって指定されたセクションのためのフラグを引数
flags によって指定されたものに設定します。引数 flags は、次のフラ
グ名のコンマで区切られたリストです:
alloc セクションは、出力ファイルに空白を専用します。
code セクションは、マシン語命令を含んでいます。
contents このフラグは、受け付けられますが、無視されます。
data セクションは、書き込み可能なデータを含んでいます。
debug セクションは、デバッグ情報を保持します。
load セクションは、ロード可能です。
noload セクションは、メモリにロードされるべきではありません。
readonly セクションは、書き込み可能ではありません。
rom セクションは、ROM 可能な内容を含んでいます。
share このフラグは、受け付けられますが、無視されます。
--set-start=address
出力 ELF オブジェクトの開始アドレスを、引数 address によって指定
された値に設定します。
--srec-forceS3
タイプ ``S3'' S レコードのみを生成します。このオプションは、出力
ターゲットが ``srec'' に設定されるとき、のみ意味があります。
--srec-len=val
S レコード行の最大の長さを val に設定します。このオプションは、出
力ターゲットが ``srec'' に設定されるときのみ意味があります。
--strip-dwo
.dwo デバッグセクションを出力ファイルにコピーしません。
--strip-symbols=filename
filename によって指定されたシンボルのいずれかを出力にコピーしませ
ん。
--strip-unneeded
リロケーション処理のために必要ではないシンボルをコピーしません。
診断
ユーティリティ objcopy は、成功すると 0 で、エラーがあった場合は >0 で終
了します。
関連項目
ar(1), ld(1), mcs(1), strip(1), elf(3), elftc_bfd_find_target(3), ar(5),
elf(5)
互換性
objcopy ユーティリティは、GNU objcopy と互換性のあるオプションであること
が期待されています。
歴史
objcopy は、Kai Wang <kaiwang27@users.sourceforge.net> によって実行されま
した。
FreeBSD 11.3 August 30, 2017 FreeBSD 11.3