xref: /openbmc/linux/net/mac80211/debugfs.c (revision 3b23dc52)
1 /*
2  * mac80211 debugfs for wireless PHYs
3  *
4  * Copyright 2007	Johannes Berg <johannes@sipsolutions.net>
5  * Copyright 2013-2014  Intel Mobile Communications GmbH
6  *
7  * GPLv2
8  *
9  */
10 
11 #include <linux/debugfs.h>
12 #include <linux/rtnetlink.h>
13 #include <linux/vmalloc.h>
14 #include "ieee80211_i.h"
15 #include "driver-ops.h"
16 #include "rate.h"
17 #include "debugfs.h"
18 
19 #define DEBUGFS_FORMAT_BUFFER_SIZE 100
20 
21 int mac80211_format_buffer(char __user *userbuf, size_t count,
22 				  loff_t *ppos, char *fmt, ...)
23 {
24 	va_list args;
25 	char buf[DEBUGFS_FORMAT_BUFFER_SIZE];
26 	int res;
27 
28 	va_start(args, fmt);
29 	res = vscnprintf(buf, sizeof(buf), fmt, args);
30 	va_end(args);
31 
32 	return simple_read_from_buffer(userbuf, count, ppos, buf, res);
33 }
34 
35 #define DEBUGFS_READONLY_FILE_FN(name, fmt, value...)			\
36 static ssize_t name## _read(struct file *file, char __user *userbuf,	\
37 			    size_t count, loff_t *ppos)			\
38 {									\
39 	struct ieee80211_local *local = file->private_data;		\
40 									\
41 	return mac80211_format_buffer(userbuf, count, ppos, 		\
42 				      fmt "\n", ##value);		\
43 }
44 
45 #define DEBUGFS_READONLY_FILE_OPS(name)			\
46 static const struct file_operations name## _ops = {			\
47 	.read = name## _read,						\
48 	.open = simple_open,						\
49 	.llseek = generic_file_llseek,					\
50 };
51 
52 #define DEBUGFS_READONLY_FILE(name, fmt, value...)		\
53 	DEBUGFS_READONLY_FILE_FN(name, fmt, value)		\
54 	DEBUGFS_READONLY_FILE_OPS(name)
55 
56 #define DEBUGFS_ADD(name)						\
57 	debugfs_create_file(#name, 0400, phyd, local, &name## _ops);
58 
59 #define DEBUGFS_ADD_MODE(name, mode)					\
60 	debugfs_create_file(#name, mode, phyd, local, &name## _ops);
61 
62 
63 DEBUGFS_READONLY_FILE(user_power, "%d",
64 		      local->user_power_level);
65 DEBUGFS_READONLY_FILE(power, "%d",
66 		      local->hw.conf.power_level);
67 DEBUGFS_READONLY_FILE(total_ps_buffered, "%d",
68 		      local->total_ps_buffered);
69 DEBUGFS_READONLY_FILE(wep_iv, "%#08x",
70 		      local->wep_iv & 0xffffff);
71 DEBUGFS_READONLY_FILE(rate_ctrl_alg, "%s",
72 	local->rate_ctrl ? local->rate_ctrl->ops->name : "hw/driver");
73 
74 static ssize_t aqm_read(struct file *file,
75 			char __user *user_buf,
76 			size_t count,
77 			loff_t *ppos)
78 {
79 	struct ieee80211_local *local = file->private_data;
80 	struct fq *fq = &local->fq;
81 	char buf[200];
82 	int len = 0;
83 
84 	spin_lock_bh(&local->fq.lock);
85 	rcu_read_lock();
86 
87 	len = scnprintf(buf, sizeof(buf),
88 			"access name value\n"
89 			"R fq_flows_cnt %u\n"
90 			"R fq_backlog %u\n"
91 			"R fq_overlimit %u\n"
92 			"R fq_overmemory %u\n"
93 			"R fq_collisions %u\n"
94 			"R fq_memory_usage %u\n"
95 			"RW fq_memory_limit %u\n"
96 			"RW fq_limit %u\n"
97 			"RW fq_quantum %u\n",
98 			fq->flows_cnt,
99 			fq->backlog,
100 			fq->overmemory,
101 			fq->overlimit,
102 			fq->collisions,
103 			fq->memory_usage,
104 			fq->memory_limit,
105 			fq->limit,
106 			fq->quantum);
107 
108 	rcu_read_unlock();
109 	spin_unlock_bh(&local->fq.lock);
110 
111 	return simple_read_from_buffer(user_buf, count, ppos,
112 				       buf, len);
113 }
114 
115 static ssize_t aqm_write(struct file *file,
116 			 const char __user *user_buf,
117 			 size_t count,
118 			 loff_t *ppos)
119 {
120 	struct ieee80211_local *local = file->private_data;
121 	char buf[100];
122 	size_t len;
123 
124 	if (count > sizeof(buf))
125 		return -EINVAL;
126 
127 	if (copy_from_user(buf, user_buf, count))
128 		return -EFAULT;
129 
130 	buf[sizeof(buf) - 1] = '\0';
131 	len = strlen(buf);
132 	if (len > 0 && buf[len-1] == '\n')
133 		buf[len-1] = 0;
134 
135 	if (sscanf(buf, "fq_limit %u", &local->fq.limit) == 1)
136 		return count;
137 	else if (sscanf(buf, "fq_memory_limit %u", &local->fq.memory_limit) == 1)
138 		return count;
139 	else if (sscanf(buf, "fq_quantum %u", &local->fq.quantum) == 1)
140 		return count;
141 
142 	return -EINVAL;
143 }
144 
145 static const struct file_operations aqm_ops = {
146 	.write = aqm_write,
147 	.read = aqm_read,
148 	.open = simple_open,
149 	.llseek = default_llseek,
150 };
151 
152 #ifdef CONFIG_PM
153 static ssize_t reset_write(struct file *file, const char __user *user_buf,
154 			   size_t count, loff_t *ppos)
155 {
156 	struct ieee80211_local *local = file->private_data;
157 
158 	rtnl_lock();
159 	__ieee80211_suspend(&local->hw, NULL);
160 	__ieee80211_resume(&local->hw);
161 	rtnl_unlock();
162 
163 	return count;
164 }
165 
166 static const struct file_operations reset_ops = {
167 	.write = reset_write,
168 	.open = simple_open,
169 	.llseek = noop_llseek,
170 };
171 #endif
172 
173 static const char *hw_flag_names[] = {
174 #define FLAG(F)	[IEEE80211_HW_##F] = #F
175 	FLAG(HAS_RATE_CONTROL),
176 	FLAG(RX_INCLUDES_FCS),
177 	FLAG(HOST_BROADCAST_PS_BUFFERING),
178 	FLAG(SIGNAL_UNSPEC),
179 	FLAG(SIGNAL_DBM),
180 	FLAG(NEED_DTIM_BEFORE_ASSOC),
181 	FLAG(SPECTRUM_MGMT),
182 	FLAG(AMPDU_AGGREGATION),
183 	FLAG(SUPPORTS_PS),
184 	FLAG(PS_NULLFUNC_STACK),
185 	FLAG(SUPPORTS_DYNAMIC_PS),
186 	FLAG(MFP_CAPABLE),
187 	FLAG(WANT_MONITOR_VIF),
188 	FLAG(NO_AUTO_VIF),
189 	FLAG(SW_CRYPTO_CONTROL),
190 	FLAG(SUPPORT_FAST_XMIT),
191 	FLAG(REPORTS_TX_ACK_STATUS),
192 	FLAG(CONNECTION_MONITOR),
193 	FLAG(QUEUE_CONTROL),
194 	FLAG(SUPPORTS_PER_STA_GTK),
195 	FLAG(AP_LINK_PS),
196 	FLAG(TX_AMPDU_SETUP_IN_HW),
197 	FLAG(SUPPORTS_RC_TABLE),
198 	FLAG(P2P_DEV_ADDR_FOR_INTF),
199 	FLAG(TIMING_BEACON_ONLY),
200 	FLAG(SUPPORTS_HT_CCK_RATES),
201 	FLAG(CHANCTX_STA_CSA),
202 	FLAG(SUPPORTS_CLONED_SKBS),
203 	FLAG(SINGLE_SCAN_ON_ALL_BANDS),
204 	FLAG(TDLS_WIDER_BW),
205 	FLAG(SUPPORTS_AMSDU_IN_AMPDU),
206 	FLAG(BEACON_TX_STATUS),
207 	FLAG(NEEDS_UNIQUE_STA_ADDR),
208 	FLAG(SUPPORTS_REORDERING_BUFFER),
209 	FLAG(USES_RSS),
210 	FLAG(TX_AMSDU),
211 	FLAG(TX_FRAG_LIST),
212 	FLAG(REPORTS_LOW_ACK),
213 	FLAG(SUPPORTS_TX_FRAG),
214 	FLAG(SUPPORTS_TDLS_BUFFER_STA),
215 	FLAG(DEAUTH_NEED_MGD_TX_PREP),
216 	FLAG(DOESNT_SUPPORT_QOS_NDP),
217 #undef FLAG
218 };
219 
220 static ssize_t hwflags_read(struct file *file, char __user *user_buf,
221 			    size_t count, loff_t *ppos)
222 {
223 	struct ieee80211_local *local = file->private_data;
224 	size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS;
225 	char *buf = kzalloc(bufsz, GFP_KERNEL);
226 	char *pos = buf, *end = buf + bufsz - 1;
227 	ssize_t rv;
228 	int i;
229 
230 	if (!buf)
231 		return -ENOMEM;
232 
233 	/* fail compilation if somebody adds or removes
234 	 * a flag without updating the name array above
235 	 */
236 	BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names) != NUM_IEEE80211_HW_FLAGS);
237 
238 	for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) {
239 		if (test_bit(i, local->hw.flags))
240 			pos += scnprintf(pos, end - pos, "%s\n",
241 					 hw_flag_names[i]);
242 	}
243 
244 	rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
245 	kfree(buf);
246 	return rv;
247 }
248 
249 static ssize_t misc_read(struct file *file, char __user *user_buf,
250 			 size_t count, loff_t *ppos)
251 {
252 	struct ieee80211_local *local = file->private_data;
253 	/* Max len of each line is 16 characters, plus 9 for 'pending:\n' */
254 	size_t bufsz = IEEE80211_MAX_QUEUES * 16 + 9;
255 	char *buf;
256 	char *pos, *end;
257 	ssize_t rv;
258 	int i;
259 	int ln;
260 
261 	buf = kzalloc(bufsz, GFP_KERNEL);
262 	if (!buf)
263 		return -ENOMEM;
264 
265 	pos = buf;
266 	end = buf + bufsz - 1;
267 
268 	pos += scnprintf(pos, end - pos, "pending:\n");
269 
270 	for (i = 0; i < IEEE80211_MAX_QUEUES; i++) {
271 		ln = skb_queue_len(&local->pending[i]);
272 		pos += scnprintf(pos, end - pos, "[%i] %d\n",
273 				 i, ln);
274 	}
275 
276 	rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
277 	kfree(buf);
278 	return rv;
279 }
280 
281 static ssize_t queues_read(struct file *file, char __user *user_buf,
282 			   size_t count, loff_t *ppos)
283 {
284 	struct ieee80211_local *local = file->private_data;
285 	unsigned long flags;
286 	char buf[IEEE80211_MAX_QUEUES * 20];
287 	int q, res = 0;
288 
289 	spin_lock_irqsave(&local->queue_stop_reason_lock, flags);
290 	for (q = 0; q < local->hw.queues; q++)
291 		res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q,
292 				local->queue_stop_reasons[q],
293 				skb_queue_len(&local->pending[q]));
294 	spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags);
295 
296 	return simple_read_from_buffer(user_buf, count, ppos, buf, res);
297 }
298 
299 DEBUGFS_READONLY_FILE_OPS(hwflags);
300 DEBUGFS_READONLY_FILE_OPS(queues);
301 DEBUGFS_READONLY_FILE_OPS(misc);
302 
303 /* statistics stuff */
304 
305 static ssize_t format_devstat_counter(struct ieee80211_local *local,
306 	char __user *userbuf,
307 	size_t count, loff_t *ppos,
308 	int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf,
309 			  int buflen))
310 {
311 	struct ieee80211_low_level_stats stats;
312 	char buf[20];
313 	int res;
314 
315 	rtnl_lock();
316 	res = drv_get_stats(local, &stats);
317 	rtnl_unlock();
318 	if (res)
319 		return res;
320 	res = printvalue(&stats, buf, sizeof(buf));
321 	return simple_read_from_buffer(userbuf, count, ppos, buf, res);
322 }
323 
324 #define DEBUGFS_DEVSTATS_FILE(name)					\
325 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\
326 				 char *buf, int buflen)			\
327 {									\
328 	return scnprintf(buf, buflen, "%u\n", stats->name);		\
329 }									\
330 static ssize_t stats_ ##name## _read(struct file *file,			\
331 				     char __user *userbuf,		\
332 				     size_t count, loff_t *ppos)	\
333 {									\
334 	return format_devstat_counter(file->private_data,		\
335 				      userbuf,				\
336 				      count,				\
337 				      ppos,				\
338 				      print_devstats_##name);		\
339 }									\
340 									\
341 static const struct file_operations stats_ ##name## _ops = {		\
342 	.read = stats_ ##name## _read,					\
343 	.open = simple_open,						\
344 	.llseek = generic_file_llseek,					\
345 };
346 
347 #define DEBUGFS_STATS_ADD(name)					\
348 	debugfs_create_u32(#name, 0400, statsd, &local->name);
349 #define DEBUGFS_DEVSTATS_ADD(name)					\
350 	debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops);
351 
352 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount);
353 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount);
354 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount);
355 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount);
356 
357 void debugfs_hw_add(struct ieee80211_local *local)
358 {
359 	struct dentry *phyd = local->hw.wiphy->debugfsdir;
360 	struct dentry *statsd;
361 
362 	if (!phyd)
363 		return;
364 
365 	local->debugfs.keys = debugfs_create_dir("keys", phyd);
366 
367 	DEBUGFS_ADD(total_ps_buffered);
368 	DEBUGFS_ADD(wep_iv);
369 	DEBUGFS_ADD(rate_ctrl_alg);
370 	DEBUGFS_ADD(queues);
371 	DEBUGFS_ADD(misc);
372 #ifdef CONFIG_PM
373 	DEBUGFS_ADD_MODE(reset, 0200);
374 #endif
375 	DEBUGFS_ADD(hwflags);
376 	DEBUGFS_ADD(user_power);
377 	DEBUGFS_ADD(power);
378 
379 	if (local->ops->wake_tx_queue)
380 		DEBUGFS_ADD_MODE(aqm, 0600);
381 
382 	statsd = debugfs_create_dir("statistics", phyd);
383 
384 	/* if the dir failed, don't put all the other things into the root! */
385 	if (!statsd)
386 		return;
387 
388 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
389 	DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount);
390 	DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount);
391 	DEBUGFS_STATS_ADD(dot11FailedCount);
392 	DEBUGFS_STATS_ADD(dot11RetryCount);
393 	DEBUGFS_STATS_ADD(dot11MultipleRetryCount);
394 	DEBUGFS_STATS_ADD(dot11FrameDuplicateCount);
395 	DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount);
396 	DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount);
397 	DEBUGFS_STATS_ADD(dot11TransmittedFrameCount);
398 	DEBUGFS_STATS_ADD(tx_handlers_drop);
399 	DEBUGFS_STATS_ADD(tx_handlers_queued);
400 	DEBUGFS_STATS_ADD(tx_handlers_drop_wep);
401 	DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc);
402 	DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port);
403 	DEBUGFS_STATS_ADD(rx_handlers_drop);
404 	DEBUGFS_STATS_ADD(rx_handlers_queued);
405 	DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc);
406 	DEBUGFS_STATS_ADD(rx_handlers_drop_defrag);
407 	DEBUGFS_STATS_ADD(tx_expand_skb_head);
408 	DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned);
409 	DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag);
410 	DEBUGFS_STATS_ADD(rx_handlers_fragments);
411 	DEBUGFS_STATS_ADD(tx_status_drop);
412 #endif
413 	DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount);
414 	DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount);
415 	DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount);
416 	DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount);
417 }
418