summaryrefslogtreecommitdiffstats
path: root/usr.sbin/wlandebug/wlandebug.8
blob: 0640eff01b20daf1d9be0079663bcce119fda09d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
.\" Copyright (c) 2007 Sam Leffler, Errno Consulting
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
.Dd August 17, 2015
.Dt WLANDEBUG 8
.Os
.Sh NAME
.Nm wlandebug
.Nd "set/query 802.11 wireless debugging messages"
.Sh SYNOPSIS
.Nm
.Op Fl d | Fl i Ar ifnet
.Op Fl flag|+flag Ar ...
.Sh DESCRIPTION
The
.Nm
command is a tool for enabling and disabling
debugging messages in the
.Xr wlan 4
module.
Running
.Nm
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
.Fl d
option.
When run as the super-user
.Nm
can be used to enable and/or disable debugging messages.
.Pp
To enable debugging messages of a certain
.Ar type
use
.Ar +type ;
to disable such messages use
.Ar -type .
Multiple messages can be enabled and disabled with a single command.
.Pp
Messages are organized in the following groups:
.Bl -tag -width ".Ar dumppkts"
.It Ar debug
general debugging facilities; equivalent to setting the debug
parameter with
.Xr ifconfig 8 .
.It Ar dumppkts
dump packet contents on transmit and receive.
.It Ar crypto
crypto-related work.
.It Ar input
errors encountered during input handling.
.It Ar xrate
extended rate set handling (for 802.11g).
.It Ar elemid
information element processing in 802.11 management frames.
.It Ar node
management of per-station state.
.It Ar assoc
802.11 station association processing; particularly useful to
see when stations join and leave a BSS.
.It Ar auth
802.11 station authentication processing.
.It Ar scan
scanning operation; especially useful for debugging problems
with not locating an access point.
.It Ar output
errors encountered during output handling.
.It Ar state
.Xr wlan 4
state machine operation.
.It Ar power
802.11 power save operation; in hostap mode this enables
copious information about buffered frames for stations operating
in power save mode.
.It Ar hwmp
trace operation of Hybrid Wireless Mesh Protocol processing.
.It Ar dot1xsm
802.1x state machine operation; not presently meaningful as 802.1x protocol
support is implemented in user mode by the
.Xr hostapd 8
program.
.It Ar 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
.Xr hostapd 8
program.
.It Ar raddump
dump packets exchanged with the radius backend for 802.1x operation;
not presently meaningful as 802.1x protocol
support is implemented in user mode by the
.Xr hostapd 8
program.
.It Ar mesh
trace operation of 802.11s mesh protocol processing.
.It Ar wpa
trace operation of the WPA protocol;
only partly meaningful as WPA protocol
support is mostly implemented in user mode by the
.Xr hostapd 8
and
.Xr wpa_supplicant 8
programs.
.It Ar acl
trace operation of the Access Control List (ACL) support; see
.Xr wlan_acl 4
for more details.
.It Ar wme
trace operation of WME/WMM protocol processing.
.It Ar superg
trace operation of Atheros SuperG protocol processing.
.It Ar doth
trace operation of IEEE 802.11h protocol processing.
.It Ar inact
trace station inactivity processing; in particular,
show when stations associated to an access point are dropped due to
inactivity.
.It Ar roam
trace station mode roaming between access points.
.It Ar rate
trace transmit rate control operation.
.El
.Sh EXAMPLES
The following might be used to debug basic station mode operation:
.Pp
.Dl "wlandebug -i wlan1 scan+auth+assoc"
.Pp
it enables debug messages while scanning, authenticating to
an access point, and associating to an access point.
.Sh SEE ALSO
.Xr athdebug 8 ,
.Xr athstats 8 ,
.Xr ifconfig 8 ,
.Xr wlanstats 8
.Sh NOTES
Different wireless drivers support different debugging messages.
Drivers such as
.Xr ath 4
and
.Xr ral 4
that depend on the
.Xr wlan 4
module for 802.11 protocol processing typically support
most of the debugging messages while devices that
implement parts of the 802.11 protocol in firmware do not.
.Pp
Some debugging messages are no longer meaningful
because protocol processing has moved from the operating
system to user mode programs such as
.Xr hostapd 8
and
.Xr wpa_supplicant 8 .
OpenPOWER on IntegriCloud