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

	struct list_head beacon_registrations;
	spinlock_t beacon_registrations_lock;

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

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

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

struct cfg80211_beacon_registration {
	struct list_head list;
	u32 nlportid;
};

/* 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_channel(struct cfg80211_registered_device *rdev,
			      struct wireless_dev *wdev,
			      struct cfg80211_chan_def *chandef);

/* 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,
			 const u8 *sae_data, int sae_data_len);
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,
		       const u8 *sae_data, int sae_data_len);
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 wireless_dev *wdev,
			  struct ieee80211_channel *chan, bool offchan,
			  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);
void cfg80211_process_wdev_events(struct wireless_dev *wdev);

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 wireless_dev *wdev,
		        struct ieee80211_channel **chan,
		        enum cfg80211_chan_mode *chanmode);

int cfg80211_set_monitor_channel(struct cfg80211_registered_device *rdev,
				 struct cfg80211_chan_def *chandef);

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
37c73b5f BG	58	struct list_head beacon_registrations;
37c73b5f BG	59	spinlock_t beacon_registrations_lock;
5e760230	60
c5a7e582	61	/* protected by RTNL only */
dbbae26a MK	62	int num_running_ifaces;
	63	int num_running_monitor_ifaces;
	64
2a519311 JB	65	/* BSSes/scanning */
	66	spinlock_t bss_lock;
	67	struct list_head bss_list;
	68	struct rb_root bss_tree;
	69	u32 bss_generation;
	70	struct cfg80211_scan_request scan_req; / protected by RTNL */
807f8a8c	71	struct cfg80211_sched_scan_request *sched_scan_req;
cb3a8eec	72	unsigned long suspend_at;
667503dd	73	struct work_struct scan_done_wk;
807f8a8c	74	struct work_struct sched_scan_results_wk;
2a519311	75
c10841ca LC	76	struct mutex sched_scan_mtx;
c10841ca LC	77
aff89a9b JB	78	#ifdef CONFIG_NL80211_TESTMODE
	79	struct genl_info *testmode_info;
	80	#endif
	81
6829c878	82	struct work_struct conn_work;
667503dd	83	struct work_struct event_work;
6829c878	84
ff1b6e69 JB	85	struct cfg80211_wowlan *wowlan;
ff1b6e69 JB	86
704232c2 JB	87	/* must be last because of the way we do wiphy_priv(),
	88	* and it should at least be aligned to NETDEV_ALIGN */
	89	struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
	90	};
	91
	92	static inline
	93	struct cfg80211_registered_device wiphy_to_dev(struct wiphy wiphy)
	94	{
	95	BUG_ON(!wiphy);
	96	return container_of(wiphy, struct cfg80211_registered_device, wiphy);
	97	}
	98
85fd129a LR	99	/* Note 0 is valid, hence phy0 */
	100	static inline
	101	bool wiphy_idx_valid(int wiphy_idx)
	102	{
a02cec21	103	return wiphy_idx >= 0;
85fd129a LR	104	}
85fd129a LR	105
ff1b6e69 JB	106	static inline void
	107	cfg80211_rdev_free_wowlan(struct cfg80211_registered_device *rdev)
	108	{
	109	int i;
	110
	111	if (!rdev->wowlan)
	112	return;
	113	for (i = 0; i < rdev->wowlan->n_patterns; i++)
	114	kfree(rdev->wowlan->patterns[i].mask);
	115	kfree(rdev->wowlan->patterns);
	116	kfree(rdev->wowlan);
	117	}
e60d7443 AB	118
e60d7443 AB	119	extern struct workqueue_struct *cfg80211_wq;
a1794390	120	extern struct mutex cfg80211_mutex;
79c97e97	121	extern struct list_head cfg80211_rdev_list;
f5ea9120	122	extern int cfg80211_rdev_list_generation;
704232c2	123
46a5ebaf JB	124	static inline void assert_cfg80211_lock(void)
	125	{
	126	lockdep_assert_held(&cfg80211_mutex);
	127	}
761cf7ec	128
806a9e39 LR	129	/*
806a9e39 LR	130	* You can use this to mark a wiphy_idx as not having an associated wiphy.
79c97e97	131	* It guarantees cfg80211_rdev_by_wiphy_idx(wiphy_idx) will return NULL
806a9e39 LR	132	*/
	133	#define WIPHY_IDX_STALE -1
	134
