scons-time - クラウドでオンライン

プログラム：

NAME

scons-time - SCons タイミング情報を生成および表示します

SYNOPSIS

スコンズタイム サブコマンド [オプション...] [引数...]

生成 タイミング 情報

スコンズタイム ラン [-hnqv] [--aegis=PROJECT] [-f FILE] [--番号=数] [--outdir=外向き] [-p
STRING] [--python=パイソン] [-s DIR] [--scons=軽蔑者] [--svn=URL] [議論]

抽出 演算 タイミング
スコンズタイム ファンク [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [--func=NAME] [-p STRING] [-t
数] [--title = TITLE] [議論]

抽出 メモリ 統計
スコンズタイム memの [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [-p STRING] [--ステージ=ステージ] [-t
数] [--title =TITLE] [議論]

抽出 オブジェクト カウント
スコンズタイム オブジェクト [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [-p STRING] [--ステージ=ステージ] [-t
数] [--title =TITLE] [議論]

抽出 実行 タイムズ
スコンズタイム 時間 [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [-p STRING] [-t 数]
[--title =TITLE] [--どれ=WHICH] [議論]

カスタマーサービス テキスト
スコンズタイム 助けます サブコマンド [...]

DESCRIPTION

当学校区の スコンズタイム コマンドは、プロファイリングされた標準セットを通じて SCons 構成を実行します。
タイミングを測定し、結果として得られるプロファイルとログ ファイルから情報を抽出してグラフ化することができます。
それらのタイミング。 によって実行されるアクション スコンズタイム スクリプトは、
subcommand、コマンドラインの最初の引数。 詳細については、以下の「サブコマンド」セクションを参照してください。
特定のサブコマンドの操作に関する情報。

基本的な使い方 スコンズタイム を実行することです スコンズタイム ラン サブコマンド (複数の場合もある)
回) を使用してプロファイルとログ ファイルの出力を生成し、他のサブコマンドのいずれかを使用します。
特定の種類のプロファイルとログ ファイルにキャプチャされた結果を表示します。
情報: 関数のタイミング ( スコンズタイム ファンク サブコマンド)、使用された合計メモリ (
スコンズタイム memの サブコマンド)、オブジェクト数 ( スコンズタイム オブジェクト サブコマンド）および全体
実行時間 ( スコンズタイム 時間 サブコマンド)。 を配置および検索するためのオプションが存在します。
プロファイルとログ ファイルを別のディレクトリに配置し、次の形式で出力を生成します。
でグラフ化するのに適しています。 gnuplot(1) プログラムなど。

基本的な方法は XNUMX つあります スコンズタイム ラン サブコマンドは収集に使用することを目的としています。
構成のタイミング統計。 XNUMX つは、 --svn= をテストするオプション
SCons Subversion リポジトリのリビジョンのリストと照合して設定を行います。 この意志
にリストされているすべてのリビジョンのプロファイルとタイミング ログ ファイルを生成します。 --番号=
オプションを使用して、SCons コード ベースに対するコミットされた変更の影響を確認することができます。
特定の構成での時間の経過に伴う変化。

もう XNUMX つの方法は、ローカル SCons コード ベースへの増分変更をプロファイリングすることです。
開発サイクル -- つまり、実行中の変更がパフォーマンスに与える影響を確認します。
地元の木。 このモードでは、 スコンズタイム ラン サブコマンド 無し 　 --svn=
オプションを使用する場合、単にプロファイル/ログ ファイルの出力ディレクトリ (
デフォルトでは現在のディレクトリ）、自動的に 次の の実行番号
出力プロファイルとログ ファイル。 このように使用すると、開発サイクルは次のようになります。
SCons を変更します。 走る スコンズタイム ラン 特定の構成に対してプロファイルを作成します。
SCons に別の変更を加えます。 走る スコンズタイム ラン もう一度プロファイルを作成します。 等

OPTIONS

当学校区の スコンズタイム コマンドはいくつかのグローバル オプションのみをサポートします。

-h、-help
グローバル ヘルプ テキストを表示して終了します。これは、 スコンズタイム 助けます サブコマンド。

-V、-version
表示する スコンズタイム バージョンと終了します。

ほとんどの機能は、個々のサブコマンドのオプションによって制御されます。 次を見る
個々のサブコマンド オプションについては、セクションを参照してください。

サブコマンド

当学校区の スコンズタイム コマンドは、次の個々のサブコマンドをサポートします。

当学校区の ファンク サブコマンド
スコンズタイム ファンク [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [--func=NAME] [-p STRING] [-t
数] [--title = TITLE] [議論]

当学校区の スコンズタイム ファンク サブコマンドは、特定の Python 関数のタイミング情報を表示します。
SCons内で。 デフォルトでは、 _主要() 関数。
すべての SCons の Python プロファイラ タイミングが含まれます。

当学校区の スコンズタイム ファンク サブコマンドは、指定されたすべての関数から関数タイミング情報を抽出します。
ファイル引数。これは Python プロファイラー出力ファイルである必要があります。 (通常、これらは
*.prof によって生成されたファイル スコンズタイム ラン サブコマンドですが、実際には
任意の Python プロファイラー呼び出しによって生成されます。) すべてのファイル名引数がグロブされます。
ディスク上のファイル。

引数が指定されていない場合、関数のタイミング情報はすべての関数から抽出されます。
*.prof ファイル、または、によって指定されたプレフィックスが付いたファイルのサブセット -p オプションを選択します。

オプションは次のとおりです。

-C ディレクトリ、--chdir=ディレクトリ
指定された内容への変更 DIRECTORY 指定されたファイル (または複数のファイル) を検索する前に
指定されたパターンに一致するもの）。

-f ファイル、--file=ファイル
指定された場所から構成情報を読み取ります。 FILE.

-fmt=フォーマット、--format=フォーマット
指定された形式で出力をレポートします。 FORMAT。 現在サポートされている形式は次のとおりです アスキー
(デフォルト) および gnuplot.

--func=名前
指定された関数のタイミングを抽出します NAME。 デフォルトでは累積レポートが行われます。
のタイミング _主要() 関数。これには、SCons の実行全体が含まれます。

-h、-help
のヘルプテキストを表示します。 スコンズタイム ファンク サブコマンド。

-p STRING、--prefix=STRING
関数タイミングを抽出するプロファイルのプレフィックス文字列を指定します
情報。 これは、引数が指定されていない場合にプロファイルを検索するために使用されます。
コマンドライン。

-t NUMBER、--tail=NUMBER
最後の関数タイミングのみを抽出します。 数 ファイル。

当学校区の 助けます サブコマンド
スコンズタイム 助けます サブコマンド [...] 助けます サブコマンドは、その他のヘルプ テキストを出力します。
サブコマンドはコマンドラインの後の引数としてリストされます。

当学校区の memの サブコマンド
スコンズタイム memの [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [-p STRING] [--ステージ=ステージ] [-t
数] [--title =TITLE] [議論]

当学校区の スコンズタイム memの サブコマンドは、SCons が使用するメモリ量を表示します。

当学校区の スコンズタイム memの サブコマンドは、指定されたすべてのファイルからメモリ使用情報を抽出します。
引数は、SCons を実行したときの出力を含むファイルである必要があります。
--debug=メモリ オプション。 (通常、これらは *。ログ によって生成されたファイル スコンズタイム
ラン すべてのファイル名引数は、ディスク上のファイルに対してグロブされます。

引数が指定されていない場合、メモリ情報はすべてのメモリから抽出されます。 *。ログ
ファイル、または、によって指定されたプレフィックスが付いたファイルのサブセット -p オプションを選択します。

-C DIR、--chdir=DIR
指定された内容への変更 DIRECTORY 指定されたファイル (または複数のファイル) を検索する前に
指定されたパターンに一致するもの）。

-f ファイル、--file=ファイル
指定された場所から構成情報を読み取ります。 FILE.

-fmt=フォーマット、--format=フォーマット
指定された形式で出力をレポートします。 FORMAT。 現在サポートされている形式は次のとおりです アスキー
(デフォルト) および gnuplot.

-h、-help
のヘルプテキストを表示します。 スコンズタイム memの サブコマンド。

-p STRING、--prefix=STRING
メモリ使用量を抽出するログ ファイルのプレフィックス文字列を指定します
情報。 引数が指定されていない場合、これはログ ファイルの検索に使用されます。
コマンドラインで。

--stage=ステージ
指定されたメモリの最後に使用されたメモリを出力します。 ステージ: 先読み （の前に
SConscript ファイルが読み取られます)、 読後 , (SConscript ファイルが読み取られた後)、
事前構築 (ターゲットが構築される前) または ビルド後の (ターゲットが構築された後)。
ない場合 - ステージ オプションが指定されている場合、デフォルトの動作は次のようになります。 ビルド後の、報告します
各実行中に SCons によって使用される最終的なメモリ量。

-t NUMBER、--tail=NUMBER
前回からのメモリ統計のみを報告します。 数 ファイル。

当学校区の オブジェクト サブコマンド
スコンズタイム オブジェクト [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [-p STRING] [--ステージ=ステージ] [-t
数] [--title =TITLE] [議論]

当学校区の スコンズタイム オブジェクト サブコマンドは、特定の名前付きタイプのオブジェクトの数を表示します。
SConsによって作成されました。

当学校区の スコンズタイム オブジェクト サブコマンドは、指定されたすべてのファイルからオブジェクト数を抽出します。
引数は、SCons を実行したときの出力を含むファイルである必要があります。
--debug=カウント オプション。 (通常、これらは *。ログ によって生成されたファイル スコンズタイム
ラン すべてのファイル名引数は、ディスク上のファイルに対してグロブされます。

引数が指定されていない場合、オブジェクト数はすべてのオブジェクトから抽出されます。 *。ログ ファイル、
または、によって指定されたプレフィックスが付いたそれらのサブセット -p オプションを選択します。

-C DIR、--chdir=DIR
指定された内容への変更 DIRECTORY 指定されたファイル (または複数のファイル) を検索する前に
指定されたパターンに一致するもの）。

-f ファイル、--file=ファイル
指定された場所から構成情報を読み取ります。 FILE.

-fmt=フォーマット、--format=フォーマット
指定された形式で出力をレポートします。 FORMAT。 現在サポートされている形式は次のとおりです アスキー
(デフォルト) および gnuplot.

-h、-help
のヘルプテキストを表示します。 スコンズタイム オブジェクト サブコマンド。

-p STRING、--prefix=STRING
オブジェクト数を抽出するログ ファイルのプレフィックス文字列を指定します。 これ
コマンドに引数が指定されていない場合、ログ ファイルの検索に使用されます。
ライン。

--stage=ステージ
指定されたオブジェクトの最後にオブジェクト数を出力します。 ステージ: 先読み （の前に
SConscript ファイルが読み取られます)、 読後 , (SConscript ファイルが読み取られた後)、
事前構築 (ターゲットが構築される前) または ビルド後の (ターゲットが構築された後)。
ない場合 - ステージ オプションが指定されている場合、デフォルトの動作は次のようになります。 ビルド後の、報告します
各実行中の最終的なオブジェクト数。

-t NUMBER、--tail=NUMBER
最後からのオブジェクト数のみをレポートします。 数 ファイル。

当学校区の ラン サブコマンド
スコンズタイム ラン [-hnqv] [--aegis=PROJECT] [-f FILE] [--番号=数] [--outdir=外向き] [-p
STRING] [--python=パイソン] [-s DIR] [--scons=軽蔑者] [--svn=URL] [議論] スコンズタイム
ラン subcommand は、特定の構成をプロファイリングするための基本的なサブコマンドです。
SCons のバージョン。

テストする構成は、テストされるファイルまたはディレクトリのリストとして指定されます。
SCons が呼び出される一時ディレクトリに解凍またはコピーされます。 の
スコンズタイム ラン サブコマンドは次のようなファイル接尾辞を理解します。 。タール, .tar.gz, の。tgz 　 .zip 　
コンテンツを一時ディレクトリに解凍します。 複数の引数がある場合
指定すると、それぞれが解凍されるか、「上」の一時ディレクトリにコピーされます。
以前のアーカイブまたはディレクトリであるため、複数の指定が期待されます。
アーカイブは同じディレクトリ レイアウトを共有します。

ファイルまたはディレクトリ引数が解凍されるか、一時ディレクトリにコピーされると、
　 スコンズタイム ラン サブコマンドは、要求されたバージョンの SCons を
設定を XNUMX 回行います:

スタートアップ
SCons は、 - 助けて SConscript ファイルのみが読み取られるようにオプションを設定し、
デフォルトのヘルプ テキストが印刷されます。 これは、認識される「オーバーヘッド」だけをプロファイルします。
SCons の起動と SConscript ファイルの処理。

フルビルド
SCons は、構成で指定されたすべてをビルドするために実行されます。 具体的なターゲット
コマンドラインで渡されるものは、 ターゲット のキーワード
構成ファイル。 詳細については以下を参照してください。

再構築する
SCons は、構築したばかりの同じディレクトリ上で再度実行されます。 SCons 内の依存関係が
設定が正しい場合、これは最新の「何もしない」再構築である必要があります。

各呼び出しでは、出力ログ ファイルとプロファイルがキャプチャされます。

当学校区の スコンズタイム ラン サブコマンドは次のオプションをサポートしています。

--aegis=プロジェクト
イージスを指定します PROJECT のバージョンから 軽蔑的 時間を計られることになる
抽出された。 いつ --イージス 指定されている場合、 --番号=数 オプションでデルタを指定します
テストされる数字。 各呼び出しの実行からの出力はファイルに配置されます
Aegis デルタ番号と一致する名前。 もし --番号= オプションが指定されていません、
この場合、デフォルトの動作は、指定された先端の時間を計測することです。 PROJECT.

-f ファイル、--file=ファイル
指定された場所から構成情報を読み取ります。 FILE。 これにより、多くの場合、さらに多くの機能が提供されます
特定のタイミングに関連するパラメータを指定して収集する便利な方法
コマンドラインで指定するよりも、設定を行う必要があります。 構成ファイルを参照してください
構成ファイルのパラメータについては、以下のセクションを参照してください。

-h、-help
のヘルプテキストを表示します。 スコンズタイム ラン サブコマンド。

-n、--no-exec
コマンドを実行せず、コマンドラインに相当するものを出力するだけです。
実行されました。 注意してください。 スコンズタイム スクリプトは実際に Python でアクションを実行します。
可能であれば、携帯性のために。 表示されるコマンドはUNIXです 同等物 何の
それはやってるよ。

--number=NUMBER
ログ ファイルとプロファイル出力の名前に使用される実行番号を指定します。
この実行によって生成されます。

と組み合わせて使用​​する場合 --aegis=PROJECT オプション、 数 XNUMX つ以上を指定します
カンマ区切りのイージス デルタ番号。
特定イージス PROJECT.

と組み合わせて使用​​する場合 --svn=URL オプション、 数 XNUMX つ以上を指定します
カンマ区切りの Subversion リビジョン番号。
指定された Subversion リポジトリ URL。 デルタまたはリビジョン番号の範囲は次のとおりです。
XNUMX つの数値をハイフン (-).

例：

% scons-time 実行 --svn=http://scons.tigris.org/svn/trunk --num=1247,1249-1252 。

-p STRING、--prefix=STRING
生成されるすべてのログ ファイルとプロファイルに使用されるプレフィックス文字列を指定します。
この実行によって。 デフォルトは、最初に指定された引数から導出されます。
引数はディレクトリです。デフォルトの接頭辞はディレクトリの名前です。 最初の場合
引数はアーカイブ (tar または zip ファイル)、デフォルトの接頭辞はそのベース名です。
アーカイブ、つまりアーカイブの接尾辞を取り除いた後に残るもの (の。tgz, .tar.gz
or .zip).

--python=パイソン
タイミング実行に使用する Python 実行可能ファイルへのパスを指定します。 デフォルト
を実行しているのと同じ Python 実行可能ファイルを使用することです。 スコンズタイム コマンド自体。

-q、-quiet
実行中のコマンドラインの表示を抑制します。

-s DIR、--subdir=DIR
コマンドの実行元となるディレクトリまたはサブディレクトリの名前を指定します。
実行されました。 デフォルトは XXX です

--scons=SCONS
タイミング実行に使用する SCons スクリプトへのパスを指定します。 デフォルトは
XXX

--svn=URL、--subversion=URL
指定する URL のバージョンが含まれている Subversion リポジトリの 軽蔑的
タイミングが合えば抽出されます。 いつ --svn 指定されている場合、 --番号=数 オプション
テストされるリビジョン番号を指定します。 各呼び出しの実行からの出力は、
Subversion リビジョン番号と一致するファイル名で配置する必要があります。 もし --番号=
オプションが指定されていない場合、デフォルトの動作では、 HEAD
指定の URL.

-v、-verbose
個々のコマンドからの出力を画面に表示します（キャプチャに加えて）
ログファイルの出力)。

当学校区の 時間 サブコマンド
スコンズタイム 時間 [-h] [--chdir=DIR] [-f FILE] [--fmt =FORMAT] [-p STRING] [-t 数]
[--title =TITLE] [--どれ=WHICH] [議論]

当学校区の スコンズタイム 時間 サブコマンドは、によって報告された SCons 実行時間を表示します。 軽蔑的
--debug=時間 オプションを選択します。

当学校区の スコンズタイム 時間 サブコマンドは、指定されたすべてのファイルから SCons タイミングを抽出します
引数は、SCons を実行したときの出力を含むファイルである必要があります。
--debug=時間 オプション。 (通常、これらは *。ログ によって生成されたファイル スコンズタイム ラン
すべてのファイル名引数は、ディスク上のファイルに対してグロブされます。

引数を指定しない場合は、すべてのパラメータから実行タイミングが抽出されます。 *。ログ
ファイル、または、によって指定されたプレフィックスが付いたファイルのサブセット -p オプションを選択します。

-C DIR、--chdir=DIR
指定された内容への変更 DIRECTORY 指定されたファイル (または複数のファイル) を検索する前に
指定されたパターンに一致するもの）。

-f ファイル、--file=ファイル
指定された場所から構成情報を読み取ります。 FILE.

-fmt=フォーマット、--format=フォーマット
指定された形式で出力をレポートします。 FORMAT。 現在サポートされている形式は次のとおりです アスキー
(デフォルト) および gnuplot.

-h、-help
のヘルプテキストを表示します。 スコンズタイム 時間 サブコマンド。

-p STRING、--prefix=STRING
実行タイミングを抽出するログファイルのプレフィックス文字列を指定します。
これは、コマンドに引数が指定されていない場合にログ ファイルを検索するために使用されます。
ライン。

-t NUMBER、--tail=NUMBER
最後からのオブジェクト数のみをレポートします。 数 ファイル。

--どれ=どれ
指定されたコマンドの実行時間を出力します。 WHICH 値： 合計 (合計実行
時間）、 S徴兵 (SConscript ファイル自体の合計実行時間)、 SCコン
(SCons コード自体の実行時間) または コマンド (コマンドの実行時間と
ターゲットを構築するために使用されるその他のアクション)。 いいえの場合 - どれの オプションが指定されている場合、デフォルトは
行動は 合計、各実行の合計実行時間をレポートします。

CONFIGURATION FILE

さまざまな スコンズタイム サブコマンドは、指定された構成ファイルから情報を読み取ることができます
渡されたとき -f or - ファイル オプション。 設定ファイルは実際には次のように実行されます。
Python スクリプト。 構成ファイルに Python 変数を設定すると、
　 スコンズタイム コマンドライン オプションを指定したり、スクリプトを実行したりするよりも便利です。
実行ごとに引数があり、必要な引数を「シュリンクラップ」する便利な方法を提供します。
特定のタイミングでの一貫した実行を生成 (およびレポート) するための情報
構成。

イージス
デルタを抽出するための Aegis 実行可能ファイル。 デフォルトは単純に イージス.

イージスプロジェクト
デルタを抽出する必要がある Aegis プロジェクト。 デフォルトは何もありません
で指定 --aegis= コマンドラインオプション。

アーカイブリスト
一時ファイルにコピーされるアーカイブ (ファイルまたはディレクトリ) のリスト
SCons が呼び出されるディレクトリ。 。タール, .tar.gz, の。tgz 　 .zip ファイルは
コンテンツを一時ディレクトリに解凍します。 ディレクトリツリーとファイル
そのままコピーされます。

初期コマンド
実際の時間の前に実行されるコマンドのリスト 軽蔑的 走る。 これはできる
ソースツリーを準備するために必要なコマンドに使用できます。たとえば、
時間指定された実行に含めるべきではない構成ファイルを作成します。

キーの場所
で生成された Gnuplot グラフ情報上のキーの位置。
--format=gnuplot オプション。 デフォルトは ボトム 左.

接頭辞
このファイルのタイミングを実行または抽出するときに使用されるファイル名のプレフィックス
構成。

パイソン
実行または抽出時に使用される Python 実行可能ファイルのパス名
この構成に関する情報。 デフォルトは、以前に使用されていたのと同じバージョンの Python です。
SConsを実行する

軽蔑的
情報を実行または抽出するときに使用される SCons スクリプトのパス名
この構成の場合。 デフォルトは単純に 軽蔑的.

scons_flags
当学校区の 軽蔑的 SCons を実行してタイミング情報を収集するときに使用されるフラグ。 デフォルト
値は --debug=カウント --debug=メモリ --debug=時間 --debug=メモイザー.

scons_lib_dir, scons_wrapper, スタートアップターゲット, サブディレクトリ
プロジェクトのサブディレクトリ スコンズタイム スクリプトはその前に変更する必要があります
SCons コマンドを時間に合わせて実行します。

subversion_url
Subversion の URL

SVN
時間を測定する SCons のリビジョンをチェックアウトするために使用される Subversion 実行可能ファイル。 の
デフォルトはシンプルです SVN.

svn_co_flag, tar, ターゲット
すべてのコマンドラインに追加する必要があるターゲットを含む文字列。
時限 軽蔑的 走る。 これは、タイミングを計るものをサブセットに制限するために使用できます。
構成の完全なビルド。

ターゲット0, ターゲット1, ターゲット2, タイトル, 解凍する, 詳細, 垂直バー

例:
以下に例があります スコンズタイム 仮想サンプル プロジェクトの構成ファイル:

# このプロジェクトでは (まだ) SCons をネイティブに使用していないため、
# 用意した別の SConscript ファイルのセットのタイミングを計る
# バニラの解凍されたプロジェクト tarball の上に。
引数 = ['project-1.2.tgz', 'project-SConscripts.tar']

# サブディレクトリ名にはプロジェクトのバージョン番号が含まれます。
# したがって、ビルドする前に scons-time に chdir を指示します。
サブディレクトリ = 'プロジェクト-1.2'

# 出力ログ ファイルとプロファイルの名前が付けられるようにプレフィックスを設定します。
# プロジェクト-000-[012].{log,prof}
# プロジェクト-001-[012].{log,prof}
＃など
プレフィックス = 'プロジェクト'

# テストされている SConscript ファイルは SConf を実行しません
# 設定なので、通常の ./configure スクリプトを実行します
# SCons を呼び出す前に。
初期コマンド = [
'。/構成、設定'、
]

# bin/プロジェクト実行可能ファイルをビルドする時間のみ。
ターゲット = 'ビン/プロジェクト'

# ブランチ/コア ブランチの SCons リビジョンに対する時間
subversion_url = 'http://scons.tigris.org/svn/scons/branches/core'

ENVIRONMENT

当学校区の スコンズタイム スクリプトは次の環境変数を使用します。

保存する
この値が設定されている場合、 スコンズタイム スクリプトは 一時ディレクトリを削除するか、
指定された構成を構築するディレクトリ、または特定のファイルをダウンロードするディレクトリ
SCons のバージョン。

onworks.net サービスを使用してオンラインで scons-time を使用する