bustle: Draw sequence diagrams of D-Bus traffic

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Warnings:

The 'description' field should be longer than the 'synopsis' field. It's useful to provide an informative 'description' to allow Haskell programmers who have never heard about your package to understand the purpose of your package. The 'description' field content is typically shown by tooling (e.g. 'cabal info', Haddock, Hackage) below the 'synopsis' which serves as a headline. Please refer to <https://www.haskell.org/cabal/users-guide/developing-packages.html#package-properties> for more details.
Packages relying on Cabal 1.12 or later should specify a version range of the form 'cabal-version: x.y'. Use 'cabal-version: 1.24'.

Draw sequence diagrams of D-Bus traffic

[Skip to Readme]

Properties

Versions	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.0, 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, gtk3 (>=0.13.7), hgettext (>=0.1.5), mtl (>=2.2.1), pango, 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
Home page	https://www.freedesktop.org/wiki/Software/Bustle/
Source repo	head: git clone https://gitlab.freedesktop.org/bustle/bustle.git
Uploaded	by WillThompson at 2018-06-15T08:37:41Z

Flags

Automatic Flags

Name	Description	Default
hgettext	Enable translations. Since there are no translations this is currently rather pointless.	Enabled
interactivetests	Build interactive test programs	Disabled
threaded	Build with the multi-threaded runtime	Enabled

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

Downloads

bustle-0.7.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

WillThompson, pwithnall

For package maintainers and hackage trustees

edit package information

Readme for bustle-0.7.0

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