dotCover 2023.3 Help

Command Reference

dotCover command-line tool provides the following commands:

  • cover - Perform coverage analysis of the specified application.

  • cover-dotnet (dotnet) - Performs coverage analysis of the 'dotnet' executable installed in the system.

  • cover-mono (mono) - Performs coverage analysis of the 'mono' executable installed in the system.

  • cover-everything - All-in-one task. Performs coverage analysis of all .NET processes that are started after dotCover.exe.

  • cover-service - All-in-one task. Performs coverage analysis of the specified Windows service.

  • cover-iis - All-in-one task. Performs coverage analysis of a web application running on a IIS server.

  • delete - Deletes all files related to the specified snapshots.

  • help - Shows command-line tool help.

  • list - Obtains the list of all files related to the specified snapshots.

  • merge - Merges several coverage snapshots.

  • report - Creates a report for the specified snapshot.

  • version - Writes dotCover version info to the specified file.

  • zip - Compresses coverage snapshot.

  • send - Sends a command to the specified dotCover.exe instance.

You can learn everything about each command right in the console by typing help followed by the command name. All commands (including help) have corresponding shortcuts. For instance, to get information about the analyse command, we can type:

dotCover.exe help cover
or
dotCover h c

cover

cover: Performs coverage analysis of the specified application usage: dotCover cover|c <parameters> [-- <target arguments>] Valid parameters: --TargetExecutable=ARG : (Required) Filename of the program to analyze --TargetArguments=ARG : (Optional) Program arguments. You can omit the parameter by specifying arguments after double dash (--) at the end of the command line. For example: -- arg1 arg2 arg3 --TargetWorkingDir=ARG : (Optional) Program working directory. By default, it is the directory of the target executable --TempDir=ARG : (Optional) Directory for auxiliary files. Set to the system temp by default --Output=ARG : (Required) Path to the resulting coverage snapshot/report --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXML]. Specify to get a report of a certain type instead of a snapshot. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional, works only if --ReportType is specified) Remove specified files from report. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --InheritConsole=ARG : (Optional) [True|False] Lets the application being analyzed to inherit dotCover console. True by default Please note that windows of analyzed GUI application will not be hidden if the console is inherited --AnalyzeTargetArguments=ARG : (Optional) [True|False] Specifies whether dotCover should analyze target arguments string and convert relative paths to absolute there. True by default --Scope : (Optional) Allows including not loaded assemblies in the specified scope into coverage results. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.dll) --Filters=ARG : (Optional) Specifies coverage filters. Syntax (use fully qualified names): +:module=*;class=*;function=*; Use -:myassembly to exclude an assembly from code coverage. Asterisk wildcard (*) is supported --AttributeFilters=ARG : (Optional) Specifies attribute filters. Syntax: filter1;filter2;... Asterisk wildcard (*) is supported --DisableDefaultFilters : (Optional) Disables default (automatically added) filters --SymbolSearchPaths=ARG : (Optional) Specifies additional symbol search paths. Paths to symbol servers (starting with srv* prefix) are supported here. Values are separated with semicolon --AllowSymbolServerAccess : (Optional) Allows dotCover to search for PDB files on a symbol server --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --ReturnTargetExitCode : (Optional) Returns the exit code of the target executable in case coverage analysis succeeded --ProcessFilters=ARG : (Optional) Specifies process filters. Syntax: +:process1;-:process2;... Asterisk wildcard (*) is supported here --UseApi=ARG : (Optional) [True|False] Whether to use CoverageProfiler Api. False by default --RemoteApiEndpoint=ARG : (Optional) Endpoint for RemoteApi feature. Syntax: IPv4Address:Port --DisableNGen : (Optional) Disables NGen images loading --StartInstance=ARG : (Optional) Starts new dotCover.exe instance in the background and waits until it is initialized. ARG is the instance ID. Use this ID to send commands to this dotCover.exe instance --Instance=ARG : (Optional) Assigns an instance ID to the current dotCover.exe instance. Use this ID to send commands to this dotCover.exe instance --CoverImmediately=ARG : (Optional) [True|False] Specifies whether to start coverage analysis immediately after launch. Use --CoverImmediately=False to defer coverage analysis (to start the analysis, send the corresponding command to this dotCover.exe instance). True by default --StartInstanceTimeout=ARG : (Optional) Timeout in seconds for the --StartInstance parameter. Default is 20 --IncludePerTestInfo=ARG : (Optional) [Assembly | Namespace | Type | Method] Collect per-test coverage info. Works only for the following executables: dotnet test, dotnet vstest, vstest.console.exe. ARG is optional and is used only if you generate a report with --ReportType. The ARG values define with which level of detail the per-test info is shown in the report. Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log filename --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover cover <configuration filename> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help cover <configuration filename>

