How zerbea/hcxdumptool works
hcxdumptool captures WLAN traffic and performs WPA-related layer-2 probing/attacks, producing pcapng captures for separate conversion and analysis tools. hcxnmealog is a companion utility for reading GPS NMEA data and logging it alongside WLAN observations. The sampled code shows raw packet handling, 802.11 processing, and NMEA input/output; several major capabilities and downstream relationships are documented in the README, while unsampled internal wiring is not inferred.
Main entry points: hcxdumptool.c Packet processing · hcxnmealog.c GPS and WLAN logger · ieee80211.h 802.11 definitions · radiotap.h Radiotap definitions
Components 18
WLAN capture
- Capture and attacks
hcxdumptool.c - Interface control
hcxdumptool.c - Packet processing
hcxdumptool.c - 802.11 transmission
hcxdumptool.c - PCAPNG capture
GPS logging
- GPS and WLAN logger
hcxnmealog.c - GPS input
hcxnmealog.c - NMEA processing
hcxnmealog.c - NMEA and TSV logs
Protocol formats
- 802.11 definitions
include/ieee80211.h - Radiotap definitions
include/radiotap.h - PCAPNG definitions
include/pcapng.h
Analysis workflow
- hcxpcapngtool
- Hash filtering tools
- Hashcat or JtR
Other components
- Operator
- WLAN device
- GPS receiver
Connections 21
- Operator → Capture and attacks: configures and starts
- Capture and attacks → Interface control: controls interface
- WLAN device → Packet processing: supplies frames
- Interface control → Packet processing: provides capture
- Packet processing → 802.11 transmission: dispatches responses
- 802.11 transmission → WLAN device: injects frames
- Packet processing → PCAPNG capture: writes packets
- Capture and attacks → PCAPNG capture: writes pcapng
- Operator → GPS and WLAN logger: configures and starts
- GPS and WLAN logger → GPS input: opens GPS source
- GPS receiver → GPS input: supplies sentences
- GPS input → NMEA processing: reads sentences
- WLAN device → GPS and WLAN logger: supplies WLAN frames
- GPS and WLAN logger → NMEA and TSV logs: writes logs
- NMEA processing → NMEA and TSV logs: records NMEA data
- Packet processing → 802.11 definitions: uses frame formats
- Packet processing → Radiotap definitions: parses radiotap
- Capture and attacks → PCAPNG definitions: formats capture
- PCAPNG capture → hcxpcapngtool: converts capture
- hcxpcapngtool → Hash filtering tools: produces hash files
- Hash filtering tools → Hashcat or JtR: supplies candidates