1 /* SPDX-License-Identifier: GPL-2.0-only */ 1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /* 2 /*
3 * Copyright (C) 2007-2012 Siemens AG 3 * Copyright (C) 2007-2012 Siemens AG
4 * 4 *
5 * Written by: 5 * Written by:
6 * Pavel Smolenskiy <pavel.smolenskiy@gmail.co 6 * Pavel Smolenskiy <pavel.smolenskiy@gmail.com>
7 * Maxim Gorbachyov <maxim.gorbachev@siemens.c 7 * Maxim Gorbachyov <maxim.gorbachev@siemens.com>
8 * Dmitry Eremin-Solenikov <dbaryshkov@gmail.c 8 * Dmitry Eremin-Solenikov <dbaryshkov@gmail.com>
9 * Alexander Smirnov <alex.bluesman.smirnov@gm 9 * Alexander Smirnov <alex.bluesman.smirnov@gmail.com>
10 */ 10 */
11 #ifndef __IEEE802154_I_H 11 #ifndef __IEEE802154_I_H
12 #define __IEEE802154_I_H 12 #define __IEEE802154_I_H
13 13
14 #include <linux/interrupt.h> 14 #include <linux/interrupt.h>
15 #include <linux/mutex.h> 15 #include <linux/mutex.h>
16 #include <linux/hrtimer.h> 16 #include <linux/hrtimer.h>
17 #include <net/cfg802154.h> 17 #include <net/cfg802154.h>
18 #include <net/mac802154.h> 18 #include <net/mac802154.h>
19 #include <net/nl802154.h> 19 #include <net/nl802154.h>
20 #include <net/ieee802154_netdev.h> 20 #include <net/ieee802154_netdev.h>
21 21
22 #include "llsec.h" 22 #include "llsec.h"
23 23
24 enum ieee802154_ongoing { 24 enum ieee802154_ongoing {
25 IEEE802154_IS_SCANNING = BIT(0), 25 IEEE802154_IS_SCANNING = BIT(0),
26 IEEE802154_IS_BEACONING = BIT(1), 26 IEEE802154_IS_BEACONING = BIT(1),
27 IEEE802154_IS_ASSOCIATING = BIT(2), 27 IEEE802154_IS_ASSOCIATING = BIT(2),
28 }; 28 };
29 29
30 /* mac802154 device private data */ 30 /* mac802154 device private data */
31 struct ieee802154_local { 31 struct ieee802154_local {
32 struct ieee802154_hw hw; 32 struct ieee802154_hw hw;
33 const struct ieee802154_ops *ops; 33 const struct ieee802154_ops *ops;
34 34
35 /* hardware address filter */ 35 /* hardware address filter */
36 struct ieee802154_hw_addr_filt addr_fi 36 struct ieee802154_hw_addr_filt addr_filt;
37 /* ieee802154 phy */ 37 /* ieee802154 phy */
38 struct wpan_phy *phy; 38 struct wpan_phy *phy;
39 39
40 int open_count; 40 int open_count;
41 41
42 /* As in mac80211 slaves list is modif 42 /* As in mac80211 slaves list is modified:
43 * 1) under the RTNL 43 * 1) under the RTNL
44 * 2) protected by slaves_mtx; 44 * 2) protected by slaves_mtx;
45 * 3) in an RCU manner 45 * 3) in an RCU manner
46 * 46 *
47 * So atomic readers can use any of th 47 * So atomic readers can use any of this protection methods.
48 */ 48 */
49 struct list_head interfaces; 49 struct list_head interfaces;
50 struct mutex iflist_mtx; 50 struct mutex iflist_mtx;
51 51
52 /* Data related workqueue */ 52 /* Data related workqueue */
53 struct workqueue_struct *workqueue; 53 struct workqueue_struct *workqueue;
54 /* MAC commands related workqueue */ 54 /* MAC commands related workqueue */
55 struct workqueue_struct *mac_wq; 55 struct workqueue_struct *mac_wq;
56 56
57 struct hrtimer ifs_timer; 57 struct hrtimer ifs_timer;
58 58
59 /* Scanning */ 59 /* Scanning */
60 u8 scan_page; 60 u8 scan_page;
61 u8 scan_channel; 61 u8 scan_channel;
62 struct ieee802154_beacon_req_frame sca 62 struct ieee802154_beacon_req_frame scan_beacon_req;
63 struct cfg802154_scan_request __rcu *s 63 struct cfg802154_scan_request __rcu *scan_req;
64 struct delayed_work scan_work; 64 struct delayed_work scan_work;
65 65
66 /* Beaconing */ 66 /* Beaconing */
67 unsigned int beacon_interval; 67 unsigned int beacon_interval;
68 struct ieee802154_beacon_frame beacon; 68 struct ieee802154_beacon_frame beacon;
69 struct cfg802154_beacon_request __rcu 69 struct cfg802154_beacon_request __rcu *beacon_req;
70 struct delayed_work beacon_work; 70 struct delayed_work beacon_work;
71 71
72 /* Asynchronous tasks */ 72 /* Asynchronous tasks */
73 struct list_head rx_beacon_list; 73 struct list_head rx_beacon_list;
74 struct work_struct rx_beacon_work; 74 struct work_struct rx_beacon_work;
75 struct list_head rx_mac_cmd_list; 75 struct list_head rx_mac_cmd_list;
76 struct work_struct rx_mac_cmd_work; 76 struct work_struct rx_mac_cmd_work;
77 77
78 /* Association */ 78 /* Association */
79 struct ieee802154_pan_device *assoc_de 79 struct ieee802154_pan_device *assoc_dev;
80 struct completion assoc_done; 80 struct completion assoc_done;
81 __le16 assoc_addr; 81 __le16 assoc_addr;
82 u8 assoc_status; 82 u8 assoc_status;
83 struct work_struct assoc_work; 83 struct work_struct assoc_work;
84 84
85 bool started; 85 bool started;
86 bool suspended; 86 bool suspended;
87 unsigned long ongoing; 87 unsigned long ongoing;
88 88
89 struct tasklet_struct tasklet; 89 struct tasklet_struct tasklet;
90 struct sk_buff_head skb_queue; 90 struct sk_buff_head skb_queue;
91 91
92 struct sk_buff *tx_skb; 92 struct sk_buff *tx_skb;
93 struct work_struct sync_tx_work; 93 struct work_struct sync_tx_work;
94 /* A negative Linux error code or a nu 94 /* A negative Linux error code or a null/positive MLME error status */
95 int tx_result; 95 int tx_result;
96 }; 96 };
97 97
98 enum { 98 enum {
99 IEEE802154_RX_MSG = 1, 99 IEEE802154_RX_MSG = 1,
100 }; 100 };
101 101
102 enum ieee802154_sdata_state_bits { 102 enum ieee802154_sdata_state_bits {
103 SDATA_STATE_RUNNING, 103 SDATA_STATE_RUNNING,
104 }; 104 };
105 105
106 /* Slave interface definition. 106 /* Slave interface definition.
107 * 107 *
108 * Slaves represent typical network interfaces 108 * Slaves represent typical network interfaces available from userspace.
109 * Each ieee802154 device/transceiver may have 109 * Each ieee802154 device/transceiver may have several slaves and able
110 * to be associated with several networks at t 110 * to be associated with several networks at the same time.
111 */ 111 */
112 struct ieee802154_sub_if_data { 112 struct ieee802154_sub_if_data {
113 struct list_head list; /* the ieee8021 113 struct list_head list; /* the ieee802154_priv->slaves list */
114 114
115 struct wpan_dev wpan_dev; 115 struct wpan_dev wpan_dev;
116 116
117 struct ieee802154_local *local; 117 struct ieee802154_local *local;
118 struct net_device *dev; 118 struct net_device *dev;
119 119
120 /* Each interface starts and works in 120 /* Each interface starts and works in nominal state at a given filtering
121 * level given by iface_default_filter 121 * level given by iface_default_filtering, which is set once for all at
122 * the interface creation and should n 122 * the interface creation and should not evolve over time. For some MAC
123 * operations however, the filtering l 123 * operations however, the filtering level may change temporarily, as
124 * reflected in the required_filtering 124 * reflected in the required_filtering field. The actual filtering at
125 * the PHY level may be different and 125 * the PHY level may be different and is shown in struct wpan_phy.
126 */ 126 */
127 enum ieee802154_filtering_level iface_ 127 enum ieee802154_filtering_level iface_default_filtering;
128 enum ieee802154_filtering_level requir 128 enum ieee802154_filtering_level required_filtering;
129 129
130 unsigned long state; 130 unsigned long state;
131 char name[IFNAMSIZ]; 131 char name[IFNAMSIZ];
132 132
133 /* protects sec from concurrent access 133 /* protects sec from concurrent access by netlink. access by
134 * encrypt/decrypt/header_create safe 134 * encrypt/decrypt/header_create safe without additional protection.
135 */ 135 */
136 struct mutex sec_mtx; 136 struct mutex sec_mtx;
137 137
138 struct mac802154_llsec sec; 138 struct mac802154_llsec sec;
139 }; 139 };
140 140
141 /* utility functions/constants */ 141 /* utility functions/constants */
142 extern const void *const mac802154_wpan_phy_pr 142 extern const void *const mac802154_wpan_phy_privid; /* for wpan_phy privid */
143 143
144 static inline struct ieee802154_local * 144 static inline struct ieee802154_local *
145 hw_to_local(struct ieee802154_hw *hw) 145 hw_to_local(struct ieee802154_hw *hw)
146 { 146 {
147 return container_of(hw, struct ieee802 147 return container_of(hw, struct ieee802154_local, hw);
148 } 148 }
149 149
150 static inline struct ieee802154_sub_if_data * 150 static inline struct ieee802154_sub_if_data *
151 IEEE802154_DEV_TO_SUB_IF(const struct net_devi 151 IEEE802154_DEV_TO_SUB_IF(const struct net_device *dev)
152 { 152 {
153 return netdev_priv(dev); 153 return netdev_priv(dev);
154 } 154 }
155 155
156 static inline struct ieee802154_sub_if_data * 156 static inline struct ieee802154_sub_if_data *
157 IEEE802154_WPAN_DEV_TO_SUB_IF(struct wpan_dev 157 IEEE802154_WPAN_DEV_TO_SUB_IF(struct wpan_dev *wpan_dev)
158 { 158 {
159 return container_of(wpan_dev, struct i 159 return container_of(wpan_dev, struct ieee802154_sub_if_data, wpan_dev);
160 } 160 }
161 161
162 static inline bool 162 static inline bool
163 ieee802154_sdata_running(struct ieee802154_sub 163 ieee802154_sdata_running(struct ieee802154_sub_if_data *sdata)
164 { 164 {
165 return test_bit(SDATA_STATE_RUNNING, & 165 return test_bit(SDATA_STATE_RUNNING, &sdata->state);
166 } 166 }
167 167
168 static inline int ieee802154_get_mac_cmd(struc 168 static inline int ieee802154_get_mac_cmd(struct sk_buff *skb, u8 *mac_cmd)
169 { 169 {
170 struct ieee802154_mac_cmd_pl mac_pl; 170 struct ieee802154_mac_cmd_pl mac_pl;
171 int ret; 171 int ret;
172 172
173 if (mac_cb(skb)->type != IEEE802154_FC 173 if (mac_cb(skb)->type != IEEE802154_FC_TYPE_MAC_CMD)
174 return -EINVAL; 174 return -EINVAL;
175 175
176 ret = ieee802154_mac_cmd_pl_pull(skb, 176 ret = ieee802154_mac_cmd_pl_pull(skb, &mac_pl);
177 if (ret) 177 if (ret)
178 return ret; 178 return ret;
179 179
180 *mac_cmd = mac_pl.cmd_id; 180 *mac_cmd = mac_pl.cmd_id;
181 return 0; 181 return 0;
182 } 182 }
183 183
184 extern struct ieee802154_mlme_ops mac802154_ml 184 extern struct ieee802154_mlme_ops mac802154_mlme_wpan;
185 185
186 void ieee802154_rx(struct ieee802154_local *lo 186 void ieee802154_rx(struct ieee802154_local *local, struct sk_buff *skb);
187 void ieee802154_xmit_sync_worker(struct work_s 187 void ieee802154_xmit_sync_worker(struct work_struct *work);
188 int ieee802154_sync_and_hold_queue(struct ieee 188 int ieee802154_sync_and_hold_queue(struct ieee802154_local *local);
189 int ieee802154_mlme_op_pre(struct ieee802154_l 189 int ieee802154_mlme_op_pre(struct ieee802154_local *local);
190 int ieee802154_mlme_tx(struct ieee802154_local 190 int ieee802154_mlme_tx(struct ieee802154_local *local,
191 struct ieee802154_sub_i 191 struct ieee802154_sub_if_data *sdata,
192 struct sk_buff *skb); 192 struct sk_buff *skb);
193 int ieee802154_mlme_tx_locked(struct ieee80215 193 int ieee802154_mlme_tx_locked(struct ieee802154_local *local,
194 struct ieee80215 194 struct ieee802154_sub_if_data *sdata,
195 struct sk_buff * 195 struct sk_buff *skb);
196 void ieee802154_mlme_op_post(struct ieee802154 196 void ieee802154_mlme_op_post(struct ieee802154_local *local);
197 int ieee802154_mlme_tx_one(struct ieee802154_l 197 int ieee802154_mlme_tx_one(struct ieee802154_local *local,
198 struct ieee802154_s 198 struct ieee802154_sub_if_data *sdata,
199 struct sk_buff *skb 199 struct sk_buff *skb);
200 int ieee802154_mlme_tx_one_locked(struct ieee8 200 int ieee802154_mlme_tx_one_locked(struct ieee802154_local *local,
201 struct ieee8 201 struct ieee802154_sub_if_data *sdata,
202 struct sk_bu 202 struct sk_buff *skb);
203 netdev_tx_t 203 netdev_tx_t
204 ieee802154_monitor_start_xmit(struct sk_buff * 204 ieee802154_monitor_start_xmit(struct sk_buff *skb, struct net_device *dev);
205 netdev_tx_t 205 netdev_tx_t
206 ieee802154_subif_start_xmit(struct sk_buff *sk 206 ieee802154_subif_start_xmit(struct sk_buff *skb, struct net_device *dev);
207 enum hrtimer_restart ieee802154_xmit_ifs_timer 207 enum hrtimer_restart ieee802154_xmit_ifs_timer(struct hrtimer *timer);
208 208
209 /** 209 /**
210 * ieee802154_hold_queue - hold ieee802154 que 210 * ieee802154_hold_queue - hold ieee802154 queue
211 * @local: main mac object 211 * @local: main mac object
212 * 212 *
213 * Hold a queue by incrementing an atomic coun 213 * Hold a queue by incrementing an atomic counter and requesting the netif
214 * queues to be stopped. The queues cannot be 214 * queues to be stopped. The queues cannot be woken up while the counter has not
215 * been reset with as any ieee802154_release_q 215 * been reset with as any ieee802154_release_queue() calls as needed.
216 */ 216 */
217 void ieee802154_hold_queue(struct ieee802154_l 217 void ieee802154_hold_queue(struct ieee802154_local *local);
218 218
219 /** 219 /**
220 * ieee802154_release_queue - release ieee8021 220 * ieee802154_release_queue - release ieee802154 queue
221 * @local: main mac object 221 * @local: main mac object
222 * 222 *
223 * Release a queue which is held by decrementi 223 * Release a queue which is held by decrementing an atomic counter and wake it
224 * up only if the counter reaches 0. 224 * up only if the counter reaches 0.
225 */ 225 */
226 void ieee802154_release_queue(struct ieee80215 226 void ieee802154_release_queue(struct ieee802154_local *local);
227 227
228 /** 228 /**
229 * ieee802154_disable_queue - disable ieee8021 229 * ieee802154_disable_queue - disable ieee802154 queue
230 * @local: main mac object 230 * @local: main mac object
231 * 231 *
232 * When trying to sync the Tx queue, we cannot 232 * When trying to sync the Tx queue, we cannot just stop the queue
233 * (which is basically a bit being set without 233 * (which is basically a bit being set without proper lock handling)
234 * because it would be racy. We actually need 234 * because it would be racy. We actually need to call netif_tx_disable()
235 * instead, which is done by this helper. Rest 235 * instead, which is done by this helper. Restarting the queue can
236 * however still be done with a regular wake c 236 * however still be done with a regular wake call.
237 */ 237 */
238 void ieee802154_disable_queue(struct ieee80215 238 void ieee802154_disable_queue(struct ieee802154_local *local);
239 239
240 /* MIB callbacks */ 240 /* MIB callbacks */
241 void mac802154_dev_set_page_channel(struct net 241 void mac802154_dev_set_page_channel(struct net_device *dev, u8 page, u8 chan);
242 242
243 int mac802154_get_params(struct net_device *de 243 int mac802154_get_params(struct net_device *dev,
244 struct ieee802154_lls 244 struct ieee802154_llsec_params *params);
245 int mac802154_set_params(struct net_device *de 245 int mac802154_set_params(struct net_device *dev,
246 const struct ieee8021 246 const struct ieee802154_llsec_params *params,
247 int changed); 247 int changed);
248 248
249 int mac802154_add_key(struct net_device *dev, 249 int mac802154_add_key(struct net_device *dev,
250 const struct ieee802154_ 250 const struct ieee802154_llsec_key_id *id,
251 const struct ieee802154_ 251 const struct ieee802154_llsec_key *key);
252 int mac802154_del_key(struct net_device *dev, 252 int mac802154_del_key(struct net_device *dev,
253 const struct ieee802154_ 253 const struct ieee802154_llsec_key_id *id);
254 254
255 int mac802154_add_dev(struct net_device *dev, 255 int mac802154_add_dev(struct net_device *dev,
256 const struct ieee802154_ 256 const struct ieee802154_llsec_device *llsec_dev);
257 int mac802154_del_dev(struct net_device *dev, 257 int mac802154_del_dev(struct net_device *dev, __le64 dev_addr);
258 258
259 int mac802154_add_devkey(struct net_device *de 259 int mac802154_add_devkey(struct net_device *dev,
260 __le64 device_addr, 260 __le64 device_addr,
261 const struct ieee8021 261 const struct ieee802154_llsec_device_key *key);
262 int mac802154_del_devkey(struct net_device *de 262 int mac802154_del_devkey(struct net_device *dev,
263 __le64 device_addr, 263 __le64 device_addr,
264 const struct ieee8021 264 const struct ieee802154_llsec_device_key *key);
265 265
266 int mac802154_add_seclevel(struct net_device * 266 int mac802154_add_seclevel(struct net_device *dev,
267 const struct ieee80 267 const struct ieee802154_llsec_seclevel *sl);
268 int mac802154_del_seclevel(struct net_device * 268 int mac802154_del_seclevel(struct net_device *dev,
269 const struct ieee80 269 const struct ieee802154_llsec_seclevel *sl);
270 270
271 void mac802154_lock_table(struct net_device *d 271 void mac802154_lock_table(struct net_device *dev);
272 void mac802154_get_table(struct net_device *de 272 void mac802154_get_table(struct net_device *dev,
273 struct ieee802154_lls 273 struct ieee802154_llsec_table **t);
274 void mac802154_unlock_table(struct net_device 274 void mac802154_unlock_table(struct net_device *dev);
275 275
276 int mac802154_wpan_update_llsec(struct net_dev 276 int mac802154_wpan_update_llsec(struct net_device *dev);
277 277
278 /* PAN management handling */ 278 /* PAN management handling */
279 void mac802154_scan_worker(struct work_struct 279 void mac802154_scan_worker(struct work_struct *work);
280 int mac802154_trigger_scan_locked(struct ieee8 280 int mac802154_trigger_scan_locked(struct ieee802154_sub_if_data *sdata,
281 struct cfg80 281 struct cfg802154_scan_request *request);
282 int mac802154_abort_scan_locked(struct ieee802 282 int mac802154_abort_scan_locked(struct ieee802154_local *local,
283 struct ieee802 283 struct ieee802154_sub_if_data *sdata);
284 int mac802154_process_beacon(struct ieee802154 284 int mac802154_process_beacon(struct ieee802154_local *local,
285 struct sk_buff *s 285 struct sk_buff *skb,
286 u8 page, u8 chann 286 u8 page, u8 channel);
287 void mac802154_rx_beacon_worker(struct work_st 287 void mac802154_rx_beacon_worker(struct work_struct *work);
288 288
289 static inline bool mac802154_is_scanning(struc 289 static inline bool mac802154_is_scanning(struct ieee802154_local *local)
290 { 290 {
291 return test_bit(IEEE802154_IS_SCANNING 291 return test_bit(IEEE802154_IS_SCANNING, &local->ongoing);
292 } 292 }
293 293
294 void mac802154_beacon_worker(struct work_struc 294 void mac802154_beacon_worker(struct work_struct *work);
295 int mac802154_send_beacons_locked(struct ieee8 295 int mac802154_send_beacons_locked(struct ieee802154_sub_if_data *sdata,
296 struct cfg80 296 struct cfg802154_beacon_request *request);
297 int mac802154_stop_beacons_locked(struct ieee8 297 int mac802154_stop_beacons_locked(struct ieee802154_local *local,
298 struct ieee8 298 struct ieee802154_sub_if_data *sdata);
299 299
300 static inline bool mac802154_is_beaconing(stru 300 static inline bool mac802154_is_beaconing(struct ieee802154_local *local)
301 { 301 {
302 return test_bit(IEEE802154_IS_BEACONIN 302 return test_bit(IEEE802154_IS_BEACONING, &local->ongoing);
303 } 303 }
304 304
305 void mac802154_rx_mac_cmd_worker(struct work_s 305 void mac802154_rx_mac_cmd_worker(struct work_struct *work);
306 306
307 int mac802154_perform_association(struct ieee8 307 int mac802154_perform_association(struct ieee802154_sub_if_data *sdata,
308 struct ieee8 308 struct ieee802154_pan_device *coord,
309 __le16 *shor 309 __le16 *short_addr);
310 int mac802154_process_association_resp(struct 310 int mac802154_process_association_resp(struct ieee802154_sub_if_data *sdata,
311 struct 311 struct sk_buff *skb);
312 312
313 static inline bool mac802154_is_associating(st 313 static inline bool mac802154_is_associating(struct ieee802154_local *local)
314 { 314 {
315 return test_bit(IEEE802154_IS_ASSOCIAT 315 return test_bit(IEEE802154_IS_ASSOCIATING, &local->ongoing);
316 } 316 }
317 317
318 int mac802154_send_disassociation_notif(struct 318 int mac802154_send_disassociation_notif(struct ieee802154_sub_if_data *sdata,
319 struct 319 struct ieee802154_pan_device *target,
320 u8 rea 320 u8 reason);
321 int mac802154_process_disassociation_notif(str 321 int mac802154_process_disassociation_notif(struct ieee802154_sub_if_data *sdata,
322 str 322 struct sk_buff *skb);
323 int mac802154_process_association_req(struct i 323 int mac802154_process_association_req(struct ieee802154_sub_if_data *sdata,
324 struct s 324 struct sk_buff *skb);
325 325
326 /* interface handling */ 326 /* interface handling */
327 int ieee802154_iface_init(void); 327 int ieee802154_iface_init(void);
328 void ieee802154_iface_exit(void); 328 void ieee802154_iface_exit(void);
329 void ieee802154_if_remove(struct ieee802154_su 329 void ieee802154_if_remove(struct ieee802154_sub_if_data *sdata);
330 struct net_device * 330 struct net_device *
331 ieee802154_if_add(struct ieee802154_local *loc 331 ieee802154_if_add(struct ieee802154_local *local, const char *name,
332 unsigned char name_assign_ty 332 unsigned char name_assign_type, enum nl802154_iftype type,
333 __le64 extended_addr); 333 __le64 extended_addr);
334 void ieee802154_remove_interfaces(struct ieee8 334 void ieee802154_remove_interfaces(struct ieee802154_local *local);
335 void ieee802154_stop_device(struct ieee802154_ 335 void ieee802154_stop_device(struct ieee802154_local *local);
336 336
337 #endif /* __IEEE802154_I_H */ 337 #endif /* __IEEE802154_I_H */
338 338
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.