cover-dotnet

cover-dotnet: Performs coverage analysis of the 'dotnet' executable installed in the system. This command is equivalent to 'dotCover cover --TargetExecutable="<path_to_dotnet_executable>"' usage: dotCover cover-dotnet|dotnet <parameters> [-- <target arguments>] Valid parameters: --TargetArguments=ARG : (Required) dotnet command line arguments. You can omit the parameter by specifying the arguments after double dash (--) at the end of the command line. For example: -- arg1 arg2 arg3 --TargetWorkingDir=ARG : (Optional) Program working directory. By default, it is the current directory from which you start coverage analysis --TempDir=ARG : (Optional) Directory for auxiliary files. Set to the system temp by default --Output=ARG : (Required) Path to the resulting coverage snapshot/report --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXML]. Specify to get a report of a certain type instead of a snapshot. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional, works only if --ReportType is specified) Remove specified files from report. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --InheritConsole=ARG : (Optional) [True|False] Lets the application being analyzed to inherit dotCover console. True by default Please note that windows of analyzed GUI application will not be hidden if the console is inherited --AnalyzeTargetArguments=ARG : (Optional) [True|False] Specifies whether dotCover should analyze target arguments string and convert relative paths to absolute there. True by default --Scope : (Optional) Allows including not loaded assemblies in the specified scope into coverage results. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.dll) --Filters=ARG : (Optional) Specifies coverage filters. Syntax (use fully qualified names): +:module=*;class=*;function=*; Use -:myassembly to exclude an assembly from code coverage. Asterisk wildcard (*) is supported here --AttributeFilters=ARG : (Optional) Specifies attribute filters. Syntax: filter1;filter2;... Asterisk wildcard (*) is supported here --DisableDefaultFilters : (Optional) Disables default (automatically added) filters --SymbolSearchPaths=ARG : (Optional) Specifies additional symbol search paths. Paths to symbol servers (starting with srv* prefix) are supported here. Values are separated with semicolon --AllowSymbolServerAccess : (Optional) Allows dotCover to search for PDB files on a symbol server --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --ReturnTargetExitCode : (Optional) Returns the exit code of the target executable in case coverage analysis succeeded --ProcessFilters=ARG : (Optional) Specifies process filters. Syntax: +:process1;-:process2;... Asterisk wildcard (*) is supported here --UseApi=ARG : (Optional) [True|False] Whether to use CoverageProfiler Api. False by default --RemoteApiEndpoint=ARG : (Optional) Endpoint for RemoteApi feature. Syntax: IPv4Address:Port --DisableNGen : (Optional) Disables NGen images loading --StartInstance=ARG : (Optional) Starts new dotCover.exe instance in the background and waits until it is initialized. ARG is the instance ID. Use this ID to send commands to this dotCover.exe instance --Instance=ARG : (Optional) Assigns an instance ID to the current dotCover.exe instance. Use this ID to send commands to this dotCover.exe instance --CoverImmediately=ARG : (Optional) [True|False] Specifies whether to start coverage analysis immediately after launch. Use --CoverImmediately=False to defer coverage analysis (to start the analysis, send the corresponding command to this dotCover.exe instance). True by default --StartInstanceTimeout=ARG : (Optional) Timeout in seconds for the --StartInstance parameter. Default is 20 --IncludePerTestInfo=ARG (Optional) [Assembly | Namespace | Type | Method] Collect per-test coverage info. Works only for the 'test' and 'vstest' commands. ARG is optional and is used only if you generate a report with --ReportType. The ARG values define with which level of detail the per-test info is shown in the report. Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover cover-dotnet <configuration file name> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help cover-dotnet <configuration file name>

cover-mono

