wimax-internal.h 3.1 KB

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