xref: /openbmc/linux/net/mac80211/debugfs.c (revision 8730046c)
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 #undef FLAG
215 };
216 
217 static ssize_t hwflags_read(struct file *file, char __user *user_buf,
218 			    size_t count, loff_t *ppos)
219 {
220 	struct ieee80211_local *local = file->private_data;
221 	size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS;
222 	char *buf = kzalloc(bufsz, GFP_KERNEL);
223 	char *pos = buf, *end = buf + bufsz - 1;
224 	ssize_t rv;
225 	int i;
226 
227 	if (!buf)
228 		return -ENOMEM;
229 
230 	/* fail compilation if somebody adds or removes
231 	 * a flag without updating the name array above
232 	 */
233 	BUILD_BUG_ON(ARRAY_SIZE(hw_flag_names) != NUM_IEEE80211_HW_FLAGS);
234 
235 	for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) {
236 		if (test_bit(i, local->hw.flags))
237 			pos += scnprintf(pos, end - pos, "%s\n",
238 					 hw_flag_names[i]);
239 	}
240 
241 	rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
242 	kfree(buf);
243 	return rv;
244 }
245 
246 static ssize_t queues_read(struct file *file, char __user *user_buf,
247 			   size_t count, loff_t *ppos)
248 {
249 	struct ieee80211_local *local = file->private_data;
250 	unsigned long flags;
251 	char buf[IEEE80211_MAX_QUEUES * 20];
252 	int q, res = 0;
253 
254 	spin_lock_irqsave(&local->queue_stop_reason_lock, flags);
255 	for (q = 0; q < local->hw.queues; q++)
256 		res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q,
257 				local->queue_stop_reasons[q],
258 				skb_queue_len(&local->pending[q]));
259 	spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags);
260 
261 	return simple_read_from_buffer(user_buf, count, ppos, buf, res);
262 }
263 
264 DEBUGFS_READONLY_FILE_OPS(hwflags);
265 DEBUGFS_READONLY_FILE_OPS(queues);
266 
267 /* statistics stuff */
268 
269 static ssize_t format_devstat_counter(struct ieee80211_local *local,
270 	char __user *userbuf,
271 	size_t count, loff_t *ppos,
272 	int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf,
273 			  int buflen))
274 {
275 	struct ieee80211_low_level_stats stats;
276 	char buf[20];
277 	int res;
278 
279 	rtnl_lock();
280 	res = drv_get_stats(local, &stats);
281 	rtnl_unlock();
282 	if (res)
283 		return res;
284 	res = printvalue(&stats, buf, sizeof(buf));
285 	return simple_read_from_buffer(userbuf, count, ppos, buf, res);
286 }
287 
288 #define DEBUGFS_DEVSTATS_FILE(name)					\
289 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\
290 				 char *buf, int buflen)			\
291 {									\
292 	return scnprintf(buf, buflen, "%u\n", stats->name);		\
293 }									\
294 static ssize_t stats_ ##name## _read(struct file *file,			\
295 				     char __user *userbuf,		\
296 				     size_t count, loff_t *ppos)	\
297 {									\
298 	return format_devstat_counter(file->private_data,		\
299 				      userbuf,				\
300 				      count,				\
301 				      ppos,				\
302 				      print_devstats_##name);		\
303 }									\
304 									\
305 static const struct file_operations stats_ ##name## _ops = {		\
306 	.read = stats_ ##name## _read,					\
307 	.open = simple_open,						\
308 	.llseek = generic_file_llseek,					\
309 };
310 
311 #define DEBUGFS_STATS_ADD(name)					\
312 	debugfs_create_u32(#name, 0400, statsd, &local->name);
313 #define DEBUGFS_DEVSTATS_ADD(name)					\
314 	debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops);
315 
316 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount);
317 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount);
318 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount);
319 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount);
320 
321 void debugfs_hw_add(struct ieee80211_local *local)
322 {
323 	struct dentry *phyd = local->hw.wiphy->debugfsdir;
324 	struct dentry *statsd;
325 
326 	if (!phyd)
327 		return;
328 
329 	local->debugfs.keys = debugfs_create_dir("keys", phyd);
330 
331 	DEBUGFS_ADD(total_ps_buffered);
332 	DEBUGFS_ADD(wep_iv);
333 	DEBUGFS_ADD(queues);
334 #ifdef CONFIG_PM
335 	DEBUGFS_ADD_MODE(reset, 0200);
336 #endif
337 	DEBUGFS_ADD(hwflags);
338 	DEBUGFS_ADD(user_power);
339 	DEBUGFS_ADD(power);
340 
341 	if (local->ops->wake_tx_queue)
342 		DEBUGFS_ADD_MODE(aqm, 0600);
343 
344 	statsd = debugfs_create_dir("statistics", phyd);
345 
346 	/* if the dir failed, don't put all the other things into the root! */
347 	if (!statsd)
348 		return;
349 
350 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
351 	DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount);
352 	DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount);
353 	DEBUGFS_STATS_ADD(dot11FailedCount);
354 	DEBUGFS_STATS_ADD(dot11RetryCount);
355 	DEBUGFS_STATS_ADD(dot11MultipleRetryCount);
356 	DEBUGFS_STATS_ADD(dot11FrameDuplicateCount);
357 	DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount);
358 	DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount);
359 	DEBUGFS_STATS_ADD(dot11TransmittedFrameCount);
360 	DEBUGFS_STATS_ADD(tx_handlers_drop);
361 	DEBUGFS_STATS_ADD(tx_handlers_queued);
362 	DEBUGFS_STATS_ADD(tx_handlers_drop_wep);
363 	DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc);
364 	DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port);
365 	DEBUGFS_STATS_ADD(rx_handlers_drop);
366 	DEBUGFS_STATS_ADD(rx_handlers_queued);
367 	DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc);
368 	DEBUGFS_STATS_ADD(rx_handlers_drop_defrag);
369 	DEBUGFS_STATS_ADD(tx_expand_skb_head);
370 	DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned);
371 	DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag);
372 	DEBUGFS_STATS_ADD(rx_handlers_fragments);
373 	DEBUGFS_STATS_ADD(tx_status_drop);
374 #endif
375 	DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount);
376 	DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount);
377 	DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount);
378 	DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount);
379 }
380