Wireshark SMF Plugin

Overview

This project is a plugin for wireshark that will dissect Solace SMF protocol.

Getting Started Quickly

Note: Wireshark SMF Plugin is currently supported on Wireshark 4.0.x, 4.2.x, 4.4.x, and 4.6.x

1. Install Wireshark.
2. Download the corresponding zip file for your platform (Click on "Releases" and in the releases page, click on "Assets" to see the downloadable contents).
3. Unzip the folder and place the .dll (Windows) or .so (Mac/Linux) file in the Wireshark plugin folder, under epan. The plugin folder path varies for each OS.

Windows Plugin Folder

Personal Plugin Folder (version specific, use the wireshark major.minor):

%APPDATA%\Wireshark\plugins\4.6\epan

Global Plugin Folder (version specific, use the wireshark major.minor):

C:\Program Files\Wireshark\plugins\4.6\epan

Linux Plugin Folder

Personal Plugin Folder:

~/.local/lib/wireshark/plugins/4.6/epan

macOS Plugin Folder

Personal Plugin Directory:

~/.local/lib/wireshark/plugins/4-6/epan

Important

If you get an error message saying library load disallowed by system policy when lauching wireshark, you must run this command to allow the plugin to load:

sudo xattr -d com.apple.quarantine ~/.local/lib/wireshark/plugins/4-6/epan/smf.so

See Wireshark Documentation on Plugin Folders for more information on installing plugins.

Finding Plugin Folders and Verify Installation

1. Open Wireshark
2. Navigate to Help>About Wireshark
3. Under the Folders tab, you can find the location for global and personal folders
4. After installing the plugin, verify that the plugin is loaded by searching smf under the Plugins tab

Building Manually

Note

If you plan to submit changes, create a fork first and clone from the fork.

Linux

1. Install the dependencies

# adjust for your distribution, you need
# - C compiler (gcc or clang)
# - cmake
# - ninja (optional, can use make)
# - glib2 with development headers
# - wireshark with development headers
# - zlib with development headers
sudo apt install build-essential cmake ninja wireshark-dev zlib1g-dev

2. Clone the repo

git clone https://github.com/SolaceLabs/wireshark-smf-plugin
# or
git clone <your-fork>/wireshark-smf-plugin

3. Enter the repo

cd wireshark-smf-plugin

4. Configure cmake

# optionally add "-DCMAKE_EXPORT_COMPILE_COMMANDS=1" to export the "compile_commands.json"
# ninja is optional
cmake -G Ninja -B build

5. (optional) If you chose to export the compile commands, you can copy them from build or create a symbolic link

ln -s build/compile_commands.json

6. Build the plugin

cmake --build build

You can then find the plugin at build/smf.so.

Windows

TODO: Build out-of-tree. See github workflow for working steps.

MacOS

TODO: Build out-of-tree. See github workflow for working steps.

Version Naming Convention

As this plugin is designed for use in Wireshark, the MAJOR.MINOR match the Wireshark versions. I.E. SMF Plugin 4.0.x indicates support for all patches of Wireshark 4.0.

The PATCH version of the plugin differentiates versions of the SMF Plugin. As long as the MAJOR.MINOR of the plugin match the corresponding MAJOR.MINOR Wireshark version, then they are compatible.

Resources

This is not an officially supported Solace product.

For more information try these resources:

• Ask the Solace Community
• The Solace Developer Portal website at: https://solace.dev

Contributing

Contributions are encouraged! Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

See the list of contributors who participated in this project.

License

Wireshark SMF Plugin is licensed under the GNU GPLv2. See the LICENSE file for details.

Disclaimer

There is no warranty, expressed or implied, associated with this product. Use at your own risk.