[thirdparty/linux.git] / net / mac80211 / rate.h

/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright 2002-2005, Instant802 Networks, Inc.
 * Copyright 2005, Devicescape Software, Inc.
 * Copyright (c) 2006 Jiri Benc <jbenc@suse.cz>
 * Copyright (C) 2022 Intel Corporation
 */

#ifndef IEEE80211_RATE_H
#define IEEE80211_RATE_H

#include <linux/netdevice.h>
#include <linux/skbuff.h>
#include <linux/types.h>
#include <net/mac80211.h>
#include "ieee80211_i.h"
#include "sta_info.h"
#include "driver-ops.h"

struct rate_control_ref {
	const struct rate_control_ops *ops;
	void *priv;
};

void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
			   struct sta_info *sta,
			   struct ieee80211_tx_rate_control *txrc);

void rate_control_tx_status(struct ieee80211_local *local,
			    struct ieee80211_tx_status *st);

void rate_control_rate_init(struct sta_info *sta);
void rate_control_rate_update(struct ieee80211_local *local,
			      struct ieee80211_supported_band *sband,
			      struct sta_info *sta,
			      unsigned int link_id,
			      u32 changed);

static inline void *rate_control_alloc_sta(struct rate_control_ref *ref,
					   struct sta_info *sta, gfp_t gfp)
{
	spin_lock_init(&sta->rate_ctrl_lock);
	return ref->ops->alloc_sta(ref->priv, &sta->sta, gfp);
}

static inline void rate_control_free_sta(struct sta_info *sta)
{
	struct rate_control_ref *ref = sta->rate_ctrl;
	struct ieee80211_sta *ista = &sta->sta;
	void *priv_sta = sta->rate_ctrl_priv;

	ref->ops->free_sta(ref->priv, ista, priv_sta);
}

static inline void rate_control_add_sta_debugfs(struct sta_info *sta)
{
#ifdef CONFIG_MAC80211_DEBUGFS
	struct rate_control_ref *ref = sta->rate_ctrl;
	if (ref && sta->debugfs_dir && ref->ops->add_sta_debugfs)
		ref->ops->add_sta_debugfs(ref->priv, sta->rate_ctrl_priv,
					  sta->debugfs_dir);
#endif
}

extern const struct file_operations rcname_ops;

static inline void rate_control_add_debugfs(struct ieee80211_local *local)
{
#ifdef CONFIG_MAC80211_DEBUGFS
	struct dentry *debugfsdir;

	if (!local->rate_ctrl)
		return;

	if (!local->rate_ctrl->ops->add_debugfs)
		return;

	debugfsdir = debugfs_create_dir("rc", local->hw.wiphy->debugfsdir);
	local->debugfs.rcdir = debugfsdir;
	debugfs_create_file("name", 0400, debugfsdir,
			    local->rate_ctrl, &rcname_ops);

	local->rate_ctrl->ops->add_debugfs(&local->hw, local->rate_ctrl->priv,
					   debugfsdir);
#endif
}

void ieee80211_check_rate_mask(struct ieee80211_link_data *link);

/* Get a reference to the rate control algorithm. If `name' is NULL, get the
 * first available algorithm. */
int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
				 const char *name);
void rate_control_deinitialize(struct ieee80211_local *local);


/* Rate control algorithms */
#ifdef CONFIG_MAC80211_RC_MINSTREL
int rc80211_minstrel_init(void);
void rc80211_minstrel_exit(void);
#else
static inline int rc80211_minstrel_init(void)
{
	return 0;
}
static inline void rc80211_minstrel_exit(void)
{
}
#endif


#endif /* IEEE80211_RATE_H */
Commit	Line	Data
d2912cb1	1	/* SPDX-License-Identifier: GPL-2.0-only */
f0706e82 JB	2	/*
	3	* Copyright 2002-2005, Instant802 Networks, Inc.
	4	* Copyright 2005, Devicescape Software, Inc.
	5	* Copyright (c) 2006 Jiri Benc <jbenc@suse.cz>
b4f85443	6	* Copyright (C) 2022 Intel Corporation
f0706e82 JB	7	*/
	8
	9	#ifndef IEEE80211_RATE_H
	10	#define IEEE80211_RATE_H
	11
	12	#include <linux/netdevice.h>
	13	#include <linux/skbuff.h>
	14	#include <linux/types.h>
	15	#include <net/mac80211.h>
	16	#include "ieee80211_i.h"
	17	#include "sta_info.h"
