dbus-test-tool — D-Bus traffic generator and test tool
dbus-test-tool black-hole [ --session | --system ] [--name=NAME] [--no-read]
dbus-test-tool echo [ --session | --system ] [--name=NAME] [--sleep-ms=MS]
dbus-test-tool spam [ --session | --system ] [--dest=NAME] [--count=N] [--flood] [--ignore-errors] [--messages-per-conn=N] [--no-reply] [--queue=N] [--seed=SEED] [ --string | --bytes | --empty ] [ --payload=S | --stdin | --message-stdin | --random-size ]
dbus-test-tool is a multi-purpose tool for debugging and profiling D-Bus.
dbus-test-tool black-hole connects to D-Bus, optionally requests a name, then does not reply to messages. It normally reads and discards messages from its D-Bus socket, but can be configured to sleep forever without reading.
dbus-test-tool echo connects to D-Bus, optionally requests a name, then sends back an empty reply to every method call, after an optional delay.
dbus-test-tool spam
connects to D-Bus and makes repeated method calls,
normally named com.example.Spam.
--sessionConnect to the session bus. This is the default.
--systemConnect to the system bus.
--name=NAMEBefore proceeding, request ownership of the well-known
bus name NAME, for example
com.example.NoReply. By default,
no name is requested, and the tool can only be addressed by
a unique bus name such as :1.23.
--no-readDo not read from the D-Bus socket.
--name=NAMEBefore proceeding, request ownership of the well-known
bus name NAME, for example
com.example.Echo. By default,
no name is requested, and the tool can only be addressed by
a unique bus name such as :1.23.
--sleep-ms=MSBlock for MS milliseconds
before replying to a method call.
--dest=NAMESend method calls to the well-known or unique
bus name NAME.
The default is the dbus-daemon,
org.freedesktop.DBus.
--count=NSend N method calls in total.
The default is 1.
--queue=NSend N method calls before
waiting for any replies, then send one new call per reply
received, keeping N method calls
"in flight" at all times until the number of messages specified
with the --count option have been sent.
The default is 1, unless --flood
is used.
--floodSend all messages without waiting for a reply,
equivalent to --queue with an arbitrarily
large N.
--no-replySet the "no reply desired" flag on the messages.
This implies --flood, since it disables
the replies that would be used for a finite
--queue length.
--messages-per-conn=NIf given, send N method calls
on the same connection, then disconnect and reconnect.
The default is to use the same connection for all method
calls.
--stringThe payload of each message is a UTF-8 string. This is the
default. The actual string used is given by the
--payload or --stdin
option, defaulting to "hello, world!".
--bytesThe payload of each message is a byte-array.
The actual bytes used are given by the
--payload or --stdin
option, defaulting to the ASCII encoding of
"hello, world!".
--emptyThe messages have no payload.
--payload=SUse S as the
--string or --bytes
in the messages. The default is "hello, world!".
--stdinRead from standard input until end-of-file is reached,
and use that as the --string or
--bytes in the messages.
--message-stdinRead a complete binary D-Bus method call message from standard input, and use that for each method call.
--random-sizeRead whitespace-separated ASCII decimal numbers from standard input, choose one at random for each message, and send a message whose payload is a string of that length.
--seed=SEEDUse SEED as the seed
for the pseudorandom number generator, to have somewhat
repeatable sequences of random messages.
Please send bug reports to the D-Bus bug tracker or mailing list. See https://www.freedesktop.org/wiki/Software/dbus/.