[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;

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

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