制約の設定 (-data-range-specifications)
R2026bグローバル変数、関数の入力およびスタブ関数の戻り値の制約
説明
グローバル変数、関数入力およびスタブ関数の戻り値の制約 (データ範囲指定または DRS とも呼ばれます) を、[制約指定] テンプレート ファイルを使用して指定します。このテンプレート ファイルは、Polyspace® ユーザー インターフェイスで生成できる XML ファイルです。
オプションの設定
以下のいずれかの方法を使用してオプションを設定します。
Polyspace Platform ユーザー インターフェイス (デスクトップ製品のみ): プロジェクト構成の [静的解析] タブで [入力およびスタブ] ノードを選択してから、このオプションを使用して制約ファイルを作成します。
コマンド ラインとオプション ファイル: オプション
-data-range-specificationsを使用します。コマンド ライン情報を参照してください。Python® API: 静的解析構成で
DataRangeSpecificationsプロパティを設定します。polyspace.project.StaticAnalysisConfiguration(Polyspace Test) を参照してください。TOML 構成ファイル (
.toml.pscfg) —[InputsStubbing]テーブルのキーDataRangeSpecificationsを使用します。以下に例を示します。[InputsStubbing] DataRangeSpecifications = "drs_file.xml"
このオプションを使用する理由
このオプションは、値が実行時にのみ既知であるコード内の、特定のオブジェクトを制約するために使用します。たとえば、ユーザー入力やセンサー値などのオブジェクトです。適切に制約されたオブジェクトを使用すると、Polyspace 結果内の誤検知やオレンジ チェックが減少する可能性があります。
ソース コードに基づいて、Polyspace は、変数の範囲やポインターに許容されるバッファー サイズなどの項目について仮定を行います。仮定は予想よりも幅広くなる場合があります。その理由は次のとおりです。
完全なコードが提供されていない。たとえば、関数定義の一部が提供されなかった場合。
変数に関する一部の情報が実行時にのみ利用可能である。たとえば、コード内の一部の変数が実行時にユーザーから値を取得する場合。
たとえば、現実世界の速度を表す int 変数の場合、その値が 0 より小さくなったり、光の速度より大きくなったりすることはありません。Polyspace は、変数の範囲が [-2^32... 2^32-1] であると仮定します。このように仮定の幅が広いため、以下のようになります。
Code Prover では実行時に発生するパスよりも多くの実行パスを考慮する可能性があります。実行パスの 1 つで操作が失敗すると、Polyspace はこの操作に対してオレンジ チェックを付けます。その実行パスが実行時に発生しない場合、オレンジ チェックは誤検知を示します。
Bug Finder では誤検知が生じることがあります。
こうした誤検知の数を減らすには、グローバル変数、関数入力、およびスタブ関数の戻り値に適用可能な制約を指定します。
制約を指定したら、それらを以降の解析で使用するために XML ファイルとして保存します。ソース コードを変更したら、以前の制約を更新します。新しい制約テンプレートを作成する必要はありません。
設定
既定値なし
テンプレート ファイルへの絶対パスを入力します。あるいは、
をクリックして既存の制約テンプレート ファイルに移動します (解析後に結果フォルダーに生成される drs-template.xml など)。
メモ
[制約指定] ウィンドウには Java® が必要です。R2026b 以降は、Polyspace Platform ユーザー インターフェイスまたは従来のユーザー インターフェイスから [制約指定] ウィンドウを開く前に、Install Java Runtime Environment (JRE) for Java-based Polyspace Workflows (Polyspace Code Prover)を実行する必要があります。
詳細については、Polyspace 解析の外的制約の指定を参照してください。
コマンド ライン情報
パラメーター: -data-range-specifications |
値: file |
| 既定値なし |
例 (Bug Finder): polyspace-bug-finder -sources |
例 (Code Prover): polyspace-code-prover -sources |
例 (Bug Finder Server): polyspace-bug-finder-server -sources |
例 (Code Prover Server): polyspace-code-prover-server -sources |
制約ファイルの絶対パスの指定、または polyspace-bug-finder または polyspace-code-prover コマンドを実行する場所からの相対パスの指定が可能です。