Linux Certif

Toute la documentation sur la certification Linux LPI

gnunet-tbench

NAME

gnunet-tbench - transport profiling tool

SYNOPSIS

gnunet-tbench [OPTIONS]

DESCRIPTION

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 gnunetd.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.

-c FILENAME, --config=FILENAME

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

-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

-h, --help

print help page

-L LOGLEVEL, --loglevel=LOGLEVEL

Change the loglevel. Possible values for LOGLEVEL are NOTHING, FATAL, ERROR, WARNING, INFO, STATUS and DEBUG. Note that options in the configuration file take precedence over this option (the argument will be ignored in that case).

-i ITER --iterations=ITER

perform ITER iterations of the benchmark

-n MESSAGES, --msg=MESSAGES

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

-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.

-s SIZE --size=SIZE

test using the specified message size

-S SPACE --space=PACE

use SPACE milli-seconds of delays between trains of messages

-t TIMEOUT --timeout=IMEOUT

wait TIMEOUT milli-seconds for replies to arrive before aborting

-v, --version

print the version number

-X COUNT --xspace=OUNT

use trains of COUNT messages

NOTES

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.

FILES

~/.gnunet/gnunet.conf

Users GNUnet configuration file

REPORTING BUGS

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

SEE ALSO

gnunet.conf(5), gnunetd(1)