libvirt

mirror of https://github.com/libvirt/libvirt.git synced 2025-02-25 18:55:26 -06:00

History

Daniel P. Berrangé e0f54d6663 tools: fix misc spelling errors reported by codespell Reviewed-by: Peter Krempa <pkrempa@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>		2020-10-05 10:28:45 +01:00
..
samples	tools: wireshark: fix link to wireshark repo	2020-09-01 21:58:45 +02:00
src	wireshark: Prefer ws_version.h over config.h	2020-09-08 10:58:24 +02:00
util	tools: fix misc spelling errors reported by codespell	2020-10-05 10:28:45 +01:00
meson.build	meson: tools/wireshark: generate protocol header files	2020-08-03 09:27:05 +02:00
README.rst	Prefer https: everywhere where possible	2020-09-01 21:58:46 +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