Operating Details

操作の詳細

HI-TECH Cは簡単に使えるようにデザインされています。単体のコマンドでプログラムをコンパイル、アセンブル、リンクできます。Cコマンドの書式は以下の通りです。

C [ options ] files [ libraries ]

optionsはゼロもしくはそれ以上のオプションで、どれもダッシュ('-')と一文字のキーレターと、（必要に応じて）キーレターからスペースなしで続く引数で構成されます。filesはは一つ、もしくはそれ以上のC言語のソースファイル、アセンブラのソースファイル、もしくはオブジェクトファイルです。librariesはゼロ、もしくはそれ以上のライブラリ名、もしくはlibname.libに展開される、-lnameで省略された名前です。

Cコマンドは特定のオプションで定義されたように、与えられたCファイルをコンパイルし、それらをアセンブルして、要求されることなくオブジェクトコードにします。そうでなければ指定されたアセンブラソースファイルをアセンブルし、アセンブルの結果を他のオブジェクトや指定されたライブラリとリンクします？？。

Cコマンドが引数無しで起動されると、入力のためにコマンドラインにプロンプトを表示します。このコマンドラインはバックスラッシュ('\')を行末でタイプすることで拡張できます。コマンドの標準入力がファイルから(例えばC < afileのように)なされた場合、コマンドラインはそのファイルから読み込みます。ファイルの中では一行以上が与えられるかもしれませんが、どの行も最後の行にはバックスラッシュが付きます。このメカニズムはMS-DOSバッチファイルでは働かないことに注意してください。つまり、Cコマンド用のコマンドファイルは別のファイルでなければいけません。MS-DOSは長いコマンドラインやバッチファイルの中から標準入力するメカニズムを持っています。

Cコマンドで認識されるオプションは以下の通りです。

-S

アセンブラ出力としてC言語ファイルのコンパイル結果を残します。Cソースコードはアセンブラコードの間に点在するコメントになります。

-C

全てのコンパイルとアセンブルの結果をオブジェクトファイルのままにします。リンカは起動させないでください。これによりリンカを個別に、もしくはもしくはもっと後のステージでCコマンドを介して起動させることができます。

-CR

クロスリファレンスリストを生成します。-CRは生の参照情報をテンポラリファイルに残し、ユーザーにCREFを明確に実行させます。生の情報を特定のファイル入れるため、例えば-CRFRED.CRFのようにファイル名を与えると、この場合ではFRED.CRF.がCREFに処理されます？？

-CPM

-O

オプティマイザをすべてのコンパイルコードに対して起動します。これはアセンブラに対してjump最適化も要求します。

-OOUTFILE

実行ファイルが作成されるように名前を指定します。デフォルトの実行ファイル名は、コンパイラに指定された最初のソース、もしくはオブジェクトファイルから派生します。このオプションはデフォルトを上書きできます。もしドット('.')が、与えられたファイル名にない場合、拡張子は特定のオペレーティングシステムに応じて付加されます。

クロスコンパイラでは、特定の出力フォーマットを指定する方法を提供する方法となります。つまり、出力ファイルPROG.BINはバイナリファイルを、一方で、PROG.HEXは16進数のファイルを生成させることになります。

-V

冗長化します。コンパイルのどのステップも、実行しているままにechoします。

-I

#include用に検索対象のファイルを追加するプレフィックス指定をします。CP/Mではデフォルトのプレフィックスは0:A:(ユーザー番号0、ディスクドライブA)です。

-D

シンボルをプリプロセッサに定義します。例えば-DCPMはシンボルCPMは#define CPM 1を介して定義します？？

-U

事前定義されているシンボルの定義を解除します。-Dの補足です。

-F

リンカにデバッガと使用するためのシンボルファイルを生成するように要求します。

-R

Z80 CP/Mコンパイラ用にだけ、このオプションはリンク時に？？コマンドラインI/Oリダイレクションとファイル名のワイルドカード拡張をします？？リダイレクションの書式に関しては付録5の_getargs()を参照してください。

-X

コンパイル、アセンブル、リンクされたファイルからローカルシンボルファイルを切り出します。グローバルシンボルのみが残ります。

-M

リンクマップを生成するようリンカに要求します。

-A

このオプションはZ80専用で、プログラムの実行時に自分自身をTPA(Transient Program Area)のトップに再配置するプログラムを生成するよう、コンパイラに命令します。このオプションは、それの後に他のプログラムが実行できるようなプログラムを書くことを許容します。このようにして書かれたプログラムは、自分自身を、守るためにbdosのロケーション6のアドレスに自動的にリセットしません。これはプログラム自身がやらなければなりません。

クロスコンパイラではリンカに対して、コンパイルされるプログラムがどこのアドレスでリンクされるかを指定する方法があります。そのオプションが -AROMADR,RAMADR,RAMSIZEです。ROMADRはシステムのROMのアドレスで、実行可能なデータや初期化データが置かれます。RAMADRはRAMの開始アドレスで、BSS PSECTなど、初期化されないデータが置かれます。RAMSIZEはプログラムが取ることのできるRAMのサイズで、スタックのトップがセットされます。

-B

-E

-W

このオプションはワーニングレベルを設定します。つまり、コンパイラがルールにのっとっているか、型の変換は怪しくないか、などについてどれくらい几帳面になるか決定します？？-W0は全てのメッセージを許容します(デフォルト)、-W1は"Func() declared implicit int"のメッセージを抑制します。-W3はもともとは、より厳格でない他のコンパイラで書かれたコードをコンパイルするときにお勧めです。-W9は全てのワーニングメッセージを抑制します。

-H

このオプションははデバッガと共に使うためのシンボルファイルを生成します。シンボルファイルのフォーマットはどこかに書かれるでしょう。シンボルファイル名のデフォルトはl.symです。違う名前は -Hsymfile.abcのようなオプションで指定されます。

-G

-Gも-Hのようにシンボルファイルを生成しますが、ソースレベルデバッガ用に行とファイル番号情報を含むものです。-Hのように、ファイル名は指定できます。-Oと共に連結して使われた場合、デバッガが混乱しないように、部分的な最適化が実行されます。

-P

-Z

-1

-2

-11

-6301

Cコマンドのサンプルをいくつか挙げます。

c prog.c

c -mlink.map prog.c x.obj -lx

c -S prog.c

c -O -C -CRprog.crf prog.c prog2.c

上記の例では、大文字、小文字は強調されています？？コンピューター上では大文字小文字の区別はされませんが、名前を指定する引数、例えば-Dでは本質的に大文字小文字の区別をします。

上記の例を順に取り上げます。最初の例はCソースファイルのprog.cをコンパイルし、標準Cライブラリとリンクします。二番目の例はprog.cファイルをコンパイルし、オブジェクトファイルx.objとライブラリlibx.libをリンクします。リンクマップはlink.mapに書き出されます。

三番目の例はprog.cをコンパイルし、アセンブラ出力をprog.asに残します。これはファイルをアセンブルせず、またリンカも呼び出しません。次の例はprog.cとprog2.cの両方をコンパイルし、両方でオプティマイザを呼び出しますが、リンクはしません。クロスリファレンスリストはprog.crfに残ります。

一つ以上のCもしくはアセンブラのソースファイルがCコマンドに与えられた場合、それぞれのファイル名が処理されている順にコンソールに表示されます。もし、ソースのコンパイル中やアセンブル中に、致命的なエラーが起きた場合は、その後の処理は行われますが、リンカは起動されません。

Cコマンドが自動的に行うよりもむしろユーザーによって発行される他のコマンドは以下の通りです。

ZAS

Z80アセンブラ

LINK

リンカ

LIBR

ライブラリアン

OBJTOHEX

オブジェクトから16進データへのコンバータ

CREF

クロスリファレンスジェネレータ

一般的にこれらのコマンドはCコマンドと同種のコマンドラインを受け付けます。つまり、ゼロ、もしくはそれ以上のオプション（'-'が先につく）をとり、そのあとに一つかそれ以上のファイル引数が付きます。リンカやライブラリアンが引数とともに起動された時、コマンドラインのプロンプトを表示します。これにより、128バイトを超えるコマンドラインの入力が可能です。入力はリダイレクションによりファイルからも可能です（ライブラリ関数一覧の_getargs()を参照）。

Cコマンドについては上記を参照してください。このコマンドの詳細はこの後のマニュアルでも記述されています。