cfg80211.h 104 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065
  1. #ifndef __NET_CFG80211_H
  2. #define __NET_CFG80211_H
  3. /*
  4. * 802.11 device and configuration interface
  5. *
  6. * Copyright 2006-2010 Johannes Berg <johannes@sipsolutions.net>
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License version 2 as
  10. * published by the Free Software Foundation.
  11. */
  12. #include <linux/netdevice.h>
  13. #include <linux/debugfs.h>
  14. #include <linux/list.h>
  15. #include <linux/netlink.h>
  16. #include <linux/skbuff.h>
  17. #include <linux/nl80211.h>
  18. #include <linux/if_ether.h>
  19. #include <linux/ieee80211.h>
  20. #include <net/regulatory.h>
  21. /* remove once we remove the wext stuff */
  22. #include <net/iw_handler.h>
  23. #include <linux/wireless.h>
  24. /**
  25. * DOC: Introduction
  26. *
  27. * cfg80211 is the configuration API for 802.11 devices in Linux. It bridges
  28. * userspace and drivers, and offers some utility functionality associated
  29. * with 802.11. cfg80211 must, directly or indirectly via mac80211, be used
  30. * by all modern wireless drivers in Linux, so that they offer a consistent
  31. * API through nl80211. For backward compatibility, cfg80211 also offers
  32. * wireless extensions to userspace, but hides them from drivers completely.
  33. *
  34. * Additionally, cfg80211 contains code to help enforce regulatory spectrum
  35. * use restrictions.
  36. */
  37. /**
  38. * DOC: Device registration
  39. *
  40. * In order for a driver to use cfg80211, it must register the hardware device
  41. * with cfg80211. This happens through a number of hardware capability structs
  42. * described below.
  43. *
  44. * The fundamental structure for each device is the 'wiphy', of which each
  45. * instance describes a physical wireless device connected to the system. Each
  46. * such wiphy can have zero, one, or many virtual interfaces associated with
  47. * it, which need to be identified as such by pointing the network interface's
  48. * @ieee80211_ptr pointer to a &struct wireless_dev which further describes
  49. * the wireless part of the interface, normally this struct is embedded in the
  50. * network interface's private data area. Drivers can optionally allow creating
  51. * or destroying virtual interfaces on the fly, but without at least one or the
  52. * ability to create some the wireless device isn't useful.
  53. *
  54. * Each wiphy structure contains device capability information, and also has
  55. * a pointer to the various operations the driver offers. The definitions and
  56. * structures here describe these capabilities in detail.
  57. */
  58. /*
  59. * wireless hardware capability structures
  60. */
  61. /**
  62. * enum ieee80211_band - supported frequency bands
  63. *
  64. * The bands are assigned this way because the supported
  65. * bitrates differ in these bands.
  66. *
  67. * @IEEE80211_BAND_2GHZ: 2.4GHz ISM band
  68. * @IEEE80211_BAND_5GHZ: around 5GHz band (4.9-5.7)
  69. * @IEEE80211_NUM_BANDS: number of defined bands
  70. */
  71. enum ieee80211_band {
  72. IEEE80211_BAND_2GHZ = NL80211_BAND_2GHZ,
  73. IEEE80211_BAND_5GHZ = NL80211_BAND_5GHZ,
  74. /* keep last */
  75. IEEE80211_NUM_BANDS
  76. };
  77. /**
  78. * enum ieee80211_channel_flags - channel flags
  79. *
  80. * Channel flags set by the regulatory control code.
  81. *
  82. * @IEEE80211_CHAN_DISABLED: This channel is disabled.
  83. * @IEEE80211_CHAN_PASSIVE_SCAN: Only passive scanning is permitted
  84. * on this channel.
  85. * @IEEE80211_CHAN_NO_IBSS: IBSS is not allowed on this channel.
  86. * @IEEE80211_CHAN_RADAR: Radar detection is required on this channel.
  87. * @IEEE80211_CHAN_NO_HT40PLUS: extension channel above this channel
  88. * is not permitted.
  89. * @IEEE80211_CHAN_NO_HT40MINUS: extension channel below this channel
  90. * is not permitted.
  91. */
  92. enum ieee80211_channel_flags {
  93. IEEE80211_CHAN_DISABLED = 1<<0,
  94. IEEE80211_CHAN_PASSIVE_SCAN = 1<<1,
  95. IEEE80211_CHAN_NO_IBSS = 1<<2,
  96. IEEE80211_CHAN_RADAR = 1<<3,
  97. IEEE80211_CHAN_NO_HT40PLUS = 1<<4,
  98. IEEE80211_CHAN_NO_HT40MINUS = 1<<5,
  99. };
  100. #define IEEE80211_CHAN_NO_HT40 \
  101. (IEEE80211_CHAN_NO_HT40PLUS | IEEE80211_CHAN_NO_HT40MINUS)
  102. /**
  103. * struct ieee80211_channel - channel definition
  104. *
  105. * This structure describes a single channel for use
  106. * with cfg80211.
  107. *
  108. * @center_freq: center frequency in MHz
  109. * @hw_value: hardware-specific value for the channel
  110. * @flags: channel flags from &enum ieee80211_channel_flags.
  111. * @orig_flags: channel flags at registration time, used by regulatory
  112. * code to support devices with additional restrictions
  113. * @band: band this channel belongs to.
  114. * @max_antenna_gain: maximum antenna gain in dBi
  115. * @max_power: maximum transmission power (in dBm)
  116. * @beacon_found: helper to regulatory code to indicate when a beacon
  117. * has been found on this channel. Use regulatory_hint_found_beacon()
  118. * to enable this, this is useful only on 5 GHz band.
  119. * @orig_mag: internal use
  120. * @orig_mpwr: internal use
  121. */
  122. struct ieee80211_channel {
  123. enum ieee80211_band band;
  124. u16 center_freq;
  125. u16 hw_value;
  126. u32 flags;
  127. int max_antenna_gain;
  128. int max_power;
  129. bool beacon_found;
  130. u32 orig_flags;
  131. int orig_mag, orig_mpwr;
  132. };
  133. /**
  134. * enum ieee80211_rate_flags - rate flags
  135. *
  136. * Hardware/specification flags for rates. These are structured
  137. * in a way that allows using the same bitrate structure for
  138. * different bands/PHY modes.
  139. *
  140. * @IEEE80211_RATE_SHORT_PREAMBLE: Hardware can send with short
  141. * preamble on this bitrate; only relevant in 2.4GHz band and
  142. * with CCK rates.
  143. * @IEEE80211_RATE_MANDATORY_A: This bitrate is a mandatory rate
  144. * when used with 802.11a (on the 5 GHz band); filled by the
  145. * core code when registering the wiphy.
  146. * @IEEE80211_RATE_MANDATORY_B: This bitrate is a mandatory rate
  147. * when used with 802.11b (on the 2.4 GHz band); filled by the
  148. * core code when registering the wiphy.
  149. * @IEEE80211_RATE_MANDATORY_G: This bitrate is a mandatory rate
  150. * when used with 802.11g (on the 2.4 GHz band); filled by the
  151. * core code when registering the wiphy.
  152. * @IEEE80211_RATE_ERP_G: This is an ERP rate in 802.11g mode.
  153. */
  154. enum ieee80211_rate_flags {
  155. IEEE80211_RATE_SHORT_PREAMBLE = 1<<0,
  156. IEEE80211_RATE_MANDATORY_A = 1<<1,
  157. IEEE80211_RATE_MANDATORY_B = 1<<2,
  158. IEEE80211_RATE_MANDATORY_G = 1<<3,
  159. IEEE80211_RATE_ERP_G = 1<<4,
  160. };
  161. /**
  162. * struct ieee80211_rate - bitrate definition
  163. *
  164. * This structure describes a bitrate that an 802.11 PHY can
  165. * operate with. The two values @hw_value and @hw_value_short
  166. * are only for driver use when pointers to this structure are
  167. * passed around.
  168. *
  169. * @flags: rate-specific flags
  170. * @bitrate: bitrate in units of 100 Kbps
  171. * @hw_value: driver/hardware value for this rate
  172. * @hw_value_short: driver/hardware value for this rate when
  173. * short preamble is used
  174. */
  175. struct ieee80211_rate {
  176. u32 flags;
  177. u16 bitrate;
  178. u16 hw_value, hw_value_short;
  179. };
  180. /**
  181. * struct ieee80211_sta_ht_cap - STA's HT capabilities
  182. *
  183. * This structure describes most essential parameters needed
  184. * to describe 802.11n HT capabilities for an STA.
  185. *
  186. * @ht_supported: is HT supported by the STA
  187. * @cap: HT capabilities map as described in 802.11n spec
  188. * @ampdu_factor: Maximum A-MPDU length factor
  189. * @ampdu_density: Minimum A-MPDU spacing
  190. * @mcs: Supported MCS rates
  191. */
  192. struct ieee80211_sta_ht_cap {
  193. u16 cap; /* use IEEE80211_HT_CAP_ */
  194. bool ht_supported;
  195. u8 ampdu_factor;
  196. u8 ampdu_density;
  197. struct ieee80211_mcs_info mcs;
  198. };
  199. /**
  200. * struct ieee80211_supported_band - frequency band definition
  201. *
  202. * This structure describes a frequency band a wiphy
  203. * is able to operate in.
  204. *
  205. * @channels: Array of channels the hardware can operate in
  206. * in this band.
  207. * @band: the band this structure represents
  208. * @n_channels: Number of channels in @channels
  209. * @bitrates: Array of bitrates the hardware can operate with
  210. * in this band. Must be sorted to give a valid "supported
  211. * rates" IE, i.e. CCK rates first, then OFDM.
  212. * @n_bitrates: Number of bitrates in @bitrates
  213. * @ht_cap: HT capabilities in this band
  214. */
  215. struct ieee80211_supported_band {
  216. struct ieee80211_channel *channels;
  217. struct ieee80211_rate *bitrates;
  218. enum ieee80211_band band;
  219. int n_channels;
  220. int n_bitrates;
  221. struct ieee80211_sta_ht_cap ht_cap;
  222. };
  223. /*
  224. * Wireless hardware/device configuration structures and methods
  225. */
  226. /**
  227. * DOC: Actions and configuration
  228. *
  229. * Each wireless device and each virtual interface offer a set of configuration
  230. * operations and other actions that are invoked by userspace. Each of these
  231. * actions is described in the operations structure, and the parameters these
  232. * operations use are described separately.
  233. *
  234. * Additionally, some operations are asynchronous and expect to get status
  235. * information via some functions that drivers need to call.
  236. *
  237. * Scanning and BSS list handling with its associated functionality is described
  238. * in a separate chapter.
  239. */
  240. /**
  241. * struct vif_params - describes virtual interface parameters
  242. * @use_4addr: use 4-address frames
  243. */
  244. struct vif_params {
  245. int use_4addr;
  246. };
  247. /**
  248. * struct key_params - key information
  249. *
  250. * Information about a key
  251. *
  252. * @key: key material
  253. * @key_len: length of key material
  254. * @cipher: cipher suite selector
  255. * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
  256. * with the get_key() callback, must be in little endian,
  257. * length given by @seq_len.
  258. * @seq_len: length of @seq.
  259. */
  260. struct key_params {
  261. u8 *key;
  262. u8 *seq;
  263. int key_len;
  264. int seq_len;
  265. u32 cipher;
  266. };
  267. /**
  268. * enum survey_info_flags - survey information flags
  269. *
  270. * @SURVEY_INFO_NOISE_DBM: noise (in dBm) was filled in
  271. * @SURVEY_INFO_IN_USE: channel is currently being used
  272. * @SURVEY_INFO_CHANNEL_TIME: channel active time (in ms) was filled in
  273. * @SURVEY_INFO_CHANNEL_TIME_BUSY: channel busy time was filled in
  274. * @SURVEY_INFO_CHANNEL_TIME_EXT_BUSY: extension channel busy time was filled in
  275. * @SURVEY_INFO_CHANNEL_TIME_RX: channel receive time was filled in
  276. * @SURVEY_INFO_CHANNEL_TIME_TX: channel transmit time was filled in
  277. *
  278. * Used by the driver to indicate which info in &struct survey_info
  279. * it has filled in during the get_survey().
  280. */
  281. enum survey_info_flags {
  282. SURVEY_INFO_NOISE_DBM = 1<<0,
  283. SURVEY_INFO_IN_USE = 1<<1,
  284. SURVEY_INFO_CHANNEL_TIME = 1<<2,
  285. SURVEY_INFO_CHANNEL_TIME_BUSY = 1<<3,
  286. SURVEY_INFO_CHANNEL_TIME_EXT_BUSY = 1<<4,
  287. SURVEY_INFO_CHANNEL_TIME_RX = 1<<5,
  288. SURVEY_INFO_CHANNEL_TIME_TX = 1<<6,
  289. };
  290. /**
  291. * struct survey_info - channel survey response
  292. *
  293. * @channel: the channel this survey record reports, mandatory
  294. * @filled: bitflag of flags from &enum survey_info_flags
  295. * @noise: channel noise in dBm. This and all following fields are
  296. * optional
  297. * @channel_time: amount of time in ms the radio spent on the channel
  298. * @channel_time_busy: amount of time the primary channel was sensed busy
  299. * @channel_time_ext_busy: amount of time the extension channel was sensed busy
  300. * @channel_time_rx: amount of time the radio spent receiving data
  301. * @channel_time_tx: amount of time the radio spent transmitting data
  302. *
  303. * Used by dump_survey() to report back per-channel survey information.
  304. *
  305. * This structure can later be expanded with things like
  306. * channel duty cycle etc.
  307. */
  308. struct survey_info {
  309. struct ieee80211_channel *channel;
  310. u64 channel_time;
  311. u64 channel_time_busy;
  312. u64 channel_time_ext_busy;
  313. u64 channel_time_rx;
  314. u64 channel_time_tx;
  315. u32 filled;
  316. s8 noise;
  317. };
  318. /**
  319. * struct beacon_parameters - beacon parameters
  320. *
  321. * Used to configure the beacon for an interface.
  322. *
  323. * @head: head portion of beacon (before TIM IE)
  324. * or %NULL if not changed
  325. * @tail: tail portion of beacon (after TIM IE)
  326. * or %NULL if not changed
  327. * @interval: beacon interval or zero if not changed
  328. * @dtim_period: DTIM period or zero if not changed
  329. * @head_len: length of @head
  330. * @tail_len: length of @tail
  331. */
  332. struct beacon_parameters {
  333. u8 *head, *tail;
  334. int interval, dtim_period;
  335. int head_len, tail_len;
  336. };
  337. /**
  338. * enum plink_action - actions to perform in mesh peers
  339. *
  340. * @PLINK_ACTION_INVALID: action 0 is reserved
  341. * @PLINK_ACTION_OPEN: start mesh peer link establishment
  342. * @PLINK_ACTION_BLOCK: block traffic from this mesh peer
  343. */
  344. enum plink_actions {
  345. PLINK_ACTION_INVALID,
  346. PLINK_ACTION_OPEN,
  347. PLINK_ACTION_BLOCK,
  348. };
  349. /**
  350. * struct station_parameters - station parameters
  351. *
  352. * Used to change and create a new station.
  353. *
  354. * @vlan: vlan interface station should belong to
  355. * @supported_rates: supported rates in IEEE 802.11 format
  356. * (or NULL for no change)
  357. * @supported_rates_len: number of supported rates
  358. * @sta_flags_mask: station flags that changed
  359. * (bitmask of BIT(NL80211_STA_FLAG_...))
  360. * @sta_flags_set: station flags values
  361. * (bitmask of BIT(NL80211_STA_FLAG_...))
  362. * @listen_interval: listen interval or -1 for no change
  363. * @aid: AID or zero for no change
  364. * @plink_action: plink action to take
  365. * @plink_state: set the peer link state for a station
  366. * @ht_capa: HT capabilities of station
  367. */
  368. struct station_parameters {
  369. u8 *supported_rates;
  370. struct net_device *vlan;
  371. u32 sta_flags_mask, sta_flags_set;
  372. int listen_interval;
  373. u16 aid;
  374. u8 supported_rates_len;
  375. u8 plink_action;
  376. u8 plink_state;
  377. struct ieee80211_ht_cap *ht_capa;
  378. };
  379. /**
  380. * enum station_info_flags - station information flags
  381. *
  382. * Used by the driver to indicate which info in &struct station_info
  383. * it has filled in during get_station() or dump_station().
  384. *
  385. * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
  386. * @STATION_INFO_RX_BYTES: @rx_bytes filled
  387. * @STATION_INFO_TX_BYTES: @tx_bytes filled
  388. * @STATION_INFO_LLID: @llid filled
  389. * @STATION_INFO_PLID: @plid filled
  390. * @STATION_INFO_PLINK_STATE: @plink_state filled
  391. * @STATION_INFO_SIGNAL: @signal filled
  392. * @STATION_INFO_TX_BITRATE: @txrate fields are filled
  393. * (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
  394. * @STATION_INFO_RX_PACKETS: @rx_packets filled
  395. * @STATION_INFO_TX_PACKETS: @tx_packets filled
  396. * @STATION_INFO_TX_RETRIES: @tx_retries filled
  397. * @STATION_INFO_TX_FAILED: @tx_failed filled
  398. * @STATION_INFO_RX_DROP_MISC: @rx_dropped_misc filled
  399. * @STATION_INFO_SIGNAL_AVG: @signal_avg filled
  400. * @STATION_INFO_RX_BITRATE: @rxrate fields are filled
  401. * @STATION_INFO_BSS_PARAM: @bss_param filled
  402. * @STATION_INFO_CONNECTED_TIME: @connected_time filled
  403. */
  404. enum station_info_flags {
  405. STATION_INFO_INACTIVE_TIME = 1<<0,
  406. STATION_INFO_RX_BYTES = 1<<1,
  407. STATION_INFO_TX_BYTES = 1<<2,
  408. STATION_INFO_LLID = 1<<3,
  409. STATION_INFO_PLID = 1<<4,
  410. STATION_INFO_PLINK_STATE = 1<<5,
  411. STATION_INFO_SIGNAL = 1<<6,
  412. STATION_INFO_TX_BITRATE = 1<<7,
  413. STATION_INFO_RX_PACKETS = 1<<8,
  414. STATION_INFO_TX_PACKETS = 1<<9,
  415. STATION_INFO_TX_RETRIES = 1<<10,
  416. STATION_INFO_TX_FAILED = 1<<11,
  417. STATION_INFO_RX_DROP_MISC = 1<<12,
  418. STATION_INFO_SIGNAL_AVG = 1<<13,
  419. STATION_INFO_RX_BITRATE = 1<<14,
  420. STATION_INFO_BSS_PARAM = 1<<15,
  421. STATION_INFO_CONNECTED_TIME = 1<<16
  422. };
  423. /**
  424. * enum station_info_rate_flags - bitrate info flags
  425. *
  426. * Used by the driver to indicate the specific rate transmission
  427. * type for 802.11n transmissions.
  428. *
  429. * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
  430. * @RATE_INFO_FLAGS_40_MHZ_WIDTH: 40 Mhz width transmission
  431. * @RATE_INFO_FLAGS_SHORT_GI: 400ns guard interval
  432. */
  433. enum rate_info_flags {
  434. RATE_INFO_FLAGS_MCS = 1<<0,
  435. RATE_INFO_FLAGS_40_MHZ_WIDTH = 1<<1,
  436. RATE_INFO_FLAGS_SHORT_GI = 1<<2,
  437. };
  438. /**
  439. * struct rate_info - bitrate information
  440. *
  441. * Information about a receiving or transmitting bitrate
  442. *
  443. * @flags: bitflag of flags from &enum rate_info_flags
  444. * @mcs: mcs index if struct describes a 802.11n bitrate
  445. * @legacy: bitrate in 100kbit/s for 802.11abg
  446. */
  447. struct rate_info {
  448. u8 flags;
  449. u8 mcs;
  450. u16 legacy;
  451. };
  452. /**
  453. * enum station_info_rate_flags - bitrate info flags
  454. *
  455. * Used by the driver to indicate the specific rate transmission
  456. * type for 802.11n transmissions.
  457. *
  458. * @BSS_PARAM_FLAGS_CTS_PROT: whether CTS protection is enabled
  459. * @BSS_PARAM_FLAGS_SHORT_PREAMBLE: whether short preamble is enabled
  460. * @BSS_PARAM_FLAGS_SHORT_SLOT_TIME: whether short slot time is enabled
  461. */
  462. enum bss_param_flags {
  463. BSS_PARAM_FLAGS_CTS_PROT = 1<<0,
  464. BSS_PARAM_FLAGS_SHORT_PREAMBLE = 1<<1,
  465. BSS_PARAM_FLAGS_SHORT_SLOT_TIME = 1<<2,
  466. };
  467. /**
  468. * struct sta_bss_parameters - BSS parameters for the attached station
  469. *
  470. * Information about the currently associated BSS
  471. *
  472. * @flags: bitflag of flags from &enum bss_param_flags
  473. * @dtim_period: DTIM period for the BSS
  474. * @beacon_interval: beacon interval
  475. */
  476. struct sta_bss_parameters {
  477. u8 flags;
  478. u8 dtim_period;
  479. u16 beacon_interval;
  480. };
  481. /**
  482. * struct station_info - station information
  483. *
  484. * Station information filled by driver for get_station() and dump_station.
  485. *
  486. * @filled: bitflag of flags from &enum station_info_flags
  487. * @connected_time: time(in secs) since a station is last connected
  488. * @inactive_time: time since last station activity (tx/rx) in milliseconds
  489. * @rx_bytes: bytes received from this station
  490. * @tx_bytes: bytes transmitted to this station
  491. * @llid: mesh local link id
  492. * @plid: mesh peer link id
  493. * @plink_state: mesh peer link state
  494. * @signal: signal strength of last received packet in dBm
  495. * @signal_avg: signal strength average in dBm
  496. * @txrate: current unicast bitrate from this station
  497. * @rxrate: current unicast bitrate to this station
  498. * @rx_packets: packets received from this station
  499. * @tx_packets: packets transmitted to this station
  500. * @tx_retries: cumulative retry counts
  501. * @tx_failed: number of failed transmissions (retries exceeded, no ACK)
  502. * @rx_dropped_misc: Dropped for un-specified reason.
  503. * @generation: generation number for nl80211 dumps.
  504. * This number should increase every time the list of stations
  505. * changes, i.e. when a station is added or removed, so that
  506. * userspace can tell whether it got a consistent snapshot.
  507. */
  508. struct station_info {
  509. u32 filled;
  510. u32 connected_time;
  511. u32 inactive_time;
  512. u32 rx_bytes;
  513. u32 tx_bytes;
  514. u16 llid;
  515. u16 plid;
  516. u8 plink_state;
  517. s8 signal;
  518. s8 signal_avg;
  519. struct rate_info txrate;
  520. struct rate_info rxrate;
  521. u32 rx_packets;
  522. u32 tx_packets;
  523. u32 tx_retries;
  524. u32 tx_failed;
  525. u32 rx_dropped_misc;
  526. struct sta_bss_parameters bss_param;
  527. int generation;
  528. };
  529. /**
  530. * enum monitor_flags - monitor flags
  531. *
  532. * Monitor interface configuration flags. Note that these must be the bits
  533. * according to the nl80211 flags.
  534. *
  535. * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
  536. * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
  537. * @MONITOR_FLAG_CONTROL: pass control frames
  538. * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
  539. * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
  540. */
  541. enum monitor_flags {
  542. MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
  543. MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
  544. MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
  545. MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
  546. MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
  547. };
  548. /**
  549. * enum mpath_info_flags - mesh path information flags
  550. *
  551. * Used by the driver to indicate which info in &struct mpath_info it has filled
  552. * in during get_station() or dump_station().
  553. *
  554. * @MPATH_INFO_FRAME_QLEN: @frame_qlen filled
  555. * @MPATH_INFO_SN: @sn filled
  556. * @MPATH_INFO_METRIC: @metric filled
  557. * @MPATH_INFO_EXPTIME: @exptime filled
  558. * @MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
  559. * @MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
  560. * @MPATH_INFO_FLAGS: @flags filled
  561. */
  562. enum mpath_info_flags {
  563. MPATH_INFO_FRAME_QLEN = BIT(0),
  564. MPATH_INFO_SN = BIT(1),
  565. MPATH_INFO_METRIC = BIT(2),
  566. MPATH_INFO_EXPTIME = BIT(3),
  567. MPATH_INFO_DISCOVERY_TIMEOUT = BIT(4),
  568. MPATH_INFO_DISCOVERY_RETRIES = BIT(5),
  569. MPATH_INFO_FLAGS = BIT(6),
  570. };
  571. /**
  572. * struct mpath_info - mesh path information
  573. *
  574. * Mesh path information filled by driver for get_mpath() and dump_mpath().
  575. *
  576. * @filled: bitfield of flags from &enum mpath_info_flags
  577. * @frame_qlen: number of queued frames for this destination
  578. * @sn: target sequence number
  579. * @metric: metric (cost) of this mesh path
  580. * @exptime: expiration time for the mesh path from now, in msecs
  581. * @flags: mesh path flags
  582. * @discovery_timeout: total mesh path discovery timeout, in msecs
  583. * @discovery_retries: mesh path discovery retries
  584. * @generation: generation number for nl80211 dumps.
  585. * This number should increase every time the list of mesh paths
  586. * changes, i.e. when a station is added or removed, so that
  587. * userspace can tell whether it got a consistent snapshot.
  588. */
  589. struct mpath_info {
  590. u32 filled;
  591. u32 frame_qlen;
  592. u32 sn;
  593. u32 metric;
  594. u32 exptime;
  595. u32 discovery_timeout;
  596. u8 discovery_retries;
  597. u8 flags;
  598. int generation;
  599. };
  600. /**
  601. * struct bss_parameters - BSS parameters
  602. *
  603. * Used to change BSS parameters (mainly for AP mode).
  604. *
  605. * @use_cts_prot: Whether to use CTS protection
  606. * (0 = no, 1 = yes, -1 = do not change)
  607. * @use_short_preamble: Whether the use of short preambles is allowed
  608. * (0 = no, 1 = yes, -1 = do not change)
  609. * @use_short_slot_time: Whether the use of short slot time is allowed
  610. * (0 = no, 1 = yes, -1 = do not change)
  611. * @basic_rates: basic rates in IEEE 802.11 format
  612. * (or NULL for no change)
  613. * @basic_rates_len: number of basic rates
  614. * @ap_isolate: do not forward packets between connected stations
  615. * @ht_opmode: HT Operation mode
  616. * (u16 = opmode, -1 = do not change)
  617. */
  618. struct bss_parameters {
  619. int use_cts_prot;
  620. int use_short_preamble;
  621. int use_short_slot_time;
  622. u8 *basic_rates;
  623. u8 basic_rates_len;
  624. int ap_isolate;
  625. int ht_opmode;
  626. };
  627. /*
  628. * struct mesh_config - 802.11s mesh configuration
  629. *
  630. * These parameters can be changed while the mesh is active.
  631. */
  632. struct mesh_config {
  633. /* Timeouts in ms */
  634. /* Mesh plink management parameters */
  635. u16 dot11MeshRetryTimeout;
  636. u16 dot11MeshConfirmTimeout;
  637. u16 dot11MeshHoldingTimeout;
  638. u16 dot11MeshMaxPeerLinks;
  639. u8 dot11MeshMaxRetries;
  640. u8 dot11MeshTTL;
  641. /* ttl used in path selection information elements */
  642. u8 element_ttl;
  643. bool auto_open_plinks;
  644. /* HWMP parameters */
  645. u8 dot11MeshHWMPmaxPREQretries;
  646. u32 path_refresh_time;
  647. u16 min_discovery_timeout;
  648. u32 dot11MeshHWMPactivePathTimeout;
  649. u16 dot11MeshHWMPpreqMinInterval;
  650. u16 dot11MeshHWMPnetDiameterTraversalTime;
  651. u8 dot11MeshHWMPRootMode;
  652. };
  653. /**
  654. * struct mesh_setup - 802.11s mesh setup configuration
  655. * @mesh_id: the mesh ID
  656. * @mesh_id_len: length of the mesh ID, at least 1 and at most 32 bytes
  657. * @path_sel_proto: which path selection protocol to use
  658. * @path_metric: which metric to use
  659. * @ie: vendor information elements (optional)
  660. * @ie_len: length of vendor information elements
  661. * @is_authenticated: this mesh requires authentication
  662. * @is_secure: this mesh uses security
  663. *
  664. * These parameters are fixed when the mesh is created.
  665. */
  666. struct mesh_setup {
  667. const u8 *mesh_id;
  668. u8 mesh_id_len;
  669. u8 path_sel_proto;
  670. u8 path_metric;
  671. const u8 *ie;
  672. u8 ie_len;
  673. bool is_authenticated;
  674. bool is_secure;
  675. };
  676. /**
  677. * struct ieee80211_txq_params - TX queue parameters
  678. * @queue: TX queue identifier (NL80211_TXQ_Q_*)
  679. * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
  680. * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
  681. * 1..32767]
  682. * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
  683. * 1..32767]
  684. * @aifs: Arbitration interframe space [0..255]
  685. */
  686. struct ieee80211_txq_params {
  687. enum nl80211_txq_q queue;
  688. u16 txop;
  689. u16 cwmin;
  690. u16 cwmax;
  691. u8 aifs;
  692. };
  693. /* from net/wireless.h */
  694. struct wiphy;
  695. /**
  696. * DOC: Scanning and BSS list handling
  697. *
  698. * The scanning process itself is fairly simple, but cfg80211 offers quite
  699. * a bit of helper functionality. To start a scan, the scan operation will
  700. * be invoked with a scan definition. This scan definition contains the
  701. * channels to scan, and the SSIDs to send probe requests for (including the
  702. * wildcard, if desired). A passive scan is indicated by having no SSIDs to
  703. * probe. Additionally, a scan request may contain extra information elements
  704. * that should be added to the probe request. The IEs are guaranteed to be
  705. * well-formed, and will not exceed the maximum length the driver advertised
  706. * in the wiphy structure.
  707. *
  708. * When scanning finds a BSS, cfg80211 needs to be notified of that, because
  709. * it is responsible for maintaining the BSS list; the driver should not
  710. * maintain a list itself. For this notification, various functions exist.
  711. *
  712. * Since drivers do not maintain a BSS list, there are also a number of
  713. * functions to search for a BSS and obtain information about it from the
  714. * BSS structure cfg80211 maintains. The BSS list is also made available
  715. * to userspace.
  716. */
  717. /**
  718. * struct cfg80211_ssid - SSID description
  719. * @ssid: the SSID
  720. * @ssid_len: length of the ssid
  721. */
  722. struct cfg80211_ssid {
  723. u8 ssid[IEEE80211_MAX_SSID_LEN];
  724. u8 ssid_len;
  725. };
  726. /**
  727. * struct cfg80211_scan_request - scan request description
  728. *
  729. * @ssids: SSIDs to scan for (active scan only)
  730. * @n_ssids: number of SSIDs
  731. * @channels: channels to scan on.
  732. * @n_channels: total number of channels to scan
  733. * @ie: optional information element(s) to add into Probe Request or %NULL
  734. * @ie_len: length of ie in octets
  735. * @wiphy: the wiphy this was for
  736. * @dev: the interface
  737. * @aborted: (internal) scan request was notified as aborted
  738. */
  739. struct cfg80211_scan_request {
  740. struct cfg80211_ssid *ssids;
  741. int n_ssids;
  742. u32 n_channels;
  743. const u8 *ie;
  744. size_t ie_len;
  745. /* internal */
  746. struct wiphy *wiphy;
  747. struct net_device *dev;
  748. bool aborted;
  749. /* keep last */
  750. struct ieee80211_channel *channels[0];
  751. };
  752. /**
  753. * struct cfg80211_sched_scan_request - scheduled scan request description
  754. *
  755. * @ssids: SSIDs to scan for (passed in the probe_reqs in active scans)
  756. * @n_ssids: number of SSIDs
  757. * @n_channels: total number of channels to scan
  758. * @interval: interval between each scheduled scan cycle
  759. * @ie: optional information element(s) to add into Probe Request or %NULL
  760. * @ie_len: length of ie in octets
  761. * @wiphy: the wiphy this was for
  762. * @dev: the interface
  763. * @channels: channels to scan
  764. */
  765. struct cfg80211_sched_scan_request {
  766. struct cfg80211_ssid *ssids;
  767. int n_ssids;
  768. u32 n_channels;
  769. u32 interval;
  770. const u8 *ie;
  771. size_t ie_len;
  772. /* internal */
  773. struct wiphy *wiphy;
  774. struct net_device *dev;
  775. /* keep last */
  776. struct ieee80211_channel *channels[0];
  777. };
  778. /**
  779. * enum cfg80211_signal_type - signal type
  780. *
  781. * @CFG80211_SIGNAL_TYPE_NONE: no signal strength information available
  782. * @CFG80211_SIGNAL_TYPE_MBM: signal strength in mBm (100*dBm)
  783. * @CFG80211_SIGNAL_TYPE_UNSPEC: signal strength, increasing from 0 through 100
  784. */
  785. enum cfg80211_signal_type {
  786. CFG80211_SIGNAL_TYPE_NONE,
  787. CFG80211_SIGNAL_TYPE_MBM,
  788. CFG80211_SIGNAL_TYPE_UNSPEC,
  789. };
  790. /**
  791. * struct cfg80211_bss - BSS description
  792. *
  793. * This structure describes a BSS (which may also be a mesh network)
  794. * for use in scan results and similar.
  795. *
  796. * @channel: channel this BSS is on
  797. * @bssid: BSSID of the BSS
  798. * @tsf: timestamp of last received update
  799. * @beacon_interval: the beacon interval as from the frame
  800. * @capability: the capability field in host byte order
  801. * @information_elements: the information elements (Note that there
  802. * is no guarantee that these are well-formed!); this is a pointer to
  803. * either the beacon_ies or proberesp_ies depending on whether Probe
  804. * Response frame has been received
  805. * @len_information_elements: total length of the information elements
  806. * @beacon_ies: the information elements from the last Beacon frame
  807. * @len_beacon_ies: total length of the beacon_ies
  808. * @proberesp_ies: the information elements from the last Probe Response frame
  809. * @len_proberesp_ies: total length of the proberesp_ies
  810. * @signal: signal strength value (type depends on the wiphy's signal_type)
  811. * @free_priv: function pointer to free private data
  812. * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
  813. */
  814. struct cfg80211_bss {
  815. struct ieee80211_channel *channel;
  816. u8 bssid[ETH_ALEN];
  817. u64 tsf;
  818. u16 beacon_interval;
  819. u16 capability;
  820. u8 *information_elements;
  821. size_t len_information_elements;
  822. u8 *beacon_ies;
  823. size_t len_beacon_ies;
  824. u8 *proberesp_ies;
  825. size_t len_proberesp_ies;
  826. s32 signal;
  827. void (*free_priv)(struct cfg80211_bss *bss);
  828. u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
  829. };
  830. /**
  831. * ieee80211_bss_get_ie - find IE with given ID
  832. * @bss: the bss to search
  833. * @ie: the IE ID
  834. * Returns %NULL if not found.
  835. */
  836. const u8 *ieee80211_bss_get_ie(struct cfg80211_bss *bss, u8 ie);
  837. /**
  838. * struct cfg80211_crypto_settings - Crypto settings
  839. * @wpa_versions: indicates which, if any, WPA versions are enabled
  840. * (from enum nl80211_wpa_versions)
  841. * @cipher_group: group key cipher suite (or 0 if unset)
  842. * @n_ciphers_pairwise: number of AP supported unicast ciphers
  843. * @ciphers_pairwise: unicast key cipher suites
  844. * @n_akm_suites: number of AKM suites
  845. * @akm_suites: AKM suites
  846. * @control_port: Whether user space controls IEEE 802.1X port, i.e.,
  847. * sets/clears %NL80211_STA_FLAG_AUTHORIZED. If true, the driver is
  848. * required to assume that the port is unauthorized until authorized by
  849. * user space. Otherwise, port is marked authorized by default.
  850. * @control_port_ethertype: the control port protocol that should be
  851. * allowed through even on unauthorized ports
  852. * @control_port_no_encrypt: TRUE to prevent encryption of control port
  853. * protocol frames.
  854. */
  855. struct cfg80211_crypto_settings {
  856. u32 wpa_versions;
  857. u32 cipher_group;
  858. int n_ciphers_pairwise;
  859. u32 ciphers_pairwise[NL80211_MAX_NR_CIPHER_SUITES];
  860. int n_akm_suites;
  861. u32 akm_suites[NL80211_MAX_NR_AKM_SUITES];
  862. bool control_port;
  863. __be16 control_port_ethertype;
  864. bool control_port_no_encrypt;
  865. };
  866. /**
  867. * struct cfg80211_auth_request - Authentication request data
  868. *
  869. * This structure provides information needed to complete IEEE 802.11
  870. * authentication.
  871. *
  872. * @bss: The BSS to authenticate with.
  873. * @auth_type: Authentication type (algorithm)
  874. * @ie: Extra IEs to add to Authentication frame or %NULL
  875. * @ie_len: Length of ie buffer in octets
  876. * @key_len: length of WEP key for shared key authentication
  877. * @key_idx: index of WEP key for shared key authentication
  878. * @key: WEP key for shared key authentication
  879. * @local_state_change: This is a request for a local state only, i.e., no
  880. * Authentication frame is to be transmitted and authentication state is
  881. * to be changed without having to wait for a response from the peer STA
  882. * (AP).
  883. */
  884. struct cfg80211_auth_request {
  885. struct cfg80211_bss *bss;
  886. const u8 *ie;
  887. size_t ie_len;
  888. enum nl80211_auth_type auth_type;
  889. const u8 *key;
  890. u8 key_len, key_idx;
  891. bool local_state_change;
  892. };
  893. /**
  894. * struct cfg80211_assoc_request - (Re)Association request data
  895. *
  896. * This structure provides information needed to complete IEEE 802.11
  897. * (re)association.
  898. * @bss: The BSS to associate with.
  899. * @ie: Extra IEs to add to (Re)Association Request frame or %NULL
  900. * @ie_len: Length of ie buffer in octets
  901. * @use_mfp: Use management frame protection (IEEE 802.11w) in this association
  902. * @crypto: crypto settings
  903. * @prev_bssid: previous BSSID, if not %NULL use reassociate frame
  904. */
  905. struct cfg80211_assoc_request {
  906. struct cfg80211_bss *bss;
  907. const u8 *ie, *prev_bssid;
  908. size_t ie_len;
  909. struct cfg80211_crypto_settings crypto;
  910. bool use_mfp;
  911. };
  912. /**
  913. * struct cfg80211_deauth_request - Deauthentication request data
  914. *
  915. * This structure provides information needed to complete IEEE 802.11
  916. * deauthentication.
  917. *
  918. * @bss: the BSS to deauthenticate from
  919. * @ie: Extra IEs to add to Deauthentication frame or %NULL
  920. * @ie_len: Length of ie buffer in octets
  921. * @reason_code: The reason code for the deauthentication
  922. * @local_state_change: This is a request for a local state only, i.e., no
  923. * Deauthentication frame is to be transmitted.
  924. */
  925. struct cfg80211_deauth_request {
  926. struct cfg80211_bss *bss;
  927. const u8 *ie;
  928. size_t ie_len;
  929. u16 reason_code;
  930. bool local_state_change;
  931. };
  932. /**
  933. * struct cfg80211_disassoc_request - Disassociation request data
  934. *
  935. * This structure provides information needed to complete IEEE 802.11
  936. * disassocation.
  937. *
  938. * @bss: the BSS to disassociate from
  939. * @ie: Extra IEs to add to Disassociation frame or %NULL
  940. * @ie_len: Length of ie buffer in octets
  941. * @reason_code: The reason code for the disassociation
  942. * @local_state_change: This is a request for a local state only, i.e., no
  943. * Disassociation frame is to be transmitted.
  944. */
  945. struct cfg80211_disassoc_request {
  946. struct cfg80211_bss *bss;
  947. const u8 *ie;
  948. size_t ie_len;
  949. u16 reason_code;
  950. bool local_state_change;
  951. };
  952. /**
  953. * struct cfg80211_ibss_params - IBSS parameters
  954. *
  955. * This structure defines the IBSS parameters for the join_ibss()
  956. * method.
  957. *
  958. * @ssid: The SSID, will always be non-null.
  959. * @ssid_len: The length of the SSID, will always be non-zero.
  960. * @bssid: Fixed BSSID requested, maybe be %NULL, if set do not
  961. * search for IBSSs with a different BSSID.
  962. * @channel: The channel to use if no IBSS can be found to join.
  963. * @channel_fixed: The channel should be fixed -- do not search for
  964. * IBSSs to join on other channels.
  965. * @ie: information element(s) to include in the beacon
  966. * @ie_len: length of that
  967. * @beacon_interval: beacon interval to use
  968. * @privacy: this is a protected network, keys will be configured
  969. * after joining
  970. * @basic_rates: bitmap of basic rates to use when creating the IBSS
  971. * @mcast_rate: per-band multicast rate index + 1 (0: disabled)
  972. */
  973. struct cfg80211_ibss_params {
  974. u8 *ssid;
  975. u8 *bssid;
  976. struct ieee80211_channel *channel;
  977. u8 *ie;
  978. u8 ssid_len, ie_len;
  979. u16 beacon_interval;
  980. u32 basic_rates;
  981. bool channel_fixed;
  982. bool privacy;
  983. int mcast_rate[IEEE80211_NUM_BANDS];
  984. };
  985. /**
  986. * struct cfg80211_connect_params - Connection parameters
  987. *
  988. * This structure provides information needed to complete IEEE 802.11
  989. * authentication and association.
  990. *
  991. * @channel: The channel to use or %NULL if not specified (auto-select based
  992. * on scan results)
  993. * @bssid: The AP BSSID or %NULL if not specified (auto-select based on scan
  994. * results)
  995. * @ssid: SSID
  996. * @ssid_len: Length of ssid in octets
  997. * @auth_type: Authentication type (algorithm)
  998. * @ie: IEs for association request
  999. * @ie_len: Length of assoc_ie in octets
  1000. * @privacy: indicates whether privacy-enabled APs should be used
  1001. * @crypto: crypto settings
  1002. * @key_len: length of WEP key for shared key authentication
  1003. * @key_idx: index of WEP key for shared key authentication
  1004. * @key: WEP key for shared key authentication
  1005. */
  1006. struct cfg80211_connect_params {
  1007. struct ieee80211_channel *channel;
  1008. u8 *bssid;
  1009. u8 *ssid;
  1010. size_t ssid_len;
  1011. enum nl80211_auth_type auth_type;
  1012. u8 *ie;
  1013. size_t ie_len;
  1014. bool privacy;
  1015. struct cfg80211_crypto_settings crypto;
  1016. const u8 *key;
  1017. u8 key_len, key_idx;
  1018. };
  1019. /**
  1020. * enum wiphy_params_flags - set_wiphy_params bitfield values
  1021. * @WIPHY_PARAM_RETRY_SHORT: wiphy->retry_short has changed
  1022. * @WIPHY_PARAM_RETRY_LONG: wiphy->retry_long has changed
  1023. * @WIPHY_PARAM_FRAG_THRESHOLD: wiphy->frag_threshold has changed
  1024. * @WIPHY_PARAM_RTS_THRESHOLD: wiphy->rts_threshold has changed
  1025. * @WIPHY_PARAM_COVERAGE_CLASS: coverage class changed
  1026. */
  1027. enum wiphy_params_flags {
  1028. WIPHY_PARAM_RETRY_SHORT = 1 << 0,
  1029. WIPHY_PARAM_RETRY_LONG = 1 << 1,
  1030. WIPHY_PARAM_FRAG_THRESHOLD = 1 << 2,
  1031. WIPHY_PARAM_RTS_THRESHOLD = 1 << 3,
  1032. WIPHY_PARAM_COVERAGE_CLASS = 1 << 4,
  1033. };
  1034. /*
  1035. * cfg80211_bitrate_mask - masks for bitrate control
  1036. */
  1037. struct cfg80211_bitrate_mask {
  1038. struct {
  1039. u32 legacy;
  1040. /* TODO: add support for masking MCS rates; e.g.: */
  1041. /* u8 mcs[IEEE80211_HT_MCS_MASK_LEN]; */
  1042. } control[IEEE80211_NUM_BANDS];
  1043. };
  1044. /**
  1045. * struct cfg80211_pmksa - PMK Security Association
  1046. *
  1047. * This structure is passed to the set/del_pmksa() method for PMKSA
  1048. * caching.
  1049. *
  1050. * @bssid: The AP's BSSID.
  1051. * @pmkid: The PMK material itself.
  1052. */
  1053. struct cfg80211_pmksa {
  1054. u8 *bssid;
  1055. u8 *pmkid;
  1056. };
  1057. /**
  1058. * struct cfg80211_wowlan_trig_pkt_pattern - packet pattern
  1059. * @mask: bitmask where to match pattern and where to ignore bytes,
  1060. * one bit per byte, in same format as nl80211
  1061. * @pattern: bytes to match where bitmask is 1
  1062. * @pattern_len: length of pattern (in bytes)
  1063. *
  1064. * Internal note: @mask and @pattern are allocated in one chunk of
  1065. * memory, free @mask only!
  1066. */
  1067. struct cfg80211_wowlan_trig_pkt_pattern {
  1068. u8 *mask, *pattern;
  1069. int pattern_len;
  1070. };
  1071. /**
  1072. * struct cfg80211_wowlan - Wake on Wireless-LAN support info
  1073. *
  1074. * This structure defines the enabled WoWLAN triggers for the device.
  1075. * @any: wake up on any activity -- special trigger if device continues
  1076. * operating as normal during suspend
  1077. * @disconnect: wake up if getting disconnected
  1078. * @magic_pkt: wake up on receiving magic packet
  1079. * @patterns: wake up on receiving packet matching a pattern
  1080. * @n_patterns: number of patterns
  1081. */
  1082. struct cfg80211_wowlan {
  1083. bool any, disconnect, magic_pkt;
  1084. struct cfg80211_wowlan_trig_pkt_pattern *patterns;
  1085. int n_patterns;
  1086. };
  1087. /**
  1088. * struct cfg80211_ops - backend description for wireless configuration
  1089. *
  1090. * This struct is registered by fullmac card drivers and/or wireless stacks
  1091. * in order to handle configuration requests on their interfaces.
  1092. *
  1093. * All callbacks except where otherwise noted should return 0
  1094. * on success or a negative error code.
  1095. *
  1096. * All operations are currently invoked under rtnl for consistency with the
  1097. * wireless extensions but this is subject to reevaluation as soon as this
  1098. * code is used more widely and we have a first user without wext.
  1099. *
  1100. * @suspend: wiphy device needs to be suspended. The variable @wow will
  1101. * be %NULL or contain the enabled Wake-on-Wireless triggers that are
  1102. * configured for the device.
  1103. * @resume: wiphy device needs to be resumed
  1104. *
  1105. * @add_virtual_intf: create a new virtual interface with the given name,
  1106. * must set the struct wireless_dev's iftype. Beware: You must create
  1107. * the new netdev in the wiphy's network namespace! Returns the netdev,
  1108. * or an ERR_PTR.
  1109. *
  1110. * @del_virtual_intf: remove the virtual interface determined by ifindex.
  1111. *
  1112. * @change_virtual_intf: change type/configuration of virtual interface,
  1113. * keep the struct wireless_dev's iftype updated.
  1114. *
  1115. * @add_key: add a key with the given parameters. @mac_addr will be %NULL
  1116. * when adding a group key.
  1117. *
  1118. * @get_key: get information about the key with the given parameters.
  1119. * @mac_addr will be %NULL when requesting information for a group
  1120. * key. All pointers given to the @callback function need not be valid
  1121. * after it returns. This function should return an error if it is
  1122. * not possible to retrieve the key, -ENOENT if it doesn't exist.
  1123. *
  1124. * @del_key: remove a key given the @mac_addr (%NULL for a group key)
  1125. * and @key_index, return -ENOENT if the key doesn't exist.
  1126. *
  1127. * @set_default_key: set the default key on an interface
  1128. *
  1129. * @set_default_mgmt_key: set the default management frame key on an interface
  1130. *
  1131. * @add_beacon: Add a beacon with given parameters, @head, @interval
  1132. * and @dtim_period will be valid, @tail is optional.
  1133. * @set_beacon: Change the beacon parameters for an access point mode
  1134. * interface. This should reject the call when no beacon has been
  1135. * configured.
  1136. * @del_beacon: Remove beacon configuration and stop sending the beacon.
  1137. *
  1138. * @add_station: Add a new station.
  1139. * @del_station: Remove a station; @mac may be NULL to remove all stations.
  1140. * @change_station: Modify a given station.
  1141. * @get_station: get station information for the station identified by @mac
  1142. * @dump_station: dump station callback -- resume dump at index @idx
  1143. *
  1144. * @add_mpath: add a fixed mesh path
  1145. * @del_mpath: delete a given mesh path
  1146. * @change_mpath: change a given mesh path
  1147. * @get_mpath: get a mesh path for the given parameters
  1148. * @dump_mpath: dump mesh path callback -- resume dump at index @idx
  1149. * @join_mesh: join the mesh network with the specified parameters
  1150. * @leave_mesh: leave the current mesh network
  1151. *
  1152. * @get_mesh_config: Get the current mesh configuration
  1153. *
  1154. * @update_mesh_config: Update mesh parameters on a running mesh.
  1155. * The mask is a bitfield which tells us which parameters to
  1156. * set, and which to leave alone.
  1157. *
  1158. * @change_bss: Modify parameters for a given BSS.
  1159. *
  1160. * @set_txq_params: Set TX queue parameters
  1161. *
  1162. * @set_channel: Set channel for a given wireless interface. Some devices
  1163. * may support multi-channel operation (by channel hopping) so cfg80211
  1164. * doesn't verify much. Note, however, that the passed netdev may be
  1165. * %NULL as well if the user requested changing the channel for the
  1166. * device itself, or for a monitor interface.
  1167. *
  1168. * @scan: Request to do a scan. If returning zero, the scan request is given
  1169. * the driver, and will be valid until passed to cfg80211_scan_done().
  1170. * For scan results, call cfg80211_inform_bss(); you can call this outside
  1171. * the scan/scan_done bracket too.
  1172. *
  1173. * @auth: Request to authenticate with the specified peer
  1174. * @assoc: Request to (re)associate with the specified peer
  1175. * @deauth: Request to deauthenticate from the specified peer
  1176. * @disassoc: Request to disassociate from the specified peer
  1177. *
  1178. * @connect: Connect to the ESS with the specified parameters. When connected,
  1179. * call cfg80211_connect_result() with status code %WLAN_STATUS_SUCCESS.
  1180. * If the connection fails for some reason, call cfg80211_connect_result()
  1181. * with the status from the AP.
  1182. * @disconnect: Disconnect from the BSS/ESS.
  1183. *
  1184. * @join_ibss: Join the specified IBSS (or create if necessary). Once done, call
  1185. * cfg80211_ibss_joined(), also call that function when changing BSSID due
  1186. * to a merge.
  1187. * @leave_ibss: Leave the IBSS.
  1188. *
  1189. * @set_wiphy_params: Notify that wiphy parameters have changed;
  1190. * @changed bitfield (see &enum wiphy_params_flags) describes which values
  1191. * have changed. The actual parameter values are available in
  1192. * struct wiphy. If returning an error, no value should be changed.
  1193. *
  1194. * @set_tx_power: set the transmit power according to the parameters
  1195. * @get_tx_power: store the current TX power into the dbm variable;
  1196. * return 0 if successful
  1197. *
  1198. * @set_wds_peer: set the WDS peer for a WDS interface
  1199. *
  1200. * @rfkill_poll: polls the hw rfkill line, use cfg80211 reporting
  1201. * functions to adjust rfkill hw state
  1202. *
  1203. * @dump_survey: get site survey information.
  1204. *
  1205. * @remain_on_channel: Request the driver to remain awake on the specified
  1206. * channel for the specified duration to complete an off-channel
  1207. * operation (e.g., public action frame exchange). When the driver is
  1208. * ready on the requested channel, it must indicate this with an event
  1209. * notification by calling cfg80211_ready_on_channel().
  1210. * @cancel_remain_on_channel: Cancel an on-going remain-on-channel operation.
  1211. * This allows the operation to be terminated prior to timeout based on
  1212. * the duration value.
  1213. * @mgmt_tx: Transmit a management frame.
  1214. * @mgmt_tx_cancel_wait: Cancel the wait time from transmitting a management
  1215. * frame on another channel
  1216. *
  1217. * @testmode_cmd: run a test mode command
  1218. *
  1219. * @set_bitrate_mask: set the bitrate mask configuration
  1220. *
  1221. * @set_pmksa: Cache a PMKID for a BSSID. This is mostly useful for fullmac
  1222. * devices running firmwares capable of generating the (re) association
  1223. * RSN IE. It allows for faster roaming between WPA2 BSSIDs.
  1224. * @del_pmksa: Delete a cached PMKID.
  1225. * @flush_pmksa: Flush all cached PMKIDs.
  1226. * @set_power_mgmt: Configure WLAN power management. A timeout value of -1
  1227. * allows the driver to adjust the dynamic ps timeout value.
  1228. * @set_cqm_rssi_config: Configure connection quality monitor RSSI threshold.
  1229. * @sched_scan_start: Tell the driver to start a scheduled scan.
  1230. * @sched_scan_stop: Tell the driver to stop an ongoing scheduled
  1231. * scan. The driver_initiated flag specifies whether the driver
  1232. * itself has informed that the scan has stopped.
  1233. *
  1234. * @mgmt_frame_register: Notify driver that a management frame type was
  1235. * registered. Note that this callback may not sleep, and cannot run
  1236. * concurrently with itself.
  1237. *
  1238. * @set_antenna: Set antenna configuration (tx_ant, rx_ant) on the device.
  1239. * Parameters are bitmaps of allowed antennas to use for TX/RX. Drivers may
  1240. * reject TX/RX mask combinations they cannot support by returning -EINVAL
  1241. * (also see nl80211.h @NL80211_ATTR_WIPHY_ANTENNA_TX).
  1242. *
  1243. * @get_antenna: Get current antenna configuration from device (tx_ant, rx_ant).
  1244. *
  1245. * @set_ringparam: Set tx and rx ring sizes.
  1246. *
  1247. * @get_ringparam: Get tx and rx ring current and maximum sizes.
  1248. */
  1249. struct cfg80211_ops {
  1250. int (*suspend)(struct wiphy *wiphy, struct cfg80211_wowlan *wow);
  1251. int (*resume)(struct wiphy *wiphy);
  1252. struct net_device * (*add_virtual_intf)(struct wiphy *wiphy,
  1253. char *name,
  1254. enum nl80211_iftype type,
  1255. u32 *flags,
  1256. struct vif_params *params);
  1257. int (*del_virtual_intf)(struct wiphy *wiphy, struct net_device *dev);
  1258. int (*change_virtual_intf)(struct wiphy *wiphy,
  1259. struct net_device *dev,
  1260. enum nl80211_iftype type, u32 *flags,
  1261. struct vif_params *params);
  1262. int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
  1263. u8 key_index, bool pairwise, const u8 *mac_addr,
  1264. struct key_params *params);
  1265. int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
  1266. u8 key_index, bool pairwise, const u8 *mac_addr,
  1267. void *cookie,
  1268. void (*callback)(void *cookie, struct key_params*));
  1269. int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
  1270. u8 key_index, bool pairwise, const u8 *mac_addr);
  1271. int (*set_default_key)(struct wiphy *wiphy,
  1272. struct net_device *netdev,
  1273. u8 key_index, bool unicast, bool multicast);
  1274. int (*set_default_mgmt_key)(struct wiphy *wiphy,
  1275. struct net_device *netdev,
  1276. u8 key_index);
  1277. int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
  1278. struct beacon_parameters *info);
  1279. int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
  1280. struct beacon_parameters *info);
  1281. int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
  1282. int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
  1283. u8 *mac, struct station_parameters *params);
  1284. int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
  1285. u8 *mac);
  1286. int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
  1287. u8 *mac, struct station_parameters *params);
  1288. int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
  1289. u8 *mac, struct station_info *sinfo);
  1290. int (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
  1291. int idx, u8 *mac, struct station_info *sinfo);
  1292. int (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
  1293. u8 *dst, u8 *next_hop);
  1294. int (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
  1295. u8 *dst);
  1296. int (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
  1297. u8 *dst, u8 *next_hop);
  1298. int (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
  1299. u8 *dst, u8 *next_hop,
  1300. struct mpath_info *pinfo);
  1301. int (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
  1302. int idx, u8 *dst, u8 *next_hop,
  1303. struct mpath_info *pinfo);
  1304. int (*get_mesh_config)(struct wiphy *wiphy,
  1305. struct net_device *dev,
  1306. struct mesh_config *conf);
  1307. int (*update_mesh_config)(struct wiphy *wiphy,
  1308. struct net_device *dev, u32 mask,
  1309. const struct mesh_config *nconf);
  1310. int (*join_mesh)(struct wiphy *wiphy, struct net_device *dev,
  1311. const struct mesh_config *conf,
  1312. const struct mesh_setup *setup);
  1313. int (*leave_mesh)(struct wiphy *wiphy, struct net_device *dev);
  1314. int (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
  1315. struct bss_parameters *params);
  1316. int (*set_txq_params)(struct wiphy *wiphy,
  1317. struct ieee80211_txq_params *params);
  1318. int (*set_channel)(struct wiphy *wiphy, struct net_device *dev,
  1319. struct ieee80211_channel *chan,
  1320. enum nl80211_channel_type channel_type);
  1321. int (*scan)(struct wiphy *wiphy, struct net_device *dev,
  1322. struct cfg80211_scan_request *request);
  1323. int (*auth)(struct wiphy *wiphy, struct net_device *dev,
  1324. struct cfg80211_auth_request *req);
  1325. int (*assoc)(struct wiphy *wiphy, struct net_device *dev,
  1326. struct cfg80211_assoc_request *req);
  1327. int (*deauth)(struct wiphy *wiphy, struct net_device *dev,
  1328. struct cfg80211_deauth_request *req,
  1329. void *cookie);
  1330. int (*disassoc)(struct wiphy *wiphy, struct net_device *dev,
  1331. struct cfg80211_disassoc_request *req,
  1332. void *cookie);
  1333. int (*connect)(struct wiphy *wiphy, struct net_device *dev,
  1334. struct cfg80211_connect_params *sme);
  1335. int (*disconnect)(struct wiphy *wiphy, struct net_device *dev,
  1336. u16 reason_code);
  1337. int (*join_ibss)(struct wiphy *wiphy, struct net_device *dev,
  1338. struct cfg80211_ibss_params *params);
  1339. int (*leave_ibss)(struct wiphy *wiphy, struct net_device *dev);
  1340. int (*set_wiphy_params)(struct wiphy *wiphy, u32 changed);
  1341. int (*set_tx_power)(struct wiphy *wiphy,
  1342. enum nl80211_tx_power_setting type, int mbm);
  1343. int (*get_tx_power)(struct wiphy *wiphy, int *dbm);
  1344. int (*set_wds_peer)(struct wiphy *wiphy, struct net_device *dev,
  1345. const u8 *addr);
  1346. void (*rfkill_poll)(struct wiphy *wiphy);
  1347. #ifdef CONFIG_NL80211_TESTMODE
  1348. int (*testmode_cmd)(struct wiphy *wiphy, void *data, int len);
  1349. #endif
  1350. int (*set_bitrate_mask)(struct wiphy *wiphy,
  1351. struct net_device *dev,
  1352. const u8 *peer,
  1353. const struct cfg80211_bitrate_mask *mask);
  1354. int (*dump_survey)(struct wiphy *wiphy, struct net_device *netdev,
  1355. int idx, struct survey_info *info);
  1356. int (*set_pmksa)(struct wiphy *wiphy, struct net_device *netdev,
  1357. struct cfg80211_pmksa *pmksa);
  1358. int (*del_pmksa)(struct wiphy *wiphy, struct net_device *netdev,
  1359. struct cfg80211_pmksa *pmksa);
  1360. int (*flush_pmksa)(struct wiphy *wiphy, struct net_device *netdev);
  1361. int (*remain_on_channel)(struct wiphy *wiphy,
  1362. struct net_device *dev,
  1363. struct ieee80211_channel *chan,
  1364. enum nl80211_channel_type channel_type,
  1365. unsigned int duration,
  1366. u64 *cookie);
  1367. int (*cancel_remain_on_channel)(struct wiphy *wiphy,
  1368. struct net_device *dev,
  1369. u64 cookie);
  1370. int (*mgmt_tx)(struct wiphy *wiphy, struct net_device *dev,
  1371. struct ieee80211_channel *chan, bool offchan,
  1372. enum nl80211_channel_type channel_type,
  1373. bool channel_type_valid, unsigned int wait,
  1374. const u8 *buf, size_t len, u64 *cookie);
  1375. int (*mgmt_tx_cancel_wait)(struct wiphy *wiphy,
  1376. struct net_device *dev,
  1377. u64 cookie);
  1378. int (*set_power_mgmt)(struct wiphy *wiphy, struct net_device *dev,
  1379. bool enabled, int timeout);
  1380. int (*set_cqm_rssi_config)(struct wiphy *wiphy,
  1381. struct net_device *dev,
  1382. s32 rssi_thold, u32 rssi_hyst);
  1383. void (*mgmt_frame_register)(struct wiphy *wiphy,
  1384. struct net_device *dev,
  1385. u16 frame_type, bool reg);
  1386. int (*set_antenna)(struct wiphy *wiphy, u32 tx_ant, u32 rx_ant);
  1387. int (*get_antenna)(struct wiphy *wiphy, u32 *tx_ant, u32 *rx_ant);
  1388. int (*set_ringparam)(struct wiphy *wiphy, u32 tx, u32 rx);
  1389. void (*get_ringparam)(struct wiphy *wiphy,
  1390. u32 *tx, u32 *tx_max, u32 *rx, u32 *rx_max);
  1391. int (*sched_scan_start)(struct wiphy *wiphy,
  1392. struct net_device *dev,
  1393. struct cfg80211_sched_scan_request *request);
  1394. int (*sched_scan_stop)(struct wiphy *wiphy, struct net_device *dev);
  1395. };
  1396. /*
  1397. * wireless hardware and networking interfaces structures
  1398. * and registration/helper functions
  1399. */
  1400. /**
  1401. * enum wiphy_flags - wiphy capability flags
  1402. *
  1403. * @WIPHY_FLAG_CUSTOM_REGULATORY: tells us the driver for this device
  1404. * has its own custom regulatory domain and cannot identify the
  1405. * ISO / IEC 3166 alpha2 it belongs to. When this is enabled
  1406. * we will disregard the first regulatory hint (when the
  1407. * initiator is %REGDOM_SET_BY_CORE).
  1408. * @WIPHY_FLAG_STRICT_REGULATORY: tells us the driver for this device will
  1409. * ignore regulatory domain settings until it gets its own regulatory
  1410. * domain via its regulatory_hint() unless the regulatory hint is
  1411. * from a country IE. After its gets its own regulatory domain it will
  1412. * only allow further regulatory domain settings to further enhance
  1413. * compliance. For example if channel 13 and 14 are disabled by this
  1414. * regulatory domain no user regulatory domain can enable these channels
  1415. * at a later time. This can be used for devices which do not have
  1416. * calibration information guaranteed for frequencies or settings
  1417. * outside of its regulatory domain.
  1418. * @WIPHY_FLAG_DISABLE_BEACON_HINTS: enable this if your driver needs to ensure
  1419. * that passive scan flags and beaconing flags may not be lifted by
  1420. * cfg80211 due to regulatory beacon hints. For more information on beacon
  1421. * hints read the documenation for regulatory_hint_found_beacon()
  1422. * @WIPHY_FLAG_NETNS_OK: if not set, do not allow changing the netns of this
  1423. * wiphy at all
  1424. * @WIPHY_FLAG_ENFORCE_COMBINATIONS: Set this flag to enforce interface
  1425. * combinations for this device. This flag is used for backward
  1426. * compatibility only until all drivers advertise combinations and
  1427. * they will always be enforced.
  1428. * @WIPHY_FLAG_PS_ON_BY_DEFAULT: if set to true, powersave will be enabled
  1429. * by default -- this flag will be set depending on the kernel's default
  1430. * on wiphy_new(), but can be changed by the driver if it has a good
  1431. * reason to override the default
  1432. * @WIPHY_FLAG_4ADDR_AP: supports 4addr mode even on AP (with a single station
  1433. * on a VLAN interface)
  1434. * @WIPHY_FLAG_4ADDR_STATION: supports 4addr mode even as a station
  1435. * @WIPHY_FLAG_CONTROL_PORT_PROTOCOL: This device supports setting the
  1436. * control port protocol ethertype. The device also honours the
  1437. * control_port_no_encrypt flag.
  1438. * @WIPHY_FLAG_IBSS_RSN: The device supports IBSS RSN.
  1439. * @WIPHY_FLAG_MESH_AUTH: The device supports mesh authentication by routing
  1440. * auth frames to userspace. See @NL80211_MESH_SETUP_USERSPACE_AUTH.
  1441. * @WIPHY_FLAG_SCHED_SCAN: The device supports scheduled scans.
  1442. */
  1443. enum wiphy_flags {
  1444. WIPHY_FLAG_CUSTOM_REGULATORY = BIT(0),
  1445. WIPHY_FLAG_STRICT_REGULATORY = BIT(1),
  1446. WIPHY_FLAG_DISABLE_BEACON_HINTS = BIT(2),
  1447. WIPHY_FLAG_NETNS_OK = BIT(3),
  1448. WIPHY_FLAG_PS_ON_BY_DEFAULT = BIT(4),
  1449. WIPHY_FLAG_4ADDR_AP = BIT(5),
  1450. WIPHY_FLAG_4ADDR_STATION = BIT(6),
  1451. WIPHY_FLAG_CONTROL_PORT_PROTOCOL = BIT(7),
  1452. WIPHY_FLAG_IBSS_RSN = BIT(8),
  1453. WIPHY_FLAG_MESH_AUTH = BIT(10),
  1454. WIPHY_FLAG_SUPPORTS_SCHED_SCAN = BIT(11),
  1455. WIPHY_FLAG_ENFORCE_COMBINATIONS = BIT(12),
  1456. };
  1457. /**
  1458. * struct ieee80211_iface_limit - limit on certain interface types
  1459. * @max: maximum number of interfaces of these types
  1460. * @types: interface types (bits)
  1461. */
  1462. struct ieee80211_iface_limit {
  1463. u16 max;
  1464. u16 types;
  1465. };
  1466. /**
  1467. * struct ieee80211_iface_combination - possible interface combination
  1468. * @limits: limits for the given interface types
  1469. * @n_limits: number of limitations
  1470. * @num_different_channels: can use up to this many different channels
  1471. * @max_interfaces: maximum number of interfaces in total allowed in this
  1472. * group
  1473. * @beacon_int_infra_match: In this combination, the beacon intervals
  1474. * between infrastructure and AP types must match. This is required
  1475. * only in special cases.
  1476. *
  1477. * These examples can be expressed as follows:
  1478. *
  1479. * Allow #STA <= 1, #AP <= 1, matching BI, channels = 1, 2 total:
  1480. *
  1481. * struct ieee80211_iface_limit limits1[] = {
  1482. * { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
  1483. * { .max = 1, .types = BIT(NL80211_IFTYPE_AP}, },
  1484. * };
  1485. * struct ieee80211_iface_combination combination1 = {
  1486. * .limits = limits1,
  1487. * .n_limits = ARRAY_SIZE(limits1),
  1488. * .max_interfaces = 2,
  1489. * .beacon_int_infra_match = true,
  1490. * };
  1491. *
  1492. *
  1493. * Allow #{AP, P2P-GO} <= 8, channels = 1, 8 total:
  1494. *
  1495. * struct ieee80211_iface_limit limits2[] = {
  1496. * { .max = 8, .types = BIT(NL80211_IFTYPE_AP) |
  1497. * BIT(NL80211_IFTYPE_P2P_GO), },
  1498. * };
  1499. * struct ieee80211_iface_combination combination2 = {
  1500. * .limits = limits2,
  1501. * .n_limits = ARRAY_SIZE(limits2),
  1502. * .max_interfaces = 8,
  1503. * .num_different_channels = 1,
  1504. * };
  1505. *
  1506. *
  1507. * Allow #STA <= 1, #{P2P-client,P2P-GO} <= 3 on two channels, 4 total.
  1508. * This allows for an infrastructure connection and three P2P connections.
  1509. *
  1510. * struct ieee80211_iface_limit limits3[] = {
  1511. * { .max = 1, .types = BIT(NL80211_IFTYPE_STATION), },
  1512. * { .max = 3, .types = BIT(NL80211_IFTYPE_P2P_GO) |
  1513. * BIT(NL80211_IFTYPE_P2P_CLIENT), },
  1514. * };
  1515. * struct ieee80211_iface_combination combination3 = {
  1516. * .limits = limits3,
  1517. * .n_limits = ARRAY_SIZE(limits3),
  1518. * .max_interfaces = 4,
  1519. * .num_different_channels = 2,
  1520. * };
  1521. */
  1522. struct ieee80211_iface_combination {
  1523. const struct ieee80211_iface_limit *limits;
  1524. u32 num_different_channels;
  1525. u16 max_interfaces;
  1526. u8 n_limits;
  1527. bool beacon_int_infra_match;
  1528. };
  1529. struct mac_address {
  1530. u8 addr[ETH_ALEN];
  1531. };
  1532. struct ieee80211_txrx_stypes {
  1533. u16 tx, rx;
  1534. };
  1535. /**
  1536. * enum wiphy_wowlan_support_flags - WoWLAN support flags
  1537. * @WIPHY_WOWLAN_ANY: supports wakeup for the special "any"
  1538. * trigger that keeps the device operating as-is and
  1539. * wakes up the host on any activity, for example a
  1540. * received packet that passed filtering; note that the
  1541. * packet should be preserved in that case
  1542. * @WIPHY_WOWLAN_MAGIC_PKT: supports wakeup on magic packet
  1543. * (see nl80211.h)
  1544. * @WIPHY_WOWLAN_DISCONNECT: supports wakeup on disconnect
  1545. */
  1546. enum wiphy_wowlan_support_flags {
  1547. WIPHY_WOWLAN_ANY = BIT(0),
  1548. WIPHY_WOWLAN_MAGIC_PKT = BIT(1),
  1549. WIPHY_WOWLAN_DISCONNECT = BIT(2),
  1550. };
  1551. /**
  1552. * struct wiphy_wowlan_support - WoWLAN support data
  1553. * @flags: see &enum wiphy_wowlan_support_flags
  1554. * @n_patterns: number of supported wakeup patterns
  1555. * (see nl80211.h for the pattern definition)
  1556. * @pattern_max_len: maximum length of each pattern
  1557. * @pattern_min_len: minimum length of each pattern
  1558. */
  1559. struct wiphy_wowlan_support {
  1560. u32 flags;
  1561. int n_patterns;
  1562. int pattern_max_len;
  1563. int pattern_min_len;
  1564. };
  1565. /**
  1566. * struct wiphy - wireless hardware description
  1567. * @reg_notifier: the driver's regulatory notification callback,
  1568. * note that if your driver uses wiphy_apply_custom_regulatory()
  1569. * the reg_notifier's request can be passed as NULL
  1570. * @regd: the driver's regulatory domain, if one was requested via
  1571. * the regulatory_hint() API. This can be used by the driver
  1572. * on the reg_notifier() if it chooses to ignore future
  1573. * regulatory domain changes caused by other drivers.
  1574. * @signal_type: signal type reported in &struct cfg80211_bss.
  1575. * @cipher_suites: supported cipher suites
  1576. * @n_cipher_suites: number of supported cipher suites
  1577. * @retry_short: Retry limit for short frames (dot11ShortRetryLimit)
  1578. * @retry_long: Retry limit for long frames (dot11LongRetryLimit)
  1579. * @frag_threshold: Fragmentation threshold (dot11FragmentationThreshold);
  1580. * -1 = fragmentation disabled, only odd values >= 256 used
  1581. * @rts_threshold: RTS threshold (dot11RTSThreshold); -1 = RTS/CTS disabled
  1582. * @_net: the network namespace this wiphy currently lives in
  1583. * @perm_addr: permanent MAC address of this device
  1584. * @addr_mask: If the device supports multiple MAC addresses by masking,
  1585. * set this to a mask with variable bits set to 1, e.g. if the last
  1586. * four bits are variable then set it to 00:...:00:0f. The actual
  1587. * variable bits shall be determined by the interfaces added, with
  1588. * interfaces not matching the mask being rejected to be brought up.
  1589. * @n_addresses: number of addresses in @addresses.
  1590. * @addresses: If the device has more than one address, set this pointer
  1591. * to a list of addresses (6 bytes each). The first one will be used
  1592. * by default for perm_addr. In this case, the mask should be set to
  1593. * all-zeroes. In this case it is assumed that the device can handle
  1594. * the same number of arbitrary MAC addresses.
  1595. * @debugfsdir: debugfs directory used for this wiphy, will be renamed
  1596. * automatically on wiphy renames
  1597. * @dev: (virtual) struct device for this wiphy
  1598. * @wext: wireless extension handlers
  1599. * @priv: driver private data (sized according to wiphy_new() parameter)
  1600. * @interface_modes: bitmask of interfaces types valid for this wiphy,
  1601. * must be set by driver
  1602. * @iface_combinations: Valid interface combinations array, should not
  1603. * list single interface types.
  1604. * @n_iface_combinations: number of entries in @iface_combinations array.
  1605. * @software_iftypes: bitmask of software interface types, these are not
  1606. * subject to any restrictions since they are purely managed in SW.
  1607. * @flags: wiphy flags, see &enum wiphy_flags
  1608. * @bss_priv_size: each BSS struct has private data allocated with it,
  1609. * this variable determines its size
  1610. * @max_scan_ssids: maximum number of SSIDs the device can scan for in
  1611. * any given scan
  1612. * @max_scan_ie_len: maximum length of user-controlled IEs device can
  1613. * add to probe request frames transmitted during a scan, must not
  1614. * include fixed IEs like supported rates
  1615. * @coverage_class: current coverage class
  1616. * @fw_version: firmware version for ethtool reporting
  1617. * @hw_version: hardware version for ethtool reporting
  1618. * @max_num_pmkids: maximum number of PMKIDs supported by device
  1619. * @privid: a pointer that drivers can use to identify if an arbitrary
  1620. * wiphy is theirs, e.g. in global notifiers
  1621. * @bands: information about bands/channels supported by this device
  1622. *
  1623. * @mgmt_stypes: bitmasks of frame subtypes that can be subscribed to or
  1624. * transmitted through nl80211, points to an array indexed by interface
  1625. * type
  1626. *
  1627. * @available_antennas_tx: bitmap of antennas which are available to be
  1628. * configured as TX antennas. Antenna configuration commands will be
  1629. * rejected unless this or @available_antennas_rx is set.
  1630. *
  1631. * @available_antennas_rx: bitmap of antennas which are available to be
  1632. * configured as RX antennas. Antenna configuration commands will be
  1633. * rejected unless this or @available_antennas_tx is set.
  1634. *
  1635. * @max_remain_on_channel_duration: Maximum time a remain-on-channel operation
  1636. * may request, if implemented.
  1637. *
  1638. * @wowlan: WoWLAN support information
  1639. */
  1640. struct wiphy {
  1641. /* assign these fields before you register the wiphy */
  1642. /* permanent MAC address(es) */
  1643. u8 perm_addr[ETH_ALEN];
  1644. u8 addr_mask[ETH_ALEN];
  1645. struct mac_address *addresses;
  1646. const struct ieee80211_txrx_stypes *mgmt_stypes;
  1647. const struct ieee80211_iface_combination *iface_combinations;
  1648. int n_iface_combinations;
  1649. u16 software_iftypes;
  1650. u16 n_addresses;
  1651. /* Supported interface modes, OR together BIT(NL80211_IFTYPE_...) */
  1652. u16 interface_modes;
  1653. u32 flags;
  1654. enum cfg80211_signal_type signal_type;
  1655. int bss_priv_size;
  1656. u8 max_scan_ssids;
  1657. u16 max_scan_ie_len;
  1658. int n_cipher_suites;
  1659. const u32 *cipher_suites;
  1660. u8 retry_short;
  1661. u8 retry_long;
  1662. u32 frag_threshold;
  1663. u32 rts_threshold;
  1664. u8 coverage_class;
  1665. char fw_version[ETHTOOL_BUSINFO_LEN];
  1666. u32 hw_version;
  1667. struct wiphy_wowlan_support wowlan;
  1668. u16 max_remain_on_channel_duration;
  1669. u8 max_num_pmkids;
  1670. u32 available_antennas_tx;
  1671. u32 available_antennas_rx;
  1672. /* If multiple wiphys are registered and you're handed e.g.
  1673. * a regular netdev with assigned ieee80211_ptr, you won't
  1674. * know whether it points to a wiphy your driver has registered
  1675. * or not. Assign this to something global to your driver to
  1676. * help determine whether you own this wiphy or not. */
  1677. const void *privid;
  1678. struct ieee80211_supported_band *bands[IEEE80211_NUM_BANDS];
  1679. /* Lets us get back the wiphy on the callback */
  1680. int (*reg_notifier)(struct wiphy *wiphy,
  1681. struct regulatory_request *request);
  1682. /* fields below are read-only, assigned by cfg80211 */
  1683. const struct ieee80211_regdomain *regd;
  1684. /* the item in /sys/class/ieee80211/ points to this,
  1685. * you need use set_wiphy_dev() (see below) */
  1686. struct device dev;
  1687. /* dir in debugfs: ieee80211/<wiphyname> */
  1688. struct dentry *debugfsdir;
  1689. #ifdef CONFIG_NET_NS
  1690. /* the network namespace this phy lives in currently */
  1691. struct net *_net;
  1692. #endif
  1693. #ifdef CONFIG_CFG80211_WEXT
  1694. const struct iw_handler_def *wext;
  1695. #endif
  1696. char priv[0] __attribute__((__aligned__(NETDEV_ALIGN)));
  1697. };
  1698. static inline struct net *wiphy_net(struct wiphy *wiphy)
  1699. {
  1700. return read_pnet(&wiphy->_net);
  1701. }
  1702. static inline void wiphy_net_set(struct wiphy *wiphy, struct net *net)
  1703. {
  1704. write_pnet(&wiphy->_net, net);
  1705. }
  1706. /**
  1707. * wiphy_priv - return priv from wiphy
  1708. *
  1709. * @wiphy: the wiphy whose priv pointer to return
  1710. */
  1711. static inline void *wiphy_priv(struct wiphy *wiphy)
  1712. {
  1713. BUG_ON(!wiphy);
  1714. return &wiphy->priv;
  1715. }
  1716. /**
  1717. * priv_to_wiphy - return the wiphy containing the priv
  1718. *
  1719. * @priv: a pointer previously returned by wiphy_priv
  1720. */
  1721. static inline struct wiphy *priv_to_wiphy(void *priv)
  1722. {
  1723. BUG_ON(!priv);
  1724. return container_of(priv, struct wiphy, priv);
  1725. }
  1726. /**
  1727. * set_wiphy_dev - set device pointer for wiphy
  1728. *
  1729. * @wiphy: The wiphy whose device to bind
  1730. * @dev: The device to parent it to
  1731. */
  1732. static inline void set_wiphy_dev(struct wiphy *wiphy, struct device *dev)
  1733. {
  1734. wiphy->dev.parent = dev;
  1735. }
  1736. /**
  1737. * wiphy_dev - get wiphy dev pointer
  1738. *
  1739. * @wiphy: The wiphy whose device struct to look up
  1740. */
  1741. static inline struct device *wiphy_dev(struct wiphy *wiphy)
  1742. {
  1743. return wiphy->dev.parent;
  1744. }
  1745. /**
  1746. * wiphy_name - get wiphy name
  1747. *
  1748. * @wiphy: The wiphy whose name to return
  1749. */
  1750. static inline const char *wiphy_name(const struct wiphy *wiphy)
  1751. {
  1752. return dev_name(&wiphy->dev);
  1753. }
  1754. /**
  1755. * wiphy_new - create a new wiphy for use with cfg80211
  1756. *
  1757. * @ops: The configuration operations for this device
  1758. * @sizeof_priv: The size of the private area to allocate
  1759. *
  1760. * Create a new wiphy and associate the given operations with it.
  1761. * @sizeof_priv bytes are allocated for private use.
  1762. *
  1763. * The returned pointer must be assigned to each netdev's
  1764. * ieee80211_ptr for proper operation.
  1765. */
  1766. struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv);
  1767. /**
  1768. * wiphy_register - register a wiphy with cfg80211
  1769. *
  1770. * @wiphy: The wiphy to register.
  1771. *
  1772. * Returns a non-negative wiphy index or a negative error code.
  1773. */
  1774. extern int wiphy_register(struct wiphy *wiphy);
  1775. /**
  1776. * wiphy_unregister - deregister a wiphy from cfg80211
  1777. *
  1778. * @wiphy: The wiphy to unregister.
  1779. *
  1780. * After this call, no more requests can be made with this priv
  1781. * pointer, but the call may sleep to wait for an outstanding
  1782. * request that is being handled.
  1783. */
  1784. extern void wiphy_unregister(struct wiphy *wiphy);
  1785. /**
  1786. * wiphy_free - free wiphy
  1787. *
  1788. * @wiphy: The wiphy to free
  1789. */
  1790. extern void wiphy_free(struct wiphy *wiphy);
  1791. /* internal structs */
  1792. struct cfg80211_conn;
  1793. struct cfg80211_internal_bss;
  1794. struct cfg80211_cached_keys;
  1795. #define MAX_AUTH_BSSES 4
  1796. /**
  1797. * struct wireless_dev - wireless per-netdev state
  1798. *
  1799. * This structure must be allocated by the driver/stack
  1800. * that uses the ieee80211_ptr field in struct net_device
  1801. * (this is intentional so it can be allocated along with
  1802. * the netdev.)
  1803. *
  1804. * @wiphy: pointer to hardware description
  1805. * @iftype: interface type
  1806. * @list: (private) Used to collect the interfaces
  1807. * @netdev: (private) Used to reference back to the netdev
  1808. * @current_bss: (private) Used by the internal configuration code
  1809. * @channel: (private) Used by the internal configuration code to track
  1810. * user-set AP, monitor and WDS channels for wireless extensions
  1811. * @bssid: (private) Used by the internal configuration code
  1812. * @ssid: (private) Used by the internal configuration code
  1813. * @ssid_len: (private) Used by the internal configuration code
  1814. * @mesh_id_len: (private) Used by the internal configuration code
  1815. * @mesh_id_up_len: (private) Used by the internal configuration code
  1816. * @wext: (private) Used by the internal wireless extensions compat code
  1817. * @use_4addr: indicates 4addr mode is used on this interface, must be
  1818. * set by driver (if supported) on add_interface BEFORE registering the
  1819. * netdev and may otherwise be used by driver read-only, will be update
  1820. * by cfg80211 on change_interface
  1821. * @mgmt_registrations: list of registrations for management frames
  1822. * @mgmt_registrations_lock: lock for the list
  1823. * @mtx: mutex used to lock data in this struct
  1824. * @cleanup_work: work struct used for cleanup that can't be done directly
  1825. * @beacon_interval: beacon interval used on this device for transmitting
  1826. * beacons, 0 when not valid
  1827. */
  1828. struct wireless_dev {
  1829. struct wiphy *wiphy;
  1830. enum nl80211_iftype iftype;
  1831. /* the remainder of this struct should be private to cfg80211 */
  1832. struct list_head list;
  1833. struct net_device *netdev;
  1834. struct list_head mgmt_registrations;
  1835. spinlock_t mgmt_registrations_lock;
  1836. struct mutex mtx;
  1837. struct work_struct cleanup_work;
  1838. bool use_4addr;
  1839. /* currently used for IBSS and SME - might be rearranged later */
  1840. u8 ssid[IEEE80211_MAX_SSID_LEN];
  1841. u8 ssid_len, mesh_id_len, mesh_id_up_len;
  1842. enum {
  1843. CFG80211_SME_IDLE,
  1844. CFG80211_SME_CONNECTING,
  1845. CFG80211_SME_CONNECTED,
  1846. } sme_state;
  1847. struct cfg80211_conn *conn;
  1848. struct cfg80211_cached_keys *connect_keys;
  1849. struct list_head event_list;
  1850. spinlock_t event_lock;
  1851. struct cfg80211_internal_bss *authtry_bsses[MAX_AUTH_BSSES];
  1852. struct cfg80211_internal_bss *auth_bsses[MAX_AUTH_BSSES];
  1853. struct cfg80211_internal_bss *current_bss; /* associated / joined */
  1854. struct ieee80211_channel *channel;
  1855. bool ps;
  1856. int ps_timeout;
  1857. int beacon_interval;
  1858. #ifdef CONFIG_CFG80211_WEXT
  1859. /* wext data */
  1860. struct {
  1861. struct cfg80211_ibss_params ibss;
  1862. struct cfg80211_connect_params connect;
  1863. struct cfg80211_cached_keys *keys;
  1864. u8 *ie;
  1865. size_t ie_len;
  1866. u8 bssid[ETH_ALEN], prev_bssid[ETH_ALEN];
  1867. u8 ssid[IEEE80211_MAX_SSID_LEN];
  1868. s8 default_key, default_mgmt_key;
  1869. bool prev_bssid_valid;
  1870. } wext;
  1871. #endif
  1872. };
  1873. /**
  1874. * wdev_priv - return wiphy priv from wireless_dev
  1875. *
  1876. * @wdev: The wireless device whose wiphy's priv pointer to return
  1877. */
  1878. static inline void *wdev_priv(struct wireless_dev *wdev)
  1879. {
  1880. BUG_ON(!wdev);
  1881. return wiphy_priv(wdev->wiphy);
  1882. }
  1883. /**
  1884. * DOC: Utility functions
  1885. *
  1886. * cfg80211 offers a number of utility functions that can be useful.
  1887. */
  1888. /**
  1889. * ieee80211_channel_to_frequency - convert channel number to frequency
  1890. * @chan: channel number
  1891. * @band: band, necessary due to channel number overlap
  1892. */
  1893. extern int ieee80211_channel_to_frequency(int chan, enum ieee80211_band band);
  1894. /**
  1895. * ieee80211_frequency_to_channel - convert frequency to channel number
  1896. * @freq: center frequency
  1897. */
  1898. extern int ieee80211_frequency_to_channel(int freq);
  1899. /*
  1900. * Name indirection necessary because the ieee80211 code also has
  1901. * a function named "ieee80211_get_channel", so if you include
  1902. * cfg80211's header file you get cfg80211's version, if you try
  1903. * to include both header files you'll (rightfully!) get a symbol
  1904. * clash.
  1905. */
  1906. extern struct ieee80211_channel *__ieee80211_get_channel(struct wiphy *wiphy,
  1907. int freq);
  1908. /**
  1909. * ieee80211_get_channel - get channel struct from wiphy for specified frequency
  1910. * @wiphy: the struct wiphy to get the channel for
  1911. * @freq: the center frequency of the channel
  1912. */
  1913. static inline struct ieee80211_channel *
  1914. ieee80211_get_channel(struct wiphy *wiphy, int freq)
  1915. {
  1916. return __ieee80211_get_channel(wiphy, freq);
  1917. }
  1918. /**
  1919. * ieee80211_get_response_rate - get basic rate for a given rate
  1920. *
  1921. * @sband: the band to look for rates in
  1922. * @basic_rates: bitmap of basic rates
  1923. * @bitrate: the bitrate for which to find the basic rate
  1924. *
  1925. * This function returns the basic rate corresponding to a given
  1926. * bitrate, that is the next lower bitrate contained in the basic
  1927. * rate map, which is, for this function, given as a bitmap of
  1928. * indices of rates in the band's bitrate table.
  1929. */
  1930. struct ieee80211_rate *
  1931. ieee80211_get_response_rate(struct ieee80211_supported_band *sband,
  1932. u32 basic_rates, int bitrate);
  1933. /*
  1934. * Radiotap parsing functions -- for controlled injection support
  1935. *
  1936. * Implemented in net/wireless/radiotap.c
  1937. * Documentation in Documentation/networking/radiotap-headers.txt
  1938. */
  1939. struct radiotap_align_size {
  1940. uint8_t align:4, size:4;
  1941. };
  1942. struct ieee80211_radiotap_namespace {
  1943. const struct radiotap_align_size *align_size;
  1944. int n_bits;
  1945. uint32_t oui;
  1946. uint8_t subns;
  1947. };
  1948. struct ieee80211_radiotap_vendor_namespaces {
  1949. const struct ieee80211_radiotap_namespace *ns;
  1950. int n_ns;
  1951. };
  1952. /**
  1953. * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
  1954. * @this_arg_index: index of current arg, valid after each successful call
  1955. * to ieee80211_radiotap_iterator_next()
  1956. * @this_arg: pointer to current radiotap arg; it is valid after each
  1957. * call to ieee80211_radiotap_iterator_next() but also after
  1958. * ieee80211_radiotap_iterator_init() where it will point to
  1959. * the beginning of the actual data portion
  1960. * @this_arg_size: length of the current arg, for convenience
  1961. * @current_namespace: pointer to the current namespace definition
  1962. * (or internally %NULL if the current namespace is unknown)
  1963. * @is_radiotap_ns: indicates whether the current namespace is the default
  1964. * radiotap namespace or not
  1965. *
  1966. * @_rtheader: pointer to the radiotap header we are walking through
  1967. * @_max_length: length of radiotap header in cpu byte ordering
  1968. * @_arg_index: next argument index
  1969. * @_arg: next argument pointer
  1970. * @_next_bitmap: internal pointer to next present u32
  1971. * @_bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
  1972. * @_vns: vendor namespace definitions
  1973. * @_next_ns_data: beginning of the next namespace's data
  1974. * @_reset_on_ext: internal; reset the arg index to 0 when going to the
  1975. * next bitmap word
  1976. *
  1977. * Describes the radiotap parser state. Fields prefixed with an underscore
  1978. * must not be used by users of the parser, only by the parser internally.
  1979. */
  1980. struct ieee80211_radiotap_iterator {
  1981. struct ieee80211_radiotap_header *_rtheader;
  1982. const struct ieee80211_radiotap_vendor_namespaces *_vns;
  1983. const struct ieee80211_radiotap_namespace *current_namespace;
  1984. unsigned char *_arg, *_next_ns_data;
  1985. __le32 *_next_bitmap;
  1986. unsigned char *this_arg;
  1987. int this_arg_index;
  1988. int this_arg_size;
  1989. int is_radiotap_ns;
  1990. int _max_length;
  1991. int _arg_index;
  1992. uint32_t _bitmap_shifter;
  1993. int _reset_on_ext;
  1994. };
  1995. extern int ieee80211_radiotap_iterator_init(
  1996. struct ieee80211_radiotap_iterator *iterator,
  1997. struct ieee80211_radiotap_header *radiotap_header,
  1998. int max_length, const struct ieee80211_radiotap_vendor_namespaces *vns);
  1999. extern int ieee80211_radiotap_iterator_next(
  2000. struct ieee80211_radiotap_iterator *iterator);
  2001. extern const unsigned char rfc1042_header[6];
  2002. extern const unsigned char bridge_tunnel_header[6];
  2003. /**
  2004. * ieee80211_get_hdrlen_from_skb - get header length from data
  2005. *
  2006. * Given an skb with a raw 802.11 header at the data pointer this function
  2007. * returns the 802.11 header length in bytes (not including encryption
  2008. * headers). If the data in the sk_buff is too short to contain a valid 802.11
  2009. * header the function returns 0.
  2010. *
  2011. * @skb: the frame
  2012. */
  2013. unsigned int ieee80211_get_hdrlen_from_skb(const struct sk_buff *skb);
  2014. /**
  2015. * ieee80211_hdrlen - get header length in bytes from frame control
  2016. * @fc: frame control field in little-endian format
  2017. */
  2018. unsigned int __attribute_const__ ieee80211_hdrlen(__le16 fc);
  2019. /**
  2020. * DOC: Data path helpers
  2021. *
  2022. * In addition to generic utilities, cfg80211 also offers
  2023. * functions that help implement the data path for devices
  2024. * that do not do the 802.11/802.3 conversion on the device.
  2025. */
  2026. /**
  2027. * ieee80211_data_to_8023 - convert an 802.11 data frame to 802.3
  2028. * @skb: the 802.11 data frame
  2029. * @addr: the device MAC address
  2030. * @iftype: the virtual interface type
  2031. */
  2032. int ieee80211_data_to_8023(struct sk_buff *skb, const u8 *addr,
  2033. enum nl80211_iftype iftype);
  2034. /**
  2035. * ieee80211_data_from_8023 - convert an 802.3 frame to 802.11
  2036. * @skb: the 802.3 frame
  2037. * @addr: the device MAC address
  2038. * @iftype: the virtual interface type
  2039. * @bssid: the network bssid (used only for iftype STATION and ADHOC)
  2040. * @qos: build 802.11 QoS data frame
  2041. */
  2042. int ieee80211_data_from_8023(struct sk_buff *skb, const u8 *addr,
  2043. enum nl80211_iftype iftype, u8 *bssid, bool qos);
  2044. /**
  2045. * ieee80211_amsdu_to_8023s - decode an IEEE 802.11n A-MSDU frame
  2046. *
  2047. * Decode an IEEE 802.11n A-MSDU frame and convert it to a list of
  2048. * 802.3 frames. The @list will be empty if the decode fails. The
  2049. * @skb is consumed after the function returns.
  2050. *
  2051. * @skb: The input IEEE 802.11n A-MSDU frame.
  2052. * @list: The output list of 802.3 frames. It must be allocated and
  2053. * initialized by by the caller.
  2054. * @addr: The device MAC address.
  2055. * @iftype: The device interface type.
  2056. * @extra_headroom: The hardware extra headroom for SKBs in the @list.
  2057. */
  2058. void ieee80211_amsdu_to_8023s(struct sk_buff *skb, struct sk_buff_head *list,
  2059. const u8 *addr, enum nl80211_iftype iftype,
  2060. const unsigned int extra_headroom);
  2061. /**
  2062. * cfg80211_classify8021d - determine the 802.1p/1d tag for a data frame
  2063. * @skb: the data frame
  2064. */
  2065. unsigned int cfg80211_classify8021d(struct sk_buff *skb);
  2066. /**
  2067. * cfg80211_find_ie - find information element in data
  2068. *
  2069. * @eid: element ID
  2070. * @ies: data consisting of IEs
  2071. * @len: length of data
  2072. *
  2073. * This function will return %NULL if the element ID could
  2074. * not be found or if the element is invalid (claims to be
  2075. * longer than the given data), or a pointer to the first byte
  2076. * of the requested element, that is the byte containing the
  2077. * element ID. There are no checks on the element length
  2078. * other than having to fit into the given data.
  2079. */
  2080. const u8 *cfg80211_find_ie(u8 eid, const u8 *ies, int len);
  2081. /**
  2082. * DOC: Regulatory enforcement infrastructure
  2083. *
  2084. * TODO
  2085. */
  2086. /**
  2087. * regulatory_hint - driver hint to the wireless core a regulatory domain
  2088. * @wiphy: the wireless device giving the hint (used only for reporting
  2089. * conflicts)
  2090. * @alpha2: the ISO/IEC 3166 alpha2 the driver claims its regulatory domain
  2091. * should be in. If @rd is set this should be NULL. Note that if you
  2092. * set this to NULL you should still set rd->alpha2 to some accepted
  2093. * alpha2.
  2094. *
  2095. * Wireless drivers can use this function to hint to the wireless core
  2096. * what it believes should be the current regulatory domain by
  2097. * giving it an ISO/IEC 3166 alpha2 country code it knows its regulatory
  2098. * domain should be in or by providing a completely build regulatory domain.
  2099. * If the driver provides an ISO/IEC 3166 alpha2 userspace will be queried
  2100. * for a regulatory domain structure for the respective country.
  2101. *
  2102. * The wiphy must have been registered to cfg80211 prior to this call.
  2103. * For cfg80211 drivers this means you must first use wiphy_register(),
  2104. * for mac80211 drivers you must first use ieee80211_register_hw().
  2105. *
  2106. * Drivers should check the return value, its possible you can get
  2107. * an -ENOMEM.
  2108. */
  2109. extern int regulatory_hint(struct wiphy *wiphy, const char *alpha2);
  2110. /**
  2111. * wiphy_apply_custom_regulatory - apply a custom driver regulatory domain
  2112. * @wiphy: the wireless device we want to process the regulatory domain on
  2113. * @regd: the custom regulatory domain to use for this wiphy
  2114. *
  2115. * Drivers can sometimes have custom regulatory domains which do not apply
  2116. * to a specific country. Drivers can use this to apply such custom regulatory
  2117. * domains. This routine must be called prior to wiphy registration. The
  2118. * custom regulatory domain will be trusted completely and as such previous
  2119. * default channel settings will be disregarded. If no rule is found for a
  2120. * channel on the regulatory domain the channel will be disabled.
  2121. */
  2122. extern void wiphy_apply_custom_regulatory(
  2123. struct wiphy *wiphy,
  2124. const struct ieee80211_regdomain *regd);
  2125. /**
  2126. * freq_reg_info - get regulatory information for the given frequency
  2127. * @wiphy: the wiphy for which we want to process this rule for
  2128. * @center_freq: Frequency in KHz for which we want regulatory information for
  2129. * @desired_bw_khz: the desired max bandwidth you want to use per
  2130. * channel. Note that this is still 20 MHz if you want to use HT40
  2131. * as HT40 makes use of two channels for its 40 MHz width bandwidth.
  2132. * If set to 0 we'll assume you want the standard 20 MHz.
  2133. * @reg_rule: the regulatory rule which we have for this frequency
  2134. *
  2135. * Use this function to get the regulatory rule for a specific frequency on
  2136. * a given wireless device. If the device has a specific regulatory domain
  2137. * it wants to follow we respect that unless a country IE has been received
  2138. * and processed already.
  2139. *
  2140. * Returns 0 if it was able to find a valid regulatory rule which does
  2141. * apply to the given center_freq otherwise it returns non-zero. It will
  2142. * also return -ERANGE if we determine the given center_freq does not even have
  2143. * a regulatory rule for a frequency range in the center_freq's band. See
  2144. * freq_in_rule_band() for our current definition of a band -- this is purely
  2145. * subjective and right now its 802.11 specific.
  2146. */
  2147. extern int freq_reg_info(struct wiphy *wiphy,
  2148. u32 center_freq,
  2149. u32 desired_bw_khz,
  2150. const struct ieee80211_reg_rule **reg_rule);
  2151. /*
  2152. * Temporary wext handlers & helper functions
  2153. *
  2154. * In the future cfg80211 will simply assign the entire wext handler
  2155. * structure to netdevs it manages, but we're not there yet.
  2156. */
  2157. int cfg80211_wext_giwname(struct net_device *dev,
  2158. struct iw_request_info *info,
  2159. char *name, char *extra);
  2160. int cfg80211_wext_siwmode(struct net_device *dev, struct iw_request_info *info,
  2161. u32 *mode, char *extra);
  2162. int cfg80211_wext_giwmode(struct net_device *dev, struct iw_request_info *info,
  2163. u32 *mode, char *extra);
  2164. int cfg80211_wext_siwscan(struct net_device *dev,
  2165. struct iw_request_info *info,
  2166. union iwreq_data *wrqu, char *extra);
  2167. int cfg80211_wext_giwscan(struct net_device *dev,
  2168. struct iw_request_info *info,
  2169. struct iw_point *data, char *extra);
  2170. int cfg80211_wext_siwmlme(struct net_device *dev,
  2171. struct iw_request_info *info,
  2172. struct iw_point *data, char *extra);
  2173. int cfg80211_wext_giwrange(struct net_device *dev,
  2174. struct iw_request_info *info,
  2175. struct iw_point *data, char *extra);
  2176. int cfg80211_wext_siwgenie(struct net_device *dev,
  2177. struct iw_request_info *info,
  2178. struct iw_point *data, char *extra);
  2179. int cfg80211_wext_siwauth(struct net_device *dev,
  2180. struct iw_request_info *info,
  2181. struct iw_param *data, char *extra);
  2182. int cfg80211_wext_giwauth(struct net_device *dev,
  2183. struct iw_request_info *info,
  2184. struct iw_param *data, char *extra);
  2185. int cfg80211_wext_siwfreq(struct net_device *dev,
  2186. struct iw_request_info *info,
  2187. struct iw_freq *freq, char *extra);
  2188. int cfg80211_wext_giwfreq(struct net_device *dev,
  2189. struct iw_request_info *info,
  2190. struct iw_freq *freq, char *extra);
  2191. int cfg80211_wext_siwessid(struct net_device *dev,
  2192. struct iw_request_info *info,
  2193. struct iw_point *data, char *ssid);
  2194. int cfg80211_wext_giwessid(struct net_device *dev,
  2195. struct iw_request_info *info,
  2196. struct iw_point *data, char *ssid);
  2197. int cfg80211_wext_siwrate(struct net_device *dev,
  2198. struct iw_request_info *info,
  2199. struct iw_param *rate, char *extra);
  2200. int cfg80211_wext_giwrate(struct net_device *dev,
  2201. struct iw_request_info *info,
  2202. struct iw_param *rate, char *extra);
  2203. int cfg80211_wext_siwrts(struct net_device *dev,
  2204. struct iw_request_info *info,
  2205. struct iw_param *rts, char *extra);
  2206. int cfg80211_wext_giwrts(struct net_device *dev,
  2207. struct iw_request_info *info,
  2208. struct iw_param *rts, char *extra);
  2209. int cfg80211_wext_siwfrag(struct net_device *dev,
  2210. struct iw_request_info *info,
  2211. struct iw_param *frag, char *extra);
  2212. int cfg80211_wext_giwfrag(struct net_device *dev,
  2213. struct iw_request_info *info,
  2214. struct iw_param *frag, char *extra);
  2215. int cfg80211_wext_siwretry(struct net_device *dev,
  2216. struct iw_request_info *info,
  2217. struct iw_param *retry, char *extra);
  2218. int cfg80211_wext_giwretry(struct net_device *dev,
  2219. struct iw_request_info *info,
  2220. struct iw_param *retry, char *extra);
  2221. int cfg80211_wext_siwencodeext(struct net_device *dev,
  2222. struct iw_request_info *info,
  2223. struct iw_point *erq, char *extra);
  2224. int cfg80211_wext_siwencode(struct net_device *dev,
  2225. struct iw_request_info *info,
  2226. struct iw_point *erq, char *keybuf);
  2227. int cfg80211_wext_giwencode(struct net_device *dev,
  2228. struct iw_request_info *info,
  2229. struct iw_point *erq, char *keybuf);
  2230. int cfg80211_wext_siwtxpower(struct net_device *dev,
  2231. struct iw_request_info *info,
  2232. union iwreq_data *data, char *keybuf);
  2233. int cfg80211_wext_giwtxpower(struct net_device *dev,
  2234. struct iw_request_info *info,
  2235. union iwreq_data *data, char *keybuf);
  2236. struct iw_statistics *cfg80211_wireless_stats(struct net_device *dev);
  2237. int cfg80211_wext_siwpower(struct net_device *dev,
  2238. struct iw_request_info *info,
  2239. struct iw_param *wrq, char *extra);
  2240. int cfg80211_wext_giwpower(struct net_device *dev,
  2241. struct iw_request_info *info,
  2242. struct iw_param *wrq, char *extra);
  2243. int cfg80211_wext_siwap(struct net_device *dev,
  2244. struct iw_request_info *info,
  2245. struct sockaddr *ap_addr, char *extra);
  2246. int cfg80211_wext_giwap(struct net_device *dev,
  2247. struct iw_request_info *info,
  2248. struct sockaddr *ap_addr, char *extra);
  2249. int cfg80211_wext_siwpmksa(struct net_device *dev,
  2250. struct iw_request_info *info,
  2251. struct iw_point *data, char *extra);
  2252. /*
  2253. * callbacks for asynchronous cfg80211 methods, notification
  2254. * functions and BSS handling helpers
  2255. */
  2256. /**
  2257. * cfg80211_scan_done - notify that scan finished
  2258. *
  2259. * @request: the corresponding scan request
  2260. * @aborted: set to true if the scan was aborted for any reason,
  2261. * userspace will be notified of that
  2262. */
  2263. void cfg80211_scan_done(struct cfg80211_scan_request *request, bool aborted);
  2264. /**
  2265. * cfg80211_sched_scan_results - notify that new scan results are available
  2266. *
  2267. * @wiphy: the wiphy which got scheduled scan results
  2268. */
  2269. void cfg80211_sched_scan_results(struct wiphy *wiphy);
  2270. /**
  2271. * cfg80211_sched_scan_stopped - notify that the scheduled scan has stopped
  2272. *
  2273. * @wiphy: the wiphy on which the scheduled scan stopped
  2274. *
  2275. * The driver can call this function to inform cfg80211 that the
  2276. * scheduled scan had to be stopped, for whatever reason. The driver
  2277. * is then called back via the sched_scan_stop operation when done.
  2278. */
  2279. void cfg80211_sched_scan_stopped(struct wiphy *wiphy);
  2280. /**
  2281. * cfg80211_inform_bss_frame - inform cfg80211 of a received BSS frame
  2282. *
  2283. * @wiphy: the wiphy reporting the BSS
  2284. * @channel: The channel the frame was received on
  2285. * @mgmt: the management frame (probe response or beacon)
  2286. * @len: length of the management frame
  2287. * @signal: the signal strength, type depends on the wiphy's signal_type
  2288. * @gfp: context flags
  2289. *
  2290. * This informs cfg80211 that BSS information was found and
  2291. * the BSS should be updated/added.
  2292. */
  2293. struct cfg80211_bss*
  2294. cfg80211_inform_bss_frame(struct wiphy *wiphy,
  2295. struct ieee80211_channel *channel,
  2296. struct ieee80211_mgmt *mgmt, size_t len,
  2297. s32 signal, gfp_t gfp);
  2298. /**
  2299. * cfg80211_inform_bss - inform cfg80211 of a new BSS
  2300. *
  2301. * @wiphy: the wiphy reporting the BSS
  2302. * @channel: The channel the frame was received on
  2303. * @bssid: the BSSID of the BSS
  2304. * @timestamp: the TSF timestamp sent by the peer
  2305. * @capability: the capability field sent by the peer
  2306. * @beacon_interval: the beacon interval announced by the peer
  2307. * @ie: additional IEs sent by the peer
  2308. * @ielen: length of the additional IEs
  2309. * @signal: the signal strength, type depends on the wiphy's signal_type
  2310. * @gfp: context flags
  2311. *
  2312. * This informs cfg80211 that BSS information was found and
  2313. * the BSS should be updated/added.
  2314. */
  2315. struct cfg80211_bss*
  2316. cfg80211_inform_bss(struct wiphy *wiphy,
  2317. struct ieee80211_channel *channel,
  2318. const u8 *bssid,
  2319. u64 timestamp, u16 capability, u16 beacon_interval,
  2320. const u8 *ie, size_t ielen,
  2321. s32 signal, gfp_t gfp);
  2322. struct cfg80211_bss *cfg80211_get_bss(struct wiphy *wiphy,
  2323. struct ieee80211_channel *channel,
  2324. const u8 *bssid,
  2325. const u8 *ssid, size_t ssid_len,
  2326. u16 capa_mask, u16 capa_val);
  2327. static inline struct cfg80211_bss *
  2328. cfg80211_get_ibss(struct wiphy *wiphy,
  2329. struct ieee80211_channel *channel,
  2330. const u8 *ssid, size_t ssid_len)
  2331. {
  2332. return cfg80211_get_bss(wiphy, channel, NULL, ssid, ssid_len,
  2333. WLAN_CAPABILITY_IBSS, WLAN_CAPABILITY_IBSS);
  2334. }
  2335. struct cfg80211_bss *cfg80211_get_mesh(struct wiphy *wiphy,
  2336. struct ieee80211_channel *channel,
  2337. const u8 *meshid, size_t meshidlen,
  2338. const u8 *meshcfg);
  2339. void cfg80211_put_bss(struct cfg80211_bss *bss);
  2340. /**
  2341. * cfg80211_unlink_bss - unlink BSS from internal data structures
  2342. * @wiphy: the wiphy
  2343. * @bss: the bss to remove
  2344. *
  2345. * This function removes the given BSS from the internal data structures
  2346. * thereby making it no longer show up in scan results etc. Use this
  2347. * function when you detect a BSS is gone. Normally BSSes will also time
  2348. * out, so it is not necessary to use this function at all.
  2349. */
  2350. void cfg80211_unlink_bss(struct wiphy *wiphy, struct cfg80211_bss *bss);
  2351. /**
  2352. * cfg80211_send_rx_auth - notification of processed authentication
  2353. * @dev: network device
  2354. * @buf: authentication frame (header + body)
  2355. * @len: length of the frame data
  2356. *
  2357. * This function is called whenever an authentication has been processed in
  2358. * station mode. The driver is required to call either this function or
  2359. * cfg80211_send_auth_timeout() to indicate the result of cfg80211_ops::auth()
  2360. * call. This function may sleep.
  2361. */
  2362. void cfg80211_send_rx_auth(struct net_device *dev, const u8 *buf, size_t len);
  2363. /**
  2364. * cfg80211_send_auth_timeout - notification of timed out authentication
  2365. * @dev: network device
  2366. * @addr: The MAC address of the device with which the authentication timed out
  2367. *
  2368. * This function may sleep.
  2369. */
  2370. void cfg80211_send_auth_timeout(struct net_device *dev, const u8 *addr);
  2371. /**
  2372. * __cfg80211_auth_canceled - notify cfg80211 that authentication was canceled
  2373. * @dev: network device
  2374. * @addr: The MAC address of the device with which the authentication timed out
  2375. *
  2376. * When a pending authentication had no action yet, the driver may decide
  2377. * to not send a deauth frame, but in that case must calls this function
  2378. * to tell cfg80211 about this decision. It is only valid to call this
  2379. * function within the deauth() callback.
  2380. */
  2381. void __cfg80211_auth_canceled(struct net_device *dev, const u8 *addr);
  2382. /**
  2383. * cfg80211_send_rx_assoc - notification of processed association
  2384. * @dev: network device
  2385. * @buf: (re)association response frame (header + body)
  2386. * @len: length of the frame data
  2387. *
  2388. * This function is called whenever a (re)association response has been
  2389. * processed in station mode. The driver is required to call either this
  2390. * function or cfg80211_send_assoc_timeout() to indicate the result of
  2391. * cfg80211_ops::assoc() call. This function may sleep.
  2392. */
  2393. void cfg80211_send_rx_assoc(struct net_device *dev, const u8 *buf, size_t len);
  2394. /**
  2395. * cfg80211_send_assoc_timeout - notification of timed out association
  2396. * @dev: network device
  2397. * @addr: The MAC address of the device with which the association timed out
  2398. *
  2399. * This function may sleep.
  2400. */
  2401. void cfg80211_send_assoc_timeout(struct net_device *dev, const u8 *addr);
  2402. /**
  2403. * cfg80211_send_deauth - notification of processed deauthentication
  2404. * @dev: network device
  2405. * @buf: deauthentication frame (header + body)
  2406. * @len: length of the frame data
  2407. *
  2408. * This function is called whenever deauthentication has been processed in
  2409. * station mode. This includes both received deauthentication frames and
  2410. * locally generated ones. This function may sleep.
  2411. */
  2412. void cfg80211_send_deauth(struct net_device *dev, const u8 *buf, size_t len);
  2413. /**
  2414. * __cfg80211_send_deauth - notification of processed deauthentication
  2415. * @dev: network device
  2416. * @buf: deauthentication frame (header + body)
  2417. * @len: length of the frame data
  2418. *
  2419. * Like cfg80211_send_deauth(), but doesn't take the wdev lock.
  2420. */
  2421. void __cfg80211_send_deauth(struct net_device *dev, const u8 *buf, size_t len);
  2422. /**
  2423. * cfg80211_send_disassoc - notification of processed disassociation
  2424. * @dev: network device
  2425. * @buf: disassociation response frame (header + body)
  2426. * @len: length of the frame data
  2427. *
  2428. * This function is called whenever disassociation has been processed in
  2429. * station mode. This includes both received disassociation frames and locally
  2430. * generated ones. This function may sleep.
  2431. */
  2432. void cfg80211_send_disassoc(struct net_device *dev, const u8 *buf, size_t len);
  2433. /**
  2434. * __cfg80211_send_disassoc - notification of processed disassociation
  2435. * @dev: network device
  2436. * @buf: disassociation response frame (header + body)
  2437. * @len: length of the frame data
  2438. *
  2439. * Like cfg80211_send_disassoc(), but doesn't take the wdev lock.
  2440. */
  2441. void __cfg80211_send_disassoc(struct net_device *dev, const u8 *buf,
  2442. size_t len);
  2443. /**
  2444. * cfg80211_send_unprot_deauth - notification of unprotected deauthentication
  2445. * @dev: network device
  2446. * @buf: deauthentication frame (header + body)
  2447. * @len: length of the frame data
  2448. *
  2449. * This function is called whenever a received Deauthentication frame has been
  2450. * dropped in station mode because of MFP being used but the Deauthentication
  2451. * frame was not protected. This function may sleep.
  2452. */
  2453. void cfg80211_send_unprot_deauth(struct net_device *dev, const u8 *buf,
  2454. size_t len);
  2455. /**
  2456. * cfg80211_send_unprot_disassoc - notification of unprotected disassociation
  2457. * @dev: network device
  2458. * @buf: disassociation frame (header + body)
  2459. * @len: length of the frame data
  2460. *
  2461. * This function is called whenever a received Disassociation frame has been
  2462. * dropped in station mode because of MFP being used but the Disassociation
  2463. * frame was not protected. This function may sleep.
  2464. */
  2465. void cfg80211_send_unprot_disassoc(struct net_device *dev, const u8 *buf,
  2466. size_t len);
  2467. /**
  2468. * cfg80211_michael_mic_failure - notification of Michael MIC failure (TKIP)
  2469. * @dev: network device
  2470. * @addr: The source MAC address of the frame
  2471. * @key_type: The key type that the received frame used
  2472. * @key_id: Key identifier (0..3)
  2473. * @tsc: The TSC value of the frame that generated the MIC failure (6 octets)
  2474. * @gfp: allocation flags
  2475. *
  2476. * This function is called whenever the local MAC detects a MIC failure in a
  2477. * received frame. This matches with MLME-MICHAELMICFAILURE.indication()
  2478. * primitive.
  2479. */
  2480. void cfg80211_michael_mic_failure(struct net_device *dev, const u8 *addr,
  2481. enum nl80211_key_type key_type, int key_id,
  2482. const u8 *tsc, gfp_t gfp);
  2483. /**
  2484. * cfg80211_ibss_joined - notify cfg80211 that device joined an IBSS
  2485. *
  2486. * @dev: network device
  2487. * @bssid: the BSSID of the IBSS joined
  2488. * @gfp: allocation flags
  2489. *
  2490. * This function notifies cfg80211 that the device joined an IBSS or
  2491. * switched to a different BSSID. Before this function can be called,
  2492. * either a beacon has to have been received from the IBSS, or one of
  2493. * the cfg80211_inform_bss{,_frame} functions must have been called
  2494. * with the locally generated beacon -- this guarantees that there is
  2495. * always a scan result for this IBSS. cfg80211 will handle the rest.
  2496. */
  2497. void cfg80211_ibss_joined(struct net_device *dev, const u8 *bssid, gfp_t gfp);
  2498. /**
  2499. * cfg80211_notify_new_candidate - notify cfg80211 of a new mesh peer candidate
  2500. *
  2501. * @dev: network device
  2502. * @macaddr: the MAC address of the new candidate
  2503. * @ie: information elements advertised by the peer candidate
  2504. * @ie_len: lenght of the information elements buffer
  2505. * @gfp: allocation flags
  2506. *
  2507. * This function notifies cfg80211 that the mesh peer candidate has been
  2508. * detected, most likely via a beacon or, less likely, via a probe response.
  2509. * cfg80211 then sends a notification to userspace.
  2510. */
  2511. void cfg80211_notify_new_peer_candidate(struct net_device *dev,
  2512. const u8 *macaddr, const u8 *ie, u8 ie_len, gfp_t gfp);
  2513. /**
  2514. * DOC: RFkill integration
  2515. *
  2516. * RFkill integration in cfg80211 is almost invisible to drivers,
  2517. * as cfg80211 automatically registers an rfkill instance for each
  2518. * wireless device it knows about. Soft kill is also translated
  2519. * into disconnecting and turning all interfaces off, drivers are
  2520. * expected to turn off the device when all interfaces are down.
  2521. *
  2522. * However, devices may have a hard RFkill line, in which case they
  2523. * also need to interact with the rfkill subsystem, via cfg80211.
  2524. * They can do this with a few helper functions documented here.
  2525. */
  2526. /**
  2527. * wiphy_rfkill_set_hw_state - notify cfg80211 about hw block state
  2528. * @wiphy: the wiphy
  2529. * @blocked: block status
  2530. */
  2531. void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked);
  2532. /**
  2533. * wiphy_rfkill_start_polling - start polling rfkill
  2534. * @wiphy: the wiphy
  2535. */
  2536. void wiphy_rfkill_start_polling(struct wiphy *wiphy);
  2537. /**
  2538. * wiphy_rfkill_stop_polling - stop polling rfkill
  2539. * @wiphy: the wiphy
  2540. */
  2541. void wiphy_rfkill_stop_polling(struct wiphy *wiphy);
  2542. #ifdef CONFIG_NL80211_TESTMODE
  2543. /**
  2544. * DOC: Test mode
  2545. *
  2546. * Test mode is a set of utility functions to allow drivers to
  2547. * interact with driver-specific tools to aid, for instance,
  2548. * factory programming.
  2549. *
  2550. * This chapter describes how drivers interact with it, for more
  2551. * information see the nl80211 book's chapter on it.
  2552. */
  2553. /**
  2554. * cfg80211_testmode_alloc_reply_skb - allocate testmode reply
  2555. * @wiphy: the wiphy
  2556. * @approxlen: an upper bound of the length of the data that will
  2557. * be put into the skb
  2558. *
  2559. * This function allocates and pre-fills an skb for a reply to
  2560. * the testmode command. Since it is intended for a reply, calling
  2561. * it outside of the @testmode_cmd operation is invalid.
  2562. *
  2563. * The returned skb (or %NULL if any errors happen) is pre-filled
  2564. * with the wiphy index and set up in a way that any data that is
  2565. * put into the skb (with skb_put(), nla_put() or similar) will end
  2566. * up being within the %NL80211_ATTR_TESTDATA attribute, so all that
  2567. * needs to be done with the skb is adding data for the corresponding
  2568. * userspace tool which can then read that data out of the testdata
  2569. * attribute. You must not modify the skb in any other way.
  2570. *
  2571. * When done, call cfg80211_testmode_reply() with the skb and return
  2572. * its error code as the result of the @testmode_cmd operation.
  2573. */
  2574. struct sk_buff *cfg80211_testmode_alloc_reply_skb(struct wiphy *wiphy,
  2575. int approxlen);
  2576. /**
  2577. * cfg80211_testmode_reply - send the reply skb
  2578. * @skb: The skb, must have been allocated with
  2579. * cfg80211_testmode_alloc_reply_skb()
  2580. *
  2581. * Returns an error code or 0 on success, since calling this
  2582. * function will usually be the last thing before returning
  2583. * from the @testmode_cmd you should return the error code.
  2584. * Note that this function consumes the skb regardless of the
  2585. * return value.
  2586. */
  2587. int cfg80211_testmode_reply(struct sk_buff *skb);
  2588. /**
  2589. * cfg80211_testmode_alloc_event_skb - allocate testmode event
  2590. * @wiphy: the wiphy
  2591. * @approxlen: an upper bound of the length of the data that will
  2592. * be put into the skb
  2593. * @gfp: allocation flags
  2594. *
  2595. * This function allocates and pre-fills an skb for an event on the
  2596. * testmode multicast group.
  2597. *
  2598. * The returned skb (or %NULL if any errors happen) is set up in the
  2599. * same way as with cfg80211_testmode_alloc_reply_skb() but prepared
  2600. * for an event. As there, you should simply add data to it that will
  2601. * then end up in the %NL80211_ATTR_TESTDATA attribute. Again, you must
  2602. * not modify the skb in any other way.
  2603. *
  2604. * When done filling the skb, call cfg80211_testmode_event() with the
  2605. * skb to send the event.
  2606. */
  2607. struct sk_buff *cfg80211_testmode_alloc_event_skb(struct wiphy *wiphy,
  2608. int approxlen, gfp_t gfp);
  2609. /**
  2610. * cfg80211_testmode_event - send the event
  2611. * @skb: The skb, must have been allocated with
  2612. * cfg80211_testmode_alloc_event_skb()
  2613. * @gfp: allocation flags
  2614. *
  2615. * This function sends the given @skb, which must have been allocated
  2616. * by cfg80211_testmode_alloc_event_skb(), as an event. It always
  2617. * consumes it.
  2618. */
  2619. void cfg80211_testmode_event(struct sk_buff *skb, gfp_t gfp);
  2620. #define CFG80211_TESTMODE_CMD(cmd) .testmode_cmd = (cmd),
  2621. #else
  2622. #define CFG80211_TESTMODE_CMD(cmd)
  2623. #endif
  2624. /**
  2625. * cfg80211_connect_result - notify cfg80211 of connection result
  2626. *
  2627. * @dev: network device
  2628. * @bssid: the BSSID of the AP
  2629. * @req_ie: association request IEs (maybe be %NULL)
  2630. * @req_ie_len: association request IEs length
  2631. * @resp_ie: association response IEs (may be %NULL)
  2632. * @resp_ie_len: assoc response IEs length
  2633. * @status: status code, 0 for successful connection, use
  2634. * %WLAN_STATUS_UNSPECIFIED_FAILURE if your device cannot give you
  2635. * the real status code for failures.
  2636. * @gfp: allocation flags
  2637. *
  2638. * It should be called by the underlying driver whenever connect() has
  2639. * succeeded.
  2640. */
  2641. void cfg80211_connect_result(struct net_device *dev, const u8 *bssid,
  2642. const u8 *req_ie, size_t req_ie_len,
  2643. const u8 *resp_ie, size_t resp_ie_len,
  2644. u16 status, gfp_t gfp);
  2645. /**
  2646. * cfg80211_roamed - notify cfg80211 of roaming
  2647. *
  2648. * @dev: network device
  2649. * @bssid: the BSSID of the new AP
  2650. * @req_ie: association request IEs (maybe be %NULL)
  2651. * @req_ie_len: association request IEs length
  2652. * @resp_ie: association response IEs (may be %NULL)
  2653. * @resp_ie_len: assoc response IEs length
  2654. * @gfp: allocation flags
  2655. *
  2656. * It should be called by the underlying driver whenever it roamed
  2657. * from one AP to another while connected.
  2658. */
  2659. void cfg80211_roamed(struct net_device *dev, const u8 *bssid,
  2660. const u8 *req_ie, size_t req_ie_len,
  2661. const u8 *resp_ie, size_t resp_ie_len, gfp_t gfp);
  2662. /**
  2663. * cfg80211_disconnected - notify cfg80211 that connection was dropped
  2664. *
  2665. * @dev: network device
  2666. * @ie: information elements of the deauth/disassoc frame (may be %NULL)
  2667. * @ie_len: length of IEs
  2668. * @reason: reason code for the disconnection, set it to 0 if unknown
  2669. * @gfp: allocation flags
  2670. *
  2671. * After it calls this function, the driver should enter an idle state
  2672. * and not try to connect to any AP any more.
  2673. */
  2674. void cfg80211_disconnected(struct net_device *dev, u16 reason,
  2675. u8 *ie, size_t ie_len, gfp_t gfp);
  2676. /**
  2677. * cfg80211_ready_on_channel - notification of remain_on_channel start
  2678. * @dev: network device
  2679. * @cookie: the request cookie
  2680. * @chan: The current channel (from remain_on_channel request)
  2681. * @channel_type: Channel type
  2682. * @duration: Duration in milliseconds that the driver intents to remain on the
  2683. * channel
  2684. * @gfp: allocation flags
  2685. */
  2686. void cfg80211_ready_on_channel(struct net_device *dev, u64 cookie,
  2687. struct ieee80211_channel *chan,
  2688. enum nl80211_channel_type channel_type,
  2689. unsigned int duration, gfp_t gfp);
  2690. /**
  2691. * cfg80211_remain_on_channel_expired - remain_on_channel duration expired
  2692. * @dev: network device
  2693. * @cookie: the request cookie
  2694. * @chan: The current channel (from remain_on_channel request)
  2695. * @channel_type: Channel type
  2696. * @gfp: allocation flags
  2697. */
  2698. void cfg80211_remain_on_channel_expired(struct net_device *dev,
  2699. u64 cookie,
  2700. struct ieee80211_channel *chan,
  2701. enum nl80211_channel_type channel_type,
  2702. gfp_t gfp);
  2703. /**
  2704. * cfg80211_new_sta - notify userspace about station
  2705. *
  2706. * @dev: the netdev
  2707. * @mac_addr: the station's address
  2708. * @sinfo: the station information
  2709. * @gfp: allocation flags
  2710. */
  2711. void cfg80211_new_sta(struct net_device *dev, const u8 *mac_addr,
  2712. struct station_info *sinfo, gfp_t gfp);
  2713. /**
  2714. * cfg80211_del_sta - notify userspace about deletion of a station
  2715. *
  2716. * @dev: the netdev
  2717. * @mac_addr: the station's address
  2718. * @gfp: allocation flags
  2719. */
  2720. void cfg80211_del_sta(struct net_device *dev, const u8 *mac_addr, gfp_t gfp);
  2721. /**
  2722. * cfg80211_rx_mgmt - notification of received, unprocessed management frame
  2723. * @dev: network device
  2724. * @freq: Frequency on which the frame was received in MHz
  2725. * @buf: Management frame (header + body)
  2726. * @len: length of the frame data
  2727. * @gfp: context flags
  2728. *
  2729. * Returns %true if a user space application has registered for this frame.
  2730. * For action frames, that makes it responsible for rejecting unrecognized
  2731. * action frames; %false otherwise, in which case for action frames the
  2732. * driver is responsible for rejecting the frame.
  2733. *
  2734. * This function is called whenever an Action frame is received for a station
  2735. * mode interface, but is not processed in kernel.
  2736. */
  2737. bool cfg80211_rx_mgmt(struct net_device *dev, int freq, const u8 *buf,
  2738. size_t len, gfp_t gfp);
  2739. /**
  2740. * cfg80211_mgmt_tx_status - notification of TX status for management frame
  2741. * @dev: network device
  2742. * @cookie: Cookie returned by cfg80211_ops::mgmt_tx()
  2743. * @buf: Management frame (header + body)
  2744. * @len: length of the frame data
  2745. * @ack: Whether frame was acknowledged
  2746. * @gfp: context flags
  2747. *
  2748. * This function is called whenever a management frame was requested to be
  2749. * transmitted with cfg80211_ops::mgmt_tx() to report the TX status of the
  2750. * transmission attempt.
  2751. */
  2752. void cfg80211_mgmt_tx_status(struct net_device *dev, u64 cookie,
  2753. const u8 *buf, size_t len, bool ack, gfp_t gfp);
  2754. /**
  2755. * cfg80211_cqm_rssi_notify - connection quality monitoring rssi event
  2756. * @dev: network device
  2757. * @rssi_event: the triggered RSSI event
  2758. * @gfp: context flags
  2759. *
  2760. * This function is called when a configured connection quality monitoring
  2761. * rssi threshold reached event occurs.
  2762. */
  2763. void cfg80211_cqm_rssi_notify(struct net_device *dev,
  2764. enum nl80211_cqm_rssi_threshold_event rssi_event,
  2765. gfp_t gfp);
  2766. /**
  2767. * cfg80211_cqm_pktloss_notify - notify userspace about packetloss to peer
  2768. * @dev: network device
  2769. * @peer: peer's MAC address
  2770. * @num_packets: how many packets were lost -- should be a fixed threshold
  2771. * but probably no less than maybe 50, or maybe a throughput dependent
  2772. * threshold (to account for temporary interference)
  2773. * @gfp: context flags
  2774. */
  2775. void cfg80211_cqm_pktloss_notify(struct net_device *dev,
  2776. const u8 *peer, u32 num_packets, gfp_t gfp);
  2777. /* Logging, debugging and troubleshooting/diagnostic helpers. */
  2778. /* wiphy_printk helpers, similar to dev_printk */
  2779. #define wiphy_printk(level, wiphy, format, args...) \
  2780. dev_printk(level, &(wiphy)->dev, format, ##args)
  2781. #define wiphy_emerg(wiphy, format, args...) \
  2782. dev_emerg(&(wiphy)->dev, format, ##args)
  2783. #define wiphy_alert(wiphy, format, args...) \
  2784. dev_alert(&(wiphy)->dev, format, ##args)
  2785. #define wiphy_crit(wiphy, format, args...) \
  2786. dev_crit(&(wiphy)->dev, format, ##args)
  2787. #define wiphy_err(wiphy, format, args...) \
  2788. dev_err(&(wiphy)->dev, format, ##args)
  2789. #define wiphy_warn(wiphy, format, args...) \
  2790. dev_warn(&(wiphy)->dev, format, ##args)
  2791. #define wiphy_notice(wiphy, format, args...) \
  2792. dev_notice(&(wiphy)->dev, format, ##args)
  2793. #define wiphy_info(wiphy, format, args...) \
  2794. dev_info(&(wiphy)->dev, format, ##args)
  2795. #define wiphy_debug(wiphy, format, args...) \
  2796. wiphy_printk(KERN_DEBUG, wiphy, format, ##args)
  2797. #define wiphy_dbg(wiphy, format, args...) \
  2798. dev_dbg(&(wiphy)->dev, format, ##args)
  2799. #if defined(VERBOSE_DEBUG)
  2800. #define wiphy_vdbg wiphy_dbg
  2801. #else
  2802. #define wiphy_vdbg(wiphy, format, args...) \
  2803. ({ \
  2804. if (0) \
  2805. wiphy_printk(KERN_DEBUG, wiphy, format, ##args); \
  2806. 0; \
  2807. })
  2808. #endif
  2809. /*
  2810. * wiphy_WARN() acts like wiphy_printk(), but with the key difference
  2811. * of using a WARN/WARN_ON to get the message out, including the
  2812. * file/line information and a backtrace.
  2813. */
  2814. #define wiphy_WARN(wiphy, format, args...) \
  2815. WARN(1, "wiphy: %s\n" format, wiphy_name(wiphy), ##args);
  2816. #endif /* __NET_CFG80211_H */