wireshark/wiretap
David Perry c01f860867 Update comments in `wiretap/file_access.c` 2023-02-07 18:24:28 +00:00
..
.editorconfig Miscellaneous EditorConfig fixes 2021-03-02 19:13:54 +00:00
5views.c wiretap: Fix build on 32-bit Linux 2022-08-24 23:26:19 +00:00
5views.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
CMakeLists.txt CMake: Cleanup unnecessary linking with shared libraries 2023-02-06 15:04:46 +00:00
README HTTPS In Even More Places, update some links. 2019-07-28 04:21:18 +00:00
README.airmagnet Fix many spelling errors 2020-10-11 08:35:55 +00:00
README.developer Add a systemd Journal Export Format parser and dissector. 2018-08-31 05:20:27 +00:00
aethra.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
aethra.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
ascend-int.h ascend: make the time stamp in the parser state a time_t. 2022-08-16 18:40:20 -07:00
ascend_parser.lemon Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
ascend_scanner.l Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
ascendtext.c wiretap: always allocate a block for a record. 2021-08-29 19:12:13 -07:00
ascendtext.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
atm.c HTTPS (almost) everywhere. 2019-07-26 18:44:40 +00:00
atm.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
autosar_dlt.c DLT: Adding support to open DLT files 2022-08-26 07:45:36 +00:00
autosar_dlt.h DLT: Adding support to open DLT files 2022-08-26 07:45:36 +00:00
ber.c wiretap: rename wtap_register_file_type_subtypes(). 2021-02-23 20:39:16 -08:00
ber.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
blf.c BLF: Fixing the interpretation of SRR and RTR 2022-10-13 14:48:43 +00:00
blf.h blf: change description and add/extend comments. 2022-08-21 01:34:41 -07:00
btsnoop.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
btsnoop.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
busmaster.c Dissector names are not protocol names. 2022-09-10 22:37:11 -07:00
busmaster.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
busmaster_parser.lemon Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
busmaster_priv.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
busmaster_scanner.l Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
camins.c Corrects repeated words throughout the code. 2021-12-22 11:01:11 +00:00
camins.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
candump.c Dissector names are not protocol names. 2022-09-10 22:37:11 -07:00
candump.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
candump_parser.lemon Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
candump_priv.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
candump_scanner.l Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
capsa.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
capsa.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
catapult_dct2000.c Fix some issues seen with cppcheck 2022-11-22 20:55:24 +00:00
catapult_dct2000.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
commview.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
commview.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
cosine.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
cosine.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
csids.c wiretap: always allocate a block for a record. 2021-08-29 19:12:13 -07:00
csids.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
daintree-sna.c Fix stdio.h conversions to use the scanf macros 2021-12-19 23:49:55 +00:00
daintree-sna.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
dbs-etherwatch.c Corrects repeated words throughout the code. 2021-12-22 11:01:11 +00:00
dbs-etherwatch.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
dct3trace.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
dct3trace.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
dpa400.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
dpa400.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
erf-common.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
erf.c erf(wiretap): Fix Clang Warning Uninitialized argument value 2022-01-15 08:41:12 +00:00
erf.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
erf_record.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
eri_enb_log.c nstime: Support ISO 8601 basic format 2021-12-01 20:50:37 -05:00
eri_enb_log.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
eyesdn.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
eyesdn.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
file_access.c Update comments in `wiretap/file_access.c` 2023-02-07 18:24:28 +00:00
file_wrappers.c Fix some issues seen with cppcheck 2022-11-22 20:55:24 +00:00
file_wrappers.h Add files with WS_DLL_PUBLIC to Doxygen 2021-11-29 21:27:45 +00:00
hcidump.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
hcidump.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
i4b_trace.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
i4btrace.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
i4btrace.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
introspection-enums.c wiretap, pcapng: Distinguish WTAP_ENCAP_UNKNOWN and _NONE 2023-02-07 13:33:20 +00:00
introspection.c wiretap: Add enum generation 2022-10-07 10:28:47 +01:00
introspection.h wiretap: Add enum generation 2022-10-07 10:28:47 +01:00
ipfix.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
ipfix.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
iptrace.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
iptrace.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
iseries.c Corrects repeated words throughout the code. 2021-12-22 11:01:11 +00:00
iseries.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
json.c wiretap: rename wtap_register_file_type_subtypes(). 2021-02-23 20:39:16 -08:00
json.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
k12.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
k12.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
k12text.l Add macros to control lemon diagnostics 2022-11-20 10:11:27 +00:00
lanalyzer.c Corrects repeated words throughout the code. 2021-12-22 11:01:11 +00:00
lanalyzer.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
libpcap.c libpcap: don't allow out-of-range time stamps. 2022-08-16 16:38:03 -07:00
libpcap.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
log3gpp.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
log3gpp.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
logcat.c Fix some issues seen with cppcheck 2022-11-22 20:55:24 +00:00
logcat.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
logcat_text.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
logcat_text.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
merge.c cli: Process IDBs after the final packet record 2023-02-04 13:40:00 +00:00
merge.h wiretap: Preserve NRBs with editcap, mergecap, and tshark 2023-01-30 13:29:49 +00:00
mime_file.c DLT: Adding support to open DLT files 2022-08-26 07:45:36 +00:00
mime_file.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
mp2t.c wiretap: always allocate a block for a record. 2021-08-29 19:12:13 -07:00
mp2t.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
mp4.c MP4: add support for segment boxes (styp, sidx) 2023-01-19 17:59:50 +00:00
mp4.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
mpeg.c mpeg: handle the presence of an image in the ID3v2 header. 2022-03-10 07:38:14 +00:00
mpeg.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
mplog.c wiretap: always allocate a block for a record. 2021-08-29 19:12:13 -07:00
mplog.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
netmon.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
netmon.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
netscaler.c wiretap: always allocate a block for a record. 2021-08-29 19:12:13 -07:00
netscaler.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
netscreen.c Corrects repeated words throughout the code. 2021-12-22 11:01:11 +00:00
netscreen.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
nettl.c nettl: don't allow out-of-range time stamps. 2022-08-16 17:19:20 -07:00
nettl.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
nettrace_3gpp_32_423.c Dissector names are not protocol names. 2022-09-10 22:37:11 -07:00
nettrace_3gpp_32_423.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
netxray.c wiretap: Fix build on 32-bit Linux 2022-08-24 23:26:19 +00:00
netxray.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
ngsniffer.c Corrects repeated words throughout the code. 2021-12-22 11:01:11 +00:00
ngsniffer.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
observer.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
observer.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
packetlogger.c packetlogger: Handle SCO data packets 2022-02-28 10:04:50 +01:00
packetlogger.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
pcap-common.c ALP: add dissector for ALP protocol (ATSC3.0 A/330) 2023-01-08 16:09:47 +00:00
pcap-common.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
pcap-encap.h Add files with WS_DLL_PUBLIC to Doxygen 2021-11-29 21:27:45 +00:00
pcapng.c wiretap, pcapng: Distinguish WTAP_ENCAP_UNKNOWN and _NONE 2023-02-07 13:33:20 +00:00
pcapng.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
pcapng_module.h Add files with WS_DLL_PUBLIC to Doxygen 2021-11-29 21:27:45 +00:00
peekclassic.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
peekclassic.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
peektagged.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
peektagged.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
pppdump.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
pppdump.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
radcom.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
radcom.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
required_file_handlers.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
rfc7468.c rfc7468: allow multiple structures per file 2022-01-06 06:29:54 +00:00
rfc7468.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
ruby_marshal.c wiretap: rename wtap_register_file_type_subtypes(). 2021-02-23 20:39:16 -08:00
ruby_marshal.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
secrets-types.h Adding secret management in DSB. 2022-01-07 13:42:33 +00:00
snoop.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
snoop.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
socketcan.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
stanag4607.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
stanag4607.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
systemd_journal.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
systemd_journal.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
tnef.c wiretap: rename wtap_register_file_type_subtypes(). 2021-02-23 20:39:16 -08:00
tnef.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
toshiba.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
toshiba.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
visual.c wiretap: Fix build on 32-bit Linux 2022-08-24 23:26:19 +00:00
visual.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
vms.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
vms.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
vwr.c Replace g_strdup_printf() with ws_strdup_printf() 2021-12-19 21:21:58 +00:00
vwr.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
wtap-int.h wiretap: Preserve NRBs with editcap, mergecap, and tshark 2023-01-30 13:29:49 +00:00
wtap.c wiretap, pcapng: Distinguish WTAP_ENCAP_UNKNOWN and _NONE 2023-02-07 13:33:20 +00:00
wtap.h wiretap, pcapng: Distinguish WTAP_ENCAP_UNKNOWN and _NONE 2023-02-07 13:33:20 +00:00
wtap_modules.h wiretap: Add header files to Doxygen 2021-11-29 21:59:23 -05:00
wtap_opttypes.c wiretap: Reprocess Name Resolution Blocks during redissect 2023-01-21 22:25:03 +00:00
wtap_opttypes.h wiretap: Preserve NRBs with editcap, mergecap, and tshark 2023-01-30 13:29:49 +00:00