cover-mono: Performs coverage analysis of the 'mono' executable installed in the system. This command is equivalent to 'dotCover cover --TargetExecutable="<path_to_mono_executable>"' usage: dotCover cover-mono|mono <parameters> [-- <target arguments>] Valid parameters: --TargetArguments=ARG : (Required) 'mono' command line arguments. You can omit the parameter by specifying the arguments after double dash (--) at the end of the command line. For example: -- arg1 arg2 arg3 --TargetWorkingDir=ARG : (Optional) Program working directory. By default, it is the current directory from which you start coverage analysis --TempDir=ARG : (Optional) Directory for auxiliary files. Set to the system temp by default --Output=ARG : (Required) Path to the resulting coverage snapshot/report --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXML]. Specify to get a report of a certain type instead of a snapshot. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional, works only if --ReportType is specified) Remove specified files from report. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --InheritConsole=ARG : (Optional) [True|False] Lets the application being analyzed to inherit dotCover console. True by default Please note that windows of analyzed GUI application will not be hidden if the console is inherited --AnalyzeTargetArguments=ARG : (Optional) [True|False] Specifies whether dotCover should analyze target arguments string and convert relative paths to absolute there. True by default --Scope : (Optional) Allows including not loaded assemblies in the specified scope into coverage results. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.dll) --Filters=ARG : (Optional) Specifies coverage filters. Syntax (use fully qualified names): +:module=*;class=*;function=*; Use -:myassembly to exclude an assembly from code coverage. Asterisk wildcard (*) is supported here --AttributeFilters=ARG : (Optional) Specifies attribute filters. Syntax: filter1;filter2;... Asterisk wildcard (*) is supported here --DisableDefaultFilters : (Optional) Disables default (automatically added) filters --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --ReturnTargetExitCode : (Optional) Returns the exit code of the target executable in case coverage analysis succeeded --ProcessFilters=ARG : (Optional) Specifies process filters. Syntax: +:process1;-:process2;... Asterisk wildcard (*) is supported here --UseApi=ARG : (Optional) [True|False] Whether to use CoverageProfiler Api. False by default --StartInstance=ARG : (Optional) Starts new dotCover.exe instance in the background and waits until it is initialized. ARG is the instance ID. Use this ID to send commands to this dotCover.exe instance --Instance=ARG : (Optional) Assigns an instance ID to the current dotCover.exe instance. Use this ID to send commands to this dotCover.exe instance --CoverImmediately=ARG : (Optional) [True|False] Specifies whether to start coverage analysis immediately after launch. Use --CoverImmediately=False to defer coverage analysis (to start the analysis, send the corresponding command to this dotCover.exe instance). True by default --StartInstanceTimeout=ARG : (Optional) Timeout in seconds for the --StartInstance parameter. Default is 20 Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover cover-mono <configuration filename> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help cover-mono <configuration filename>

cover-everything

cover-everything: Performs coverage analysis of all .NET processes started after dotCover usage: dotCover cover-everything|ce <parameters> Valid parameters: --StartInstance=ARG : (Required) Starts new dotCover.exe instance in the background and waits until it is initialized. ARG is the instance ID. Use this ID to send commands to this dotCover.exe instance. Not required if --Instance is specified --Instance=ARG : (Required) Assigns an instance ID to the current dotCover.exe instance. Use this ID to send commands to this dotCover.exe instance. Not required if --StartInstance is specified --CoverImmediately=ARG : (Optional) [True|False] Specifies whether to start coverage analysis immediately after launch. Use --CoverImmediately=False to defer coverage analysis (to start the analysis, send the corresponding command to this dotCover.exe instance). True by default --StartInstanceTimeout=ARG : (Optional) Timeout in seconds for the --StartInstance parameter. Default is 20 --Output=ARG : (Required) Path to the resulting coverage snapshot/report --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXML]. Specify to get a report of a certain type instead of a snapshot. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional, works only if --ReportType is specified) Remove specified files from report. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --TempDir=ARG : (Optional) Directory for auxiliary files. Set to the system temp by default --Scope : (Optional) Allows including not loaded assemblies in the specified scope into coverage results. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.dll) --Filters=ARG : (Optional) Specifies coverage filters. Syntax (use fully qualified names): +:module=*;class=*;function=*; Use -:myassembly to exclude an assembly from code coverage. Asterisk wildcard (*) is supported here --AttributeFilters=ARG : (Optional) Specifies attribute filters. Syntax: filter1;filter2;... Asterisk wildcard (*) is supported here --DisableDefaultFilters : (Optional) Disables default (automatically added) filters --SymbolSearchPaths=ARG : (Optional) Specifies additional symbol search paths. Paths to symbol servers (starting with srv* prefix) are supported here. Values are separated with semicolon --AllowSymbolServerAccess : (Optional) Allows dotCover to search for PDB files on a symbol server --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --ProcessFilters=ARG : (Optional) Specifies process filters. Syntax: +:process1;-:process2;... Asterisk wildcard (*) is supported here --DisableNGen : (Optional) Disables NGen images loading Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover cover-everything <configuration filename> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help cover-everything <configuration filename>

cover-service

