SBQUERY(1)

名前
sbquery - ソースブラウザへのコマンド行インタフェース

形式
sbquery [ -break_lock ] [ -files_only ] [ -filter ]
[ -focus ] [ -help ] [ -help_filter [ language ]]
[ -help_focus ] [ -literal ] [ -max_memory size ]
[ -no_case ] [ -no_secondaries ] [ -no_source ]
[ -no_update ] [ -o file ]
[ -pattern symbol ] [ -reg_expr ] [ -sh_pattern ]
[ -show_db_dirs ] [ -symbols_only ]
[ -version | -V ] symbol

使用条件
ANSI C、C++、Sun FORTRAN、アセンブラで使用できます。

機能説明
sbquery は、ソースブラウザのコマンド行インタフェースで、ソースレベルの コードを表示します。

ソースブラウザのデータベースを生成するには、コンパイラのコマンド行に -xsb や -sb といった適切なブラウザオプションを指定します。

コマンド行から問い合わせをするには、 sbquery コマンドの後に必要なコマンド行オプションとその引数を入力し、 その後に探したいシンボルを入力します。 sbquery は一致する内容を表示し、同時にシンボルが現われたファイル、 行番号、シンボルを持つ関数、そのシンボルを持つソースコードも表示します。

sbquery には、検索範囲を狭くするためのオプションが 2 つあります。 1 つはフィルタオプションで、プログラムの中でのシンボルの使われ方をもとに 検索します。 たとえば、変数の宣言だけを検索することができます。もう 1 つはフォーカスオプションで、 プログラム、関数、ライブラリなど、検索をコードのクラスで制限します。

オプション

-break_lock
    データベースのロックを外します。このオプションを使用すると、 ユーザーのデータベースは整合性のない状態になる可能性があります。 整合性を確保するには、 sbcleanup を使用してサブディレクトリを削除して、ユーザーのプログラムを再コンパイルします。

-files_only
    シンボルが現れるファイルだけをリストします。

-filter
    symbol に指定したフィルタをかけて検索します。 たとえば、 sbquery -strings argv は、文字列の参照に限り argv を検索します。 フィルタオプションのリストを表示するには、
    -help_filter オプションを使用します。

-focus
    指定したコードのクラスに限り symbol を検索します。 たとえば、 sbquery -in_library void は、ライブラリユニットに限り void を検索します。 フォーカスオプションのリストを表示するには、 -help_focus オプションを使用します。

-help
    sbquery コマンドの形式を表示します。

-help_filter language
    このオプションを引数なしで使用すると、フィルタオプションを使用できる 言語のリストを表示します。ある言語に対するフィルタオプションのリストを 表示するには、
    -help_filter と入力し、次にその言語名を入力します。 たとえば、 sbquery -help_filter ansi_c と入力すると、 ANSI C に対するすべてのフィルタオプションを表示します。 フィルタ付き問い合わせを行う場合、 sbquery の後にフィルタオプションを入力し、その後に検索したいシンボルを入力します。

-help_focus
    フォーカスオプションのリストを表示します。フォーカスした問い合わせを行う場合、 sbquery の後にフォーカスオプションを入力し、その後に検索したいシンボルを入力します。

-literal
    特殊文字そのものに一致し、ワイルドカードには一致しません。 このオプションは、他のワイルドカード方式のメタ文字を 含む文字列を検索するのに便利です。

-max_memory size
    sbquery がインデックスファイルを構築するときに使用する一時ファイル のメモリー総量の概数をバイト数で指定します。

-no_case
    ソースコード中のシンボルを検索するときに、大文字と小文字を区別しません。

-no_secondaries
    一次的一致だけ戻し、二次的一致は戻しません。 二次的一致とは、マクロ中の識別子のことです。 フィルタ付き問い合わせを多数行い、問い合わせ中のシンボルが多数のマクロの中で 使用されているときに、問い合わせの中で二次的一致をオフにすることができます。

-no_source
    各一致に関連するファイル名と行番号だけを表示します。 ソースは表示しません。

-no_update
    コンパイルの後に問い合わせをするときに、 インデックスファイルを再構築しません。

-o file
    標準出力の代わりに指定したファイルに出力を保存します。

-pattern symbol
    先頭にダッシュ (-) の付いた特殊文字を含む symbol について問い合わせを行います。 これによって、コマンド行オプションのように見えるシンボルについて問い合わせを 行うことができます。たとえば、 -help というシンボルについて問い合わせを行う場合、 sbquery は、通常の -help オプションと区別することができます。

-reg_expr
    正規表現のワイルドカードを使用して、問い合わせを行います。

-sh_pattern
    シェル形式のワイルドカードを含む問い合わせを行います。 このワイルドカードの設定がデフォルトです。 シェル形式のパターン照合についての詳細は、 sh(1) を参照してください。

-show_db_dirs
    すべての データベースディレクトリを表示します。 sbquery は、デフォルトで、現在の作業ディレクトリ内に そのデータベースを作成します。

-symbols_only
    ユーザーが指定した検索パターンに一致した すべてのシンボルのリストを表示します。

-version
    バージョンに関する情報を表示します。

-V  バージョンに関する情報を表示します。

例

コマンド sbquery は、 sbquery コマンドの形式を表示します。

コマンド sbquery file は、シンボル file を持つ行をすべて表示します。

コマンド sbquery -files_only hello は、シンボル hello が現れるファイルだけをすべてリストします。

コマンド sbquery -in_function hello -no_case file は、関数 hello の中で file が使用されている箇所をすべて見つけます。 sbquery は大文字と小文字を区別しません。

コマンド sbquery -no_case -declaration file は、宣言中に file が使用されている箇所をすべて見つけます。

コマンド sbquery -reg_expr -symbols_only arg. は、正規表現 arg. ("." は任意の文字との一致) と一致する箇所をすべて一覧表示します。

環境

環境変数は sbquery がデータベースを ブラウズするために必要な情報を格納します。

HOME
    ユーザーのログイン・ディレクトリ名。

PWD 現在のディレクトリの絶対パス名。

SUNPRO_SB_ATTEMPTS_MAX
    インデックス構築がロックされたデータベースにアクセスを試みる最大回数。

SUNPRO_SB_EX_FILE_NAME
    sun_source_browser.exファイルの絶対パス名。

SUNPRO_SB_INIT_FILE_NAME
    .sbinit ファイルの絶対パス名。

関連項目
sbcleanup(1)、 sbtags(1)、 sbinit(4)