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