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.

-baseline

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

-directory

Set the working directory in which the program is executed.

-displayUI

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

-echoArgsToUser

-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 Thread Validator has finished collecting data from the target program.

-exportAsHTML_BOM
-exportAsXML_BOM

Specify the file encoding for the exported file

-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 Thread Validator user interface during the test.

-injectID

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

-injectName

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

-loadSession

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

-loadSettings

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

-monitorAService

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

-numSessions

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

-program

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

-programToMonitor

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

-programToMonitorLaunchCount

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

-refreshActiveObjects

Automatically refresh the Active Objects tab once a test is complete.

-refreshQuery

Automatically refresh the Query tab once a test is complete.

-refreshCoverage

Automatically refresh the Coverage tab once a test is complete.

-refreshActiveLocks

Automatically refresh the Active Locks tab once a test is complete.

-refreshAllLocks

Automatically refresh the All Locks tab once a test is complete.

-refreshObjectHandles

Automatically refresh the Object Handles tab once a test is complete.

-refreshLocksPerThread

Automatically refresh the Locks Per Thread tab once a test is complete.

-refreshSummary

Automatically refresh the Summary tab once a test is complete.

-refreshThreads

Automatically refresh the Threads tab once a test is complete.

-refreshWaitChain

Automatically refresh the Wait Chain tab once a test is complete.

-resetSettings

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

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

-sessionLoad

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

-setenvironment

Environment variables for Thread 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.

-showErrorsOnCommandPrompt

If an error occurs when launching the application, the error will be reported on the command line.

-showErrorsWithMessageBox

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

-waitName

Name a process that Thread Validator will wait for.