| 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 |
|