8f727ef3	18	#include "driver-ops.h"
f0706e82	19
f0706e82	20	struct rate_control_ref {
631ad703	21	const struct rate_control_ops *ops;
f0706e82	22	void *priv;
f0706e82 JB	23	};
f0706e82 JB	24
4b7679a5	25	void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
e6a9854b JB	26	struct sta_info *sta,
e6a9854b JB	27	struct ieee80211_tx_rate_control *txrc);
f0706e82	28
18fb84d9	29	void rate_control_tx_status(struct ieee80211_local *local,
18fb84d9	30	struct ieee80211_tx_status *st);
f0706e82	31
eb6d9293 DV	32	void rate_control_rate_init(struct sta_info *sta);
eb6d9293 DV	33	void rate_control_rate_update(struct ieee80211_local *local,
b4f85443 JB	34	struct ieee80211_supported_band *sband,
	35	struct sta_info *sta,
	36	unsigned int link_id,
	37	u32 changed);
f0706e82	38
f0706e82	39	static inline void rate_control_alloc_sta(struct rate_control_ref ref,
35c347ac	40	struct sta_info *sta, gfp_t gfp)
f0706e82	41	{
35c347ac JB	42	spin_lock_init(&sta->rate_ctrl_lock);
35c347ac JB	43	return ref->ops->alloc_sta(ref->priv, &sta->sta, gfp);
f0706e82 JB	44	}
f0706e82 JB	45
4b7679a5	46	static inline void rate_control_free_sta(struct sta_info *sta)
f0706e82	47	{
4b7679a5 JB	48	struct rate_control_ref *ref = sta->rate_ctrl;
	49	struct ieee80211_sta *ista = &sta->sta;
	50	void *priv_sta = sta->rate_ctrl_priv;
	51
	52	ref->ops->free_sta(ref->priv, ista, priv_sta);
f0706e82 JB	53	}
f0706e82 JB	54
e9f207f0 JB	55	static inline void rate_control_add_sta_debugfs(struct sta_info *sta)
	56	{
	57	#ifdef CONFIG_MAC80211_DEBUGFS
	58	struct rate_control_ref *ref = sta->rate_ctrl;
fc4a25c5	59	if (ref && sta->debugfs_dir && ref->ops->add_sta_debugfs)
e9f207f0	60	ref->ops->add_sta_debugfs(ref->priv, sta->rate_ctrl_priv,
fc4a25c5	61	sta->debugfs_dir);
e9f207f0 JB	62	#endif
	63	}
	64
6cb5f3ea JB	65	extern const struct file_operations rcname_ops;
	66
	67	static inline void rate_control_add_debugfs(struct ieee80211_local *local)
	68	{
	69	#ifdef CONFIG_MAC80211_DEBUGFS
	70	struct dentry *debugfsdir;
	71
	72	if (!local->rate_ctrl)
	73	return;
	74
	75	if (!local->rate_ctrl->ops->add_debugfs)
	76	return;
	77
	78	debugfsdir = debugfs_create_dir("rc", local->hw.wiphy->debugfsdir);
	79	local->debugfs.rcdir = debugfsdir;
	80	debugfs_create_file("name", 0400, debugfsdir,
	81	local->rate_ctrl, &rcname_ops);
	82
	83	local->rate_ctrl->ops->add_debugfs(&local->hw, local->rate_ctrl->priv,
	84	debugfsdir);
	85	#endif
	86	}
	87
de03f8ac	88	void ieee80211_check_rate_mask(struct ieee80211_link_data *link);
e8e4f528	89
209c671d AS	90	/* Get a reference to the rate control algorithm. If `name' is NULL, get the
209c671d AS	91	* first available algorithm. */
ff688089 JB	92	int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
	93	const char *name);
	94	void rate_control_deinitialize(struct ieee80211_local *local);
	95
4b475898 JB	96
4b475898 JB	97	/* Rate control algorithms */
cccf129f	98	#ifdef CONFIG_MAC80211_RC_MINSTREL
c1b1203d JP	99	int rc80211_minstrel_init(void);
c1b1203d JP	100	void rc80211_minstrel_exit(void);
cccf129f FF	101	#else
	102	static inline int rc80211_minstrel_init(void)
	103	{
	104	return 0;
	105	}
	106	static inline void rc80211_minstrel_exit(void)
	107	{
	108	}
	109	#endif
	110
	111
f0706e82	112	#endif /* IEEE80211_RATE_H */