as(1)

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

書式
as [-a[dhlns] [=file ]] [-D] [--defsym SYM=VAL] [-f] [--gstabs] [-I path ] [-K] [-L] [-M | --mri] [-o objfile ] [-R] [--traditional-format] [-v] [-w] [-- | files ...] i960 だけにあるオプション:
[-ACA|-ACA_A|-ACB |-ACC|-AKA|-AKB |-AKC|-AMC] [-b] [-no-relax] 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 の起動 1 回ごとに、ちょうどひとつのソースプログラムだけをアセンブルします。 ソースプログラムはひとつ以上のファイルから構成されます。 (標準入力もファイルひとつとみなします。) もし as にファイル名が指定されなければ、ひとつの入力ファイルが as の標準入力 (ふつうは端末) から読み出されます。ctl-D をタイプすることで、これ以上アセンブルするプログラムが存在しないこと を as に通知します。 コマンドライン上で明示的に標準入力を指定する必要のある時は、`-- ' を使ってください。 as は、警告およびエラーメッセージを標準エラー出力 (通常は端末) へ出力します。as が コンパイラによって自動起動された場合は、この限りではありません。 警告とは、欠陥のあるプログラムのアセンブルを続行するために as が仮定した内容を報告したものです。 エラーは、アセンブルを続行できない重大な問題を表します。

オプション

-a  アセンブル時のリスト出力を行ないます。多様なサブオプションがあります。 d はデバッグ用ディレクティブを削除します。 h は高レベルなソースコードを含めます。 ソースファイルが見付かり、そのコードが -g 付きでコンパイルされた場合のみ利用可能です。 l はアセンブリのリスト出力を含めます。 n はフォーム処理 (forms processing) を削除します。 s シンボルのリスト出力を含めます。 = file はリスト出力を行うファイル名を設定します。 これは、最後のサブオプションである必要があります。 デフォルトのサブオプションは hls です。

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

--defsym SYM=VALUE
    入力ファイルをアセンブルする前に、シンボル SYM を LAVUE であると定義します。 VALUE は定数の整数である必要があります。 C と同様、先行する 0x は 16 進数値を示し、先行する 0 は 8 進数値を示します。

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

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

--gstabs
    各アセンブリの行に対し、スタブデバッグ情報 (stabs debugging information) を生成します。 デバッガが扱える場合、アセンブリコードのデバッグに役立つかもしれません。

-K  ロングディスプレースメントのために差分表が変更された場合に、警告を発行します。

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

-M, --mri
    MRI 互換モードでアセンブルします。

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

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

--traditional-format
    可能であるならば、機種固有のアセンブラと同じ書式を使用します。

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

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

--fatal-warnings
    警告を、致命的なものとして扱います。

--warn
    警告を、単に警告として扱います。

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

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

-b  (Intel 960 用) 条件分岐の統計情報を収集するコードを追加します。

-no-relax
    (Intel 960 用。) ロングディスプレースメントの「比較-分岐」という命令列に対して 変更を加えません。 場合によってはエラーが発生します。

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

-mc68000|-mc68010|-mc68020
    (Motorola 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, 2000 Free Software Foundation, Inc.

This document is distributed under the terms of the GNU Free Documentation License, version 1.1. That license is described in the sources for this manual page, but it is not displayed here in order to make this manual more consise. Copies of this license can also be obtained from: http://www.gnu.org/copyleft/.