|  | /* | 
|  | * Wireless configuration interface internals. | 
|  | * | 
|  | * Copyright 2006-2010	Johannes Berg <johannes@sipsolutions.net> | 
|  | */ | 
|  | #ifndef __NET_WIRELESS_CORE_H | 
|  | #define __NET_WIRELESS_CORE_H | 
|  | #include <linux/mutex.h> | 
|  | #include <linux/list.h> | 
|  | #include <linux/netdevice.h> | 
|  | #include <linux/kref.h> | 
|  | #include <linux/rbtree.h> | 
|  | #include <linux/debugfs.h> | 
|  | #include <linux/rfkill.h> | 
|  | #include <linux/workqueue.h> | 
|  | #include <net/genetlink.h> | 
|  | #include <net/cfg80211.h> | 
|  | #include "reg.h" | 
|  |  | 
|  | struct cfg80211_registered_device { | 
|  | const struct cfg80211_ops *ops; | 
|  | struct list_head list; | 
|  | /* we hold this mutex during any call so that | 
|  | * we cannot do multiple calls at once, and also | 
|  | * to avoid the deregister call to proceed while | 
|  | * any call is in progress */ | 
|  | struct mutex mtx; | 
|  |  | 
|  | /* rfkill support */ | 
|  | struct rfkill_ops rfkill_ops; | 
|  | struct rfkill *rfkill; | 
|  | struct work_struct rfkill_sync; | 
|  |  | 
|  | /* ISO / IEC 3166 alpha2 for which this device is receiving | 
|  | * country IEs on, this can help disregard country IEs from APs | 
|  | * on the same alpha2 quickly. The alpha2 may differ from | 
|  | * cfg80211_regdomain's alpha2 when an intersection has occurred. | 
|  | * If the AP is reconfigured this can also be used to tell us if | 
|  | * the country on the country IE changed. */ | 
|  | char country_ie_alpha2[2]; | 
|  |  | 
|  | /* If a Country IE has been received this tells us the environment | 
|  | * which its telling us its in. This defaults to ENVIRON_ANY */ | 
|  | enum environment_cap env; | 
|  |  | 
|  | /* wiphy index, internal only */ | 
|  | int wiphy_idx; | 
|  |  | 
|  | /* associate netdev list */ | 
|  | struct mutex devlist_mtx; | 
|  | /* protected by devlist_mtx or RCU */ | 
|  | struct list_head netdev_list; | 
|  | int devlist_generation; | 
|  | int opencount; /* also protected by devlist_mtx */ | 
|  | wait_queue_head_t dev_wait; | 
|  |  | 
|  | /* BSSes/scanning */ | 
|  | spinlock_t bss_lock; | 
|  | struct list_head bss_list; | 
|  | struct rb_root bss_tree; | 
|  | u32 bss_generation; | 
|  | struct cfg80211_scan_request *scan_req; /* protected by RTNL */ | 
|  | struct cfg80211_sched_scan_request *sched_scan_req; | 
|  | unsigned long suspend_at; | 
|  | struct work_struct scan_done_wk; | 
|  | struct work_struct sched_scan_results_wk; | 
|  |  | 
|  | struct mutex sched_scan_mtx; | 
|  |  | 
|  | #ifdef CONFIG_NL80211_TESTMODE | 
|  | struct genl_info *testmode_info; | 
|  | #endif | 
|  |  | 
|  | struct work_struct conn_work; | 
|  | struct work_struct event_work; | 
|  |  | 
|  | struct cfg80211_wowlan *wowlan; | 
|  |  | 
|  | /* must be last because of the way we do wiphy_priv(), | 
|  | * and it should at least be aligned to NETDEV_ALIGN */ | 
|  | struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN))); | 
|  | }; | 
|  |  | 
|  | static inline | 
|  | struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy) | 
|  | { | 
|  | BUG_ON(!wiphy); | 
|  | return container_of(wiphy, struct cfg80211_registered_device, wiphy); | 
|  | } | 
|  |  | 
|  | /* Note 0 is valid, hence phy0 */ | 
|  | static inline | 
|  | bool wiphy_idx_valid(int wiphy_idx) | 
|  | { | 
|  | return wiphy_idx >= 0; | 
|  | } | 
|  |  | 
|  | static inline void | 
|  | cfg80211_rdev_free_wowlan(struct cfg80211_registered_device *rdev) | 
|  | { | 
|  | int i; | 
|  |  | 
|  | if (!rdev->wowlan) | 
|  | return; | 
|  | for (i = 0; i < rdev->wowlan->n_patterns; i++) | 
|  | kfree(rdev->wowlan->patterns[i].mask); | 
|  | kfree(rdev->wowlan->patterns); | 
|  | kfree(rdev->wowlan); | 
|  | } | 
|  |  | 
|  | extern struct workqueue_struct *cfg80211_wq; | 
|  | extern struct mutex cfg80211_mutex; | 
|  | extern struct list_head cfg80211_rdev_list; | 
|  | extern int cfg80211_rdev_list_generation; | 
|  |  | 
|  | static inline void assert_cfg80211_lock(void) | 
|  | { | 
|  | lockdep_assert_held(&cfg80211_mutex); | 
|  | } | 
|  |  | 
|  | /* | 
|  | * You can use this to mark a wiphy_idx as not having an associated wiphy. | 
|  | * It guarantees cfg80211_rdev_by_wiphy_idx(wiphy_idx) will return NULL | 
|  | */ | 
|  | #define WIPHY_IDX_STALE -1 | 
|  |  | 
|  | struct cfg80211_internal_bss { | 
|  | struct list_head list; | 
|  | struct rb_node rbn; | 
|  | unsigned long ts; | 
|  | struct kref ref; | 
|  | atomic_t hold; | 
|  | bool beacon_ies_allocated; | 
|  | bool proberesp_ies_allocated; | 
|  |  | 
|  | /* must be last because of priv member */ | 
|  | struct cfg80211_bss pub; | 
|  | }; | 
|  |  | 
|  | static inline struct cfg80211_internal_bss *bss_from_pub(struct cfg80211_bss *pub) | 
|  | { | 
|  | return container_of(pub, struct cfg80211_internal_bss, pub); | 
|  | } | 
|  |  | 
|  | static inline void cfg80211_ref_bss(struct cfg80211_internal_bss *bss) | 
|  | { | 
|  | kref_get(&bss->ref); | 
|  | } | 
|  |  | 
|  | static inline void cfg80211_hold_bss(struct cfg80211_internal_bss *bss) | 
|  | { | 
|  | atomic_inc(&bss->hold); | 
|  | } | 
|  |  | 
|  | static inline void cfg80211_unhold_bss(struct cfg80211_internal_bss *bss) | 
|  | { | 
|  | int r = atomic_dec_return(&bss->hold); | 
|  | WARN_ON(r < 0); | 
|  | } | 
|  |  | 
|  |  | 
|  | struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx); | 
|  | int get_wiphy_idx(struct wiphy *wiphy); | 
|  |  | 
|  | struct cfg80211_registered_device * | 
|  | __cfg80211_rdev_from_info(struct genl_info *info); | 
|  |  | 
|  | /* | 
|  | * This function returns a pointer to the driver | 
|  | * that the genl_info item that is passed refers to. | 
|  | * If successful, it returns non-NULL and also locks | 
|  | * the driver's mutex! | 
|  | * | 
|  | * This means that you need to call cfg80211_unlock_rdev() | 
|  | * before being allowed to acquire &cfg80211_mutex! | 
|  | * | 
|  | * This is necessary because we need to lock the global | 
|  | * mutex to get an item off the list safely, and then | 
|  | * we lock the rdev mutex so it doesn't go away under us. | 
|  | * | 
|  | * We don't want to keep cfg80211_mutex locked | 
|  | * for all the time in order to allow requests on | 
|  | * other interfaces to go through at the same time. | 
|  | * | 
|  | * The result of this can be a PTR_ERR and hence must | 
|  | * be checked with IS_ERR() for errors. | 
|  | */ | 
|  | extern struct cfg80211_registered_device * | 
|  | cfg80211_get_dev_from_info(struct genl_info *info); | 
|  |  | 
|  | /* requires cfg80211_rdev_mutex to be held! */ | 
|  | struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx); | 
|  |  | 
|  | /* identical to cfg80211_get_dev_from_info but only operate on ifindex */ | 
|  | extern struct cfg80211_registered_device * | 
|  | cfg80211_get_dev_from_ifindex(struct net *net, int ifindex); | 
|  |  | 
|  | int cfg80211_switch_netns(struct cfg80211_registered_device *rdev, | 
|  | struct net *net); | 
|  |  | 
|  | static inline void cfg80211_lock_rdev(struct cfg80211_registered_device *rdev) | 
|  | { | 
|  | mutex_lock(&rdev->mtx); | 
|  | } | 
|  |  | 
|  | static inline void cfg80211_unlock_rdev(struct cfg80211_registered_device *rdev) | 
|  | { | 
|  | BUG_ON(IS_ERR(rdev) || !rdev); | 
|  | mutex_unlock(&rdev->mtx); | 
|  | } | 
|  |  | 
|  | static inline void wdev_lock(struct wireless_dev *wdev) | 
|  | __acquires(wdev) | 
|  | { | 
|  | mutex_lock(&wdev->mtx); | 
|  | __acquire(wdev->mtx); | 
|  | } | 
|  |  | 
|  | static inline void wdev_unlock(struct wireless_dev *wdev) | 
|  | __releases(wdev) | 
|  | { | 
|  | __release(wdev->mtx); | 
|  | mutex_unlock(&wdev->mtx); | 
|  | } | 
|  |  | 
|  | #define ASSERT_RDEV_LOCK(rdev) lockdep_assert_held(&(rdev)->mtx) | 
|  | #define ASSERT_WDEV_LOCK(wdev) lockdep_assert_held(&(wdev)->mtx) | 
|  |  | 
|  | enum cfg80211_event_type { | 
|  | EVENT_CONNECT_RESULT, | 
|  | EVENT_ROAMED, | 
|  | EVENT_DISCONNECTED, | 
|  | EVENT_IBSS_JOINED, | 
|  | }; | 
|  |  | 
|  | struct cfg80211_event { | 
|  | struct list_head list; | 
|  | enum cfg80211_event_type type; | 
|  |  | 
|  | union { | 
|  | struct { | 
|  | u8 bssid[ETH_ALEN]; | 
|  | const u8 *req_ie; | 
|  | const u8 *resp_ie; | 
|  | size_t req_ie_len; | 
|  | size_t resp_ie_len; | 
|  | u16 status; | 
|  | } cr; | 
|  | struct { | 
|  | struct ieee80211_channel *channel; | 
|  | u8 bssid[ETH_ALEN]; | 
|  | const u8 *req_ie; | 
|  | const u8 *resp_ie; | 
|  | size_t req_ie_len; | 
|  | size_t resp_ie_len; | 
|  | } rm; | 
|  | struct { | 
|  | const u8 *ie; | 
|  | size_t ie_len; | 
|  | u16 reason; | 
|  | } dc; | 
|  | struct { | 
|  | u8 bssid[ETH_ALEN]; | 
|  | } ij; | 
|  | }; | 
|  | }; | 
|  |  | 
|  | struct cfg80211_cached_keys { | 
|  | struct key_params params[6]; | 
|  | u8 data[6][WLAN_MAX_KEY_LEN]; | 
|  | int def, defmgmt; | 
|  | }; | 
|  |  | 
|  |  | 
|  | /* free object */ | 
|  | extern void cfg80211_dev_free(struct cfg80211_registered_device *rdev); | 
|  |  | 
|  | extern int cfg80211_dev_rename(struct cfg80211_registered_device *rdev, | 
|  | char *newname); | 
|  |  | 
|  | void ieee80211_set_bitrate_flags(struct wiphy *wiphy); | 
|  | void wiphy_update_regulatory(struct wiphy *wiphy, | 
|  | enum nl80211_reg_initiator setby); | 
|  |  | 
|  | void cfg80211_bss_expire(struct cfg80211_registered_device *dev); | 
|  | void cfg80211_bss_age(struct cfg80211_registered_device *dev, | 
|  | unsigned long age_secs); | 
|  |  | 
|  | /* IBSS */ | 
|  | int __cfg80211_join_ibss(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct cfg80211_ibss_params *params, | 
|  | struct cfg80211_cached_keys *connkeys); | 
|  | int cfg80211_join_ibss(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct cfg80211_ibss_params *params, | 
|  | struct cfg80211_cached_keys *connkeys); | 
|  | void cfg80211_clear_ibss(struct net_device *dev, bool nowext); | 
|  | int __cfg80211_leave_ibss(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, bool nowext); | 
|  | int cfg80211_leave_ibss(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, bool nowext); | 
|  | void __cfg80211_ibss_joined(struct net_device *dev, const u8 *bssid); | 
|  | int cfg80211_ibss_wext_join(struct cfg80211_registered_device *rdev, | 
|  | struct wireless_dev *wdev); | 
|  |  | 
|  | /* mesh */ | 
|  | extern const struct mesh_config default_mesh_config; | 
|  | extern const struct mesh_setup default_mesh_setup; | 
|  | int __cfg80211_join_mesh(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | const struct mesh_setup *setup, | 
|  | const struct mesh_config *conf); | 
|  | int cfg80211_join_mesh(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | const struct mesh_setup *setup, | 
|  | const struct mesh_config *conf); | 
|  | int cfg80211_leave_mesh(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev); | 
|  |  | 
|  | /* MLME */ | 
|  | int __cfg80211_mlme_auth(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct ieee80211_channel *chan, | 
|  | enum nl80211_auth_type auth_type, | 
|  | const u8 *bssid, | 
|  | const u8 *ssid, int ssid_len, | 
|  | const u8 *ie, int ie_len, | 
|  | const u8 *key, int key_len, int key_idx, | 
|  | bool local_state_change); | 
|  | int cfg80211_mlme_auth(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, struct ieee80211_channel *chan, | 
|  | enum nl80211_auth_type auth_type, const u8 *bssid, | 
|  | const u8 *ssid, int ssid_len, | 
|  | const u8 *ie, int ie_len, | 
|  | const u8 *key, int key_len, int key_idx, | 
|  | bool local_state_change); | 
|  | int __cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct ieee80211_channel *chan, | 
|  | const u8 *bssid, const u8 *prev_bssid, | 
|  | const u8 *ssid, int ssid_len, | 
|  | const u8 *ie, int ie_len, bool use_mfp, | 
|  | struct cfg80211_crypto_settings *crypt); | 
|  | int cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, struct ieee80211_channel *chan, | 
|  | const u8 *bssid, const u8 *prev_bssid, | 
|  | const u8 *ssid, int ssid_len, | 
|  | const u8 *ie, int ie_len, bool use_mfp, | 
|  | struct cfg80211_crypto_settings *crypt); | 
|  | int __cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, const u8 *bssid, | 
|  | const u8 *ie, int ie_len, u16 reason, | 
|  | bool local_state_change); | 
|  | int cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, const u8 *bssid, | 
|  | const u8 *ie, int ie_len, u16 reason, | 
|  | bool local_state_change); | 
|  | int cfg80211_mlme_disassoc(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, const u8 *bssid, | 
|  | const u8 *ie, int ie_len, u16 reason, | 
|  | bool local_state_change); | 
|  | void cfg80211_mlme_down(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev); | 
|  | void __cfg80211_connect_result(struct net_device *dev, const u8 *bssid, | 
|  | const u8 *req_ie, size_t req_ie_len, | 
|  | const u8 *resp_ie, size_t resp_ie_len, | 
|  | u16 status, bool wextev, | 
|  | struct cfg80211_bss *bss); | 
|  | int cfg80211_mlme_register_mgmt(struct wireless_dev *wdev, u32 snd_pid, | 
|  | u16 frame_type, const u8 *match_data, | 
|  | int match_len); | 
|  | void cfg80211_mlme_unregister_socket(struct wireless_dev *wdev, u32 nlpid); | 
|  | void cfg80211_mlme_purge_registrations(struct wireless_dev *wdev); | 
|  | int cfg80211_mlme_mgmt_tx(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct ieee80211_channel *chan, bool offchan, | 
|  | enum nl80211_channel_type channel_type, | 
|  | bool channel_type_valid, unsigned int wait, | 
|  | const u8 *buf, size_t len, u64 *cookie); | 
|  |  | 
|  | /* SME */ | 
|  | int __cfg80211_connect(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct cfg80211_connect_params *connect, | 
|  | struct cfg80211_cached_keys *connkeys, | 
|  | const u8 *prev_bssid); | 
|  | int cfg80211_connect(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, | 
|  | struct cfg80211_connect_params *connect, | 
|  | struct cfg80211_cached_keys *connkeys); | 
|  | int __cfg80211_disconnect(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, u16 reason, | 
|  | bool wextev); | 
|  | int cfg80211_disconnect(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, u16 reason, | 
|  | bool wextev); | 
|  | void __cfg80211_roamed(struct wireless_dev *wdev, | 
|  | struct ieee80211_channel *channel, | 
|  | const u8 *bssid, | 
|  | const u8 *req_ie, size_t req_ie_len, | 
|  | const u8 *resp_ie, size_t resp_ie_len); | 
|  | int cfg80211_mgd_wext_connect(struct cfg80211_registered_device *rdev, | 
|  | struct wireless_dev *wdev); | 
|  |  | 
|  | void cfg80211_conn_work(struct work_struct *work); | 
|  | void cfg80211_sme_failed_assoc(struct wireless_dev *wdev); | 
|  | bool cfg80211_sme_failed_reassoc(struct wireless_dev *wdev); | 
|  |  | 
|  | /* internal helpers */ | 
|  | int cfg80211_validate_key_settings(struct cfg80211_registered_device *rdev, | 
|  | struct key_params *params, int key_idx, | 
|  | bool pairwise, const u8 *mac_addr); | 
|  | void __cfg80211_disconnected(struct net_device *dev, const u8 *ie, | 
|  | size_t ie_len, u16 reason, bool from_ap); | 
|  | void cfg80211_sme_scan_done(struct net_device *dev); | 
|  | void cfg80211_sme_rx_auth(struct net_device *dev, const u8 *buf, size_t len); | 
|  | void cfg80211_sme_disassoc(struct net_device *dev, int idx); | 
|  | void __cfg80211_scan_done(struct work_struct *wk); | 
|  | void ___cfg80211_scan_done(struct cfg80211_registered_device *rdev, bool leak); | 
|  | void __cfg80211_sched_scan_results(struct work_struct *wk); | 
|  | int __cfg80211_stop_sched_scan(struct cfg80211_registered_device *rdev, | 
|  | bool driver_initiated); | 
|  | void cfg80211_upload_connect_keys(struct wireless_dev *wdev); | 
|  | int cfg80211_change_iface(struct cfg80211_registered_device *rdev, | 
|  | struct net_device *dev, enum nl80211_iftype ntype, | 
|  | u32 *flags, struct vif_params *params); | 
|  | void cfg80211_process_rdev_events(struct cfg80211_registered_device *rdev); | 
|  |  | 
|  | int cfg80211_can_change_interface(struct cfg80211_registered_device *rdev, | 
|  | struct wireless_dev *wdev, | 
|  | enum nl80211_iftype iftype); | 
|  |  | 
|  | static inline int | 
|  | cfg80211_can_add_interface(struct cfg80211_registered_device *rdev, | 
|  | enum nl80211_iftype iftype) | 
|  | { | 
|  | return cfg80211_can_change_interface(rdev, NULL, iftype); | 
|  | } | 
|  |  | 
|  | struct ieee80211_channel * | 
|  | rdev_freq_to_chan(struct cfg80211_registered_device *rdev, | 
|  | int freq, enum nl80211_channel_type channel_type); | 
|  | int cfg80211_set_freq(struct cfg80211_registered_device *rdev, | 
|  | struct wireless_dev *wdev, int freq, | 
|  | enum nl80211_channel_type channel_type); | 
|  |  | 
|  | u16 cfg80211_calculate_bitrate(struct rate_info *rate); | 
|  |  | 
|  | int ieee80211_get_ratemask(struct ieee80211_supported_band *sband, | 
|  | const u8 *rates, unsigned int n_rates, | 
|  | u32 *mask); | 
|  |  | 
|  | int cfg80211_validate_beacon_int(struct cfg80211_registered_device *rdev, | 
|  | u32 beacon_int); | 
|  |  | 
|  | #ifdef CONFIG_CFG80211_DEVELOPER_WARNINGS | 
|  | #define CFG80211_DEV_WARN_ON(cond)	WARN_ON(cond) | 
|  | #else | 
|  | /* | 
|  | * Trick to enable using it as a condition, | 
|  | * and also not give a warning when it's | 
|  | * not used that way. | 
|  | */ | 
|  | #define CFG80211_DEV_WARN_ON(cond)	({bool __r = (cond); __r; }) | 
|  | #endif | 
|  |  | 
|  | #endif /* __NET_WIRELESS_CORE_H */ |