README

NOTE: this documents the original intent behind libwiretap.  Currently,
it is being developed solely as a library for reading capture files,
rather than packet capture.  The list of file formats is also
out-of-date.

Wiretap is a library that is being developed as a future replacement for
libpcap, the current standard Unix library for packet capturing. Libpcap
is great in that it is very platform independent and has a wonderful
BPF optimizing engine. But it has some shortcomings as well. These
shortcomings came to a head during the development of Wireshark
(https://www.wireshark.org/), a packet analyzer. As such, I began developing
wiretap so that:

1. The library can easily be amended with new packet filtering objects.
Libpcap is very TCP/IP-oriented. I want to filter on IPX objects, SNA objects,
etc. I also want any decent programmer to be able to add new filters to the
library.

2. The library can read file formats from many packet-capturing utilities.
Libpcap only reads Libpcap files.

3. The library can capture on more than one network interface at a time, and
save this trace in one file.

4. Network names can be resolved immediately after a trace and saved in the
trace file. That way, I can ship a trace of my firewall-protected network to a
colleague, and he'll see the proper hostnames for the IP addresses in the
packet capture, even though he doesn't have access to the DNS server behind my
LAN's firewall.

5. I want to look into the possibility of compressing packet data when saved
to a file, like Sniffer.

6. The packet-filter can be optimized for the host OS. Not all OSes have BPF;
SunOS has NIT and Solaris has DLPI, which both use the CMU/Stanford
packet-filter pseudomachine. RMON has another type of packet-filter syntax
which we could support.

Wiretap is very good at reading many file formats, as per #2
above. Wiretap has no filter capability at present; it currently doesn't
support packet capture, so it wouldn't be useful there, and filtering
when reading a capture file is done by Wireshark, using a more powerful
filtering mechanism than that provided by BPF.


File Formats
============

Libpcap
-------
The "libpcap" file format was determined by reading the "libpcap" code;
wiretap reads the "libpcap" file format with its own code, rather than
using the "libpcap" library's code to read it.

Sniffer (compressed and uncompressed)
-------
The uncompressed Sniffer format is documented in the Sniffer manual.
Unfortunately, Sniffer manuals tend to document only the format for
the Sniffer model they document. Token-Ring and ethernet seems to work
well, though.  If you have an ATM Sniffer file, both Guy and Gilbert
would be *very* interested in receiving a sample. (see 'AUTHORS' file
for our e-mail addresses).

LANalyzer
---------
The LANalyzer format is available from http://www.novell.com. Search
their knowledge base for "Trace File Format".

Network Monitor
---------------
Microsoft's Network Monitor file format is supported, at least under
Ethernet and token-ring. If you have capture files of other datalink
types, please send them to Guy.

"snoop"
-------
The Solaris 2.x "snoop" program's format is documented in RFC 1761.

"iptrace"
---------
This is the capture program that comes with AIX 3.x and 4.x.  AIX 3 uses
the iptrace 1.0 file format, while AIX4 uses iptrace 2.0.  iptrace has
an undocumented, yet very simple, file format.  The interesting thing
about iptrace is that it will record packets coming in from all network
interfaces; a single iptrace file can contain multiple datalink types.

Sniffer Basic (NetXRay)/Windows Sniffer Pro
-------------------------------------------
Network Associates' Sniffer Basic (formerly NetXRay from Cinco Networks)
file format is now supported, at least for Ethernet and token-ring. 
Network Associates' Windows Sniffer Pro appears to use a variant of that
format; it's supported to the same extent.

RADCOM WAN/LAN Analyzers
------------------------
Olivier Abad has added code to read Ethernet and LAPB captures from
RADCOM WAN/LAN Analyzers (see https://web.archive.org/web/20031231213434/http://www.radcom-inc.com/).

Lucent/Ascend access products
-----------------------------
Gerald

HP-UX nettl
-----------
nettl is used on HP-UX to trace various streams based subsystems.  Wiretap
can read nettl files containing IP frames (NS_LS_IP subsystem) and LAPB
frames (SX25L2 subsystem). It has been tested with files generated on
HP-UX 9.04 and 10.20.
Use the following commands to generate a trace :
# IP capture. 0x30000000 means PDU in and PDU out :
nettl -tn 0x30000000 -e NS_LS_IP -f tracefile
# X25 capture. You must specify an interface :
nettl -tn 0x30000000 -e SX25l2 -d /dev/x25_0 -f tracefile
# stop capture. subsystem is NS_LS_IP or SX25L2 :
nettl -tf -e subsystem

One may be able to specify "-tn pduin pduout" rather than
"-tn 0x30000000"; the nettl man page for HP-UX 10.30 implies that it
should work.

There is also basic support for nettl files containing NS_LS_DRIVER, 
NS_LS_TCP, NS_LS_UDP, NS_LS_LOOPBACK, unknown type 0xb9, and NS_LS_ICMP.
However, NS_LS_ICMP will not be decoded since WTAP lacks a raw ICMP 
encapsulation type.


Toshiba ISDN Router
-------------------
An under-documented command that the router supports in a telnet session
is "snoop" (not related to the Solaris "snoop" command). If you give
it the "dump" option (either by letting "snoop" query you for its next
argument, or typing "snoop dump" on the command line), you'll get a hex
dump of all packets across the router (except of your own telnet session
-- good thinking Toshiba!). You can select a certain channel to sniff
(LAN, B1, B2, D), but the default is all channels.  You save this hex
dump to disk with 'script' or by 'telnet | tee'. Wiretap will read the
ASCII hex dump and convert it to binary data.

ISDN4BSD "i4btrace" utility
---------------------------
Bert Driehuis

Cisco Secure Intrusion Detection System iplogging facility
-----------------------------------------------------------
Mike Hall

pppd logs (pppdump-format files)
--------------------------------
Gilbert

VMS TCPTRACE
------------
Compaq VMS's TCPIPTRACE format is supported.  This is the capture program
that comes with TCP/IP or UCX as supplied by Compaq or Digital Equipment
Corporation.

Under UCX 4.x, it is invoked as TCPIPTRACE.  Under TCPIP 5.x, it is invoked
as TCPTRACE.

TCPTRACE produces an ascii text based format, that has changed slightly over
time.

DBS Etherwatch (text format)
----------------------------
Text output from DBS Etherwatch is supported.  DBS Etherwatch is available
from: https://web.archive.org/web/20070612033348/http://www.users.bigpond.com/dbsneddon/software.htm.

Catapult DCT2000 (.out files)
-----------------------------
DCT2000 test systems produce ascii text-based .out files for ports
that have logging enabled. When being read, the data part of the message is
prefixed with a short header that provides some context (context+port,
direction, original timestamp, etc).

You can choose to suppress the reading of non-standard protocols
(i.e. messages between layers rather than the well-known link-level protocols
usually found on board ports).


Gilbert Ramirez <gram@alumni.rice.edu>
Guy Harris <guy@alum.mit.edu>

STANAG 4607
-----------
Initial support for the STANAG 4607 protocol.  Documentation at:
https://web.archive.org/web/20130223054955/http://www.nato.int/structur/AC/224/standard/4607/4607.htm