GTAGS(1)

名称
gtags - GTAGS, GRTAGS, GSYMS ファイルを作成する

書式
gtags [-i] [-o] [-v] [dbpath]

解説
gtags は global(1) で用いる GTAGS, GRTAGS, GSYMS ファイルを作成します。 gtags はサブディレクトリをたどり、ソースファイルを読み、シンボルの位置を把握して その情報をタグファイルに保存します。 C や yacc やアセンブラのソースファイルがサポートされています。 このコマンドはソースツリーのルートで実行する必要があります。

ソースディレクトリが CDROM のような読み込み専用デバイスの場合、 タグファイルを作成するディレクトリを dbpath に指定します。

-i  タグファイルが最後に更新されてから更新されたファイルについてのみ 検査することにより、 タグファイルをインクリメンタルに更新します

-o  GSYMS ファイルの作成を抑止します。 global(1) で -s オプションを使用しない場合に使用してください。

-v  冗長モード。

関連ファイル
GTAGS
    関数定義に関するタグファイル。
GRTAGS
    関数参照に関するタグファイル。
GSYMS
    他のシンボルに関するタグファイル。

診断
gtags はエラーが発生すると非 0 を、そうでなければ 0 を返します。

関連項目
btreeop(1), global(1), htags(1), vi(1).

バグ
GTAGS, GRTAGS, GSYMS はとても大きくなります。 実行前にディスクの空き容量をチェックしてください。
アセンブラのサポートは完璧には程遠く、ソースファイルから ENTRY() と ALTENTRY() を抜き出すだけです。 FreeBSD と Linux のカーネルソースでどうにか大丈夫なだけでしょう。
タグファイルに関する並行制御はしていません。

作者
Shigio Yamaguchi (shigio@wafu.netgate.net)

歴史
gtags コマンドは FreeBSD 2.2.2 で登場しました。