path: root/ja_JP.eucJP/man/man1/as.1

.\" Copyright (c) 1991, 1992, 1996, 1997, 1998 Free Software Foundation
.\" See section COPYING for conditions for redistribution
.\" %FreeBSD: src/contrib/binutils/gas/doc/as.1,v 1.2.6.2 2000/07/07 05:33:59 obrien Exp %
.TH as 1 "29 March 1996" "cygnus support" "GNU Development Tools"
.\" jpman %Id: as.1,v 1.3 1997/10/11 07:37:12 horikawa Stab %

.SH 名称
GNU as \- ポータブル GNU アセンブラ

.SH 書式
.na
.B as
.RB "[\|" \-a "[\|" dhlns "\|]" \c
\&[\|\=\c
.I file\c
\&\|]\|]
.RB "[\|" \-D "\|]"
.RB "[\|" \-\-defsym\ SYM=VAL "\|]"
.RB "[\|" \-f "\|]"
.RB "[\|" \-\-gstabs "\|]"
.RB "[\|" \-I
.I path\c
\&\|]
.RB "[\|" \-K "\|]"
.RB "[\|" \-L "\|]"
.RB "[\|" \-M\ |\ \-\-mri "\|]"
.RB "[\|" \-o 
.I objfile\c
\&\|]
.RB "[\|" \-R "\|]"
.RB "[\|" \-\-traditional\-format "\|]"
.RB "[\|" \-v "\|]"
.RB "[\|" \-w "\|]"
.RB "[\|" \-\^\- "\ |\ " \c
.I files\c
\&\|.\|.\|.\|]

.I i960 だけにあるオプション:
.br
.RB "[\|" \-ACA "\||\|" \-ACA_A "\||\|" \-ACB\c
.RB "\||\|" \-ACC "\||\|" \-AKA "\||\|" \-AKB\c
.RB "\||\|" \-AKC "\||\|" \-AMC "\|]"
.RB "[\|" \-b "\|]"
.RB "[\|" \-no-relax "\|]"

.I m680x0 だけにあるオプション:
.br
.RB "[\|" \-l "\|]"
.RB "[\|" \-mc68000 "\||\|" \-mc68010 "\||\|" \-mc68020 "\|]"
.ad b

.SH 解説
GNU \c
.B as\c
\& とは、実は一連のアセンブラのことです。
もしあるアーキテクチャで GNU アセンブラを使う (もしくは、使った
ことがある) ならば、他のアーキテクチャで使う時もかなり似た環境となり
ます。それぞれのバージョンは他のバージョンと共通の部分が多くあります。
例えば、オブジェクトファイルフォーマットや
ほとんどのアセンブラディレクティブ (
\c
.I 疑似命令(pseudo-ops)
とも呼ばれます)\c
\& 、アセンブラシンタクスなどです。

GNU \c
.B as\c
のシンタクスや疑似命令(pseudo-ops)に関する情報については、
.B info \c
(もしくは、マニュアル \c
.I
.I
Using as: The GNU Assembler\c
\&)
の
\& `\|\c
.B as\c
\|' の項を参照してください。

\c
.B as\c
\& が作られた第一の目的は、GNU C コンパイラ \c
.B gcc\c
\& の出力をリンカ
.B ld\c
\& で使用できるようアセンブルすることです。
確かに、
.B as\c
\& が、
ネイティブアセンブラがアセンブルできるものはすべて
正しくアセンブルできるようにしようとしてきました。
このことは、\c
.B as\c
\& の用いるシンタクスが、
同一アーキテクチャの他のアセンブラと同じである、
ということを意味するものではありません。
たとえば、680x0 のアセンブラ言語
のシンタクスには互換性のないバージョンが存在することが知られてい
ます。

.B as\c
\& の起動 1 回ごとに、ちょうどひとつのソースプログラムだけをアセンブルします。
ソースプログラムはひとつ以上のファイルから構成されます。
(標準入力もファイルひとつとみなします。)

もし \c
.B as\c
\& にファイル名が指定されなければ、ひとつの入力ファイルが \c
.B as\c
\& の標準入力 (ふつうは端末) から読み出されます。\c
.B ctl-D\c
\& をタイプすることで、これ以上アセンブルするプログラムが存在しないこと
を \c
.B as\c
\& に通知します。
コマンドライン上で明示的に標準入力を指定する必要のある時は、`\|\c
.B \-\^\-\c
\|' を使ってください。

.B as\c
\& は、警告およびエラーメッセージを標準エラー出力 (通常は端末) 
へ出力します。\c
.B as\c
\& が
コンパイラによって自動起動された場合は、この限りではありません。
警告とは、欠陥のあるプログラムのアセンブルを続行するために \c
.B as\c
\& が仮定した内容を報告したものです。
エラーは、アセンブルを続行できない重大な問題を表します。

