[mirror_ubuntu-bionic-kernel.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;

	struct mutex sched_scan_mtx;

#ifdef CONFIG_NL80211_TESTMODE
	struct genl_info *testmode_info;
#endif

	struct work_struct conn_work;
	struct work_struct event_work;

	struct cfg80211_wowlan *wowlan;

	/* must be last because of the way we do wiphy_priv(),
	 * and it should at least be aligned to NETDEV_ALIGN */
	struct wiphy wiphy __attribute__((__aligned__(NETDEV_ALIGN)));
};

static inline
struct cfg80211_registered_device *wiphy_to_dev(struct wiphy *wiphy)
{
	BUG_ON(!wiphy);
	return container_of(wiphy, struct cfg80211_registered_device, wiphy);
}

/* Note 0 is valid, hence phy0 */
static inline
bool wiphy_idx_valid(int wiphy_idx)
{
	return wiphy_idx >= 0;
}

static inline void
cfg80211_rdev_free_wowlan(struct cfg80211_registered_device *rdev)
{
	int i;

	if (!rdev->wowlan)
		return;
	for (i = 0; i < rdev->wowlan->n_patterns; i++)
		kfree(rdev->wowlan->patterns[i].mask);
	kfree(rdev->wowlan->patterns);
	kfree(rdev->wowlan);
}

extern struct workqueue_struct *cfg80211_wq;
extern struct mutex cfg80211_mutex;
extern struct list_head cfg80211_rdev_list;
extern int cfg80211_rdev_list_generation;

static inline void assert_cfg80211_lock(void)
{
	lockdep_assert_held(&cfg80211_mutex);
}

/*
 * You can use this to mark a wiphy_idx as not having an associated wiphy.
 * It guarantees cfg80211_rdev_by_wiphy_idx(wiphy_idx) will return NULL
 */
#define WIPHY_IDX_STALE -1

struct cfg80211_internal_bss {
	struct list_head list;
	struct rb_node rbn;
	unsigned long ts;
	struct kref ref;
	atomic_t hold;
	bool beacon_ies_allocated;
	bool proberesp_ies_allocated;

	/* must be last because of priv member */
	struct cfg80211_bss pub;
};

static inline struct cfg80211_internal_bss *bss_from_pub(struct cfg80211_bss *pub)
{
	return container_of(pub, struct cfg80211_internal_bss, pub);
}

static inline void cfg80211_ref_bss(struct cfg80211_internal_bss *bss)
{
	kref_get(&bss->ref);
}

static inline void cfg80211_hold_bss(struct cfg80211_internal_bss *bss)
{
	atomic_inc(&bss->hold);
}

static inline void cfg80211_unhold_bss(struct cfg80211_internal_bss *bss)
{
	int r = atomic_dec_return(&bss->hold);
	WARN_ON(r < 0);
}


struct cfg80211_registered_device *cfg80211_rdev_by_wiphy_idx(int wiphy_idx);
int get_wiphy_idx(struct wiphy *wiphy);

struct cfg80211_registered_device *
__cfg80211_rdev_from_info(struct genl_info *info);

/*
 * This function returns a pointer to the driver
 * that the genl_info item that is passed refers to.
 * If successful, it returns non-NULL and also locks
 * the driver's mutex!
 *
 * This means that you need to call cfg80211_unlock_rdev()
 * before being allowed to acquire &cfg80211_mutex!
 *
 * This is necessary because we need to lock the global
 * mutex to get an item off the list safely, and then
 * we lock the rdev mutex so it doesn't go away under us.
 *
 * We don't want to keep cfg80211_mutex locked
 * for all the time in order to allow requests on
 * other interfaces to go through at the same time.
 *
 * The result of this can be a PTR_ERR and hence must
 * be checked with IS_ERR() for errors.
 */
extern struct cfg80211_registered_device *
cfg80211_get_dev_from_info(struct genl_info *info);

/* requires cfg80211_rdev_mutex to be held! */
struct wiphy *wiphy_idx_to_wiphy(int wiphy_idx);

/* identical to cfg80211_get_dev_from_info but only operate on ifindex */
extern struct cfg80211_registered_device *
cfg80211_get_dev_from_ifindex(struct net *net, int ifindex);

int cfg80211_switch_netns(struct cfg80211_registered_device *rdev,
			  struct net *net);

static inline void cfg80211_lock_rdev(struct cfg80211_registered_device *rdev)
{
	mutex_lock(&rdev->mtx);
}

static inline void cfg80211_unlock_rdev(struct cfg80211_registered_device *rdev)
{
	BUG_ON(IS_ERR(rdev) || !rdev);
	mutex_unlock(&rdev->mtx);
}

