[linux-2.6-block.git] / net / wireless / core.h

/*
 * 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;

	u32 ap_beacons_nlpid;

	/* 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 {
			const u8 *req_ie;
			const u8 *resp_ie;
			size_t req_ie_len;
			size_t resp_ie_len;
			struct cfg80211_bss *bss;
		} 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 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,
			  u32 assoc_flags, struct ieee80211_ht_cap *ht_capa,
			  struct ieee80211_ht_cap *ht_capa_mask);
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,
			u32 assoc_flags, struct ieee80211_ht_cap *ht_capa,
			struct ieee80211_ht_cap *ht_capa_mask);
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, bool no_cck,
			  bool dont_wait_for_ack, u64 *cookie);
void cfg80211_oper_and_ht_capa(struct ieee80211_ht_cap *ht_capa,
			       const struct ieee80211_ht_cap *ht_capa_mask);

/* 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 cfg80211_bss *bss,
		       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 */
bool cfg80211_supported_cipher_suite(struct wiphy *wiphy, u32 cipher);
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 */
Commit	Line	Data
704232c2 JB	1	/*
	2	* Wireless configuration interface internals.
	3	*
5f2aa25e	4	* Copyright 2006-2010 Johannes Berg <johannes@sipsolutions.net>
704232c2 JB	5	*/
	6	#ifndef __NET_WIRELESS_CORE_H
	7	#define __NET_WIRELESS_CORE_H
	8	#include <linux/mutex.h>
	9	#include <linux/list.h>
	10	#include <linux/netdevice.h>
2a519311 JB	11	#include <linux/kref.h>
2a519311 JB	12	#include <linux/rbtree.h>
1ac61302	13	#include <linux/debugfs.h>
1f87f7d3 JB	14	#include <linux/rfkill.h>
1f87f7d3 JB	15	#include <linux/workqueue.h>
704232c2	16	#include <net/genetlink.h>
704232c2	17	#include <net/cfg80211.h>
3f2355cb	18	#include "reg.h"
704232c2 JB	19
704232c2 JB	20	struct cfg80211_registered_device {
3dcf670b	21	const struct cfg80211_ops *ops;
704232c2 JB	22	struct list_head list;
	23	/* we hold this mutex during any call so that
	24	* we cannot do multiple calls at once, and also
	25	* to avoid the deregister call to proceed while
	26	* any call is in progress */
	27	struct mutex mtx;
	28
1f87f7d3 JB	29	/* rfkill support */
	30	struct rfkill_ops rfkill_ops;
	31	struct rfkill *rfkill;
	32	struct work_struct rfkill_sync;
	33
3f2355cb LR	34	/* ISO / IEC 3166 alpha2 for which this device is receiving
	35	* country IEs on, this can help disregard country IEs from APs
	36	* on the same alpha2 quickly. The alpha2 may differ from
	37	* cfg80211_regdomain's alpha2 when an intersection has occurred.
	38	* If the AP is reconfigured this can also be used to tell us if
	39	* the country on the country IE changed. */
	40	char country_ie_alpha2[2];
	41
	42	/* If a Country IE has been received this tells us the environment
	43	* which its telling us its in. This defaults to ENVIRON_ANY */
	44	enum environment_cap env;
	45
704232c2	46	/* wiphy index, internal only */
b5850a7a	47	int wiphy_idx;
704232c2 JB	48
	49	/* associate netdev list */
	50	struct mutex devlist_mtx;
5f2aa25e	51	/* protected by devlist_mtx or RCU */
704232c2	52	struct list_head netdev_list;
f5ea9120	53	int devlist_generation;
ad002395 JB	54	int opencount; /* also protected by devlist_mtx */
ad002395 JB	55	wait_queue_head_t dev_wait;
704232c2	56
5e760230 JB	57	u32 ap_beacons_nlpid;
5e760230 JB	58
2a519311 JB	59	/* BSSes/scanning */
	60	spinlock_t bss_lock;
	61	struct list_head bss_list;
	62	struct rb_root bss_tree;
	63	u32 bss_generation;
	64	struct cfg80211_scan_request scan_req; / protected by RTNL */
807f8a8c	65	struct cfg80211_sched_scan_request *sched_scan_req;
cb3a8eec	66	unsigned long suspend_at;
667503dd	67	struct work_struct scan_done_wk;
807f8a8c	68	struct work_struct sched_scan_results_wk;
2a519311	69
c10841ca LC	70	struct mutex sched_scan_mtx;
c10841ca LC	71
aff89a9b JB	72	#ifdef CONFIG_NL80211_TESTMODE
	73	struct genl_info *testmode_info;
	74	#endif
	75
6829c878	76	struct work_struct conn_work;
667503dd	77	struct work_struct event_work;
6829c878	78
ff1b6e69 JB	79	struct cfg80211_wowlan *wowlan;
ff1b6e69 JB	80
704232c2 JB	81	/* must be last because of the way we do wiphy_priv(),
	82	* and it should at least be aligned to NETDEV_ALIGN */
	83	struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
	84	};
	85
	86	static inline
	87	struct cfg80211_registered_device wiphy_to_dev(struct wiphy wiphy)
	88	{
	89	BUG_ON(!wiphy);
	90	return container_of(wiphy, struct cfg80211_registered_device, wiphy);
	91	}
	92
