wireshark2.4.2 vs2015 源码编译及C语言插件开发总结

wireshark Windows源码编译及C语言插件开发总结


一、Windows源码编译环境配置（vs2015，32bit）
1、wireshark源码下载地址https://www.wireshark.org/；
2、下载qt-opensource-linux-x64-5.5.1.run安装Qt5.9.1; 下载安装cygwin。
3、创建插件开发目录wireshark2.4.2_dev，wireshark源码解压到C语言插件开发目录wireshark2.4.2_dev，在该目录下创建project目录，目录结构如下：
wireshark2.4.2_dev
|
------project
|
------wireshark-2.4.2
4、启动vs2015命令行窗口，Visual Studio 2015 → Visual Studio Tools → Windows Desktop Command Prompts → vs2015 x86本机工具命令提示符
5、在命令行窗口下配置编译选项：
rem Let CMake determine the library download directory name under
rem WIRESHARK_BASE_DIR or set it explicitly by using WIRESHARK_LIB_DIR.
rem Set *one* of these.
set WIRESHARK_BASE_DIR=E:\wireshark_custom\wireshark2.4.2_dev\project
rem set WIRESHARK_LIB_DIR=c:\wireshark-win64-libs
rem Set the Qt installation directory
set QT5_BASE_DIR=E:\Qt\Qt5.9.1\5.9.1\msvc2015
rem Append a custom string to the package version. Optional.
set WIRESHARK_VERSION_EXTRA=E:\wireshark_custom\wireshark2.4.2_dev\project\extraversion
rem Chocolatey installs Cygwin in an odd location
set WIRESHARK_CYGWIN_INSTALL_PATH=E:\cygwin\bin
set VisualStudioVersion=14.0
6、在命令行窗口下进入开发目录project，执行编译命令
cmake -DENABLE_CHM_GUIDES=on -G "Visual Studio 14 2015" E:\wireshark_custom\wireshark2.4.2_dev\wireshark-2.4.2
出现以下内容说明编译完成
-- Configuring done
-- Generating done
-- Build files have been written to: E:\wireshark_custom\wireshark2.4.2_dev\project
点击wireshark的vs2015工程文件，打开wireshark工程后执行编译操作，工程文件所在位置如：E:\wireshark_custom\wireshark2.4.2_dev\project\Wireshark.sln
也可以使用命令行执行编译操作，如下：msbuild /m /p:Configuration=RelWithDebInfo Wireshark.sln
第一次编译时间可能较长，编译成功后会在配置目录project\run下生成可执行文件，说明wireshark2.4.2源码编译成功。


二、C语言插件工程配置
1、Wireshark C语言插件开发目录一般在plugins目录，如E:\wireshark_custom\wireshark2.4.2_dev\wireshark-2.4.2\plugins，该目录下已经存在一些其他开发完成插件，在该目录下创建自己需要开发的插件目录octopus
2、从其他插件目录copy以下文件到octopus目录：plugin.c、plugin.rc.in、moduleinfo.h、COPYING、CMakeLists.txt、ChangeLog、AUTHORS；根据需要修改工程及文件属性。其中plugin.c是插件注册接口，根据插件的名称注册插件；CMakeLists.txt数据插件工程编译文件，根据需要加入自己的源码文件。
3、修改E:\wireshark_custom\wireshark2.4.2_dev\wireshark-2.4.2\CMakeLists.txt，在set(PLUGIN_SRC_DIRS内容出增加plugins/octopus；
4、在命令行窗口执行cmake命令cmake -DENABLE_CHM_GUIDES=on -G "Visual Studio 14 2015" E:\wireshark_custom\wireshark2.4.2_dev\wireshark-2.4.2，
配置完成后会自动将octopus插件工程加入到wireshark总项目中，使用VS2015打开Wireshark.sln，在Plugins下即可看到octopus项目，至此开发工程已经配置完成。
5、配置完后，可以在vs2015工具下编辑开发octopus插件了。


三、自定义插件源码编写注意事项
源码编写时注意以下头文件的使用顺序，顺序不对会导致编译错误。
#include "config.h"
#include


源码编写完成后，


其他开发相关事宜参考官方wireshark开发文档即可，https://www.wireshark.org/docs/wsdg_html_chunked/