as(1)

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

書式
as [-a|-al|-as ] [-D] [-f] [-I path ] [-k] [-L] [-o objfile ] [-R] [-v] [-w] [-- | files ...] i960 だけにあるオプション:
[-ACA|-ACA_A|-ACB |-ACC|-AKA|-AKB |-AKC|-AMC] [-b] [-norelax] m680x0 だけにあるオプション:
[-l] [-mc68000|-mc68010|-mc68020]

解説
GNU as は、数あるアセンブラのひとつです。 もしあるアーキテクチャで GNU アセンブラを使う (もしくは、使った ことがある) ならば、他のアーキテクチャで使う時も同様の環境となり ます。それぞれのバージョンは、オブジェクトファイルフォーマットや ほとんどのアセンブラディレクティブ (しばしば、 pseudo-ops と呼ばれる)と、アセンブラシンタクスを含む、多くの部分で他のバージョンと 共通です。 GNU as のシンタクスや pseudo-ops に関する情報については、 info (もしくは、マニュアル Using as: The GNU Assembler) の `as ' の項を参照してください。 as の主な目的は、GNU C コンパイラ gcc の出力をリンカ ld で使用できるようアセンブルすることです。にもかかわらず、 ネイティブのアセンブラでアセンブルできるものはすべて正常にアセンブル できるように as を作成しました。 このことは、as が同じアーキテクチャの他のアセンブラと同じシンタクスをいつも使う とは限らないことを意味します。たとえば、680x0 のアセンブラ言語 のシンタクスには互換性のないバージョンが存在することが知られてい ます。 as を起動すると、必ずひとつのソースプログラムをアセンブルします。 ソースプログラムはひとつ以上のファイルから構成されます。 (標準入力もファイルとみなします。) もし as にファイル名が指定されなければ、ひとつの入力ファイルが as の標準入力 (ふつうは端末) から読み出されます。ctl-D をタイプすることで、アセンブルするプログラムがなくなったこと を as に通知します。 コマンドライン上で明示的に標準入力を指定する必要のある時は、`-- ' を使ってください。 as は、警告およびエラーメッセージを標準エラー出力 (通常は端末) へ出力します。as が コンパイラによって自動起動された時は、この限りではありません。 警告は、不備な点のあったプログラムをアセンブルできるように as がたてた仮定を報告するものです。エラーは重大な問題を報告し、 アセンブルを中止します。

オプション

-a|-al|-as
    アセンブル時のリスト出力を行います。`-al 'はリスト出力のみ、`-as 'はシンボル出力のみ、 `-a 'は両方の出力を行います。

-D  このオプションは、他のアセンブラ呼び出しとの互換のために用意され たものであり、 as では何の効果もありません。

-f  ``高速 (fast)''--プリプロセシングを行いません (ソースがコンパイラの出力と みなします)。

-I path
    path を .include ディレクティブの検索リストに追加します。

-k  gcc -fpic によって作成された、位置独立なコードを処理します。

-L  `L ' から始まるローカルシンボルを (シンボルテーブル内に) 保持します。

-o objfile
    as が出力するオブジェクトファイル名を指定します。

-R  データセクションをテキストセクション内に押し込みます。

-v  as のバージョンを表示します。

-W  警告メッセージの出力を抑制します。

-- | files...
    アセンブル対象の、ソースファイルまたは標準入力 (--) を指定します。

-Avar
    (インテル 960 用。) 960 アーキテクチャのどのプロセッサがターゲットか指定します。

-b  (インテル 960 用。) 分岐が得た統計情報を収集するコードを追加します。

-norelax
    (インテル 960 用。) compare-and-branch 命令を long 指定に変更しません。場合によっては エラーが発生します。

-l  (モトローラ 68000 用。)
    2 ワードではなく、1 ワードの短い参照を未定義シンボルに適用します。

-mc68000|-mc68010|-mc68020
    (モトローラ 68000用。)
    68000 ファミリのどのプロセッサがターゲットかを指定します。(デフォルトは 68020)

オプションの記述順は自由であり、ファイル名の前や後、ファイル名の 間にも記述することができます。ファイル名の記述順は重要です。 `-- ' (2つのハイフン) をファイル名に指定することで、as がアセンブルするファイルのひとつとして標準入力を明示的に指定 します。 `-- ' を除く、ハイフン (`- ') から始まるコマンドライン引数は、オプション指定です。それぞれの オプションは、as の振舞いを変更します。オプションは、他のオプションの動作を変えません。 オプションは `- ' に続けてひとつ以上の英文字を書いて指定します; 英文字の大文字 小文字の区別は重要です。すべてのオプションは省略可能です。 `-o ' オプションに続けてひとつのファイル名を指定します。ファイル名 はオプション文字の直後に記述する (古いアセンブラとの互換) か、 または次のコマンド引数 (GNU 標準) のいずれかで指定することができます。 次の2つのコマンドラインは等価です:
as -o my-object-file.o mumble.s
as -omy-object-file.o mumble.s

関連項目
info内の `as' の項 ; Using as: The GNU Assembler; gcc(1), ld(1).

COPYING
Copyright (c) 1991, 1992 Free Software Foundation, Inc.

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.

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.

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.