85fd129a LR	93	/* Note 0 is valid, hence phy0 */
	94	static inline
	95	bool wiphy_idx_valid(int wiphy_idx)
	96	{
a02cec21	97	return wiphy_idx >= 0;
85fd129a LR	98	}
85fd129a LR	99
ff1b6e69 JB	100	static inline void
	101	cfg80211_rdev_free_wowlan(struct cfg80211_registered_device *rdev)
	102	{
	103	int i;
	104
	105	if (!rdev->wowlan)
	106	return;
	107	for (i = 0; i < rdev->wowlan->n_patterns; i++)
	108	kfree(rdev->wowlan->patterns[i].mask);
	109	kfree(rdev->wowlan->patterns);
	110	kfree(rdev->wowlan);
	111	}
e60d7443 AB	112
e60d7443 AB	113	extern struct workqueue_struct *cfg80211_wq;
a1794390	114	extern struct mutex cfg80211_mutex;
79c97e97	115	extern struct list_head cfg80211_rdev_list;
f5ea9120	116	extern int cfg80211_rdev_list_generation;
704232c2	117
46a5ebaf JB	118	static inline void assert_cfg80211_lock(void)
	119	{
	120	lockdep_assert_held(&cfg80211_mutex);
	121	}
761cf7ec	122
806a9e39 LR	123	/*
806a9e39 LR	124	* You can use this to mark a wiphy_idx as not having an associated wiphy.
79c97e97	125	* It guarantees cfg80211_rdev_by_wiphy_idx(wiphy_idx) will return NULL
806a9e39 LR	126	*/
	127	#define WIPHY_IDX_STALE -1
	128
2a519311 JB	129	struct cfg80211_internal_bss {
	130	struct list_head list;
	131	struct rb_node rbn;
	132	unsigned long ts;
	133	struct kref ref;
19957bb3	134	atomic_t hold;
34a6eddb JM	135	bool beacon_ies_allocated;
34a6eddb JM	136	bool proberesp_ies_allocated;
a08c1c1a	137
2a519311 JB	138	/* must be last because of priv member */
	139	struct cfg80211_bss pub;
	140	};
	141
19957bb3 JB	142	static inline struct cfg80211_internal_bss bss_from_pub(struct cfg80211_bss pub)
	143	{
	144	return container_of(pub, struct cfg80211_internal_bss, pub);
	145	}
	146
df7fc0f9 JB	147	static inline void cfg80211_ref_bss(struct cfg80211_internal_bss *bss)
	148	{
	149	kref_get(&bss->ref);
	150	}
	151
19957bb3 JB	152	static inline void cfg80211_hold_bss(struct cfg80211_internal_bss *bss)
	153	{
	154	atomic_inc(&bss->hold);
	155	}
	156
	157	static inline void cfg80211_unhold_bss(struct cfg80211_internal_bss *bss)
	158	{
	159	int r = atomic_dec_return(&bss->hold);
	160	WARN_ON(r < 0);
	161	}
	162
	163
