1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Linux WiMAX
4 * Internal API for kernel space WiMAX stack
5 *
6 * Copyright (C) 2007 Intel Corporation <linux-wimax@intel.com>
7 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
8 *
9 * This header file is for declarations and definitions internal to
10 * the WiMAX stack. For public APIs and documentation, see
11 * include/net/wimax.h and include/linux/wimax.h.
12 */
13
14 #ifndef __WIMAX_INTERNAL_H__
15 #define __WIMAX_INTERNAL_H__
16 #ifdef __KERNEL__
17
18 #ifdef pr_fmt
19 #undef pr_fmt
20 #endif
21
22 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
23
24 #include <linux/device.h>
25 #include <net/wimax.h>
26
27
28 /*
29 * Decide if a (locked) device is ready for use
30 *
31 * Before using the device structure, it must be locked
32 * (wimax_dev->mutex). As well, most operations need to call this
33 * function to check if the state is the right one.
34 *
35 * An error value will be returned if the state is not the right
36 * one. In that case, the caller should not attempt to use the device
37 * and just unlock it.
38 */
39 static inline __must_check
wimax_dev_is_ready(struct wimax_dev * wimax_dev)40 int wimax_dev_is_ready(struct wimax_dev *wimax_dev)
41 {
42 if (wimax_dev->state == __WIMAX_ST_NULL)
43 return -EINVAL; /* Device is not even registered! */
44 if (wimax_dev->state == WIMAX_ST_DOWN)
45 return -ENOMEDIUM;
46 if (wimax_dev->state == __WIMAX_ST_QUIESCING)
47 return -ESHUTDOWN;
48 return 0;
49 }
50
51
52 static inline
__wimax_state_set(struct wimax_dev * wimax_dev,enum wimax_st state)53 void __wimax_state_set(struct wimax_dev *wimax_dev, enum wimax_st state)
54 {
55 wimax_dev->state = state;
56 }
57 void __wimax_state_change(struct wimax_dev *, enum wimax_st);
58
59 #ifdef CONFIG_DEBUG_FS
60 void wimax_debugfs_add(struct wimax_dev *);
61 void wimax_debugfs_rm(struct wimax_dev *);
62 #else
wimax_debugfs_add(struct wimax_dev * wimax_dev)63 static inline void wimax_debugfs_add(struct wimax_dev *wimax_dev) {}
wimax_debugfs_rm(struct wimax_dev * wimax_dev)64 static inline void wimax_debugfs_rm(struct wimax_dev *wimax_dev) {}
65 #endif
66
67 void wimax_id_table_add(struct wimax_dev *);
68 struct wimax_dev *wimax_dev_get_by_genl_info(struct genl_info *, int);
69 void wimax_id_table_rm(struct wimax_dev *);
70 void wimax_id_table_release(void);
71
72 int wimax_rfkill_add(struct wimax_dev *);
73 void wimax_rfkill_rm(struct wimax_dev *);
74
75 /* generic netlink */
76 extern struct genl_family wimax_gnl_family;
77
78 /* ops */
79 int wimax_gnl_doit_msg_from_user(struct sk_buff *skb, struct genl_info *info);
80 int wimax_gnl_doit_reset(struct sk_buff *skb, struct genl_info *info);
81 int wimax_gnl_doit_rfkill(struct sk_buff *skb, struct genl_info *info);
82 int wimax_gnl_doit_state_get(struct sk_buff *skb, struct genl_info *info);
83
84 #endif /* #ifdef __KERNEL__ */
85 #endif /* #ifndef __WIMAX_INTERNAL_H__ */
86