cover-service: Performs coverage analysis of the specified Windows Service usage: dotCover cover-service|cs <parameters> Valid parameters: --ServiceName=ARG : (Required) Name of the service to analyze --ServiceArguments=ARG : (Optional) Service arguments --StartDependentServices=ARG : (Optional) [True|False] Specifies whether dependent services must be started. False by default --TempDir=ARG : (Optional) Directory for auxiliary files. Set to the system temp by default --Output=ARG : (Required) Path to the resulting coverage snapshot/report --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXML]. Specify to get a report of a certain type instead of a snapshot. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional, works only if --ReportType is specified) Remove specified files from report. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --AnalyzeServiceArguments=ARG : (Optional) [True|False] Specifies whether dotCover should analyze arguments string and convert relative paths to absolute there. True by default --Scope : (Optional) Allows including not loaded assemblies in the specified scope into coverage results. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.dll) --Filters=ARG : (Optional) Specifies coverage filters. Syntax (use fully qualified names): +:module=*;class=*;function=*; Use -:myassembly to exclude an assembly from code coverage. Asterisk wildcard (*) is supported here --AttributeFilters=ARG : (Optional) Specifies attribute filters. Syntax: filter1;filter2;... Asterisk wildcard (*) is supported here --DisableDefaultFilters : (Optional) Disables default (automatically added) filters --SymbolSearchPaths=ARG : (Optional) Specifies additional symbol search paths. Paths to symbol servers (starting with srv* prefix) are supported here. Values are separated with semicolon --AllowSymbolServerAccess : (Optional) Allows dotCover to search for PDB files on a symbol server --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --UseApi=ARG : (Optional) [True|False] Whether to use CoverageProfiler Api. False by default --RemoteApiEndpoint=ARG : (Optional) Endpoint for RemoteApi feature. Syntax: IPv4Address:Port --DisableNGen : (Optional) Disables NGen images loading --StartInstance=ARG : (Optional) Starts new dotCover.exe instance in the background and waits until it is initialized. ARG is the instance ID. Use this ID to send commands to this dotCover.exe instance --Instance=ARG : (Optional) Assigns an instance ID to the current dotCover.exe instance. Use this ID to send commands to this dotCover.exe instance --CoverImmediately=ARG : (Optional) [True|False] Specifies whether to start coverage analysis immediately after launch. Use --CoverImmediately=False to defer coverage analysis (to start the analysis, send the corresponding command to this dotCover.exe instance). True by default --StartInstanceTimeout=ARG : (Optional) Timeout in seconds for the --StartInstance parameter. Default is 20 Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover cover-service <configuration filename> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help cover-service <configuration filename>

cover-iis

cover-iis: Performs coverage analysis of IIS usage: dotCover cover-iis|iis <parameters> Valid parameters: --TempDir=ARG : (Optional) Directory for auxiliary files. Set to the system temp by default --Output=ARG : (Required) Path to the resulting coverage snapshot/report --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXML]. Specify to get a report of a certain type instead of a snapshot. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional, works only if --ReportType is specified) Remove specified files from report. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --Scope : (Optional) Allows including not loaded assemblies in the specified scope into coverage results. The parameter is a semicolon-separated list of file path masks. Ant-style patterns are supported here (e.g. ProjectFolder/**/*.dll) --Filters=ARG : (Optional) Specifies coverage filters. Syntax (use fully qualified names): +:module=*;class=*;function=*; Use -:myassembly to exclude an assembly from code coverage. Asterisk wildcard (*) is supported here --AttributeFilters=ARG : (Optional) Specifies attribute filters. Syntax: filter1;filter2;... Asterisk wildcard (*) is supported here --DisableDefaultFilters : (Optional) Disables default (automatically added) filters --SymbolSearchPaths=ARG : (Optional) Specifies additional symbol search paths. Paths to symbol servers (starting with srv* prefix) are supported here. Values are separated with semicolon --AllowSymbolServerAccess : (Optional) Allows dotCover to search for PDB files on a symbol server --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --UseApi=ARG : (Optional) [True|False] Whether to use CoverageProfiler Api. False by default --RemoteApiEndpoint=ARG : (Optional) Endpoint for RemoteApi feature. Syntax: IPv4Address:Port --DisableNGen : (Optional) Disables NGen images loading --StartInstance=ARG : (Optional) Starts new dotCover.exe instance in the background and waits until it is initialized. ARG is the instance ID. Use this ID to send commands to this dotCover.exe instance --Instance=ARG : (Optional) Assigns an instance ID to the current dotCover.exe instance. Use this ID to send commands to this dotCover.exe instance --CoverImmediately=ARG : (Optional) [True|False] Specifies whether to start coverage analysis immediately after launch. Use --CoverImmediately=False to defer coverage analysis (to start the analysis, send the corresponding command to this dotCover.exe instance). True by default --StartInstanceTimeout=ARG : (Optional) Timeout in seconds for the --StartInstance parameter. Default is 20 Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover cover-iis <configuration file name> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help cover-iis <configuration file name>

