home | help
WLANDEBUG(8)		     System Manager's Manual		    WLANDEBUG(8)

NAME
     wlandebug -- set/query 802.11 wireless debugging messages

SYNOPSIS
     wlandebug [-i ifnet] [-flag|+flag ...]

DESCRIPTION
     The  wlandebug  command is a tool for enabling and disabling debugging mes-
     sages in the wlan(4) module.  Running wlandebug without  any  options  will
     display  the  current  messages enabled for the specified network interface
     (by default, ``ath0').  When run as the super-user wlandebug can be used to
     enable and/or disable debugging messages.

     To enable debugging messages of a certain type use +type; to  disable  such
     messages  use  -type.  Multiple messages can be enabled and disabled with a
     single command.

     Messages are organized in the following groups:

     debug     general debugging facilities; equivalent to setting the debug pa-
	       rameter with ifconfig(8).

     dumppkts  dump packet contents on transmit and receive.

     crypto    crypto-related work.

     input     errors encountered during input handling.

     xrate     extended rate set handling (for 802.11g).

     elemid    information element processing in 802.11 management frames.

     node      management of per-station state.

     assoc     802.11 station association processing; particularly useful to see
	       when stations join and leave a BSS.

     auth      802.11 station authentication processing.

     scan      scanning operation; especially useful for debugging problems with
	       not locating an access point.

     output    errors encountered during output handling.

     state     wlan(4) state machine operation.

     power     802.11 power save operation; in hostap mode this enables  copious
	       information about buffered frames for stations operating in power
	       save mode.

     dot1x     802.1x  operation;  not	presently  meaningful as 802.1x protocol
	       support is implemented in user mode by the hostapd(8) program.

     dot1xsm   802.1x state  machine  operation;  not  presently  meaningful  as
	       802.1x  protocol  support  is  implemented  in  user  mode by the
	       hostapd(8) program.

     radius    radius backend operation as it relates to 802.1x  operation;  not
	       presently meaningful as 802.1x protocol support is implemented in
	       user mode by the hostapd(8) program.

     raddump   dump  packets exchanged with the radius backend for 802.1x opera-
	       tion; not presently meaningful as 802.1x protocol support is  im-
	       plemented in user mode by the hostapd(8) program.

     radkeys   include	key contents when dumping packets exchanged with the ra-
	       dius backend for 802.1x operation; not  presently  meaningful  as
	       802.1x  protocol  support  is  implemented  in  user  mode by the
	       hostapd(8) program.

     wpa       trace operation of the WPA protocol; only  partly  meaningful  as
	       WPA  protocol  support  is mostly implemented in user mode by the
	       hostapd(8) and wpa_supplicant(8) programs.

     acl       trace operation of the Access Control  List  (ACL)  support;  see
	       wlan_acl(4) for more details.

     wme       trace operation of WME/WMM protocol processing.

     superg    trace operation of Atheros SuperG protocol processing.

     doth      trace operation of IEEE 802.11h protocol processing.

     inact     trace  station  inactivity  processing;	in particular, show when
	       stations associated to an access point are dropped due  to  inac-
	       tivity.

     roam      trace station mode roaming between access points.

     rate      trace transmit rate control operation.

EXAMPLES
     The following might be used to debug basic station mode operation:

	   wlandebug -i ral0 scan+auth+assoc

     it  enables  debug  messages  while  scanning,  authenticating to an access
     point, and associating to an access point.

SEE ALSO
     ifconfig(8), wlanstats(8), athdebug(8), athstats(8).

NOTES
     Different wireless drivers support different debugging  messages.	 Drivers
     such as ath(4) and ral(4) that depend on the wlan(4) module for 802.11 pro-
     tocol processing typically support most of the debugging messages while de-
     vices that implement parts of the 802.11 protocol in firmware do not.

     Some  debugging messages are no longer meaningful because protocol process-
     ing has moved from the operating system  to  user	mode  programs	such  as
     hostapd(8) and wpa_supplicant(8).

FreeBSD 7.0			 January 8, 2007		    WLANDEBUG(8)

home | help