jacoco:dump
Full name:
org.jacoco:jacoco-maven-plugin:0.7.1.201405082137: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:
- Requires a Maven project to be executed.
- The goal is thread-safe and supports parallel builds.
- Since version:
0.6.4
. - Binds by default to the lifecycle phase:
post-integration-test
.
Optional Parameters
Name | Type | Since | Description |
address |
String
|
0.6.4
|
IP address or hostname to connect to. |
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 . |
destFile |
File
|
0.6.4
|
Path to the output file for execution data. Default value is: ${project.build.directory}/jacoco.exec . |
dump |
boolean
|
0.6.4
|
Sets whether execution data should be downloaded from the remote
host. Default value is: true . |
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 . |
reset |
boolean
|
0.6.4
|
Sets whether a reset command should be sent after the execution
data has been dumped. Default value is: false . |
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 . |
skip |
boolean
|
0.6.4
|
Flag used to suppress execution. Default value is: false . |
Parameter Details
IP address or hostname to connect to.
-
Type:
java.lang.String
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.address}
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.
-
Type:
boolean
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.append}
-
Default:
true
Path to the output file for execution data.
-
Type:
java.io.File
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.destFile}
-
Default:
${project.build.directory}/jacoco.exec
dump:
Sets whether execution data should be downloaded from the remote
host.
-
Type:
boolean
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.dump}
-
Default:
true
A list of class files to exclude from
instrumentation/analysis/reports. May use wildcard characters (*
and ?). When not specified nothing will be excluded.
-
Type:
java.util.List
-
Since:
0.6.4
-
Required:
No
A list of class files to include in
instrumentation/analysis/reports. May use wildcard characters (*
and ?). When not specified everything will be included.
-
Type:
java.util.List
-
Since:
0.6.4
-
Required:
No
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.
-
Type:
int
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.port}
-
Default:
6300
Sets whether a reset command should be sent after the execution
data has been dumped.
-
Type:
boolean
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.reset}
-
Default:
false
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.
-
Type:
int
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.retryCount}
-
Default:
10
skip:
Flag used to suppress execution.
-
Type:
boolean
-
Since:
0.6.4
-
Required:
No
-
Expression:
${jacoco.skip}
-
Default:
false