bustle: Draw sequence diagrams of D-Bus traffic

[ desktop, lgpl, network, program ] [ Propose Tags ] [ Report a vulnerability ]

Draw sequence diagrams of D-Bus traffic


[Skip to Readme]

Flags

Automatic Flags
NameDescriptionDefault
interactivetests

Build interactive test programs

Disabled
threaded

Build with the multi-threaded runtime

Enabled
withgtk2hsbuildtools

Build-depend on gtk2hs-buildtools. They aren't (currently) used to build Bustle itself but are needed to build dependencies like gtk3, which for whatever reason do not Build-Depend on the tools.

Disabled

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

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

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.md
Dependencies base (>=4 && <5), bytestring, cairo, containers, dbus (>=0.10), directory, filepath, gio, glib, gtk2hs-buildtools, gtk3 (>=0.13.7), hgettext (>=0.1.5), mtl (>=2.2.1), pango, parsec, pcap, process, setlocale, text, time [details]
Tested with ghc >=7.8.4 && <7.11
License LicenseRef-OtherLicense
Author Will Thompson <will@willthompson.co.uk>
Maintainer Will Thompson <will@willthompson.co.uk>
Category Network, Desktop
Home page http://www.freedesktop.org/wiki/Software/Bustle/
Source repo head: git clone git://anongit.freedesktop.org/bustle
Uploaded by WillThompson at 2015-08-18T11:29:20Z
Distributions Arch:0.10.0, Debian:0.8.0, Fedora:0.8.0
Reverse Dependencies 1 direct, 0 indirect [details]
Executables dump-messages, test-monitor, bustle
Downloads 15367 total (116 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2015-12-10 [all 8 reports]

Readme for bustle-0.5.2

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

Using Bustle

Run it:

bustle

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://www.freedesktop.org/wiki/Software/Bustle/.