Quick Setup
UNIX: Installation
All the tools required are usually installed on a UNIX
developer machine.
If a tool is not already installed on your system, you
will typically use the installation package from your
distribution (by your favourite package manager: aptitude, yum,
synaptics, ...).
If an install package is not available, or you have a
reason not to use it (maybe because it's simply too old), you
can install that tool from source code. The following sections
will provide you with the webpage addresses where you can get
these sources.
Win32: Step-by-Step Guide
A quick setup guide for Win32 with recommended
configuration.
Warning!
Unless you know exactly what you are doing, you
should strictly follow the recommendations!
Install Microsoft C compiler and Platform SDK
You need to install:
C compiler:
Download(474MB) and install "Visual C++ 2005
Express Edition"
Platform SDK :
Download(420MB) and install Platform SDK Server
2003 R2
Install MSVC the usual way. Don't forget to install
vcvars32.bat or call it manually before building Wireshark.
vcvars32.bat will set some required environment (e.g. the
PATH) settings.
Other Microsoft C compiler variants
possible!
It's possible to compile Wireshark with a wide range
of Microsoft C compiler variants, for details see
!
Don't use cygwin's gcc!
Using cygwin's gcc is not recommended and will
certainly not work (at least without a lot of advanced
tweaking). For further details on this topic, see
.
XXX - mention the compiler and PSDK web installers -
which significantly reduce download size - and find out the
required components
XXX - how to get the right PATH settings?
Why this is recommended: While this is a huge download,
the 2005 express edition is the only free (as in beer)
version that includes the Visual Studio integrated
debugger.
Install Cygwin
Download the cygwin installer and start it.
At the "Select Packages" page, you'll need to select
some additional packages, which are not installed by default.
Navigate to the required Category/Package row and click on
the "Skip" item in the "New" column so it shows a version
number for:
Archive/unzip
Devel/bison
Devel/flex
Interpreters/perl
Utils/patch
Web/wget
After clicking the Next button several times, the setup
will then download and install the selected packages (this
may take a while).
Why this is recommended: Cygwin's bash version is
required, as no native Win32 version is available. As
additional packages can easily be added, the perl and alike
packages are also used.
Install Python
Get the python 2.4 installer from:
and install python
into the default location (currently: C:/Python24).
Beware: python 2.5 won't work without
modifications.
Why this is recommended: Cygwin's python package
doesn't work on some machines, so the Win32 native package is
recommended.
Install Subversion Client
Please note that the following is not required to build
Wireshark, but can be quite helpful when working with the
sources.
Why this is recommended: updating a personal source
tree is significantly easier to do with Subversion than
downloading a zip file and merging new sources into a
personal source tree "by hand".
Subversion
If you want to work with the Wireshark Subversion
source repositories (which is highly recommended, see
), it's recommended to
install Subversion. This makes the first time setup easy
and enables the Wireshark build process to determine your
current source code revision. You can download the setup
from
and simply
install it.
TortoiseSVN
If you want to work with the Wireshark Subversion
source repositories (which is highly recommended, see
), it's recommended to use
TortoiseSVN for your everyday work. You can download the
setup from
and simply
install it.
Install and Prepare Sources
Tip
It's a good idea to successfully compile and run
Wireshark at least once before you start hacking the
Wireshark sources for your own project!
Download sources : Download Wireshark sources into:
C:\wireshark using TortoiseSVN
right click on the C:\ drive in Windows
Explorer
in the upcoming context menu select "SVN
checkout..." and then set:
URL of repository: "
http://anonsvn.wireshark.org/wireshark/trunk/"
Checkout directory:
"C:\wireshark"
TortoiseSVN might ask you to create this
directory - say yes
TortoiseSVN starts downloading the
sources
if the download fails you may be behind a
restrictive firewall, see
for alternative
download methods
Edit config.nmake: edit the settings in
C:\wireshark\config.nmake, especially:
VERSION_EXTRA : give Wireshark your "private"
version info, e.g.: -myprotocol123 - to distinguish
it from an official release!
PROGRAM_FILES : where your programs reside,
usually just keep the default: C:/Program Files
2
MSVC_VARIANT : search for the line:
#MSVC_VARIANT=MSVC2005EE and remove the tailing #
comment char from this line
1
1Compiler dependent: This step
depends on the compiler variant used, for other variants than
the recommended Visual C++ 2005 Express Edition see the table
at
!
2International Windows might use
different values here, e.g. a german version uses
C:/Programme - take this also in account where C:\Program
Files appears elsewhere
Prepare cmd.exe
Prepare cmd.exe - set environment and current dir.
start cmd.exe
call "C:\Program Files\Microsoft Platform SDK for
Windows Server 2003 R2\SetEnv.Cmd" to set environment
variables of Platform SDK Server 2003 R2
1,2
call "C:\Program Files\Microsoft Visual Studio
8\VC\bin\vcvars32.bat" to set environment variables of
Visual C++ 2005 Express Edition
1,2
cd C:\wireshark to jump into the source
directory
1Compiler dependent: This step
depends on the compiler variant used, for other variants than
the recommended Visual C++ 2005 Express Edition see the table
at
!
2International Windows might use
different values here, e.g. a german version uses
C:/Programme - take this also in account where C:\Program
Files appears elsewhereNote: You need to repeat steps 1 - 4
each time you open a new cmd.exe!
Install Libraries
If you've closed cmd.exe in the meantime, prepare
cmd.exe again
nmake -f Makefile.nmake setup downloads libraries
using wget and installs them - this may take a while
...
If the download fails you may be behind a
restrictive firewall, see the wget manual for ways to use
a proxy
Distclean Sources
The released Wireshark sources contain files that are
prepared for a UNIX build (e.g. config.h).
You must distclean your sources before building the
first time!
If you've closed cmd.exe in the meantime, prepare
cmd.exe again
nmake -f Makefile.nmake distclean to cleanup the
Wireshark sources
Build Wireshark
Now it's time to build Wireshark ...
If you've closed cmd.exe in the meantime, prepare
cmd.exe again
nmake -f Makefile.nmake all to build
Wireshark
wait for Wireshark to compile - this may take a
while!
run C:\wireshark\wireshark-gtk2\wireshark.exe and
check if it starts
check Help/About if it shows your "private" program
version, e.g.: Version 0.99.4-myprotocol123 - you might
run a release version previously installed!
Tip: If compilation fails for suspicious
reasons after you changed some source files try to distclean
the sources and make "all" again
Debug Environment Setup (XXX)
XXX - debug needs to be written, e.g. an idea is the
create a simple MSVC 6 workspace/project(s) to ease Visual
Studio debugging
Optional: Create User's and Developer's Guide
Detailed information to build these guides can be found
in the file docbook/README.txt in the Wireshark
sources.
Optional: Create a Wireshark Installer
Note: You should have successfully built Wireshark
before doing the following!
If you want to build your own wireshark-setup.exe,
you'll need NSIS.
NSIS:
Download and install NSIS
You may check the MAKENSIS setting in the file
config.nmake of the Wireshark
sources.
vcredist_x86.exe :
Download the C-Runtime redistributable for Visual
C++ 2005 Express Edition (vcredist_x86.exe) and copy it
into C:\wireshark-win32-libs
1
Beware of Visual Studio Service Packs!
If you have installed the Visual Studio Service
Pack 1, you need a different vcredist_x86.exe version!
See
for details!
If you've closed cmd.exe in the meantime, prepare
cmd.exe again
nmake -f Makefile.nmake packaging build Wireshark
installer
run
C:\wireshark\packaging\nsis\wireshark-setup-<version>.exe
and test it - it's a good idea to test also on a
different machine than the developer machine.
1Compiler dependent: This step
depends on the compiler variant used, for other variants than
the recommended Visual C++ 2005 Express Edition see the table
at
!