forked from osmocom/wireshark
Convert the libraries chapter to AsciiDoc.
Add some docbook-related entries to .gitignore. Whoever maintains the Windows libraries has done a terrible job of keeping this chapter up to date. Change-Id: Ic6dcbd9e8369eae9f07403bd3f805a515886f542 Reviewed-on: https://code.wireshark.org/review/72 Reviewed-by: Gerald Combs <gerald@wireshark.org> Tested-by: Gerald Combs <gerald@wireshark.org>daniel/osmux
Gerald Combs
Gerald Combs
parent
bdafbad955
commit
ec6fc7690b
|
|
@ -117,6 +117,11 @@ doxygen.cfg
|
|||
help/faq.txt
|
||||
pod2htm[di].tmp
|
||||
wireshark.pod
|
||||
docbook/ws?g_src/WS?G_*.dbk
|
||||
docbook/*-guide-*.fo
|
||||
docbook/*-guide-*.pdf
|
||||
docbook/ws?g_html/
|
||||
docbook/ws?g_html_chunked/
|
||||
|
||||
# Qt #
|
||||
######
|
||||
|
|
|
|||
|
|
@ -186,7 +186,7 @@ set(WSDG_FILES
|
|||
wsdg_src/WSDG_chapter_capture.xml
|
||||
wsdg_src/WSDG_chapter_dissection.xml
|
||||
wsdg_generated_src/WSDG_chapter_env_intro.xml
|
||||
wsdg_src/WSDG_chapter_libraries.xml
|
||||
wsdg_generated_src/WSDG_chapter_libraries.xml
|
||||
wsdg_generated_src/WSDG_chapter_quick_setup.xml
|
||||
wsdg_generated_src/WSDG_chapter_sources.xml
|
||||
wsdg_generated_src/WSDG_chapter_tools.xml
|
||||
|
|
@ -199,6 +199,7 @@ set(WSDG_FILES
|
|||
|
||||
set(WSDG_ASCIIDOC_FILES
|
||||
wsdg_src/WSDG_chapter_env_intro.asciidoc
|
||||
wsdg_src/WSDG_chapter_libraries.asciidoc
|
||||
wsdg_src/WSDG_chapter_quick_setup.xml
|
||||
wsdg_src/WSDG_chapter_sources.asciidoc
|
||||
wsdg_src/WSDG_chapter_tools.asciidoc
|
||||
|
|
|
|||
|
|
@ -163,7 +163,7 @@ WSDG_FILES = \
|
|||
wsdg_src/WSDG_chapter_capture.xml \
|
||||
wsdg_src/WSDG_chapter_dissection.xml \
|
||||
wsdg_src/WSDG_chapter_env_intro.asciidoc \
|
||||
wsdg_src/WSDG_chapter_libraries.xml \
|
||||
wsdg_src/WSDG_chapter_libraries.asciidoc \
|
||||
wsdg_src/WSDG_chapter_quick_setup.asciidoc \
|
||||
wsdg_src/WSDG_chapter_sources.asciidoc \
|
||||
wsdg_src/WSDG_chapter_tools.asciidoc \
|
||||
|
|
@ -175,6 +175,7 @@ WSDG_FILES = \
|
|||
|
||||
WSDG_GENERATED_SOURCE = \
|
||||
wsdg_src/WSDG_chapter_env_intro.xml \
|
||||
wsdg_src/WSDG_chapter_libraries.xml \
|
||||
wsdg_src/WSDG_chapter_quick_setup.xml \
|
||||
wsdg_src/WSDG_chapter_sources.xml \
|
||||
wsdg_src/WSDG_chapter_tools.xml \
|
||||
|
|
|
|||
|
|
@ -0,0 +1,416 @@
|
|||
++++++++++++++++++++++++++++++++++++++
|
||||
<!-- WSDG Chapter Libraries -->
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
|
||||
[[ChapterLibraries]]
|
||||
|
||||
== Library Reference
|
||||
|
||||
[[ChLibIntro]]
|
||||
|
||||
=== Introduction
|
||||
|
||||
Several libraries are needed to build and run Wireshark. Most of them
|
||||
are split into three packages:
|
||||
|
||||
. 'Runtime'. System and third party libraries such as 'MSVCR110.dll' and 'libglib-2.0-0.dll'.
|
||||
|
||||
. 'Developer'. Documentation, header files, import libraries, and other files needed for compilation.
|
||||
|
||||
. 'Source'. Library sources, which are usually not required to
|
||||
build Wireshark.
|
||||
|
||||
[TIP]
|
||||
.Our libraries are freely available
|
||||
====
|
||||
All libraries required to build Wireshark on Windows are available for download at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[] and
|
||||
http://anonsvn.wireshark.org/wireshark-win64-libs/trunk/packages/[].
|
||||
See <<ChLibsSetup>> for an easier way to install them.
|
||||
====
|
||||
|
||||
[[ChLibsFormat]]
|
||||
|
||||
=== Binary library formats
|
||||
|
||||
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.
|
||||
|
||||
|
||||
[[ChLibsFormatUnix]]
|
||||
|
||||
|
||||
==== Unix
|
||||
|
||||
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.
|
||||
|
||||
|
||||
[[ChLibsFormatWin32]]
|
||||
|
||||
|
||||
==== Win32: MSVC
|
||||
|
||||
Most of the Win32 binary libraries you will find on the web are in this
|
||||
format. You will recognize MSVC libraries by the .lib/.dll file extension.
|
||||
|
||||
|
||||
[[ChLibsFormatWin32Cygwin]]
|
||||
|
||||
|
||||
==== Win32: cygwin gcc
|
||||
|
||||
Cygwin provides most of the required libraries (with file extension .a or .lib)
|
||||
for Wireshark suitable for cygwin's gcc compiler.
|
||||
|
||||
|
||||
[[ChLibsSetup]]
|
||||
|
||||
|
||||
=== Win32: Automated library download
|
||||
|
||||
[[ChLibsSetupInitial]]
|
||||
|
||||
|
||||
==== Initial download
|
||||
|
||||
You can download and install all required libraries by using the `setup` target
|
||||
of 'Makefile.nmake' from the source package.
|
||||
|
||||
[TIP]
|
||||
.Use the setup target
|
||||
====
|
||||
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.
|
||||
|
||||
Before you start the download, you must have installed both the required tools
|
||||
(see <<ChapterTools>>) and the Wireshark sources (see <<ChSrcObtain>>).
|
||||
====
|
||||
|
||||
By default the libraries will be downloaded and installed into
|
||||
'C:\wireshark-win32-libs' for x86 builds and 'C:\wireshark-win64-libs' for x86_64 builds.
|
||||
You can change this to any other location by editing
|
||||
'config.nmake' and changing the line containing
|
||||
WIRESHARK_LIB_DIR to your favourite place. You must use an absolute path.
|
||||
|
||||
Then run the command
|
||||
|
||||
----
|
||||
> nmake -f Makefile.nmake setup
|
||||
----
|
||||
|
||||
This will first check for all the various tools needed to build Wireshark
|
||||
as described in <<ChToolsWin32Verify>>.
|
||||
|
||||
Then it will download the zipped libraries (together around 30MB!) from the
|
||||
server location at
|
||||
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.
|
||||
|
||||
If you have problems downloading the library files, you might be connected to
|
||||
the internet through a proxy. In this case see the wget proxy comment in
|
||||
<<ChToolsWget>>.
|
||||
|
||||
[[ChLibsSetupUpdate]]
|
||||
|
||||
==== Update of a previous download
|
||||
|
||||
As new versions of the libraries become available, maybe with bugfixes or
|
||||
some new functionality, your libraries get outdated.
|
||||
|
||||
You could simply remove everything in the WIRESHARK_LIB_DIR dir and call the
|
||||
`setup` target again, but that would require a download of every file again,
|
||||
which isn't necessary.
|
||||
|
||||
The following will bring your libraries up to date:
|
||||
|
||||
* Update your Wireshark sources to the latest SVN files (see <<ChSrcObtain>>), so the zip filenames in the setup target
|
||||
of Makefile.nmake are in sync with the library zip files on the server.
|
||||
|
||||
* Execute the library setup command as described above.
|
||||
+
|
||||
--
|
||||
----
|
||||
> nmake -f Makefile.nmake setup
|
||||
----
|
||||
|
||||
Note that this command will automatically do a `clean-setup` which will
|
||||
remove all files previously unzipped from the downloaded files in your
|
||||
WIRESHARK_LIB_DIR library path (all the subdirs, e.g.
|
||||
'$$c:\wireshark-win32-libs\gtk+$$'),
|
||||
except for the zip files located at the toplevel, which are the files
|
||||
downloaded the last time(s).
|
||||
|
||||
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.
|
||||
--
|
||||
|
||||
[[ChLibsGtk]]
|
||||
|
||||
=== GTK+ / GLib / GDK / Pango / ATK / GNU gettext / GNU libiconv
|
||||
|
||||
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 <<ChCodeGLib>>.
|
||||
|
||||
The GTK and its dependent libraries are used to build Wireshark's GUI.
|
||||
For a detailed description of the GTK libraries, see <<ChUIGTK>>.
|
||||
|
||||
All other libraries are dependent on the two libraries mentioned above,
|
||||
you will typically not come in touch with these while doing Wireshark
|
||||
development.
|
||||
|
||||
As the requirements for the GLib/GTK libraries have increased in the past,
|
||||
the required additional libraries depend on the GLib/GTK versions you have.
|
||||
The 2.x versions require all mentioned libs.
|
||||
|
||||
[[ChLibsUnixGTK]]
|
||||
|
||||
|
||||
==== Unix
|
||||
|
||||
The GLib/GTK+ libraries are available for many unix-like platforms and
|
||||
Cygwin.
|
||||
|
||||
If these libraries aren't already installed and also aren't available as a
|
||||
package for your platform, you can get them at
|
||||
http://www.gtk.org/download.html[].
|
||||
|
||||
[[ChLibsWin32GTK]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
You can get the latest version at http://www.gtk.org/download.html[].
|
||||
|
||||
[[ChLibsSMI]]
|
||||
|
||||
=== SMI (optional)
|
||||
|
||||
LibSMI is used for MIB and PIB parsing and for OID resolution.
|
||||
|
||||
[[ChLibsUnixSMI]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://www.ibr.cs.tu-bs.de/projects/libsmi/[].
|
||||
|
||||
[[ChLibsWin32SMI]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
Wireshark uses the source libSMI distribution at
|
||||
http://www.ibr.cs.tu-bs.de/projects/libsmi/[].
|
||||
LibSMI is cross-compiled using MinGW32. It's stored in the libsmi zip archive at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[].
|
||||
|
||||
[[ChLibsCares]]
|
||||
|
||||
=== c-ares (optional)
|
||||
|
||||
C-Ares is used for asynchronous DNS resolution. This is the primary name
|
||||
resolution library in Wireshark.
|
||||
|
||||
[[ChLibsUnixCares]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a package for your
|
||||
platform, you can get it at http://c-ares.haxx.se/[].
|
||||
|
||||
[[ChLibsWin32Cares]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
C-Ares is cross-compiled using MinGW32 and is available at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[].
|
||||
|
||||
[[ChLibsZlib]]
|
||||
|
||||
=== zlib (optional)
|
||||
|
||||
[quote, The zlib web site, http://www.zlib.net/]
|
||||
____
|
||||
zlib is designed to be a
|
||||
http://www.gzip.org/zlib/zlib_license.html[free],
|
||||
general-purpose, legally unencumbered -- that is, not covered by any
|
||||
patents -- lossless data-compression library for use on virtually any computer
|
||||
hardware and operating system.
|
||||
____
|
||||
|
||||
[[ChLibsUnixZlib]]
|
||||
|
||||
==== Unix
|
||||
|
||||
This library is almost certain to be installed on your system. If it isn't or
|
||||
you don't want to use the default library you can download it from
|
||||
http://www.zlib.net/[].
|
||||
|
||||
[[ChLibsWin32Zlib]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
The zlib sources are downloaded from
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[] and compiled
|
||||
locally.
|
||||
|
||||
[[ChLibsPcap]]
|
||||
|
||||
=== libpcap/WinPcap (optional)
|
||||
|
||||
Libpcap and WinPcap provide that packet capture capabilities that are central
|
||||
to Wireshark's core functionality.
|
||||
|
||||
[[ChLibsLibpcap]]
|
||||
|
||||
==== Unix: libpcap
|
||||
|
||||
If this library isn't already installed or available as a package for your
|
||||
platform, you can get it at http://www.tcpdump.org/[].
|
||||
|
||||
[[ChLibsWinpPcap]]
|
||||
|
||||
==== Win32 MSVC: WinPcap
|
||||
|
||||
You can get the "Windows packet capture library" at:
|
||||
http://www.winpcap.org/install/[]
|
||||
|
||||
[[ChLibsGNUTLS]]
|
||||
|
||||
=== GnuTLS (optional)
|
||||
|
||||
The GNU Transport Layer Security Library is used to dissect SSL and TLS
|
||||
protocols (aka: HTTPS).
|
||||
|
||||
[[ChLibsUnixGNUTLS]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://www.gnu.org/software/gnutls/download.html[].
|
||||
|
||||
[[ChLibsWin32GNUTLS]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
We provide a package cross-compiled using MinGW32 at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[].
|
||||
|
||||
[[ChLibsGcrypt]]
|
||||
|
||||
=== Gcrypt (optional)
|
||||
|
||||
The Gcrypt Library is a low-level encryption library that provides
|
||||
support for many ciphers, such as DES, 3DES, AES, Blowfish, and others..
|
||||
|
||||
[[ChLibsUnixGcrypt]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://directory.fsf.org/security/libgcrypt.html[].
|
||||
|
||||
[[ChLibsWin32Gcrypt]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
Part of our GnuTLS package.
|
||||
|
||||
[[ChLibsKerberos]]
|
||||
|
||||
=== Kerberos (optional)
|
||||
|
||||
The Kerberos library is used to dissect Kerberos, sealed DCERPC and
|
||||
secureLDAP protocols.
|
||||
|
||||
[[ChLibsUnixKerberos]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://web.mit.edu/Kerberos/dist/[].
|
||||
|
||||
[[ChLibsWin32Kerberos]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
We provide a package at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[].
|
||||
|
||||
[[ChLibsLua]]
|
||||
|
||||
=== LUA (optional)
|
||||
|
||||
The LUA library is used to add scripting support to Wireshark.
|
||||
|
||||
[[ChLibsUnixLua]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://www.lua.org/download.html[].
|
||||
|
||||
[[ChLibsWin32Lua]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
We provide a copy of the official package at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[].
|
||||
|
||||
[[ChLibsPortAudio]]
|
||||
|
||||
=== PortAudio (optional)
|
||||
|
||||
The PortAudio library enables audio output for RTP streams.
|
||||
|
||||
[[ChLibsUnixPortAudio]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://www.portaudio.com/download.html[].
|
||||
|
||||
[[ChLibsWin32PortAudio]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
The PortAudio sources are downloaded from
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[] and compiled
|
||||
locally.
|
||||
|
||||
[[ChLibsGeoIP]]
|
||||
|
||||
=== GeoIP (optional)
|
||||
|
||||
MaxMind Inc. publishes a GeoIP database for use in open source software.
|
||||
It can be used to map IP addresses to geographical locations.
|
||||
|
||||
[[ChLibsUnixGeoIP]]
|
||||
|
||||
==== Unix
|
||||
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at
|
||||
http://www.maxmind.com/app/c[].
|
||||
|
||||
[[ChLibsWin32GeoIP]]
|
||||
|
||||
==== Win32 MSVC
|
||||
|
||||
We provide a package cross-compiled using MinGW32 at
|
||||
http://anonsvn.wireshark.org/wireshark-win32-libs/trunk/packages/[].
|
||||
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
<!-- End of WSDG Chapter Libraries -->
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
|
||||
|
|
@ -1,524 +0,0 @@
|
|||
<!-- WSDG Chapter Libraries -->
|
||||
<!-- $Id$ -->
|
||||
|
||||
<chapter id="ChapterLibraries">
|
||||
<title>Library Reference</title>
|
||||
|
||||
<section id="ChLibIntro">
|
||||
<title>Introduction</title>
|
||||
<para>
|
||||
Several libraries are needed to build / run Wireshark. Most of the
|
||||
libraries are split into three packages:
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
Runtime package: binaries (e.g. win32 DLL's) and alike
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Developer package: documentation, header files and alike
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Source package: library sources, usually not required to
|
||||
build Wireshark
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<tip><title>Tip!</title>
|
||||
<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
|
||||
libraries.
|
||||
</para>
|
||||
</tip>
|
||||
<tip><title>Tip!</title>
|
||||
<para>
|
||||
Win64: All required libraries for the VS9 generation are available at:
|
||||
<ulink url="http://anonsvn.wireshark.org/wireshark-win64-libs/trunk/packages/"/>,
|
||||
but see <xref linkend="ChLibsSetup"/> for an easier way to install the
|
||||
libraries. Not all libraries are available, yet.
|
||||
</para>
|
||||
</tip>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsFormat">
|
||||
<title>Binary library formats</title>
|
||||
<para>
|
||||
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
|
||||
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.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsFormatWin32">
|
||||
<title>Win32: MSVC</title>
|
||||
<para>
|
||||
Most of the Win32 binary libraries you will find on the web are in this
|
||||
format. You will recognize MSVC libraries by the .lib/.dll file extension.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsFormatWin32Cygwin">
|
||||
<title>Win32: cygwin gcc</title>
|
||||
<para>
|
||||
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
|
||||
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
|
||||
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
|
||||
Wireshark sources (see <xref linkend="ChSrcObtain"/>).
|
||||
</para>
|
||||
</note>
|
||||
<para>
|
||||
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_LIB_DIR setting to your favourite place (use an absolute path
|
||||
here).
|
||||
</para>
|
||||
<para>
|
||||
Then enter at the command line:
|
||||
</para>
|
||||
<para>
|
||||
<prompt>></prompt> <userinput>nmake -f Makefile.nmake setup</userinput>
|
||||
</para>
|
||||
<para>
|
||||
This will first check for all the various tools needed to build Wireshark,
|
||||
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_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.
|
||||
In this case see the wget proxy comment in <xref linkend="ChToolsWget"/>.
|
||||
</para>
|
||||
</section>
|
||||
<section id="ChLibsSetupUpdate">
|
||||
<title>Update of a previous download</title>
|
||||
<para>
|
||||
As new versions of the libraries become available, maybe with bugfixes or
|
||||
some new functionality, your libraries get outdated.
|
||||
</para>
|
||||
<para>
|
||||
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>
|
||||
The following will bring your libraries up to date:
|
||||
</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
|
||||
of Makefile.nmake are in sync with the library zip files on the server.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
Execute the library setup command as described above.
|
||||
</para>
|
||||
<para>
|
||||
<prompt>></prompt> <userinput>nmake -f Makefile.nmake setup</userinput>
|
||||
</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_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_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
|
||||
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
|
||||
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.
|
||||
</para>
|
||||
<para>
|
||||
As the requirements for the GLib/GTK libraries have increased in the past,
|
||||
the required additional libraries depend on the GLib/GTK versions you have.
|
||||
The 2.x versions require all mentioned libs.
|
||||
</para>
|
||||
|
||||
<section id="ChLibsUnixGTK">
|
||||
<title>Unix</title>
|
||||
<para>
|
||||
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:
|
||||
<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:
|
||||
<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:
|
||||
<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
|
||||
<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>
|
||||
"Library for asynchronous name resolves."
|
||||
</para>
|
||||
<para>
|
||||
This is the primary name resolving library for Wireshark. It replaces ADNS.
|
||||
</para>
|
||||
<section id="ChLibsUnixCares">
|
||||
<title>Unix</title>
|
||||
<para>
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at:
|
||||
<ulink url="http://c-ares.haxx.se/"/>.
|
||||
</para>
|
||||
</section>
|
||||
<section id="ChLibsWin32Cares">
|
||||
<title>Win32 MSVC</title>
|
||||
<para>
|
||||
You can get the latest version at:
|
||||
<ulink url="http://c-ares.haxx.se/"/>.
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsADNS">
|
||||
<title>GNU adns (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:
|
||||
<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:
|
||||
<ulink url="http://adns.jgaa.com/"/>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
|
||||
<section id="ChLibsZlib">
|
||||
<title>zlib (optional)</title>
|
||||
<para>
|
||||
"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
|
||||
hardware and operating system."
|
||||
</para>
|
||||
|
||||
<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:
|
||||
<ulink url="http://www.gzip.org/zlib/"/>.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsWin32Zlib">
|
||||
<title>Win32 MSVC</title>
|
||||
<para>
|
||||
You can get the latest version at:
|
||||
<ulink url="http://gnuwin32.sourceforge.net/packages/zlib.htm"/>
|
||||
</para>
|
||||
<para>
|
||||
(A version for the MSVC2003 compiler can be found at:
|
||||
<ulink url="http://www.winimage.com/zLibDll/"/>)
|
||||
</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:
|
||||
<ulink url="http://www.tcpdump.org/"/>.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsWinpPcap">
|
||||
<title>Win32 MSVC: WinPcap</title>
|
||||
<para>
|
||||
You can get the "Windows packet capture library" at:
|
||||
<ulink url="http://www.winpcap.org/install/default.htm"/>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
|
||||
<section id="ChLibsGNUTLS">
|
||||
<title>GnuTLS (optional)</title>
|
||||
<para>
|
||||
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:
|
||||
<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:
|
||||
<ulink url="http://josefsson.org/gnutls4win/"/>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
<section id="ChLibsGcrypt">
|
||||
<title>Gcrypt (optional)</title>
|
||||
<para>
|
||||
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:
|
||||
<ulink url="http://directory.fsf.org/security/libgcrypt.html"/>.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsWin32Gcrypt">
|
||||
<title>Win32 MSVC</title>
|
||||
<para>
|
||||
Part of our homemade GnuTLS package.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
<section id="ChLibsKerberos">
|
||||
<title>Kerberos (optional)</title>
|
||||
<para>
|
||||
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:
|
||||
<ulink url="http://web.mit.edu/Kerberos/dist/"/>.
|
||||
</para>
|
||||
<para>
|
||||
XXX - Is it supported on *NIX at all?
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsWin32Kerberos">
|
||||
<title>Win32 MSVC</title>
|
||||
<para>
|
||||
You can get the latest version of KfW "Kerberos for Windows" at:
|
||||
<ulink url="http://web.mit.edu/Kerberos/dist/"/>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
<section id="ChLibsLua">
|
||||
<title>LUA (optional)</title>
|
||||
<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:
|
||||
<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:
|
||||
<ulink url="http://luaforge.net/frs/?group_id=110"/>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
<section id="ChLibsPortAudio">
|
||||
<title>PortAudio (optional)</title>
|
||||
<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:
|
||||
<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:
|
||||
<ulink url="http://www.portaudio.com/download.html"/>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
|
||||
<section id="ChLibsGeoIP">
|
||||
<title>GeoIP (optional)</title>
|
||||
<para>
|
||||
MaxMind Inc. publishes a GeoIP database for use in open source software.
|
||||
It can be used to map IP addresses to geographical locations.
|
||||
</para>
|
||||
|
||||
<section id="ChLibsUnixGeoIP">
|
||||
<title>Unix</title>
|
||||
<para>
|
||||
If this library isn't already installed or available as a
|
||||
package for your platform, you can get it at:
|
||||
<ulink url="http://www.maxmind.com/app/c"/>.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="ChLibsWin32GeoIP">
|
||||
<title>Win32 MSVC</title>
|
||||
<para>
|
||||
You can get the latest version at:
|
||||
<ulink url="http://www.maxmind.com/app/c"/>
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
</chapter>
|
||||
<!-- End of WSDG Chapter Libraries -->
|
||||
Loading…
Reference in New Issue