| 1 |
------------------------------------------------------------------------ |
| 2 |
How to build wireshark with HAProxy Peers Protocol dissection support. |
| 3 |
------------------------------------------------------------------------ |
| 4 |
|
| 5 |
Please note that at this time, HAProxy Peers Protocol dissection is not supported |
| 6 |
on Windows systems (could not be tested). |
| 7 |
|
| 8 |
1) File list |
| 9 |
------------- |
| 10 |
- packet-happp.c: source code for HAProxy Peers Protocol (HAPPP) dissection |
| 11 |
support. |
| 12 |
- wireshark.happp.dissector.patch: a patch file for wireshark sources to enable HAPPP |
| 13 |
dissection support. Note that this patch file modifies only two files: |
| 14 |
(epan/dissectors/CMakeLists.txt and epan/dissectors/Makefile.am) to add |
| 15 |
packet-happp.c file DISSECTOR_SRC variable which list all wireshark |
| 16 |
- README: this file. |
| 17 |
|
| 18 |
2a) To build wireshark with HAPPP dissection support |
| 19 |
--------------------------------------------------- |
| 20 |
- Download wireshark sources: |
| 21 |
$ git clone https://code.wireshark.org/review/wireshark |
| 22 |
- copy packet-happp.c file to epan/dissectors/ directory. |
| 23 |
- apply wireshark.happp.dissector.patch file to wireshark source directory. |
| 24 |
- build wireshark (see https://www.wireshark.org/docs/wsdg_html_chunked/): |
| 25 |
$ ./autogen.sh |
| 26 |
$ ./configure |
| 27 |
$ make |
| 28 |
|
| 29 |
2b) Alternative: build the HAPPP dissector as a wireshark plugin |
| 30 |
----------------------------------------------------------------- |
| 31 |
If you don't want to build completely wireshark, you can build the dissector as |
| 32 |
a plugin. |
| 33 |
|
| 34 |
You will need the development package of your distribution, which is |
| 35 |
"libwireshark-dev" for debian based distribution and "wireshark-dev" for |
| 36 |
redhat-based ones. |
| 37 |
|
| 38 |
$ make |
| 39 |
|
| 40 |
It is possible that depending on your distribution the compilation may fail |
| 41 |
with such an error: |
| 42 |
|
| 43 |
packet-happp.c:40:10: fatal error: ws_version.h: No such file or directory |
| 44 |
#include <ws_version.h> |
| 45 |
|
| 46 |
In this case try to build this plugins with this OPTS variable: |
| 47 |
|
| 48 |
$ OPTS=-DWITHOUT_WS_VERSION make |
| 49 |
|
| 50 |
To install it in your home directory: |
| 51 |
|
| 52 |
$ make install |
| 53 |
|
| 54 |
The plugin will be installed in ~/.wireshark/plugins/ by default, but you can |
| 55 |
change this path by setting the "plugins" variable. If it didn't work, check |
| 56 |
the paths in "Help > About Wireshark > Folders > Personal Plugins" which should |
| 57 |
give you the right path to use. |
| 58 |
|
| 59 |
In some distribution it will be in ~/.local/lib/wireshark/ so you will need to |
| 60 |
install it this way: |
| 61 |
|
| 62 |
$ make install plugins=~/.local/lib/wireshark/plugins/3.2/epan/ |
| 63 |
|
| 64 |
If you want to install it in the system directory you can do it this way, the |
| 65 |
right path is also in the Folder window. Change the plugins variable this way: |
| 66 |
|
| 67 |
$ sudo make install plugins=/usr/lib64/wireshark/plugins/3.2/epan/ |
| 68 |
|
| 69 |
Be careful to use the right version number in the path. |
| 70 |
|
| 71 |
3) Check if you have the dissector in wireshark |
| 72 |
----------------------------------------------- |
| 73 |
To verify if the protocol was well loaded by your wireshark, open the Supported |
| 74 |
Protocols window in "View > Internals > Supported Protocols" and look for |
| 75 |
"HAPPP". |
| 76 |
|
| 77 |
In the case of a plugin, you should see your plugin loaded in "Help > About |
| 78 |
Wireshark > Plugins". |