[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 <linux/rtnetlink.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;

	/* associated wireless interfaces */
	struct mutex devlist_mtx;
	/* protected by devlist_mtx or RCU */
	struct list_head wdev_list;
	int devlist_generation, wdev_id;
	int opencount; /* also protected by devlist_mtx */
	wait_queue_head_t dev_wait;

	u32 ap_beacons_nlpid;

	/* protected by RTNL only */
	int num_running_ifaces;
	int num_running_monitor_ifaces;

	struct ieee80211_channel *monitor_channel;
	enum nl80211_channel_type monitor_channel_type;

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

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

static inline bool cfg80211_has_monitors_only(struct cfg80211_registered_device *rdev)
{
	ASSERT_RTNL();

	return rdev->num_running_ifaces == rdev->num_running_monitor_ifaces &&
	       rdev->num_running_ifaces > 0;
}

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

enum cfg80211_chan_mode {
	CHAN_MODE_UNDEFINED,
	CHAN_MODE_SHARED,
	CHAN_MODE_EXCLUSIVE,
};


/* 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,
			 struct mesh_setup *setup,
			 const struct mesh_config *conf);
int cfg80211_join_mesh(struct cfg80211_registered_device *rdev,
		       struct net_device *dev,
		       struct mesh_setup *setup,
		       const struct mesh_config *conf);
int cfg80211_leave_mesh(struct cfg80211_registered_device *rdev,
			struct net_device *dev);
int cfg80211_set_mesh_freq(struct cfg80211_registered_device *rdev,
			   struct wireless_dev *wdev, int freq,
			   enum nl80211_channel_type channel_type);

/* AP */
int cfg80211_stop_ap(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);
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);
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,
			   struct cfg80211_internal_bss *bss);
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_use_iftype_chan(struct cfg80211_registered_device *rdev,
				 struct wireless_dev *wdev,
				 enum nl80211_iftype iftype,
				 struct ieee80211_channel *chan,
				 enum cfg80211_chan_mode chanmode);

static inline int
cfg80211_can_change_interface(struct cfg80211_registered_device *rdev,
			      struct wireless_dev *wdev,
			      enum nl80211_iftype iftype)
{
	return cfg80211_can_use_iftype_chan(rdev, wdev, iftype, NULL,
					    CHAN_MODE_UNDEFINED);
}

static inline int
cfg80211_can_add_interface(struct cfg80211_registered_device *rdev,
			   enum nl80211_iftype iftype)
{
	return cfg80211_can_change_interface(rdev, NULL, iftype);
}

static inline int
cfg80211_can_use_chan(struct cfg80211_registered_device *rdev,
		      struct wireless_dev *wdev,
		      struct ieee80211_channel *chan,
		      enum cfg80211_chan_mode chanmode)
{
	return cfg80211_can_use_iftype_chan(rdev, wdev, wdev->iftype,
					    chan, chanmode);
}

void
cfg80211_get_chan_state(struct cfg80211_registered_device *rdev,
		        struct wireless_dev *wdev,
		        struct ieee80211_channel **chan,
		        enum cfg80211_chan_mode *chanmode);

struct ieee80211_channel *
rdev_freq_to_chan(struct cfg80211_registered_device *rdev,
		  int freq, enum nl80211_channel_type channel_type);
int cfg80211_set_monitor_channel(struct cfg80211_registered_device *rdev,
				 int freq, enum nl80211_channel_type chantype);

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

void cfg80211_update_iface_num(struct cfg80211_registered_device *rdev,
			       enum nl80211_iftype iftype, int num);

#define CFG80211_MAX_NUM_DIFFERENT_CHANNELS 10

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