Debian Codegraph @

changelog

raw
1 08.02.2026
2 ==========
3 bug fix release v7.1.2 git
4
5 01.02.2026
6 ==========
7 release v7.1.0
8
9
10 30.01.2026
11 ==========
12 hcxdumptool: added new option to rcascan to show only APs in range (all channels):
13 --rds=<digit> : enable real time display
14 attack mode:
15 0 = off(default)
16 1 = show APs on current channel, show CLIENTs (M1M2ROGUE)
17 2 = show all APs (M1M2, M1M2M3 or PMKID), show CLIENTs (M1M2ROGUE)
18 3 = show all APs, show CLIENTs (M1M2ROGUE)
19 4 = show waterfall (PMKID & EAPOL)
20 TIME TYPE MAC_AP MAC_CLIENT ESSID
21 columns:
22 E = encryption (e)ncrypted / (o)pen
23 A = AKM (p)re-shared key
24 1 = received M1 (+)
25 2 = received M1M2 (+)
26 3 = received M1M2M3 (+)
27 P = received PMKID (+)
28 rcascan mode
29 0 = show APs on current channel sorted by BEACON timestamp
30 1 = show APs on current channel sorted by PROBERESPONSE timestamp
31 2 = show APs on current channel sorted by RSSI
32 3 = show APs of all channels sorted by RSSI
33 4 = show only APs in range on current channel sorted by PROBERESPONSE timestamp
34 requires --rcascan=active
35 5 = show only APs of all channels sorted by PROBERESPONSE timestamp
36 requires --rcascan=active
37
38
39 29.01.2026
40 ==========
41 hcxdumptool: added PROBEREQUEST counter
42 fixed PROBERESPONSE counter
43 added information why hcxdumptool can't arm the interface
44 added new option to rcascan to show only APs in range (current channel):
45 --rds=<digit> : enable real time display
46 attack mode:
47 0 = off(default)
48 1 = show APs on current channel, show CLIENTs (M1M2ROGUE)
49 2 = show all APs (M1M2, M1M2M3 or PMKID), show CLIENTs (M1M2ROGUE)
50 3 = show all APs, show CLIENTs (M1M2ROGUE)
51 4 = show waterfall (PMKID & EAPOL)
52 TIME TYPE MAC_AP MAC_CLIENT ESSID
53 columns:
54 E = encryption (e)ncrypted / (o)pen
55 A = AKM (p)re-shared key
56 1 = received M1 (+)
57 2 = received M1M2 (+)
58 3 = received M1M2M3 (+)
59 P = received PMKID (+)
60 rcascan mode
61 0 = show APs on current channel sorted by BEACON timestamp
62 1 = show APs on current channel sorted by PROBERESPONSE timestamp
63 2 = show APs on current channel sorted by RSSI
64 3 = show APs of all channels sorted by RSSI
65 4 = show only APs in range on current channel sorted by PROBERESPONSE tim
66
67
68 20.01.2026
69 ==========
70 hcxdumptool: allow to disable watchdog
71 --watchdogmax=<seconds> : set maximum TIMEOUT when no packets received
72 default: 600 seconds
73 set 0 to disable watchdog (not recommended)
74
75 Usually the watchdog should not trigger (ever ever)!
76 But if it triggers, hcxdumptool has serious problems
77 - related to the hardware hardware
78 - related to the driver
79 - related to the configuration
80 - related to the Berkeley Packet filter
81
82
83 18.12.2025
84 ==========
85 hcxdumptool: added option to daemonize hcxdumptool
86 --daemonize : daemonize
87 status messages are suppressed
88 to terminate hcxdumptool send SIGTERM to its PID
89 or press push button (modified Raspberry Pi)
90
91
92 05.11.2025
93 ==========
94 hcxdumptool: added waterfall status display mode (rds=4)
95 Warning: Expect massive packet drops especially when running the real time display on slow CPUs
96
97
98 09.09.2025
99 ==========
100 release v7.0.1
101 hcxdumptool: fixed proberesponsetx error
102
103 08.09.2025
104 ==========
105 hcxdumptool: modified option proberesponsetx:
106 --proberesponsetx=<digit> : transmit n PROBERESPONSEs from the ESSID ring buffer
107 default: 1023
108 to disable transmitting of PROBERESPONSE frames set 0
109
110 Important notice:
111 This does not disable to retrieve an M2 of a CLIENT that is connected to an AP.
112 To disable this too set m2max to 0.
113
114 02.08.2025
115 ==========
116 release v7.0.0 (according to hashcat v7.0.0)
117 workaround on OpenWRT Linux Kernel bug: https://github.com/openwrt/openwrt/issues/19405
118
119 $ hcxdumptool -v
120 hcxdumptool 7.0.0 (C) 2025 ZeroBeat
121 running on Linux kernel 6.12.40-2-lts
122 running GNU libc version 2.42
123 compiled by gcc 15.1.1
124 compiled with Linux API headers 6.16.0
125 compiled with GNU libc headers 2.42
126 enabled BPF compiler
127
128
129 12.07.2025
130 ==========
131 added an information to --help that there is another help menu (-h)
132
133 $ hcxdumptool --help
134 hcxdumptool 6.3.5-148-gdabec8a (C) 2025 ZeroBeat
135 Additional information (for commonly used options use -h):
136 ----------------------------------------------------------
137 press GPIO button to terminate
138 hardware modification is necessary, read more:
139 https://github.com/ZerBea/hcxdumptool/tree/master/docs
140 to store entire traffic, run tshark in parallel on the same interface:
141 $ tshark -i <interface> -w allframes.pcapng
142
143 Berkeley Packet Filter:
144 -----------------------
145 see man bpfc
146
147 Important recommendation:
148 -------------------------
149 Do not set monitor mode by third party tools or third party scripts!
150 Do not use virtual interfaces (monx, wlanxmon, prismx, ...)!
151 Do not use virtual machines or emulators!
152 Do not run other tools that take access to the interface in parallel (except: tshark, wireshark, tcpdump)!
153 Do not use tools to change the virtual MAC (like macchanger)!
154 Do not merge (pcapng) dump files, because this destroys assigned hash values!
155
156
157 15.03.2025
158 ==========
159 hcxdumptool: added new option --rdt to disable TIOCGWINSZ
160 --rdt : disable TIOCGWINSZ for real time displays
161
162
163 03.03.2025
164 ==========
165 hcxnmealog: removed WPS information - all tested APs use WPS 2.0!
166
167 03.03.2025
168 ==========
169 hcxnmealog: changed option -c to -t because output is tabulator separated an not comma separated
170
171 02.03.2025
172 ==========
173 replaced hcxdumptool by hcxlabtool
174 major changes:
175 removed split screen ACCESS POINT <-> CLIENT
176 improved attack modes
177 added RSSI to rcascan
178 moved entire GPS handling from hcxdumptool to new hcxnmealog (still work on progress)
179
180 hcxdumptool:
181 most common options:
182 --------------------
183 -i <INTERFACE> : name of INTERFACE to be used
184 default: first suitable INTERFACE
185 warning:
186 hcxlabtool changes the mode of the INTERFACE
187 hcxlabtool changes the virtual MAC address of the INTERFACE
188 hcxlabtool changes the channel of the INTERFACE
189 -w <outfile> : write packets to a pcapng-format file named <outfile>
190 default outfile name: yyyyddmmhhmmss-interfacename.pcapng
191 existing file will not be overwritten
192 get more information: https://pcapng.com/
193 -c <digit> : set channel (1a,2a,36b,...)
194 default: 1a,6a,11a
195 important notice: channel numbers are not unique
196 it is mandatory to add band information to the channel number (e.g. 12a)
197 band a: NL80211_BAND_2GHZ
198 band b: NL80211_BAND_5GHZ
199 band c: NL80211_BAND_6GHZ
200 band d: NL80211_BAND_60GHZ
201 band e: NL80211_BAND_S1GHZ (902 MHz)
202 to disable frequency management, set this option to a single frequency/channel
203 -f <digit> : set frequency (2412,2417,5180,...)
204 -F : use all available frequencies from INTERFACE
205 -t <second> : minimum stay time (will increase on new stations and/or authentications)
206 default 7 seconds
207 -A : ACK incoming frames
208 INTERFACE must support active monitor mode
209 -L : show PHYSICAL INTERFACE list and terminate
210 -l : show PHYSICAL INTERFACE list (tabulator separated and greppable) and terminate
211 -I <INTERFACE> : show detailed information about INTERFACE and terminate
212 --bpfc=<filter> : compile Berkeley Packet Filter (BPF) and exit
213 $ hcxlabtool --bpfc="wlan addr3 112233445566" > filter.bpf
214 see man pcap-filter
215 --bpfd=<mode> : set output mode for compiled Berkeley Packet Filter (BPF)
216 default = 0
217 0 = compile BPF code as decimal numbers (readable by --bpf)
218 1 = compile BPF code as decimal numbers preceded with a count (readable by --bpf)
219 2 = compile BPF code as a C program fragment (readable by --bpf)
220 3 = compile BPF code as a ASM program (tcpdump style)
221 4 = compile BPF code as as decimal numbers (bpf_debug style)
222 see man pcap-filter
223 --bpf=<file> : input Berkeley Packet Filter (BPF) code (maximum 4096 instructions) in tcpdump decimal numbers format
224 see --help for more information
225 --ftc : enable fake time clock
226 --rds=<digit> : enable real time display
227 attack mode:
228 0 = off(default)
229 1 = show APs on current channel, show CLIENTs (M1M2ROGUE)
230 2 = show all APs (M1M2, M1M2M3 or PMKID), show CLIENTs (M1M2ROGUE)
231 3 = show all APs, show CLIENTs (M1M2ROGUE)
232 columns:
233 E = encryption (e)ncrypted / (o)pen
234 A = AKM (p)re-shared key
235 1 = received M1
236 2 = received M1M2
237 3 = received M1M2M3
238 P = received PMKID
239 rcascan mode
240 0 = show APs on current channel sorted by BEACON timestamp
241 1 = show APs on current channel sorted by RESPONSE timestamp
242 2 = show APs on current channel sorted by RSSI
243 --rcascan=<mode> : radio channel assessment scan
244 (a)ctive = active scan (transmit undirected PROBEREQUEST frames)
245 no PROBERESPONSE, AP is out of RANGE, packet injection is broken
246 (p)assive = passive scan (listen only)
247 -h : show this help
248 -v : show version
249
250 less common options:
251 --------------------
252 -m <INTERFACE> : set monitor mode and terminate
253 --m2max=<digit> : set maximum of received M1M2ROGUE
254 default: 4 M1M2ROGUE
255 to reject CLIENTs set 0
256 --associationmax=<digit> : set maximum of attempts to associate with an AP
257 default: 100 attempts
258 to disable association with an AP set 0
259 --disable_disassociation : do not transmit DISASSOCIATION frames
260 --proberesponsetx=<digit> : transmit n PROBERESPONSEs from the ESSID ring buffer
261 default: 1023
262 --essidlist=<file> : initialize ESSID list with these ESSIDs
263 --errormax=<digit> : set maximum allowed ERRORs
264 default: 100 ERRORs
265 --watchdogmax=<seconds> : set maximum TIMEOUT when no packets received
266 default: 600 seconds
267 --tot=<digit> : enable timeout timer in minutes
268 --exitoneapol=<type> : exit on first EAPOL occurrence:
269 bitmask:
270 1 = PMKID (from AP)
271 2 = EAPOL M2M3 (authorized)
272 4 = EAPOL M1M2 (not authorized)
273 8 = EAPOL M1M2ROGUE (not authorized)
274 16 = EAPOL M1
275 target BPF filter is recommended
276 --onsigterm=<action> : action when the program has been terminated (poweroff, reboot)
277 poweroff: power off system
278 reboot: reboot system
279 --ongpiobutton=<action> : action when the program has been terminated (poweroff, reboot)
280 poweroff: power off system
281 reboot: reboot system
282 --ontot=<action> : action when the program has been terminated (poweroff, reboot)
283 poweroff: power off system
284 reboot: reboot system
285 --onwatchdog=<action> : action when the program has been terminated (poweroff, reboot)
286 poweroff: power off system
287 reboot: reboot system
288 --onerror=<action> : action when the program has been terminated (poweroff, reboot)
289 poweroff: power off system
290 reboot: reboot system
291 --gpio_button=<digit> : Raspberry Pi GPIO pin number of button (2...27)
292 push GPIO button (> 10 seconds) to terminate program
293 default: 0 (GPIO not in use)
294 --gpio_statusled=<digit> : Raspberry Pi GPIO number of status LED (2...27)
295 default: 0 (GPIO not in use)
296 --help : show additional help (example and trouble shooting)
297 --version : show version
298
299
300 added new passive GPS logger hcxnmealog. It can run in parallel with hcxdumptool, tshark or Wireshark
301 data is logged to NMEA 0183 format (BSSID only - can be processed by gpsbabel) and CSV (tabulator separated)
302
303 hcxnmealog:
304 -n <file> : output nmea 0183 track to file
305 track append to file: filename
306 use gpsbabel to convert to other formats:
307 gpsbabel -w -t -i nmea -f in_file.nmea -o gpx -F out_file.gpx
308 gpsbabel -w -t -i nmea -f in_file.nmea -o kml -F out_file.kml
309 time = UTC (in accordance with the NMEA 0183 standard)
310 -t <file> : output separated by tabulator (tsv)
311 columns:
312 LINUX EPOCH (seconds that have passed since the date January 1st, 1970)
313 use date -d @epoch_value to convert to human readable time
314 BSSID (MAC ACCESS POINT)
315 ESSID (network name)
316 COUNTRY CODE (ISO / IEC 3166 alpha2 country code)
317 ENCRYPTION (encrypted / open)
318 RSN INFORMATION ELEMENT (WPA2/WPA3)
319 bitmask (--help for more information)
320 WPA INFORMATION ELEMENT (WPA1)
321 bitmask (--help for more information)
322 FREQUENCY (interface frequency in MHz)
323 CHANNEL
324 RSSI (signal strength in dBm)
325 lATITUDE (decimal degrees)
326 LONGITUDE (decimal degrees)
327 ALTITUDE (decimal degrees)
328 SPEED (knots)
329 PDOP (position -3D- dilution of precision)
330 HDOP (horizontal dilution of precision)
331 VDOP (vertical dilution of precision)
332 VDOP (vertical dilution of precision)
333 -d <device> : GPS source
334 use gpsd: gpsd
335 use device: /dev/ttyACM0, /dev/tty/USBx, ...
336 get more information: https://en.wikipedia.org/wiki/NMEA_0183
337 depending on the device it can take a while to get a fix
338 -b <digit> : baudrate of GPS device
339 default: 9600
340 -i <INTERFACE> : name of INTERFACE to be used
341 -h : show this help
342 -v : show version
343
344 --bpf=<file> : input Berkeley Packet Filter (BPF) code (maximum 4096 instructions) in tcpdump decimal numbers format
345 see --help for more information
346 --help : show additional help
347 --version : show version
348
349 Additional information:
350 0x00000000 suite not in use
351 Cipher Suites (bitmask)
352 0x00000001 WEP
353 0x00000002 TKIP
354 0x00000004 RESERVED
355 0x00000008 CCMP-128
356 0x00000010 WEP-104
357 0x00000020 BIP-CMAC-128
358 0x00000040 Group Address Traffic Not Allowed
359 0x00000080 GCMP-128
360 0x00000100 GCMP-256
361 0x00000200 CCMP-256
362 0x00000400 BIP-GMAC-128
363 0x00000800 BIP-GMAC-256
364 0x00001000 BIP-CMAC-256
365 0x00008000 unknown
366 Authentication Management Suites (bitmask)
367 0x00010000 802.1X
368 0x00020000 PSK
369 0x00040000 FT + 802.1X
370 0x00080000 FT + PSK
371 0x00100000 802.1X SHA-256
372 0x00200000 PSK SHA-256
373 0x00400000 TDLS
374 0x00800000 SAE SHA-256
375 0x01000000 FT + SAE SHA-256
376 0x02000000 AP Peer Key Authentication
377 0x04000000 802.1X Suite B EAP SH-256
378 0x08000000 802.1X Suite B EAP SH-384
379 0x10000000 FT + 802.1X SHA-384
380 0x80000000 unknown
381
382 11.11.2024
383 ==========
384 release v6.3.5
385 better compatibility with OpenWRT
386 several fixes
387
388
389 04.03.2024
390 ==========
391 README.md: removed entire instructions how to compile hcxdumptool on different distributions
392 check the distribution's page how to update the distribution, how to install missing dependencies and missing header files
393
394
395 25.02.2024
396 ==========
397 release v6.3.4
398 release v6.3.3
399 internal BPFC compiler enabled by default
400 new dependency libpcap
401
402
403 04.02.2024
404 ==========
405 hcxdumptool: changed bit mask order of exitoneapol
406 --exitoneapol=<type> : exit on first EAPOL occurrence:
407 bitmask:
408 1 = PMKID (from AP)
409 2 = EAPOL M2M3 (authorized)
410 4 = EAPOL M1M2/M1M2ROGUE (not authorized)
411 8 = EAPOL M1
412
413
414 06.01.2024
415 ==========
416 hcxdumptool: changed option --beacon_off to --disable_beacon
417
418
419 04.12.2023
420 ==========
421 hcxdumptool: allow to set monitor mode (-m) in combination with channel (-c) or frequency (-f)
422
423
424 28.12.2023
425 ==========
426 hcxdumptool: do not spam channel with retries
427 changed SNAPLEN
428
429
430 22.12.2023
431 ==========
432 hcxdumptool: added BE support
433 removed option beacontx
434 --beaconoff : disable internal BEACON (one BEACON/second to wildcard SSID)
435
436
437 08.12.2023
438 ==========
439 Some drivers report incorrectly active monitor mode capability.
440 hcxdumptool: do not set active monitor mode by default if driver report that it is possible
441 removed option -p
442 added new option -A in case active monitor mode is working as expected
443 -A : ACK incoming frames
444 INTERFACE must support active monitor mode
445
446
447 28.11.2023
448 ==========
449 hcxdumptool: added full featured BPF compiler
450 due to additional dependency (libpcap and libpcap-dev) this feature must be enabled in Makefile
451 added PROBEREQUEST counter to rcascan mode
452 added option to sort rcascan display by PROBEREQUEST counter
453
454
455 27.11.2023
456 ==========
457 hcxdumptool: accept Berkeley Packet filter code in tcpdump raw format and in tcpdump c style format
458 -bpf=<file> : input Berkeley Packet Filter (BPF) code (maximum 4096 instructions)
459 in tcpdump raw format:
460 example: tcpdump high level compiler:
461 $ tcpdump -s 65535 -y IEEE802_11_RADIO wlan addr3 11:22:33:44:55:66 -ddd > filter.bpf
462 see man pcap-filter
463 example: bpf_asm low level compiler
464 $ bpf_asm filter.asm | tr ',' '\n' > filter.bpf
465 see https://www.kernel.org/doc/html/latest/networking/filter.html
466 example: bpfc low level compiler:
467 $ bpfc -f tcpdump -i filter.asm > filter.bpf
468 see man bpfc
469 in tcpdump c style format:
470 example: tcpdump high level compiler:
471 $ tcpdump -s 65535 -y IEEE802_11_RADIO wlan addr3 11:22:33:44:55:66 -dd > filter.bpf
472 see man pcap-filter
473 example: bpfc low level compiler:
474 $ bpfc -f C -i filter.asm > filter.bpf
475 see man bpfc
476
477
478 01.11.2023
479 ==========
480 release v6.3.2
481
482
483 23.10.2023
484 ==========
485 hcxdumptool: removed option "disable_beacon" because it is replaced by option beacontx=0
486
487
488 01.09.2023
489 ==========
490 hcxdumptool: added new option to get short and greppable interface list
491
492
493 26.07.2023
494 ==========
495 hcxdumptool: added compile time information to version information
496
497 $ hcxdumptool -v
498 hcxdumptool 6.3.1-35-g1a0930e (C) 2023 ZeroBeat
499 compiled by gcc 13.1.1
500 Linux API headers 6.3.0
501 compiled with glibc 2.37
502
503 Under normal circumstances, the Linux kernel version could be
504 greater than the "Linux API headers" version, but never less.
505
506
507 24.07.2023
508 ==========
509 hcxdumptool: added new option to EXIT on EAPOL
510 --exitoneapol=<type> : exit on first EAPOL occurrence:
511 bitmask:
512 1 = PMKID
513 2 = EAPOL M2
514 4 = EAPOL M3
515 target BPF filter is recommended
516 get more information here:
517 https://github.com/ZerBea/hcxdumptool/issues/333#issuecomment-1647684235
518
519
520 03.07.2023
521 ==========
522 added -Wpedantic to compiler flags and fixed all warnings
523
524
525 30.06.2023
526 ==========
527 release v6.3.1
528
529
530 09.05.2023
531 ==========
532 hcxdumptool: added option to remove active monitor flag
533 -p : do not set monitor mode: active (do not ACK incoming frames addressed to the device MAC
534 default monitor mode: active (ACK all incoming frames addressed to the device MAC)
535
536 This is a workaround on mt7601u devices/drivers.
537 Running active monitor mode, only frames addressed to the MAC of the device
538 or addressed to BROADCAST MAC are received. This is a driver/firmware problem!
539 To verify if you are affected:
540 run hcxdumptool
541 run Wireshark in parallel and set filter option to "eapol"
542 if Wireshark only show EAPOL M1 frames it is mandatory to disable active monitor mode
543 by option "-p"
544
545 Problem is reported here:
546 https://bugzilla.kernel.org/show_bug.cgi?id=217465
547
548
549 06.05.2023
550 ==========
551 hcxdumptool: added option to save GPS information to pcapng dumpfile
552 --nmea_pcapng : write GPS information to pcapng dump file
553
554
555 05.05.2023
556 ==========
557 release v6.3.0
558
559 Since kernel 6.3 Kernel developer decided to print a dmesg warning if tools are detected that use deprecated WEXT:
560 [ 2770.939021] warning: `hcxdumptool' uses wireless extensions which will stop working for Wi-Fi 7 hardware; use nl80211
561 hcxdumptool used ioctl(SIOCGIWNAME) to detect presence of WEXT. That was the last remnant of WEXT code.
562 To get rid of this dmesg warning, this detection has been removed by latest commit.
563
564
565 03.05.2023
566 ==========
567 hcxdumptool: changed/added several options:
568 $ hcxdumptool --help
569 hcxdumptool 6.2.9-161-gf581815 (C) 2023 ZeroBeat
570 usage: hcxdumptool <options>
571 first stop all services that take access to the interface, e.g.:
572 $ sudo systemctl stop NetworkManager.service
573 $ sudo systemctl stop wpa_supplicant.service
574 then run hcxdumptool
575 press ctrl+c to terminate
576 press GPIO button to terminate
577 hardware modification is necessary, read more:
578 https://github.com/ZerBea/hcxdumptool/tree/master/docs
579 stop all services (e.g.: wpa_supplicant.service, NetworkManager.service) that take access to the interface
580 do not set monitor mode by third party tools (iwconfig, iw, airmon-ng)
581 do not use logical (NETLINK) interfaces (monx, wlanxmon, prismx, ...) created by airmon-ng and iw
582 do not use virtual machines or emulators
583 do not run other tools that take access to the interface in parallel (except: tshark, wireshark, tcpdump)
584 do not use tools to change MAC (like macchanger)
585 do not merge (pcapng) dump files, because this destroys assigned hash values!
586
587 short options:
588 -i <INTERFACE> : name of INTERFACE to be used
589 default: first suitable INTERFACE
590 warning: hcxdumptool changes the virtual MAC address of the INTERFACE
591 -w <outfile> : write packets to a pcapng-format file named <outfile>
592 default outfile name: yyyyddmmhhmmss-interfacename.pcapng
593 get more information: https://pcapng.com/
594 -c <digit> : set channel (1a,2a,36b...)
595 default: 1a,6a,11a
596 important notice: channel numbers are not unique
597 it is mandatory to add band information to the channel number (e.g. 12a)
598 band a: NL80211_BAND_2GHZ
599 band b: NL80211_BAND_5GHZ
600 band c: NL80211_BAND_6GHZ
601 band d: NL80211_BAND_60GHZ
602 band e: NL80211_BAND_S1GHZ (902 MHz)
603 to disable frequency management, set this option to a single frequency/channel
604 -f <digit> : set frequency (2412,2417,5180,...)
605 -F : use available frequencies from INTERFACE
606 -t <second> : minimum stay time (will increase on new stations and/or authentications)
607 default 1 seconds
608 -m <INTERFACE> : set monitor mode and terminate
609 -L : show INTERFACE list
610 -I <INTERFACE> : show detailed information about INTERFACE
611 -h : show this help
612 -v : show version
613
614 long options:
615 --bpf=<file> : input kernel space Berkeley Packet Filter (BPF) code
616 steps to create a BPF (it only has to be done once):
617 $ hcxdumptool -m <interface>
618 create BPF to protect MACs
619 $ tcpdump -i <INTERFACE> not wlan addr2 11:22:33:44:55:66 -ddd > protect.bpf
620 recommended to protect own devices
621 create BPF to attack a MAC
622 $ tcpdump -i <INTERFACE> wlan addr1 11:22:33:44:55:66 or wlan addr2 11:22:33:44:55:66 or wlan addr3 11:22:33:44:55:66 -ddd > attack.bpf
623 it is strongly recommended to allow all PROBEREQUEST frames (wlan_type mgt && wlan_subtype probe-req)
624 $ tcpdump -i <interface> wlan addr1 11:22:33:44:55:66 or wlan addr2 11:22:33:44:55:66 or wlan addr3 11:22:33:44:55:66 or wlan addr3 ff:ff:ff:ff:ff:ff -ddd > attack.bpf
625 see man pcap-filter for a list of all filter options
626 add BPF code:
627 $ hcxdumptool -i <INTERFACE> --bpf=attack.bpf ...
628 --disable_beacon : do not transmit BEACON frames
629 --disable_deauthentication : do not transmit DEAUTHENTICATION/DISASSOCIATION frames
630 --disable_proberequest : do not transmit PROBEREQUEST frames
631 --disable_association : do not AUTHENTICATE/ASSOCIATE
632 --disable_reassociation : do not REASSOCIATE a CLIENT
633 --beacontx=<digit> : transmit BEACON of first n entries of ESSID list
634 default: 10
635 --proberesponsetx=<digit> : transmit PROBERESPONSEs of first n entries of ESSID list
636 default: 10
637 --essidlist=<file> : initialize ESSID list with these ESSIDs
638 --errormax=<digit> : set maximum allowed ERRORs
639 default: 100 ERRORs
640 --watchdogmax=<seconds> : set maximum TIMEOUT when no packets received
641 default: 600 seconds
642 --attemptclientmax=<digit> : set maximum of attempts to request an EAPOL M2
643 default: 10 attempts
644 --attemptapmax=<digit> : set maximum of received BEACONs to request a PMKID or to get a 4-way handshake
645 default: stop after 4 received BEACONs
646 --tot=<digit> : enable timeout timer in minutes
647 --onsigterm=<action> : action when the program has been terminated (poweroff, reboot)
648 poweroff: power off system
649 reboot: reboot system
650 --ongpiobutton=<action> : action when the program has been terminated (poweroff, reboot)
651 poweroff: power off system
652 reboot: reboot system
653 --ontot=<action> : action when the program has been terminated (poweroff, reboot)
654 poweroff: power off system
655 reboot: reboot system
656 --onwatchdog=<action> : action when the program has been terminated (poweroff, reboot)
657 poweroff: power off system
658 reboot: reboot system
659 --onerror=<action> : action when the program has been terminated (poweroff, reboot)
660 poweroff: power off system
661 reboot: reboot system
662 --gpio_button=<digit> : Raspberry Pi GPIO pin number of button (2...27)
663 push GPIO button (> 10 seconds) to terminate program
664 default: 0 (GPIO not in use)
665 --gpio_statusled=<digit> : Raspberry Pi GPIO number of status LED (2...27)
666 default: 0 (GPIO not in use)
667 --nmea_dev=<NMEA device> : open NMEA device (/dev/ttyACM0, /dev/tty/USB0, ...)
668 baudrate = BD9600
669 --gpsd : use gpsd to get position
670 gpsd will be switched to NMEA0183 mode
671 --nmea_out=<outfile> : write GPS information to a nmea-format file named <outfile>
672 default outfile name: yyyymmddhhmmss.nmea
673 output: NMEA 0183 standard messages:
674 $GPRMC: Position, velocity, time and date
675 $GPGGA: Position, orthometric height, fix related data, time
676 $GPWPL: Position and MAC AP
677 $GPTXT: ESSID in HEX ASCII
678 use gpsbabel to convert to other formats:
679 gpsbabel -w -t -i nmea -f in_file.nmea -o gpx -F out_file.gpx
680 gpsbabel -w -t -i nmea -f in_file.nmea -o kml -F out_file.kml
681 get more information: https://en.wikipedia.org/wiki/NMEA_0183
682 --rcascan=<character> : do (R)adio (C)hannel (A)ssignment scan
683 default = passive scan
684 a = active scan
685 p = passive scan
686 --rds=<digit> : sort real time display
687 default: sort by time (last seen on top)
688 1 = sort by status (last PMKID/EAPOL on top)
689 --help : show this help
690 --version : show version
691
692 Legend
693 real time display:
694 R = + AP display: AP is in TX range or under attack
695 S = + AP display: AUTHENTICATION KEY MANAGEMENT PSK
696 P = + AP display: got PMKID
697 1 = + AP display: got EAPOL M1 (CHALLENGE)
698 3 = + AP display: got EAPOL M1M2M3 (AUTHORIZATION)
699 E = + CLIENT display: got EAP-START MESSAGE
700 2 = + CLIENT display: got EAPOL M1M2 (ROGUE CHALLENGE)
701 Notice:
702 This is a penetration testing tool!
703 It is made to detect vulnerabilities in your NETWORK mercilessly!
704 To store entire traffic, run <tshark -i <interface> -w allframes.pcapng> in parallel
705
706
707 19.04.2023
708 ==========
709 hcxdumptool: changed rcascan
710 --rcascan=<character> : do (R)adio (C)hannel (A)ssignment scan
711 default = passive scan
712 a = active scan
713 p = passive scan
714
715
716 14.04.2023
717 ==========
718 hcxdumptool: added new option to sort status display
719 --rds=<digit> : sort real time display
720 default: sort by time (last seen on top)
721 1 = sort by status (last PMKID/EAPOL on top)
722
723
724 07.04.2023
725 ==========
726 removed obsolete hcxpioff
727 refactored hcxdumptool: replaced entire hcxdumptool code by hcxlabtool code
728
729 $ hcxdumptool --help
730 hcxdumptool 6.2.9-22-gace924f (C) 2023 ZeroBeat
731 usage: hcxdumptool <options>
732 first stop all services that take access to the interface , e.g.:
733 $ sudo systemctl stop NetworkManager.service
734 $ sudo systemctl stop wpa_supplicant.service
735 than run hcxdumptool
736 press ctrl+c to terminate
737 press GPIO button to terminate
738 hardware modification is necessary, read more:
739 https://github.com/ZerBea/hcxdumptool/tree/master/docs
740 do not set monitor mode by third party tools (iwconfig, iw, airmon-ng)
741 do not use logical (NETLINK) interfaces (monx, wlanxmon, prismx, ...) created by airmon-ng and iw
742 do not use virtual machines or emulators
743 do not run other tools that take access to the interface in parallel (except: tshark, wireshark, tcpdump)
744 do not use tools to change MAC (like macchanger)
745 stop all services (e.g.: wpa_supplicant.service, NetworkManager.service) that take access to the interface
746
747 short options:
748 -i <INTERFACE> : name of INTERFACE to be used
749 default: first suitable INTERFACE
750 warning: hcxdumptool changes the virtual MAC address of the INTERFACE
751 -w <outfile> : write packets to a pcapng-format file named <outfile>
752 default outfile name: yyyyddmmhhmmss-interfacename.pcapng
753 get more information: https://pcapng.com/
754 -c <digit> : set channel (1a,2a,36b...)
755 default: 1a,6a,11a
756 important notice: channel numbers are not unique
757 it is mandatory to add band information to the channel number (e.g. 12a)
758 band a: NL80211_BAND_2GHZ
759 band b: NL80211_BAND_5GHZ
760 band c: NL80211_BAND_6GHZ
761 band d: NL80211_BAND_60GHZ
762 band e: NL80211_BAND_S1GHZ (902 MHz)
763 to disable frequency management, set this option to a single frequency/channel
764 -f <digit> : set frequency (2412,2417,5180,...)
765 -F : use available frequencies from INTERFACE
766 -t <second> : minimum stay time (will increase on new stations and/or authentications
767 default 1 seconds
768 -m <INTERFACE> : set monitor mode and terminate
769 -L : show INTERFACE list
770 -I <INTERFACE> : show detailed information about INTERFACE
771 -h : show this help
772 -v : show version
773
774 long options:
775 --bpf=<file> : input kernel space Berkeley Packet Filter (BPF) code
776 steps to create a BPF (it only has to be done once):
777 $ hcxdumptool -m <interface>
778 create BPF to protect MACs
779 $ tcpdump -i <INTERFACE> not wlan addr2 11:22:33:44:55:66 -ddd > protect.bpf
780 recommended to protect own devices
781 create BPF to attack a MAC
782 $ tcpdump -i <INTERFACE> wlan addr1 11:22:33:44:55:66 or wlan addr2 11:22:33:44:55:66 or wlan addr3 11:22:33:44:55:66 -ddd > attack.bpf
783 it is strongly recommended to allow all PROBEREQUEST frames (wlan_type mgt && wlan_subtype probe-req)
784 $ tcpdump -i <interface> wlan addr1 11:22:33:44:55:66 or wlan addr2 11:22:33:44:55:66 or wlan addr3 11:22:33:44:55:66 or wlan addr3 ff:ff:ff:ff:ff:ff -ddd > attack.bpf
785 see man pcap-filter for a list of all filter options
786 add BPF code:
787 $ hcxdumptool -i <INTERFACE> --bpf=attack.bpf ...
788 --disable_beacon : do not transmit BEACON frames
789 --disable_deauthentication : do not transmit DEAUTHENTICATION/DISASSOCIATION frames
790 --disable_proberequest : do not transmit PROBEREQUEST frames
791 --disable_association : do not AUTHENTICATE/ASSOCIATE
792 --disable_reassociation : do not REASSOCIATE a CLIENT
793 --beacontx=<digit> : transmit BEACON of first n entries of ESSID list
794 default: 10
795 --proberesponsetx=<digit> : transmit PROBERESPONSEs of first n entries of ESSID list
796 default: 10
797 --essidlist=<file> : initialize ESSID list with this ESSIDs
798 --errormax=<digit> : set maximum allowed ERRORs
799 default: 100 ERRORs
800 --watchdog=<seconds> : set maximum TIMEOUT when no packets received
801 default: 600 seconds
802 --attemptclientmax=<digit> : set maximum of attempts to request an EAPOL M2
803 default: 10 attempts
804 --attemptapmax=<digit> : set maximum of received BEACONs to request a PMKID or to get a 4-way handshake
805 default: stop after 4 received BEACONs
806 --tot=<digit> : enable timeout timer in minutes
807 --onsigterm=<action> : action when the program has been terminated (poweroff, reboot)
808 poweroff: power off system
809 reboot: reboot system
810 --ongpiobutton=<action> : action when the program has been terminated (poweroff, reboot)
811 poweroff: power off system
812 reboot: reboot system
813 --ongtot=<action> : action when the program has been terminated (poweroff, reboot)
814 poweroff: power off system
815 reboot: reboot system
816 --onwatchdog=<action : action when the program has been terminated (poweroff, reboot)
817 poweroff: power off system
818 reboot: reboot system
819 --onerror=<action> : action when the program has been terminated (poweroff, reboot)
820 poweroff: power off system
821 reboot: reboot system
822 --gpio_button=<digit> : Raspberry Pi GPIO pin number of button (2...27)
823 push GIPO button (> 10 seconds) to terminate program
824 default: 0 (GPIO not in use)
825 --gpio_statusled=<digit> : Raspberry Pi GPIO number of status LED (2...27)
826 default: 0 (GPIO not in use)
827 --nmea_dev=<NMEA device> : open NMEA device (/dev/ttyACM0, /dev/tty/USB0, ...)
828 baudrate = BD9600
829 --gpsd : use gpsd to get position
830 gpsd will be switched to NMEA0183 mode
831 --nmea_out=<outfile> : write GPS information to a nmea-format file named <outfile>
832 default outfile name: yyyyddmmhhmmss.nmea
833 output: NMEA 0183 standard messages:
834 $GPRMC: Position, velocity, time and date
835 $GPGGA: Position, orthometric height, fix related data, time
836 $GPWPL: Position and MAC AP
837 $GPTXT: ESSID in HEX ASCII
838 use gpsbabel to convert to other formats:
839 gpsbabel -w -t -i nmea -f in_file.nmea -o gpx -F out_file_gpx
840 gpsbabel -w -t -i nmea -f in_file.nmea -o kml -F out_file.kml
841 get more information: https://en.wikipedia.org/wiki/NMEA_0183
842 --rcascan_passive : do passive (R)adio (C)hannel (A)ssignment scan
843 --help : show this help
844 --version : show version
845
846 Legend
847 real time display:
848 R = + AP is in TX range
849 P = + got PMKID
850 M = + AP display: got EAPOL M1M2M3 (AUTHORIZATION)
851 M = + CLIENT display: got EAPOL M1M2 (ROGUE CHALLENGE)
852 A = + AUTHENTICATION KEY MANAGEMENT PSK
853 Notice:
854 This is a penetration testing tool!
855 It is made to detect vulnerabilities in your NETWORK mercilessly!
856 To store entire traffic, run <tshark -i <interface> -w allframes.pcapng> in parallel
857
858
859 06.04.2023
860 ==========
861 release v6.2.9
862 several bug fixes
863
864 This is the last version:
865 that use WIRELESS EXTENSIONS
866 that use ETHTOOL to get/set virtual MAC address
867 that use old style status output
868 that use soft coded filter lists
869 that use msec timestamp
870 that use crypto stuff
871 that use server/client mode to display status
872
873 Next version will go back to the roots:
874 set focus on WPA PSK (WPA1, WPA2, WPA2 key version 3)
875 set bandwidth to 20MHz to increase range
876 set bitrate to lowest values to increase range
877 use active monitor mode
878 use NL80211 stack
879 use RTNETLINK
880 band a, b, c, d, e support
881 use NMEA messages:
882 $GPRMC: Position, velocity, time and date
883 $GPGGA: Position, orthometric height, fix related data, time
884 $GPWPL: Position and MAC AP
885 $GPTXT: ESSID in HEX ASCII
886 remove options that slow hcxdumptool down
887
888
889 10.03.2023
890 ==========
891 release v6.2.8
892 move to OpenSSL 3.0 EVP API (from now on OPenSSL >= 3.0 is mandatory)
893 new options
894 several bug fixes
895
896
897 16.01.2023
898 ==========
899 hcxdumptool: added option to reset an USB device without unplugging it
900 --reset_usb_device=<sysfs dev path>: reset USB device by BUS ID and device ID (/dev/bus/usb/bus_id/device_id
901 $ lsusb
902 Bus 005 Device 006: ID 7392:7710 Edimax Technology Co., Ltd Edimax Wi-Fi
903 sysfs dev path = /dev/bus/usb/005/006
904
905
906 12.11.2022
907 ==========
908 start moving to OpenSSL 3.0 EVP API
909 this is a huge step forward an will break backward compatibility
910 https://wiki.openssl.org/index.php/OpenSSL_3.0
911
912
913 07.08.2022
914 ==========
915 release v6.2.7
916 several bug fixes
917 still using OpenSSL 1.1
918
919
920 02.06.2022
921 ==========
922 hcxdumptool: added warning if a not recommended driver has been detected
923
924
925 31.05.2022
926 ==========
927 hcxpcapngtool: added new option according to https://github.com/ZerBea/hcxdumptool/issues/220
928 --passive : channel management is completely disabled - initial channel must be set by a third party tool
929 hcxdumptool is acting like a passive dumper (silent mode)
930 expect possible heavy packet loss
931
932
933 22.04.2022
934 ==========
935 release v6.2.6
936 several bug fixes
937 license update
938 still supporting OpenSSL 1.1
939
940
941 01.12.2021
942 ==========
943 release v6.2.5
944 still supporting OpenSSL 1.1
945
946
947 08.11.2021
948 ==========
949 hcxdumptool: replaced channel scan engine by frequency scan engine
950 this is high experimental
951 tested devices:
952 USB:
953 Bus 005 Device 060: ID 148f:5370 Ralink Technology, Corp. RT5370 Wireless Adapter
954 Bus 005 Device 062: ID 148f:761a Ralink Technology, Corp. MT7610U ("Archer T2U" 2.4G+5G WLAN Adapter
955 Bus 005 Device 064: ID 148f:5572 Ralink Technology, Corp. RT5572 Wireless Adapter
956 Bus 005 Device 065: ID 0e8d:7612 MediaTek Inc. MT7612U 802.11a/b/g/n/ac Wireless Adapter
957 Bus 005 Device 066: ID 0cf3:9271 Qualcomm Atheros Communications AR9271 802.11n
958 Bus 005 Device 068: ID 0bda:8178 Realtek Semiconductor Corp. RTL8192CU 802.11n WLAN Adapter
959 Bus 005 Device 071: ID 7392:7710 Edimax Technology Co., Ltd Edimax Wi-Fi
960 Bus 005 Device 073: ID 148f:7601 Ralink Technology, Corp. MT7601U Wireless Adapter
961 Bus 005 Device 075: ID 148f:3070 Ralink Technology, Corp. RT2870/RT3070 Wireless Adapter
962 Bus 005 Device 078: ID 0b05:17d1 ASUSTek Computer, Inc. AC51 802.11a/b/g/n/ac Wireless Adapter [Mediatek MT7610U]
963 Bus 005 Device 082: ID 0bda:8187 Realtek Semiconductor Corp. RTL8187 Wireless Adapter
964
965 PCI:
966 04:00.0 Network controller: Realtek Semiconductor Co., Ltd. RTL8821CE 802.11ac PCIe Wireless Network Adapter
967
968 That is necessary because, since WiFi 6, channel numbers are no longer unique:
969 https://en.wikipedia.org/wiki/List_of_WLAN_channels
970
971
972 24.10.2021
973 ==========
974 hcxdumptool: added new option to ignore ioctl() warnings
975 --force_interface : ignore all ioctl() warnings
976 do not report issues, if attacks or channel switch is not working as expected
977
978
979 23.10.2021
980 ==========
981 added generic hcxdumptool.1 man page
982
983
984 22.10.2021
985 ==========
986 moved install dir from usr/local/bin to /usr/bin
987
988
989 14.09.2021
990 ==========
991 release v6.2.4
992 This is the last version, supporting OpenSSL 1.1
993 Next version 6.3.0 will need OpenSSL 3.0.0
994
995
996 01.09.2021
997 ==========
998 hcxdumptool: added new option to the next EAP request entry contained in the sequence passed to
999 --eapreq with a type matching the Desired Auth Type requested in a client's Legacy NAK response
1000 --eapreq_follownak : jump to Auth Type requested by client in Legacy Nak response, if type available in remaining request sequence
1001
1002
1003 29.08.2021
1004 ==========
1005 hcxdumptool: GPIO flash interval not longer hardcoded
1006 --gpio_statusled_intervall=<digit> : Raspberry Pi GPIO LED flash interval
1007 default = flash every 5 seconds
1008
1009
1010 15.08.2021
1011 ==========
1012 hcxdumptool: allow MAC instead of filter list
1013 --filterlist_ap=<file or MAC> : ACCESS POINT MAC or MAC filter list
1014 format: 112233445566, 11:22:33:44:55:66, 11-22-33-44-55-66 # comment
1015 maximum entries 256
1016 run first --do_rcascan to retrieve information about the target
1017 --filterlist_client=<file or MAC> : CLIENT MAC or MAC filter list
1018 format: 112233445566, 11:22:33:44:55:66, 11-22-33-44-55-66 # comment
1019 maximum entries 256
1020 due to MAC randomization of the CLIENT, it does not always work!
1021
1022
1023 17.05.2021
1024 ==========
1025 release v 6.1.6
1026 get ready for gcc 11.1.0
1027
1028
1029 18.03.2021
1030 ==========
1031 hcxdumptool: added VENDOR filter
1032 --filterlist_ap_vendor=<file> : ACCESS POINT MAC filter list by VENDOR
1033 format: 112233, 11:22:33, 11-22-33 # comment
1034 maximum entries 256
1035 run first --do_rcascan to retrieve information about the target
1036 --filterlist_client_VENDOR=<file> : CLIENT MAC filter list
1037 format: 112233, 11:22:33, 11-22-33 # comment
1038 maximum entries 256
1039 due to MAC randomization of the CLIENT, it does not always work!
1040
1041
1042 09.03.2021
1043 ==========
1044 release v 6.1.6
1045 get ready for OpenSSL 3.0
1046
1047
1048 05.03.2021
1049 ==========
1050 hcxdumptool: removed preamble option, because it is ignored by most wlan adapters
1051
1052
1053 04.03.2021
1054 ==========
1055 hcxdumptool: added new option to use short preamble
1056 --short_preamble : use short preamble
1057 default: use long preamble
1058 that may not work on older devices!
1059
1060
1061 23.02.2021
1062 ==========
1063 hcxdumptool: allow output to stdout
1064 -o <dump file> : output file in pcapng format, filename '-' outputs to stdout
1065 including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
1066
1067
1068 14.02.2021
1069 ==========
1070 sll_pkttype = PACKET_OUTGOING is completely ignored in promiscuous mode
1071 At least I found a way to detect outgoing packets.
1072 Luckily IEEE80211_RADIOTAP_TX_FLAGS is set on outgoing packets. If we check this, we are able to ignore them.
1073 That save us CPU time.
1074
1075
1076 13.02.2021
1077 ==========
1078 hcxdumptool: added WATCHDOG - we need that to determine if USB device died
1079 Raspberry Pi LED will flash twice if now packet received turing the last past 600 seconds
1080 print AGE of last received packet in status
1081
1082
1083 09.02.2021
1084 ==========
1085 started to prepare to use openssl 3.0
1086 Many structures have been made opaque in OpenSSL 3.0 since OpenSSL 1.0.2
1087 https://wiki.openssl.org/index.php/OpenSSL_3.0
1088 it is recommended to upgrade to at least to OpenSSL 1.1
1089
1090
1091 06.02.2021
1092 ==========
1093 hcxdumptool: fixed handling of BE (according to hcxpcapngtool fixes)
1094
1095
1096 18.01.2021
1097 ==========
1098 hcxdumptool: added auto channel/auto band.
1099 therefore default channel list and predefined channel lists changed!
1100
1101 -c <digit> : set channel (1,2,3, ...)
1102 default: auto channel/auto band
1103 maximum entries: 255
1104 standard 802.11 channels (depends on device, driver and world regulatory domain):
1105 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14
1106 36, 38, 40, 44, 48, 52, 56, 60, 64
1107 100, 104, 108, 112, 116, 120, 124, 128
1108 132, 136, 140, 144, 149, 153, 157, 161, 165
1109 201, 205, 209, 213, 217, 221, 225, 229, 233
1110 -s <digit> : set predefined scanlist
1111 0 = auto channel/auto band (default)
1112 1 = 1,6,11,3,5,1,6,11,2,4,1,6,11,7,9,1,6,11,8,10,1,6,11,12,13 (optimized 2.4GHz)
1113 2 = 1,2,3,4,5,6,7,8,9,10,11,12,13 (standard 2.4 GHz)
1114 3 = 36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165 (standard 5GHz)
1115 4 = 1,2,3,4,5,6,7,8,9,10,11,12,13,36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165 (standard 2.4GHz/5GHz)
1116 5 = 201,205,209,213,217,221,225,229,233 (standard 6GHz)
1117
1118
1119 16.01.2021
1120 ==========
1121 hcxdumptool: added new option - rcascan ranking is no longer hard coded
1122 --rcascan_order=digit> : rcascan sorting order:
1123 0 = sort by HIT (PROBERESPONSE) (default)
1124 1 = sort by COUNT (BEACON)
1125 2 = sort by CHANNEL
1126
1127
1128 14.01.2021
1129 ==========
1130 release v 6.1.5
1131
1132
1133 03.01.2021
1134 ==========
1135 hcxdummptool: added new option to limit status of rcascan to n lines
1136 --rcascan_max=digit> : show only n highest ranking lines
1137 default: 256 lines
1138
1139
1140 21.12.2020
1141 ==========
1142 removed TP-LINK TL-WN722N v1 (ath9k driver) from list of working devices due to driver issue
1143 hcxdumptool: moved from select() to pselect()
1144
1145
1146 20.12.2020
1147 ==========
1148 hcxdumptool: added tot (transmission timeout timer)
1149 hcxdumptool will no longer freeze if driver died
1150 this is a workaround on ath9k driver issue:
1151 https://github.com/ZerBea/hcxdumptool/issues/80#issuecomment-748622644
1152 not caused by hcxdumptool:
1153 https://bugs.archlinux.org/task/68578
1154
1155
1156 19.12.2020
1157 ==========
1158 hcxdumptool: added support for 6GHz channels 201,205,209,213,217,221,225,229,233 on option -c and option -s
1159 -s <digit> : set predefined scanlist
1160 0 = 1,6,11,3,5,1,6,11,2,4,1,6,11,7,9,1,6,11,8,10,1,6,11,12,13 (default)
1161 1 = 1,2,3,4,5,6,7,8,9,10,11,12,13
1162 2 = 36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165
1163 3 = 1,2,3,4,5,6,7,8,9,10,11,12,13,36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165
1164 4 = 201,205,209,213,217,221,225,229,233
1165
1166
1167 10.12.2020
1168 ==========
1169 Makefile: make use of pkg-config
1170
1171
1172 02.12.2020
1173 ==========
1174 release v 6.1.4
1175
1176
1177 27.11.2020
1178 ==========
1179 hcxdumptool: show openSSL version in status
1180
1181
1182 24.10.2020
1183 ==========
1184 hcxdumptool: Default channels are not longer hard coded.
1185
1186 Now hcxdumptool test if channel is available. That allow handling of channels
1187 from a patched driver.
1188
1189 Some 2 GHz ath9k radios are actually tunable on 2312-2732 on 5 MHz steps
1190
1191 CHAN2G(2407, 14)
1192 CHAN2G(2402, 15)
1193 CHAN2G(2397, 16)
1194 CHAN2G(2392, 17)
1195 CHAN2G(2387, 18)
1196 CHAN2G(2382, 19)
1197 CHAN2G(2377, 20)
1198 CHAN2G(2372, 21)
1199 CHAN2G(2367, 22)
1200 CHAN2G(2362, 23)
1201 CHAN2G(2357, 24)
1202 CHAN2G(2352, 25)
1203 CHAN2G(2347, 26)
1204 CHAN2G(2342, 27)
1205 CHAN2G(2337, 28)
1206 CHAN2G(2332, 29)
1207 CHAN2G(2327, 30)
1208 CHAN2G(2322, 31)
1209 CHAN2G(2317, 32)
1210 CHAN2G(2312, 33)
1211
1212
1213 09.10.2020
1214 ==========
1215 release v 6.1.3
1216 fixed broken GPS handling
1217 added better GPS error handling
1218
1219
1220 03.10.2020
1221 ==========
1222 hcxdumptool: added new option
1223 --example : show some example command lines
1224
1225
1226 30.09.2020
1227 ==========
1228 hcxdumptool: added new options
1229 --eapreq=<type><data>[:<term>],... : send max. 20 subsequent EAP requests after initial EAP ID request, hex string starting with EAP Type
1230 response is terminated with:
1231 :F = EAP Failure
1232 :S = EAP Success
1233 :I = EAP ERP Initiate
1234 :F = EAP ERP Finish
1235 :D = Deauthentication
1236 :T = TLS shutdown
1237 :- = no packet
1238 default behavior is terminating all responses with a EAP Failure, after last one the client is deauthenticated
1239 --eaptlstun : activate TLS tunnel negotiation and Phase 2 EAP requests when requesting PEAP using --eapreq
1240 requires --eap_server_cert and --eap_server_key
1241 --eap_server_cert=<server.pem> : EAP TLS tunnel Server cert PEM file
1242 --eap_server_key=<server.key> : EAP TLS tunnel Server private key file
1243
1244
1245
1246 17.09.2020
1247 ==========
1248 release v 6.1.2
1249
1250
1251 15.09.2020
1252 ==========
1253 hcxdumptool: added new option
1254 --stop_client_m2_attacks=<digit> : stop attacks against CLIENTS after 10 M2 frames received
1255 affected: ap-less (EAPOL 2/4 - M2) attack
1256 require hcxpcangtool --all option
1257
1258
1259 24.08.2020
1260 ==========
1261 hcxdumptool: added new option
1262 --eapreq=<type><data>[:<term>],... : send max. 20 subsequent EAP requests after initial EAP ID request, hex string starting with EAP Type
1263 response is terminated with :F = EAP Failure, :S = EAP Success, :I = EAP ERP Initiate, :F = EAP ERP Finish,
1264 :D = Deauthentication, :- = no packet
1265 default behavior is terminating all responses with a Failure packet, after last one the client is deauthenticated
1266
1267
1268 14.08.2020
1269 ==========
1270 hcxdumptool: added new option --wpaent to announce WPA ENTERPRISE
1271
1272
1273 06.08.2020
1274 ==========
1275 release v 6.1.1
1276 fixed handling of long opts
1277
1278
1279 30.07.2020
1280 ==========
1281 hcxdumptool: added new option --ip to allow to set IP for server / client mode
1282
1283
1284 29.07.2020
1285 ==========
1286 hcxdumptool: add new radiotap flag: IEEE80211_RADIOTAP_F_TX_NOSEQNO
1287 https://patchwork.kernel.org/patch/11680527/
1288
1289
1290 29.07.2020
1291 ==========
1292 release v 6.1.0
1293
1294
1295 19.07.2020
1296 ==========
1297 hcxdumptool: new option
1298 --beaconparams=<TLVs> : update or add Information Elements in all transmitted beacons
1299 maximum 50 IEs as TLV hex string, tag id 0 (ESSID) will be ignored, tag id 3 (channel) overwritten
1300 multiple IEs with same tag id are added, default IE is overwritten by the first
1301
1302
1303 06.07.2020
1304 ==========
1305 hcxdumptool: allow to set channel (-c) on --check_injection
1306 fixed display channel if tags.channel is empty
1307 added new option -s to set predefined scanlists
1308 -s <digit> : set predefined scanlist
1309 0 = 1,6,11,3,5,1,6,11,2,4,1,6,11,7,9,1,6,11,8,10,1,6,11,12,13 (default)
1310 1 = 1,2,3,4,5,6,7,8,9,10,11,12,13
1311 2 = 36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165
1312 3 = 1,2,3,4,5,6,7,8,9,10,11,12,13,36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165
1313
1314
1315 15.06.2020
1316 ==========
1317 release v 6.0.7
1318
1319
1320 10.06.2020
1321 ==========
1322 hcxdumptool: changed behavior of --essidlist and --active_beacon
1323 according to https://github.com/ZerBea/hcxdumptool/issues/115
1324 --essidlist - transmit beacons from this list only
1325 --active_beacon - transmit beacons from collected ESSIDs and from essidlist
1326
1327
1328 21.05.2020
1329 ==========
1330 release v 6.0.6
1331
1332
1333 18.05.2020
1334 ==========
1335 hcxdumptool: added new option --do_targetscan
1336 --do_targetscan=<MAC_AP> : same as do_rcascan - hide all networks, except target
1337
1338
1339 17.05.2020
1340 ==========
1341 hcxdumptool: fixed issue that caused hcxdumptool to respond on probereuest even if --silent is selected
1342 allow MAC format 11:22:33:44:55:66 and 11-22-33-44-55-66 in filterlists
1343
1344
1345 01.05.2020
1346 ==========
1347 hcxdumptool: added option mask to save vendor defined action frames
1348 -f <frames> : frames to save
1349 bitmask:
1350 0: clear default values
1351 1: MANAGEMENT frames (default)
1352 2: EAP and EAPOL frames (default)
1353 4: IPV4 frames
1354 8: IPV6 frames
1355 16: WEP encrypted frames
1356 32: WPA encrypted frames
1357 64: vendor defined frames (AWDL)
1358
1359
1360 05.04.2020
1361 ==========
1362 release v 6.0.5
1363 Security fix: We do not want to disturb uninvolved users!
1364 Increase error count and terminate hcxdumptool if channel was changed by a third party tool.
1365 After transmitting a request, hcxdumptool expect an answer on the same channel.
1366 If the channel was changed by a third party tool, hcxdumptool will never get this answer and transmit again, again and again. This will jam all channels, set by the third party tool.
1367 https://forum.hashkiller.io/index.php?threads/ap-less-attack-with-hcxtools.21036/page-4#post-237403
1368 04.04.2020
1369 ==========
1370 release v 6.0.4
1371
1372
1373 27.03.2020
1374 ==========
1375 hcxdumptool: ERROR_MAX not longer hard coded
1376 --error_max=<digit> : terminate hcxdumptool if error maximum reached
1377 default: 100 errors
1378
1379
1380 26.03.2020
1381 ==========
1382 Some drivers / firmwares provide only limited monitor functions instead of full packet injection capabilities.
1383 hcxdumptool: added packet injection test
1384 --check_injection : run packet injection test to determine that driver support full packet injection\n"
1385
1386
1387 18.03.2020
1388 ==========
1389 release v 6.0.3
1390 removed debug message "OS not supported" from Makefile
1391
1392
1393 14.03.2020
1394 ==========
1395 release v 6.0.2
1396 complete rewrite from scratch
1397 the Raspberry Pi is a little bit too slow, so we have to reduce status output. Most CLIENTs running randomized MACs. They are no longer displayed.
1398 improved IE tag walk similar to hcxpcapngtool
1399 improved attack vector
1400 added new options to improve attack vector against hardened targets
1401 added more information to help menu
1402 added option to import Berkeley packet Filter code from tcpdump as alternative to apfilterlist and clientfilterlist
1403 make less noise on the the channel (receive more, transmit less)
1404 WLAN REASON CODE (deauthentication) no longer hardcoded
1405 moved to git versioning on non releases
1406
1407 $ hcxdumptool -h
1408 hcxdumptool 6.0.2 (C) 2020 ZeroBeat
1409 usage : hcxdumptool <options>
1410 press the switch to terminate hcxdumptool
1411 hardware modification is necessary, read more:
1412 https://github.com/ZerBea/hcxdumptool/tree/master/docs
1413 example: hcxdumptool -o output.pcapng -i wlp39s0f3u4u5 -t 5 --enable_status=3
1414 do not run hcxdumptool on logical (NETLINK) interfaces (monx, wlanxmon)
1415 do not use hcxdumptool in combination with other 3rd party tools, which take access to the interface
1416
1417 short options:
1418 -i <interface> : interface (monitor mode will be enabled by hcxdumptool)
1419 can also be done manually:
1420 ip link set <interface> down
1421 iw dev <interface> set type monitor
1422 ip link set <interface> up
1423 WARNING: iw use NETLINK (libnl) and hcxdumptool will not work on pure NETLINK interfaces
1424 -o <dump file> : output file in pcapng format
1425 including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
1426 -f <frames> : frames to save
1427 bitmask:
1428 0: clear default values
1429 1: MANAGEMENT frames (default)
1430 2: EAP and EAPOL frames (default)
1431 4: IPV4 frames
1432 8: IPV6 frames
1433 16: WEP encrypted frames
1434 32: WPA encrypted frames
1435 to clear default values use -f 0 first, followed by desired frame type (e.g. -f 0 -f 4)
1436 -c <digit> : set scan list (1,2,3, ...)
1437 default scan list: 1...13
1438 maximum entries: 127
1439 allowed channels (depends on the device):
1440 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14
1441 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 58, 60, 62, 64, 68, 96
1442 100, 102, 104, 106, 108, 110, 112, 114, 116, 118, 120, 122, 124, 126, 128
1443 132, 134, 136, 138, 140, 142, 144, 149, 151, 153, 155, 157, 159
1444 161, 165, 169, 173
1445 -t <seconds> : stay time on channel before hopping to the next channel
1446 default 4 seconds
1447 -m <interface> : set monitor mode by ioctl() system call and quit
1448 -I : show WLAN interfaces and quit
1449 -C : show available channels and quit
1450 if no channels are available, interface is probably in use or doesn't support monitor mode
1451
1452 long options:
1453 --do_rcascan : show radio channel assignment (scan for target access points)
1454 this can be used to test that ioctl() calls and packet injection is working
1455 if you got no HIT, packet injection is possible not working
1456 also it can be used to get information about the target
1457 and to determine that the target is in range
1458 use this mode to collect data for the filter list
1459 run this mode at least for 2 minutes
1460 to save all received raw packets use option -o
1461 --reason_code=<digit> : deauthentication reason code
1462 recommended codes:
1463 1 WLAN_REASON_UNSPECIFIED
1464 2 WLAN_REASON_PREV_AUTH_NOT_VALID
1465 4 WLAN_REASON_DISASSOC_DUE_TO_INACTIVITY
1466 5 WLAN_REASON_DISASSOC_AP_BUSY
1467 6 WLAN_REASON_CLASS2_FRAME_FROM_NONAUTH_STA
1468 7 WLAN_REASON_CLASS3_FRAME_FROM_NONASSOC_STA (default)
1469 9 WLAN_REASON_STA_REQ_ASSOC_WITHOUT_AUTH
1470 --disable_client_attacks : do not attack clients
1471 affected: ap-less (EAPOL 2/4 - M2) attack
1472 --disable_ap_attacks : do not attack access points
1473 affected: connected clients and client-less (PMKID) attack
1474 --stop_ap_attacks=<digit> : stop attacks against ACCESS POINTs if <n> BEACONs received
1475 default: stop after 600 BEACONs
1476 --resume_ap_attacks=<digit> : resume attacks against ACCESS POINTs after <n> BEACONs received
1477 default: 864000 BEACONs
1478 --disable_deauthentication : do not send deauthentication or disassociation frames
1479 affected: connected clients
1480 --silent : do not transmit!
1481 hcxdumptool is acting like a passive dumper
1482 expect possible packet loss
1483 --eapoltimeout=<digit> : set EAPOL TIMEOUT (microseconds)
1484 default: 20000 usec
1485 --bpfc=<file> : input Berkeley Packet Filter (BPF) code
1486 steps to create a BPF (it only has to be done once):
1487 set hcxdumptool monitormode
1488 $ hcxumptool -m <interface>
1489 create BPF to protect a MAC
1490 $ tcpdump -i <interface> not wlan addr1 11:22:33:44:55:66 and not wlan addr2 11:22:33:44:55:66 -ddd > protect.bpf
1491 recommended to protect own devices
1492 or create BPF to attack a MAC
1493 $ tcpdump -i <interface> wlan addr1 11:22:33:44:55:66 or wlan addr2 11:22:33:44:55:66 -ddd > attack.bpf
1494 not recommended, because important pre-authentication frames will be lost due to MAC randomization of the CLIENTs
1495 use the BPF code
1496 $ hcxumptool -i <interface> --bpfc=attack.bpf ...
1497 see man pcap-filter for a list of all filter options
1498 --filterlist_ap=<file> : ACCESS POINT MAC filter list
1499 format: 112233445566 + comment
1500 maximum entries 256
1501 run first --do_rcascan to retrieve information about the target
1502 --filterlist_client=<file> : CLIENT MAC filter list
1503 format: 112233445566 # comment
1504 maximum entries 256
1505 due to MAC randomization of the CLIENT, it does not always work!
1506 --filtermode=<digit> : mode for filter list
1507 mandatory in combination with --filterlist_ap and/or --filterlist_client
1508 0: ignore filter list (default)
1509 1: use filter list as protection list
1510 do not interact with ACCESS POINTs and CLIENTs from this list
1511 2: use filter list as target list
1512 only interact with ACCESS POINTs and CLIENTs from this list
1513 not recommended, because important pre-authentication frames will be lost due to MAC randomization of the CLIENTs
1514 --weakcandidate=<password> : use this pre shared key (8...63 characters) for weak candidate alert
1515 will be saved to pcapng to inform hcxpcaptool
1516 default:
1517 --mac_ap : use this MAC as ACCESS POINT MAC instead of a randomized one
1518 format: 112233445566
1519 --mac_client : use this MAC as CLIENT MAC instead of a randomized one
1520 format: 112233445566
1521 --essidlist=<file> : transmit beacons from this ESSID list
1522 maximum entries: 256 ESSIDs
1523 --active_beacon : transmit beacon once every 200000 usec
1524 affected: ap-less
1525 --flood_beacon : transmit beacon on every received beacon
1526 affected: ap-less
1527 --infinity : prevent that a CLIENT can establish a connection to an assigned ACCESS POINT
1528 affected: ACCESS POINTs and CLIENTs
1529 --use_gps_device=<device> : use GPS device
1530 /dev/ttyACM0, /dev/ttyUSB0, ...
1531 NMEA 0183 $GPGGA $GPGGA
1532 --use_gpsd : use GPSD device
1533 NMEA 0183 $GPGGA, $GPRMC
1534 --nmea=<file> : save track to file
1535 format: NMEA 0183 $GPGGA, $GPRMC, $GPWPL
1536 to convert it to gpx, use GPSBabel:
1537 gpsbabel -i nmea -f hcxdumptool.nmea -o gpx -F file.gpx
1538 to display the track, open file.gpx with viking
1539 --gpio_button=<digit> : Raspberry Pi GPIO pin number of button (2...27)
1540 default = GPIO not in use
1541 --gpio_statusled=<digit> : Raspberry Pi GPIO number of status LED (2...27)
1542 default = GPIO not in use
1543 --tot=<digit> : enable timeout timer in minutes (minimum = 2 minutes)
1544 : hcxdumptool will terminate if tot reached (EXIT code = 2)
1545 --reboot : once hcxdumptool terminated, reboot system
1546 --poweroff : once hcxdumptool terminated, power off system
1547 --enable_status=<digit> : enable real-time display (waterfall)
1548 only incoming traffic
1549 only once at the first occurrence due to MAC randomization of CLIENTs
1550 bitmask:
1551 0: no status (default)
1552 1: EAP and EAPOL
1553 2: ASSOCIATION and REASSOCIATION
1554 4: AUTHENTICATION
1555 8: BEACON and PROBERESPONSE
1556 16: ROGUE AP
1557 32: GPS (once a minute)
1558 64: internal status (once a minute)
1559 128: run as server
1560 256: run as client
1561 characters < 0x20 && > 0x7e are replaced by .
1562 example: show everything but don't run as server or client (1+2+4+8+16 = 31)
1563 show only EAP and EAPOL and ASSOCIATION and REASSOCIATION (1+2 = 3)
1564 --server_port=<digit> : define port for server status output (1...65535)
1565 : default IP: 224.0.0.255
1566 : default port: 60123
1567 --client_port=<digit> : define port for client status read (1...65535)
1568 : default IP: 224.0.0.255
1569 : default port: 60123
1570 --check_driver : run several tests to determine that driver support all(!) required ioctl() system calls
1571 --help : show this help
1572 --version : show version
1573
1574 Run hcxdumptool -i interface --do_rcascan for at least 30 seconds, before you start an attack!
1575 Do not edit, merge or convert this pcapng files, because it will remove optional comment fields!
1576 It is much better to run gzip to compress the files. Wireshark, tshark and hcxpcapngtool will understand this.
1577 If hcxdumptool captured your password from WiFi traffic, you should check all your devices immediately!
1578 If you use GPS, make sure GPS device is inserted and has a GPS FIX, before you start hcxdumptool!
1579
1580
1581 06.03.2020
1582 ==========
1583 complete rewrite from scratch
1584 the Raspberry Pi is a little bit too slow, so we have to reduce status output. Most CLIENTs running randomized MACs. They are no longer displayed.
1585 improved IE tag walk similar to hcxpcapngtool
1586 improved attack vector
1587 added new options to improve attack vector against hardened targets
1588 added more information to help menu
1589 added option to import Berkeley packet Filter code from tcpdump as alternative to apfilterlist and clientfilterlist
1590 make less noise on the the channel (receive more, transmit less)
1591 WLAN REASON CODE (deauthentication) no longer hardcoded
1592 moved to git versioning on non releases
1593
1594
1595 29.01.2020
1596 ==========
1597 moved to v6.0.1
1598 removed options to set userdefined MAC_AP and/or MAC_CLIENT, because they make hcxdumptool's stealth capability ineffective
1599 improved handling of association/reassociation frames
1600 improved handling of null/powersave frames
1601 added counter for PMKID/EAPOL frames
1602 handle EAP request/response frames
1603 improved IE tag walk similar to hcxpcapngtool
1604 fixed cipher suite and AKM suite handling
1605 handle wrong FCS
1606 reduce pcapng size
1607 fixed internal counters
1608 allow mixed attack vector PSK/PSK256
1609 handle PMKID in reassociationrequest
1610
1611
1612 11.12.2019
1613 ==========
1614 moved to v6.0.0
1615 hcxdumptool: complete rewrite from scratch
1616 filterlist split (APs, CLIENTs), entries increased upt to 256 each list:
1617 --filterlist_ap
1618 --filterlist_client
1619 improved real time display:
1620 driver information and firmware information (if available)
1621 detailed information about PMKID and MESSAGE PAIR)
1622 allow more than one option (--enable_status)
1623 0: no status (default)
1624 1: EAPOL
1625 2: PROBE REQUEST/PROBE RESPONSE
1626 4: AUTHENTICATION
1627 8: ASSOCIATION/REASSOCIATION
1628 16: BEACON
1629 32: GPS (once a minute)
1630 64: internal status
1631 128: send status to client
1632 choose pcapng frames to save (-f) using option -o
1633 improved rca_scan:
1634 0: no real time display
1635 1: show only access points in range (default)
1636 2: show only access points not range
1637 3: show all access points
1638 improved GPS handling:
1639 read GPS information directly from device
1640 --use_gps_device=<device>
1641 or us GPSD
1642 --use_gpsd
1643 use full standard NMEA raw sentence $GPGGA, $GPRMC, $GPGWL
1644 this version need hcxpcaptool v6.0.0 to convert GPS information or gpsbabel
1645 gpsbabel -i nmea -f nmea.txt -o gpx -F test.gpx
1646 then open test.gpx with viking (layer -> waypoint -> BSSID)
1647 ignore M4 if SNONCE is zeroed
1648 ignore PMKID if zeroed
1649 improved handling of radiatapheader on ath9k_htc driver
1650 new option codes:
1651 ENTERPRISE NUMBER 0x2a, 0xce, 0x46, 0xa1
1652 MAGIC NUMBER 0x2a, 0xce, 0x46, 0xa1, 0x79, 0xa0, 0x72, 0x33,
1653 0x83, 0x37, 0x27, 0xab, 0x59, 0x33, 0xb3, 0x62,
1654 0x45, 0x37, 0x11, 0x47, 0xa7, 0xcf, 0x32, 0x7f,
1655 0x8d, 0x69, 0x80, 0xc0, 0x89, 0x5e, 0x5e, 0x98
1656 OPTIONCODE_MACMYORIG 0xf29a (6 byte)
1657 OPTIONCODE_MACMYAP 0xf29b (6 byte)
1658 OPTIONCODE_RC 0xf29c (8 byte)
1659 OPTIONCODE_ANONCE 0xf29d (32 byte)
1660 OPTIONCODE_MACMYSTA 0xf29e (6 byte)
1661 OPTIONCODE_SNONCE 0xf29f (32 byte)
1662 OPTIONCODE_WEAKCANDIDATE 0xf2a0 (32 byte)
1663 OPTIONCODE_GPS 0xf2a1 (max 128 byte)
1664 removed weak candidate check, because it leads to many, many unauthorized MP:M1M2
1665
1666 hcxpioff: new options --tot, --poweroff, --reboot
1667 --tot=<digit> : enable timeout timer in minutes (minimum = 2 minutes)
1668 : hcxpioff will terminate if tot reached
1669 --reboot : once hcxpioff terminated, reboot system
1670
1671
1672 20.09.2019
1673 ==========
1674 hcxdumptool: added pcapng custom block
1675 we store all custom information inside this block
1676
1677 list of used pcapng option codes:
1678 #define OPTIONCODE_MACMYORIG 0xf29a
1679 #define OPTIONCODE_MACMYAP 0xf29b
1680 #define OPTIONCODE_RC 0xf29c
1681 #define OPTIONCODE_ANONCE 0xf29d
1682 #define OPTIONCODE_MACMYSTA 0xf29e
1683 #define OPTIONCODE_SNONCE 0xf29f
1684 #define OPTIONCODE_WEAKCANDIDATE 0xf2a0
1685
1686
1687 18.09.2019
1688 ==========
1689 hcxdumptool: added new option --weak_candidate
1690 added weak candidate detection on PMKID and WPA1
1691 weak candidate is no longer "hard coded"
1692 ---weak_candidate=<password> : use this password (8...63 characters) for weak candidate alert
1693 default: 00000000
1694 affected: client-less attack
1695
1696 list of used pcapng option codes:
1697 #define OPTIONCODE_MACMYAP 62107
1698 #define OPTIONCODE_RC 62108
1699 #define OPTIONCODE_ANONCE 62109
1700 #define OPTIONCODE_MACMYSTA 62110
1701 #define OPTIONCODE_SNONCE 62111
1702 #define OPTIONCODE_WEAKCANDIDATE 62112
1703
1704
1705 17.09.2019
1706 ==========
1707 hcxdumptool: added weak password check
1708 high experimental, only on WPA2 QOS
1709 new dependency: lib crypto (openssl)
1710
1711
1712 07.09.2019
1713 ==========
1714 hcxdumptool: added new options
1715
1716 --reactive_beacon : send internal/external beacon on every received proberequest
1717 affected: ap-less
1718 --flood_beacon=<digit> : transmit internal/external beacon after every <x> received management packet
1719 affected: ap-less
1720
1721
1722 05.09.2019
1723 ==========
1724 hcxdumptool: added new options (feature request: https://github.com/ZerBea/hcxdumptool/issues/70)
1725
1726 --disable_internal_beacons : do not transmit beacons using received ESSIDs
1727 default: transmit this kind of beacon once on channel change or every five seconds
1728 affected: ap-less and reactive_beacon, flood_beacon
1729 --use_external_beaconlist=<file> : transmit beacons from this list
1730 maximum ESSID length 32, maximum entries 4095
1731 default: transmit this kind of beacon once on channel change or every five seconds
1732 affected: ap-less and reactive_beacon, flood_beacon
1733
1734
1735 28.08.2019
1736 ==========
1737 moved to v5.2.2
1738
1739
1740 02.09.2019
1741 ==========
1742 hcxdumptool : added bind() ll.sll_pkttype = PACKET_OTHERHOST | PACKET_OUTGOING
1743 added setsockopt() r.mr_type = PACKET_MR_PROMISC
1744
1745 now dmesg will show when device entered promiscuous mode
1746 during hcxdumptool initialization:
1747 [ 6313.657830] device wlp3s0f0u11u1 entered promiscuous mode
1748
1749 and when it left promiscuous mode when hcxdumptool terminated:
1750 [ 6313.735833] device wlp3s0f0u11u1 left promiscuous mode
1751
1752
1753 01.09.2019
1754 ==========
1755 hcxdumptool : print additional information about interfering services
1756 first_steps.txt : added quickstart guide to docs
1757
1758
1759 28.08.2019
1760 ==========
1761 moved to v5.2.1
1762
1763
1764 25.08.2019
1765 ==========
1766 hcxdumptool: removed option --ignore_warning (no longer needed)
1767 hcxdumptool forces to set monitor mode running ioctl(SIOCGIWMODE) IW_MODE_MONITOR
1768 if that doesn't work on first try, try it again and/or
1769 do monitor mode manually:
1770 ip link set <interface> down
1771 iw dev <interface> set type monitor
1772 ip link set <interface> up
1773
1774 warning: on some drivers rtlXXXX netlink will not notice that we use forced ioctl() system calls
1775 in that case iw dev wlp3s0f0u11u4 will show you that the "netlink part" is still managed
1776 Interface wlp3s0f0u11u4
1777 ifindex 11
1778 wdev 0x800000001
1779 addr 70:f1:1c:27:ae:ec
1780 type managed
1781 wiphy 8
1782 txpower 13.00 dBm
1783
1784
1785 19.08.2019
1786 ==========
1787 moved to v5.2.0
1788
1789
1790 18.08.2019
1791 ==========
1792 hcxdumptool: print ESSID on status 1
1793
1794
1795 15.08.2019
1796 ==========
1797 hcxdumptool: added server - client status output (only local networkes)
1798 --server_port=<digit> : define port for server status output (1...65535)
1799 : default IP: 224.0.0.255
1800 --client_port=<digit> : define port for client status read (1...65535)
1801 : default IP: 224.0.0.255
1802
1803 example:
1804 on client machine run hcxdumptool with option --client_port=12345
1805 $ hcxdumptool -i <interface> -o test.pcapng --enable_status=1 --client_port=12345
1806
1807 on capture machine run hcxdumptool with option --server_port=12345
1808 $ hcxdumptool -i <interface> -o test.pcapng --enable_status=1 --server_port=12345
1809
1810
1811 13.08.2019
1812 ==========
1813 hcxdumptool: added new option --check_driver
1814 --check_driver : run several tests to determine that driver support all(!) required system calls
1815
1816 If everything is fine, result should look like this:
1817 $ sudo hcxdumptool -i wlp3s0f0u10u4 --check_driver
1818 driver tests passed - all required ioctl() system calls are supported by driver
1819
1820 If not, hcxdumptool will show which test failed:
1821 $ sudo hcxdumptool -i wlp3s0f0u10u5 --check_driver
1822 ioctl(SIOCGIFFLAGS) failed: No such device
1823 ioctl(SIOCGIWMODE) failed: No such device
1824 ioctl(SIOCSIFFLAGS) failed: No such device
1825 ioctl(SIOCSIWMODE) - IW_MODE_MONITOR failed: No such device
1826 ioctl(SIOCGIWMODE) failed: No such device
1827 ioctl(SIOCGIWMODE) - IW_MODE_MONITOR failed
1828 ioctl(SIOCSIFFLAGS) -IFF_UP failed: No such device
1829 ioctl(SIOCGIFFLAGS) failed: No such device
1830 ioctl(SIOCGIFFLAGS) - IFF_UP | IFF_RUNNING | IFF_BROADCAST failed
1831 ioctl(SIOCGIFINDEX) failed: No such device
1832 ioctl(SIOCETHTOOL) - ETHTOOL_GPERMADDR failed: No such device
1833 ioctl(SIOCSIWFREQ) - IW_FREQ_FIXED failed: No such device
1834 it looks like this interface/driver isn't suitable for hcxdumptool
1835 possible reasons:
1836 wrong interface selected
1837 interface is blocked by another tool
1838 driver doesn't support required ioctl() system calls
1839
1840
1841 12.08.2019
1842 ==========
1843 hcxdumptool: a crappy filter list is not longer a reason to terminate initialization
1844
1845
1846 11.08.2019
1847 ==========
1848 hcxdumptool: added new options --tot and --reboot
1849 --tot=<digit> : enable timeout timer in minutes (minimum = 2 minutes)
1850 : hcxdumptool will terminate if tot reached (EXIT code = 2)
1851 --reboot : once hcxdumptool terminated, reboot system
1852
1853 hcxdumptool return values:
1854 0 = every thing is fine
1855 1 = error occurred
1856 2 = tot reached
1857
1858
1859 23.07.2019
1860 ==========
1861 hcxdumptool: moved from usleep() to nanosleep()
1862 hcxpioff: moved from usleep() to nanosleep()
1863
1864
1865 17.07.2019
1866 ==========
1867 added some additional information which ioctl() command isn't supported by driver
1868 added warning on option --do_rcascan if packet injection fails (driver doesn't support
1869 full packet injection) after 20 seconds
1870
1871 Remarks:
1872 nl80211/cfg80211/mac80211 doesn't use use ioctl() calls, they use netlink.
1873 hcxdumptool use ioctl() calls and will not work on netlink.
1874 That is the case, if ioctl(SIOCGIWMODE) or ioctl(SIOCSIWMODE) calls failed!
1875
1876 Read more here:
1877 https://www.quora.com/What-are-the-differences-between-netlink-sockets-and-ioctl-calls
1878
1879
1880 30.06.2019
1881 ==========
1882 increased maximum filter list entries from 64 up to 255
1883 this will have a price tag, because hcxdumptool's respond time increases.
1884
1885
1886 25.06.2019
1887 ==========
1888 detect Raspberry Pi 4
1889
1890
1891 23.06.2019
1892 ==========
1893 moved to v 5.1.7
1894 hcxdumptool: improved help
1895 fixed pcpng option header
1896
1897
1898 12.06.2019
1899 ==========
1900 hcxdumptool: ignore more warnings if --ignore_warning is selected
1901 do not report issues if you run this option!!!
1902
1903
1904 29.05.2019
1905 ==========
1906 hcxdumptool moved to v 5.1.5
1907
1908
1909 19.05.2019
1910 ==========
1911 hcxdumptool: activated option --ignore warning
1912 --ignore_warning : ignore warnings
1913 try this if you get some driver warnings
1914 do not report issues
1915
1916
1917 16.04.2019
1918 ==========
1919 updated wiki device and README.md.
1920 This adapters are working fine, running kernel 4.19, 4.20 and 5.0:
1921 EDIMAX EW-7711UAN ID 7392:7710 Edimax Technology Co., Ltd
1922 ALLNET ALL-WA0150N ID 148f:7601 Ralink Technology, Corp. MT7601U Wireless Adapter
1923 TENDA W311U+ ID 148f:3070 Ralink Technology, Corp. RT2870/RT3070 Wireless Adapter
1924 LogiLink WL0151 ID 148f:5370 Ralink Technology, Corp. RT5370 Wireless Adapter
1925 regardless of the xhci issue.
1926
1927
1928 14.04.2019
1929 ==========
1930 removed all device names from README.md, because VENDORS often change chipsets or driver errors occur:
1931 v1 of a device is working fine, while v2 doesn't work
1932 device A, running driver A is working fine, while device B running driver A doesn't work
1933 driver doesn't support monitor mode
1934 driver support monitor mode, but doesn't support packet injection
1935 Examples here:
1936 https://bugzilla.kernel.org/show_bug.cgi?id=202241
1937 https://bugzilla.kernel.org/show_bug.cgi?id=202243
1938 https://bugzilla.kernel.org/show_bug.cgi?id=202541
1939
1940 To find a working device, I recommend to read wikidevi:
1941 https://wikidevi.com/
1942
1943
1944 02.04.2019
1945 ==========
1946 hcxdumptool now use this radiotap header:
1947
1948 static const uint8_t hdradiotap[] =
1949 {
1950 0x00, 0x00, // radiotap version + pad byte
1951 0x0e, 0x00, // radiotap header length
1952 0x06, 0x8c, 0x00, 0x00, // bitmap
1953 0x00, // flags
1954 0x02, // rate
1955 0x14, // tx power
1956 0x01, // antenna
1957 0x08, 0x00 // tx flags
1958 #define HDRRT_SIZE sizeof(hdradiotap)
1959 };
1960
1961 read more about radiotap header here:
1962 https://www.kernel.org/doc/Documentation/networking/mac80211-injection.txt
1963
1964
1965 header is working with:
1966 ID 148f:761a Ralink Technology, Corp. MT7610U ("Archer T2U" 2.4G+5G WLAN Adapter
1967
1968 removed "USB ID 7392:a812 Edimax Technology Co., Ltd" from "known as working device list"
1969 because this driver is not working with the radiotap header.
1970
1971
1972 30.03.2019
1973 ==========
1974 hcxdumptool: added new option --silent
1975 --silent : do not transmit!
1976 hcxdumptool is acting like a passive dumper
1977
1978 added RTL8187. Removed the wrong devices from the list (only RT3070 ia affected)
1979 * USB ID 0bda:8187 Realtek Semiconductor Corp. RTL8187 Wireless Adapter (ALFA AWUS036H)
1980 * USB ID 0bda:8189 Realtek Semiconductor Corp. RTL8187B Wireless 802.11g 54Mbps Network Adapter
1981
1982
1983 29.03.2019
1984 ==========
1985 added cflag DEBUG
1986 if compiled with DEBUG, hcxdumptool show raw packets and raw GSP data, directly received from the device
1987
1988 removed ALFA AWUS036NH from the "known as workinging list", because the device doesn't work
1989 any longer, running kernel 5.0.
1990
1991
1992 28.03.2019
1993 ==========
1994 removed devices from "known working" list:
1995 * USB ID 0bda:8187 Realtek Semiconductor Corp. RTL8187 Wireless Adapter (ALFA AWUS036H)
1996 * USB ID 0bda:8189 Realtek Semiconductor Corp. RTL8187B Wireless 802.11g 54Mbps Network Adapter
1997 because they are not working running kernel 5.0
1998
1999
2000 27.03.2019
2001 ==========
2002 removed wiringPi dependency
2003 now we are running "bare metal" - complete GPIO stuff moved to hcxdumptool and hcxpioff
2004 do not use wiringPi in combination with hcxdumptool and/or hcxpioff
2005 Makefile: removed DOGPIOSUPPORT
2006 hcxdumptool: changed options wiringPi options to GPIO options
2007 --gpio_button=<digit> : Raspberry Pi GPIO pin number of button (2...27)
2008 default = GPIO not in use
2009 --gpio_statusled=<digit> : Raspberry Pi GPIO number of status LED (2...27)
2010 default = GPIO not in use
2011
2012 hcxpioff: changed options wiringPi options to GPIO options
2013 --gpio_button=<digit> : Raspberry Pi GPIO pin number of button (2...27)
2014 default = GPIO not in use
2015 --gpio_statusled=<digit> : Raspberry Pi GPIO number of status LED (2...27)
2016 default = GPIO not in use
2017
2018 The GPIO is disabled on default. If you like to activate GPIO support you must do
2019 the hardware modifications as described here: doc/gpiowait.odg
2020 and set the options according to your modification.
2021 You can choose every GPIO pin, as long as you use a pull down resistor to ground.
2022 Raspberry model should be detected by automatic and according to the revision we use:
2023 GPIO mem 0x20000000 for A, B, A+, B+, and Zero, Zero W(H)
2024 GPIO mem 0x3F000000 for 2B, 3B, 3A+, 3B+
2025 compute modules (CMx) are not supported.
2026
2027
2028 20.03.2019
2029 ==========
2030 hcxdumptool: GPIO pins are no longer hard coded!
2031 --wpi_button=<digit> : wiringPi number of of button (0...31, Raspberry Pi A and B: 0 .. 16)
2032 default = 7
2033 --wpi_statusled=<digit> : wiringPi number of status LED (0...31, Raspberry Pi A and B: 0 .. 16)
2034 default = 0
2035
2036
2037 19.03.2019
2038 ==========
2039 hcxpioff: refactored - GPIO pins are no longer hard coded!
2040 --wpi_button=<digit> : wiringPi number of of button (0...31, Raspberry Pi A and B: 0 .. 16)
2041 default = 7
2042 --wpi_statusled=<digit> : wiringPi number of status LED (0...31, Raspberry Pi A and B: 0 .. 16)
2043 default = 0
2044 --help : show this help
2045 --version : show version
2046
2047
2048 16.03.2019
2049 ==========
2050 added man page hcxdumptool.1
2051 removed device from list:
2052 USB ID 7392:a812 Edimax Technology Co., Ltd (Edimax AC600 USB / Manufacturer: Realtek)
2053 because the driver from here: https://github.com/aircrack-ng/rtl8812au
2054 is no longer working on kernel 5.0
2055
2056
2057 09.03.2019
2058 ==========
2059 hcxdumptool moved to v 5.1.4
2060
2061 hcxdumptool: added new option:
2062 --ignore_warning : hcxdumptool will not terminate if other services take access on the device
2063 : warning: expect problems if hcxdumptool tries to change channels
2064
2065 From now on, hcxdumptool will not terminate during the initialization
2066 if another service take access on the interface.
2067 Expect problems and do not report issues related to this option!!!!
2068
2069 From now on, hcxdumptool will also show channel and frequency (when running option -C)
2070 1 / 2412MHz (20 dBm)
2071 2 / 2417MHz (20 dBm)
2072 3 / 2422MHz (20 dBm)
2073 4 / 2427MHz (20 dBm)
2074 5 / 2432MHz (20 dBm)
2075 6 / 2437MHz (20 dBm)
2076 7 / 2442MHz (20 dBm)
2077 8 / 2447MHz (20 dBm)
2078 9 / 2452MHz (20 dBm)
2079 10 / 2457MHz (20 dBm)
2080 11 / 2462MHz (20 dBm)
2081 12 / 2467MHz (20 dBm)
2082 13 / 2472MHz (20 dBm)
2083
2084
2085 09.03.2019
2086 ==========
2087 hcxdumptool: added improved warning message
2088 Now hcxdumptool print the error message received from the driver inside the brackets
2089 $ hcxdumptool -i wlp3s0f0u1 -c 14
2090 initialization...
2091 warning: unable to set channel 14 (Invalid argument) - removed this channel from scan list
2092
2093 In this case the user tried to set channel 14. The driver doesn't support this
2094 and responds with Invalid argument
2095
2096
2097 07.03.2019
2098 ==========
2099 hcxdumptool: added debug code in main packet loop [processpackets()]
2100 to print raw GPS data, received from GPSD:
2101 /*
2102 printf("\ndebug: %s\n", gpsddata);
2103 */
2104 uncomment this before you run make to retrieve this values.
2105
2106
2107 06.03.2019
2108 ==========
2109 hcxdumptool: added GPS date and GPS time to status and pcapng comment field.
2110
2111 $ sudo hcxdumptool -i wlp3s0f0u1 --use_gpsd -o test.pcapng
2112 initialization...
2113 connecting to GPSD...
2114 waiting up to 5 seconds to retrieve first position
2115 GPSD activated
2116
2117 start capturing (stop with ctrl+c)
2118 GPS LATITUDE.............: 49.126403
2119 GPS LONGITUDE............: 4.626175
2120 GPS ALTITUDE.............: 129.500000
2121 GPS DATE.................: 06.03.2019
2122 GPS TIME.................: 21:52:41
2123 INTERFACE................: wlp3s0f0u1
2124 ERRORMAX.................: 100 errors
2125 FILTERLIST...............: 0 entries
2126 MAC CLIENT...............: f04f7c89dabb
2127 MAC ACCESS POINT.........: 980ee432604d (incremented on every new client)
2128 EAPOL TIMEOUT............: 150000
2129 REPLAYCOUNT..............: 61455
2130 ANONCE...................: 182972399cd2e65deb7941601cca14b644681c092dcf6f704935c7f3d2eaceea
2131
2132 INFO: cha=11, rx=7080, rx(dropped)=1676, tx=408, powned=10, err=0, lat=49.126342, lon=4.626268, alt=129.500000, gpsdate=06.03.2019, gpstime=22:01:55^C
2133 terminated...
2134
2135 $ tshark -r test.pcapng-0 -Y frame.comment -T fields -E header=y -e frame.number -e frame.time -e wlan.sa -e frame.comment
2136 172 Mar 6, 2019 23:01:48.793212000 CET 1a:f8:7c:91:24:a3 lat:49.126337,lon:4.626268,alt:129.500000,date:06.03.2019,time:22:01:48
2137
2138
2139 05.03.2019
2140 ==========
2141 hcxdumptool: removed general info about tx-power - now we use iw style to show tx-power/channel
2142 hcxdumptool -i <interface> -C
2143 initialization...
2144 available channels:
2145 1 (20 dBm)
2146 2 (20 dBm)
2147 3 (20 dBm)
2148 ...
2149 132 (26 dBm)
2150 136 (26 dBm)
2151 140 (26 dBm)
2152 149 (13 dBm)
2153 153 (13 dBm)
2154 157 (13 dBm)
2155 161 (13 dBm)
2156 165 (13 dBm)
2157
2158
2159 26.02.2019
2160 ==========
2161 hcxdumptool moved to version 5.1.3 due several bug fixes and improved rcascan status output
2162
2163
2164 18.02.2019
2165 ==========
2166 release hcxdumptool v 5.1.2 due to several bugfixes
2167
2168
2169 02.02.2019
2170 ==========
2171 release hcxdumptool v 5.1.1
2172
2173
2174 20.01.2019
2175 ==========
2176 hcxdumptool:
2177 added new MT76 device: "TP-LINK Archer Archer T2U"
2178 working with kernel: 4.19, 4.20 (some issues), 5.0
2179 read more here:
2180 https://github.com/ZerBea/hcxdumptool/issues/42
2181 https://bugzilla.kernel.org/show_bug.cgi?id=202241
2182 https://bugzilla.kernel.org/show_bug.cgi?id=202243
2183
2184
2185 11.01.2019
2186 ==========
2187 hcxdudmptool:
2188 From now on, we assume that a packet is outgoing, if
2189 dBm Antenne Signal is absent.
2190
2191
2192 08.01.2019
2193 ==========
2194 hcxdudmptool and mac80211_hwsim
2195 mac80211_hwsim is a Linux kernel module that can be used to simulate
2196 arbitrary number of IEEE 802.11 radios for mac80211. It can be used to
2197 test hcxdumptool:
2198 load module:
2199 $ sudo modprobe mac80211_hwsim
2200
2201 run hcxdumptool to retrieve information about the interface:
2202 $ hcxdumptool -I
2203 wlan interfaces:
2204 020000000000 wlan0 (mac80211_hwsim)
2205 020000000100 wlan1 (mac80211_hwsim)
2206
2207 bring monitor interface up:
2208 $ sudo sudo ip link set hwsim0 up
2209
2210 run hcxdumptool:
2211 $ sudo hcxdumptool -i wlan0
2212 initialization...
2213
2214 start capturing (stop with ctrl+c)
2215 INTERFACE:...............: wlan0
2216 ERRORMAX.................: 100 errors
2217 FILTERLIST...............: 0 entries
2218 MAC CLIENT...............: c8aacc9c01ec
2219 MAC ACCESS POINT.........: 580943000000 (incremented on every new client)
2220 EAPOL TIMEOUT............: 150000
2221 REPLAYCOUNT..............: 62263
2222 ANONCE...................: 513282ebb604e6e10c450d6c3eaa6428d118b54abeef4672be3ef700052305d5
2223
2224 INFO: cha=11, rx=0, rx(dropped)=0, tx=120, powned=0, err=0
2225
2226 run wireshark on wlan0 or hwsim0 to monitor hcxdumptool output.
2227 do not forget to remove mac80211_hwsim if the module is not longer needed!
2228
2229 read more here:
2230 https://www.kernel.org/doc/readme/Documentation-networking-mac80211_hwsim-README
2231
2232
2233 04.01.2019
2234 ==========
2235 hcxdumptool - changed flash time:
2236 LED flashes every 5 seconds = everything is fine
2237 LED stays on = no signal received during the last past five seconds
2238 hcxdumptool - ignore double outgoing packets (rth->it_present == 0)
2239
2240
2241 03.01.2019
2242 ==========
2243 hcxdumptool: changed flash time (5 times longer on ERROR)
2244 hcxpioff: changed flash time
2245
2246
2247 20.12.2018
2248 ==========
2249 improved detection of broken driver
2250 from now on GPIO LED blinks twice every 5 seconds
2251 - if a possible driver issue is detected
2252 - if no packets received during the last past 5 seconds
2253
2254 another indicator is that the incoming packetcounter (rx=xxxx)
2255 doesn't increase
2256
2257 or dmesg show this error:
2258 [65786.808078] ieee80211 phy2: rt2x00queue_flush_queue: Warning - Queue 14 failed to flush
2259 [65824.174119] ieee80211 phy2: rt2x00queue_flush_queue: Warning - Queue 14 failed to flush
2260 [67801.029527] ------------[ cut here ]------------
2261
2262 it seems to be a kernel issue that hcxdumptool isn't able to handle, automatically:
2263 https://bbs.archlinux.org/viewtopic.php?id=237028
2264 https://bugs.openwrt.org/index.php?do=details&task_id=929&opened=169&status%5B0%5D=
2265 https://community.spiceworks.com/topic/2132263-ubuntu-16-04-wifi-disconnects-randomly
2266 https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1750226
2267 https://www.raspberrypi.org/forums/viewtopic.php?t=206815
2268
2269 workaround:
2270 1) get driver information
2271 $ hcxdumptool -I
2272 wlan interfaces:
2273 7cdd90xxxxxx wlp3s0f0u2 (rt2800usb)
2274
2275 2) remove module
2276 $ modprobe -r rt2800usb
2277
2278 3) load module
2279 $ modprobe rt2800usb
2280
2281
2282 18.12.2018
2283 ==========
2284 added new option to set station MAC address
2285 --station_mac=<mac_addr> : use this MAC address for station
2286 format = 112233445566
2287 format = 112233000000 (to set only OUI)
2288 format = 445566 (to set only NIC)
2289
2290 added new option to set access point MAC address
2291 --ap_mac=<mac_addr> : use this MAC address for access point as start MAC
2292 format = 112233445566
2293 format = 112233000000 (to set only OUI)
2294 format = 445566 (to set only NIC)
2295 warning: do not use a MAC of an existing access point in your range
2296
2297 improved detection of broken driver
2298 set default ERRORMAX to 100
2299 added option to set ERRORMAX
2300 -T <digit> : set maximum ERROR count (hcxdumptool terminates when the value is reached)
2301 default: 100 errors
2302
2303 Remarks:
2304 errorcount will increase by one, if send packet (tx=xxx) > 3*incoming packets (rx=xxx)
2305
2306
2307 15.12.2018
2308 ==========
2309 improved random generator (now seeded with and adapter mac address)
2310 Raspberry Pi: improved handling of GPIO switch
2311
2312
2313 07.12.2018
2314 ==========
2315 restore interface settings after -C
2316 improved help menu
2317 -more information about monitor mode
2318 -more information about packet injection
2319 monitor mode and packet injection must be supported by the driver,
2320 otherwise hcxdumptool will not work.
2321
2322
2323 05.12.2018
2324 ==========
2325 moved to v 5.1.0 (according to hashcat)
2326
2327
2328 04.12.2018
2329 ==========
2330 added new option:
2331 -C : show available channels and quit
2332
2333
2334 27.11.2018
2335 ==========
2336 added new option:
2337 --poweroff : once hcxdumptool finished, power off system
2338
2339
2340 26.11.2018
2341 ==========
2342 several big endian fixes
2343 switched to version 5.0.1
2344
2345
2346 07.10.2018
2347 ==========
2348 added new option filter mode 3:
2349 --filterlist=<file> : mac filter list
2350 format: 112233445566 + comment
2351 maximum line length 255, maximum entries 64
2352 --filtermode=<digit> : mode for filter list
2353 1: use filter list as protection list (default) in transmission branch
2354 receive everything, interact with all APs and CLIENTs in range,
2355 except(!) the ones from the filter list
2356 2: use filter list as target list in transmission branch
2357 receive everything, only interact with APs and CLIENTs in range,
2358 from the filter list
2359 3: use filter list as target list in receiving branch
2360 only receive APs and CLIENTs in range,
2361 from the filter list
2362
2363
2364 30.10.2018
2365 ==========
2366 moved to version 5.0.0
2367
2368
2369 05.10.2018
2370 ==========
2371 added more error messages
2372 fixed small bug in error count on channel change failure
2373
2374
2375 04.10.2018
2376 ==========
2377 show GPS position (if activated) in status line (refresh every 5 seconds)
2378 fixed broken status display on rcascan
2379 increased speed of rcascan
2380 fixed error handling if selected channels not supported by driver
2381 if option -t is not set, skip empty channels after one second
2382 improved scan list
2383 fixed some static var
2384
2385
2386 01.10.2018
2387 ==========
2388 changed order of channels in default scan list:
2389 1, 9, 6, 3, 11, 7, 1, 10, 6, 8, 11, 4, 1, 12, 6, 2, 11, 5, 13
2390
2391
2392 27.09.2018
2393 ==========
2394 added GPSD support (stored as comment in pcapng file)
2395 --use_gpsd : use GPSD to retrieve position
2396 add latitude, longitude and altitude to every pcapng frame
2397 device must be supported by GPSD:
2398 http://www.catb.org/gpsd/hardware.html
2399 (tested using: AktivePilot JENTRO BT-GPS-8)
2400
2401 Retrieve GPS information with:
2402 $ tshark -r filename.pcapng -Y frame.comment -T fields -E header=y -e frame.number -e frame.time -e wlan.sa -e frame.comment
2403
2404
2405 write mac_ap to pcapng SHB
2406 write mac_sta to pcapng SHB
2407 SHB optioncodes:
2408 #define OPTIONCODE_MACMYAP 62107
2409 #define OPTIONCODE_RC 62108
2410 #define OPTIONCODE_ANONCE 62109
2411 #define OPTIONCODE_MACMYSTA 62110
2412
2413
2414 16.09.2018
2415 ==========
2416 show warning if NetworkManager and/or wpa_supplicant is running
2417
2418
2419 15.09.2018
2420 ==========
2421 added Cisco Systems, Inc VENDOR information
2422 --station_vendor=<digit> : use this VENDOR information for station
2423 0: transmit no VENDOR information (default)
2424 1: Broadcom
2425 2: Apple-Broadcom
2426 3: Sonos
2427 4: Netgear-Broadcom
2428 5: Wilibox Deliberant Group LLC
2429 6: Cisco Systems, Inc
2430
2431
2432 11.09.2018
2433 ==========
2434 You can “uncomment a line” in a configuration file
2435 by removing the # at the start of the line.
2436 Or, to “comment out” a line, add a # character
2437 to the start of the line.
2438
2439 001122334455 myap
2440 # aabbccddeeff ignore this mac
2441 112233445566 second ap
2442 # this is may comment
2443
2444
2445 05.09.2018
2446 ==========
2447 added Netgear Broadcom VENDOR information
2448 added Wilibox Deliberant Group LLC VENDOR information
2449
2450
2451 04.09.2018
2452 ==========
2453 improved rcascan (show time and access points which hide their ESSID)
2454 prepare detection of PMF
2455 refactored access point handling
2456 handle 4096 access points simultaneously
2457 refactored client handling
2458 handle 4096 clients simultaneously
2459 speed up retrieving PMKIDs (< 1 minute)
2460 attack access points which hide their ESSID
2461 increased filter list line length
2462 increased filter list maximum entries
2463 added option to show beacons in status output:
2464 --enable_status=<digit> : enable status messages
2465 bitmask:
2466 1: EAPOL
2467 2: PROBEREQUEST/PROBERESPONSE
2468 4: AUTHENTICATION
2469 8: ASSOCIATION
2470 16: BEACON
2471
2472 added option to choose station VENDOR information:
2473 --station_chipset=<digit> : use this VENDOR information for station
2474 0: transmit no VENDOR information (default)
2475 1: Broadcom
2476 2: Apple-Broadcom
2477 3: Sonos
2478
2479
2480 30.08.2018
2481 ==========
2482 iw/ip functionality added!
2483 now hcxdumptool will set monitor mode and bring up interface!
2484 previous interface settings will be restored, when hcxdumptool terminated
2485
2486
2487 19.08.2018
2488 ==========
2489 parse SAE authentication
2490
2491
2492 19.08.2018
2493 ==========
2494 added radio assignment scan
2495 --do_rcascan : show radio channel assignment (scan for target access points)
2496 --save_rcascan=<file> : output rca scan list to file when hcxdumptool terminated
2497 --save_rcascan_raw=<file> : output file in pcapngformat
2498 unfiltered packets
2499 including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2500
2501
2502 17.08.2018
2503 ==========
2504 detect NETWORK EAP authentication system
2505 transmit BROADCAST beacon
2506
2507
2508 16.08.2018
2509 ==========
2510 From now on we store open system authentications to pcapng
2511 only if they have have a vendor specific field.
2512 we are no longer interested in standard open system authentications (payload len = 6)
2513
2514
2515 changed some default values:
2516
2517 -D <digit> : deauthentication interval
2518 default: 10 (every 10 beacons)
2519 the target beacon interval is used as trigger
2520 -A <digit> : ap attack interval
2521 default: 10 (every 10 beacons)
2522 --give_up_deauthentications=<digit>: disable transmitting deauthentications after n tries
2523 default: 100 tries (minimum: 4)
2524 affected: connections between client an access point
2525 deauthentication attacks will not work against protected management frames
2526 --give_up_ap_attacks=<digit> : disable transmitting directed proberequests after n tries
2527 default: 100 tries (minimum: 4)
2528 affected: client-less attack
2529 deauthentication attacks will not work against protected management frames
2530
2531
2532
2533 13.08.2018
2534 ==========
2535 increased some attack values:
2536 --give_up_deauthentications=<digit>: disable transmitting deauthentications after n tries
2537 default: 100 tries (minimum: 4)
2538 affected: connections between client an access point
2539 deauthentication attacks will not work against protected management frames
2540 --give_up_ap_attacks=<digit> : disable transmitting directed proberequests after n tries
2541 default: 100 tries (minimum: 4)
2542
2543
2544 07.08.2018
2545 ==========
2546 moved to 4.2.1
2547 added communication between hcxdumptool and hcxpcaptool via pcapng option fields:
2548 62108 for REPLAYCOUNT uint64_t
2549 62109 for ANONCE uint8_t[32]
2550
2551 enabled hardware handshake instead of software handshake
2552 changed behavior of status:
2553 --enable_status=<digit> : enables status messages
2554 bitmask:
2555 1: EAPOL
2556 2: PROBEREQUEST/PROBERESPONSE
2557 4: AUTHENTICATION
2558 8: ASSOCIATION
2559 Now we use a bitmask to deliver status messages.
2560
2561
2562 06.08.2018
2563 ==========
2564 write ISB (Interface Statistic Block) at the end of a capture
2565
2566
2567 04.08.2018
2568 ==========
2569 addet new option (--disable-active_scan) to hcxdumptool
2570 --disable_active_scan: do not transmit proberequests to BROADCAST using a BROADCAST ESSID
2571
2572
2573 04.08.2018
2574 ==========
2575 release hcxdumptool 4.2.0
2576 complete refactored:
2577 -various new options
2578 -measurement of EAPOL timeout
2579 -full support for hashcat hashmodes -m 16800 and 16801
2580 -now default format is pcapng
2581
2582
2583 $ ./hcxdumptool-bleeding --help
2584 hcxdumptool 4.2.0 (C) 2018 ZeroBeat
2585 usage : hcxdumptool <options>
2586 example: hcxdumptool -o output.pcapng -i wlp39s0f3u4u5 -t 5 --enable_status
2587
2588 options:
2589 -i <interface> : interface (monitor mode must be enabled)
2590 ip link set <interface> down
2591 iw dev <interface> set type monitor
2592 ip link set <interface> up
2593 -o <dump file> : output file in pcapngformat
2594 management frames and EAP/EAPOL frames
2595 including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2596 -O <dump file> : output file in pcapngformat
2597 unencrypted IPv4 and IPv6 frames
2598 including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2599 -W <dump file> : output file in pcapngformat
2600 encrypted WEP frames
2601 including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2602 -c <digit> : set scanlist (1,2,3,...)
2603 default scanlist: 1, 3, 5, 7, 9, 11, 13, 2, 4, 6, 8, 10, 12
2604 maximum entries: 127
2605 allowed channels:
2606 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14
2607 34, 36, 38, 40, 42, 44, 46, 48, 52, 56, 58, 60, 62, 64
2608 100, 104, 108, 112, 116, 120, 124, 128, 132,
2609 136, 140, 144, 147, 149, 151, 153, 155, 157
2610 161, 165, 167, 169, 184, 188, 192, 196, 200, 204, 208, 212, 216
2611 -t <seconds> : stay time on channel before hopping to the next channel
2612 default: 5 seconds
2613 -E <digit> : EAPOL timeout
2614 default: 100000 = 1 second
2615 value depends on channel assignment
2616 -D <digit> : deauthentication interval
2617 default: 20 (every 20 beacons)
2618 the target beacon interval is used as trigger
2619 -A <digit> : ap attack interval
2620 default: 20 (every 20 beacons)
2621 the target beacon interval is used as trigger
2622 -I : show suitable wlan interfaces and quit
2623 -h : show this help
2624 -v : show version
2625
2626 --filterlist=<file> : mac filter list
2627 format: 112233445566 + comment
2628 maximum line length 128, maximum entries 32
2629 --filtermode=<digit> : mode for filter list
2630 1: use filter list as protection list (default)
2631 2: use filter list as target list
2632 --disable_deauthentications: disable transmitting deauthentications
2633 affected: connections between client an access point
2634 deauthentication attacks will not work against protected management frames
2635 --give_up_deauthentications=<digit>: disable transmitting deauthentications after n tries
2636 default: 10 tries (minimum: 4)
2637 affected: connections between client an access point
2638 deauthentication attacks will not work against protected management frames
2639 --disable_disassociations : disable transmitting disassociations
2640 affected: retry (EAPOL 4/4 - M4) attack
2641 --disable_ap_attacks : disable attacks on single access points
2642 affected: client-less (PMKID) attack
2643 --give_up_ap_attacks=<digit> : disable transmitting directed proberequests after n tries
2644 default: 10 tries (minimum: 4)
2645 affected: client-less attack
2646 deauthentication attacks will not work against protected management frames
2647 --disable_client_attacks : disable attacks on single clients points
2648 affected: ap-less (EAPOL 2/4 - M2) attack
2649 --enable_status : enable status messages
2650 --help : show this help
2651 --version : show version
2652
2653
2654
2655 01.08.2018
2656 ==========
2657 moved some stuff from hcxtools to hcxdumptool repository
2658 prepare complete refactoring!
2659
2660
2661 04.03.2018
2662 ==========
2663 hcxdumptool: added new option -W
2664 -W <dump file> : WEP encrypted packets output file in pcapformat including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2665
2666
2667 04.03.2018
2668 ==========
2669 hcxdumptool again complete refactored:
2670
2671
2672 02.03.2018
2673 ==========
2674 hcxdumptool is complete refactored:
2675 - improved scan engine
2676 - improved authentication engine (incl. Radio Measurement, and NULL frame detection)
2677 - dropped timer
2678 - use threads for LED and channel switch
2679 - use only one file descriptor for raw socket operations
2680 - working on Intel Corporation Centrino Ultimate-N 6300 (rev 3e) WiFi adapter (kernel >= 4.15)
2681 - working on Alfa AWUS036NH, Alfa AWUS036NHA
2682 - working on Alfa AWUS036ACH (driver: https://github.com/kimocoder/rtl8812au)
2683 - more channels allowed (depends on installed wireless regulatory domain)
2684 - simple usage: hcxdumptool -i <interface> -o dumpfile.pcap -t 5
2685 interface (real interface - no monX) must be in monitor - all services/programs with access to the interface must be stopped!
2686 - new format of blacklist
2687 - and more...
2688
2689 reported to run on Gentoo
2690 https://github.com/ZerBea/hcxdumptool_bleeding_testing/issues/2#issuecomment-369256915
2691
2692 reported to run on OpenWRT/LEDE
2693 https://github.com/ZerBea/hcxdumptool_bleeding_testing/issues/3#issuecomment-369756725
2694
2695 reported to run with Intel Corporation Centrino Ultimate-N 6300 (rev 3e)
2696 https://github.com/ZerBea/hcxdumptool_bleeding_testing/issues/2#issuecomment-369259800
2697
2698 $ hcxdumptool -h
2699 hcxdumptool 4.1.0 (C) 2018 ZeroBeat
2700 usage:
2701 hcxdumptool <options>
2702
2703 options:
2704 -i <interface> : interface (monitor mode must be enabled)
2705 ip link set <interface> down
2706 iw dev <interface> set type monitor
2707 ip link set <interface> up
2708 -o <dump file> : output file in pcapformat including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2709 -O <dump file> : ip based traffic output file in pcapformat including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)
2710 -c <digit> : set scanlist (1,2,3,... / default = default scanlist)
2711 default scanlist: 1, 3, 5, 7, 9, 11, 13, 2, 4, 6, 8, 10, 12
2712 allowed channels:
2713 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14
2714 36, 40, 44, 48, 52, 56, 60, 64
2715 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 147, 151, 155, 167
2716 -t <seconds> : stay time on channel before hopping to the next channel
2717 default = 5 seconds
2718 -T <maxerrors> : terminate after <x> maximal errors
2719 : default: 1000000
2720 -D : do not transmit deauthentications or disassociations
2721 -R : do not transmit requests
2722 -A : do not respond to requests from clients
2723 -B <file> : blacklist (do not deauthenticate clients from this hosts)
2724 format = mac_ap:mac_sta:ESSID
2725 112233445566:aabbccddeeff:networkname (max. 32 chars)
2726 -P : enable poweroff
2727 -s : enable status messages
2728 -I : show suitable wlan interfaces and quit
2729 -h : show this help
2730 -v : show version
2731
2732
2733 27.02.2018
2734 ==========
2735 Now recommendations since we are run into heavy problems with latest drivers and operating systems
2736 * Operatingsystem: archlinux (strict), Kernel >= 4.14 (strict)
2737 * Raspberry Pi A, B, A+, B+ (Recommended: A+ = very low power consumption or B+), but notebooks and desktops could work, too.
2738 * GPIO hardware mod recommended
2739
2740 Supported adapters (strict)
2741 * USB ID 148f:7601 Ralink Technology, Corp. MT7601U Wireless Adapter
2742 * USB ID 148f:3070 Ralink Technology, Corp. RT2870/RT3070 Wireless Adapter
2743 * USB ID 148f:5370 Ralink Technology, Corp. RT5370 Wireless Adapter
2744 * USB ID 0bda:8187 Realtek Semiconductor Corp. RTL8187 Wireless Adapter
2745 * USB ID 0bda:8189 Realtek Semiconductor Corp. RTL8187B Wireless 802.11g 54Mbps Network Adapter
2746
2747
2748 25.02.2018
2749 ==========
2750 - initial start of this repository
2751 - added hcxdumptool
2752 - added hcxpioff
2753