delete

delete: Delete all files related to the specified snapshots usage: dotCover delete|d <parameters> Valid parameters: --Source=ARG : (Required) List of snapshot files separated with semicolon (;) Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover delete <configuration filename> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help delete <configuration filename>

help

help: Show command-line tool help. Type 'dotCover help <command>' for help on a specific command, parameters and configuration xml format Type 'dotCover help <command> <file name>' to write configuration xml example to the specified file

list

list: Obtain the list of all files related to the specified snapshots usage: dotCover list|l <parameters> Valid parameters: --Source=ARG : (Required) List of snapshot files separated with semicolon (;) --Output=ARG : (Required) Resulting file name. Stores plain list of all snapshot files Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover list <configuration file name> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help list <configuration file name>

merge

merge: Merge several coverage snapshots usage: dotCover merge|m <parameters> Valid parameters: --Source=ARG : (Required) List of snapshots separated with semicolon (;) --Output=ARG : (Required) File name for the merged snapshot --TempDir=ARG : (Optional) Directory for the auxiliary files. Set to system temp by default Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover merge <configuration file name> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help merge <configuration file name>

report

report: Creates a report by the specified snapshot usage: dotCover report|r <parameters> Valid parameters: --Source=ARG : (Required) Coverage snapshot file name --Output=ARG : (Required) Resulting report file name. For multiple reports, specify a list of files separated by semicolon ( ; ) --ReportType=ARG : (Optional) [HTML|JSON|XML|DetailedXML|NDependXML|SummaryXMl]. A type of the report. XML by default. For multiple reports, specify a list of report types separated by comma (,) --HideAutoProperties : (Optional) Remove auto-implemented properties from report --ExcludeFileMasks : (Optional) Remove specified files from report. The parameter is a list of file path masks separated by semicolon ( ; ). Ant-style patterns are supported here (e.g. ProjectFolder/**/*.generated.cs) --GroupNamespaces : (Optional, works only if --ReportType=XML|HTML|JSON is specified) Group namespaces in report --SourcesSearchPaths=ARG : (Optional, works only if --ReportType=HTML is specified) Specifies path(s) to the source code. Use it if the real code location path differs from the path specified in .pdb files. Values are separated by semicolon ( ; ) --AllowSourceServersAccess : (Optional, works only if --ReportType=HTML is specified) Allows downloading the source code from source servers --IncludePerTestInfo=ARG : (Optional, works only if --ReportType=XML|JSON is specified)[Assembly|Namespace|Type|Method] Include per-test coverage info in reports Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify part of the parameters or all of them in the configuration file. usage: dotCover report <configuration file name> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help report <configuration file name>

version

version: Writes dotCover version info to the specified file usage: dotCover version|v [<output file name>] [<parameters>] Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe

zip

zip: Compresses coverage snapshot usage: dotCover zip|z <parameters> Valid parameters: --Source=ARG : (Required) Coverage snapshot file name --Output=ARG : (Required) Zipped snapshot file name Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name --UseEnvVarsInPaths=ARG : (Optional) [True|False] Allows using environment variables (for example, %TEMP%) in paths. True by default Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe It is possible to specify a part of the parameters or all of them in the configuration file. usage: dotCover zip <configuration file name> [parameters] Configuration file format is described in the autogenerated sample. usage: dotCover help zip <configuration file name>

send

send: Send command to dotCover instance usage: dotCover send|s <parameters> Valid parameters: --Instance=ARG : (Required) ID of the target dotCover.exe instance --Command=ARG : (Required) [Cover|Pause|GetSnapshotAndKillChildren] Command to send Cover - Start coverage analysis Pause - Pause coverage analysis GetSnapshotAndKillChildren - Saves current coverage data, kill all profiled processes and stop instance --Timeout=ARG : (Optional) Timeout in seconds for command execution. Default is 10 Global parameters: --LogFile=ARG : (Optional) Enables logging and allows specifying a log file name Notes: * Parameters are case-insensitive. * Slash (/) and double dash (--) can be used to specify a parameter. * Equals sign (=) and colon (:) can be used to specify parameter value. For example, the following is equivalent: /TargetExecutable=MyApp.exe --targetexecutable:MyApp.exe
Last modified: 01 December 2023