79c97e97	164	struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx);
806a9e39 LR	165	int get_wiphy_idx(struct wiphy *wiphy);
806a9e39 LR	166
4bbf4d56	167	struct cfg80211_registered_device *
79c97e97	168	__cfg80211_rdev_from_info(struct genl_info *info);
4bbf4d56	169
55682965 JB	170	/*
	171	* This function returns a pointer to the driver
	172	* that the genl_info item that is passed refers to.
	173	* If successful, it returns non-NULL and also locks
	174	* the driver's mutex!
	175	*
4d0c8aea	176	* This means that you need to call cfg80211_unlock_rdev()
a1794390	177	* before being allowed to acquire &cfg80211_mutex!
55682965 JB	178	*
	179	* This is necessary because we need to lock the global
	180	* mutex to get an item off the list safely, and then
79c97e97	181	* we lock the rdev mutex so it doesn't go away under us.
55682965	182	*
a1794390	183	* We don't want to keep cfg80211_mutex locked
55682965 JB	184	* for all the time in order to allow requests on
	185	* other interfaces to go through at the same time.
	186	*
	187	* The result of this can be a PTR_ERR and hence must
	188	* be checked with IS_ERR() for errors.
	189	*/
	190	extern struct cfg80211_registered_device *
	191	cfg80211_get_dev_from_info(struct genl_info *info);
	192
79c97e97	193	/* requires cfg80211_rdev_mutex to be held! */
806a9e39 LR	194	struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);
806a9e39 LR	195
55682965 JB	196	/* identical to cfg80211_get_dev_from_info but only operate on ifindex */
55682965 JB	197	extern struct cfg80211_registered_device *
463d0183 JB	198	cfg80211_get_dev_from_ifindex(struct net *net, int ifindex);
	199
	200	int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
	201	struct net *net);
55682965	202
79c97e97	203	static inline void cfg80211_lock_rdev(struct cfg80211_registered_device *rdev)
667503dd	204	{
79c97e97	205	mutex_lock(&rdev->mtx);
667503dd JB	206	}
667503dd JB	207
79c97e97	208	static inline void cfg80211_unlock_rdev(struct cfg80211_registered_device *rdev)
4d0c8aea	209	{
79c97e97 JB	210	BUG_ON(IS_ERR(rdev) \|\| !rdev);
79c97e97 JB	211	mutex_unlock(&rdev->mtx);
4d0c8aea	212	}
55682965	213
667503dd JB	214	static inline void wdev_lock(struct wireless_dev *wdev)
	215	__acquires(wdev)
	216	{
	217	mutex_lock(&wdev->mtx);
	218	__acquire(wdev->mtx);
	219	}
	220
	221	static inline void wdev_unlock(struct wireless_dev *wdev)
	222	__releases(wdev)
	223	{
	224	__release(wdev->mtx);
	225	mutex_unlock(&wdev->mtx);
	226	}
	227
46a5ebaf JB	228	#define ASSERT_RDEV_LOCK(rdev) lockdep_assert_held(&(rdev)->mtx)
46a5ebaf JB	229	#define ASSERT_WDEV_LOCK(wdev) lockdep_assert_held(&(wdev)->mtx)
667503dd JB	230
	231	enum cfg80211_event_type {
	232	EVENT_CONNECT_RESULT,
	233	EVENT_ROAMED,
	234	EVENT_DISCONNECTED,
	235	EVENT_IBSS_JOINED,
	236	};
	237
	238	struct cfg80211_event {
	239	struct list_head list;
	240	enum cfg80211_event_type type;
	241
	242	union {
	243	struct {
	244	u8 bssid[ETH_ALEN];
	245	const u8 *req_ie;
	246	const u8 *resp_ie;
	247	size_t req_ie_len;
	248	size_t resp_ie_len;
	249	u16 status;
	250	} cr;
	251	struct {
667503dd JB	252	const u8 *req_ie;
	253	const u8 *resp_ie;
	254	size_t req_ie_len;
	255	size_t resp_ie_len;
adbde344	256	struct cfg80211_bss *bss;
667503dd JB	257	} rm;
	258	struct {
	259	const u8 *ie;
	260	size_t ie_len;
	261	u16 reason;
	262	} dc;
	263	struct {
	264	u8 bssid[ETH_ALEN];
	265	} ij;
	266	};
	267	};
	268
fffd0934 JB	269	struct cfg80211_cached_keys {
	270	struct key_params params[6];
	271	u8 data[6][WLAN_MAX_KEY_LEN];
	272	int def, defmgmt;
	273	};
	274
