xref: /linux/net/mac80211/debugfs_netdev.c (revision cb299ba8b5ef2239429484072fea394cd7581bd7)
1 /*
2  * Copyright (c) 2006	Jiri Benc <jbenc@suse.cz>
3  * Copyright 2007	Johannes Berg <johannes@sipsolutions.net>
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation.
8  */
9 
10 #include <linux/kernel.h>
11 #include <linux/device.h>
12 #include <linux/if.h>
13 #include <linux/interrupt.h>
14 #include <linux/netdevice.h>
15 #include <linux/rtnetlink.h>
16 #include <linux/slab.h>
17 #include <linux/notifier.h>
18 #include <net/mac80211.h>
19 #include <net/cfg80211.h>
20 #include "ieee80211_i.h"
21 #include "rate.h"
22 #include "debugfs.h"
23 #include "debugfs_netdev.h"
24 
25 static ssize_t ieee80211_if_read(
26 	struct ieee80211_sub_if_data *sdata,
27 	char __user *userbuf,
28 	size_t count, loff_t *ppos,
29 	ssize_t (*format)(const struct ieee80211_sub_if_data *, char *, int))
30 {
31 	char buf[70];
32 	ssize_t ret = -EINVAL;
33 
34 	read_lock(&dev_base_lock);
35 	if (sdata->dev->reg_state == NETREG_REGISTERED)
36 		ret = (*format)(sdata, buf, sizeof(buf));
37 	read_unlock(&dev_base_lock);
38 
39 	if (ret != -EINVAL)
40 		ret = simple_read_from_buffer(userbuf, count, ppos, buf, ret);
41 
42 	return ret;
43 }
44 
45 static ssize_t ieee80211_if_write(
46 	struct ieee80211_sub_if_data *sdata,
47 	const char __user *userbuf,
48 	size_t count, loff_t *ppos,
49 	ssize_t (*write)(struct ieee80211_sub_if_data *, const char *, int))
50 {
51 	u8 *buf;
52 	ssize_t ret;
53 
54 	buf = kmalloc(count, GFP_KERNEL);
55 	if (!buf)
56 		return -ENOMEM;
57 
58 	ret = -EFAULT;
59 	if (copy_from_user(buf, userbuf, count))
60 		goto freebuf;
61 
62 	ret = -ENODEV;
63 	rtnl_lock();
64 	if (sdata->dev->reg_state == NETREG_REGISTERED)
65 		ret = (*write)(sdata, buf, count);
66 	rtnl_unlock();
67 
68 freebuf:
69 	kfree(buf);
70 	return ret;
71 }
72 
73 #define IEEE80211_IF_FMT(name, field, format_string)			\
74 static ssize_t ieee80211_if_fmt_##name(					\
75 	const struct ieee80211_sub_if_data *sdata, char *buf,		\
76 	int buflen)							\
77 {									\
78 	return scnprintf(buf, buflen, format_string, sdata->field);	\
79 }
80 #define IEEE80211_IF_FMT_DEC(name, field)				\
81 		IEEE80211_IF_FMT(name, field, "%d\n")
82 #define IEEE80211_IF_FMT_HEX(name, field)				\
83 		IEEE80211_IF_FMT(name, field, "%#x\n")
84 #define IEEE80211_IF_FMT_SIZE(name, field)				\
85 		IEEE80211_IF_FMT(name, field, "%zd\n")
86 
87 #define IEEE80211_IF_FMT_ATOMIC(name, field)				\
88 static ssize_t ieee80211_if_fmt_##name(					\
89 	const struct ieee80211_sub_if_data *sdata,			\
90 	char *buf, int buflen)						\
91 {									\
92 	return scnprintf(buf, buflen, "%d\n", atomic_read(&sdata->field));\
93 }
94 
95 #define IEEE80211_IF_FMT_MAC(name, field)				\
96 static ssize_t ieee80211_if_fmt_##name(					\
97 	const struct ieee80211_sub_if_data *sdata, char *buf,		\
98 	int buflen)							\
99 {									\
100 	return scnprintf(buf, buflen, "%pM\n", sdata->field);		\
101 }
102 
103 #define IEEE80211_IF_FMT_DEC_DIV_16(name, field)			\
104 static ssize_t ieee80211_if_fmt_##name(					\
105 	const struct ieee80211_sub_if_data *sdata,			\
106 	char *buf, int buflen)						\
107 {									\
108 	return scnprintf(buf, buflen, "%d\n", sdata->field / 16);	\
109 }
110 
111 #define __IEEE80211_IF_FILE(name, _write)				\
112 static ssize_t ieee80211_if_read_##name(struct file *file,		\
113 					char __user *userbuf,		\
114 					size_t count, loff_t *ppos)	\
115 {									\
116 	return ieee80211_if_read(file->private_data,			\
117 				 userbuf, count, ppos,			\
118 				 ieee80211_if_fmt_##name);		\
119 }									\
120 static const struct file_operations name##_ops = {			\
121 	.read = ieee80211_if_read_##name,				\
122 	.write = (_write),						\
123 	.open = mac80211_open_file_generic,				\
124 	.llseek = generic_file_llseek,					\
125 }
126 
127 #define __IEEE80211_IF_FILE_W(name)					\
128 static ssize_t ieee80211_if_write_##name(struct file *file,		\
129 					 const char __user *userbuf,	\
130 					 size_t count, loff_t *ppos)	\
131 {									\
132 	return ieee80211_if_write(file->private_data, userbuf, count,	\
133 				  ppos, ieee80211_if_parse_##name);	\
134 }									\
135 __IEEE80211_IF_FILE(name, ieee80211_if_write_##name)
136 
137 
138 #define IEEE80211_IF_FILE(name, field, format)				\
139 		IEEE80211_IF_FMT_##format(name, field)			\
140 		__IEEE80211_IF_FILE(name, NULL)
141 
142 /* common attributes */
143 IEEE80211_IF_FILE(drop_unencrypted, drop_unencrypted, DEC);
144 IEEE80211_IF_FILE(rc_rateidx_mask_2ghz, rc_rateidx_mask[IEEE80211_BAND_2GHZ],
145 		  HEX);
146 IEEE80211_IF_FILE(rc_rateidx_mask_5ghz, rc_rateidx_mask[IEEE80211_BAND_5GHZ],
147 		  HEX);
148 
149 /* STA attributes */
150 IEEE80211_IF_FILE(bssid, u.mgd.bssid, MAC);
151 IEEE80211_IF_FILE(aid, u.mgd.aid, DEC);
152 IEEE80211_IF_FILE(last_beacon, u.mgd.last_beacon_signal, DEC);
153 IEEE80211_IF_FILE(ave_beacon, u.mgd.ave_beacon_signal, DEC_DIV_16);
154 
155 static int ieee80211_set_smps(struct ieee80211_sub_if_data *sdata,
156 			      enum ieee80211_smps_mode smps_mode)
157 {
158 	struct ieee80211_local *local = sdata->local;
159 	int err;
160 
161 	if (!(local->hw.flags & IEEE80211_HW_SUPPORTS_STATIC_SMPS) &&
162 	    smps_mode == IEEE80211_SMPS_STATIC)
163 		return -EINVAL;
164 
165 	/* auto should be dynamic if in PS mode */
166 	if (!(local->hw.flags & IEEE80211_HW_SUPPORTS_DYNAMIC_SMPS) &&
167 	    (smps_mode == IEEE80211_SMPS_DYNAMIC ||
168 	     smps_mode == IEEE80211_SMPS_AUTOMATIC))
169 		return -EINVAL;
170 
171 	/* supported only on managed interfaces for now */
172 	if (sdata->vif.type != NL80211_IFTYPE_STATION)
173 		return -EOPNOTSUPP;
174 
175 	mutex_lock(&local->iflist_mtx);
176 	err = __ieee80211_request_smps(sdata, smps_mode);
177 	mutex_unlock(&local->iflist_mtx);
178 
179 	return err;
180 }
181 
182 static const char *smps_modes[IEEE80211_SMPS_NUM_MODES] = {
183 	[IEEE80211_SMPS_AUTOMATIC] = "auto",
184 	[IEEE80211_SMPS_OFF] = "off",
185 	[IEEE80211_SMPS_STATIC] = "static",
186 	[IEEE80211_SMPS_DYNAMIC] = "dynamic",
187 };
188 
189 static ssize_t ieee80211_if_fmt_smps(const struct ieee80211_sub_if_data *sdata,
190 				     char *buf, int buflen)
191 {
192 	if (sdata->vif.type != NL80211_IFTYPE_STATION)
193 		return -EOPNOTSUPP;
194 
195 	return snprintf(buf, buflen, "request: %s\nused: %s\n",
196 			smps_modes[sdata->u.mgd.req_smps],
197 			smps_modes[sdata->u.mgd.ap_smps]);
198 }
199 
200 static ssize_t ieee80211_if_parse_smps(struct ieee80211_sub_if_data *sdata,
201 				       const char *buf, int buflen)
202 {
203 	enum ieee80211_smps_mode mode;
204 
205 	for (mode = 0; mode < IEEE80211_SMPS_NUM_MODES; mode++) {
206 		if (strncmp(buf, smps_modes[mode], buflen) == 0) {
207 			int err = ieee80211_set_smps(sdata, mode);
208 			if (!err)
209 				return buflen;
210 			return err;
211 		}
212 	}
213 
214 	return -EINVAL;
215 }
216 
217 __IEEE80211_IF_FILE_W(smps);
218 
219 /* AP attributes */
220 IEEE80211_IF_FILE(num_sta_ps, u.ap.num_sta_ps, ATOMIC);
221 IEEE80211_IF_FILE(dtim_count, u.ap.dtim_count, DEC);
222 
223 static ssize_t ieee80211_if_fmt_num_buffered_multicast(
224 	const struct ieee80211_sub_if_data *sdata, char *buf, int buflen)
225 {
226 	return scnprintf(buf, buflen, "%u\n",
227 			 skb_queue_len(&sdata->u.ap.ps_bc_buf));
228 }
229 __IEEE80211_IF_FILE(num_buffered_multicast, NULL);
230 
231 /* WDS attributes */
232 IEEE80211_IF_FILE(peer, u.wds.remote_addr, MAC);
233 
234 #ifdef CONFIG_MAC80211_MESH
235 /* Mesh stats attributes */
236 IEEE80211_IF_FILE(fwded_mcast, u.mesh.mshstats.fwded_mcast, DEC);
237 IEEE80211_IF_FILE(fwded_unicast, u.mesh.mshstats.fwded_unicast, DEC);
238 IEEE80211_IF_FILE(fwded_frames, u.mesh.mshstats.fwded_frames, DEC);
239 IEEE80211_IF_FILE(dropped_frames_ttl, u.mesh.mshstats.dropped_frames_ttl, DEC);
240 IEEE80211_IF_FILE(dropped_frames_no_route,
241 		u.mesh.mshstats.dropped_frames_no_route, DEC);
242 IEEE80211_IF_FILE(estab_plinks, u.mesh.mshstats.estab_plinks, ATOMIC);
243 
244 /* Mesh parameters */
245 IEEE80211_IF_FILE(dot11MeshMaxRetries,
246 		u.mesh.mshcfg.dot11MeshMaxRetries, DEC);
247 IEEE80211_IF_FILE(dot11MeshRetryTimeout,
248 		u.mesh.mshcfg.dot11MeshRetryTimeout, DEC);
249 IEEE80211_IF_FILE(dot11MeshConfirmTimeout,
250 		u.mesh.mshcfg.dot11MeshConfirmTimeout, DEC);
251 IEEE80211_IF_FILE(dot11MeshHoldingTimeout,
252 		u.mesh.mshcfg.dot11MeshHoldingTimeout, DEC);
253 IEEE80211_IF_FILE(dot11MeshTTL, u.mesh.mshcfg.dot11MeshTTL, DEC);
254 IEEE80211_IF_FILE(auto_open_plinks, u.mesh.mshcfg.auto_open_plinks, DEC);
255 IEEE80211_IF_FILE(dot11MeshMaxPeerLinks,
256 		u.mesh.mshcfg.dot11MeshMaxPeerLinks, DEC);
257 IEEE80211_IF_FILE(dot11MeshHWMPactivePathTimeout,
258 		u.mesh.mshcfg.dot11MeshHWMPactivePathTimeout, DEC);
259 IEEE80211_IF_FILE(dot11MeshHWMPpreqMinInterval,
260 		u.mesh.mshcfg.dot11MeshHWMPpreqMinInterval, DEC);
261 IEEE80211_IF_FILE(dot11MeshHWMPnetDiameterTraversalTime,
262 		u.mesh.mshcfg.dot11MeshHWMPnetDiameterTraversalTime, DEC);
263 IEEE80211_IF_FILE(dot11MeshHWMPmaxPREQretries,
264 		u.mesh.mshcfg.dot11MeshHWMPmaxPREQretries, DEC);
265 IEEE80211_IF_FILE(path_refresh_time,
266 		u.mesh.mshcfg.path_refresh_time, DEC);
267 IEEE80211_IF_FILE(min_discovery_timeout,
268 		u.mesh.mshcfg.min_discovery_timeout, DEC);
269 IEEE80211_IF_FILE(dot11MeshHWMPRootMode,
270 		u.mesh.mshcfg.dot11MeshHWMPRootMode, DEC);
271 #endif
272 
273 
274 #define DEBUGFS_ADD(name) \
275 	debugfs_create_file(#name, 0400, sdata->debugfs.dir, \
276 			    sdata, &name##_ops);
277 
278 #define DEBUGFS_ADD_MODE(name, mode) \
279 	debugfs_create_file(#name, mode, sdata->debugfs.dir, \
280 			    sdata, &name##_ops);
281 
282 static void add_sta_files(struct ieee80211_sub_if_data *sdata)
283 {
284 	DEBUGFS_ADD(drop_unencrypted);
285 	DEBUGFS_ADD(rc_rateidx_mask_2ghz);
286 	DEBUGFS_ADD(rc_rateidx_mask_5ghz);
287 
288 	DEBUGFS_ADD(bssid);
289 	DEBUGFS_ADD(aid);
290 	DEBUGFS_ADD(last_beacon);
291 	DEBUGFS_ADD(ave_beacon);
292 	DEBUGFS_ADD_MODE(smps, 0600);
293 }
294 
295 static void add_ap_files(struct ieee80211_sub_if_data *sdata)
296 {
297 	DEBUGFS_ADD(drop_unencrypted);
298 	DEBUGFS_ADD(rc_rateidx_mask_2ghz);
299 	DEBUGFS_ADD(rc_rateidx_mask_5ghz);
300 
301 	DEBUGFS_ADD(num_sta_ps);
302 	DEBUGFS_ADD(dtim_count);
303 	DEBUGFS_ADD(num_buffered_multicast);
304 }
305 
306 static void add_wds_files(struct ieee80211_sub_if_data *sdata)
307 {
308 	DEBUGFS_ADD(drop_unencrypted);
309 	DEBUGFS_ADD(rc_rateidx_mask_2ghz);
310 	DEBUGFS_ADD(rc_rateidx_mask_5ghz);
311 
312 	DEBUGFS_ADD(peer);
313 }
314 
315 static void add_vlan_files(struct ieee80211_sub_if_data *sdata)
316 {
317 	DEBUGFS_ADD(drop_unencrypted);
318 	DEBUGFS_ADD(rc_rateidx_mask_2ghz);
319 	DEBUGFS_ADD(rc_rateidx_mask_5ghz);
320 }
321 
322 static void add_monitor_files(struct ieee80211_sub_if_data *sdata)
323 {
324 }
325 
326 #ifdef CONFIG_MAC80211_MESH
327 
328 static void add_mesh_stats(struct ieee80211_sub_if_data *sdata)
329 {
330 	struct dentry *dir = debugfs_create_dir("mesh_stats",
331 						sdata->debugfs.dir);
332 
333 #define MESHSTATS_ADD(name)\
334 	debugfs_create_file(#name, 0400, dir, sdata, &name##_ops);
335 
336 	MESHSTATS_ADD(fwded_mcast);
337 	MESHSTATS_ADD(fwded_unicast);
338 	MESHSTATS_ADD(fwded_frames);
339 	MESHSTATS_ADD(dropped_frames_ttl);
340 	MESHSTATS_ADD(dropped_frames_no_route);
341 	MESHSTATS_ADD(estab_plinks);
342 #undef MESHSTATS_ADD
343 }
344 
345 static void add_mesh_config(struct ieee80211_sub_if_data *sdata)
346 {
347 	struct dentry *dir = debugfs_create_dir("mesh_config",
348 						sdata->debugfs.dir);
349 
350 #define MESHPARAMS_ADD(name) \
351 	debugfs_create_file(#name, 0600, dir, sdata, &name##_ops);
352 
353 	MESHPARAMS_ADD(dot11MeshMaxRetries);
354 	MESHPARAMS_ADD(dot11MeshRetryTimeout);
355 	MESHPARAMS_ADD(dot11MeshConfirmTimeout);
356 	MESHPARAMS_ADD(dot11MeshHoldingTimeout);
357 	MESHPARAMS_ADD(dot11MeshTTL);
358 	MESHPARAMS_ADD(auto_open_plinks);
359 	MESHPARAMS_ADD(dot11MeshMaxPeerLinks);
360 	MESHPARAMS_ADD(dot11MeshHWMPactivePathTimeout);
361 	MESHPARAMS_ADD(dot11MeshHWMPpreqMinInterval);
362 	MESHPARAMS_ADD(dot11MeshHWMPnetDiameterTraversalTime);
363 	MESHPARAMS_ADD(dot11MeshHWMPmaxPREQretries);
364 	MESHPARAMS_ADD(path_refresh_time);
365 	MESHPARAMS_ADD(min_discovery_timeout);
366 
367 #undef MESHPARAMS_ADD
368 }
369 #endif
370 
371 static void add_files(struct ieee80211_sub_if_data *sdata)
372 {
373 	if (!sdata->debugfs.dir)
374 		return;
375 
376 	switch (sdata->vif.type) {
377 	case NL80211_IFTYPE_MESH_POINT:
378 #ifdef CONFIG_MAC80211_MESH
379 		add_mesh_stats(sdata);
380 		add_mesh_config(sdata);
381 #endif
382 		break;
383 	case NL80211_IFTYPE_STATION:
384 		add_sta_files(sdata);
385 		break;
386 	case NL80211_IFTYPE_ADHOC:
387 		/* XXX */
388 		break;
389 	case NL80211_IFTYPE_AP:
390 		add_ap_files(sdata);
391 		break;
392 	case NL80211_IFTYPE_WDS:
393 		add_wds_files(sdata);
394 		break;
395 	case NL80211_IFTYPE_MONITOR:
396 		add_monitor_files(sdata);
397 		break;
398 	case NL80211_IFTYPE_AP_VLAN:
399 		add_vlan_files(sdata);
400 		break;
401 	default:
402 		break;
403 	}
404 }
405 
406 void ieee80211_debugfs_add_netdev(struct ieee80211_sub_if_data *sdata)
407 {
408 	char buf[10+IFNAMSIZ];
409 
410 	sprintf(buf, "netdev:%s", sdata->name);
411 	sdata->debugfs.dir = debugfs_create_dir(buf,
412 		sdata->local->hw.wiphy->debugfsdir);
413 	if (sdata->debugfs.dir)
414 		sdata->debugfs.subdir_stations = debugfs_create_dir("stations",
415 			sdata->debugfs.dir);
416 	add_files(sdata);
417 }
418 
419 void ieee80211_debugfs_remove_netdev(struct ieee80211_sub_if_data *sdata)
420 {
421 	if (!sdata->debugfs.dir)
422 		return;
423 
424 	debugfs_remove_recursive(sdata->debugfs.dir);
425 	sdata->debugfs.dir = NULL;
426 }
427 
428 void ieee80211_debugfs_rename_netdev(struct ieee80211_sub_if_data *sdata)
429 {
430 	struct dentry *dir;
431 	char buf[10 + IFNAMSIZ];
432 
433 	dir = sdata->debugfs.dir;
434 
435 	if (!dir)
436 		return;
437 
438 	sprintf(buf, "netdev:%s", sdata->name);
439 	if (!debugfs_rename(dir->d_parent, dir, dir->d_parent, buf))
440 		printk(KERN_ERR "mac80211: debugfs: failed to rename debugfs "
441 		       "dir to %s\n", buf);
442 }
443