gnunet-tbench - transport profiling tool

gnunet-tbench [OPTIONS]

gnunet-tbench can be used to test the performance of the GNUnet core (link-to-link encryption and the available transport services). gnunet-tbench is useless to most ordinary users since its primary function is to test the performance and correctness of GNUnet transport service implementations.

gnunet-tbench sends a sequence of messages to another peer that has the tbench module loaded. The service then measures the throughput, latency and loss of the messages round-trip. gnunet-tbench can only be used to test a direct peer-to-peer connection. You must load the tbench module (via the configuration gnunet.conf, section GNUNETD under APPLICATIONS) in each of the two peers before gnunet-tbench can be used.

The two peers must know of each other and be connected (use gnunet-stats to test for connections). Typically, gnunet-tbench reports the time it took to sent all specified messages and the percentage of messages lost.

-r RECEIVER, --rec=RECEIVER use this option to specify the identity of the RECEIVER peer that is used for the benchmark. This option is required.

-h, --help

print help page

-c FILENAME, --config=FILENAME

load config file (defaults: ~/.gnunet/gnunet.conf)

-v, --version

print the version number

-n MESSAGES, --msg=MESSAGES

how many messages should be used in each iteration (used to compute average, min, max, etc.)

-s SIZE --size=SIZE

test using the specified message size

-i ITER --iterations=ITER

perform ITER iterations of the benchmark

-t TIMEOUT --timeout=IMEOUT

wait TIMEOUT milli-seconds for replies to arrive before aborting

-S SPACE --space=PACE

use SPACE milli-seconds of delays between trains of messages

-X COUNT --xspace=OUNT

use trains of COUNT messages -g --gnuplot create output in two colums suitable for gnuplot. When using this option, concatenate the output of multiple runs with various options into a file 'tbench' and run the following gnuplot script to visualize the time/loss ratio:

set xlabel "time"

set ylabel "percent transmitted" plot "tbench" title 'Transport benchmarking' with points

gnunet-tbench can run for a long time, depending on how high you have set the numbers. Run first with small numbers to get an initial estimate on the runtime.

~/.gnunet/gnunet.conf

Users GNUnet configuration file

Report bugs by using mantis <https://gnunet.org/mantis/> or by sending electronic mail to <gnunet-developers@gnu.org>

gnunet.conf(5), gnunetd(1)