667503dd	275
704232c2	276	/* free object */
79c97e97	277	extern void cfg80211_dev_free(struct cfg80211_registered_device *rdev);
704232c2	278
79c97e97	279	extern int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
55682965 JB	280	char *newname);
55682965 JB	281
8318d78a	282	void ieee80211_set_bitrate_flags(struct wiphy *wiphy);
8318d78a	283
2a519311	284	void cfg80211_bss_expire(struct cfg80211_registered_device *dev);
cb3a8eec DW	285	void cfg80211_bss_age(struct cfg80211_registered_device *dev,
cb3a8eec DW	286	unsigned long age_secs);
2a519311	287
04a773ad	288	/* IBSS */
667503dd JB	289	int __cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
667503dd JB	290	struct net_device *dev,
fffd0934 JB	291	struct cfg80211_ibss_params *params,
fffd0934 JB	292	struct cfg80211_cached_keys *connkeys);
04a773ad JB	293	int cfg80211_join_ibss(struct cfg80211_registered_device *rdev,
04a773ad JB	294	struct net_device *dev,
fffd0934 JB	295	struct cfg80211_ibss_params *params,
fffd0934 JB	296	struct cfg80211_cached_keys *connkeys);
9d308429	297	void cfg80211_clear_ibss(struct net_device *dev, bool nowext);
98d3a7ca JB	298	int __cfg80211_leave_ibss(struct cfg80211_registered_device *rdev,
98d3a7ca JB	299	struct net_device *dev, bool nowext);
04a773ad	300	int cfg80211_leave_ibss(struct cfg80211_registered_device *rdev,
9d308429	301	struct net_device *dev, bool nowext);
667503dd	302	void __cfg80211_ibss_joined(struct net_device dev, const u8 bssid);
fffd0934 JB	303	int cfg80211_ibss_wext_join(struct cfg80211_registered_device *rdev,
fffd0934 JB	304	struct wireless_dev *wdev);
04a773ad	305
29cbe68c JB	306	/* mesh */
29cbe68c JB	307	extern const struct mesh_config default_mesh_config;
c80d545d	308	extern const struct mesh_setup default_mesh_setup;
29cbe68c JB	309	int __cfg80211_join_mesh(struct cfg80211_registered_device *rdev,
29cbe68c JB	310	struct net_device *dev,
c80d545d	311	const struct mesh_setup *setup,
29cbe68c JB	312	const struct mesh_config *conf);
	313	int cfg80211_join_mesh(struct cfg80211_registered_device *rdev,
	314	struct net_device *dev,
c80d545d	315	const struct mesh_setup *setup,
29cbe68c JB	316	const struct mesh_config *conf);
	317	int cfg80211_leave_mesh(struct cfg80211_registered_device *rdev,
	318	struct net_device *dev);
	319
19957bb3	320	/* MLME */
667503dd JB	321	int __cfg80211_mlme_auth(struct cfg80211_registered_device *rdev,
	322	struct net_device *dev,
	323	struct ieee80211_channel *chan,
	324	enum nl80211_auth_type auth_type,
	325	const u8 *bssid,
	326	const u8 *ssid, int ssid_len,
fffd0934	327	const u8 *ie, int ie_len,
d5cdfacb JM	328	const u8 *key, int key_len, int key_idx,
d5cdfacb JM	329	bool local_state_change);
19957bb3 JB	330	int cfg80211_mlme_auth(struct cfg80211_registered_device *rdev,
	331	struct net_device dev, struct ieee80211_channel chan,
	332	enum nl80211_auth_type auth_type, const u8 *bssid,
	333	const u8 *ssid, int ssid_len,
fffd0934	334	const u8 *ie, int ie_len,
d5cdfacb JM	335	const u8 *key, int key_len, int key_idx,
d5cdfacb JM	336	bool local_state_change);
667503dd JB	337	int __cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev,
	338	struct net_device *dev,
	339	struct ieee80211_channel *chan,
	340	const u8 bssid, const u8 prev_bssid,
	341	const u8 *ssid, int ssid_len,
	342	const u8 *ie, int ie_len, bool use_mfp,
7e7c8926 BG	343	struct cfg80211_crypto_settings *crypt,
	344	u32 assoc_flags, struct ieee80211_ht_cap *ht_capa,
	345	struct ieee80211_ht_cap *ht_capa_mask);