2a519311 JB	135	struct cfg80211_internal_bss {
	136	struct list_head list;
	137	struct rb_node rbn;
	138	unsigned long ts;
	139	struct kref ref;
19957bb3	140	atomic_t hold;
a08c1c1a	141
2a519311 JB	142	/* must be last because of priv member */
	143	struct cfg80211_bss pub;
	144	};
	145
19957bb3 JB	146	static inline struct cfg80211_internal_bss bss_from_pub(struct cfg80211_bss pub)
	147	{
	148	return container_of(pub, struct cfg80211_internal_bss, pub);
	149	}
	150
	151	static inline void cfg80211_hold_bss(struct cfg80211_internal_bss *bss)
	152	{
	153	atomic_inc(&bss->hold);
	154	}
	155
	156	static inline void cfg80211_unhold_bss(struct cfg80211_internal_bss *bss)
	157	{
	158	int r = atomic_dec_return(&bss->hold);
	159	WARN_ON(r < 0);
	160	}
	161
	162
79c97e97	163	struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx);
806a9e39 LR	164	int get_wiphy_idx(struct wiphy *wiphy);
806a9e39 LR	165
79c97e97	166	/* requires cfg80211_rdev_mutex to be held! */
806a9e39 LR	167	struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);
806a9e39 LR	168
55682965 JB	169	/* identical to cfg80211_get_dev_from_info but only operate on ifindex */
55682965 JB	170	extern struct cfg80211_registered_device *
463d0183 JB	171	cfg80211_get_dev_from_ifindex(struct net *net, int ifindex);
	172
	173	int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
	174	struct net *net);
55682965	175
79c97e97	176	static inline void cfg80211_lock_rdev(struct cfg80211_registered_device *rdev)
667503dd	177	{
79c97e97	178	mutex_lock(&rdev->mtx);
667503dd JB	179	}
667503dd JB	180
79c97e97	181	static inline void cfg80211_unlock_rdev(struct cfg80211_registered_device *rdev)
4d0c8aea	182	{
79c97e97 JB	183	BUG_ON(IS_ERR(rdev) \|\| !rdev);
79c97e97 JB	184	mutex_unlock(&rdev->mtx);
4d0c8aea	185	}
55682965	186
667503dd JB	187	static inline void wdev_lock(struct wireless_dev *wdev)
	188	__acquires(wdev)
	189	{
	190	mutex_lock(&wdev->mtx);
	191	__acquire(wdev->mtx);
	192	}
	193
	194	static inline void wdev_unlock(struct wireless_dev *wdev)
	195	__releases(wdev)
	196	{
	197	__release(wdev->mtx);
	198	mutex_unlock(&wdev->mtx);
	199	}
	200
46a5ebaf JB	201	#define ASSERT_RDEV_LOCK(rdev) lockdep_assert_held(&(rdev)->mtx)
46a5ebaf JB	202	#define ASSERT_WDEV_LOCK(wdev) lockdep_assert_held(&(wdev)->mtx)
667503dd	203
dbbae26a MK	204	static inline bool cfg80211_has_monitors_only(struct cfg80211_registered_device *rdev)
dbbae26a MK	205	{
c5a7e582	206	ASSERT_RTNL();
dbbae26a MK	207
	208	return rdev->num_running_ifaces == rdev->num_running_monitor_ifaces &&
	209	rdev->num_running_ifaces > 0;
	210	}
	211
667503dd JB	212	enum cfg80211_event_type {
	213	EVENT_CONNECT_RESULT,
	214	EVENT_ROAMED,
	215	EVENT_DISCONNECTED,
	216	EVENT_IBSS_JOINED,
	217	};
	218
	219	struct cfg80211_event {
	220	struct list_head list;
	221	enum cfg80211_event_type type;
	222
	223	union {
	224	struct {
	225	u8 bssid[ETH_ALEN];
	226	const u8 *req_ie;
	227	const u8 *resp_ie;
	228	size_t req_ie_len;
	229	size_t resp_ie_len;
	230	u16 status;
	231	} cr;
	232	struct {
667503dd JB	233	const u8 *req_ie;
	234	const u8 *resp_ie;
	235	size_t req_ie_len;
	236	size_t resp_ie_len;
adbde344	237	struct cfg80211_bss *bss;
667503dd JB	238	} rm;
	239	struct {
	240	const u8 *ie;
	241	size_t ie_len;
	242	u16 reason;
	243	} dc;
	244	struct {
	245	u8 bssid[ETH_ALEN];
	246	} ij;
	247	};
	248	};
	249
