User Guide

Warning!

You will need the Wireshark sources and some tools (nmake, bash) installed, before

this verification is able to work.

Enter at the command line (cmd.exe, not Cygwin's bash!):

> nmake -f Makefile.nmake verify_tools

This will check for the various tools needed to build Wireshark:

Checking for required applications:

cl: /cygdrive/c/Programme/Microsoft Visual Studio 8/VC/BIN/cl

link: /cygdrive/c/Programme/Microsoft Visual Studio 8/VC/BIN/link

nmake: /cygdrive/c/Programme/Microsoft Visual Studio 8/VC/BIN/nmake

bash: /usr/bin/bash

bison: /usr/bin/bison

flex: /usr/bin/flex

env: /usr/bin/env

grep: /usr/bin/grep

/usr/bin/find: /usr/bin/find

perl: /usr/bin/perl

env: /usr/bin/env

C:/python24/python.exe: /cygdrive/c/python24/python.exe

sed: /usr/bin/sed

unzip: /usr/bin/unzip

wget: /usr/bin/wget

If you have problems with all the first three items (cl, link, nmake), check if you called

vcvars32/SetEnv as mentioned in Section 2.2.6, “Prepare cmd.exe” (which will "fix" your PATH

settings). However, the exact text will be slightly different depending on the MSVC version used.

Unfortunately, the link command is defined both in cygwin and in MSVC each with completely dif-

ferent functionality; you'll need the MSVC link. If your link command looks something like: /

usr/bin/link, the link command of cygwin takes precedence over the MSVC one. To fix this, you can

change your PATH environment setting or simply rename the link.exe in cygwin. If you rename it,

make sure to remember that a cygwin update may provide a new version of it.

2.2.8. Install Libraries

1. If you've closed cmd.exe in the meantime, prepare cmd.exe again

2. nmake -f Makefile.nmake setup downloads libraries using wget and installs them - this may

take a while ...

3. If the download fails you may be behind a restrictive firewall, see the wget manual for ways to

use a proxy

2.2.9. 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!

1. If you've closed cmd.exe in the meantime, prepare cmd.exe again

2. nmake -f Makefile.nmake distclean to cleanup the Wireshark sources

2.2.10. Build Wireshark

Quick Setup