3 * Initialization, addition and removal of wimax devices
6 * Copyright (C) 2005-2006 Intel Corporation <linux-wimax@intel.com>
7 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License version
11 * 2 as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
26 * - basic life cycle of 'struct wimax_dev' [wimax_dev_*()]; on
27 * addition/registration initialize all subfields and allocate
28 * generic netlink resources for user space communication. On
29 * removal/unregistration, undo all that.
31 * - device state machine [wimax_state_change()] and support to send
32 * reports to user space when the state changes
33 * [wimax_gnl_re_state_change*()].
35 * See include/net/wimax.h for rationales and design.
39 * [__]wimax_state_change() Called by drivers to update device's state
40 * wimax_gnl_re_state_change_alloc()
41 * wimax_gnl_re_state_change_send()
43 * wimax_dev_init() Init a device
44 * wimax_dev_add() Register
46 * wimax_gnl_add() Register all the generic netlink resources.
47 * wimax_id_table_add()
48 * wimax_dev_rm() Unregister
53 #include <linux/device.h>
54 #include <net/genetlink.h>
55 #include <linux/netdevice.h>
56 #include <linux/wimax.h>
57 #include "wimax-internal.h"
60 #define D_SUBMODULE stack
61 #include "debug-levels.h"
64 * Authoritative source for the RE_STATE_CHANGE attribute policy
66 * We don't really use it here, but /me likes to keep the definition
67 * close to where the data is generated.
71 struct nla_policy wimax_gnl_re_status_change[WIMAX_GNL_ATTR_MAX + 1] = {
72 [WIMAX_GNL_STCH_STATE_OLD] = { .type = NLA_U8 },
73 [WIMAX_GNL_STCH_STATE_NEW] = { .type = NLA_U8 },
79 * Allocate a Report State Change message
81 * @header: save it, you need it for _send()
83 * Creates and fills a basic state change message; different code
84 * paths can then add more attributes to the message as needed.
86 * Use wimax_gnl_re_state_change_send() to send the returned skb.
88 * Returns: skb with the genl message if ok, IS_ERR() ptr on error
92 struct sk_buff *wimax_gnl_re_state_change_alloc(
93 struct wimax_dev *wimax_dev,
94 enum wimax_st new_state, enum wimax_st old_state,
98 struct device *dev = wimax_dev_to_dev(wimax_dev);
100 struct sk_buff *report_skb;
102 d_fnstart(3, dev, "(wimax_dev %p new_state %u old_state %u)\n",
103 wimax_dev, new_state, old_state);
105 report_skb = nlmsg_new(NLMSG_DEFAULT_SIZE, GFP_KERNEL);
106 if (report_skb == NULL) {
107 dev_err(dev, "RE_STCH: can't create message\n");
110 data = genlmsg_put(report_skb, 0, wimax_gnl_mcg.id, &wimax_gnl_family,
111 0, WIMAX_GNL_RE_STATE_CHANGE);
113 dev_err(dev, "RE_STCH: can't put data into message\n");
118 result = nla_put_u8(report_skb, WIMAX_GNL_STCH_STATE_OLD, old_state);
120 dev_err(dev, "RE_STCH: Error adding OLD attr: %d\n", result);
123 result = nla_put_u8(report_skb, WIMAX_GNL_STCH_STATE_NEW, new_state);
125 dev_err(dev, "RE_STCH: Error adding NEW attr: %d\n", result);
128 result = nla_put_u32(report_skb, WIMAX_GNL_STCH_IFIDX,
129 wimax_dev->net_dev->ifindex);
131 dev_err(dev, "RE_STCH: Error adding IFINDEX attribute\n");
134 d_fnend(3, dev, "(wimax_dev %p new_state %u old_state %u) = %p\n",
135 wimax_dev, new_state, old_state, report_skb);
139 nlmsg_free(report_skb);
141 d_fnend(3, dev, "(wimax_dev %p new_state %u old_state %u) = %d\n",
142 wimax_dev, new_state, old_state, result);
143 return ERR_PTR(result);
148 * Send a Report State Change message (as created with _alloc).
150 * @report_skb: as returned by wimax_gnl_re_state_change_alloc()
151 * @header: as returned by wimax_gnl_re_state_change_alloc()
153 * Returns: 0 if ok, < 0 errno code on error.
155 * If the message is NULL, pretend it didn't happen.
158 int wimax_gnl_re_state_change_send(
159 struct wimax_dev *wimax_dev, struct sk_buff *report_skb,
163 struct device *dev = wimax_dev_to_dev(wimax_dev);
164 d_fnstart(3, dev, "(wimax_dev %p report_skb %p)\n",
165 wimax_dev, report_skb);
166 if (report_skb == NULL) {
170 genlmsg_end(report_skb, header);
171 genlmsg_multicast(report_skb, 0, wimax_gnl_mcg.id, GFP_KERNEL);
173 d_fnend(3, dev, "(wimax_dev %p report_skb %p) = %d\n",
174 wimax_dev, report_skb, result);
180 void __check_new_state(enum wimax_st old_state, enum wimax_st new_state,
181 unsigned allowed_states_bm)
183 if (WARN_ON(((1 << new_state) & allowed_states_bm) == 0)) {
184 printk(KERN_ERR "SW BUG! Forbidden state change %u -> %u\n",
185 old_state, new_state);
191 * Set the current state of a WiMAX device [unlocking version of
192 * wimax_state_change().
194 void __wimax_state_change(struct wimax_dev *wimax_dev, enum wimax_st new_state)
196 struct device *dev = wimax_dev_to_dev(wimax_dev);
197 enum wimax_st old_state = wimax_dev->state;
198 struct sk_buff *stch_skb;
201 d_fnstart(3, dev, "(wimax_dev %p new_state %u [old %u])\n",
202 wimax_dev, new_state, old_state);
204 if (WARN_ON(new_state >= __WIMAX_ST_INVALID)) {
205 dev_err(dev, "SW BUG: requesting invalid state %u\n",
209 if (old_state == new_state)
211 header = NULL; /* gcc complains? can't grok why */
212 stch_skb = wimax_gnl_re_state_change_alloc(
213 wimax_dev, new_state, old_state, &header);
215 /* Verify the state transition and do exit-from-state actions */
217 case __WIMAX_ST_NULL:
218 __check_new_state(old_state, new_state,
222 __check_new_state(old_state, new_state,
223 1 << __WIMAX_ST_QUIESCING
224 | 1 << WIMAX_ST_UNINITIALIZED
225 | 1 << WIMAX_ST_RADIO_OFF);
227 case __WIMAX_ST_QUIESCING:
228 __check_new_state(old_state, new_state, 1 << WIMAX_ST_DOWN);
230 case WIMAX_ST_UNINITIALIZED:
231 __check_new_state(old_state, new_state,
232 1 << __WIMAX_ST_QUIESCING
233 | 1 << WIMAX_ST_RADIO_OFF);
235 case WIMAX_ST_RADIO_OFF:
236 __check_new_state(old_state, new_state,
237 1 << __WIMAX_ST_QUIESCING
238 | 1 << WIMAX_ST_READY);
241 __check_new_state(old_state, new_state,
242 1 << __WIMAX_ST_QUIESCING
243 | 1 << WIMAX_ST_RADIO_OFF
244 | 1 << WIMAX_ST_SCANNING
245 | 1 << WIMAX_ST_CONNECTING
246 | 1 << WIMAX_ST_CONNECTED);
248 case WIMAX_ST_SCANNING:
249 __check_new_state(old_state, new_state,
250 1 << __WIMAX_ST_QUIESCING
251 | 1 << WIMAX_ST_RADIO_OFF
252 | 1 << WIMAX_ST_READY
253 | 1 << WIMAX_ST_CONNECTING
254 | 1 << WIMAX_ST_CONNECTED);
256 case WIMAX_ST_CONNECTING:
257 __check_new_state(old_state, new_state,
258 1 << __WIMAX_ST_QUIESCING
259 | 1 << WIMAX_ST_RADIO_OFF
260 | 1 << WIMAX_ST_READY
261 | 1 << WIMAX_ST_SCANNING
262 | 1 << WIMAX_ST_CONNECTED);
264 case WIMAX_ST_CONNECTED:
265 __check_new_state(old_state, new_state,
266 1 << __WIMAX_ST_QUIESCING
267 | 1 << WIMAX_ST_RADIO_OFF
268 | 1 << WIMAX_ST_READY);
269 netif_tx_disable(wimax_dev->net_dev);
270 netif_carrier_off(wimax_dev->net_dev);
272 case __WIMAX_ST_INVALID:
274 dev_err(dev, "SW BUG: wimax_dev %p is in unknown state %u\n",
275 wimax_dev, wimax_dev->state);
280 /* Execute the actions of entry to the new state */
282 case __WIMAX_ST_NULL:
283 dev_err(dev, "SW BUG: wimax_dev %p entering NULL state "
284 "from %u\n", wimax_dev, wimax_dev->state);
285 WARN_ON(1); /* Nobody can enter this state */
289 case __WIMAX_ST_QUIESCING:
291 case WIMAX_ST_UNINITIALIZED:
293 case WIMAX_ST_RADIO_OFF:
297 case WIMAX_ST_SCANNING:
299 case WIMAX_ST_CONNECTING:
301 case WIMAX_ST_CONNECTED:
302 netif_carrier_on(wimax_dev->net_dev);
303 netif_wake_queue(wimax_dev->net_dev);
305 case __WIMAX_ST_INVALID:
309 __wimax_state_set(wimax_dev, new_state);
311 wimax_gnl_re_state_change_send(wimax_dev, stch_skb, header);
313 d_fnend(3, dev, "(wimax_dev %p new_state %u [old %u]) = void\n",
314 wimax_dev, new_state, old_state);
320 * wimax_state_change - Set the current state of a WiMAX device
322 * @wimax_dev: WiMAX device descriptor (properly referenced)
323 * @new_state: New state to switch to
325 * This implements the state changes for the wimax devices. It will
327 * - verify that the state transition is legal (for now it'll just
328 * print a warning if not) according to the table in
329 * linux/wimax.h's documentation for 'enum wimax_st'.
331 * - perform the actions needed for leaving the current state and
332 * whichever are needed for entering the new state.
334 * - issue a report to user space indicating the new state (and an
335 * optional payload with information about the new state).
337 * NOTE: @wimax_dev must be locked
339 void wimax_state_change(struct wimax_dev *wimax_dev, enum wimax_st new_state)
341 mutex_lock(&wimax_dev->mutex);
342 __wimax_state_change(wimax_dev, new_state);
343 mutex_unlock(&wimax_dev->mutex);
346 EXPORT_SYMBOL_GPL(wimax_state_change);
350 * wimax_state_get() - Return the current state of a WiMAX device
352 * @wimax_dev: WiMAX device descriptor
354 * Returns: Current state of the device according to its driver.
356 enum wimax_st wimax_state_get(struct wimax_dev *wimax_dev)
359 mutex_lock(&wimax_dev->mutex);
360 state = wimax_dev->state;
361 mutex_unlock(&wimax_dev->mutex);
364 EXPORT_SYMBOL_GPL(wimax_state_get);
368 * wimax_dev_init - initialize a newly allocated instance
370 * @wimax_dev: WiMAX device descriptor to initialize.
372 * Initializes fields of a freshly allocated @wimax_dev instance. This
373 * function assumes that after allocation, the memory occupied by
374 * @wimax_dev was zeroed.
376 void wimax_dev_init(struct wimax_dev *wimax_dev)
378 INIT_LIST_HEAD(&wimax_dev->id_table_node);
379 __wimax_state_set(wimax_dev, WIMAX_ST_UNINITIALIZED);
380 mutex_init(&wimax_dev->mutex);
381 mutex_init(&wimax_dev->mutex_reset);
383 EXPORT_SYMBOL_GPL(wimax_dev_init);
386 * This extern is declared here because it's easier to keep track --
387 * both declarations are a list of the same
389 extern struct genl_ops
390 wimax_gnl_msg_from_user,
395 struct genl_ops *wimax_gnl_ops[] = {
396 &wimax_gnl_msg_from_user,
403 size_t wimax_addr_scnprint(char *addr_str, size_t addr_str_size,
404 unsigned char *addr, size_t addr_len)
407 for (total = cnt = 0; cnt < addr_len; cnt++)
408 total += scnprintf(addr_str + total, addr_str_size - total,
410 cnt == addr_len - 1 ? '\0' : ':');
416 * wimax_dev_add - Register a new WiMAX device
418 * @wimax_dev: WiMAX device descriptor (as embedded in your @net_dev's
419 * priv data). You must have called wimax_dev_init() on it before.
421 * @net_dev: net device the @wimax_dev is associated with. The
422 * function expects SET_NETDEV_DEV() and register_netdev() were
423 * already called on it.
425 * Registers the new WiMAX device, sets up the user-kernel control
426 * interface (generic netlink) and common WiMAX infrastructure.
428 * Note that the parts that will allow interaction with user space are
429 * setup at the very end, when the rest is in place, as once that
430 * happens, the driver might get user space control requests via
431 * netlink or from debugfs that might translate into calls into
434 int wimax_dev_add(struct wimax_dev *wimax_dev, struct net_device *net_dev)
437 struct device *dev = net_dev->dev.parent;
440 d_fnstart(3, dev, "(wimax_dev %p net_dev %p)\n", wimax_dev, net_dev);
442 /* Do the RFKILL setup before locking, as RFKILL will call
443 * into our functions. */
444 wimax_dev->net_dev = net_dev;
445 result = wimax_rfkill_add(wimax_dev);
447 goto error_rfkill_add;
449 /* Set up user-space interaction */
450 mutex_lock(&wimax_dev->mutex);
451 wimax_id_table_add(wimax_dev);
452 result = wimax_debugfs_add(wimax_dev);
454 dev_err(dev, "cannot initialize debugfs: %d\n",
456 goto error_debugfs_add;
459 __wimax_state_set(wimax_dev, WIMAX_ST_DOWN);
460 mutex_unlock(&wimax_dev->mutex);
462 wimax_addr_scnprint(addr_str, sizeof(addr_str),
463 net_dev->dev_addr, net_dev->addr_len);
464 dev_err(dev, "WiMAX interface %s (%s) ready\n",
465 net_dev->name, addr_str);
466 d_fnend(3, dev, "(wimax_dev %p net_dev %p) = 0\n", wimax_dev, net_dev);
470 wimax_id_table_rm(wimax_dev);
471 mutex_unlock(&wimax_dev->mutex);
472 wimax_rfkill_rm(wimax_dev);
474 d_fnend(3, dev, "(wimax_dev %p net_dev %p) = %d\n",
475 wimax_dev, net_dev, result);
478 EXPORT_SYMBOL_GPL(wimax_dev_add);
482 * wimax_dev_rm - Unregister an existing WiMAX device
484 * @wimax_dev: WiMAX device descriptor
486 * Unregisters a WiMAX device previously registered for use with
489 * IMPORTANT! Must call before calling unregister_netdev().
491 * After this function returns, you will not get any more user space
492 * control requests (via netlink or debugfs) and thus to wimax_dev->ops.
494 * Reentrancy control is ensured by setting the state to
495 * %__WIMAX_ST_QUIESCING. rfkill operations coming through
496 * wimax_*rfkill*() will be stopped by the quiescing state; ops coming
497 * from the rfkill subsystem will be stopped by the support being
498 * removed by wimax_rfkill_rm().
500 void wimax_dev_rm(struct wimax_dev *wimax_dev)
502 d_fnstart(3, NULL, "(wimax_dev %p)\n", wimax_dev);
504 mutex_lock(&wimax_dev->mutex);
505 __wimax_state_change(wimax_dev, __WIMAX_ST_QUIESCING);
506 wimax_debugfs_rm(wimax_dev);
507 wimax_id_table_rm(wimax_dev);
508 __wimax_state_change(wimax_dev, WIMAX_ST_DOWN);
509 mutex_unlock(&wimax_dev->mutex);
510 wimax_rfkill_rm(wimax_dev);
511 d_fnend(3, NULL, "(wimax_dev %p) = void\n", wimax_dev);
513 EXPORT_SYMBOL_GPL(wimax_dev_rm);
516 /* Debug framework control of debug levels */
517 struct d_level D_LEVEL[] = {
518 D_SUBMODULE_DEFINE(debugfs),
519 D_SUBMODULE_DEFINE(id_table),
520 D_SUBMODULE_DEFINE(op_msg),
521 D_SUBMODULE_DEFINE(op_reset),
522 D_SUBMODULE_DEFINE(op_rfkill),
523 D_SUBMODULE_DEFINE(stack),
525 size_t D_LEVEL_SIZE = ARRAY_SIZE(D_LEVEL);
528 struct genl_family wimax_gnl_family = {
529 .id = GENL_ID_GENERATE,
531 .version = WIMAX_GNL_VERSION,
533 .maxattr = WIMAX_GNL_ATTR_MAX,
536 struct genl_multicast_group wimax_gnl_mcg = {
542 /* Shutdown the wimax stack */
544 int __init wimax_subsys_init(void)
548 d_fnstart(4, NULL, "()\n");
549 snprintf(wimax_gnl_family.name, sizeof(wimax_gnl_family.name),
551 result = genl_register_family(&wimax_gnl_family);
552 if (unlikely(result < 0)) {
553 printk(KERN_ERR "cannot register generic netlink family: %d\n",
555 goto error_register_family;
558 for (cnt = 0; cnt < ARRAY_SIZE(wimax_gnl_ops); cnt++) {
559 result = genl_register_ops(&wimax_gnl_family,
561 d_printf(4, NULL, "registering generic netlink op code "
562 "%u: %d\n", wimax_gnl_ops[cnt]->cmd, result);
563 if (unlikely(result < 0)) {
564 printk(KERN_ERR "cannot register generic netlink op "
566 wimax_gnl_ops[cnt]->cmd, result);
567 goto error_register_ops;
571 result = genl_register_mc_group(&wimax_gnl_family, &wimax_gnl_mcg);
574 d_fnend(4, NULL, "() = 0\n");
579 for (cnt--; cnt >= 0; cnt--)
580 genl_unregister_ops(&wimax_gnl_family,
582 genl_unregister_family(&wimax_gnl_family);
583 error_register_family:
584 d_fnend(4, NULL, "() = %d\n", result);
588 module_init(wimax_subsys_init);
591 /* Shutdown the wimax stack */
593 void __exit wimax_subsys_exit(void)
596 wimax_id_table_release();
597 genl_unregister_mc_group(&wimax_gnl_family, &wimax_gnl_mcg);
598 for (cnt = ARRAY_SIZE(wimax_gnl_ops) - 1; cnt >= 0; cnt--)
599 genl_unregister_ops(&wimax_gnl_family,
601 genl_unregister_family(&wimax_gnl_family);
603 module_exit(wimax_subsys_exit);
605 MODULE_AUTHOR("Intel Corporation <linux-wimax@intel.com>");
606 MODULE_DESCRIPTION("Linux WiMAX stack");
607 MODULE_LICENSE("GPL");