Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
     wlandebug -- set/query 802.11 wireless debugging messages

SYNOPSIS
     wlandebug [-d | -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, ``wlan0').  The default debugging level for new interfaces can
     be set by specifying the -d option.  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.

     hwmp      trace operation of Hybrid Wireless Mesh Protocol processing.

     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.

     mesh      trace operation of 802.11s mesh protocol processing.

     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 wlan1 scan+auth+assoc

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

SEE ALSO
     ifconfig(8)

     The /usr/src/tools directory contains some utilities that might be relevant
     to debug wireless issues.

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 ports 15.1		 August 17, 2015		    WLANDEBUG(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wlandebug&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help