libvirt

History

Roman Bolshakov 45006fa408 wireshark: Fix missing bool_t on macOS The header has to be explicitly added to pull definition of bool_t and a few other types. Otherwise packet-libvirt.c can't be compiled. Signed-off-by: Roman Bolshakov <r.bolshakov@yadro.com> Reviewed-by: Andrea Bolognani <abologna@redhat.com>		2020-10-07 19:17:53 +02:00
..
samples	tools: wireshark: fix link to wireshark repo	2020-09-01 21:58:45 +02:00
src	wireshark: Fix missing bool_t on macOS	2020-10-07 19:17:53 +02:00
util	tools: fix misc spelling errors reported by codespell	2020-10-05 10:28:45 +01:00
README.rst	Prefer https: everywhere where possible	2020-09-01 21:58:46 +02:00
meson.build	meson: tools/wireshark: generate protocol header files	2020-08-03 09:27:05 +02:00

README.rst

=====
About
=====

This is the project of Google Summer of Code 2013 accepted by QEMU.org and
libvirt community.  The goal of this project is, provide Wireshark dissector for
Libvirt RPC protocol. It will provide Libvirt packet overview/detail analysing
in Wireshark. Furthermore, it will be able to build(generated) from RPC protocol
definition placed in Libvirt source tree to support latest protocol
specification.

See also:

* https://www.google-melange.com/gsoc/project/google/gsoc2013/kawamuray/7001
* https://wiki.qemu.org/Features/LibvirtWiresharkDissector


Installation
=============

Run ``./configure`` with ``--with-wireshark-dissector`` option enabled.
Then dissector will compiled with libvirt itself.

Add/Remove protocol from dissector's support
--------------------------------------------

Modify variable ``WS_DISSECTOR_PROTO_FILES``
in ``tools/wireshark/src/Makefile.am``.

Changing installation directory
-------------------------------

You can change installation directory of pluggable shared
object(``libvirt.so``) by specifying ``--with-ws-plugindir=<path>``.

You can install ``libvirt.so`` into your local wireshark plugin directory:

::

  $ ./configure --with-wireshark-dissector \
                --with-ws-plugindir=$HOME/.wireshark/plugins