Get rid of the check for NetBSD in the Wiretap "configure.in"; we
[obnox/wireshark/wip.git] / README.linux
1 $Id: README.linux,v 1.5 2000/02/01 21:52:22 guy Exp $
2
3 The standard libpcap compiled for Linux has a timeout problem; it
4 doesn't support the timeout argument to "pcap_open_live()".
5
6 The current version of Ethereal attempts to work around this, so its GUI
7 shouldn't freeze when capturing on a not-so-busy network.  If its GUI
8 does freeze when that happens, please send a note about this, indicating
9 which version of which distribution of Linux you're using, and which
10 version of libpcap you're using, to ethereal-dev@zing.org.
11
12 The current version of Ethereal should work with versions of libpcap
13 that have been patched to fix the timeout problem, as well as working
14 with unpatched versions.
15
16 An additional problem, on Linux, with current versions of libpcap is
17 that capture filters do not work when snooping loopback devices; if
18 you're capturing on a Linux loopback device, do not use a capture
19 filter, as it will probably reject most if not all packets, including
20 the packets it's intended to accept - instead, capture all packets and
21 use a display filter to select the packets you want to see.
22
23 In addition, current versions of libpcap on at least some Linux
24 distributions will not turn promiscuous mode off on a network device
25 until the program using promiscuous mode exits, so if you start a
26 capture with Ethereal on some Linux distributions, the network interface
27 will be put in promiscuous mode and will remain in promiscuous mode
28 until Ethereal exits.  There might be additional libpcap bugs that cause
29 it not to be turned off even when Ethereal exits; if your network is
30 busy, this could cause the Linux networking stack to do a lot more work
31 discarding packets not intended for the machine, so you may want to
32 check, after running Ethereal, whether any network interfaces are in
33 promiscuous mode (the output of "ifconfig -a" will say something such as
34
35 eth0      Link encap:Ethernet  HWaddr 00:00:66:66:66:66
36           inet addr:66.66.66.66  Bcast:66.66.66.255  Mask:255.255.255.0
37           UP BROADCAST RUNNING PROMISC MULTICAST  MTU:1500  Metric:1
38           RX packets:6493 errors:0 dropped:0 overruns:0 frame:0
39           TX packets:3380 errors:0 dropped:0 overruns:0 carrier:0
40           collisions:0 txqueuelen:100 
41           Interrupt:18 Base address:0xfc80 
42
43 with "PROMISC" indicating that the interface is in promiscuous mode),
44 and, if any interfaces are in promiscuous mode and no capture is being
45 done on that interface, turn promiscuous mode off by hand with
46
47         ifconfig <ifname> -promisc
48
49 where "<ifname>" is the name of the interface.