jacoco:dump

Full name:

org.jacoco:jacoco-maven-plugin:0.7.10-SNAPSHOT:dump

Description:

Request a dump over TCP/IP from a JaCoCo agent running in tcpserver mode.

Note concerning parallel builds: While the dump goal as such is thread safe, it has to be considered that TCP/IP server ports of the agents are a shared resource.

Attributes:

Optional Parameters

Name Type Since Description
address String 0.6.4 IP address or hostname to connect to.
User property is: jacoco.address.
append boolean 0.6.4 If set to true and the execution data file already exists, coverage data is appended to the existing file. If set to false, an existing execution data file will be replaced.
Default value is: true.
User property is: jacoco.append.
destFile File 0.6.4 Path to the output file for execution data.
Default value is: ${project.build.directory}/jacoco.exec.
User property is: jacoco.destFile.
dump boolean 0.6.4 Sets whether execution data should be downloaded from the remote host.
Default value is: true.
User property is: jacoco.dump.
excludes List 0.6.4 A list of class files to exclude from instrumentation/analysis/reports. May use wildcard characters (* and ?). When not specified nothing will be excluded.
includes List 0.6.4 A list of class files to include in instrumentation/analysis/reports. May use wildcard characters (* and ?). When not specified everything will be included.
port int 0.6.4 Port number to connect to. If multiple JaCoCo agents should run on the same machine, different ports have to be specified for the agents.
Default value is: 6300.
User property is: jacoco.port.
reset boolean 0.6.4 Sets whether a reset command should be sent after the execution data has been dumped.
Default value is: false.
User property is: jacoco.reset.
retryCount int 0.6.4 Number of retries which the goal will attempt to establish a connection. This can be used to wait until the target JVM is successfully launched.
Default value is: 10.
User property is: jacoco.retryCount.
skip boolean 0.6.4 Flag used to suppress execution.
Default value is: false.
User property is: jacoco.skip.

Parameter Details

address:

IP address or hostname to connect to.

append:

If set to true and the execution data file already exists, coverage data is appended to the existing file. If set to false, an existing execution data file will be replaced.

destFile:

Path to the output file for execution data.

dump:

Sets whether execution data should be downloaded from the remote host.

excludes:

A list of class files to exclude from instrumentation/analysis/reports. May use wildcard characters (* and ?). When not specified nothing will be excluded.

includes:

A list of class files to include in instrumentation/analysis/reports. May use wildcard characters (* and ?). When not specified everything will be included.

port:

Port number to connect to. If multiple JaCoCo agents should run on the same machine, different ports have to be specified for the agents.

reset:

Sets whether a reset command should be sent after the execution data has been dumped.

retryCount:

Number of retries which the goal will attempt to establish a connection. This can be used to wait until the target JVM is successfully launched.

skip:

Flag used to suppress execution.