fffd0934 JB	250	struct cfg80211_cached_keys {
	251	struct key_params params[6];
	252	u8 data[6][WLAN_MAX_KEY_LEN];
	253	int def, defmgmt;
	254	};
	255
26ab9a0c MK	256	enum cfg80211_chan_mode {
	257	CHAN_MODE_UNDEFINED,
	258	CHAN_MODE_SHARED,
	259	CHAN_MODE_EXCLUSIVE,
	260	};
	261
37c73b5f BG	262	struct cfg80211_beacon_registration {
	263	struct list_head list;
	264	u32 nlportid;
	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);
683b6d3b JB	310	int cfg80211_set_mesh_channel(struct cfg80211_registered_device *rdev,
	311	struct wireless_dev *wdev,
	312	struct cfg80211_chan_def *chandef);
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,
e39e5b5e JM	326	const u8 *key, int key_len, int key_idx,
e39e5b5e JM	327	const u8 *sae_data, int sae_data_len);
19957bb3 JB	328	int cfg80211_mlme_auth(struct cfg80211_registered_device *rdev,
	329	struct net_device dev, struct ieee80211_channel chan,
	330	enum nl80211_auth_type auth_type, const u8 *bssid,
	331	const u8 *ssid, int ssid_len,
fffd0934	332	const u8 *ie, int ie_len,
e39e5b5e JM	333	const u8 *key, int key_len, int key_idx,
e39e5b5e JM	334	const u8 *sae_data, int sae_data_len);
667503dd JB	335	int __cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev,
	336	struct net_device *dev,
	337	struct ieee80211_channel *chan,
	338	const u8 bssid, const u8 prev_bssid,
	339	const u8 *ssid, int ssid_len,
	340	const u8 *ie, int ie_len, bool use_mfp,
7e7c8926 BG	341	struct cfg80211_crypto_settings *crypt,
	342	u32 assoc_flags, struct ieee80211_ht_cap *ht_capa,
	343	struct ieee80211_ht_cap *ht_capa_mask);
19957bb3 JB	344	int cfg80211_mlme_assoc(struct cfg80211_registered_device *rdev,
19957bb3 JB	345	struct net_device dev, struct ieee80211_channel chan,
3e5d7649 JB	346	const u8 bssid, const u8 prev_bssid,
3e5d7649 JB	347	const u8 *ssid, int ssid_len,
19957bb3	348	const u8 *ie, int ie_len, bool use_mfp,
7e7c8926 BG	349	struct cfg80211_crypto_settings *crypt,
	350	u32 assoc_flags, struct ieee80211_ht_cap *ht_capa,
	351	struct ieee80211_ht_cap *ht_capa_mask);
