summaryrefslogtreecommitdiffstats
path: root/doc/man_kxdpgun.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man_kxdpgun.rst')
-rw-r--r--doc/man_kxdpgun.rst25
1 files changed, 23 insertions, 2 deletions
diff --git a/doc/man_kxdpgun.rst b/doc/man_kxdpgun.rst
index 28713ba..bc26d12 100644
--- a/doc/man_kxdpgun.rst
+++ b/doc/man_kxdpgun.rst
@@ -67,6 +67,11 @@ Options
**-i**, **--infile** *filename*
Path to a file with query templates.
+**-B**, **--binary**
+ Specify that input file is in binary format. This format is similar to the
+ TCP DNS message format. The file contains records formated as 2-octet length
+ (network order) followed by a message in DNS wire format.
+
**-I**, **--interface** *interface*
Network interface for outgoing communication. This can be useful in situations
when the interfaces are in a bond for example.
@@ -111,11 +116,20 @@ Options
This option is ignored if not in the QUIC mode. The recommended usage is
with **--quic=R** or with low QPS. Otherwise, too many files are generated.
+**-j**, **--json**
+ Print statistics formatted as json.
+
+**-S**, **--stats-period** *period*
+ Report statistics automatically every *period* milliseconds.
+
+ These reports contain only metrics collected in the given period.
+
**-h**, **--help**
Print the program help.
**-V**, **--version**
- Print the program version.
+ Print the program version. The option **-VV** makes the program
+ print the compile time configuration summary.
Queries file format
...................
@@ -165,7 +179,8 @@ Signals
.......
Sending USR1 signal to a running process triggers current statistics dump
-to the standard output.
+to the standard output. In combination with **-S** may cause erratic printout
+timing.
Notes
-----
@@ -178,6 +193,12 @@ CAP_NET_RAW, CAP_NET_ADMIN, CAP_SYS_ADMIN, CAP_IPC_LOCK, and CAP_SYS_RESOURCE
The utility allocates source UDP/TCP ports from the range 2000-65535.
+Due to the multi-threaded program structure there are slight discrepancies in
+the timespan during which metrics are collected for any given thread. The
+statistics printouts ignore this and are thus ever-so-slightly inaccurate. The
+error margin decreases proportionally to the volume of data & timespan over
+which they are collected.
+
Exit values
-----------