.SH オプション
.TP
.BR \-a
アセンブル時のリスト出力を行ないます。多様なサブオプションがあります。
.B d
はデバッグ用ディレクティブを削除します。
.B h
は高レベルなソースコードを含めます。
ソースファイルが見付かり、そのコードが
.B \-g
付きでコンパイルされた場合のみ利用可能です。
.B l
はアセンブリのリスト出力を含めます。
.B n
はフォーム処理 (forms processing) を削除します。
.B s
シンボルのリスト出力を含めます。
.B =
.I file
はリスト出力を行うファイル名を設定します。
これは、最後のサブオプションである必要があります。
デフォルトのサブオプションは
.B hls
です。
.TP
.B \-D
このオプションは、他のアセンブラ呼び出しとの互換のために用意され
たものであり、 \c
.B as\c
\& では何の効果もありません。
.TP
.B \-\-defsym SYM=VALUE
入力ファイルをアセンブルする前に、シンボル SYM を LAVUE であると定義します。
VALUE は定数の整数である必要があります。
C と同様、先行する 0x は 16 進数値を示し、先行する 0 は 8 進数値を示します。
.TP
.B \-f
``高速 (fast)''オプションです--プリプロセシングを行ないません (ソースはコンパ
イラの出力したものとみなします)。
.TP
.BI "\-I\ " path
.I path
を
.B .include
ディレクティブの検索リストに追加します。
.TP
.B \-\-gstabs
各アセンブリの行に対し、スタブデバッグ情報 (stabs debugging information)
を生成します。
デバッガが扱える場合、アセンブリコードのデバッグに役立つかもしれません。
.TP
.B \-K
ロングディスプレースメントのために差分表が変更された場合に、警告を発行します。
.TP
.B \-L
`\|\c
.B L\c
\|' から始まるローカルシンボルを (シンボルテーブル内に) 保持します。
.TP
.B \-M, \-\-mri
MRI 互換モードでアセンブルします。
.TP
.BI "\-o\ " objfile
.B as
が出力するオブジェクトファイル名を指定します。
.TP
.B \-R
データセクションをテキストセクション内に押し込みます。
.TP
.B \-\-traditional\-format
可能であるならば、機種固有のアセンブラと同じ書式を使用します。
.TP
.B \-v
.B as\c
\& のバージョンを表示します。
.TP
.B \-W, \-\-no-warn
警告メッセージの出力を抑制します。
.TP
.B \-\-fatal\-warnings
警告を、致命的なものとして扱います。
.TP
.B \-\-warn
警告を、単に警告として扱います。
.TP
.IR "\-\^\-" "\ |\ " "files\|.\|.\|."
アセンブル対象のソースファイルまたは標準入力 (\c
.BR "\-\^\-" ")\c"
を指定します。
.TP
.BI \-A var
.I
(Intel 960 用。)
960 アーキテクチャのどのプロセッサがターゲットかを指定します。
.TP
.B \-b
.I
(Intel 960 用)
条件分岐の統計情報を収集するコードを追加します。
.TP
.B \-no-relax
.I
(Intel 960 用。)
ロングディスプレースメントの「比較-分岐」という命令列に対して
変更を加えません。
場合によってはエラーが発生します。
.TP
.B \-l
.I
(Motorola 68000 用)。
.br
2 ワードではなく、1 ワードの短い参照を未定義シンボルに適用します。
.TP
.BR "\-mc68000" "\||\|" "\-mc68010" "\||\|" "\-mc68020"
.I
(Motorola 68000用)。
.br
68000 ファミリのどのプロセッサがターゲットかを指定します
(デフォルトは 68020)。

.PP
オプションの記述順は自由であり、ファイル名の前や後、ファイル名の
間にも記述することができます。ファイル名の記述順は重要な意味を持ちます。

`\|\c
.B \-\^\-\c
\|' (2つのハイフン) をファイル名に指定することで、\c
.B as\c
\& がアセンブルするファイルのひとつとして標準入力を明示的に指定
できます。

ハイフン
(`\|\c
.B \-\c
\|') から始まるコマンドライン引数は、
`\|\c
.B \-\^\-\c
\|' を除き、すべてオプションです。それぞ
れのオプションは、\c
.B as\c
\&の振舞いを変更します。あるオプションが他のオプションの動作を変え
ることはありません。
オプションは `\|\c
.B \-\c
\|' に続けてひとつ以上の文字を書いて指定します; 英文字の大文字
小文字の区別は重要です。すべてのオプションは省略可能です。

`\|\c
.B \-o\c
\|' オプションの後には、ファイル名をひとつだけ指定します。ファイル名
は、オプション文字の直後に記述する (古いアセンブラとの互換) 形式、または
次のコマンド引数 (GNU 標準) として記述する形式の
いずれでも指定することができます。

つまり次の2つのコマンドラインは等価です:
.br
.B
as\ \ \-o\ \ my\-object\-file.o\ \ mumble.s
.br
.B
as\ \ \-omy\-object\-file.o\ \ mumble.s

.SH "関連項目"
.B
info\c
内の
.RB "`\|" as "\|'"
の項
.B
\&; 
.I
Using as: The GNU Assembler\c
\&;
.BR gcc "(" 1 "),"
.BR ld "(" 1 ")."

.SH COPYING
Copyright (c) 1991, 1992 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.