マニュアルページ 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)