capt_get_packet(): check for key press only every 20ms
[iptraf-ng.git] / README.interfaces
blob39b8a78af3dcf0499f65583dfe518628d0d0cce2
1 ============================================================================
2 Supported Interface Information
3 as of version 2.8, July 2002
4 ----------------------------------------------------------------------------
6 IPTraf has been slowly improving with its interface support since its
7 first release.  IPTraf currently supports the following types of links:
9 Local loopback
10 Ethernet (10 and 100 Mbps)
11 SLIP and variants
12 Asynchronous PPP over analog telephone lines
13 Synchronous PPP over digital ISDN lines
14 ISDN using raw IP encapsulation
15 ISDN using Cisco-HDLC encapsulation
16 FDDI (now includes Ethernet-emulating interfces)
17 Frame Relay FRAD/DLCI interfaces (new as of IPTraf 2.5.0)
18 PLIP (Parallel Line IP)
19 Token Ring
20 DVB satellite-receive interfaces
21 SBNI long-range modem interfaces
22 Wireless LAN interfaces
23 Free s/WAN logical interfaces
24 IPsec logical interfaces
25 Some tunnelling interfaces
26 Some bridging interfaces
28 ADDITIONAL INTERFACE SUPPORT
30 As much as I would like to support every concievable interface in
31 existence, we know that's just not possible.  I myself do not have a lot
32 of interface types.  However, that does not mean I'm unwilling to support
33 more.
35 So here's the deal.  If you'd like me to include support for a new type of
36 interface I will need this information as much as possible:
38 * Resulting link type in spkt_family after a recvfrom() on a (PF_PACKET,
39   SOCK_RAW) socket (ARPHRD_ETHER, ARPHRD_PPP, etc).
40 * Standard interface name for the type of network medium (eth0, eth1,
41   ppp0, etc) after the recvfrom() mentioned above.
42 * Packet structure.  How many bytes are there in its data-link header
43   (with Ethernet, there are 14, with FDDI, 21) as returned by recvfrom on
44   a (PF_PACKET, SOCK_RAW) socket?
45 * Pointers to other sources of information if possible.  This is necessary
46   for cases like ISDN, which claim to be ARPHRD_ETHER, but have completely
47   different frame structures, so I needed the appropriate ioctl()
48   information.  Token Ring packets may have a RIF structure or not.  These
49   factors need to be taken into consideration.
51 Then finally, if you come up with a request for support for a new
52 interface, I'd really like an offer to have it tested, obviously, since I
53 do not have the interface myself (for example, my country is primarily
54 leased-line territory, and ISDN is only starting, and it isn't even in my
55 city yet).  If I do not receive an offer to test, then support cannot be
56 included.
58 Patches, even quick-and-dirty ones, are very much welcome.
60 All information and patches will be fully credited in the CHANGES file.
62 Looking forward to serving you.
64 -- Gerard <riker@seul.org>