net/wimax/op-reset.c

   1 /*
   2  * Linux WiMAX
   3  * Implement and export a method for resetting a WiMAX device
   4  *
   5  *
   6  * Copyright (C) 2008 Intel Corporation <linux-wimax@intel.com>
   7  * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
   8  *
   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.
  12  *
  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.
  17  *
  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
  21  * 02110-1301, USA.
  22  *
  23  *
  24  * This implements a simple synchronous call to reset a WiMAX device.
  25  *
  26  * Resets aim at being warm, keeping the device handles active;
  27  * however, when that fails, it falls back to a cold reset (that will
  28  * disconnect and reconnect the device).
  29  */
  30
  31 #include <net/wimax.h>
  32 #include <net/genetlink.h>
  33 #include <linux/wimax.h>
  34 #include <linux/security.h>
  35 #include "wimax-internal.h"
  36
  37 #define D_SUBMODULE op_reset
  38 #include "debug-levels.h"
  39
  40
  41 /**
  42  * wimax_reset - Reset a WiMAX device
  43  *
  44  * @wimax_dev: WiMAX device descriptor
  45  *
  46  * Returns:
  47  *
  48  * %0 if ok and a warm reset was done (the device still exists in
  49  * the system).
  50  *
  51  * -%ENODEV if a cold/bus reset had to be done (device has
  52  * disconnected and reconnected, so current handle is not valid
  53  * any more).
  54  *
  55  * -%EINVAL if the device is not even registered.
  56  *
  57  * Any other negative error code shall be considered as
  58  * non-recoverable.
  59  *
  60  * Description:
  61  *
  62  * Called when wanting to reset the device for any reason. Device is
  63  * taken back to power on status.
  64  *
  65  * This call blocks; on succesful return, the device has completed the
  66  * reset process and is ready to operate.
  67  */
  68 int wimax_reset(struct wimax_dev *wimax_dev)
  69 {
  70         int result = -EINVAL;
  71         struct device *dev = wimax_dev_to_dev(wimax_dev);
  72         enum wimax_st state;
  73
  74         might_sleep();
  75         d_fnstart(3, dev, "(wimax_dev %p)\n", wimax_dev);
  76         mutex_lock(&wimax_dev->mutex);
  77         dev_hold(wimax_dev->net_dev);
  78         state = wimax_dev->state;
  79         mutex_unlock(&wimax_dev->mutex);
  80
  81         if (state >= WIMAX_ST_DOWN) {
  82                 mutex_lock(&wimax_dev->mutex_reset);
  83                 result = wimax_dev->op_reset(wimax_dev);
  84                 mutex_unlock(&wimax_dev->mutex_reset);
  85         }
  86         dev_put(wimax_dev->net_dev);
  87
  88         d_fnend(3, dev, "(wimax_dev %p) = %d\n", wimax_dev, result);
  89         return result;
  90 }
  91 EXPORT_SYMBOL(wimax_reset);
  92
  93
  94 static const
  95 struct nla_policy wimax_gnl_reset_policy[WIMAX_GNL_ATTR_MAX + 1] = {
  96         [WIMAX_GNL_RESET_IFIDX] = {
  97                 .type = NLA_U32,
  98         },
  99 };
 100
 101
 102 /*
 103  * Exporting to user space over generic netlink
 104  *
 105  * Parse the reset command from user space, return error code.
 106  *
 107  * No attributes.
 108  */
 109 static
 110 int wimax_gnl_doit_reset(struct sk_buff *skb, struct genl_info *info)
 111 {
 112         int result, ifindex;
 113         struct wimax_dev *wimax_dev;
 114         struct device *dev;
 115
 116         d_fnstart(3, NULL, "(skb %p info %p)\n", skb, info);
 117         result = -ENODEV;
 118         if (info->attrs[WIMAX_GNL_RESET_IFIDX] == NULL) {
 119                 printk(KERN_ERR "WIMAX_GNL_OP_RFKILL: can't find IFIDX "
 120                         "attribute\n");
 121                 goto error_no_wimax_dev;
 122         }
 123         ifindex = nla_get_u32(info->attrs[WIMAX_GNL_RESET_IFIDX]);
 124         wimax_dev = wimax_dev_get_by_genl_info(info, ifindex);
 125         if (wimax_dev == NULL)
 126                 goto error_no_wimax_dev;
 127         dev = wimax_dev_to_dev(wimax_dev);
 128         /* Execute the operation and send the result back to user space */
 129         result = wimax_reset(wimax_dev);
 130         dev_put(wimax_dev->net_dev);
 131 error_no_wimax_dev:
 132         d_fnend(3, NULL, "(skb %p info %p) = %d\n", skb, info, result);
 133         return result;
 134 }
 135
 136
 137 struct genl_ops wimax_gnl_reset = {
 138         .cmd = WIMAX_GNL_OP_RESET,
 139         .flags = GENL_ADMIN_PERM,
 140         .policy = wimax_gnl_reset_policy,
 141         .doit = wimax_gnl_doit_reset,
 142         .dumpit = NULL,
 143 };