wifi_scan¶
Presentation¶
wifi_scan scans for WiFi access points and stations. It allows to configure the execution time (TIME parameter), along with the fact to scan either stations, access points or both (STATIONS and ACCESS_POINTS parameters).
Compatible devices¶
Input parameters¶
Name |
Default value |
Possible values |
Description |
---|---|---|---|
INTERFACE |
wlan0 |
wlanX |
Interface to use |
TIME |
14 |
<integer> |
Execution time |
STATIONS |
yes |
<boolean> |
Scan for stations |
ACCESS_POINTS |
yes |
<boolean> |
Scan for access points |
Output parameters¶
If no devices are found, no output parameters are generated.
If only one device is found, the following output parameters are generated:
if the device is an Access Point:
Name
Possible values
Description
AP_ADDRESS
<MAC address>
MAC address of the access point
AP_SSID
<SSID>
SSID of the access point
AP_CHANNELS
<integer list>
Channels of the access point
if the device is a Station:
Name
Possible values
Description
TARGET
<MAC address>
MAC address of the station
CHANNELS
<integer list>
Channels of the station
If multiple devices have been identified, the same output parameters are generated, but are suffixed by the number of the device :
Name |
Possible values |
Description |
---|---|---|
AP_ADDRESS1 |
<MAC address> |
MAC address of the 1st access point |
AP_SSID1 |
<SSID> |
SSID of the 1st access point |
AP_CHANNELS1 |
<integer list> |
Channels of the 1st access point |
STATION_ADDRESS1 |
<MAC address> |
MAC address of the 1st station |
STATION_CHANNELS1 |
<integer list> |
Channels of the 1st station |
AP_ADDRESS2 |
<MAC address> |
MAC address of the 2nd access point |
AP_SSID2 |
<SSID> |
SSID of the 2nd access point |
AP_CHANNELS2 |
<integer list> |
Channels of the 2nd access point |
STATION_ADDRESS2 |
<MAC address> |
MAC address of the 2nd station |
STATION_CHANNELS2 |
<integer list> |
Channels of the 2nd station |
... |
... |
... |
Usage¶
To scan for both stations and access points, you can use the following command:
$ mirage wifi_scan
[INFO] Module wifi_scan loaded !
[INFO] New channel : 1
┌Access Point Found─┬──────────────────────────────────┬─────────┐
│ MAC Address │ SSID │ Channel │
├───────────────────┼──────────────────────────────────┼─────────┤
│ DC:9F:DB:F3:EF:9A │ LAN1 │ 1 │
│ DE:9F:DB:F7:B6:0A │ │ 1 │
│ 06:53:7C:94:87:47 │ Vodafone Homespot │ 1 │
│ 04:53:7C:94:87:46 │ Vodafone Hotspot │ 1 │
└───────────────────┴──────────────────────────────────┴─────────┘
[INFO] New channel : 2
┌Access Point Found─┬──────────────────────────────────┬─────────┐
│ MAC Address │ SSID │ Channel │
├───────────────────┼──────────────────────────────────┼─────────┤
│ DC:9F:DB:F3:EF:9A │ LAN1 │ 1 │
│ DE:9F:DB:F7:B6:0A │ │ 1 │
│ 06:53:7C:94:87:47 │ Vodafone Homespot │ 1 │
│ 04:53:7C:94:87:46 │ Vodafone Hotspot │ 1 │
│ E4:3E:D7:3B:AF:CD │ DonCorleone │ 2 │
└───────────────────┴──────────────────────────────────┴─────────┘
[INFO] New channel : 3
[INFO] New channel : 4
[INFO] New channel : 5
[INFO] New channel : 6
┌Access Point Found─┬──────────────────────────────────┬─────────┐
│ MAC Address │ SSID │ Channel │
├───────────────────┼──────────────────────────────────┼─────────┤
│ DC:9F:DB:F3:EF:9A │ LAN1 │ 1 │
│ DE:9F:DB:F7:B6:0A │ │ 1 │
│ 06:53:7C:94:87:47 │ Vodafone Homespot │ 1 │
│ 04:53:7C:94:87:46 │ Vodafone Hotspot │ 1 │
│ E4:3E:D7:3B:AF:CD │ DonCorleone │ 2 │
│ DC:9F:DB:F3:EE:C3 │ LAN1 │ 6 │
│ 06:18:D6:01:95:78 │ │ 6 │
└───────────────────┴──────────────────────────────────┴─────────┘
┌Stations Found─────┬─────────┐
│ MAC Address │ Channel │
├───────────────────┼─────────┤
│ 5E:F8:E1:A5:4F:2B │ 5,6 │
└───────────────────┴─────────┘
┌Stations Found─────┬─────────┐
│ MAC Address │ Channel │
├───────────────────┼─────────┤
│ 5E:F8:E1:A5:4F:2B │ 5,6 │
│ B4:74:43:6E:58:C3 │ 6 │
└───────────────────┴─────────┘
[INFO] New channel : 7
[INFO] New channel : 8
┌Stations Found─────┬─────────┐
│ MAC Address │ Channel │
├───────────────────┼─────────┤
│ 5E:F8:E1:A5:4F:2B │ 5,6 │
│ B4:74:43:6E:58:C3 │ 6 │
│ 1A:B1:37:5C:A7:7D │ 7 │
└───────────────────┴─────────┘
[INFO] New channel : 9
^C[INFO] Disabling monitor mode ...
[INFO] Mirage process terminated !