19957bb3 JB	346	int cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev,
19957bb3 JB	347	struct net_device dev, struct ieee80211_channel chan,
3e5d7649 JB	348	const u8 bssid, const u8 prev_bssid,
3e5d7649 JB	349	const u8 *ssid, int ssid_len,
19957bb3	350	const u8 *ie, int ie_len, bool use_mfp,
7e7c8926 BG	351	struct cfg80211_crypto_settings *crypt,
	352	u32 assoc_flags, struct ieee80211_ht_cap *ht_capa,
	353	struct ieee80211_ht_cap *ht_capa_mask);
667503dd JB	354	int __cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev,
667503dd JB	355	struct net_device dev, const u8 bssid,
d5cdfacb JM	356	const u8 *ie, int ie_len, u16 reason,
d5cdfacb JM	357	bool local_state_change);
19957bb3 JB	358	int cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev,
19957bb3 JB	359	struct net_device dev, const u8 bssid,
d5cdfacb JM	360	const u8 *ie, int ie_len, u16 reason,
d5cdfacb JM	361	bool local_state_change);
19957bb3 JB	362	int cfg80211_mlme_disassoc(struct cfg80211_registered_device *rdev,
19957bb3 JB	363	struct net_device dev, const u8 bssid,
d5cdfacb JM	364	const u8 *ie, int ie_len, u16 reason,
d5cdfacb JM	365	bool local_state_change);
19957bb3 JB	366	void cfg80211_mlme_down(struct cfg80211_registered_device *rdev,
19957bb3 JB	367	struct net_device *dev);
667503dd JB	368	void __cfg80211_connect_result(struct net_device dev, const u8 bssid,
	369	const u8 *req_ie, size_t req_ie_len,
	370	const u8 *resp_ie, size_t resp_ie_len,
df7fc0f9 JB	371	u16 status, bool wextev,
df7fc0f9 JB	372	struct cfg80211_bss *bss);
2e161f78 JB	373	int cfg80211_mlme_register_mgmt(struct wireless_dev *wdev, u32 snd_pid,
	374	u16 frame_type, const u8 *match_data,
	375	int match_len);
	376	void cfg80211_mlme_unregister_socket(struct wireless_dev *wdev, u32 nlpid);
	377	void cfg80211_mlme_purge_registrations(struct wireless_dev *wdev);
	378	int cfg80211_mlme_mgmt_tx(struct cfg80211_registered_device *rdev,
	379	struct net_device *dev,
f7ca38df	380	struct ieee80211_channel *chan, bool offchan,
2e161f78	381	enum nl80211_channel_type channel_type,
f7ca38df	382	bool channel_type_valid, unsigned int wait,
e9f935e3	383	const u8 *buf, size_t len, bool no_cck,
e247bd90	384	bool dont_wait_for_ack, u64 *cookie);
7e7c8926 BG	385	void cfg80211_oper_and_ht_capa(struct ieee80211_ht_cap *ht_capa,
7e7c8926 BG	386	const struct ieee80211_ht_cap *ht_capa_mask);
19957bb3	387
b23aa676	388	/* SME */
667503dd JB	389	int __cfg80211_connect(struct cfg80211_registered_device *rdev,
667503dd JB	390	struct net_device *dev,
fffd0934	391	struct cfg80211_connect_params *connect,
f401a6f7 JB	392	struct cfg80211_cached_keys *connkeys,
f401a6f7 JB	393	const u8 *prev_bssid);
b23aa676 SO	394	int cfg80211_connect(struct cfg80211_registered_device *rdev,
b23aa676 SO	395	struct net_device *dev,
fffd0934 JB	396	struct cfg80211_connect_params *connect,
fffd0934 JB	397	struct cfg80211_cached_keys *connkeys);
667503dd JB	398	int __cfg80211_disconnect(struct cfg80211_registered_device *rdev,
	399	struct net_device *dev, u16 reason,
	400	bool wextev);
