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
アセンブラで用いられる文法や擬似命令に関しては
info の
as エントリ
(またはマニュアルである
Using as: The GNU Assembler )
を参照のこと。
as はもともと GNU C
コンパイラ
gcc
の出力をリンカ
ld
で利用で
きるようにアセンブルするためのものである。しかし我々は
as
がネイティブなアセンブラと同様な動作をすることを目指してきた。ただしこ
れは
as
の文法が常に他のアセンブラのものと同じであることを保証するものではない。
例えば 680x0
アセンブリ言語の文法には、
as
とは互換性のないものも存在する。
as
は実行のたびにただ一つのプログラムをアセンブルする。プログラムは一つ以
上のファイルから構成される
(標準入力もファイルである)。
ファイル名が指定されなければ
as は標準入力
(通常は端末)
をアセンブルしようとする。
ctl-D
とタイプすれば、アセンブルするプログラムの終わりを
as
に伝えることができる。標準入力ファイルを用いることをコマンドラインで明
示したい場合には
--
を用いる。
as
は警告やエラーのメッセージを標準エラー出力
(通常は端末)
に書き出す。た だし
as
がコンパイラによって自動的に実行された場合にはこの限りで
はない。警告メッセージは「プログラムに問題
(flaw)
があり、アセンブルを
続けるためにこのような仮定をした」ことを報告するものであり、エラーメッ
セージは「アセンブルを停止しなければならない重大な障害が存在した」こと
を報告するものである。
- -a
- アセンブリリストを表示する。多くの副オプションがある。
d
デバッグ命令を除く。
h
は高位レベルのソースコードを含める。これはソースファイルにアクセスでき、
またコードが -g
でコンパイルされた場合にのみ有効となる。
l
はアセンブリリストを含める。
n
はフォーム処理を含めない。
s
はシンボルのリストを含める
= file
はリストのファイル名を設定する。
これは最後の副オプションでなければならない。
デフォルトの副オプションは
hls である。
- -D
- 他のアセンブラとの互換性のためだけに用意されたオプションであり、
as
では効果を持たない。
- --defsym SYM=VALUE
- 入力ファイルをアセンブルする前にシンボル
SYM の値を VALUE
に定義する。 VALUE
は整定数でなければならない。
C と同様に 0x
が前置されれば 16 進
数として扱われ、 0
が前置されれば 8
進数として扱われる。
- -f
- 高速 (fast)
オプション。プリプロセスを行わない
(ソースがコンパイラ出力
であるとみなす)。
-
-I path
-
.include
命令における探索リストに
path を追加する。
- --gstabs
- アセンブリ各行に、スタブデバッグ情報
(stabs debugging information)
を生成する。デバッガがこの情報を扱える場合、
アセンブリコードのデバッグに役立つかもしれない。
- -K
- long displacement のための
difference table
が変更されたときに警告メッセージを発する。
- -L
- シンボルテーブルにローカルシンボル
( L
で始まるシンボル)
を保存する。
- -M, --mri
- MRI
互換モードでアセンブルする。
-
-o objfile
-
as
が出力するオブジェクトファイルの名前をつける。
- -R
- データセクションをテキストセクションと一緒にする。
- --traditional-format
- 可能ならネイティブのアセンブラと同じ書式を用いる。
- -v
-
as
のバージョンを表示する。
- -W
- 警告メッセージを抑制する。
-
-- | files...
- アセンブルするソースファイルを指定する
('--' は標準入力)。
-
-Avar
- (Intel 960
用オプション) 960
アーキテクチャのどのタイプをターゲットとするかを指定する。
- -b
- (Intel 960
用オプション) 分岐
(branch)
に関する統計情報を取得するコードを追加する。
- -no-relax
- (Intel 960
用オプション) long displacement
のために比較-分岐命令を変更しない。必要な場合はエラー
とする。
- -l
- (Motorola 68000
用オプション)
未定義シンボルへのリファレンスを
2 ワードではなく 1
ワードに短縮する。
-
-mc68000|-mc68010|-mc68020
- (Motorola 68000
用オプション) 68000
ファミリのどのプロセッサをターゲットとするかを指定する
(デフォル トは 68020)。
オプションの指定順序は任意である。またファイル名の前でも後でも間でもよ
い。一方ファイル名の順序は重要な意味を持つ。
--
のようにハイフン二つだけを指定した場合は、
as
がアセンブルするファイルのひとつとして標準入力を明示的に指定したことに
なる。
`
--' を除き、ハイフン
(`
-')
で始まる全てのコマンドラ
イン引数はオプショ
ンである。それぞれのオプションは
as
の振る舞いを変更する。またあ
るオプションによって他のオプションが影響されることはない。オプションは
`
-'
に一つまたは二つの文字が付いたものである。大文字と小文字は
別の意味を持つ。全てのオプションは指定してもしなくても良い。
`
-o'
オプションの後にはファイル名を一つだけ指定する。ファイル名
はオプション文字の直後に指定しても良い
(古いアセンブラとの互換のため)
し、次のコマンド引数として指定しても良い
(GNU 流)。
以下の二つのコマンドラインは等価である:
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)
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. ?