static inline void wdev_lock(struct wireless_dev *wdev)
	__acquires(wdev)
{
	mutex_lock(&wdev->mtx);
	__acquire(wdev->mtx);
}

static inline void wdev_unlock(struct wireless_dev *wdev)
	__releases(wdev)
{
	__release(wdev->mtx);
	mutex_unlock(&wdev->mtx);
}

#define ASSERT_RDEV_LOCK(rdev) lockdep_assert_held(&(rdev)->mtx)
#define ASSERT_WDEV_LOCK(wdev) lockdep_assert_held(&(wdev)->mtx)

enum cfg80211_event_type {
	EVENT_CONNECT_RESULT,
	EVENT_ROAMED,
	EVENT_DISCONNECTED,
	EVENT_IBSS_JOINED,
};

struct cfg80211_event {
	struct list_head list;
	enum cfg80211_event_type type;

	union {
		struct {
			u8 bssid[ETH_ALEN];
			const u8 *req_ie;
			const u8 *resp_ie;
			size_t req_ie_len;
			size_t resp_ie_len;
			u16 status;
		} cr;
		struct {
			struct ieee80211_channel *channel;
			u8 bssid[ETH_ALEN];
			const u8 *req_ie;
			const u8 *resp_ie;
			size_t req_ie_len;
			size_t resp_ie_len;
		} rm;
		struct {
			const u8 *ie;
			size_t ie_len;
			u16 reason;
		} dc;
		struct {
			u8 bssid[ETH_ALEN];
		} ij;
	};
};

struct cfg80211_cached_keys {
	struct key_params params[6];
	u8 data[6][WLAN_MAX_KEY_LEN];
	int def, defmgmt;
};


/* free object */
extern void cfg80211_dev_free(struct cfg80211_registered_device *rdev);

extern int cfg80211_dev_rename(struct cfg80211_registered_device *rdev,
			       char *newname);

void ieee80211_set_bitrate_flags(struct wiphy *wiphy);

void 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, bool no_cck,
			  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 */
bool cfg80211_supported_cipher_suite(struct wiphy *wiphy, u32 cipher);
int cfg80211_validate_key_settings(struct cfg80211_registered_device *rdev,
				   struct key_params *params, int key_idx,
				   bool pairwise, const u8 *mac_addr);
void __cfg80211_disconnected(struct net_device *dev, const u8 *ie,
			     size_t ie_len, u16 reason, bool from_ap);
void cfg80211_sme_scan_done(struct net_device *dev);
void cfg80211_sme_rx_auth(struct net_device *dev, const u8 *buf, size_t len);
void cfg80211_sme_disassoc(struct net_device *dev, int idx);
void __cfg80211_scan_done(struct work_struct *wk);
void ___cfg80211_scan_done(struct cfg80211_registered_device *rdev, bool leak);
void __cfg80211_sched_scan_results(struct work_struct *wk);
int __cfg80211_stop_sched_scan(struct cfg80211_registered_device *rdev,
			       bool driver_initiated);
void cfg80211_upload_connect_keys(struct wireless_dev *wdev);
int cfg80211_change_iface(struct cfg80211_registered_device *rdev,
			  struct net_device *dev, enum nl80211_iftype ntype,
			  u32 *flags, struct vif_params *params);
void cfg80211_process_rdev_events(struct cfg80211_registered_device *rdev);

int cfg80211_can_change_interface(struct cfg80211_registered_device *rdev,
				  struct wireless_dev *wdev,
				  enum nl80211_iftype iftype);

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

struct ieee80211_channel *
rdev_freq_to_chan(struct cfg80211_registered_device *rdev,
		  int freq, enum nl80211_channel_type channel_type);
int cfg80211_set_freq(struct cfg80211_registered_device *rdev,
		      struct wireless_dev *wdev, int freq,
		      enum nl80211_channel_type channel_type);

u16 cfg80211_calculate_bitrate(struct rate_info *rate);

int ieee80211_get_ratemask(struct ieee80211_supported_band *sband,
			   const u8 *rates, unsigned int n_rates,
			   u32 *mask);

int cfg80211_validate_beacon_int(struct cfg80211_registered_device *rdev,
				 u32 beacon_int);

#ifdef CONFIG_CFG80211_DEVELOPER_WARNINGS
#define CFG80211_DEV_WARN_ON(cond)	WARN_ON(cond)
#else
/*
 * Trick to enable using it as a condition,
 * and also not give a warning when it's
 * not used that way.
 */
#define CFG80211_DEV_WARN_ON(cond)	({bool __r = (cond); __r; })
#endif

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