b23aa676	401	int cfg80211_disconnect(struct cfg80211_registered_device *rdev,
f2129354 JB	402	struct net_device *dev, u16 reason,
f2129354 JB	403	bool wextev);
ed9d0102	404	void __cfg80211_roamed(struct wireless_dev *wdev,
adbde344	405	struct cfg80211_bss *bss,
667503dd JB	406	const u8 *req_ie, size_t req_ie_len,
667503dd JB	407	const u8 *resp_ie, size_t resp_ie_len);
fffd0934 JB	408	int cfg80211_mgd_wext_connect(struct cfg80211_registered_device *rdev,
fffd0934 JB	409	struct wireless_dev *wdev);
b23aa676	410
6829c878	411	void cfg80211_conn_work(struct work_struct *work);
7d930bc3	412	void cfg80211_sme_failed_assoc(struct wireless_dev *wdev);
f401a6f7	413	bool cfg80211_sme_failed_reassoc(struct wireless_dev *wdev);
6829c878	414
08645126	415	/* internal helpers */
38ba3c57	416	bool cfg80211_supported_cipher_suite(struct wiphy *wiphy, u32 cipher);
fffd0934 JB	417	int cfg80211_validate_key_settings(struct cfg80211_registered_device *rdev,
fffd0934 JB	418	struct key_params *params, int key_idx,
e31b8213	419	bool pairwise, const u8 *mac_addr);
667503dd	420	void __cfg80211_disconnected(struct net_device dev, const u8 ie,
6829c878 JB	421	size_t ie_len, u16 reason, bool from_ap);
	422	void cfg80211_sme_scan_done(struct net_device *dev);
	423	void cfg80211_sme_rx_auth(struct net_device dev, const u8 buf, size_t len);
19957bb3	424	void cfg80211_sme_disassoc(struct net_device *dev, int idx);
667503dd	425	void __cfg80211_scan_done(struct work_struct *wk);
01a0ac41	426	void ___cfg80211_scan_done(struct cfg80211_registered_device *rdev, bool leak);
807f8a8c LC	427	void __cfg80211_sched_scan_results(struct work_struct *wk);
	428	int __cfg80211_stop_sched_scan(struct cfg80211_registered_device *rdev,
	429	bool driver_initiated);
fffd0934	430	void cfg80211_upload_connect_keys(struct wireless_dev *wdev);
3d54d255 JB	431	int cfg80211_change_iface(struct cfg80211_registered_device *rdev,
	432	struct net_device *dev, enum nl80211_iftype ntype,
	433	u32 flags, struct vif_params params);
	434	void cfg80211_process_rdev_events(struct cfg80211_registered_device *rdev);
08645126	435
7527a782 JB	436	int cfg80211_can_change_interface(struct cfg80211_registered_device *rdev,
	437	struct wireless_dev *wdev,
	438	enum nl80211_iftype iftype);
	439
	440	static inline int
	441	cfg80211_can_add_interface(struct cfg80211_registered_device *rdev,
	442	enum nl80211_iftype iftype)
	443	{
	444	return cfg80211_can_change_interface(rdev, NULL, iftype);
	445	}
	446
9588bbd5 JM	447	struct ieee80211_channel *
	448	rdev_freq_to_chan(struct cfg80211_registered_device *rdev,
	449	int freq, enum nl80211_channel_type channel_type);
f444de05 JB	450	int cfg80211_set_freq(struct cfg80211_registered_device *rdev,
	451	struct wireless_dev *wdev, int freq,
	452	enum nl80211_channel_type channel_type);
59bbb6f7	453
254416aa JL	454	u16 cfg80211_calculate_bitrate(struct rate_info *rate);
254416aa JL	455
34850ab2 JB	456	int ieee80211_get_ratemask(struct ieee80211_supported_band *sband,
	457	const u8 *rates, unsigned int n_rates,
	458	u32 *mask);
	459
56d1893d JB	460	int cfg80211_validate_beacon_int(struct cfg80211_registered_device *rdev,
	461	u32 beacon_int);
	462
f7969969 JB	463	#ifdef CONFIG_CFG80211_DEVELOPER_WARNINGS
	464	#define CFG80211_DEV_WARN_ON(cond) WARN_ON(cond)
	465	#else
	466	/*
	467	* Trick to enable using it as a condition,
	468	* and also not give a warning when it's
	469	* not used that way.
	470	*/
	471	#define CFG80211_DEV_WARN_ON(cond) ({bool __r = (cond); __r; })
	472	#endif
	473
704232c2	474	#endif /* __NET_WIRELESS_CORE_H */