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¶

WiFi Device

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 !