summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRonnie Sahlberg <ronnie_sahlberg@ozemail.com.au>2006-06-17 12:21:54 +0000
committerRonnie Sahlberg <ronnie_sahlberg@ozemail.com.au>2006-06-17 12:21:54 +0000
commit06bdc31f5b08227eeeb14f7cb540adf8a2d780b5 (patch)
treedca89f7b6b87b7fe6b27da1d8c51bb07a080262e
parent62e32390b50565abbbd98cb6f43b4168c7ae3486 (diff)
downloadwireshark-06bdc31f5b08227eeeb14f7cb540adf8a2d780b5.tar.gz
ethereal to wireshark changes
svn path=/trunk/; revision=18501
-rw-r--r--README.bsd2
-rw-r--r--README.hpux16
-rw-r--r--README.linux10
-rw-r--r--README.macos16
-rw-r--r--README.tru644
-rw-r--r--README.vmware2
-rw-r--r--README.win3274
7 files changed, 62 insertions, 62 deletions
diff --git a/README.bsd b/README.bsd
index e92293af79..76a7a657ac 100644
--- a/README.bsd
+++ b/README.bsd
@@ -1,6 +1,6 @@
$Id$
-In order to capture packets (with Ethereal/TShark, tcpdump, or any
+In order to capture packets (with Wireshark/TShark, tcpdump, or any
other packet capture program) on a BSD system, your kernel must have
the Berkeley packet Filter mechanism enabled. On some BSDs (recent
versions of FreeBSD, for example), it's enabled by default in the
diff --git a/README.hpux b/README.hpux
index c22026a568..9e603572d6 100644
--- a/README.hpux
+++ b/README.hpux
@@ -2,13 +2,13 @@ $Id$
Contents:
-1 - Building ethereal
+1 - Building wireshark
2 - Building GTK+/GLib with HP's C compiler
3 - nettl support
4 - libpcap on HP-UX
5 - HP-UX patches to fix packet capture problems
-1 - Building ethereal
+1 - Building wireshark
The Software Porting And Archive Centre for HP-UX, at
@@ -20,7 +20,7 @@ both source and binary form, for Wireshark, as well as for the libpcap,
GLib, GTK+, and zlib libraries that it uses.
The changes they've made appear largely to be compile option changes; if
-you've downloaded the source to the latest version of Ethereal (the
+you've downloaded the source to the latest version of Wireshark (the
version on the Centre's site may not necessarily be the latest version),
it should be able to compile, perhaps with those changes.
@@ -40,12 +40,12 @@ By default, HP's C compiler doesn't support "long long int" to provide
64-bit integral data types on 32-bit platforms; the "-Ae" flag must be
supplied to enable extensions such as that.
-Ethereal's "configure" script automatically includes that flag if it
+Wireshark's "configure" script automatically includes that flag if it
detects that the native compiler is being used on HP-UX; however, the
configure scripts for GTK+ and GLib don't do so, which means that 64-bit
integer support won't be enabled.
-This may prevent some parts of Ethereal from compiling; in order to get
+This may prevent some parts of Wireshark from compiling; in order to get
64-bit integer support in GTK+/GLib, edit all the Makefiles for GTK+ and
GLib, as generated by the GTK+ and GLib "configure" scripts, to add
"-Ae" to all "CFLAGS = " definitions found in those Makefiles. (If a
@@ -54,7 +54,7 @@ definition that includes "-Ae".)
3 - nettl support
-nettl is used on HP-UX to trace various streams based subsystems. Ethereal
+nettl is used on HP-UX to trace various streams based subsystems. Wireshark
can read nettl files containing raw IP frames (NS_LS_IP, NS_LS_TCP,
NS_LS_UDP, NS_LS_ICMP subsystems), all ethernet/tokenring/fddi driver
level frames (such as BTLAN, BASE100, GELAN, IGELAN subsystems) and LAPB
@@ -80,7 +80,7 @@ on old versions of 10.20 and 9.04.
4 - libpcap on HP-UX
-If you want to use Ethereal to capture packets, you will have to install
+If you want to use Wireshark to capture packets, you will have to install
libpcap; binary distributions are, as noted above, available from the
Software Porting And Archive Centre for HP-UX, as well as source code.
@@ -99,7 +99,7 @@ as a shared library.
5 - HP-UX patches to fix packet capture problems
-Note that packet-capture programs such as Ethereal/TShark or tcpdump
+Note that packet-capture programs such as Wireshark/TShark or tcpdump
may, on HP-UX, not be able to see packets sent from the machine on which
they're running. Make sure you have a recent "LAN Cummulative/DLPI" patch
installed.
diff --git a/README.linux b/README.linux
index ad27953bbf..8b0170db0c 100644
--- a/README.linux
+++ b/README.linux
@@ -1,6 +1,6 @@
$Id$
-In order to capture packets (with Ethereal/TShark, tcpdump, or any
+In order to capture packets (with Wireshark/TShark, tcpdump, or any
other libpcap-based packet capture program) on a Linux system, the
"packet" protocol must be supported by your kernel. If it is not, you
may get error messages such as
@@ -83,13 +83,13 @@ distribution releases will not have this problem.
In addition, older versions of libpcap will, on Linux systems with a
2.0[.x] kernel, or if built for systems with a 2.0[.x] kernel, not turn
promiscuous mode off on a network device until the program using
-promiscuous mode exits, so if you start a capture with Ethereal on some
+promiscuous mode exits, so if you start a capture with Wireshark on some
Linux distributions, the network interface will be put in promiscuous
-mode and will remain in promiscuous mode until Ethereal exits. There
+mode and will remain in promiscuous mode until Wireshark exits. There
might be additional libpcap bugs that cause it not to be turned off even
-when Ethereal exits; if your network is busy, this could cause the Linux
+when Wireshark exits; if your network is busy, this could cause the Linux
networking stack to do a lot more work discarding packets not intended
-for the machine, so you may want to check, after running Ethereal,
+for the machine, so you may want to check, after running Wireshark,
whether any network interfaces are in promiscuous mode (the output of
"ifconfig -a" will say something such as
diff --git a/README.macos b/README.macos
index 2feb37b9ac..2a499e7c1f 100644
--- a/README.macos
+++ b/README.macos
@@ -1,21 +1,21 @@
$Id$
-This file tries to help building Ethereal for Mac OS X (Ethereal does
+This file tries to help building Wireshark for Mac OS X (Wireshark does
not work on earlier versions of Mac OS).
-In order to build Ethereal, you must have X11 and the X11 developer
+In order to build Wireshark, you must have X11 and the X11 developer
headers and libraries installed; otherwise, you will not be able to
build or install GTK+, and will only be able to build TShark. The
X11 and X11 SDK that come with Mac OS X 10.3[.x] are sufficient to build
-and run Ethereal.
+and run Wireshark.
The changes to enable libwiretap and libwireshark being built as shared
libraries have broken shared gtk1 builds on Mac OS X. The GLib 1.x and
GTK+ 1.x release tarballs were built with an older version of libtool
that didn't support shared libraries on Mac OS X, so you can't build and
install them as shared libraries, but the shared-library build of
-Ethereal requires GLib and GTK+, on Mac OS X, to be shared libraries.
-The alternative to build Ethereal as one big statically linked binary
+Wireshark requires GLib and GTK+, on Mac OS X, to be shared libraries.
+The alternative to build Wireshark as one big statically linked binary
isn't working either (and may never have worked on this OS).
The way out of this situation is to use gtk2 and associated libraries
@@ -47,7 +47,7 @@ directory:
However, on Tiger, it appears that the libraries built and installed by
those packages collide with libraries that come with the OS, so you
might have to configure GTK+ not to support loading those images
-(Ethereal doesn't use the ability to load JPEG, PNG, or TIFF images), by
+(Wireshark doesn't use the ability to load JPEG, PNG, or TIFF images), by
using the "--without-libpng", "--without-libjpeg", and
"---without-libtiff" flags when running "configure" in the GTK+ source
directory.
@@ -77,11 +77,11 @@ do "sudo ranlib /usr/local/lib/libjpeg.a" after "make install-lib".
For libpng, use scripts/makefile.darwin, not scripts/makefile.macosx.
Finally run the configure script. By default it will use
-the Glib2 and GTK+2 libraries. If you run Ethereal's configure script
+the Glib2 and GTK+2 libraries. If you run Wireshark's configure script
with the "--disable-gtk2" argument it'll try to configure with GLib
1.2[.x] and GTK+ 1.2[.x], in which case:
if they're not installed, the configure script will fail;
if they are installed, the configure script will configure
- Ethereal to build with them.
+ Wireshark to build with them.
diff --git a/README.tru64 b/README.tru64
index eeea5ffa3f..8c018ce16b 100644
--- a/README.tru64
+++ b/README.tru64
@@ -35,9 +35,9 @@ Interface configuration
In order to capture all packets on a network, you may want to allow
applications to put the interface on that network into "local copy"
-mode, so that Ethereal can see packets sent by the host on which it's
+mode, so that Wireshark can see packets sent by the host on which it's
running as well as packets received by that host, and to put the
-interface into "promiscuous" mode, so that Ethereal can see packets on
+interface into "promiscuous" mode, so that Wireshark can see packets on
the network segment not sent to the host on which it's running, by using
the pfconfig(1) command:
diff --git a/README.vmware b/README.vmware
index 8f5b882f49..d7aeecb3d6 100644
--- a/README.vmware
+++ b/README.vmware
@@ -23,7 +23,7 @@ With the patch from VMware, you can sniff the packets on these
network devices. Note the distinction between "network device", where a
device driver file exists in /dev, and "interface", which is a namespace
private to the kernel (not on the filesystem). You have to supply the
-full pathname of the device to Ethereal (i.e., "/dev/vmnetN").
+full pathname of the device to Wireshark (i.e., "/dev/vmnetN").
When vmnet1 is up, you will be able to select it from the list of
interfaces, since it will have both a device name (/dev/vmnet1) and
an interface name "vmnet1"
diff --git a/README.win32 b/README.win32
index 8048244b7c..e31d407ede 100644
--- a/README.win32
+++ b/README.win32
@@ -1,8 +1,8 @@
$Id$
-Installing Ethereal, TShark, and Editcap on Win32
+Installing Wireshark, TShark, and Editcap on Win32
====================================================
-These are the instructions for installing Ethereal
+These are the instructions for installing Wireshark
from the installation executable that is provided on
the Wireshark website at:
@@ -12,7 +12,7 @@ and any of its mirrors.
The installation package allows you to install:
- o Ethereal - the GUI version
+ o Wireshark - the GUI version
o TShark - the console, line-mode version
o Editcap - a console, line-mode utility to convert
capture files from one format to another.
@@ -24,29 +24,29 @@ The installation package allows you to install:
Additionally, the installation package contains a "plugins"
option, which installs some additional dissector plugins
-for use with Ethereal and TShark.
+for use with Wireshark and TShark.
All binaries in Wireshark package are now built with debugging
information embedded. If you are experiencing a crash when running
-Ethereal or other binaries, Dr. Watson or your debugger
+Wireshark or other binaries, Dr. Watson or your debugger
can use the information embedded in the binary to provide useful
information to the Wireshark developers that will help them pinpoint
the problem.
-In the past, two versions of Ethereal binaries were published -- a
+In the past, two versions of Wireshark binaries were published -- a
version that could capture packets and a version which could not.
The latter is useful if you're only reading files produced by
another product (e.g., a sniffer, firewall, or intrustion detection system)
-and did not wish to install WinPcap, the library Ethereal uses
+and did not wish to install WinPcap, the library Wireshark uses
to capture packets on Win32 platforms.
As of WinPcap 2.1, all the WinPcap libraries have been released as DLLs.
-This means that Ethereal can detect the presence of WinPcap at run time,
+This means that Wireshark can detect the presence of WinPcap at run time,
which means that only one version of the Wireshark binaries needs to be
shipped.
-If you don't want to capture packets, just install the Ethereal
-package. If you do want to capture packets, install Ethereal *and*
+If you don't want to capture packets, just install the Wireshark
+package. If you do want to capture packets, install Wireshark *and*
install the latest non-beta version of WinPcap, available from:
http://winpcap.polito.it/
@@ -85,7 +85,7 @@ They also make Analyzer, a GUI sniffer for Win32:
http://analyzer.polito.it/
The rest of this documentation is only interesting if
-you want to compile Ethereal yourself.
+you want to compile Wireshark yourself.
Compiling the Wireshark distribution from source
@@ -93,7 +93,7 @@ Compiling the Wireshark distribution from source
Developer's Guide
-----------------
-You can find a comprehensive guide how to develop Ethereal in the
+You can find a comprehensive guide how to develop Wireshark in the
Developer's Guide, which you can find (and much more info) at:
http://wiki.wireshark.org/Development
@@ -104,9 +104,9 @@ environment and it's usage.
Compilers
---------
MS Visual C++ Version 6
-This is the common compiler used for building Ethereal on win32.
+This is the common compiler used for building Wireshark on win32.
-If you've downloaded an Ethereal source tarball and unpacked it, then,
+If you've downloaded an Wireshark source tarball and unpacked it, then,
before you do any build, you must do
nmake -f makefile.nmake distclean
@@ -131,7 +131,7 @@ Currently unsupported for two reasons:
See section "Problems with MS Visual C++ Version 7 / VC.NET" below.
Cygwin GCC
-Ethereal can entirely be built with cygwin GCC. However the built binaries will
+Wireshark can entirely be built with cygwin GCC. However the built binaries will
only run in a cygwin environment, so they are not standalone Win32 applications.
It is however not excluded that native Win32 code can be compiled on cygwin GCC
but you then have to use -mms-bitfields as a strict minimum and probably
@@ -210,7 +210,7 @@ By default, the build process looks for these packages in
C:\wireshark-win32-libs. You can place them in a different directory, but
you must update the WIRESHARK_LIBS variable in config.nmake accordingly.
-The following lists the packages needed to compile Ethereal and the default
+The following lists the packages needed to compile Wireshark and the default
locations where to unpack them, when the above method isn't used.
Package Default Location
@@ -248,7 +248,7 @@ Compiling the Wireshark distribution using GTK+2
-----------------------------------------------
The more recent version 2 of the GTK+ can be used to compile
-Ethereal with, but is still considered beta.
+Wireshark with, but is still considered beta.
GTK+2 will look better in various ways, especially for WIN32 users.
@@ -277,23 +277,23 @@ and optional:
Be sure to set GTK2_DIR in config.nmake correct, to be able to compile.
-Running your freshly compiled Ethereal
+Running your freshly compiled Wireshark
--------------------------------------
Make sure the glib and gtk DLL's are in your path or you use a directory
where all required DLL's and the exe files reside.- i.e., that your
path includes the directory (folder) or directories (folders) in which
-those DLLs are found - when you run Ethereal.
+those DLLs are found - when you run Wireshark.
Note the wiretap*.dll must be in your path as well and if wiretap is changed
be sure to put the new one in your path.
Plugins (gryphon.dll and mgcp.dll) can go in:
- <Ethereal installation directory>\plugins\<version>
+ <Wireshark installation directory>\plugins\<version>
Where <version> is the version number, without brackets. For example,
-if you have Ethereal 0.10.12 installed in the default location, plugins
-will reside in C:\Program Files\Ethereal\plugins\0.10.12
+if you have Wireshark 0.99.1 installed in the default location, plugins
+will reside in C:\Program Files\Wireshark\plugins\0.99.1
Yes, the location of plugins needs to be more flexible.
@@ -320,7 +320,7 @@ as the "command.com" on Windows 2000, at least, can't handle non-8.3
directory names. (It may be that the "command.com" in Windows 95, Windows
98, and Windows Me, as it's the only command interpreter in those systems,
can handle those directories. If not, it may not be possible to build
-Ethereal from the command line on those versions of Windows.)
+Wireshark from the command line on those versions of Windows.)
Be sure that your command-line environment is set up to compile
and link with MSVC++. When installing MSVC++, you can have your
@@ -329,8 +329,8 @@ command line, or you can invoke the vcvars32.bat script, which can
usually be found in the "VC98\Bin" subdirectory of the directory in
which Visual Studio was installed.
-The first time you build Ethereal, run "nmake -f makefile.nmake distclean"
-in the top-level Ethereal source directory to make sure that the "config.h"
+The first time you build Wireshark, run "nmake -f makefile.nmake distclean"
+in the top-level Wireshark source directory to make sure that the "config.h"
files will be reconstructed from the "config.h.win32" files. (If, for
example, you have "config.h" files left over from a Unix build, a
Windows build will fail.)
@@ -442,12 +442,12 @@ Installing GTK-Wimp
GTK-Wimp can be used to get a native Look-and-Feel on WinXP machines,
especially with the new "coloured" WinXP theme. It will only take effect
-together with the GTK2 version of Ethereal.
+together with the GTK2 version of Wireshark.
No changes to the Wireshark sources are needed, GTK-Wimp simply changes the
way GTK2 displays the widgets (by changing the GTK2 default theme).
-GTK-Wimp will be automatically installed if you use the official Ethereal Setup.
+GTK-Wimp will be automatically installed if you use the official Wireshark Setup.
In this case, the files mentioned below are already existing at the appropriate
places.
@@ -456,7 +456,7 @@ method is error prone and therefore no longer recommended):
1. Go to http://gtk-wimp.sourceforge.net/
2. Download the ZIP archive containing the library and the theme
-3. Locate the installation directory of Ethereal (C:\Program Files\Ethereal)
+3. Locate the installation directory of Wireshark (C:\Program Files\Wireshark)
4. Create a subdirectory 'share\themes\Default\gtk-2.0'
5. Drop the file 'gtkrc' in 'share\themes\Default\gtk-2.0'
6. Create a subdirectory named 'lib\gtk-2.0\2.4.0\engines'
@@ -464,10 +464,10 @@ method is error prone and therefore no longer recommended):
When you're finished, you should have:
-C:\Program Files\Ethereal\lib\gtk-2.0\2.4.0\engines\libwimp.dll
-C:\Program Files\Ethereal\share\themes\Default\gtk-2.0\gtkrc
+C:\Program Files\Wireshark\lib\gtk-2.0\2.4.0\engines\libwimp.dll
+C:\Program Files\Wireshark\share\themes\Default\gtk-2.0\gtkrc
-After (re-)starting Ethereal, you should now see it's widgets in the modern
+After (re-)starting Wireshark, you should now see it's widgets in the modern
WinXP style on your screen.
@@ -492,7 +492,7 @@ The same problem seems to apply on all MSVC compilers after version 6, like the
Instructions for Cygwin
-----------------------
-It is possible to build Ethereal under Cygwin using their version
+It is possible to build Wireshark under Cygwin using their version
of XFree86. References:
- http://www.ethereal.com/lists/ethereal-dev/200205/msg00107.html
- http://www.ethereal.com/lists/ethereal-dev/200302/msg00026.html
@@ -546,10 +546,10 @@ To get it running, execute the following steps:
removing "ethclist.c" from the dependencies.
This patch is required since the private GTK+ clist widget
- (was required for earlier versions of GTK+ but prevents Ethereal
+ (was required for earlier versions of GTK+ but prevents Wireshark
from running with cygwin).
-6. Configure and make Ethereal:
+6. Configure and make Wireshark:
Set the path (if this has not yet been done earlier)
@@ -575,7 +575,7 @@ To get it running, execute the following steps:
want to use them. Note also that running "make install" produces lots of
output to the console; this is normal.
-Note: Compiling Ethereal under cygwin takes a lot of time, because the
+Note: Compiling Wireshark under cygwin takes a lot of time, because the
generation of 'register.c' takes ages. If you only edit one dissector and
you know what you're doing, it is acceptable to uncomment the generation
of the file 'register.c' in Makefile. Look for the 'register.c' target:
@@ -587,12 +587,12 @@ of the file 'register.c' in Makefile. Look for the 'register.c' target:
Of course, you need to generate the 'register.c' file at least once.
-Note: You can also capture packets on a cygwin built Ethereal. You then have
+Note: You can also capture packets on a cygwin built Wireshark. You then have
to unpack the WinPCap development package, install the files in lib/ and
include/ in say /usr/lib and /usr/include (they must be in the search path of
the compiler and linker, otherwise you have to specify the configure option
--with-pcap=/location/to/pcap so the packet capture functionality can be used.
-In order to run Ethereal, you have to add the .dll files in a directory in the
+In order to run Wireshark, you have to add the .dll files in a directory in the
PATH (e.g., /bin).
Should you want packet capturing enabled in the cygwin build, then you have to
remove --without-pcap from step 6.