# as to the required library package files will be made.
#
LIBS_CHECK=_libs_check_
-!IF [$(SH) $(WIN_SETUP) --checktag "$(WIRESHARK_LIBS)"] != 0
+!IF [$(SH) $(WIN_SETUP) --checktag "$(WIRESHARK_LIB_DIR)"] != 0
CHECK_TAG=_check_tag_
!ELSE
CHECK_TAG=
#
$(ADNS_DLL):
!IF "$(MSVC_VARIANT)" == "MSVC6"
- if not exist $(WIRESHARK_LIBS)\$(MSVC_VARIANT)\adns mkdir $(WIRESHARK_LIBS)\$(MSVC_VARIANT)\adns
+ if not exist $(WIRESHARK_LIB_DIR)\$(MSVC_VARIANT)\adns mkdir $(WIRESHARK_LIB_DIR)\$(MSVC_VARIANT)\adns
copy $(ADNS_DIR)\adns_win32\lib\adns_dll.dll $(ADNS_DLL)
copy $(ADNS_DIR)\adns_win32\lib\adns_dll.lib $(ADNS_LIBS)
!ELSE
!IFDEF MANIFEST_INFO_REQUIRED
mt.exe -nologo -manifest "adns_dll.dll.manifest" -outputresource:adns_dll.dll;2
!ENDIF
- if not exist $(WIRESHARK_LIBS)\$(MSVC_VARIANT)\adns mkdir $(WIRESHARK_LIBS)\$(MSVC_VARIANT)\adns
+ if not exist $(WIRESHARK_LIB_DIR)\$(MSVC_VARIANT)\adns mkdir $(WIRESHARK_LIB_DIR)\$(MSVC_VARIANT)\adns
copy adns_dll.dll $(ADNS_DLL)
copy adns_dll.lib $(ADNS_LIBS)
cd ..\..\..
verify_tools:
# As win-setup.sh assumes the dir exists create it if it doesn't
- @if not exist $(WIRESHARK_LIBS) md $(WIRESHARK_LIBS)
+ @if not exist $(WIRESHARK_LIB_DIR) md $(WIRESHARK_LIB_DIR)
@$(SH) $(WIN_SETUP) --appverify $(REQUIRED_TOOLS)
# Targets and etc used to verify or download libraries
!ENDIF
-# Download (if needed) and install all the required libraries into WIRESHARK_LIBS.
+# Download (if needed) and install all the required libraries into WIRESHARK_LIB_DIR.
# A clean_setup is done first to ensure that the target dirs don't
# contain old files remaining from a previous setup run.
setup: verify_tools clean_setup process_libs
# The process_libs target when invoked causes either a --libverify or a --download for all the required libraries.
# (The choice is determined by the value of the macro WIN_SETUP_OPT).
process_libs:
- @if not exist $(WIRESHARK_LIBS) md $(WIRESHARK_LIBS)
+ @if not exist $(WIRESHARK_LIB_DIR) md $(WIRESHARK_LIB_DIR)
!IFDEF GTK_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
gtk2 gtk+-bundle_$(GTK_PKG)_$(WIRESHARK_TARGET_PLATFORM).zip
!ENDIF
!IFDEF KFW_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. kfw-3-2-2-i386-ws-vc6.zip
-# @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+# @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
# . kfw-3-2-2.zip
!ENDIF
!IFDEF PCAP_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. WpdPack_$(PCAP_VERSION).zip
!ENDIF
!IFDEF AIRPCAP_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
AirPcap_Devpack_4_1_0_1622 AirPcap_Devpack_4_1_0_1622.zip
!ENDIF
!IFDEF C_ARES_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. c-ares-$(C_ARES_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws.zip
!ENDIF
!IFDEF ADNS_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. adns-1.0-win32-05ws.zip
!ENDIF
!IFDEF ZLIB_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
!if "$(WIRESHARK_TARGET_PLATFORM)" == "win32"
zlib125 zlib-1.2.5.zip
!else
!endif
!ENDIF
!IFDEF LUA_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
lua5.1.4 lua$(LUA_DIST)_lib.zip
!ENDIF
!IFDEF GNUTLS_PKG
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. gnutls-$(GNUTLS_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws.zip
!ENDIF
!IFDEF PORTAUDIO_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. portaudio_v19_2.zip
!ENDIF
!IFDEF SMI_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. libsmi-$(SMI_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws.zip
!ENDIF
!IFDEF GEOIP_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. GeoIP-1.4.6-$(WIRESHARK_TARGET_PLATFORM)ws.zip
!ENDIF
!IFDEF HHC_DIR
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
user-guide user-guide-37310.zip
!ENDIF
!IFDEF UPX
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. upx303w.zip
!ENDIF
!IFDEF NASM
- @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIBS)" \
+ @$(SH) $(WIN_SETUP) "$(WIN_SETUP_OPT)" "$(WIRESHARK_LIB_DIR)" \
. nasm-2.09.08-win32.zip
!ENDIF
!IF "$(WIN_SETUP_OPT)" == "--download"
- @$(SH) $(WIN_SETUP) --settag "$(WIRESHARK_LIBS)"
+ @$(SH) $(WIN_SETUP) --settag "$(WIRESHARK_LIB_DIR)"
!ENDIF
@echo.
@echo Wireshark is ready to build.
# WHEN UPDATING LIBRARY VERSIONS, KEEP ALSO ONE FORMER VERSION SO
# UPDATING REMOVES THE FORMER USER DIRS
clean_setup:
- cd $(WIRESHARK_LIBS)
+ cd $(WIRESHARK_LIB_DIR)
rm -r -f adns-1.0-win32-05ws
rm -r -f c-ares-1.5.3ws
rm -r -f c-ares-1.6.0ws
# compile the sources. This setting is used only inside this file.
# This can be defined in the system environment.
#
-!IFNDEF WIRESHARK_LIBS
-WIRESHARK_LIBS=C:\wireshark-$(WIRESHARK_TARGET_PLATFORM)-libs
+!IFNDEF WIRESHARK_LIB_DIR
+WIRESHARK_LIB_DIR=C:\wireshark-$(WIRESHARK_TARGET_PLATFORM)-libs
!ENDIF
#
# If you don't have NASM, comment this line out, so that NASM
# isn't defined.
#
-NASM=$(WIRESHARK_LIBS)\nasm-2.09.08\nasm.exe
+NASM=$(WIRESHARK_LIB_DIR)\nasm-2.09.08\nasm.exe
#
# Optional: the Python library enables scripting support.
# If you want building with GTK+, set GTK_DIR to the pathname of the
# directory in which the "include" and "lib" directories reside.
#
-GTK_DIR=$(WIRESHARK_LIBS)\gtk2
+GTK_DIR=$(WIRESHARK_LIB_DIR)\gtk2
# These macros are used by the nsis installer script and by the install target.
PNG_DLL=libpng14-14.dll
FREETYPE_DLL=freetype6.dll
# If you don't have the WPdpack, comment this line out, so that
# PCAP_DIR isn't defined.
#
-PCAP_DIR=$(WIRESHARK_LIBS)\WPdpack
+PCAP_DIR=$(WIRESHARK_LIB_DIR)\WPdpack
# This macro is used by the nsis installer script, by the u3/portable apps and by the setup target.
PCAP_VERSION=4_1_2
# If you don't have Zlib, comment this line out, so that ZLIB_DIR isn't
# defined.
# EXperimental only use zlib 1.2.5 on win32 for now
-ZLIB_DIR=$(WIRESHARK_LIBS)\zlib125
+ZLIB_DIR=$(WIRESHARK_LIB_DIR)\zlib125
#
# Optional: the ADNS library enables asynchronous (nonblocking) DNS
#
# If C_ARES_DIR is defined below, it will override this setting.
#
-#ADNS_DIR=$(WIRESHARK_LIBS)\adns-1.0-win32-05ws
+#ADNS_DIR=$(WIRESHARK_LIB_DIR)\adns-1.0-win32-05ws
#
# Optional: the c-ares library enables asynchronous (nonblocking) DNS
# If you don't have KFW, comment this line out, so that KFW_DIR
# isn't defined.
#
-KFW_DIR=$(WIRESHARK_LIBS)\kfw-3-2-2-i386-ws-vc6
+KFW_DIR=$(WIRESHARK_LIB_DIR)\kfw-3-2-2-i386-ws-vc6
#
# Optional: the Nettle library enables ??? decryption.
# If you don't have Nettle, comment this line out, so that NETTLE_DIR
# isn't defined.
#
-# NETTLE_DIR=$(WIRESHARK_LIBS)\nettle-1.10
+# NETTLE_DIR=$(WIRESHARK_LIB_DIR)\nettle-1.10
#
# Optional: the LUA library enables scripting support.
# isn't defined.
#
LUA_DIST=5_1_4_Win32_dll6
-LUA_DIR=$(WIRESHARK_LIBS)\lua5.1.4
+LUA_DIR=$(WIRESHARK_LIB_DIR)\lua5.1.4
#
# Optional: the PORTAUDIO library enables audio output for RTP streams.
# If you don't have PORTAUDIO, comment this line out, so that
# PORTAUDIO_DIR isn't defined.
#
-#PORTAUDIO_DIR=$(WIRESHARK_LIBS)\portaudio_v18_1
-PORTAUDIO_DIR=$(WIRESHARK_LIBS)\portaudio_v19_2
+#PORTAUDIO_DIR=$(WIRESHARK_LIB_DIR)\portaudio_v18_1
+PORTAUDIO_DIR=$(WIRESHARK_LIB_DIR)\portaudio_v19_2
#
# Version number of PortAudio
# If you don't have the AirPcap developer's pack, comment this line out,
# so that AIRPCAP_DIR isn't defined.
#
-AIRPCAP_DIR=$(WIRESHARK_LIBS)\AirPcap_Devpack_4_1_0_1622\AirPcap_Devpack
+AIRPCAP_DIR=$(WIRESHARK_LIB_DIR)\AirPcap_Devpack_4_1_0_1622\AirPcap_Devpack
#
# Optional: LIBSMI, System Management Interface
# However, the Microsoft Platform SDK for Windows Server 2003 R2 provides
# these definitions. The SDK's SetEnv.bat script defines INETSDK.
!IF "$(MSVC_VARIANT)" != "MSVC6" || DEFINED(INETSDK)
-GEOIP_DIR=$(WIRESHARK_LIBS)\GeoIP-1.4.6-win32ws\libGeoIP
+GEOIP_DIR=$(WIRESHARK_LIB_DIR)\GeoIP-1.4.6-win32ws\libGeoIP
!ENDIF
!else
# If you want building with GTK+, set GTK_DIR to the pathname of the
# directory in which the "include" and "lib" directories reside.
#
-GTK_DIR=$(WIRESHARK_LIBS)\gtk2
+GTK_DIR=$(WIRESHARK_LIB_DIR)\gtk2
# These macros are used by the nsis installer script and by the install target.
PNG_DLL=libpng14-14.dll
#TIFF_DLL=libtiff-3.dll
# If you don't have the WPdpack, comment this line out, so that
# PCAP_DIR isn't defined.
#
-PCAP_DIR=$(WIRESHARK_LIBS)\WPdpack
+PCAP_DIR=$(WIRESHARK_LIB_DIR)\WPdpack
# This macro is used by the nsis installer script, by the u3/portable apps and by the setup target.
PCAP_VERSION=4_1_2
# If you don't have Zlib, comment this line out, so that ZLIB_DIR isn't
# defined.
#
-ZLIB_DIR=$(WIRESHARK_LIBS)\zlib125
+ZLIB_DIR=$(WIRESHARK_LIB_DIR)\zlib125
#
# Optional: the ADNS library enables asynchronous (nonblocking) DNS
#
# If C_ARES_DIR is defined below, it will override this setting.
#
-#ADNS_DIR=$(WIRESHARK_LIBS)\adns-1.0-win32-05ws
+#ADNS_DIR=$(WIRESHARK_LIB_DIR)\adns-1.0-win32-05ws
#
# Optional: the c-ares library enables asynchronous (nonblocking) DNS
# If you don't have KFW, comment this line out, so that KFW_DIR
# isn't defined.
#
-#KFW_DIR=$(WIRESHARK_LIBS)\kfw-3.2.2-ws1
+#KFW_DIR=$(WIRESHARK_LIB_DIR)\kfw-3.2.2-ws1
#
# Optional: the Nettle library enables ??? decryption.
# If you don't have Nettle, comment this line out, so that NETTLE_DIR
# isn't defined.
#
-# NETTLE_DIR=$(WIRESHARK_LIBS)\nettle-1.10
+# NETTLE_DIR=$(WIRESHARK_LIB_DIR)\nettle-1.10
#
# Optional: the LUA library enables scripting support.
# isn't defined.
#
LUA_DIST=5_1_4_Win64_dll9
-LUA_DIR=$(WIRESHARK_LIBS)\lua5.1.4
+LUA_DIR=$(WIRESHARK_LIB_DIR)\lua5.1.4
#
# Optional: the PORTAUDIO library enables audio output for RTP streams.
# If you don't have PORTAUDIO, comment this line out, so that
# PORTAUDIO_DIR isn't defined.
#
-#PORTAUDIO_DIR=$(WIRESHARK_LIBS)\portaudio_v18_1
-PORTAUDIO_DIR=$(WIRESHARK_LIBS)\portaudio_v19_2
+#PORTAUDIO_DIR=$(WIRESHARK_LIB_DIR)\portaudio_v18_1
+PORTAUDIO_DIR=$(WIRESHARK_LIB_DIR)\portaudio_v19_2
#
# Version number of PortAudio
# If you don't have the AirPcap developer's pack, comment this line out,
# so that AIRPCAP_DIR isn't defined.
#
-AIRPCAP_DIR=$(WIRESHARK_LIBS)\AirPcap_Devpack_4_1_0_1622\AirPcap_Devpack
+AIRPCAP_DIR=$(WIRESHARK_LIB_DIR)\AirPcap_Devpack_4_1_0_1622\AirPcap_Devpack
#
# Optional: LIBSMI, System Management Interface
#
# Used to map IP addresses to MaxMind GeoIP database entries
#
-GEOIP_DIR=$(WIRESHARK_LIBS)\GeoIP-1.4.6-win64ws\libGeoIP
+GEOIP_DIR=$(WIRESHARK_LIB_DIR)\GeoIP-1.4.6-win64ws\libGeoIP
!endif
# comment this line out, so that UPX isn't defined.
#
-UPX=$(WIRESHARK_LIBS)\upx303w\upx.exe
+UPX=$(WIRESHARK_LIB_DIR)\upx303w\upx.exe
##### Flags, PATHs and Miscellaneous #####
!ELSEIF "$(WIRESHARK_TARGET_PLATFORM)" == "win64"
# We're not creating portable packages and therefore don't have to worry about
# "deploying using xcopy"
-VCREDIST_EXE=$(WIRESHARK_LIBS)\vcredist_$(TARGET_MACHINE).exe
+VCREDIST_EXE=$(WIRESHARK_LIB_DIR)\vcredist_$(TARGET_MACHINE).exe
!ELSEIF "$(MSVC_VARIANT)" == "MSVC2002"
# you probably need to tweak this directory if you don't use the professional edition!
!ELSEIF "$(MSVC_VARIANT)" == "MSVC2005EE" || "$(MSVC_VARIANT)" == "DOTNET20" || "$(MSVC_VARIANT)" == "MSVC2008EE"
# you need to download the redistributable package vcredist_x86.exe from Microsoft first,
# and copy it to the lib folder!!!
-VCREDIST_EXE=$(WIRESHARK_LIBS)\vcredist_$(TARGET_MACHINE).exe
+VCREDIST_EXE=$(WIRESHARK_LIB_DIR)\vcredist_$(TARGET_MACHINE).exe
!ELSEIF "$(MSVC_VARIANT)" == "MSVC2008"
MSVCR_DLL=$(PROGRAM_FILES)\Microsoft Visual Studio 9.0\VC\redist\$(PROCESSOR_ARCHITECTURE)\Microsoft.VC90.CRT\*.*
!ELSEIF "$(MSVC_VARIANT)" == "MSVC2010EE"
# you need to download the redistributable package vcredist_x86.exe from Microsoft first,
# and copy it to the lib folder!!!
-VCREDIST_EXE=$(WIRESHARK_LIBS)\vcredist_$(TARGET_MACHINE).exe
+VCREDIST_EXE=$(WIRESHARK_LIB_DIR)\vcredist_$(TARGET_MACHINE).exe
!ELSEIF "$(MSVC_VARIANT)" == "MSVC2010"
MSVCR_DLL=$(PROGRAM_FILES)\Microsoft Visual Studio 10.0\VC\redist\$(TARGET_MACHINE)\Microsoft.VC100.CRT\*.*
!IFDEF C_ARES_PKG
!UNDEF ADNS_DIR
-C_ARES_DIR=$(WIRESHARK_LIBS)\c-ares-$(C_ARES_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws
+C_ARES_DIR=$(WIRESHARK_LIB_DIR)\c-ares-$(C_ARES_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws
C_ARES_CFLAGS=/I$(C_ARES_DIR)/include
C_ARES_LIBS=$(C_ARES_DIR)\lib\libcares-2.lib
C_ARES_DLL=$(C_ARES_DIR)\bin\libcares-2.dll
!IFDEF ADNS_DIR
ADNS_PATH=$(ADNS_DIR)\adns_win32\lib
ADNS_CFLAGS=/I$(ADNS_DIR)\src /I$(ADNS_DIR)\adns_win32
-ADNS_LIBS=$(WIRESHARK_LIBS)\$(MSVC_VARIANT)\adns\adns_dll.lib
-ADNS_DLL=$(WIRESHARK_LIBS)\$(MSVC_VARIANT)\adns\adns_dll.dll
+ADNS_LIBS=$(WIRESHARK_LIB_DIR)\$(MSVC_VARIANT)\adns\adns_dll.lib
+ADNS_DLL=$(WIRESHARK_LIB_DIR)\$(MSVC_VARIANT)\adns\adns_dll.dll
# Nmake uses carets to escape special characters
ADNS_CONFIG=^#define HAVE_GNU_ADNS 1
!else
!ENDIF
!IFDEF GNUTLS_PKG
-GNUTLS_DIR=$(WIRESHARK_LIBS)\gnutls-$(GNUTLS_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws
+GNUTLS_DIR=$(WIRESHARK_LIB_DIR)\gnutls-$(GNUTLS_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws
GNUTLS_PATH=$(GNUTLS_DIR)
# /DNOCRYPT avoids inclusion of Wincrypt.h, avoiding a X509_NAME define clash
GNUTLS_CFLAGS=/I$(GNUTLS_DIR)\include /DNOCRYPT /DIMPORT_LIGNUTLSDLL
!ENDIF
!IFDEF SMI_PKG
-SMI_DIR=$(WIRESHARK_LIBS)\libsmi-$(SMI_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws
+SMI_DIR=$(WIRESHARK_LIB_DIR)\libsmi-$(SMI_PKG)-$(WIRESHARK_TARGET_PLATFORM)ws
SMI_CONFIG=^#define HAVE_LIBSMI 1
SMI_CFLAGS=/I$(SMI_DIR)\include
SMI_LIBS=$(SMI_DIR)\lib\libsmi-2.lib
<chapter id="ChapterLibraries">
<title>Library Reference</title>
-
+
<section id="ChLibIntro">
<title>Introduction</title>
<para>
<para>
Win32: All libraries for the VS9 generation are available at:
<ulink url="http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/"/>,
- but see <xref linkend="ChLibsSetup"/> for an easier way to install the
+ but see <xref linkend="ChLibsSetup"/> for an easier way to install the
libraries.
</para>
</tip>
</tip>
</para>
</section>
-
+
<section id="ChLibsFormat">
<title>Binary library formats</title>
<para>
- Binary libraries are available in different formats, depending on the C
+ Binary libraries are available in different formats, depending on the C
compiler used to build it and of course the platform they were built for.
</para>
-
+
<section id="ChLibsFormatUnix">
<title>Unix</title>
<para>
- If you have installed unix binary libraries on your system, they will
+ If you have installed unix binary libraries on your system, they will
match the C compiler. If not already installed, the libraries should be
available as a package from the platform installer, or you can download
and compile the source and then install the binaries.
<section id="ChLibsFormatWin32Cygwin">
<title>Win32: cygwin gcc</title>
<para>
- Cygwin provides most of the required libraries (with file extension .a or .lib)
+ Cygwin provides most of the required libraries (with file extension .a or .lib)
for Wireshark suitable for cygwin's gcc compiler.
</para>
</section>
</section>
-
+
<section id="ChLibsSetup">
<title>Win32: Automated library download</title>
<section id="ChLibsSetupInitial">
<title>Initial download</title>
<para>
- You can download/install all required libraries by using the setup target
+ You can download/install all required libraries by using the setup target
of the <filename>Makefile.nmake</filename> from the source package.
</para>
<tip><title>Tip!</title>
<para>
- It's a really good idea to use the Win32 automated library download to
+ It's a really good idea to use the Win32 automated library download to
install the required libraries as it makes this download very easy.
</para>
</tip>
<note><title>Note!</title>
<para>
Before you start the download, you must have installed both
- the required tools (see <xref linkend="ChapterTools"/>) and also the
+ the required tools (see <xref linkend="ChapterTools"/>) and also the
Wireshark sources (see <xref linkend="ChSrcObtain"/>).
</para>
</note>
<para>
- By default the libraries will be downloaded and installed into
+ By default the libraries will be downloaded and installed into
<filename>C:\wireshark-win32-libs</filename>.
You can change this to any other location by editing the file
- <filename>config.nmake</filename> and changing the line containing
- the WIRESHARK_LIBS setting to your favourite place (use an absolute path
+ <filename>config.nmake</filename> and changing the line containing
+ the WIRESHARK_LIB_DIR setting to your favourite place (use an absolute path
here).
</para>
<para>
as described already in <xref linkend="ChToolsWin32Verify"/>.
</para>
<para>
- Then it will download the zipped libraries (together around 30MB!) from
- the server location at: <ulink
- url="http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/"/>
- into the directory specified by WIRESHARK_LIBS and install (unzip) all
+ Then it will download the zipped libraries (together around 30MB!) from
+ the server location at: <ulink
+ url="http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/"/>
+ into the directory specified by WIRESHARK_LIB_DIR and install (unzip) all
required library files there.
</para>
<para>
- If you have problems downloading the library files, you might be connected
- to the internet through a proxy/firewall.
+ If you have problems downloading the library files, you might be connected
+ to the internet through a proxy/firewall.
In this case see the wget proxy comment in <xref linkend="ChToolsWget"/>.
</para>
</section>
some new functionality, your libraries get outdated.
</para>
<para>
- You could simply remove everything in the WIRESHARK_LIBS dir and call the
- <userinput>setup</userinput> target again, but that would require a download of every file again,
+ You could simply remove everything in the WIRESHARK_LIB_DIR dir and call the
+ <userinput>setup</userinput> target again, but that would require a download of every file again,
which isn't necessary.
</para>
<para>
<itemizedlist>
<listitem>
<para>
- Update your Wireshark sources to the latest SVN files (see <xref
- linkend="ChSrcObtain"/>), so the zip filenames in the setup target
+ Update your Wireshark sources to the latest SVN files (see <xref
+ linkend="ChSrcObtain"/>), so the zip filenames in the setup target
of Makefile.nmake are in sync with the library zip files on the server.
</para>
</listitem>
<para>
<prompt>></prompt> <userinput>nmake -f Makefile.nmake setup</userinput>
</para>
- <para>
+ <para>
Note that this command will automatically do a <userinput>clean-setup</userinput> which will
- remove all files previously unzipped from the downloaded files in your
- WIRESHARK_LIBS library path (all the subdirs, e.g.
- <filename>c:\wireshark-win32-libs\gtk+</filename>),
- except for the zip files located at the toplevel, which are the files
+ remove all files previously unzipped from the downloaded files in your
+ WIRESHARK_LIB_DIR library path (all the subdirs, e.g.
+ <filename>c:\wireshark-win32-libs\gtk+</filename>),
+ except for the zip files located at the toplevel, which are the files
downloaded the last time(s).
</para>
<para>
- Also note that as wget will download only the
- missing (updated) files, existing zip files in the WIRESHARK_LIBS dir won't be
+ Also note that as wget will download only the
+ missing (updated) files, existing zip files in the WIRESHARK_LIB_DIR dir won't be
downloaded again. Remaining (outdated) zip files shouldn't do any harm.
</para>
</listitem>
</itemizedlist>
</section>
-
+
</section>
<section id="ChLibsGtk">
<title>GTK+ / GLib / GDK / Pango / ATK / GNU gettext / GNU libiconv</title>
<para>
- The Glib library is used as a basic platform abstraction library, it's
- not related to graphical user interface (GUI) things. For a detailed
+ The Glib library is used as a basic platform abstraction library, it's
+ not related to graphical user interface (GUI) things. For a detailed
description about GLib, see <xref linkend="ChCodeGLib"/>.
</para>
<para>
- The GTK and its dependent libraries are used to build Wireshark's GUI.
- For a detailed description of the GTK libraries, see <xref
+ The GTK and its dependent libraries are used to build Wireshark's GUI.
+ For a detailed description of the GTK libraries, see <xref
linkend="ChUIGTK"/>.
</para>
<para>
- All other libraries are dependent on the two libraries mentioned above,
- you will typically not come in touch with these while doing Wireshark
- development.
+ All other libraries are dependent on the two libraries mentioned above,
+ you will typically not come in touch with these while doing Wireshark
+ development.
</para>
<para>
As the requirements for the GLib/GTK libraries have increased in the past,
<section id="ChLibsUnixGTK">
<title>Unix</title>
<para>
- The GLib/GTK+ libraries are available for many unix-like platforms and
+ The GLib/GTK+ libraries are available for many unix-like platforms and
cygwin.
</para>
<para>
- If these libraries aren't already installed and also aren't available as a
- package for your platform, you can get them at:
+ If these libraries aren't already installed and also aren't available as a
+ package for your platform, you can get them at:
<ulink url="http://www.gtk.org/download.html"/>.
</para>
</section>
<section id="ChLibsWin32GTK">
<title>Win32 MSVC</title>
<para>
- You can get the latest version at:
+ You can get the latest version at:
<ulink url="http://www.gtk.org/download.html"/>.
</para>
</section>
</section>
-
+
<section id="ChLibsSMI">
<title>SMI (optional)</title>
<para>
"Various tools relating to the SMI MIB Information"
</para>
-
+
<section id="ChLibsUnixSMI">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.ibr.cs.tu-bs.de/projects/libsmi/"/>.
</para>
</section>
<section id="ChLibsWin32SMI">
<title>Win32 MSVC</title>
<para>
- Wireshark uses the source libSMI distribution at
+ Wireshark uses the source libSMI distribution at
<ulink url="http://www.ibr.cs.tu-bs.de/projects/libsmi/"/>.
libSMI is compiled using MSVC++ 6.0. It's stored in the libsmi zip archive at
<ulink url="http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/"/>
</para>
</section>
-
+
</section>
-
+
<section id="ChLibsCares">
<title>c-ares (optional)</title>
<para>
"Advanced, easy to use, asynchronous-capable DNS client library and
utilities."
</para>
-
+
<section id="ChLibsUnixADNS">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.gnu.org/software/adns/"/>.
</para>
</section>
<section id="ChLibsWin32ADNS">
<title>Win32 MSVC</title>
<para>
- You can get the latest version at:
+ You can get the latest version at:
<ulink url="http://adns.jgaa.com/"/>
</para>
</section>
-
+
</section>
-
+
<section id="ChLibsPCRE">
<title>PCRE (optional)</title>
wrapper around PCRE. Wireshark's configure script will use it instead of
PCRE if it is present.
</para>
-
+
<section id="ChLibsUnixPCRE">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.pcre.org/"/>.
</para>
</section>
<section id="ChLibsWin32PCRE">
<title>Win32 MSVC</title>
<para>
- You can get the latest version at:
+ You can get the latest version at:
<ulink url="http://gnuwin32.sourceforge.net/packages/pcre.htm"/>
</para>
</section>
-
+
</section>
-
-
+
+
<section id="ChLibsZlib">
<title>zlib (optional)</title>
<para>
- "zlib is designed to be a
+ "zlib is designed to be a
<ulink url="http://www.gzip.org/zlib/zlib_license.html">free</ulink>,
general-purpose, legally unencumbered -- that is, not covered by any
patents -- lossless data-compression library for use on virtually any computer
<section id="ChLibsUnixZlib">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.gzip.org/zlib/"/>.
</para>
</section>
<section id="ChLibsWin32Zlib">
<title>Win32 MSVC</title>
<para>
- You can get the latest version at:
+ You can get the latest version at:
<ulink url="http://gnuwin32.sourceforge.net/packages/zlib.htm"/>
</para>
<para>
</section>
</section>
-
-
+
+
<section id="ChLibsPcap">
<title>libpcap/WinPcap (optional)</title>
<para>
"packet capture library"
</para>
-
+
<section id="ChLibsLibpcap">
<title>Unix: libpcap</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.tcpdump.org/"/>.
</para>
</section>
<section id="ChLibsGNUTLS">
<title>GnuTLS (optional)</title>
<para>
- The "GNU Transport Layer Security Library" is used to dissect SSL and TLS
+ The "GNU Transport Layer Security Library" is used to dissect SSL and TLS
protocols (aka: HTTPS).
</para>
-
+
<section id="ChLibsUnixGNUTLS">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.gnu.org/software/gnutls/download.html"/>.
</para>
</section>
<section id="ChLibsWin32GNUTLS">
<title>Win32 MSVC</title>
<para>
- We roll our own version using:
+ We roll our own version using:
<ulink url="http://josefsson.org/gnutls4win/"/>
</para>
</section>
<section id="ChLibsGcrypt">
<title>Gcrypt (optional)</title>
<para>
- The "Gcrypt Library" is Low-level encryption library and provides
+ The "Gcrypt Library" is Low-level encryption library and provides
support for many ciphers, such as DES, 3DES, AES, Blowfish, and others..
</para>
-
+
<section id="ChLibsUnixGcrypt">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://directory.fsf.org/security/libgcrypt.html"/>.
</para>
</section>
<section id="ChLibsKerberos">
<title>Kerberos (optional)</title>
<para>
- The Kerberos library is used to dissect Kerberos, sealed DCERPC and
+ The Kerberos library is used to dissect Kerberos, sealed DCERPC and
secureLDAP protocols.
</para>
-
+
<section id="ChLibsUnixKerberos">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://web.mit.edu/Kerberos/dist/"/>.
</para>
<para>
<section id="ChLibsWin32Kerberos">
<title>Win32 MSVC</title>
<para>
- You can get the latest version of KfW "Kerberos for Windows" at:
+ You can get the latest version of KfW "Kerberos for Windows" at:
<ulink url="http://web.mit.edu/Kerberos/dist/"/>
</para>
</section>
<para>
The LUA library is used to add scripting support to Wireshark.
</para>
-
+
<section id="ChLibsUnixLua">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.lua.org/download.html"/>.
</para>
</section>
<section id="ChLibsWin32Lua">
<title>Win32 MSVC</title>
<para>
- You can get the latest version at:
+ You can get the latest version at:
<ulink url="http://luaforge.net/frs/?group_id=110"/>
</para>
</section>
<para>
The PortAudio library enables audio output for RTP streams.
</para>
-
+
<section id="ChLibsUnixPortAudio">
<title>Unix</title>
<para>
- If this library isn't already installed or available as a
- package for your platform, you can get it at:
+ If this library isn't already installed or available as a
+ package for your platform, you can get it at:
<ulink url="http://www.portaudio.com/download.html"/>.
</para>
</section>
<section id="ChLibsWin32PortAudio">
<title>Win32 MSVC</title>
<para>
- You can get the latest version at:
+ You can get the latest version at:
<ulink url="http://www.portaudio.com/download.html"/>
</para>
</section>
git.samba.org / obnox / wireshark / wip.git / commitdiff