cfg80211.h 107 KB

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