rate.c 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416
  1. /*
  2. * Copyright 2002-2005, Instant802 Networks, Inc.
  3. * Copyright 2005-2006, 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. #include <linux/kernel.h>
  11. #include <linux/rtnetlink.h>
  12. #include <linux/slab.h>
  13. #include "rate.h"
  14. #include "ieee80211_i.h"
  15. #include "debugfs.h"
  16. struct rate_control_alg {
  17. struct list_head list;
  18. struct rate_control_ops *ops;
  19. };
  20. static LIST_HEAD(rate_ctrl_algs);
  21. static DEFINE_MUTEX(rate_ctrl_mutex);
  22. static char *ieee80211_default_rc_algo = CONFIG_MAC80211_RC_DEFAULT;
  23. module_param(ieee80211_default_rc_algo, charp, 0644);
  24. MODULE_PARM_DESC(ieee80211_default_rc_algo,
  25. "Default rate control algorithm for mac80211 to use");
  26. int ieee80211_rate_control_register(struct rate_control_ops *ops)
  27. {
  28. struct rate_control_alg *alg;
  29. if (!ops->name)
  30. return -EINVAL;
  31. mutex_lock(&rate_ctrl_mutex);
  32. list_for_each_entry(alg, &rate_ctrl_algs, list) {
  33. if (!strcmp(alg->ops->name, ops->name)) {
  34. /* don't register an algorithm twice */
  35. WARN_ON(1);
  36. mutex_unlock(&rate_ctrl_mutex);
  37. return -EALREADY;
  38. }
  39. }
  40. alg = kzalloc(sizeof(*alg), GFP_KERNEL);
  41. if (alg == NULL) {
  42. mutex_unlock(&rate_ctrl_mutex);
  43. return -ENOMEM;
  44. }
  45. alg->ops = ops;
  46. list_add_tail(&alg->list, &rate_ctrl_algs);
  47. mutex_unlock(&rate_ctrl_mutex);
  48. return 0;
  49. }
  50. EXPORT_SYMBOL(ieee80211_rate_control_register);
  51. void ieee80211_rate_control_unregister(struct rate_control_ops *ops)
  52. {
  53. struct rate_control_alg *alg;
  54. mutex_lock(&rate_ctrl_mutex);
  55. list_for_each_entry(alg, &rate_ctrl_algs, list) {
  56. if (alg->ops == ops) {
  57. list_del(&alg->list);
  58. kfree(alg);
  59. break;
  60. }
  61. }
  62. mutex_unlock(&rate_ctrl_mutex);
  63. }
  64. EXPORT_SYMBOL(ieee80211_rate_control_unregister);
  65. static struct rate_control_ops *
  66. ieee80211_try_rate_control_ops_get(const char *name)
  67. {
  68. struct rate_control_alg *alg;
  69. struct rate_control_ops *ops = NULL;
  70. if (!name)
  71. return NULL;
  72. mutex_lock(&rate_ctrl_mutex);
  73. list_for_each_entry(alg, &rate_ctrl_algs, list) {
  74. if (!strcmp(alg->ops->name, name))
  75. if (try_module_get(alg->ops->module)) {
  76. ops = alg->ops;
  77. break;
  78. }
  79. }
  80. mutex_unlock(&rate_ctrl_mutex);
  81. return ops;
  82. }
  83. /* Get the rate control algorithm. */
  84. static struct rate_control_ops *
  85. ieee80211_rate_control_ops_get(const char *name)
  86. {
  87. struct rate_control_ops *ops;
  88. const char *alg_name;
  89. kparam_block_sysfs_write(ieee80211_default_rc_algo);
  90. if (!name)
  91. alg_name = ieee80211_default_rc_algo;
  92. else
  93. alg_name = name;
  94. ops = ieee80211_try_rate_control_ops_get(alg_name);
  95. if (!ops) {
  96. request_module("rc80211_%s", alg_name);
  97. ops = ieee80211_try_rate_control_ops_get(alg_name);
  98. }
  99. if (!ops && name)
  100. /* try default if specific alg requested but not found */
  101. ops = ieee80211_try_rate_control_ops_get(ieee80211_default_rc_algo);
  102. /* try built-in one if specific alg requested but not found */
  103. if (!ops && strlen(CONFIG_MAC80211_RC_DEFAULT))
  104. ops = ieee80211_try_rate_control_ops_get(CONFIG_MAC80211_RC_DEFAULT);
  105. kparam_unblock_sysfs_write(ieee80211_default_rc_algo);
  106. return ops;
  107. }
  108. static void ieee80211_rate_control_ops_put(struct rate_control_ops *ops)
  109. {
  110. module_put(ops->module);
  111. }
  112. #ifdef CONFIG_MAC80211_DEBUGFS
  113. static ssize_t rcname_read(struct file *file, char __user *userbuf,
  114. size_t count, loff_t *ppos)
  115. {
  116. struct rate_control_ref *ref = file->private_data;
  117. int len = strlen(ref->ops->name);
  118. return simple_read_from_buffer(userbuf, count, ppos,
  119. ref->ops->name, len);
  120. }
  121. static const struct file_operations rcname_ops = {
  122. .read = rcname_read,
  123. .open = mac80211_open_file_generic,
  124. .llseek = default_llseek,
  125. };
  126. #endif
  127. static struct rate_control_ref *rate_control_alloc(const char *name,
  128. struct ieee80211_local *local)
  129. {
  130. struct dentry *debugfsdir = NULL;
  131. struct rate_control_ref *ref;
  132. ref = kmalloc(sizeof(struct rate_control_ref), GFP_KERNEL);
  133. if (!ref)
  134. goto fail_ref;
  135. kref_init(&ref->kref);
  136. ref->local = local;
  137. ref->ops = ieee80211_rate_control_ops_get(name);
  138. if (!ref->ops)
  139. goto fail_ops;
  140. #ifdef CONFIG_MAC80211_DEBUGFS
  141. debugfsdir = debugfs_create_dir("rc", local->hw.wiphy->debugfsdir);
  142. local->debugfs.rcdir = debugfsdir;
  143. debugfs_create_file("name", 0400, debugfsdir, ref, &rcname_ops);
  144. #endif
  145. ref->priv = ref->ops->alloc(&local->hw, debugfsdir);
  146. if (!ref->priv)
  147. goto fail_priv;
  148. return ref;
  149. fail_priv:
  150. ieee80211_rate_control_ops_put(ref->ops);
  151. fail_ops:
  152. kfree(ref);
  153. fail_ref:
  154. return NULL;
  155. }
  156. static void rate_control_release(struct kref *kref)
  157. {
  158. struct rate_control_ref *ctrl_ref;
  159. ctrl_ref = container_of(kref, struct rate_control_ref, kref);
  160. ctrl_ref->ops->free(ctrl_ref->priv);
  161. #ifdef CONFIG_MAC80211_DEBUGFS
  162. debugfs_remove_recursive(ctrl_ref->local->debugfs.rcdir);
  163. ctrl_ref->local->debugfs.rcdir = NULL;
  164. #endif
  165. ieee80211_rate_control_ops_put(ctrl_ref->ops);
  166. kfree(ctrl_ref);
  167. }
  168. static bool rc_no_data_or_no_ack(struct ieee80211_tx_rate_control *txrc)
  169. {
  170. struct sk_buff *skb = txrc->skb;
  171. struct ieee80211_hdr *hdr = (struct ieee80211_hdr *) skb->data;
  172. struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
  173. __le16 fc;
  174. fc = hdr->frame_control;
  175. return (info->flags & IEEE80211_TX_CTL_NO_ACK) || !ieee80211_is_data(fc);
  176. }
  177. static void rc_send_low_broadcast(s8 *idx, u32 basic_rates,
  178. struct ieee80211_supported_band *sband)
  179. {
  180. u8 i;
  181. if (basic_rates == 0)
  182. return; /* assume basic rates unknown and accept rate */
  183. if (*idx < 0)
  184. return;
  185. if (basic_rates & (1 << *idx))
  186. return; /* selected rate is a basic rate */
  187. for (i = *idx + 1; i <= sband->n_bitrates; i++) {
  188. if (basic_rates & (1 << i)) {
  189. *idx = i;
  190. return;
  191. }
  192. }
  193. /* could not find a basic rate; use original selection */
  194. }
  195. bool rate_control_send_low(struct ieee80211_sta *sta,
  196. void *priv_sta,
  197. struct ieee80211_tx_rate_control *txrc)
  198. {
  199. struct ieee80211_tx_info *info = IEEE80211_SKB_CB(txrc->skb);
  200. struct ieee80211_supported_band *sband = txrc->sband;
  201. int mcast_rate;
  202. if (!sta || !priv_sta || rc_no_data_or_no_ack(txrc)) {
  203. info->control.rates[0].idx = rate_lowest_index(txrc->sband, sta);
  204. info->control.rates[0].count =
  205. (info->flags & IEEE80211_TX_CTL_NO_ACK) ?
  206. 1 : txrc->hw->max_rate_tries;
  207. if (!sta && txrc->bss) {
  208. mcast_rate = txrc->bss_conf->mcast_rate[sband->band];
  209. if (mcast_rate > 0) {
  210. info->control.rates[0].idx = mcast_rate - 1;
  211. return true;
  212. }
  213. rc_send_low_broadcast(&info->control.rates[0].idx,
  214. txrc->bss_conf->basic_rates,
  215. sband);
  216. }
  217. return true;
  218. }
  219. return false;
  220. }
  221. EXPORT_SYMBOL(rate_control_send_low);
  222. static void rate_idx_match_mask(struct ieee80211_tx_rate *rate,
  223. int n_bitrates, u32 mask)
  224. {
  225. int j;
  226. /* See whether the selected rate or anything below it is allowed. */
  227. for (j = rate->idx; j >= 0; j--) {
  228. if (mask & (1 << j)) {
  229. /* Okay, found a suitable rate. Use it. */
  230. rate->idx = j;
  231. return;
  232. }
  233. }
  234. /* Try to find a higher rate that would be allowed */
  235. for (j = rate->idx + 1; j < n_bitrates; j++) {
  236. if (mask & (1 << j)) {
  237. /* Okay, found a suitable rate. Use it. */
  238. rate->idx = j;
  239. return;
  240. }
  241. }
  242. /*
  243. * Uh.. No suitable rate exists. This should not really happen with
  244. * sane TX rate mask configurations. However, should someone manage to
  245. * configure supported rates and TX rate mask in incompatible way,
  246. * allow the frame to be transmitted with whatever the rate control
  247. * selected.
  248. */
  249. }
  250. void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
  251. struct sta_info *sta,
  252. struct ieee80211_tx_rate_control *txrc)
  253. {
  254. struct rate_control_ref *ref = sdata->local->rate_ctrl;
  255. void *priv_sta = NULL;
  256. struct ieee80211_sta *ista = NULL;
  257. struct ieee80211_tx_info *info = IEEE80211_SKB_CB(txrc->skb);
  258. int i;
  259. u32 mask;
  260. if (sta) {
  261. ista = &sta->sta;
  262. priv_sta = sta->rate_ctrl_priv;
  263. }
  264. for (i = 0; i < IEEE80211_TX_MAX_RATES; i++) {
  265. info->control.rates[i].idx = -1;
  266. info->control.rates[i].flags = 0;
  267. info->control.rates[i].count = 0;
  268. }
  269. if (sdata->local->hw.flags & IEEE80211_HW_HAS_RATE_CONTROL)
  270. return;
  271. ref->ops->get_rate(ref->priv, ista, priv_sta, txrc);
  272. /*
  273. * Try to enforce the rateidx mask the user wanted. skip this if the
  274. * default mask (allow all rates) is used to save some processing for
  275. * the common case.
  276. */
  277. mask = sdata->rc_rateidx_mask[info->band];
  278. if (mask != (1 << txrc->sband->n_bitrates) - 1) {
  279. if (sta) {
  280. /* Filter out rates that the STA does not support */
  281. mask &= sta->sta.supp_rates[info->band];
  282. }
  283. /*
  284. * Make sure the rate index selected for each TX rate is
  285. * included in the configured mask and change the rate indexes
  286. * if needed.
  287. */
  288. for (i = 0; i < IEEE80211_TX_MAX_RATES; i++) {
  289. /* Skip invalid rates */
  290. if (info->control.rates[i].idx < 0)
  291. break;
  292. /* Rate masking supports only legacy rates for now */
  293. if (info->control.rates[i].flags & IEEE80211_TX_RC_MCS)
  294. continue;
  295. rate_idx_match_mask(&info->control.rates[i],
  296. txrc->sband->n_bitrates, mask);
  297. }
  298. }
  299. BUG_ON(info->control.rates[0].idx < 0);
  300. }
  301. struct rate_control_ref *rate_control_get(struct rate_control_ref *ref)
  302. {
  303. kref_get(&ref->kref);
  304. return ref;
  305. }
  306. void rate_control_put(struct rate_control_ref *ref)
  307. {
  308. kref_put(&ref->kref, rate_control_release);
  309. }
  310. int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
  311. const char *name)
  312. {
  313. struct rate_control_ref *ref, *old;
  314. ASSERT_RTNL();
  315. if (local->open_count)
  316. return -EBUSY;
  317. if (local->hw.flags & IEEE80211_HW_HAS_RATE_CONTROL) {
  318. if (WARN_ON(!local->ops->set_rts_threshold))
  319. return -EINVAL;
  320. return 0;
  321. }
  322. ref = rate_control_alloc(name, local);
  323. if (!ref) {
  324. wiphy_warn(local->hw.wiphy,
  325. "Failed to select rate control algorithm\n");
  326. return -ENOENT;
  327. }
  328. old = local->rate_ctrl;
  329. local->rate_ctrl = ref;
  330. if (old) {
  331. rate_control_put(old);
  332. sta_info_flush(local, NULL);
  333. }
  334. wiphy_debug(local->hw.wiphy, "Selected rate control algorithm '%s'\n",
  335. ref->ops->name);
  336. return 0;
  337. }
  338. void rate_control_deinitialize(struct ieee80211_local *local)
  339. {
  340. struct rate_control_ref *ref;
  341. ref = local->rate_ctrl;
  342. if (!ref)
  343. return;
  344. local->rate_ctrl = NULL;
  345. rate_control_put(ref);
  346. }