xref: /linux/net/mac80211/debugfs.c (revision 7eb7404f7ee4bf59cb034897ab678aba2755c5e0)
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 "ieee80211_i.h"
14 #include "driver-ops.h"
15 #include "rate.h"
16 #include "debugfs.h"
17 
18 #define DEBUGFS_FORMAT_BUFFER_SIZE 100
19 
20 int mac80211_format_buffer(char __user *userbuf, size_t count,
21 				  loff_t *ppos, char *fmt, ...)
22 {
23 	va_list args;
24 	char buf[DEBUGFS_FORMAT_BUFFER_SIZE];
25 	int res;
26 
27 	va_start(args, fmt);
28 	res = vscnprintf(buf, sizeof(buf), fmt, args);
29 	va_end(args);
30 
31 	return simple_read_from_buffer(userbuf, count, ppos, buf, res);
32 }
33 
34 #define DEBUGFS_READONLY_FILE_FN(name, fmt, value...)			\
35 static ssize_t name## _read(struct file *file, char __user *userbuf,	\
36 			    size_t count, loff_t *ppos)			\
37 {									\
38 	struct ieee80211_local *local = file->private_data;		\
39 									\
40 	return mac80211_format_buffer(userbuf, count, ppos, 		\
41 				      fmt "\n", ##value);		\
42 }
43 
44 #define DEBUGFS_READONLY_FILE_OPS(name)			\
45 static const struct file_operations name## _ops = {			\
46 	.read = name## _read,						\
47 	.open = simple_open,						\
48 	.llseek = generic_file_llseek,					\
49 };
50 
51 #define DEBUGFS_READONLY_FILE(name, fmt, value...)		\
52 	DEBUGFS_READONLY_FILE_FN(name, fmt, value)		\
53 	DEBUGFS_READONLY_FILE_OPS(name)
54 
55 #define DEBUGFS_ADD(name)						\
56 	debugfs_create_file(#name, 0400, phyd, local, &name## _ops);
57 
58 #define DEBUGFS_ADD_MODE(name, mode)					\
59 	debugfs_create_file(#name, mode, phyd, local, &name## _ops);
60 
61 
62 DEBUGFS_READONLY_FILE(user_power, "%d",
63 		      local->user_power_level);
64 DEBUGFS_READONLY_FILE(power, "%d",
65 		      local->hw.conf.power_level);
66 DEBUGFS_READONLY_FILE(total_ps_buffered, "%d",
67 		      local->total_ps_buffered);
68 DEBUGFS_READONLY_FILE(wep_iv, "%#08x",
69 		      local->wep_iv & 0xffffff);
70 DEBUGFS_READONLY_FILE(rate_ctrl_alg, "%s",
71 	local->rate_ctrl ? local->rate_ctrl->ops->name : "hw/driver");
72 
73 #ifdef CONFIG_PM
74 static ssize_t reset_write(struct file *file, const char __user *user_buf,
75 			   size_t count, loff_t *ppos)
76 {
77 	struct ieee80211_local *local = file->private_data;
78 
79 	rtnl_lock();
80 	__ieee80211_suspend(&local->hw, NULL);
81 	__ieee80211_resume(&local->hw);
82 	rtnl_unlock();
83 
84 	return count;
85 }
86 
87 static const struct file_operations reset_ops = {
88 	.write = reset_write,
89 	.open = simple_open,
90 	.llseek = noop_llseek,
91 };
92 #endif
93 
94 static const char *hw_flag_names[NUM_IEEE80211_HW_FLAGS + 1] = {
95 #define FLAG(F)	[IEEE80211_HW_##F] = #F
96 	FLAG(HAS_RATE_CONTROL),
97 	FLAG(RX_INCLUDES_FCS),
98 	FLAG(HOST_BROADCAST_PS_BUFFERING),
99 	FLAG(SIGNAL_UNSPEC),
100 	FLAG(SIGNAL_DBM),
101 	FLAG(NEED_DTIM_BEFORE_ASSOC),
102 	FLAG(SPECTRUM_MGMT),
103 	FLAG(AMPDU_AGGREGATION),
104 	FLAG(SUPPORTS_PS),
105 	FLAG(PS_NULLFUNC_STACK),
106 	FLAG(SUPPORTS_DYNAMIC_PS),
107 	FLAG(MFP_CAPABLE),
108 	FLAG(WANT_MONITOR_VIF),
109 	FLAG(NO_AUTO_VIF),
110 	FLAG(SW_CRYPTO_CONTROL),
111 	FLAG(SUPPORT_FAST_XMIT),
112 	FLAG(REPORTS_TX_ACK_STATUS),
113 	FLAG(CONNECTION_MONITOR),
114 	FLAG(QUEUE_CONTROL),
115 	FLAG(SUPPORTS_PER_STA_GTK),
116 	FLAG(AP_LINK_PS),
117 	FLAG(TX_AMPDU_SETUP_IN_HW),
118 	FLAG(SUPPORTS_RC_TABLE),
119 	FLAG(P2P_DEV_ADDR_FOR_INTF),
120 	FLAG(TIMING_BEACON_ONLY),
121 	FLAG(SUPPORTS_HT_CCK_RATES),
122 	FLAG(CHANCTX_STA_CSA),
123 	FLAG(SUPPORTS_CLONED_SKBS),
124 	FLAG(SINGLE_SCAN_ON_ALL_BANDS),
125 	FLAG(TDLS_WIDER_BW),
126 	FLAG(SUPPORTS_AMSDU_IN_AMPDU),
127 	FLAG(BEACON_TX_STATUS),
128 	FLAG(NEEDS_UNIQUE_STA_ADDR),
129 
130 	/* keep last for the build bug below */
131 	(void *)0x1
132 #undef FLAG
133 };
134 
135 static ssize_t hwflags_read(struct file *file, char __user *user_buf,
136 			    size_t count, loff_t *ppos)
137 {
138 	struct ieee80211_local *local = file->private_data;
139 	size_t bufsz = 30 * NUM_IEEE80211_HW_FLAGS;
140 	char *buf = kzalloc(bufsz, GFP_KERNEL);
141 	char *pos = buf, *end = buf + bufsz - 1;
142 	ssize_t rv;
143 	int i;
144 
145 	if (!buf)
146 		return -ENOMEM;
147 
148 	/* fail compilation if somebody adds or removes
149 	 * a flag without updating the name array above
150 	 */
151 	BUILD_BUG_ON(hw_flag_names[NUM_IEEE80211_HW_FLAGS] != (void *)0x1);
152 
153 	for (i = 0; i < NUM_IEEE80211_HW_FLAGS; i++) {
154 		if (test_bit(i, local->hw.flags))
155 			pos += scnprintf(pos, end - pos, "%s\n",
156 					 hw_flag_names[i]);
157 	}
158 
159 	rv = simple_read_from_buffer(user_buf, count, ppos, buf, strlen(buf));
160 	kfree(buf);
161 	return rv;
162 }
163 
164 static ssize_t queues_read(struct file *file, char __user *user_buf,
165 			   size_t count, loff_t *ppos)
166 {
167 	struct ieee80211_local *local = file->private_data;
168 	unsigned long flags;
169 	char buf[IEEE80211_MAX_QUEUES * 20];
170 	int q, res = 0;
171 
172 	spin_lock_irqsave(&local->queue_stop_reason_lock, flags);
173 	for (q = 0; q < local->hw.queues; q++)
174 		res += sprintf(buf + res, "%02d: %#.8lx/%d\n", q,
175 				local->queue_stop_reasons[q],
176 				skb_queue_len(&local->pending[q]));
177 	spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags);
178 
179 	return simple_read_from_buffer(user_buf, count, ppos, buf, res);
180 }
181 
182 DEBUGFS_READONLY_FILE_OPS(hwflags);
183 DEBUGFS_READONLY_FILE_OPS(queues);
184 
185 /* statistics stuff */
186 
187 static ssize_t format_devstat_counter(struct ieee80211_local *local,
188 	char __user *userbuf,
189 	size_t count, loff_t *ppos,
190 	int (*printvalue)(struct ieee80211_low_level_stats *stats, char *buf,
191 			  int buflen))
192 {
193 	struct ieee80211_low_level_stats stats;
194 	char buf[20];
195 	int res;
196 
197 	rtnl_lock();
198 	res = drv_get_stats(local, &stats);
199 	rtnl_unlock();
200 	if (res)
201 		return res;
202 	res = printvalue(&stats, buf, sizeof(buf));
203 	return simple_read_from_buffer(userbuf, count, ppos, buf, res);
204 }
205 
206 #define DEBUGFS_DEVSTATS_FILE(name)					\
207 static int print_devstats_##name(struct ieee80211_low_level_stats *stats,\
208 				 char *buf, int buflen)			\
209 {									\
210 	return scnprintf(buf, buflen, "%u\n", stats->name);		\
211 }									\
212 static ssize_t stats_ ##name## _read(struct file *file,			\
213 				     char __user *userbuf,		\
214 				     size_t count, loff_t *ppos)	\
215 {									\
216 	return format_devstat_counter(file->private_data,		\
217 				      userbuf,				\
218 				      count,				\
219 				      ppos,				\
220 				      print_devstats_##name);		\
221 }									\
222 									\
223 static const struct file_operations stats_ ##name## _ops = {		\
224 	.read = stats_ ##name## _read,					\
225 	.open = simple_open,						\
226 	.llseek = generic_file_llseek,					\
227 };
228 
229 #define DEBUGFS_STATS_ADD(name)					\
230 	debugfs_create_u32(#name, 0400, statsd, &local->name);
231 #define DEBUGFS_DEVSTATS_ADD(name)					\
232 	debugfs_create_file(#name, 0400, statsd, local, &stats_ ##name## _ops);
233 
234 DEBUGFS_DEVSTATS_FILE(dot11ACKFailureCount);
235 DEBUGFS_DEVSTATS_FILE(dot11RTSFailureCount);
236 DEBUGFS_DEVSTATS_FILE(dot11FCSErrorCount);
237 DEBUGFS_DEVSTATS_FILE(dot11RTSSuccessCount);
238 
239 void debugfs_hw_add(struct ieee80211_local *local)
240 {
241 	struct dentry *phyd = local->hw.wiphy->debugfsdir;
242 	struct dentry *statsd;
243 
244 	if (!phyd)
245 		return;
246 
247 	local->debugfs.keys = debugfs_create_dir("keys", phyd);
248 
249 	DEBUGFS_ADD(total_ps_buffered);
250 	DEBUGFS_ADD(wep_iv);
251 	DEBUGFS_ADD(queues);
252 #ifdef CONFIG_PM
253 	DEBUGFS_ADD_MODE(reset, 0200);
254 #endif
255 	DEBUGFS_ADD(hwflags);
256 	DEBUGFS_ADD(user_power);
257 	DEBUGFS_ADD(power);
258 
259 	statsd = debugfs_create_dir("statistics", phyd);
260 
261 	/* if the dir failed, don't put all the other things into the root! */
262 	if (!statsd)
263 		return;
264 
265 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
266 	DEBUGFS_STATS_ADD(dot11TransmittedFragmentCount);
267 	DEBUGFS_STATS_ADD(dot11MulticastTransmittedFrameCount);
268 	DEBUGFS_STATS_ADD(dot11FailedCount);
269 	DEBUGFS_STATS_ADD(dot11RetryCount);
270 	DEBUGFS_STATS_ADD(dot11MultipleRetryCount);
271 	DEBUGFS_STATS_ADD(dot11FrameDuplicateCount);
272 	DEBUGFS_STATS_ADD(dot11ReceivedFragmentCount);
273 	DEBUGFS_STATS_ADD(dot11MulticastReceivedFrameCount);
274 	DEBUGFS_STATS_ADD(dot11TransmittedFrameCount);
275 	DEBUGFS_STATS_ADD(tx_handlers_drop);
276 	DEBUGFS_STATS_ADD(tx_handlers_queued);
277 	DEBUGFS_STATS_ADD(tx_handlers_drop_wep);
278 	DEBUGFS_STATS_ADD(tx_handlers_drop_not_assoc);
279 	DEBUGFS_STATS_ADD(tx_handlers_drop_unauth_port);
280 	DEBUGFS_STATS_ADD(rx_handlers_drop);
281 	DEBUGFS_STATS_ADD(rx_handlers_queued);
282 	DEBUGFS_STATS_ADD(rx_handlers_drop_nullfunc);
283 	DEBUGFS_STATS_ADD(rx_handlers_drop_defrag);
284 	DEBUGFS_STATS_ADD(tx_expand_skb_head);
285 	DEBUGFS_STATS_ADD(tx_expand_skb_head_cloned);
286 	DEBUGFS_STATS_ADD(rx_expand_skb_head_defrag);
287 	DEBUGFS_STATS_ADD(rx_handlers_fragments);
288 	DEBUGFS_STATS_ADD(tx_status_drop);
289 #endif
290 	DEBUGFS_DEVSTATS_ADD(dot11ACKFailureCount);
291 	DEBUGFS_DEVSTATS_ADD(dot11RTSFailureCount);
292 	DEBUGFS_DEVSTATS_ADD(dot11FCSErrorCount);
293 	DEBUGFS_DEVSTATS_ADD(dot11RTSSuccessCount);
294 }
295