summaryrefslogtreecommitdiff
path: root/ja/man/man1/objcopy.1
diff options
context:
space:
mode:
authorJun Kuriyama <kuriyama@FreeBSD.org>1998-10-10 13:09:09 +0000
committerJun Kuriyama <kuriyama@FreeBSD.org>1998-10-10 13:09:09 +0000
commit1df2059db73d2cbb52178c19b2d4ab834f4a5144 (patch)
treeb906d9cf72865a0582ee668fc592d2e0a6c8d36c /ja/man/man1/objcopy.1
parente360fabf3bb9fccb746f69e52db056c0dc364efc (diff)
Notes
Diffstat (limited to 'ja/man/man1/objcopy.1')
-rw-r--r--ja/man/man1/objcopy.1310
1 files changed, 310 insertions, 0 deletions
diff --git a/ja/man/man1/objcopy.1 b/ja/man/man1/objcopy.1
new file mode 100644
index 0000000000..d6d39bc513
--- /dev/null
+++ b/ja/man/man1/objcopy.1
@@ -0,0 +1,310 @@
+.\" Copyright (c) 1991, 93, 94, 95, 96, 1997 Free Software Foundation
+.\" See section COPYING for conditions for redistribution
+.\" jpman %Id: objcopy.1,v 1.2 1998/10/10 08:45:41 hnokubi Stab %
+.TH objcopy 1 "October 1994" "cygnus support" "GNU Development Tools"
+.de BP
+.sp
+.ti \-.2i
+\(**
+..
+
+.SH 名称
+objcopy \- オブジェクトファイルのコピーと変換
+
+.SH 書式
+.hy 0
+.na
+.TP
+.B objcopy
+.RB "[\|" \-F\ \fIbfdname\fR\ |\ \fB\-\-target=\fIbfdname\fR "\|]"
+.RB "[\|" \-I\ \fIbfdname\fR\ |\ \fB\-\-input\-target=\fIbfdname\fR "\|]"
+.RB "[\|" \-O\ \fIbfdname\fR\ |\ \fB\-\-output\-target=\fIbfdname\fR "\|]"
+.RB "[\|" \-R\ \fIsectionname\fR\ |\ \fB\-\-remove\-section=\fIsectionname\fR "\|]"
+.RB "[\|" \-S\fR\ |\ \fB\-\-strip\-all\fR "\|]"
+.RB "[\|" \-g\fR\ |\ \fB\-\-strip\-debug\fR "\|]"
+.RB "[\|" \-\-strip\-unneeded\fR "\|]"
+.RB "[\|" \-K\ \fIsymbolname\fR\ |\ \fB\-\-keep\-symbol=\fIsymbolname\fR "\|]"
+.RB "[\|" \-N\ \fIsymbolname\fR\ |\ \fB\-\-strip\-symbol=\fIsymbolname\fR "\|]"
+.RB "[\|" \-x\fR\ |\ \fB\-\-discard\-all\fR "\|]"
+.RB "[\|" \-X\fR\ |\ \fB\-\-discard\-locals\fR "\|]"
+.RB "[\|" \-b\ \fIbyte\fR\ |\ \fB\-\-byte=\fIbyte\fR "\|]"
+.RB "[\|" \-i\ \fIinterleave\fR\ |\ \fB\-\-interleave=\fIinterleave\fR "\|]"
+.RB "[\|" \-p\fR\ |\ \fB\-\-preserve\-dates\fR "\|]"
+.RB "[\|" \-\-debugging "\|]"
+.RB "[\|" \-\-gap\-fill=\fIval\fR "\|]"
+.RB "[\|" \-\-pad\-to=\fIaddress\fR "\|]"
+.RB "[\|" \-\-set\-start=\fIval\fR "\|]"
+.RB "[\|" \-\-adjust\-start=\fIincr\fR "\|]"
+.RB "[\|" \-\-adjust\-vma=\fIincr\fR "\|]"
+.RB "[\|" \-\-adjust\-section\-vma=\fIsection{=,+,-}val\fR "\|]"
+.RB "[\|" \-\-adjust\-warnings\fR "\|]"
+.RB "[\|" \-\-no\-adjust\-warnings\fR "\|]"
+.RB "[\|" \-\-set\-section\-flags=\fIsection=flags\fR "\|]"
+.RB "[\|" \-\-add\-section=\fIsectionname=filename\fR "\|]"
+.RB "[\|" \-\-change\-leading\-char\fR "\|]"
+.RB "[\|" \-\-remove\-leading\-char\fR "\|]"
+.RB "[\|" \-\-weaken\fR "\|]"
+.RB "[\|" \-v\ |\ \-\-verbose\fR "\|]"
+.RB "[\|" \-V\ |\ \-\-version\fR "\|]"
+.RB "[\|" \-\-help\fR "\|]"
+.B infile
+.RB "[\|" outfile\fR "\|]"
+.SH 解説
+GNU
+.B objcopy
+ユーティリティはあるオブジェクトファイルの内容を他へコピーします。
+.B objcopy
+はオブジェクトファイルの読み書きに GNU BFD ライブラリを使います。
+元のオブジェクトファイルと異なるフォーマットでコピー先の
+オブジェクトファイルに書き込む事が可能です。
+.B objcopy
+の厳密な挙動はコマンド・ラインの引数で制御します。
+.PP
+.B objcopy
+は変換のために一時ファイルを作成して後でそれらを削除します。
+.B objcopy
+はすべての変換作業で BFD を使います; つまり BFD が知っている
+フォーマットはすべて知っている事になるので、明示的に指定しなくても
+大部分のフォーマットを認識する事が出来ます。
+.PP
+.B objcopy
+で出力先に
+.B srec
+を指定する
+(例えば
+.B -O srec
+を使う) ことで Sレコードを生成できます。
+.PP
+.B objcopy
+で出力先に
+.B binary
+を指定する
+(例えば
+.B -O binary
+を使う) ことで生のバイナリファイルを生成できます。
+.B objcopy
+で生のバイナリファイルを生成することは、本質的には入力の
+オブジェクトファイルの内容のメモリダンプを生成することに
+なるでしょう。シンボルと
+再配置情報はすべて捨て去られます。メモリダンプは出力ファイルに
+コピーされる中で最も低位のセクションの仮想アドレスから始まります。
+.PP
+Sレコードや生のバイナリファイルを生成する場合は、
+.B -S
+を使ってデバッグ情報を含むセクションを削除するのが良いかもしれません。
+場合によっては
+.B -R
+が、バイナリファイルに必要無い情報を含むセクションを削除するのに有用でしょう。
+.PP
+.I infile
+と
+.I outfile
+は それぞれ入力と出力ファイルです。
+.IR outfile
+を指定しないと、
+.B objcopy
+は一時ファイルを作成してから そのファイル名を入力ファイル名に付けかえて
+しまいます。
+
+.SH オプション
+.TP
+.B \-I \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname
+入力ファイルのオブジェクト形式を推測しようとするかわりに
+.IR bfdname
+であるとして扱います。
+.TP
+.B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname
+オブジェクト形式として
+.IR bfdname
+を使って出力ファイルに書き込みます。
+.TP
+.B \-F \fIbfdname\fR, \fB\-\-target=\fIbfdname
+入出力両方のオブジェクト形式が
+.I bfdname
+であるとします; つまり、入力から出力へ無変換でデータを
+単純に転送するということです。
+.TP
+.B \-R \fIsectionname\fR, \fB\-\-remove-section=\fIsectionname
+指定されたセクションをファイルから取り除きます。このオプションは
+2回以上指定できます。このオプションを不適切に使うと出力ファイルが
+利用できない物になるので注意して下さい。
+.TP
+.B \-S\fR, \fB\-\-strip\-all
+再配置とシンボルの情報を入力ファイルからコピーしません。
+.TP
+.B \-g\fR, \fB\-\-strip\-debug
+デバッグシンボルを入力ファイルからコピーしません。
+.TP
+.B \-\-strip\-unneeded
+再配置処理に不要なシンボルをすべて取り除きます。
+.TP
+.B \-K \fIsymbolname\fR, \fB\-\-keep\-symbol=\fIsymbolname
+入力ファイルからシンボル \fIsymbolname\fP だけをコピーします。
+このオプションは 2回以上指定できます。
+.TP
+.B \-N \fIsymbolname\fR, \fB\-\-strip\-symbol=\fIsymbolname
+入力ファイルからシンボル \fIsymbolname\fP をコピーしません。
+このオプションは 2回以上指定できます。そして \fB\-K\fR 以外の
+strip のオプションと組み合わせられます。
+.TP
+.B \-x\fR, \fB \-\-discard\-all
+入力ファイルからグローバルでないシンボルをコピーしません。
+.TP
+.B \-X\fR, \fB\-\-discard\-locals
+コンパイラが生成したローカルシンボルをコピーしません。
+(それらは通常 "L" か "." で始まります。)
+.TP
+.B \-b \fIbyte\fR, \fB\-\-byte=\fIbyte
+入力ファイルの各 \fIbyte\fP番めのバイトのみを取り出します
+(ヘッダデータには影響しません)。\fIbyte\fP には
+0 から interleave-1 の範囲の値を指定できます。
+このオプションは ROM に書き込むためのファイルを作成するために有用です。
+典型的には srec の出力指定と共に使います。
+.TP
+.B \-i \fIinterleave\fR, \fB\-\-interleave=\fIinterleave
+各 \fIinterleave\fPバイト毎に 1バイトだけをコピーします。
+どれをコピーするかは \fB\-b\fP か \fB\-\-byte\fP オプションで
+選びます。デフォルトは 4です。
+interleave は \fB\-b\fP か \fB\-\-byte\fP のどちらも指定されていない
+場合は無視されます。
+.TP
+.B \-p\fR, \fB\-\-preserve\-dates
+出力ファイルのアクセスと変更時刻を入力ファイルに合わせます。
+.TP
+.B \-\-debugging
+可能であればデバッグ情報を変換します。
+特定のデバッグ情報しかサポートしておらず、変換処理は時間を
+要する可能性があるので、これはデフォルトではありません。
+.TP
+.B \-\-gap\-fill=\fIval
+セクション間のすきまを \fIval\fP で埋めます。
+これは低位アドレスのセクションのサイズを増やし、
+できた余分の空間を \fIval\fP で埋める事で実現しています。
+.TP
+.B \-\-pad\-to=\fIaddress
+仮想アドレス \fIaddress\fP まで出力ファイルに詰め物をします。
+これは最後のセクションのサイズを増やす事で行われます。
+できた余分の空間は \fB\-\-gap\-fill\fP で
+指定された値 (デフォルトは 0) で埋められます。
+.TP
+.B \fB\-\-set\-start=\fIval
+新しいファイルの開始アドレスを \fIval\fP に設定します。
+すべてのファイル形式が開始アドレスの設定をサポートしている
+わけではありません。
+.TP
+.B \fB\-\-adjust\-start=\fIincr
+開始アドレスを、\fIincr\fP を加算する事で調整します。
+すべてのファイル形式が開始アドレスの設定をサポートしている
+わけではありません。
+.TP
+.B \fB\-\-adjust\-vma=\fIincr
+開始番地およびすべてのセクションのアドレスを、\fIincr\fP を
+加算する事で調整します。いくつかのオブジェクト形式では
+セクションのアドレスを任意の値に変更する事は許されていません。
+これはセクションを再配置するのではない事に注意して下さい;
+もしプログラムがセクションが特定のアドレスにロードされる事を
+期待しており、そしてこのオプションがセクションを異なるアドレスに
+ロードするように使われた場合は、プログラムは正常に
+動作しないかもしれません。
+.TP
+.B \fB\-\-adjust\-section\-vma=\fIsection{=,+,-}val
+指定された \fIsection\fP のアドレスを設定または調整します。\fI=\fP が
+指定された場合は、セクションのアドレスは \fIval\fP に設定されます。
+そうでなければ \fIval\fP がセクションのアドレスに加算または減算されます。
+上の \fB\-\-adjust\-vma\fP に書かれているコメントも参照して下さい。
+入力ファイルに \fIsection\fP が存在しない場合は、
+\fB\-\-no\-adjust\-warnings\fP が指定されていなければ警告が出力されます。
+.TP
+.B \fB\-\-adjust\-warnings
+\fB\-\-adjust\-section\-vma\fP が指定され、
+指定されたセクションが存在しないと警告が出力されます。
+これはデフォルトです。
+.TP
+.B \fB\-\-no\-adjust\-warnings
+\fB\-\-adjust\-section\-vma\fP が指定されて、指定された
+セクションが存在しなくても警告を出力しません。
+.TP
+.B \fB\-\-set\-section\-flags=\fIsection=flags
+指定されたセクションのフラグを設定します。引数 \fIflags\fP は
+フラグ名をカンマで区切った文字列です。認識するフラグ名は
+\fIalloc\fP、\fIload\fP、\fIreadonly\fP、\fIcode\fP、\fIdata\fP、
+\fIrom\fP です。すべてのフラグがすべてのオブジェクトファイル形式で
+意味を持つとは限りません。
+.TP
+.B \fB\-\-add\-section=\fIsectionname=filename
+\fIsectionname\fR で指定された名前の新しいセクションをファイルの
+コピー中に付け加えます。新しいセクションの内容はファイル
+\fIfilename\fR から取り込まれます。セクションのサイズはファイルの
+サイズになります。このオプションは任意の名前を持つセクションを
+サポートできるファイル形式でのみ機能します。
+.TP
+.B \-\-change\-leading\-char
+いくつかのオブジェクトファイル形式でシンボルの最初に特殊文字が
+使われています。もっとも一般的なのはアンダースコアで、しばしば
+コンパイラが各シンボルの前に付け加えます。
+このオプションは
+.B objcopy
+に、オブジェクトファイル形式を変換する時に各シンボルの始まりの
+文字を変更するよう指示します。
+変換前後のオブジェクトファイル形式がシンボルの始まりに同じ文字を
+使っている場合は、このオプションは何もしません。そうでなければ、
+このオプションで文字を付け加える、または文字を削除する、または
+文字を変更する事が、適切に行われます。
+.TP
+.B \-\-remove\-leading\-char
+グローバルシンボルの最初の文字が、オブジェクトファイル形式で使われる
+シンボルの最初に付加される特殊文字だった場合は、その文字を取り除きます。
+シンボルに前置される最も一般的な文字はアンダースコアです。
+このオプションは前置されているアンダースコアをすべての
+グローバルシンボルから取り除きます。これはシンボル名の取り決めが
+異なるファイル形式のファイルを一緒にリンクしたい場合に有用です。
+これは \fB\-\-change\-leading\-char\fP とは異なります。
+なぜならこのオプションでは適切であれば、
+出力のオブジェクトファイル形式とは関係なく
+常にシンボル名を変更してしまうからです。
+.TP
+.B \-\-weaken
+ファイルのすべてのグローバルシンボルを weak に変更します。
+.TP
+.B \-v\fR, \fB\-\-verbose
+饒舌になります: 変更されたすべてのオブジェクトファイルをリストします。
+アーカイブの場合は "\fBobjcopy \-V\fR" でアーカイブのメンバがすべて
+リストされます。
+.TP
+.B \-V\fR, \fB\-\-version
+.B objcopy
+のバージョン番号を表示して終了します。
+.TP
+.B \-\-help
+.B objcopy
+のオプションのサマリを表示して終了します。
+.SH "関連項目"
+.B
+info\c
+\& の
+.RB "`\|" binutils "\|'"
+の項;
+.I
+The GNU Binary Utilities\c
+\&, Roland H. Pesch (June 1993)
+
+.SH COPYING
+Copyright (c) 1993, 94, 95, 96, 1997 Free Software Foundation, Inc.
+.PP
+Permission is granted to make and distribute verbatim copies of
+this manual provided the copyright notice and this permission notice
+are preserved on all copies.
+.PP
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+.PP
+Permission is granted to copy and distribute translations of this
+manual into another language, under the above conditions for modified
+versions, except that this permission notice may be included in
+translations approved by the Free Software Foundation instead of in
+the original English.
+
+.SH 日本語訳
+野首 寛高(hnokubi@yyy.or.jp): FreeBSD 用に翻訳