LXR linux/net/wimax/wimax-internal.h

   1/*
   2 * Linux WiMAX
   3 * Internal API for kernel space WiMAX stack
   4 *
   5 *
   6 * Copyright (C) 2007 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 header file is for declarations and definitions internal to
  25 * the WiMAX stack. For public APIs and documentation, see
  26 * include/net/wimax.h and include/linux/wimax.h.
  27 */
  28
  29#ifndef __WIMAX_INTERNAL_H__
  30#define __WIMAX_INTERNAL_H__
  31#ifdef __KERNEL__
  32
  33#ifdef pr_fmt
  34#undef pr_fmt
  35#endif
  36
  37#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  38
  39#include <linux/device.h>
  40#include <net/wimax.h>
  41
  42
  43/*
  44 * Decide if a (locked) device is ready for use
  45 *
  46 * Before using the device structure, it must be locked
  47 * (wimax_dev->mutex). As well, most operations need to call this
  48 * function to check if the state is the right one.
  49 *
  50 * An error value will be returned if the state is not the right
  51 * one. In that case, the caller should not attempt to use the device
  52 * and just unlock it.
  53 */
  54static inline __must_check
  55int wimax_dev_is_ready(struct wimax_dev *wimax_dev)
  56{
  57        if (wimax_dev->state == __WIMAX_ST_NULL)
  58                return -EINVAL; /* Device is not even registered! */
  59        if (wimax_dev->state == WIMAX_ST_DOWN)
  60                return -ENOMEDIUM;
  61        if (wimax_dev->state == __WIMAX_ST_QUIESCING)
  62                return -ESHUTDOWN;
  63        return 0;
  64}
  65
  66
  67static inline
  68void __wimax_state_set(struct wimax_dev *wimax_dev, enum wimax_st state)
  69{
  70        wimax_dev->state = state;
  71}
  72void __wimax_state_change(struct wimax_dev *, enum wimax_st);
  73
  74#ifdef CONFIG_DEBUG_FS
  75int wimax_debugfs_add(struct wimax_dev *);
  76void wimax_debugfs_rm(struct wimax_dev *);
  77#else
  78static inline int wimax_debugfs_add(struct wimax_dev *wimax_dev)
  79{
  80        return 0;
  81}
  82static inline void wimax_debugfs_rm(struct wimax_dev *wimax_dev) {}
  83#endif
  84
  85void wimax_id_table_add(struct wimax_dev *);
  86struct wimax_dev *wimax_dev_get_by_genl_info(struct genl_info *, int);
  87void wimax_id_table_rm(struct wimax_dev *);
  88void wimax_id_table_release(void);
  89
  90int wimax_rfkill_add(struct wimax_dev *);
  91void wimax_rfkill_rm(struct wimax_dev *);
  92
  93/* generic netlink */
  94extern struct genl_family wimax_gnl_family;
  95
  96/* ops */
  97int wimax_gnl_doit_msg_from_user(struct sk_buff *skb, struct genl_info *info);
  98int wimax_gnl_doit_reset(struct sk_buff *skb, struct genl_info *info);
  99int wimax_gnl_doit_rfkill(struct sk_buff *skb, struct genl_info *info);
 100int wimax_gnl_doit_state_get(struct sk_buff *skb, struct genl_info *info);
 101
 102#endif /* #ifdef __KERNEL__ */
 103#endif /* #ifndef __WIMAX_INTERNAL_H__ */
 104