Polyspace® Code Prover™ является звуковым инструментом статического анализа, который доказывает отсутствие переполнения, разделитесь на нуль, за пределы доступ к массиву и определенные другие ошибки времени выполнения в исходном коде C++ и C. Анализ Программы автоматического доказательства Кода приводит к результатам, не требуя выполнения программы, отладки кода или тестов. Программа автоматического доказательства кода использует семантический анализ и абстрактную интерпретацию на основе формальных методов, чтобы определить поток управления и поток данных в коде. Можно использовать Программу автоматического доказательства Кода на рукописном коде, сгенерированном коде или комбинации двух. В результатах анализа на каждую операцию наносят цветную маркировку, чтобы указать, свободно ли это от ошибок времени выполнения, которые, как доказывают, перестали работать, недостижимый, или бездоказательный.
Можно запустить Программу автоматического доказательства Кода на коде C/C++ от пользовательского интерфейса Polyspace в поддерживаемой среде разработки (IDE), такой как скрипты использования или Eclipse™. См.:
Запустите Polyspace в пользовательском интерфейсе
Если это - ваш первый раз с помощью Polyspace, вы можете хотеть начать с пользовательского интерфейса Polyspace. Можно получить справку от функций, таких как мастер настройки проекта, помог настройке и обобщил аналитический журнал.
Запустите Polyspace на командной строке Linux или Windows
Если вы настраиваете проект в пользовательском интерфейсе Polyspace и завершаете несколько пробных прогонов, можно экспортировать настройку в скрипты, которые вы запускаете автоматически или по требованию. Можно также запустить анализ Polyspace непосредственно из командной строки в операционной системе. Можно затем сохранить команды в пакетных файлах (Windows) или сценарии оболочки (Linux) для более поздних запусков. Если при запуске Серверные продукты Polyspace с помощью инструментов непрерывной интеграции, таких как Jenkins, можно переиспользовать скрипты из десктопных решений Polyspace.
Если вы знакомы с рабочим Polyspace из командной строки, можно создать пункты меню в IDE, которые запускают скрипты и запускают анализ Polyspace в один клик. В Eclipse и основанных на Eclipse IDE, можно установить плагин Polyspace, который не требует никакой дополнительной настройки вообще. Когда вы запускаете Polyspace от плагина Eclipse, аналитическая настройка создается непосредственно из вашего проекта Eclipse.
Если у вас есть установка MATLAB, особенно легко записать скрипты, чтобы запустить анализ Polyspace. Вы извлекаете всю пользу из сценариев в среде MATLAB, например, автоматической справке на синтаксисах функций. После анализа можно создать собственную визуализацию использования результатов графика MATLAB и инструменты визуализации.
Чтобы выполнить шаги в этом примере, скопируйте файлы |
Дважды кликните polyspace исполняемый файл в polyspaceroot\polyspace\binpolyspacerootC:\Program Files\Polyspace\R2020a. См. также Папку Установки.
Если вы настраиваете ярлык Polyspace на вашем рабочем столе или меню Start в Windows®, дважды кликаете ярлык.
Чтобы запустить верификацию, необходимо создать новый проект Polyspace. Проект Polyspace указывает, на исходный код и включать папки в вашей файловой системе.
Слева от панели Start Page нажмите Start a new project. В качестве альтернативы выберите File> New Project.
После того, как вы обеспечиваете название проекта на следующих экранах:
Добавьте свою исходную папку.
В этом примере добавьте путь к папке, в которой вы сохранили файл example.c. Нажмите Next.
Добавьте ваш включать папку.
В этом примере добавьте путь к папке, в которой вы сохранили файл include.h. Эта папка может совпасть с предыдущей папкой. Нажмите Finish.
После того, как вы закончите добавлять свой источник и включать папки, вы видите новый проект на панели Project Browser. Ваши исходные папки копируются в первый модуль в проекте. Можно щелкнуть правой кнопкой по проекту добавить больше папок позже. Если вы добавляете папки позже, необходимо явным образом скопировать их в модуль.
Можно изменить опции по умолчанию, сопоставленные с анализом Polyspace.
Кликните по узлу Configuration в своем модуле проекта. На панели Configuration измените опции по мере необходимости. Например, на узле Coding Rules & Code Metrics, выберите Check MISRA C:2004.
Для получения дополнительной информации смотрите подсказку на каждой опции. Щелкните по ссылке More help для контекстно-зависимой справки на опциях.
Чтобы запустить верификацию, нажмите Run Code Prover на главной панели инструментов. Если кнопка указывает на Bug Finder, кликните по стреле около кнопки, чтобы переключиться на Программу автоматического доказательства Кода.
Следуйте за прогрессом верификации на окне Output Summary. После верификации результаты открываются автоматически.
См.:
Можно запустить Программу автоматического доказательства Кода от Windows или командной строки Linux® с пакетом (.bat) файлы или интерпретатор (.shСкрипты.
Используйте polyspace-code-prover команда, чтобы запустить верификацию.
Чтобы сохранить ввод полного пути в команду, добавьте путь polyspaceroot\polyspace\binPath переменная окружения на вашей операционной системе. Здесь, polyspacerootC:\Program Files\Polyspace\R2020a.
Перейдите к папке, где вы сохранили файлы (использующий cd). Введите следующее:
polyspace-code-prover -sources example.c -I . -results-dir . -main-generator
. указывает на текущую папку. Используемые опции:
-sources: Задайте разделенные от запятой исходные файлы.
-I: Задайте путь, чтобы включать папку. Используйте -I отметьте каждый раз, когда вы хотите добавить, что отдельное включает папку.
-results-dir: Задайте путь к папке, где результаты Polyspace Code Prover будут сохранены.
Обратите внимание на то, что папка результатов очищена и повторно заполнена при каждом запуске. Чтобы избежать случайного удаления файлов во время очистки, вместо того, чтобы использовать существующую папку, которая содержит другие файлы, задают специализированную папку для результатов Polyspace.
Verify module or library (-main-generator): Укажите что main функция должна быть сгенерирована если не найденный в исходных файлах
После верификации результаты сохранены в файле ps_results.pscp. Можно открыть этот файл от пользовательского интерфейса Polyspace. Например, введите следующее:
polyspace ps_results.pscp
Вместо того, чтобы задать разделенные от запятой источники непосредственно на командной строке, можно перечислить источники в текстовом файле (один файл на строку). Используйте опцию -sources-list-file задавать этот текстовый файл.
См.:
Если вы разрабатываете код в Eclipse или основанном на Eclipse IDE, можно запустить Программу автоматического доказательства Кода непосредственно от IDE.
После установки плагина Eclipse можно запустить Polyspace непосредственно на файлах в проектах Eclipse.
В панели Project Explorer в Eclipse выберите свой проект. Чтобы использовать Программу автоматического доказательства Кода для анализа, выберите Polyspace> Code Prover. Чтобы запустить анализ, выберите Polyspace> Run (Ctrl + R).
После анализа результаты открываются автоматически в Eclipse.
Смотрите запущенный анализ Polyspace проектов Eclipse.
Прежде чем вы запустите Polyspace от MATLAB®, необходимо соединить Polyspace и установки MATLAB. Смотрите Интегрируют Polyspace с MATLAB и Simulink.
Чтобы запустить анализ, используйте polyspace.Project объект. Объект имеет два свойства:
Configuration: Задайте опции анализа, такие как источники, включает, компилятор и папка результатов с помощью этого свойства.
Results: После анализа считайте результаты анализа в таблицу MATLAB с помощью этого свойства.
Чтобы запустить анализ, используйте run метод этого объекта.
Запускать Polyspace на файле в качестве примера example.c в polyspaceroot\polyspace\examples\cxx\Code_Prover_Examples\sources
proj = polyspace.Project % Configure analysis proj.Configuration.Sources = {fullfile(polyspaceroot, 'polyspace', 'examples',... 'cxx', 'Code_Prover_Example', 'sources', 'example.c')}; proj.Configuration.EnvironmentSettings.IncludeFolders = {fullfile(polyspaceroot,... 'polyspace', 'examples', 'cxx', 'Code_Prover_Example', 'sources')} proj.Configuration.TargetCompiler.Compiler = 'gnu4.9'; proj.Configuration.ResultsDir = fullfile(pwd,'results'); proj.Configuration.CodeProverVerification.MainGenerator = true; % Run analysis cpStatus = proj.run('codeProver'); % Read results resObj = proj.Results; cpSummary = getSummary(resObj, 'runtime'); cpResults = getResults(resObj, 'readable');
После верификации результаты сохранены в файле ps_results.pscp. Можно открыть этот файл от пользовательского интерфейса Polyspace. Например, введите следующее:
resultsFile = fullfile(proj.Configuration.ResultsDir,'ps_results.pscp');
polyspaceCodeProver(resultsFile)
См.: