Please enable JavaScript to view this site.

Performance Validator Help

Navigation: Command Line Interface

Command Line Reference

Scroll Prev Top Next More

 

Command line reference

 

The following alphabetical list provides a convenient look-up for all the command line arguments used in automated regression testing.

 

Option

 

Description

-?

Print command line help on the standard output.

-allArgs

Pass the remainder of the command line (after -allArgs) to the program being launched.

-arg

Pass command line arguments to the target program. Can be used multiple times.

-baseline

Load a previously created session into Performance Validator to act as the baseline session against which other sessions are compared.

-classAndFunctionFile

Points to a file specifying the class and function hook options.

-collectData

Turn data collection on or off

-collectFunctionTimes

Turn the collection of function timing on or off

-collectLineTimes

Turn the collection of line timing on or off

-collectStdout

Turn collection of stdout on or off

-compareByParentTime
-compareByTotalTime

During session comparison choose whether to use the percentage of the parent's execution time or the total time as the comparator.

-comparisonShowAddress

-comparisonShowArgs

-comparisonShowFilename

-comparisonShowModulename

-comparisonShowReturnType

Control if the each of the function details are shown in an exported session comparison.

 

-createProcessStartupThread

Obsolete and ignored if present.

-directory

Set the working directory in which the program is executed.

-displayUI

Force the Performance Validator user interface to be displayed during the test.

-dllHookFile

Points to a file listing the DLLs to be hooked for the test.

-doNotInteractWithUser

Never display dialog boxes in the target application that is being profiled.

-dotNetCoreArg

Specify a runtime configuration option to the .Net runtime.

-dotNetCoreLaunchType

Specify if you are launching a self contained or framework dependent .Net Core application.

-environment

Environment variables for program, as a series of name/value pairs

-exportAsCallGraphHTML
-exportAsCallTreeHTML

Exports the session data as a HTML file containing a call graph or a call tree when Performance Validator has finished collecting data from the target program.

-exportAsHTML
-exportAsXML

Export the session data as an HTML or XML file when Performance Validator has finished collecting data.

-exportAsHTML_BOM
-exportAsXML_BOM

Specify the file encoding for the exported file

-exportDescription

Set the description to be included the exported HTML/XML.

-exportThreshold

Set the minimum overall percentage contribution that a function must have in order to be included in a call tree or call graph export.

-fileLocations

Specify a plain text file listing file locations to be used during testing. See the format of the file below.

-help

Print command line help on the standard output.

-hideUI

Hide the Performance Validator user interface during the test.

-idleStartupThread

Obsolete and ignored if present.

-injectID

Set the numeric (decimal) id of a process for Performance Validator to attach to.

-injectName

Set the name of the process for Performance Validator to attach to.

-launchAppHide

Hide the target application during the test.

-launchAppShow

Show the target application during the test.

-launchAppShowMaximized

Show the target application maximized and activated.

-launchAppShowMinNoActive

Show the target application minimized and activated.

-launchAppShowMinimized

Show the target application minimized and not active.

-launchAppShowNA

Show the target application at current size and position but not activated.

-launchAppShowNoActivate

Show the target application at most recent size and position but not activated.

-launchAppShowNormal

Show the target application at original size and position and activated.

-loadSettings

Points to a previously saved settings file to be used for the test.

-monitorAService

Specify the full file system path to a service to monitor, including any extension. The service is not started by Performance Validator but by an external means.

-normalStartupThread

Obsolete and ignored if present.

-noSuspendInStubDuringAttach

Obsolete and ignored if present.

-numSessions

Set the number of sessions that can be loaded at once.

-pauseStartupThread

Obsolete and ignored if present

-program

Specify the full file system path of the executable target program to be started by Performance Validator, including any extension.

-programToMonitorDLL

Specify the .Net Core DLL that identifies the program being monitored. Use in conjunction with -programToMonitorEXE.

-programToMonitorEXE

-programToMonitor

Changes which program the data is collected from but does not change which process Performance Validator initially launches.

-programToMonitorLaunchCount

Specify the nth invocation of the programToMonitor which is to have its data collected.

-refreshAnalysis

Automatically refresh the Analysis tab once a test is complete.

-refreshCallTree

Automatically refresh the Call Tree tab once a test is complete.

-refreshCallGraph

Automatically refresh the Call Graph tab once a test is complete.

-refreshStatistics

Automatically refresh the Statistics tab once a test is complete.

-saveSession

Save the session data when all data has finished being collecting from the target program.

-sessionCompareHTML

-sessionCompareXML

Compare two sessions, producing an HTML or XML report detailing any performance regression and improvements.

-sessionLoad

Load a previously created session to be compared with the data from the session being recorded.

-setenvironment

Environment variables for Performance Validator, as a series of name/value pairs

-settings

Points to a previously saved settings file to be used for the test.

-showErrorsWithMessageBox

Force errors to be displayed using a message box when running from the command line.

-sourceFileFilterHookFile

Points to a file specifying the source files to be hooked for the test.

-suspendStartupThread

Obsolete and ignored if present.

-thresholdPC

Set the percentage threshold to be used when performing session comparisons.

-waitNameDLL

Name a .Net Core dll that identifies the process to wait for. Use in conjunction with -waitNameEXE.

-waitNameEXE

-waitName

Name a process that Performance Validator will wait for.

-win32API

Specify how to hook Win32 API functions called from the target application.

 

 

To run 32 bit performance validator run C:\Program Files (x86)\Software Verify\Performance Validator x86\performanceValidator.exe

 

To run 64 bit performance validator run C:\Program Files (x86)\Software Verify\Performance Validator x64\performanceValidator_x64.exe