Mark Nellemann
87c8c1f56e
All checks were successful
continuous-integration/drone/push Build is passing
55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
# jnetperf
|
|
|
|
Small utility to measure (single threaded) network performance between two hosts.
|
|
|
|
## Requirements
|
|
|
|
You need Java (JRE) version 8 or later to run jnetperf.
|
|
|
|
## Usage Instructions
|
|
|
|
- Install the jnetperf package (*.deb*, *.rpm* or *.jar*) from [Packages](https://git.data.coop/nellemann/jnetperf/packages) or compile from source.
|
|
- Run **/opt/jnetperf/bin/jperf**, if installed from package, or as **java -jar /path/to/jnetperf.jar**
|
|
|
|
```shell
|
|
Usage: jnetperf [-huV] [-l=SIZE] [-n=NUM] [-p=PORT] (-c=SERVER | -s)
|
|
For more information visit https://git.data.coop/nellemann/jnetperf
|
|
-c, --connect=SERVER Connect to remote server.
|
|
-h, --help Show this help message and exit.
|
|
-l, --pkt-len=SIZE Packet size in bytes [default: 1432].
|
|
-n, --pkt-num=NUM Number of packets to send [default: 150000].
|
|
-p, --port=PORT Network port [default: 4445].
|
|
-s, --server Run server and wait for client.
|
|
-u, --udp Use UDP network protocol [default: false].
|
|
-V, --version Print version information and exit.
|
|
```
|
|
|
|
|
|
## Examples
|
|
|
|
On *host A* run jnetperf as a server waiting for a connection from a client:
|
|
|
|
```shell
|
|
java -jar jnetperf-x.y.z-all.jar -s
|
|
```
|
|
|
|
On *host B* run jnetperf as a client connecting to the server and sending data:
|
|
|
|
```shell
|
|
java -jar jnetperf-x.y.z-all.jar -c server-ip
|
|
```
|
|
|
|
|
|
## Development Information
|
|
|
|
You need Java (JDK) version 8 or later to build jnetperf.
|
|
|
|
|
|
### Build & Test
|
|
|
|
Use the gradle build tool, which will download all required dependencies:
|
|
|
|
```shell
|
|
./gradlew clean build
|
|
```
|