667503dd JB	352	int __cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev,
667503dd JB	353	struct net_device dev, const u8 bssid,
d5cdfacb JM	354	const u8 *ie, int ie_len, u16 reason,
d5cdfacb JM	355	bool local_state_change);
19957bb3 JB	356	int cfg80211_mlme_deauth(struct cfg80211_registered_device *rdev,
19957bb3 JB	357	struct net_device dev, const u8 bssid,
d5cdfacb JM	358	const u8 *ie, int ie_len, u16 reason,
d5cdfacb JM	359	bool local_state_change);
19957bb3 JB	360	int cfg80211_mlme_disassoc(struct cfg80211_registered_device *rdev,
19957bb3 JB	361	struct net_device dev, const u8 bssid,
d5cdfacb JM	362	const u8 *ie, int ie_len, u16 reason,
d5cdfacb JM	363	bool local_state_change);
19957bb3 JB	364	void cfg80211_mlme_down(struct cfg80211_registered_device *rdev,
19957bb3 JB	365	struct net_device *dev);
667503dd JB	366	void __cfg80211_connect_result(struct net_device dev, const u8 bssid,
	367	const u8 *req_ie, size_t req_ie_len,
	368	const u8 *resp_ie, size_t resp_ie_len,
df7fc0f9 JB	369	u16 status, bool wextev,
df7fc0f9 JB	370	struct cfg80211_bss *bss);
2e161f78 JB	371	int cfg80211_mlme_register_mgmt(struct wireless_dev *wdev, u32 snd_pid,
	372	u16 frame_type, const u8 *match_data,
	373	int match_len);
	374	void cfg80211_mlme_unregister_socket(struct wireless_dev *wdev, u32 nlpid);
	375	void cfg80211_mlme_purge_registrations(struct wireless_dev *wdev);
	376	int cfg80211_mlme_mgmt_tx(struct cfg80211_registered_device *rdev,
71bbc994	377	struct wireless_dev *wdev,
f7ca38df	378	struct ieee80211_channel *chan, bool offchan,
42d97a59 JB	379	unsigned int wait, const u8 *buf, size_t len,
42d97a59 JB	380	bool no_cck, 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);
1f6fc43e	432	void cfg80211_process_wdev_events(struct wireless_dev *wdev);
08645126	433
d4e50c59 MK	434	int cfg80211_can_use_iftype_chan(struct cfg80211_registered_device *rdev,
	435	struct wireless_dev *wdev,
	436	enum nl80211_iftype iftype,
	437	struct ieee80211_channel *chan,
	438	enum cfg80211_chan_mode chanmode);
	439
	440	static inline int
	441	cfg80211_can_change_interface(struct cfg80211_registered_device *rdev,
	442	struct wireless_dev *wdev,
	443	enum nl80211_iftype iftype)
	444	{
	445	return cfg80211_can_use_iftype_chan(rdev, wdev, iftype, NULL,
	446	CHAN_MODE_UNDEFINED);
	447	}
7527a782 JB	448
	449	static inline int
	450	cfg80211_can_add_interface(struct cfg80211_registered_device *rdev,
	451	enum nl80211_iftype iftype)
	452	{
	453	return cfg80211_can_change_interface(rdev, NULL, iftype);
	454	}
	455
d4e50c59 MK	456	static inline int
	457	cfg80211_can_use_chan(struct cfg80211_registered_device *rdev,
	458	struct wireless_dev *wdev,
	459	struct ieee80211_channel *chan,
	460	enum cfg80211_chan_mode chanmode)
	461	{
	462	return cfg80211_can_use_iftype_chan(rdev, wdev, wdev->iftype,
	463	chan, chanmode);
	464	}
	465
26ab9a0c	466	void
8e95ea49	467	cfg80211_get_chan_state(struct wireless_dev *wdev,
26ab9a0c MK	468	struct ieee80211_channel **chan,
	469	enum cfg80211_chan_mode *chanmode);
	470
e8c9bd5b	471	int cfg80211_set_monitor_channel(struct cfg80211_registered_device *rdev,
683b6d3b	472	struct cfg80211_chan_def *chandef);
59bbb6f7	473
34850ab2 JB	474	int ieee80211_get_ratemask(struct ieee80211_supported_band *sband,
	475	const u8 *rates, unsigned int n_rates,
	476	u32 *mask);
	477
56d1893d JB	478	int cfg80211_validate_beacon_int(struct cfg80211_registered_device *rdev,
	479	u32 beacon_int);
	480
dbbae26a MK	481	void cfg80211_update_iface_num(struct cfg80211_registered_device *rdev,
	482	enum nl80211_iftype iftype, int num);
	483
d4e50c59 MK	484	#define CFG80211_MAX_NUM_DIFFERENT_CHANNELS 10
d4e50c59 MK	485
f7969969 JB	486	#ifdef CONFIG_CFG80211_DEVELOPER_WARNINGS
	487	#define CFG80211_DEV_WARN_ON(cond) WARN_ON(cond)
	488	#else
	489	/*
	490	* Trick to enable using it as a condition,
	491	* and also not give a warning when it's
	492	* not used that way.
	493	*/
	494	#define CFG80211_DEV_WARN_ON(cond) ({bool __r = (cond); __r; })
	495	#endif
	496
704232c2	497	#endif /* __NET_WIRELESS_CORE_H */