HCXDUMPTOOL(1)

NAME
hcxdumptool - capture packets from wifi devices

SYNOPSIS
hcxdumptool <options>

DESCRIPTION
hcxdumptool is a tool to capture packets from wifi devices and store the information in pcapng format.

AUTHOR
This manual page was written by Mike (ZeroBeat). Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so. License MIT

OPTIONS

Common options:

-i <interface>
    interface (monitor mode will be enabled by hcxdumptool)

-o <dump file>
    output management frames and EAP/EAPOL frames in pcapng format including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)

Other options:

-O <dump file>
    output unencrypted IPv4 and IPv6 frames in pcapng format including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)

-W <dump file>
    output encrypted WEP frames in pcapng format including radiotap header (LINKTYPE_IEEE802_11_RADIOTAP)

-c <digit>
    set scan list channels (1,2,3,...)

-t <seconds>
    stay time on channel before hopping to the next channel

-T <digit>
    set maximum ERROR count (hcxdumptool terminates when the value is reached)

-E <digit>
    EAPOL timeout

-D <digit>
    deauthentication interval

-A <digit>
    ap attack interval

--filterlist=<file>
    mac filter list

--filtermode=<digit>
    mode for filter list

--silent
    do not transmit packets

--disable_active_scan
    do not transmit proberequests to BROADCAST using a BROADCAST ESSID

--disable_deauthentications
    disable transmitting deauthentications

--give_up_deauthentications=<digit>

--disable_disassociations
    disable transmitting disassociations

--disable_ap_attacks
    disable attacks on single access points

--give_up_ap_attacks=<digit>
    disable transmitting directed proberequests after n tries

--disable_client_attacks
    disable attacks on single clients

--do_rcascan
    show radio channel assignment (scan for target access points)

--ap_mac=<mac_addr>
    use this MAC address for access point as start MAC

--station_mac=<mac_addr>
    use this MAC address for station

--station_vendor=<digit>
    use this VENDOR information for station

--use_gpsd
    use GPSD to retrieve position

--save_rcascan=<file>
    output rca scan list to file when hcxdumptool terminated

--save_rcascan_raw=<file>
    output file in pcapng format

--enable_status=<digit>
    enable status messages

--gpio_button=<digit>
    Raspberry Pi GPIO pin number of button (2...27)

--gpio_statusled=<digit>
    Raspberry Pi GPIO number of status LED (2...27)

--poweroff
    once hcxdumptool terminated, power off system

--ignore_warning
    hcxdumptool will not terminate if other services take access on the device

-I  show wlan interfaces

-C  show available channels and quit

-h or --help
    show help screen

-v or --version
    show version