2017-09-23 21:50:28 +00:00
|
|
|
|
2021-02-26 16:07:26 +00:00
|
|
|
This is an example of how to build a Wireshark plugin out-of-tree. This
|
|
|
|
|
is an alternative, more recent way to build Wireshark binary plugins,
|
|
|
|
|
than the one in 'README.plugins', that describes in detail how to
|
|
|
|
|
include a new plugin into the project source tree (here called in-tree
|
|
|
|
|
build). Building a plugin out-of-tree doesn't require rebuilding the whole
|
|
|
|
|
Wireshark source tree every time.
|
2017-09-23 21:50:28 +00:00
|
|
|
|
2021-02-26 16:07:26 +00:00
|
|
|
You always need to rebuild plugins for each major.minor Wireshark version.
|
|
|
|
|
Binary compatibility is never guaranteed between those releases and Wireshark
|
|
|
|
|
will explicitly check for which version the plugin was built and refuse
|
|
|
|
|
to load it otherwise.
|
|
|
|
|
|
|
|
|
|
Note that this method builds the plugin against Wireshark's *system installion*,
|
|
|
|
|
using CMake's Config-file mechanism[1] for configuration.
|
|
|
|
|
|
|
|
|
|
You should of course adapt this trivial example to your own needs.
|
2017-09-23 21:50:28 +00:00
|
|
|
|
2018-05-23 14:27:06 +00:00
|
|
|
To build/install the plugin:
|
2017-09-23 21:50:28 +00:00
|
|
|
|
2018-05-23 14:27:06 +00:00
|
|
|
$ mkdir build && cd build
|
|
|
|
|
$ cmake ..
|
2017-09-23 21:50:28 +00:00
|
|
|
$ make
|
2018-05-21 23:46:18 +00:00
|
|
|
$ sudo make install
|
2018-05-23 14:27:06 +00:00
|
|
|
|
2018-09-14 02:41:21 +00:00
|
|
|
If your WiresharkConfig.cmake file is not in one of the standard cmake search
|
|
|
|
|
paths you will have to tell cmake where to find it. You can do so using
|
2021-02-26 16:07:26 +00:00
|
|
|
CMAKE_PREFIX_PATH, for example:
|
2018-05-23 14:27:06 +00:00
|
|
|
|
2018-09-14 02:41:21 +00:00
|
|
|
$ cmake -DCMAKE_PREFIX_PATH="/opt/wireshark" ..
|
2021-02-26 16:07:26 +00:00
|
|
|
|
|
|
|
|
[1]https://cmake.org/cmake/help/latest/manual/cmake-packages.7.html#config-file-packages
|
