bustle: Draw pretty sequence diagrams of D-Bus traffic

[ desktop, lgpl, network, program ] [ Propose Tags ]

Draw pretty sequence diagrams of D-Bus traffic

[Skip to Readme]


Automatic Flags

Build interactive test programs


Build with the multi-threaded runtime


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Versions [RSS] 0.4.3, 0.4.4, 0.4.5, 0.4.6, 0.4.7, 0.4.8, 0.5.0, 0.5.1, 0.5.2, 0.5.3, 0.5.4, 0.6.1, 0.6.2, 0.7.1, 0.7.2, 0.7.3, 0.7.4, 0.7.5, 0.8.0
Change log NEWS
Dependencies base (>=4 && <5), bytestring, cairo, containers, dbus (>=0.10), directory, filepath, glib, gtk (>=0.12.4), hgettext (>=0.1.5), mtl, pango, parsec, pcap, process, setlocale, text, time [details]
License LicenseRef-OtherLicense
Author Will Thompson <will@willthompson.co.uk>
Maintainer Will Thompson <will@willthompson.co.uk>
Category Network, Desktop
Source repo head: git clone git://anongit.freedesktop.org/bustle
Uploaded by WillThompson at 2014-02-26T22:47:35Z
Distributions Arch:0.8.0, Debian:0.8.0, Fedora:0.8.0
Reverse Dependencies 1 direct, 0 indirect [details]
Executables dump-messages, test-monitor, bustle
Downloads 14894 total (84 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Successful builds reported [all 8 reports]

Readme for bustle-0.4.5

[back to package description]
Bustle draws sequence diagrams of D-Bus activity, showing signal
emissions, method calls and their corresponding returns, with timestamps
for each individual event and the duration of each method call. This can
help you check for unwanted D-Bus traffic, and pinpoint why your
D-Bus-based application isn't performing as well as you like. It also
provides statistics like signal frequencies and average method call

Using Bustle

Run it:


Now click **File → New…** to start recording session bus traffic. When you're
done, click **Stop**, and explore the log.

If you want to record traffic without running the UI (maybe on an embedded
platform which doesn't have Gtk+ and/or a Haskell compiler), you can use the
stand-alone logger:

    bustle-pcap logfile.bustle

You can then open `logfile.bustle` in Bustle.

You can also get some ASCII-art
version of the statistics shown in the UI:

    bustle --count logfile.bustle
    bustle --time logfile.bustle

If you want to log all system bus traffic, you need to edit
`/etc/dbus/system.conf` to enable eavesdropping, and then remove the include of
`/etc/dbus-1/system.conf.d` which seems to re-enable strictness. Then you can run
the stand-alone logger against the system bus:

    bustle-pcap --system system-log.bustle

Please remember to **undo these changes** when you're done.

More information

See <http://wjt.me.uk/bustle/>.