View source for Plugin:MadWifi

{{Infobox Plugin
  | Name=MadWifi
  | Type=read
  | Status= style="background-color: yellow;" {{!}} ''in development''
  | FirstVersion=4.8
  | Copyright=''2009'' Ondrej Zajicek
  | License={{GPLv2}}
  | Manpage=[http://collectd.org/documentation/manpages/collectd.conf.5.shtml#plugin_madwifi collectd.conf(5)]
}}

== Description ==

The '''MadWifi plugin''' collects information about Atheros wireless LAN chipsets from the ''MadWifi'' driver. It uses the <code>/sys</code> filesystem to identify cards handled by this driver automatically but can be configured manually, too. Because ''very many'' statistics are available, an advanced selection mechanism is provided.

== Synopsis ==

 <Plugin "madwifi">
   Interface "wlan0"
   Source "SysFS"
   WatchSet "None"
   WatchAdd "node_octets"
   WatchAdd "node_rssi"
   WatchAdd "is_rx_acl"
   WatchAdd "is_scan_active"
 </Plugin>

== Example graphs ==

{{No Example Graph}}

== Available statistics ==

=== Special statistics ===
{| class="with_background"
 |-
 ! Name !! Description !! Default
 |-
 | node_octets || RX and TX data count <small>(per node)</small> || {{EnabledCell}}
 |-
 | node_rssi || Received signal strength indication (RSSI) <small>(per node)</small> || {{EnabledCell}}
 |-
 | node_tx_rate || used TX rate <small>(per node)</small> || {{EnabledCell}}
 |-
 | ns_rx_beacons || RX beacon frames <small>(per node)</small>  || {{DisabledCell}}
 |-
 | ath_nodes || the number of associated nodes <small>(per interface)</small> || {{EnabledCell}}
 |-
 | ast_ant_rx || RX frames with antenna <small>(per interface)</small> || {{EnabledCell}}
 |-
 | ast_ant_tx || TX frames with antenna <small>(per interface)</small> || {{EnabledCell}}
 |-
 |}

=== Node statistics ===

All the following statistics are collected ''per&nbsp;node'', i.&nbsp;e. there will be one file for each node associated with the interface.

{| class="with_background"
 |-
 ! Name !! Description !! Default
 |-
 | ns_rx_data || RX data frames  || {{EnabledCell}}
 |-
 | ns_rx_mgmt || RX management frames  || {{EnabledCell}}
 |-
 | ns_rx_ctrl || RX control frames  || {{EnabledCell}}
 |-
 | ns_rx_ucast || RX unicast frames  || {{DisabledCell}}
 |-
 | ns_rx_mcast || RX multi/broadcast frames  || {{DisabledCell}}
 |-
 | ns_rx_proberesp || RX probe response frames  || {{DisabledCell}}
 |-
 | ns_rx_dup || RX discard because it's a dup  || {{EnabledCell}}
 |-
 | ns_rx_noprivacy || RX with WEP but privacy off  || {{SummarizedCell}}
 |-
 | ns_rx_wepfail || RX WEP processing failed  || {{SummarizedCell}}
 |-
 | ns_rx_demicfail || RX demic failed  || {{SummarizedCell}}
 |-
 | ns_rx_decap || RX decapsulation failed  || {{SummarizedCell}}
 |-
 | ns_rx_defrag || RX defragmentation failed  || {{SummarizedCell}}
 |-
 | ns_rx_disassoc || RX disassociation  || {{DisabledCell}}
 |-
 | ns_rx_deauth || RX deauthentication  || {{DisabledCell}}
 |-
 | ns_rx_decryptcrc || RX decrypt failed on CRC  || {{SummarizedCell}}
 |-
 | ns_rx_unauth || RX on unauthorized port  || {{SummarizedCell}}
 |-
 | ns_rx_unencrypted || RX unecrypted with privacy  || {{SummarizedCell}}
 |-
 | ns_tx_data || TX data frames  || {{EnabledCell}}
 |-
 | ns_tx_mgmt || TX management frames  || {{EnabledCell}}
 |-
 | ns_tx_ucast || TX unicast frames  || {{DisabledCell}}
 |-
 | ns_tx_mcast || TX multi/broadcast frames  || {{DisabledCell}}
 |-
 | ns_tx_probereq || TX probe request frames  || {{DisabledCell}}
 |-
 | ns_tx_uapsd || TX on uapsd queue  || {{DisabledCell}}
 |-
 | ns_tx_novlantag || TX discard due to no tag  || {{SummarizedCell}}
 |-
 | ns_tx_vlanmismatch || TX discard due to of bad tag  || {{SummarizedCell}}
 |-
 | ns_tx_eosplost || uapsd EOSP retried out  || {{DisabledCell}}
 |-
 | ns_ps_discard || ps discard due to of age  || {{DisabledCell}}
 |-
 | ns_uapsd_triggers || uapsd triggers  || {{DisabledCell}}
 |-
 | ns_tx_assoc || [re]associations  || {{EnabledCell}}
 |-
 | ns_tx_auth || [re]authentications  || {{EnabledCell}}
 |-
 | ns_tx_deauth || deauthentications  || {{DisabledCell}}
 |-
 | ns_tx_disassoc || disassociations  || {{DisabledCell}}
 |-
 | ns_psq_drops || power save queue drops  || {{DisabledCell}}
 |}

=== Interface statistics ===

The following statistics are collected ''per&nbsp;interface''.

{| class="with_background"
 |-
 ! Name !! Description !! Default
 |-
 | is_rx_badversion || RX frame with bad version  || {{SummarizedCell}}
 |-
 | is_rx_tooshort || RX frame too short  || {{SummarizedCell}}
 |-
 | is_rx_wrongbss || RX from wrong BSSID  || {{EnabledCell}}
 |-
 | is_rx_dup || RX discard due to it's a duplication || {{EnabledCell}}
 |-
 | is_rx_wrongdir || RX with wrong direction  || {{SummarizedCell}}
 |-
 | is_rx_mcastecho || RX discard due to multicast echo  || {{DisabledCell}}
 |-
 | is_rx_notassoc || RX discard due to not associated sta || {{SummarizedCell}}
 |-
 | is_rx_noprivacy || RX with WEP but privacy off  || {{SummarizedCell}}
 |-
 | is_rx_unencrypted || RX without WEP and privacy on  || {{SummarizedCell}}
 |-
 | is_rx_wepfail || RX WEP processing failed  || {{SummarizedCell}}
 |-
 | is_rx_decap || RX decapsulation failed  || {{SummarizedCell}}
 |-
 | is_rx_mgtdiscard || RX discard management frames  || {{DisabledCell}}
 |-
 | is_rx_ctl || RX discard control frames  || {{DisabledCell}}
 |-
 | is_rx_beacon || RX beacon frames  || {{DisabledCell}}
 |-
 | is_rx_rstoobig || RX rate set truncated  || {{DisabledCell}}
 |-
 | is_rx_elem_missing || RX required element missing || {{SummarizedCell}}
 |-
 | is_rx_elem_toobig || RX element too big  || {{SummarizedCell}}
 |-
 | is_rx_elem_toosmall || RX element too small  || {{SummarizedCell}}
 |-
 | is_rx_elem_unknown || RX element unknown  || {{EnabledCell}}
 |-
 | is_rx_badchan || RX frame with invalid channel  || {{SummarizedCell}}
 |-
 | is_rx_chanmismatch || RX frame channel mismatch  || {{SummarizedCell}}
 |-
 | is_rx_nodealloc || RX frame dropped  || {{SummarizedCell}}
 |-
 | is_rx_ssidmismatch || RX frame SSID mismatch   || {{EnabledCell}}
 |-
 | is_rx_auth_unsupported || RX with unsupported authentication algorithm  || {{SummarizedCell}}
 |-
 | is_rx_auth_fail || RX sta authentication failure  || {{SummarizedCell}}
 |-
 | is_rx_auth_countermeasures || RX authentication discard due to countermeasures || {{SummarizedCell}}
 |-
 | is_rx_assoc_bss || RX assoc from wrong BSSID || {{SummarizedCell}}
 |-
 | is_rx_assoc_notauth || RX assoc without authentication || {{SummarizedCell}}
 |-
 | is_rx_assoc_capmismatch || RX assoc with cap mismatch  || {{SummarizedCell}}
 |-
 | is_rx_assoc_norate || RX assoc with no rate match  || {{SummarizedCell}}
 |-
 | is_rx_assoc_badwpaie || RX assoc with bad WPA IE  || {{SummarizedCell}}
 |-
 | is_rx_deauth || RX deauthentication  || {{EnabledCell}}
 |-
 | is_rx_disassoc || RX disassociation  || {{EnabledCell}}
 |-
 | is_rx_badsubtype || RX frame with unknown subtype || {{SummarizedCell}}
 |-
 | is_rx_nobuf || RX failed for lack of buffers  || {{SummarizedCell}}
 |-
 | is_rx_decryptcrc || RX decrypt failed on CRC  || {{SummarizedCell}}
 |-
 | is_rx_ahdemo_mgt || RX discard ahdemo management frame || {{DisabledCell}}
 |-
 | is_rx_bad_auth || RX bad authentication request  || {{SummarizedCell}}
 |-
 | is_rx_unauth || RX on unauthorized port  || {{SummarizedCell}}
 |-
 | is_rx_badkeyid || RX with incorrect key ID  || {{SummarizedCell}}
 |-
 | is_rx_ccmpreplay || RX sequence number violation (CCMP),  || {{DisabledCell}}
 |-
 | is_rx_ccmpformat || RX format bad (CCMP),  || {{DisabledCell}}
 |-
 | is_rx_ccmpmic || RX MIC check failed (CCMP),  || {{DisabledCell}}
 |-
 | is_rx_tkipreplay || RX sequence number violation (TKIP),  || {{DisabledCell}}
 |-
 | is_rx_tkipformat || RX format bad (TKIP),  || {{DisabledCell}}
 |-
 | is_rx_tkipmic || RX MIC check failed (TKIP),  || {{DisabledCell}}
 |-
 | is_rx_tkipicv || RX ICV check failed (TKIP),  || {{DisabledCell}}
 |-
 | is_rx_badcipher || RX failed due to of key type  || {{DisabledCell}}
 |-
 | is_rx_nocipherctx || RX failed due to missing key setup  || {{DisabledCell}}
 |-
 | is_rx_acl || RX discard due to of ACL policy  || {{DisabledCell}}
 |-
 | is_rx_ffcnt || RX fast frames  || {{DisabledCell}}
 |-
 | is_rx_badathtnl || driver key allocation failed  || {{SummarizedCell}}
 |-
 | is_tx_nobuf || TX failed for lack of buffers  || {{SummarizedCell}}
 |-
 | is_tx_nonode || TX failed for no node  || {{SummarizedCell}}
 |-
 | is_tx_unknownmgt || TX of unknown management frame  || {{SummarizedCell}}
 |-
 | is_tx_badcipher || TX failed due to of key type  || {{SummarizedCell}}
 |-
 | is_tx_nodefkey || TX failed due to no default key  || {{SummarizedCell}}
 |-
 | is_tx_noheadroom || TX failed due to no space  || {{SummarizedCell}}
 |-
 | is_tx_ffokcnt || TX fast frames sent success  || {{DisabledCell}}
 |-
 | is_tx_fferrcnt || TX fast frames sent success  || {{DisabledCell}}
 |-
 | is_scan_active || active scans started  || {{DisabledCell}}
 |-
 | is_scan_passive || passive scans started  || {{DisabledCell}}
 |-
 | is_node_timeout || nodes timed out inactivity  || {{DisabledCell}}
 |-
 | is_crypto_nomem || no memory for crypto context  || {{DisabledCell}}
 |-
 | is_crypto_tkip || TKIP crypto done in software  || {{DisabledCell}}
 |-
 | is_crypto_tkipenmic || TKIP en-MIC done in software  || {{DisabledCell}}
 |-
 | is_crypto_tkipdemic || TKIP de-MIC done in software  || {{DisabledCell}}
 |-
 | is_crypto_tkipcm || TKIP counter measures  || {{DisabledCell}}
 |-
 | is_crypto_ccmp || CCMP crypto done in software  || {{DisabledCell}}
 |-
 | is_crypto_wep || WEP crypto done in software  || {{DisabledCell}}
 |-
 | is_crypto_setkey_cipher || cipher rejected key  || {{DisabledCell}}
 |-
 | is_crypto_setkey_nokey || no key index for setkey  || {{DisabledCell}}
 |-
 | is_crypto_delkey || driver key delete failed  || {{DisabledCell}}
 |-
 | is_crypto_badcipher || unknown cipher  || {{DisabledCell}}
 |-
 | is_crypto_nocipher || cipher not available  || {{DisabledCell}}
 |-
 | is_crypto_attachfail || cipher attach failed  || {{DisabledCell}}
 |-
 | is_crypto_swfallback || cipher fallback to software  || {{DisabledCell}}
 |-
 | is_crypto_keyfail || driver key allocation failed  || {{DisabledCell}}
 |-
 | is_crypto_enmicfail || en-MIC failed  || {{DisabledCell}}
 |-
 | is_ibss_capmismatch || merge failed-cap mismatch  || {{SummarizedCell}}
 |-
 | is_ibss_norate || merge failed-rate mismatch  || {{SummarizedCell}}
 |-
 | is_ps_unassoc || ps-poll for unassociated sta  || {{DisabledCell}}
 |-
 | is_ps_badaid || ps-poll with incorrect aid  || {{DisabledCell}}
 |-
 | is_ps_qempty || ps-poll with nothing to send  || {{DisabledCell}}
 |}

=== Atheros statistics ===
{| class="with_background"
 |-
 ! Name !! Description !! Default
 |-
 | ast_watchdog || device reset by watchdog  || {{DisabledCell}}
 |-
 | ast_hardware || fatal hardware error interrupts  || {{DisabledCell}}
 |-
 | ast_bmiss || beacon miss interrupts  || {{DisabledCell}}
 |-
 | ast_rxorn || RX overrun interrupts  || {{DisabledCell}}
 |-
 | ast_rxeol || RX eol interrupts  || {{DisabledCell}}
 |-
 | ast_txurn || TX underrun interrupts  || {{DisabledCell}}
 |-
 | ast_mib || mib interrupts  || {{DisabledCell}}
 |-
 | ast_tx_packets || packet sent on the interface  || {{DisabledCell}}
 |-
 | ast_tx_mgmt || management frames transmitted  || {{DisabledCell}}
 |-
 | ast_tx_discard || frames discarded prior to assoc  || {{EnabledCell}}
 |-
 | ast_tx_invalid || frames discarded due to is device gone  || {{SummarizedCell}}
 |-
 | ast_tx_qstop || TX queue stopped because it's full || {{SummarizedCell}}
 |-
 | ast_tx_encap || TX encapsulation failed  || {{SummarizedCell}}
 |-
 | ast_tx_nonode || TX failed due to of no node  || {{SummarizedCell}}
 |-
 | ast_tx_nobuf || TX failed due to of no TX buffer (data),  || {{SummarizedCell}}
 |-
 | ast_tx_nobufmgt || TX failed due to of no TX buffer (mgmt), || {{SummarizedCell}}
 |-
 | ast_tx_xretries || TX failed due to of too many retries  || {{EnabledCell}}
 |-
 | ast_tx_fifoerr || TX failed due to of FIFO underrun  || {{SummarizedCell}}
 |-
 | ast_tx_filtered || TX failed due to xmit filtered  || {{SummarizedCell}}
 |-
 | ast_tx_shortretry || TX on-chip retries (short),  || {{EnabledCell}}
 |-
 | ast_tx_longretry || TX on-chip retries (long),  || {{EnabledCell}}
 |-
 | ast_tx_badrate || TX failed due to of bogus xmit rate  || {{SummarizedCell}}
 |-
 | ast_tx_noack || TX frames with no ack marked  || {{DisabledCell}}
 |-
 | ast_tx_rts || TX frames with rts enabled  || {{DisabledCell}}
 |-
 | ast_tx_cts || TX frames with cts enabled  || {{DisabledCell}}
 |-
 | ast_tx_shortpre || TX frames with short preamble  || {{DisabledCell}}
 |-
 | ast_tx_altrate || TX frames with alternate rate  || {{EnabledCell}}
 |-
 | ast_tx_protect || TX frames with protection  || {{DisabledCell}}
 |-
 | ast_rx_orn || RX failed due to of desc overrun  || {{SummarizedCell}}
 |-
 | ast_rx_crcerr || RX failed due to of bad CRC  || {{EnabledCell}}
 |-
 | ast_rx_fifoerr || RX failed due to of FIFO overrun  || {{SummarizedCell}}
 |-
 | ast_rx_badcrypt || RX failed due to of decryption  || {{SummarizedCell}}
 |-
 | ast_rx_badmic || RX failed due to of MIC failure  || {{SummarizedCell}}
 |-
 | ast_rx_phyerr || RX PHY error summary count  || {{EnabledCell}}
 |-
 | ast_rx_tooshort || RX discarded due to frame too short  || {{SummarizedCell}}
 |-
 | ast_rx_toobig || RX discarded due to frame too large  || {{SummarizedCell}}
 |-
 | ast_rx_nobuf || RX setup failed due to of no skbuff  || {{SummarizedCell}}
 |-
 | ast_rx_packets || packet recv on the interface  || {{DisabledCell}}
 |-
 | ast_rx_mgt || management frames received  || {{DisabledCell}}
 |-
 | ast_rx_ctl || control frames received  || {{DisabledCell}}
 |-
 | ast_be_xmit || beacons transmitted  || {{DisabledCell}}
 |-
 | ast_be_nobuf || no skbuff available for beacon  || {{SummarizedCell}}
 |-
 | ast_per_cal || periodic calibration calls  || {{DisabledCell}}
 |-
 | ast_per_calfail || periodic calibration failed  || {{DisabledCell}}
 |-
 | ast_per_rfgain || periodic calibration rfgain reset  || {{DisabledCell}}
 |-
 | ast_rate_calls || rate control checks  || {{DisabledCell}}
 |-
 | ast_rate_raise || rate control raised xmit rate  || {{DisabledCell}}
 |-
 | ast_rate_drop || rate control dropped xmit rate  || {{DisabledCell}}
 |-
 | ast_ant_defswitch || RX/default antenna switches  || {{DisabledCell}}
 |-
 | ast_ant_txswitch || TX antenna switches  || {{DisabledCell}}
 |}

== Dependencies ==

* Linux
** <code>/sys</code> filesystem
** ''MadWifi'' driver

== See also ==

* http://madwifi-project.org/

[[Category:Plugins]]