Repository files navigation

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

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

1. InstallWireshark.
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, underepan. The plugin folder path varies for each OS.

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

Personal Plugin Folder:

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

Personal Plugin Directory:

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

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

SeeWireshark Documentation on Plugin Folders for more information on installing plugins.

1. Open Wireshark
2. Navigate toHelp>About Wireshark
3. Under theFolders tab, you can find the location for global and personal folders
4. After installing the plugin, verify that the plugin is loaded by searchingsmf under thePlugins tab

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 headerssudo apt install build-essential cmake ninja wireshark-dev zlib1g-dev

2. Clone the repo

git clone https://github.com/SolaceLabs/wireshark-smf-plugin# orgit 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 optionalcmake -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 atbuild/smf.so.

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

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

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.

This is not an officially supported Solace product.

For more information try these resources:

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

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

See the list ofcontributors who participated in this project.

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

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