net/mac80211/rate.h

   1 /*
   2  * Copyright 2002-2005, Instant802 Networks, Inc.
   3  * Copyright 2005, Devicescape Software, Inc.
   4  * Copyright (c) 2006 Jiri Benc <jbenc@suse.cz>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 as
   8  * published by the Free Software Foundation.
   9  */
  10
  11 #ifndef IEEE80211_RATE_H
  12 #define IEEE80211_RATE_H
  13
  14 #include <linux/netdevice.h>
  15 #include <linux/skbuff.h>
  16 #include <linux/types.h>
  17 #include <linux/kref.h>
  18 #include <net/mac80211.h>
  19 #include "ieee80211_i.h"
  20 #include "sta_info.h"
  21
  22 struct rate_control_ref {
  23         struct ieee80211_local *local;
  24         struct rate_control_ops *ops;
  25         void *priv;
  26         struct kref kref;
  27 };
  28
  29 /* Get a reference to the rate control algorithm. If `name' is NULL, get the
  30  * first available algorithm. */
  31 struct rate_control_ref *rate_control_alloc(const char *name,
  32                                             struct ieee80211_local *local);
  33 void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
  34                            struct sta_info *sta,
  35                            struct ieee80211_tx_rate_control *txrc);
  36 struct rate_control_ref *rate_control_get(struct rate_control_ref *ref);
  37 void rate_control_put(struct rate_control_ref *ref);
  38
  39 static inline void rate_control_tx_status(struct ieee80211_local *local,
  40                                           struct ieee80211_supported_band *sband,
  41                                           struct sta_info *sta,
  42                                           struct sk_buff *skb)
  43 {
  44         struct rate_control_ref *ref = local->rate_ctrl;
  45         struct ieee80211_sta *ista = &sta->sta;
  46         void *priv_sta = sta->rate_ctrl_priv;
  47         struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
  48
  49         if (likely(info->flags & IEEE80211_TX_INTFL_RCALGO))
  50                 ref->ops->tx_status(ref->priv, sband, ista, priv_sta, skb);
  51 }
  52
  53
  54 static inline void rate_control_rate_init(struct sta_info *sta)
  55 {
  56         struct ieee80211_local *local = sta->sdata->local;
  57         struct rate_control_ref *ref = sta->rate_ctrl;
  58         struct ieee80211_sta *ista = &sta->sta;
  59         void *priv_sta = sta->rate_ctrl_priv;
  60         struct ieee80211_supported_band *sband;
  61
  62         if (!ref)
  63                 return;
  64
  65         sband = local->hw.wiphy->bands[local->hw.conf.channel->band];
  66
  67         ref->ops->rate_init(ref->priv, sband, ista, priv_sta);
  68 }
  69
  70 static inline void rate_control_rate_update(struct ieee80211_local *local,
  71                                     struct ieee80211_supported_band *sband,
  72                                     struct sta_info *sta, u32 changed,
  73                                     enum nl80211_channel_type oper_chan_type)
  74 {
  75         struct rate_control_ref *ref = local->rate_ctrl;
  76         struct ieee80211_sta *ista = &sta->sta;
  77         void *priv_sta = sta->rate_ctrl_priv;
  78
  79         if (ref && ref->ops->rate_update)
  80                 ref->ops->rate_update(ref->priv, sband, ista,
  81                                       priv_sta, changed, oper_chan_type);
  82 }
  83
  84 static inline void *rate_control_alloc_sta(struct rate_control_ref *ref,
  85                                            struct ieee80211_sta *sta,
  86                                            gfp_t gfp)
  87 {
  88         return ref->ops->alloc_sta(ref->priv, sta, gfp);
  89 }
  90
  91 static inline void rate_control_free_sta(struct sta_info *sta)
  92 {
  93         struct rate_control_ref *ref = sta->rate_ctrl;
  94         struct ieee80211_sta *ista = &sta->sta;
  95         void *priv_sta = sta->rate_ctrl_priv;
  96
  97         ref->ops->free_sta(ref->priv, ista, priv_sta);
  98 }
  99
 100 static inline void rate_control_add_sta_debugfs(struct sta_info *sta)
 101 {
 102 #ifdef CONFIG_MAC80211_DEBUGFS
 103         struct rate_control_ref *ref = sta->rate_ctrl;
 104         if (ref && sta->debugfs.dir && ref->ops->add_sta_debugfs)
 105                 ref->ops->add_sta_debugfs(ref->priv, sta->rate_ctrl_priv,
 106                                           sta->debugfs.dir);
 107 #endif
 108 }
 109
 110 static inline void rate_control_remove_sta_debugfs(struct sta_info *sta)
 111 {
 112 #ifdef CONFIG_MAC80211_DEBUGFS
 113         struct rate_control_ref *ref = sta->rate_ctrl;
 114         if (ref && ref->ops->remove_sta_debugfs)
 115                 ref->ops->remove_sta_debugfs(ref->priv, sta->rate_ctrl_priv);
 116 #endif
 117 }
 118
 119 /* functions for rate control related to a device */
 120 int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
 121                                  const char *name);
 122 void rate_control_deinitialize(struct ieee80211_local *local);
 123
 124
 125 /* Rate control algorithms */
 126 #ifdef CONFIG_MAC80211_RC_PID
 127 extern int rc80211_pid_init(void);
 128 extern void rc80211_pid_exit(void);
 129 #else
 130 static inline int rc80211_pid_init(void)
 131 {
 132         return 0;
 133 }
 134 static inline void rc80211_pid_exit(void)
 135 {
 136 }
 137 #endif
 138
 139 #ifdef CONFIG_MAC80211_RC_MINSTREL
 140 extern int rc80211_minstrel_init(void);
 141 extern void rc80211_minstrel_exit(void);
 142 #else
 143 static inline int rc80211_minstrel_init(void)
 144 {
 145         return 0;
 146 }
 147 static inline void rc80211_minstrel_exit(void)
 148 {
 149 }
 150 #endif
 151
 152
 153 #endif /* IEEE80211_RATE_H */