curs_trace(3X) | curs_trace(3X) |
名称
_tracef, _tracedump, _traceattr, _traceattr2, _nc_tracebits, _tracechar, _tracechtype, _tracechtype2, _tracemouse, trace - curses デバッグルーチン書式
#include <curses.h>解説
trace ルーチンは、ncurses ライブラリを使用するアプリケーションと同様に ncurses ライブラリをデバッグするために使用されます。これらの関数は、通常デバッグライブラリ libncurses_g.a でのみ利用可能ですが、シンボル TRACE を定義することによって任意のモデル (共有、静的、プロファイル) にコンパイルすることができます。このインタフェースの主要部分は、異なるトレース機能を選択的に有効にする trace ルーチン、と trace ファイルに書式化されたデータを書き込む _tracef ルーチンです。
0 でないパラメータをつけて trace を呼び出すことは、カレントディレクトリのファイル trace を出力のためにオープンします。パラメータは、 <curses.h> の TRACE_xxx 定義のリストから値を論理和 (OR) することにより形成されます。これらは、次のものを含んでいます:
- TRACE_DISABLE
- トレースをオフに切り替えます。
- TRACE_TIMES
- ユーザとシステムの更新時間をトレースします。
- TRACE_TPUTS
- tputs 呼び出しをトレースします。
- TRACE_UPDATE
- 更新の動作、古い &新しい画面をトレースします。
- TRACE_MOVE
- カーソルの移動とスクロールをトレースします。
- TRACE_CHARPUT
- すべての文字出力をトレースします。
- TRACE_ORDINARY
- すべての更新の動作をトレースします。古い画面の新しい画面の内容は、各リフレッシュのためのトレースファイルに書き込まれます。
- TRACE_CALLS
- すべての curses 呼び出しをトレースします。各呼び出しのためのパラメータは、返り値と同様にトレースされます。
- TRACE_VIRTPUT
- 実際上の文字の出力 (put)、すなわち addch の呼び出し、をトレースします。
- TRACE_IEVENT
- タイムアウトを含んで、低レベル入力処理をトレースします。
- TRACE_BITS
- TTY 制御ビットの状態をトレースします。
- TRACE_ICALLS
- 内部の/ネストした呼び出しをトレースします。
- TRACE_CCALLS
- 文字ごとの呼び出しをトレースします。
- TRACE_DATABASE
- terminfo/termcap データの読み込み/書き込みをトレースします。
- TRACE_ATTRS
- ビデオ属性と色の変化をトレースします。
- TRACE_MAXIMUM
- 最大のトレースレベル、個別のトレース機能のすべてを有効にします。
trace パラメータが 0 でないときはいつでも、いくつかのトレース機能が、有効にされます。いくつかの機能は、オーバラップしています。特有の名前は、ガイドラインとして使用されます。