cfg80211.h 108 KB

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