wifiCapture

Value Type

keyword-list

Accepted Values

off | on | filter

Default Value

off

Description

This parameter controls 802.11 WiFi packet capture within CDRouter.

When set to on or filter, CDRouter will automatically create a monitor interface and generate 802.11 wireless captures for each WiFi interface that is in use.

A default capture filter will be applied when this parameter is set to a value of on. The default capture filter is dynamic based on the association state of the first wireless client on each WiFi interface that is in use.

The default capture filter will discard all 802.11 packets until the first client begins the association process. While the first client is associating, the default capture filter is updated to allow all management frames and data frames to and from the first client.

In pcap-filter syntax the default capture filter while the first client is associating on each interface is:

type mgt or (type data and (wlan addr1 <client-mac> or wlan addr2 <client-mac>))

When one or more clients are associated, the default capture filter is updated again to allow all management frames except for beacons, probe requests, and probe responses and all data frames to and from the AP’s BSSID.

In pcap-filter syntax the default capture following successful association of the first client on each interface is:

(type mgt or type data) and !subtype beacon and !subtype probe-req and !subtype probe-resp and (wlan addr1 <bssid> or wlan addr2 <bssid>)

Optionally, a user defined capture filter in standard pcap- filter syntax can be applied by setting this parameter to a value of filter. The testvar wifiCaptureFilter is then used to define the filter.

Note that all 802.11 packet captures generated by CDRouter will be available in the result directory on disk or via the Files dropdown within CDRouter’s web UI log viewer.

Also note that WiFi packet capture will be automatically disabled for the duration of any performance tests.

This testvar was added in CDRouter 11.1