LXR linux/net/mac80211/rate.h

   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