Please enable JavaScript to view this site.

Coverage 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 to the program being launched.

-arg

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

-centralDirectory

Name a central directory used for performing an auto merge.

-centralFileName

Name the full path to the central file used for performing an auto merge.

-classAndFunction

Specify classes and methods to be hooked or not hooked.

-classAndFunctionAll

All classes and methods will be hooked.

-classAndFunctionDoNotHook

Classes and methods specified by -classAndFunction will not be hooked.

-classAndFunctionFile

Points to a file specifying the class and function to be hooked for the test.

-classAndFunctionHook

Only the classes and methods specified by -classAndFunction will be hooked.

-classAndFunctionNone

Discard any previous command line options specified for the class and method filter.

-codeExcludeDisable

-codeExcludeEnable

Disable or enable source code exclusion.
 

-collectData

Turn data collection on or off

-collectStdout

Turn collection of stdout on or off

-commandFile

Specify a file from which to read the command line arguments.

-createProcessStartupThread

This option is obsolete.

-directory

Set the working directory in which the program is executed.

-disableMergeIntoCurrentSession

When the regression test is complete, the merged session results will not be merged into the current session.

-displayUI

Force the Coverage 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.

-dontShowWindowsErrorReportingUI

Never display the Windows Error Reporting dialog if the target program crashes.

-enableMergeIntoCurrentSession

When the regression test is complete, set the merged session results to be merged into the current session.

-endPragma

Set the end pragma for use with multi-line code exclusion.

-environment

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

-exportAsHTML
-exportAsXML

Export the session data as an HTML or XML file when Coverage Validator has finished collecting data from the target program.

-exportAsXMLCobertura

Export the session data as a Cobertura XML file when Coverage Validator has finished collecting data.

-exportAsHTML_BOM
-exportAsXML_BOM

-exportAsXMLCobertura_BOM

-exportMergedAsHTML_BOM
-exportMergedAsXML_BOM

-exportMergedAsXMLCobertura_BOM

Specify the file encoding for the exported file

-exportDescription

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

-exportDetailedReport

Produce a detailed export report.

-exportDoColourCode

Make the HTML export colour coded (not relevant for XML export).

-exportFileFormatCR
-exportFileFormatCRLF
-exportFileFormatLF

Set the line ending format in the output file.

-exportMergedAsHTML

-exportMergedAsXML

Export the merged session data as an HTML or XML file when Coverage Validator has finished collecting data from the target program.

-exportSourceCode

Set whether source code is exported when -exportType is set to. SummaryAndCoverage

-exportType

Specify the format of the exported data (file, class, summary & coverage).

-exportUnhooked

Export information about functions that could not be hooked.

-exportUnvisitedFunctions

Export  information about unvisited functions.

-exportUnvisitedLines

Export  information about unvisited lines.

-exportVisitedFunctions

Export  information about visited functions.

-exportVisitedLines

Export  information about visited lines.

-fileExt

Specify a file extension to be instrumented.

-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.

-hideCommandPrompt

Any launched console window will be hidden during the test.

-hideUI

Hide the Coverage Validator user interface during the test.

-idleStartupThread

This option is obsolete.

-ignoreMissingStdin

Allows you to specify stdin files that don't exist without getting an error.

-ignoreMissingStdout

Allows you to specify stdout files that don't exist without getting an error.

-injectID

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

-injectName

Set the name of the process for Coverage 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.

-linePragma

Set the line pragma for use with single line code exclusion.

-loadSession

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

-loadSession2

Load a session to be merged with the session that was loaded via -loadSession.

-loadSettings

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

-maxNumRestarts

Sets the maximum number of times a process can restart itself to be monitor by -waitName.

-mergeClearChangeApplication

Reset merge results when the application being tested changes from that used to create the merged session data

-mergeClearEditedFilesOnly

Reset merge results only for source files that have been edited

-mergeClearNone

No clearing of merged session results occurs under any circumstance.

-mergeClearRebuild

Clear all merged session results when any source file is modified (the application changes its timestamp)

-mergeSessions

Merge a previously loaded session (using -loadSession) with the current session just recorded (by the command line arguments to -program, etc).

-mergeToCentralSession

Switch the auto merge feature on or off.

-mergeUsingAddress

Merge coverage data based on symbol addresses

-mergeUsingSymbol

Merge coverage data based on symbol names and symbol filenames

-monitorAllRestarts

Enables the ability to monitor additional runs of the applicaton monitored by -waitName.

-monitorAService

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

-normalStartupThread

This option is obsolete.

-noSuspendInStubDuringAttach

This option is obsolete.

-numSessions

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

-pauseStartupThread

This option is obsolete.

-program

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

-programToMonitorDLL

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

-programToMonitorEXE

-programToMonitor

Specify the program to monitor if monitoring a different application than the launched application.

-programToMonitorLaunchCount

Specify the nth invocation of the programToMonitor which is to have its

data collected.

-pulseToStdout

Output '.' characters to the standard output on a regular basis.

-refreshCoverage

Automatically refresh the Coverage tab once a test is complete.

-refreshFilesAndLines

Automatically refresh the File and Lines tab once a test is complete.

-refreshFunctions

Automatically refresh the Functions tab once a test is complete.

-refreshResults

Automatically refresh the Summary tab once a test is complete.

-resetSettings

Forces Coverage Validator to reset (nearly) all settings to the default state.

-saveMergeResult

Results of a session merge are saved to a file.

-saveSession

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

-setenvironment

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

-settings

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

-showCommandPrompt

Any launched console window will be shown during the test.

-showErrorsWithMessageBox

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

-showMergeWithReport

Specify whether a list of merged files is included in the exported data when an export is performed, and if so, whether to include them at the top or bottom.

-showWindowsErrorReportingUI

Show the Windows Error Reporting user interface if the target program crashes.

-sourceFileFilterHookFile

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

-startPragma

Set the start pragma for use with multi-line code exclusion.

-statisticsConsiderDLLForSource

Code coverage data is collected for each source on a per-DLL basis.

-statisticsIgnoreDLLForSource

Code coverage data is collected for each source regardless of which DLL the source code is compiled into.

-stdin

Name a file to be read and piped to the standard input of the application being tested.

-stdout

Name a file to be written with data piped from the standard output of the application being tested.

-suppressPipeWarnings

Prevent Coverage Validator from displaying an error message box when the stub injected into the launched application cannot find the user interface.

-suspendStartupThread

This option is obsolete.

-terminatePipeWarnings

Force Coverage Validator to shutdown the launched application when the stub injected into the launched application cannot find the user interface.

-waitNameDLL

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

-waitNameEXE

-waitName

Name a process that Coverage Validator will wait for.

 

 

To run 32 bit coverage validator run C:\Program Files (x86)\Software Verify\Coverage Validator x86\coverageValidator.exe

 

To run 64 bit coverage validator run C:\Program Files (x86)\Software Verify\Coverage Validator x64\coverageValidator_x64.exe