There are several ways to obtain the latest development source tree:

Subversion (SVN)

You can use a a Subversion client to download the source code from Ethereal's anonymous SVN repository. The URL for the repository trunk is http://anonsvn.ethereal.com/ethereal/trunk. For example, to check out using the command-line Subversion client, you would type

Along with the traditional command-line client, several GUI clients are available for a number of platforms.

Please note that the anonymous SVN repository is separate from the main repository. It may take several minutes for committed changes to appear in the anonymous repository.

Automated Builds

If you can't use anonymous SVN - for example, because you're behind a firewall which blocks the HTTP methods used by Subversion - source tarballs and Windows installers of recent Subversion checkins can be downloaded from the following locations:

or

a mirror... HTTP Australia (PlanetMirror) Australia (Wiretapped) Germany (netmirror.org) Germany (pangora.org) Germany (uni-kl.de) Indonesia (CBN) Korea Malaysia Spain Sweden Taiwan FTP Australia (PlanetMirror) Australia (Wiretapped) Austria Germany (netmirror.org) Germany (uni-kl.de) Mexico Sweden Taiwan USA

These packages are created using Buildbot.

Subversion Web Interface

The entire source tree is available via a web interface. You can view each revision of a particular file, as well as diffs between different revsions. You can also download individual files or entire directories.

Developers's Guide

The Developer's Guide is available online at the following locations:

Multiple pages: or

a mirror... HTTP Australia (PlanetMirror) Germany (mirroring.de) Indonesia (CBN) Indonesia (Gadjah Mada University) Korea Malaysia Spain Taiwan USA

One huge page: or

a mirror... HTTP Australia (PlanetMirror) Germany (mirroring.de) Indonesia (CBN) Indonesia (Gadjah Mada University) Korea Malaysia Spain Taiwan USA

It is also available for download on the documentation page.

READMEs

The Ethereal source distribution contains several README files, which are recommeded for anyone wishing to develop with Ethereal.

Required Libraries and Packages

Before you download source code to Ethereal, you may want to verify that the following packages are installed on your system -- they are required in order to compile:

• GTK+ and GLib, available from the GTK+ site. Ethereal will work with versions 1.2 or 2.x.

  Solaris users should note that at least some versions of the GLib and GTK+ packages from sunfreeware.com have had problems that either cause Ethereal not to build or cause it to crash when run; if the build fails because plugin_list isn't defined, or the build succeeds but Ethereal crashes with a bus error, and you have GLib and GTK+ packages from sunfreeware.com installed, un-install those packages, and try getting the 1.2.10 versions from that site, or the version from The Written Word, or the version from Sun's GNOME distribution, or the version from the supplemental software CD that comes with the Solaris media kit, or build it from source from the GTK Web site. Then re-run the configuration script, and try rebuilding Ethereal. (If you get the 1.2.10 versions from www.sunfreeware.org, and the problem persists, un-install them and try installing one of the other versions mentioned.)

• The libpcap packet capture library, available for UNIX The Tcpdump Group, if it doesn't come as part of your OS; the Windows port, WinPcap, is available from the WinPcap Web site, as well as from the local mirror of that site or the Wiretapped.net mirror of that site.

  In Linux distributions that come with libpcap, there are often separate "user" and "developer" packages for libpcap; you will have to install both packages in order to compile Ethereal.

  On Windows, you will need to install not only the regular WinPcap library, but also the "developer's pack", in order to compile Ethereal. As of Ethereal 0.9.5, you must install WinPcap 2.3 or later, and the corresponding version of the developer's pack, in order to be able to compile Ethereal; it will not compile with older versions of the developer's pack. (The installed version of the developer's pack should be the same version as the version of WinPcap you have installed.)

• Perl is required to build the documentation.
• Python may be required to generate some code.

Optional Libraries

Additionally, Ethereal can make use of the zlib, NET-SNMP, ADNS, and PCRE libraries if available.

• Zlib allows Ethereal to read gzip-compressed files on the fly.
• The NET-SNMP (formerly known as UCD SNMP) library enables translation of OIDs to names, and more detailed decoding of variable bindings, using MIB files that come with the NET-SNMP library.
• GNU adns allows asynchronous DNS resolution. Normally, Ethereal and Tethereal perform name resolution synchronously, which can slow things down considerably. A Windows version of the library is also available.
• The Perl Compatible Regular Expressions (PCRE) library implements the "matches" display filter operator, which lets you search for arbitrary regular expressions in capture files.

Building Under Unix or Linux

To build, you must have the GNU autoconf (2.52 or greater), automake (1.6 or later), and libtool (1.4 or greater) tools installed, as well as Perl. You may also need flex and bison. Run the autogen.sh script at the top-level ethereal directory to configure your build directory.

To synchronize your local tree with the development tree, you can run

from the ethereal directory.

Building Under Windows

Building Ethereal under Windows requires either MSVC++ or Cygwin. Complete instructions can be found in the Windows distribution README file. Files needed for development can be checked out from http://anonsvn.ethereal.com/ethereal-win32-libs/trunk/packages/ using Subversion. They can also be downloaded directly from the same URL.

[ This content has been moved to the wiki. ]

[ The wish list has been moved to the wiki. ]