Please enable JavaScript to view this site.

Memory Validator Help

 

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 previous session as the baseline session against which the recorded session is compared for regressions or improvements.

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

-compareUseBaselineFilters

Apply the filters loaded using -sessionFilters to the baseline session.

-compareUseGlobalFilters

Apply the filters loaded using -globalFilters to the baseline session and the comparison session.

-createProcessStartupThread

Obsolete and ignored if present.

-directory

Set the working directory in which the program is executed.

-displayUI

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

-dllHookFile

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

-doNotInteractWithUser

Never display dialog boxes (including error 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

-exportAsHTML
-exportAsXML

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

-exportAsHTML_BOM
-exportAsXML_BOM

Specify the file encoding for the exported file

-exportSessionLeakedObjectsHTML
-exportSessionLeakedObjectsXML

Export the data on the Types tab as an HTML or XML file when Memory Validator has finished collecting data from the target program. Only data for objects with a non-zero Count value is exported.

-exportSessionObjectsHTML
-exportSessionObjectsXML

Exports the data on the Types tab as an HTML or XML file when Memory Validator has finished collecting data from the target program.

-fileLocations

Specify a plain text file listing file locations to be used during testing.

-exportSessionObjectsHTML
-exportSessionObjectsXML

When the session objects are exported to an HTML or XML file, output is filtered using the filters loaded using -globalFilters.

-flatXMLSessionCompareExport

Use the old style XML report without the <EVENT> tag when exporting the results of a session comparison.

-flatXMLSessionExport  

Use the old style (flat) XML report without the <EVENT> tag.

-globalFilters

Specify filters to be applied to the sessions loaded for the regression test.

-help

Print command line help on the standard output.

-hideUI

Hide the Memory Validator user interface during the test.

-htmlAllocMemory

Include allocated memory data in the export.

-htmlDetailedReport

Include Thread ID and Timestamp information as additional data.

-htmlDoColourCode

Make the HTML export colour coded.

-htmlErrorFilter

Apply filters (session or global) to data for error conditions.

-htmlErrors

Include data describing error conditions.

-htmlErrorStackTrace

Include stack traces for error conditions.

-htmlFreeMemory

Include free memory data in the export

-htmlHandleFilter

Apply filters (session or global) to data for handle allocations.

-htmlHandles

Include data describing handle allocations.

-htmlHandleStackTrace

Include stack traces for handle allocations.

-htmlLeaksOnly

Only include information about leaked data.

-htmlMemory

Include data describing memory allocations.

-htmlMemoryFilter

Apply filters (session or global) to data memory allocations.

-htmlMemoryStackTrace

Include stack traces for memory allocations.

-htmlReAllocMemory

Include reallocated memory data in the export.

-htmlTrace

Include data describing TRACE and OutputDebugString information.

-htmlTraceFilter

Apply filters (session or global) to data for trace information.

-htmlTraceStackTrace

Include stack traces for trace information.

-idleStartupThread

Obsolete and ignored if present.

-injectID

Set the numeric id of a process for Memory Validator to attach to.

-injectName

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

-launchAppHidden

Hide the target application during the test.

-monitorAService

Specify the full file system path to the service to monitor with Memory Validator, including any extension. The service is not started by Memory Validator but my 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 Memory 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 Memory Validator initially launches.

-programToMonitorLaunchCount

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

data collected.

-refreshAnalysis

Automatically refresh the Analysis tab in Memory Validator once a test is complete.

-refreshHotspot

Automatically refresh the Hotspots tab in Memory Validator once a test is complete.

-refreshMemory

Automatically refresh the Memory tab in Memory Validator once a test is complete.

-refreshObjects

Automatically refresh the Types tab in Memory Validator once a test is complete

-refreshPages

Automatically refresh the Pages tab in Memory Validator 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 regression and improvements.

-sessionFilters

Specify filters to be applied to the sessions loaded for the regression test.

-sessionLoad

Load a previously created session to act as the comparison session and which will be compared against a baseline session, for regression testing.

-showErrorsWithMessageBox

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

-setenvironment

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

-settings

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

-suspendStartupThread

Obsolete and ignored if present.

-waitNameDLL

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

-waitNameEXE

-waitName

Set the name of a process that Memory Validator will wait for.

-xmlAllocMemory

Include allocated memory data in the export.

-xmlDetailedReport

Include Thread ID and Timestamp information as additional data.

-xmlErrorFilter

Apply filters (session or global) to data for error conditions.

-xmlErrors

Include data describing error conditions.

-xmlErrorStackTrace

Include stack traces for error conditions.

-xmlFreeMemory

Include free memory data in the export.

-xmlHandleFilter

Apply filters (session or global) to data for handle allocations.

-xmlHandles

Include data describing handle allocations.

-xmlHandleStackTrace

Include stack traces for handle allocations.

-xmlLeaksOnly

Only include information about leaked data.

-xmlMemory

Include data describing memory allocations.

-xmlMemoryFilter

Apply filters (session or global) to data memory allocations.

-xmlMemoryStackTrace

Include stack traces for memory allocations.

-xmlReAllocMemory

Include reallocated memory data in the export.

-xmlTrace

Include data describing TRACE and OutputDebugString informationApply.

-xmlTraceFilter

Apply filters (session or global) to data for trace information.

-xmlTraceStackTrace

Include stack traces for trace information.

 

 

To run 32 bit memory validator run C:\Program Files (x86)\Software Verify\Memory Validator x86\memoryValidator.exe

 

To run 64 bit memory validator run C:\Program Files (x86)\Software Verify\Memory Validator x64\memoryValidator_x64.exe