cfg80211.h 65 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040
  1. #ifndef __NET_CFG80211_H
  2. #define __NET_CFG80211_H
  3. /*
  4. * 802.11 device and configuration interface
  5. *
  6. * Copyright 2006-2009 Johannes Berg <johannes@sipsolutions.net>
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License version 2 as
  10. * published by the Free Software Foundation.
  11. */
  12. #include <linux/netdevice.h>
  13. #include <linux/debugfs.h>
  14. #include <linux/list.h>
  15. #include <linux/netlink.h>
  16. #include <linux/skbuff.h>
  17. #include <linux/nl80211.h>
  18. #include <linux/if_ether.h>
  19. #include <linux/ieee80211.h>
  20. #include <net/regulatory.h>
  21. /* remove once we remove the wext stuff */
  22. #include <net/iw_handler.h>
  23. #include <linux/wireless.h>
  24. /*
  25. * wireless hardware capability structures
  26. */
  27. /**
  28. * enum ieee80211_band - supported frequency bands
  29. *
  30. * The bands are assigned this way because the supported
  31. * bitrates differ in these bands.
  32. *
  33. * @IEEE80211_BAND_2GHZ: 2.4GHz ISM band
  34. * @IEEE80211_BAND_5GHZ: around 5GHz band (4.9-5.7)
  35. */
  36. enum ieee80211_band {
  37. IEEE80211_BAND_2GHZ,
  38. IEEE80211_BAND_5GHZ,
  39. /* keep last */
  40. IEEE80211_NUM_BANDS
  41. };
  42. /**
  43. * enum ieee80211_channel_flags - channel flags
  44. *
  45. * Channel flags set by the regulatory control code.
  46. *
  47. * @IEEE80211_CHAN_DISABLED: This channel is disabled.
  48. * @IEEE80211_CHAN_PASSIVE_SCAN: Only passive scanning is permitted
  49. * on this channel.
  50. * @IEEE80211_CHAN_NO_IBSS: IBSS is not allowed on this channel.
  51. * @IEEE80211_CHAN_RADAR: Radar detection is required on this channel.
  52. * @IEEE80211_CHAN_NO_HT40PLUS: extension channel above this channel
  53. * is not permitted.
  54. * @IEEE80211_CHAN_NO_HT40MINUS: extension channel below this channel
  55. * is not permitted.
  56. */
  57. enum ieee80211_channel_flags {
  58. IEEE80211_CHAN_DISABLED = 1<<0,
  59. IEEE80211_CHAN_PASSIVE_SCAN = 1<<1,
  60. IEEE80211_CHAN_NO_IBSS = 1<<2,
  61. IEEE80211_CHAN_RADAR = 1<<3,
  62. IEEE80211_CHAN_NO_HT40PLUS = 1<<4,
  63. IEEE80211_CHAN_NO_HT40MINUS = 1<<5,
  64. };
  65. #define IEEE80211_CHAN_NO_HT40 \
  66. (IEEE80211_CHAN_NO_HT40PLUS | IEEE80211_CHAN_NO_HT40MINUS)
  67. /**
  68. * struct ieee80211_channel - channel definition
  69. *
  70. * This structure describes a single channel for use
  71. * with cfg80211.
  72. *
  73. * @center_freq: center frequency in MHz
  74. * @hw_value: hardware-specific value for the channel
  75. * @flags: channel flags from &enum ieee80211_channel_flags.
  76. * @orig_flags: channel flags at registration time, used by regulatory
  77. * code to support devices with additional restrictions
  78. * @band: band this channel belongs to.
  79. * @max_antenna_gain: maximum antenna gain in dBi
  80. * @max_power: maximum transmission power (in dBm)
  81. * @beacon_found: helper to regulatory code to indicate when a beacon
  82. * has been found on this channel. Use regulatory_hint_found_beacon()
  83. * to enable this, this is is useful only on 5 GHz band.
  84. * @orig_mag: internal use
  85. * @orig_mpwr: internal use
  86. */
  87. struct ieee80211_channel {
  88. enum ieee80211_band band;
  89. u16 center_freq;
  90. u16 hw_value;
  91. u32 flags;
  92. int max_antenna_gain;
  93. int max_power;
  94. bool beacon_found;
  95. u32 orig_flags;
  96. int orig_mag, orig_mpwr;
  97. };
  98. /**
  99. * enum ieee80211_rate_flags - rate flags
  100. *
  101. * Hardware/specification flags for rates. These are structured
  102. * in a way that allows using the same bitrate structure for
  103. * different bands/PHY modes.
  104. *
  105. * @IEEE80211_RATE_SHORT_PREAMBLE: Hardware can send with short
  106. * preamble on this bitrate; only relevant in 2.4GHz band and
  107. * with CCK rates.
  108. * @IEEE80211_RATE_MANDATORY_A: This bitrate is a mandatory rate
  109. * when used with 802.11a (on the 5 GHz band); filled by the
  110. * core code when registering the wiphy.
  111. * @IEEE80211_RATE_MANDATORY_B: This bitrate is a mandatory rate
  112. * when used with 802.11b (on the 2.4 GHz band); filled by the
  113. * core code when registering the wiphy.
  114. * @IEEE80211_RATE_MANDATORY_G: This bitrate is a mandatory rate
  115. * when used with 802.11g (on the 2.4 GHz band); filled by the
  116. * core code when registering the wiphy.
  117. * @IEEE80211_RATE_ERP_G: This is an ERP rate in 802.11g mode.
  118. */
  119. enum ieee80211_rate_flags {
  120. IEEE80211_RATE_SHORT_PREAMBLE = 1<<0,
  121. IEEE80211_RATE_MANDATORY_A = 1<<1,
  122. IEEE80211_RATE_MANDATORY_B = 1<<2,
  123. IEEE80211_RATE_MANDATORY_G = 1<<3,
  124. IEEE80211_RATE_ERP_G = 1<<4,
  125. };
  126. /**
  127. * struct ieee80211_rate - bitrate definition
  128. *
  129. * This structure describes a bitrate that an 802.11 PHY can
  130. * operate with. The two values @hw_value and @hw_value_short
  131. * are only for driver use when pointers to this structure are
  132. * passed around.
  133. *
  134. * @flags: rate-specific flags
  135. * @bitrate: bitrate in units of 100 Kbps
  136. * @hw_value: driver/hardware value for this rate
  137. * @hw_value_short: driver/hardware value for this rate when
  138. * short preamble is used
  139. */
  140. struct ieee80211_rate {
  141. u32 flags;
  142. u16 bitrate;
  143. u16 hw_value, hw_value_short;
  144. };
  145. /**
  146. * struct ieee80211_sta_ht_cap - STA's HT capabilities
  147. *
  148. * This structure describes most essential parameters needed
  149. * to describe 802.11n HT capabilities for an STA.
  150. *
  151. * @ht_supported: is HT supported by the STA
  152. * @cap: HT capabilities map as described in 802.11n spec
  153. * @ampdu_factor: Maximum A-MPDU length factor
  154. * @ampdu_density: Minimum A-MPDU spacing
  155. * @mcs: Supported MCS rates
  156. */
  157. struct ieee80211_sta_ht_cap {
  158. u16 cap; /* use IEEE80211_HT_CAP_ */
  159. bool ht_supported;
  160. u8 ampdu_factor;
  161. u8 ampdu_density;
  162. struct ieee80211_mcs_info mcs;
  163. };
  164. /**
  165. * struct ieee80211_supported_band - frequency band definition
  166. *
  167. * This structure describes a frequency band a wiphy
  168. * is able to operate in.
  169. *
  170. * @channels: Array of channels the hardware can operate in
  171. * in this band.
  172. * @band: the band this structure represents
  173. * @n_channels: Number of channels in @channels
  174. * @bitrates: Array of bitrates the hardware can operate with
  175. * in this band. Must be sorted to give a valid "supported
  176. * rates" IE, i.e. CCK rates first, then OFDM.
  177. * @n_bitrates: Number of bitrates in @bitrates
  178. */
  179. struct ieee80211_supported_band {
  180. struct ieee80211_channel *channels;
  181. struct ieee80211_rate *bitrates;
  182. enum ieee80211_band band;
  183. int n_channels;
  184. int n_bitrates;
  185. struct ieee80211_sta_ht_cap ht_cap;
  186. };
  187. /*
  188. * Wireless hardware/device configuration structures and methods
  189. */
  190. /**
  191. * struct vif_params - describes virtual interface parameters
  192. * @mesh_id: mesh ID to use
  193. * @mesh_id_len: length of the mesh ID
  194. * @use_4addr: use 4-address frames
  195. */
  196. struct vif_params {
  197. u8 *mesh_id;
  198. int mesh_id_len;
  199. int use_4addr;
  200. };
  201. /**
  202. * struct key_params - key information
  203. *
  204. * Information about a key
  205. *
  206. * @key: key material
  207. * @key_len: length of key material
  208. * @cipher: cipher suite selector
  209. * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
  210. * with the get_key() callback, must be in little endian,
  211. * length given by @seq_len.
  212. */
  213. struct key_params {
  214. u8 *key;
  215. u8 *seq;
  216. int key_len;
  217. int seq_len;
  218. u32 cipher;
  219. };
  220. /**
  221. * struct beacon_parameters - beacon parameters
  222. *
  223. * Used to configure the beacon for an interface.
  224. *
  225. * @head: head portion of beacon (before TIM IE)
  226. * or %NULL if not changed
  227. * @tail: tail portion of beacon (after TIM IE)
  228. * or %NULL if not changed
  229. * @interval: beacon interval or zero if not changed
  230. * @dtim_period: DTIM period or zero if not changed
  231. * @head_len: length of @head
  232. * @tail_len: length of @tail
  233. */
  234. struct beacon_parameters {
  235. u8 *head, *tail;
  236. int interval, dtim_period;
  237. int head_len, tail_len;
  238. };
  239. /**
  240. * enum plink_action - actions to perform in mesh peers
  241. *
  242. * @PLINK_ACTION_INVALID: action 0 is reserved
  243. * @PLINK_ACTION_OPEN: start mesh peer link establishment
  244. * @PLINK_ACTION_BLOCL: block traffic from this mesh peer
  245. */
  246. enum plink_actions {
  247. PLINK_ACTION_INVALID,
  248. PLINK_ACTION_OPEN,
  249. PLINK_ACTION_BLOCK,
  250. };
  251. /**
  252. * struct station_parameters - station parameters
  253. *
  254. * Used to change and create a new station.
  255. *
  256. * @vlan: vlan interface station should belong to
  257. * @supported_rates: supported rates in IEEE 802.11 format
  258. * (or NULL for no change)
  259. * @supported_rates_len: number of supported rates
  260. * @sta_flags_mask: station flags that changed
  261. * (bitmask of BIT(NL80211_STA_FLAG_...))
  262. * @sta_flags_set: station flags values
  263. * (bitmask of BIT(NL80211_STA_FLAG_...))
  264. * @listen_interval: listen interval or -1 for no change
  265. * @aid: AID or zero for no change
  266. */
  267. struct station_parameters {
  268. u8 *supported_rates;
  269. struct net_device *vlan;
  270. u32 sta_flags_mask, sta_flags_set;
  271. int listen_interval;
  272. u16 aid;
  273. u8 supported_rates_len;
  274. u8 plink_action;
  275. struct ieee80211_ht_cap *ht_capa;
  276. };
  277. /**
  278. * enum station_info_flags - station information flags
  279. *
  280. * Used by the driver to indicate which info in &struct station_info
  281. * it has filled in during get_station() or dump_station().
  282. *
  283. * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
  284. * @STATION_INFO_RX_BYTES: @rx_bytes filled
  285. * @STATION_INFO_TX_BYTES: @tx_bytes filled
  286. * @STATION_INFO_LLID: @llid filled
  287. * @STATION_INFO_PLID: @plid filled
  288. * @STATION_INFO_PLINK_STATE: @plink_state filled
  289. * @STATION_INFO_SIGNAL: @signal filled
  290. * @STATION_INFO_TX_BITRATE: @tx_bitrate fields are filled
  291. * (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
  292. * @STATION_INFO_RX_PACKETS: @rx_packets filled
  293. * @STATION_INFO_TX_PACKETS: @tx_packets filled
  294. */
  295. enum station_info_flags {
  296. STATION_INFO_INACTIVE_TIME = 1<<0,
  297. STATION_INFO_RX_BYTES = 1<<1,
  298. STATION_INFO_TX_BYTES = 1<<2,
  299. STATION_INFO_LLID = 1<<3,
  300. STATION_INFO_PLID = 1<<4,
  301. STATION_INFO_PLINK_STATE = 1<<5,
  302. STATION_INFO_SIGNAL = 1<<6,
  303. STATION_INFO_TX_BITRATE = 1<<7,
  304. STATION_INFO_RX_PACKETS = 1<<8,
  305. STATION_INFO_TX_PACKETS = 1<<9,
  306. };
  307. /**
  308. * enum station_info_rate_flags - bitrate info flags
  309. *
  310. * Used by the driver to indicate the specific rate transmission
  311. * type for 802.11n transmissions.
  312. *
  313. * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
  314. * @RATE_INFO_FLAGS_40_MHZ_WIDTH: 40 Mhz width transmission
  315. * @RATE_INFO_FLAGS_SHORT_GI: 400ns guard interval
  316. */
  317. enum rate_info_flags {
  318. RATE_INFO_FLAGS_MCS = 1<<0,
  319. RATE_INFO_FLAGS_40_MHZ_WIDTH = 1<<1,
  320. RATE_INFO_FLAGS_SHORT_GI = 1<<2,
  321. };
  322. /**
  323. * struct rate_info - bitrate information
  324. *
  325. * Information about a receiving or transmitting bitrate
  326. *
  327. * @flags: bitflag of flags from &enum rate_info_flags
  328. * @mcs: mcs index if struct describes a 802.11n bitrate
  329. * @legacy: bitrate in 100kbit/s for 802.11abg
  330. */
  331. struct rate_info {
  332. u8 flags;
  333. u8 mcs;
  334. u16 legacy;
  335. };
  336. /**
  337. * struct station_info - station information
  338. *
  339. * Station information filled by driver for get_station() and dump_station.
  340. *
  341. * @filled: bitflag of flags from &enum station_info_flags
  342. * @inactive_time: time since last station activity (tx/rx) in milliseconds
  343. * @rx_bytes: bytes received from this station
  344. * @tx_bytes: bytes transmitted to this station
  345. * @llid: mesh local link id
  346. * @plid: mesh peer link id
  347. * @plink_state: mesh peer link state
  348. * @signal: signal strength of last received packet in dBm
  349. * @txrate: current unicast bitrate to this station
  350. * @rx_packets: packets received from this station
  351. * @tx_packets: packets transmitted to this station
  352. * @generation: generation number for nl80211 dumps.
  353. * This number should increase every time the list of stations
  354. * changes, i.e. when a station is added or removed, so that
  355. * userspace can tell whether it got a consistent snapshot.
  356. */
  357. struct station_info {
  358. u32 filled;
  359. u32 inactive_time;
  360. u32 rx_bytes;
  361. u32 tx_bytes;
  362. u16 llid;
  363. u16 plid;
  364. u8 plink_state;
  365. s8 signal;
  366. struct rate_info txrate;
  367. u32 rx_packets;
  368. u32 tx_packets;
  369. int generation;
  370. };
  371. /**
  372. * enum monitor_flags - monitor flags
  373. *
  374. * Monitor interface configuration flags. Note that these must be the bits
  375. * according to the nl80211 flags.
  376. *
  377. * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
  378. * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
  379. * @MONITOR_FLAG_CONTROL: pass control frames
  380. * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
  381. * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
  382. */
  383. enum monitor_flags {
  384. MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
  385. MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
  386. MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
  387. MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
  388. MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
  389. };
  390. /**
  391. * enum mpath_info_flags - mesh path information flags
  392. *
  393. * Used by the driver to indicate which info in &struct mpath_info it has filled
  394. * in during get_station() or dump_station().
  395. *
  396. * MPATH_INFO_FRAME_QLEN: @frame_qlen filled
  397. * MPATH_INFO_SN: @sn filled
  398. * MPATH_INFO_METRIC: @metric filled
  399. * MPATH_INFO_EXPTIME: @exptime filled
  400. * MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
  401. * MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
  402. * MPATH_INFO_FLAGS: @flags filled
  403. */
  404. enum mpath_info_flags {
  405. MPATH_INFO_FRAME_QLEN = BIT(0),
  406. MPATH_INFO_SN = BIT(1),
  407. MPATH_INFO_METRIC = BIT(2),
  408. MPATH_INFO_EXPTIME = BIT(3),
  409. MPATH_INFO_DISCOVERY_TIMEOUT = BIT(4),
  410. MPATH_INFO_DISCOVERY_RETRIES = BIT(5),
  411. MPATH_INFO_FLAGS = BIT(6),
  412. };
  413. /**
  414. * struct mpath_info - mesh path information
  415. *
  416. * Mesh path information filled by driver for get_mpath() and dump_mpath().
  417. *
  418. * @filled: bitfield of flags from &enum mpath_info_flags
  419. * @frame_qlen: number of queued frames for this destination
  420. * @sn: target sequence number
  421. * @metric: metric (cost) of this mesh path
  422. * @exptime: expiration time for the mesh path from now, in msecs
  423. * @flags: mesh path flags
  424. * @discovery_timeout: total mesh path discovery timeout, in msecs
  425. * @discovery_retries: mesh path discovery retries
  426. * @generation: generation number for nl80211 dumps.
  427. * This number should increase every time the list of mesh paths
  428. * changes, i.e. when a station is added or removed, so that
  429. * userspace can tell whether it got a consistent snapshot.
  430. */
  431. struct mpath_info {
  432. u32 filled;
  433. u32 frame_qlen;
  434. u32 sn;
  435. u32 metric;
  436. u32 exptime;
  437. u32 discovery_timeout;
  438. u8 discovery_retries;
  439. u8 flags;
  440. int generation;
  441. };
  442. /**
  443. * struct bss_parameters - BSS parameters
  444. *
  445. * Used to change BSS parameters (mainly for AP mode).
  446. *
  447. * @use_cts_prot: Whether to use CTS protection
  448. * (0 = no, 1 = yes, -1 = do not change)
  449. * @use_short_preamble: Whether the use of short preambles is allowed
  450. * (0 = no, 1 = yes, -1 = do not change)
  451. * @use_short_slot_time: Whether the use of short slot time is allowed
  452. * (0 = no, 1 = yes, -1 = do not change)
  453. * @basic_rates: basic rates in IEEE 802.11 format
  454. * (or NULL for no change)
  455. * @basic_rates_len: number of basic rates
  456. */
  457. struct bss_parameters {
  458. int use_cts_prot;
  459. int use_short_preamble;
  460. int use_short_slot_time;
  461. u8 *basic_rates;
  462. u8 basic_rates_len;
  463. };
  464. struct mesh_config {
  465. /* Timeouts in ms */
  466. /* Mesh plink management parameters */
  467. u16 dot11MeshRetryTimeout;
  468. u16 dot11MeshConfirmTimeout;
  469. u16 dot11MeshHoldingTimeout;
  470. u16 dot11MeshMaxPeerLinks;
  471. u8 dot11MeshMaxRetries;
  472. u8 dot11MeshTTL;
  473. bool auto_open_plinks;
  474. /* HWMP parameters */
  475. u8 dot11MeshHWMPmaxPREQretries;
  476. u32 path_refresh_time;
  477. u16 min_discovery_timeout;
  478. u32 dot11MeshHWMPactivePathTimeout;
  479. u16 dot11MeshHWMPpreqMinInterval;
  480. u16 dot11MeshHWMPnetDiameterTraversalTime;
  481. u8 dot11MeshHWMPRootMode;
  482. };
  483. /**
  484. * struct ieee80211_txq_params - TX queue parameters
  485. * @queue: TX queue identifier (NL80211_TXQ_Q_*)
  486. * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
  487. * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
  488. * 1..32767]
  489. * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
  490. * 1..32767]
  491. * @aifs: Arbitration interframe space [0..255]
  492. */
  493. struct ieee80211_txq_params {
  494. enum nl80211_txq_q queue;
  495. u16 txop;
  496. u16 cwmin;
  497. u16 cwmax;
  498. u8 aifs;
  499. };
  500. /* from net/wireless.h */
  501. struct wiphy;
  502. /* from net/ieee80211.h */
  503. struct ieee80211_channel;
  504. /**
  505. * struct cfg80211_ssid - SSID description
  506. * @ssid: the SSID
  507. * @ssid_len: length of the ssid
  508. */
  509. struct cfg80211_ssid {
  510. u8 ssid[IEEE80211_MAX_SSID_LEN];
  511. u8 ssid_len;
  512. };
  513. /**
  514. * struct cfg80211_scan_request - scan request description
  515. *
  516. * @ssids: SSIDs to scan for (active scan only)
  517. * @n_ssids: number of SSIDs
  518. * @channels: channels to scan on.
  519. * @n_channels: total number of channels to scan
  520. * @ie: optional information element(s) to add into Probe Request or %NULL
  521. * @ie_len: length of ie in octets
  522. * @wiphy: the wiphy this was for
  523. * @dev: the interface
  524. */
  525. struct cfg80211_scan_request {
  526. struct cfg80211_ssid *ssids;
  527. int n_ssids;
  528. u32 n_channels;
  529. const u8 *ie;
  530. size_t ie_len;
  531. /* internal */
  532. struct wiphy *wiphy;
  533. struct net_device *dev;
  534. bool aborted;
  535. /* keep last */
  536. struct ieee80211_channel *channels[0];
  537. };
  538. /**
  539. * enum cfg80211_signal_type - signal type
  540. *
  541. * @CFG80211_SIGNAL_TYPE_NONE: no signal strength information available
  542. * @CFG80211_SIGNAL_TYPE_MBM: signal strength in mBm (100*dBm)
  543. * @CFG80211_SIGNAL_TYPE_UNSPEC: signal strength, increasing from 0 through 100
  544. */
  545. enum cfg80211_signal_type {
  546. CFG80211_SIGNAL_TYPE_NONE,
  547. CFG80211_SIGNAL_TYPE_MBM,
  548. CFG80211_SIGNAL_TYPE_UNSPEC,
  549. };
  550. /**
  551. * struct cfg80211_bss - BSS description
  552. *
  553. * This structure describes a BSS (which may also be a mesh network)
  554. * for use in scan results and similar.
  555. *
  556. * @bssid: BSSID of the BSS
  557. * @tsf: timestamp of last received update
  558. * @beacon_interval: the beacon interval as from the frame
  559. * @capability: the capability field in host byte order
  560. * @information_elements: the information elements (Note that there
  561. * is no guarantee that these are well-formed!)
  562. * @len_information_elements: total length of the information elements
  563. * @signal: signal strength value (type depends on the wiphy's signal_type)
  564. * @free_priv: function pointer to free private data
  565. * @priv: private area for driver use, has at least wiphy->bss_priv_size bytes
  566. */
  567. struct cfg80211_bss {
  568. struct ieee80211_channel *channel;
  569. u8 bssid[ETH_ALEN];
  570. u64 tsf;
  571. u16 beacon_interval;
  572. u16 capability;
  573. u8 *information_elements;
  574. size_t len_information_elements;
  575. s32 signal;
  576. void (*free_priv)(struct cfg80211_bss *bss);
  577. u8 priv[0] __attribute__((__aligned__(sizeof(void *))));
  578. };
  579. /**
  580. * ieee80211_bss_get_ie - find IE with given ID
  581. * @bss: the bss to search
  582. * @ie: the IE ID
  583. * Returns %NULL if not found.
  584. */
  585. const u8 *ieee80211_bss_get_ie(struct cfg80211_bss *bss, u8 ie);
  586. /**
  587. * struct cfg80211_crypto_settings - Crypto settings
  588. * @wpa_versions: indicates which, if any, WPA versions are enabled
  589. * (from enum nl80211_wpa_versions)
  590. * @cipher_group: group key cipher suite (or 0 if unset)
  591. * @n_ciphers_pairwise: number of AP supported unicast ciphers
  592. * @ciphers_pairwise: unicast key cipher suites
  593. * @n_akm_suites: number of AKM suites
  594. * @akm_suites: AKM suites
  595. * @control_port: Whether user space controls IEEE 802.1X port, i.e.,
  596. * sets/clears %NL80211_STA_FLAG_AUTHORIZED. If true, the driver is
  597. * required to assume that the port is unauthorized until authorized by
  598. * user space. Otherwise, port is marked authorized by default.
  599. */
  600. struct cfg80211_crypto_settings {
  601. u32 wpa_versions;
  602. u32 cipher_group;
  603. int n_ciphers_pairwise;
  604. u32 ciphers_pairwise[NL80211_MAX_NR_CIPHER_SUITES];
  605. int n_akm_suites;
  606. u32 akm_suites[NL80211_MAX_NR_AKM_SUITES];
  607. bool control_port;
  608. };
  609. /**
  610. * struct cfg80211_auth_request - Authentication request data
  611. *
  612. * This structure provides information needed to complete IEEE 802.11
  613. * authentication.
  614. *
  615. * @bss: The BSS to authenticate with.
  616. * @auth_type: Authentication type (algorithm)
  617. * @ie: Extra IEs to add to Authentication frame or %NULL
  618. * @ie_len: Length of ie buffer in octets
  619. * @key_len: length of WEP key for shared key authentication
  620. * @key_idx: index of WEP key for shared key authentication
  621. * @key: WEP key for shared key authentication
  622. */
  623. struct cfg80211_auth_request {
  624. struct cfg80211_bss *bss;
  625. const u8 *ie;
  626. size_t ie_len;
  627. enum nl80211_auth_type auth_type;
  628. const u8 *key;
  629. u8 key_len, key_idx;
  630. };
  631. /**
  632. * struct cfg80211_assoc_request - (Re)Association request data
  633. *
  634. * This structure provides information needed to complete IEEE 802.11
  635. * (re)association.
  636. * @bss: The BSS to associate with.
  637. * @ie: Extra IEs to add to (Re)Association Request frame or %NULL
  638. * @ie_len: Length of ie buffer in octets
  639. * @use_mfp: Use management frame protection (IEEE 802.11w) in this association
  640. * @crypto: crypto settings
  641. * @prev_bssid: previous BSSID, if not %NULL use reassociate frame
  642. */
  643. struct cfg80211_assoc_request {
  644. struct cfg80211_bss *bss;
  645. const u8 *ie, *prev_bssid;
  646. size_t ie_len;
  647. struct cfg80211_crypto_settings crypto;
  648. bool use_mfp;
  649. };
  650. /**
  651. * struct cfg80211_deauth_request - Deauthentication request data
  652. *
  653. * This structure provides information needed to complete IEEE 802.11
  654. * deauthentication.
  655. *
  656. * @bss: the BSS to deauthenticate from
  657. * @ie: Extra IEs to add to Deauthentication frame or %NULL
  658. * @ie_len: Length of ie buffer in octets
  659. * @reason_code: The reason code for the deauthentication
  660. */
  661. struct cfg80211_deauth_request {
  662. struct cfg80211_bss *bss;
  663. const u8 *ie;
  664. size_t ie_len;
  665. u16 reason_code;
  666. };
  667. /**
  668. * struct cfg80211_disassoc_request - Disassociation request data
  669. *
  670. * This structure provides information needed to complete IEEE 802.11
  671. * disassocation.
  672. *
  673. * @bss: the BSS to disassociate from
  674. * @ie: Extra IEs to add to Disassociation frame or %NULL
  675. * @ie_len: Length of ie buffer in octets
  676. * @reason_code: The reason code for the disassociation
  677. */
  678. struct cfg80211_disassoc_request {
  679. struct cfg80211_bss *bss;
  680. const u8 *ie;
  681. size_t ie_len;
  682. u16 reason_code;
  683. };
  684. /**
  685. * struct cfg80211_ibss_params - IBSS parameters
  686. *
  687. * This structure defines the IBSS parameters for the join_ibss()
  688. * method.
  689. *
  690. * @ssid: The SSID, will always be non-null.
  691. * @ssid_len: The length of the SSID, will always be non-zero.
  692. * @bssid: Fixed BSSID requested, maybe be %NULL, if set do not
  693. * search for IBSSs with a different BSSID.
  694. * @channel: The channel to use if no IBSS can be found to join.
  695. * @channel_fixed: The channel should be fixed -- do not search for
  696. * IBSSs to join on other channels.
  697. * @ie: information element(s) to include in the beacon
  698. * @ie_len: length of that
  699. * @beacon_interval: beacon interval to use
  700. * @privacy: this is a protected network, keys will be configured
  701. * after joining
  702. */
  703. struct cfg80211_ibss_params {
  704. u8 *ssid;
  705. u8 *bssid;
  706. struct ieee80211_channel *channel;
  707. u8 *ie;
  708. u8 ssid_len, ie_len;
  709. u16 beacon_interval;
  710. bool channel_fixed;
  711. bool privacy;
  712. };
  713. /**
  714. * struct cfg80211_connect_params - Connection parameters
  715. *
  716. * This structure provides information needed to complete IEEE 802.11
  717. * authentication and association.
  718. *
  719. * @channel: The channel to use or %NULL if not specified (auto-select based
  720. * on scan results)
  721. * @bssid: The AP BSSID or %NULL if not specified (auto-select based on scan
  722. * results)
  723. * @ssid: SSID
  724. * @ssid_len: Length of ssid in octets
  725. * @auth_type: Authentication type (algorithm)
  726. * @assoc_ie: IEs for association request
  727. * @assoc_ie_len: Length of assoc_ie in octets
  728. * @privacy: indicates whether privacy-enabled APs should be used
  729. * @crypto: crypto settings
  730. * @key_len: length of WEP key for shared key authentication
  731. * @key_idx: index of WEP key for shared key authentication
  732. * @key: WEP key for shared key authentication
  733. */
  734. struct cfg80211_connect_params {
  735. struct ieee80211_channel *channel;
  736. u8 *bssid;
  737. u8 *ssid;
  738. size_t ssid_len;
  739. enum nl80211_auth_type auth_type;
  740. u8 *ie;
  741. size_t ie_len;
  742. bool privacy;
  743. struct cfg80211_crypto_settings crypto;
  744. const u8 *key;
  745. u8 key_len, key_idx;
  746. };
  747. /**
  748. * enum wiphy_params_flags - set_wiphy_params bitfield values
  749. * WIPHY_PARAM_RETRY_SHORT: wiphy->retry_short has changed
  750. * WIPHY_PARAM_RETRY_LONG: wiphy->retry_long has changed
  751. * WIPHY_PARAM_FRAG_THRESHOLD: wiphy->frag_threshold has changed
  752. * WIPHY_PARAM_RTS_THRESHOLD: wiphy->rts_threshold has changed
  753. */
  754. enum wiphy_params_flags {
  755. WIPHY_PARAM_RETRY_SHORT = 1 << 0,
  756. WIPHY_PARAM_RETRY_LONG = 1 << 1,
  757. WIPHY_PARAM_FRAG_THRESHOLD = 1 << 2,
  758. WIPHY_PARAM_RTS_THRESHOLD = 1 << 3,
  759. };
  760. /**
  761. * enum tx_power_setting - TX power adjustment
  762. *
  763. * @TX_POWER_AUTOMATIC: the dbm parameter is ignored
  764. * @TX_POWER_LIMITED: limit TX power by the dbm parameter
  765. * @TX_POWER_FIXED: fix TX power to the dbm parameter
  766. */
  767. enum tx_power_setting {
  768. TX_POWER_AUTOMATIC,
  769. TX_POWER_LIMITED,
  770. TX_POWER_FIXED,
  771. };
  772. /*
  773. * cfg80211_bitrate_mask - masks for bitrate control
  774. */
  775. struct cfg80211_bitrate_mask {
  776. /*
  777. * As discussed in Berlin, this struct really
  778. * should look like this:
  779. struct {
  780. u32 legacy;
  781. u8 mcs[IEEE80211_HT_MCS_MASK_LEN];
  782. } control[IEEE80211_NUM_BANDS];
  783. * Since we can always fix in-kernel users, let's keep
  784. * it simpler for now:
  785. */
  786. u32 fixed; /* fixed bitrate, 0 == not fixed */
  787. u32 maxrate; /* in kbps, 0 == no limit */
  788. };
  789. /**
  790. * struct cfg80211_ops - backend description for wireless configuration
  791. *
  792. * This struct is registered by fullmac card drivers and/or wireless stacks
  793. * in order to handle configuration requests on their interfaces.
  794. *
  795. * All callbacks except where otherwise noted should return 0
  796. * on success or a negative error code.
  797. *
  798. * All operations are currently invoked under rtnl for consistency with the
  799. * wireless extensions but this is subject to reevaluation as soon as this
  800. * code is used more widely and we have a first user without wext.
  801. *
  802. * @suspend: wiphy device needs to be suspended
  803. * @resume: wiphy device needs to be resumed
  804. *
  805. * @add_virtual_intf: create a new virtual interface with the given name,
  806. * must set the struct wireless_dev's iftype. Beware: You must create
  807. * the new netdev in the wiphy's network namespace!
  808. *
  809. * @del_virtual_intf: remove the virtual interface determined by ifindex.
  810. *
  811. * @change_virtual_intf: change type/configuration of virtual interface,
  812. * keep the struct wireless_dev's iftype updated.
  813. *
  814. * @add_key: add a key with the given parameters. @mac_addr will be %NULL
  815. * when adding a group key.
  816. *
  817. * @get_key: get information about the key with the given parameters.
  818. * @mac_addr will be %NULL when requesting information for a group
  819. * key. All pointers given to the @callback function need not be valid
  820. * after it returns. This function should return an error if it is
  821. * not possible to retrieve the key, -ENOENT if it doesn't exist.
  822. *
  823. * @del_key: remove a key given the @mac_addr (%NULL for a group key)
  824. * and @key_index, return -ENOENT if the key doesn't exist.
  825. *
  826. * @set_default_key: set the default key on an interface
  827. *
  828. * @set_default_mgmt_key: set the default management frame key on an interface
  829. *
  830. * @add_beacon: Add a beacon with given parameters, @head, @interval
  831. * and @dtim_period will be valid, @tail is optional.
  832. * @set_beacon: Change the beacon parameters for an access point mode
  833. * interface. This should reject the call when no beacon has been
  834. * configured.
  835. * @del_beacon: Remove beacon configuration and stop sending the beacon.
  836. *
  837. * @add_station: Add a new station.
  838. *
  839. * @del_station: Remove a station; @mac may be NULL to remove all stations.
  840. *
  841. * @change_station: Modify a given station.
  842. *
  843. * @get_mesh_params: Put the current mesh parameters into *params
  844. *
  845. * @set_mesh_params: Set mesh parameters.
  846. * The mask is a bitfield which tells us which parameters to
  847. * set, and which to leave alone.
  848. *
  849. * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
  850. *
  851. * @change_bss: Modify parameters for a given BSS.
  852. *
  853. * @set_txq_params: Set TX queue parameters
  854. *
  855. * @set_channel: Set channel
  856. *
  857. * @scan: Request to do a scan. If returning zero, the scan request is given
  858. * the driver, and will be valid until passed to cfg80211_scan_done().
  859. * For scan results, call cfg80211_inform_bss(); you can call this outside
  860. * the scan/scan_done bracket too.
  861. *
  862. * @auth: Request to authenticate with the specified peer
  863. * @assoc: Request to (re)associate with the specified peer
  864. * @deauth: Request to deauthenticate from the specified peer
  865. * @disassoc: Request to disassociate from the specified peer
  866. *
  867. * @connect: Connect to the ESS with the specified parameters. When connected,
  868. * call cfg80211_connect_result() with status code %WLAN_STATUS_SUCCESS.
  869. * If the connection fails for some reason, call cfg80211_connect_result()
  870. * with the status from the AP.
  871. * @disconnect: Disconnect from the BSS/ESS.
  872. *
  873. * @join_ibss: Join the specified IBSS (or create if necessary). Once done, call
  874. * cfg80211_ibss_joined(), also call that function when changing BSSID due
  875. * to a merge.
  876. * @leave_ibss: Leave the IBSS.
  877. *
  878. * @set_wiphy_params: Notify that wiphy parameters have changed;
  879. * @changed bitfield (see &enum wiphy_params_flags) describes which values
  880. * have changed. The actual parameter values are available in
  881. * struct wiphy. If returning an error, no value should be changed.
  882. *
  883. * @set_tx_power: set the transmit power according to the parameters
  884. * @get_tx_power: store the current TX power into the dbm variable;
  885. * return 0 if successful
  886. *
  887. * @rfkill_poll: polls the hw rfkill line, use cfg80211 reporting
  888. * functions to adjust rfkill hw state
  889. *
  890. * @testmode_cmd: run a test mode command
  891. */
  892. struct cfg80211_ops {
  893. int (*suspend)(struct wiphy *wiphy);
  894. int (*resume)(struct wiphy *wiphy);
  895. int (*add_virtual_intf)(struct wiphy *wiphy, char *name,
  896. enum nl80211_iftype type, u32 *flags,
  897. struct vif_params *params);
  898. int (*del_virtual_intf)(struct wiphy *wiphy, struct net_device *dev);
  899. int (*change_virtual_intf)(struct wiphy *wiphy,
  900. struct net_device *dev,
  901. enum nl80211_iftype type, u32 *flags,
  902. struct vif_params *params);
  903. int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
  904. u8 key_index, const u8 *mac_addr,
  905. struct key_params *params);
  906. int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
  907. u8 key_index, const u8 *mac_addr, void *cookie,
  908. void (*callback)(void *cookie, struct key_params*));
  909. int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
  910. u8 key_index, const u8 *mac_addr);
  911. int (*set_default_key)(struct wiphy *wiphy,
  912. struct net_device *netdev,
  913. u8 key_index);
  914. int (*set_default_mgmt_key)(struct wiphy *wiphy,
  915. struct net_device *netdev,
  916. u8 key_index);
  917. int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
  918. struct beacon_parameters *info);
  919. int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
  920. struct beacon_parameters *info);
  921. int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
  922. int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
  923. u8 *mac, struct station_parameters *params);
  924. int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
  925. u8 *mac);
  926. int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
  927. u8 *mac, struct station_parameters *params);
  928. int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
  929. u8 *mac, struct station_info *sinfo);
  930. int (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
  931. int idx, u8 *mac, struct station_info *sinfo);
  932. int (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
  933. u8 *dst, u8 *next_hop);
  934. int (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
  935. u8 *dst);
  936. int (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
  937. u8 *dst, u8 *next_hop);
  938. int (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
  939. u8 *dst, u8 *next_hop,
  940. struct mpath_info *pinfo);
  941. int (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
  942. int idx, u8 *dst, u8 *next_hop,
  943. struct mpath_info *pinfo);
  944. int (*get_mesh_params)(struct wiphy *wiphy,
  945. struct net_device *dev,
  946. struct mesh_config *conf);
  947. int (*set_mesh_params)(struct wiphy *wiphy,
  948. struct net_device *dev,
  949. const struct mesh_config *nconf, u32 mask);
  950. int (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
  951. struct bss_parameters *params);
  952. int (*set_txq_params)(struct wiphy *wiphy,
  953. struct ieee80211_txq_params *params);
  954. int (*set_channel)(struct wiphy *wiphy,
  955. struct ieee80211_channel *chan,
  956. enum nl80211_channel_type channel_type);
  957. int (*scan)(struct wiphy *wiphy, struct net_device *dev,
  958. struct cfg80211_scan_request *request);
  959. int (*auth)(struct wiphy *wiphy, struct net_device *dev,
  960. struct cfg80211_auth_request *req);
  961. int (*assoc)(struct wiphy *wiphy, struct net_device *dev,
  962. struct cfg80211_assoc_request *req);
  963. int (*deauth)(struct wiphy *wiphy, struct net_device *dev,
  964. struct cfg80211_deauth_request *req,
  965. void *cookie);
  966. int (*disassoc)(struct wiphy *wiphy, struct net_device *dev,
  967. struct cfg80211_disassoc_request *req,
  968. void *cookie);
  969. int (*connect)(struct wiphy *wiphy, struct net_device *dev,
  970. struct cfg80211_connect_params *sme);
  971. int (*disconnect)(struct wiphy *wiphy, struct net_device *dev,
  972. u16 reason_code);
  973. int (*join_ibss)(struct wiphy *wiphy, struct net_device *dev,
  974. struct cfg80211_ibss_params *params);
  975. int (*leave_ibss)(struct wiphy *wiphy, struct net_device *dev);
  976. int (*set_wiphy_params)(struct wiphy *wiphy, u32 changed);
  977. int (*set_tx_power)(struct wiphy *wiphy,
  978. enum tx_power_setting type, int dbm);
  979. int (*get_tx_power)(struct wiphy *wiphy, int *dbm);
  980. int (*set_wds_peer)(struct wiphy *wiphy, struct net_device *dev,
  981. u8 *addr);
  982. void (*rfkill_poll)(struct wiphy *wiphy);
  983. #ifdef CONFIG_NL80211_TESTMODE
  984. int (*testmode_cmd)(struct wiphy *wiphy, void *data, int len);
  985. #endif
  986. int (*set_bitrate_mask)(struct wiphy *wiphy,
  987. struct net_device *dev,
  988. const u8 *peer,
  989. const struct cfg80211_bitrate_mask *mask);
  990. /* some temporary stuff to finish wext */
  991. int (*set_power_mgmt)(struct wiphy *wiphy, struct net_device *dev,
  992. bool enabled, int timeout);
  993. };
  994. /*
  995. * wireless hardware and networking interfaces structures
  996. * and registration/helper functions
  997. */
  998. /**
  999. * struct wiphy - wireless hardware description
  1000. * @idx: the wiphy index assigned to this item
  1001. * @class_dev: the class device representing /sys/class/ieee80211/<wiphy-name>
  1002. * @custom_regulatory: tells us the driver for this device
  1003. * has its own custom regulatory domain and cannot identify the
  1004. * ISO / IEC 3166 alpha2 it belongs to. When this is enabled
  1005. * we will disregard the first regulatory hint (when the
  1006. * initiator is %REGDOM_SET_BY_CORE).
  1007. * @strict_regulatory: tells us the driver for this device will ignore
  1008. * regulatory domain settings until it gets its own regulatory domain
  1009. * via its regulatory_hint(). After its gets its own regulatory domain
  1010. * it will only allow further regulatory domain settings to further
  1011. * enhance compliance. For example if channel 13 and 14 are disabled
  1012. * by this regulatory domain no user regulatory domain can enable these
  1013. * channels at a later time. This can be used for devices which do not
  1014. * have calibration information gauranteed for frequencies or settings
  1015. * outside of its regulatory domain.
  1016. * @disable_beacon_hints: enable this if your driver needs to ensure that
  1017. * passive scan flags and beaconing flags may not be lifted by cfg80211
  1018. * due to regulatory beacon hints. For more information on beacon
  1019. * hints read the documenation for regulatory_hint_found_beacon()
  1020. * @reg_notifier: the driver's regulatory notification callback
  1021. * @regd: the driver's regulatory domain, if one was requested via
  1022. * the regulatory_hint() API. This can be used by the driver
  1023. * on the reg_notifier() if it chooses to ignore future
  1024. * regulatory domain changes caused by other drivers.
  1025. * @signal_type: signal type reported in &struct cfg80211_bss.
  1026. * @cipher_suites: supported cipher suites
  1027. * @n_cipher_suites: number of supported cipher suites
  1028. * @retry_short: Retry limit for short frames (dot11ShortRetryLimit)
  1029. * @retry_long: Retry limit for long frames (dot11LongRetryLimit)
  1030. * @frag_threshold: Fragmentation threshold (dot11FragmentationThreshold);
  1031. * -1 = fragmentation disabled, only odd values >= 256 used
  1032. * @rts_threshold: RTS threshold (dot11RTSThreshold); -1 = RTS/CTS disabled
  1033. * @net: the network namespace this wiphy currently lives in
  1034. * @netnsok: if set to false, do not allow changing the netns of this
  1035. * wiphy at all
  1036. * @ps_default: default for powersave, will be set depending on the
  1037. * kernel's default on wiphy_new(), but can be changed by the
  1038. * driver if it has a good reason to override the default
  1039. */
  1040. struct wiphy {
  1041. /* assign these fields before you register the wiphy */
  1042. /* permanent MAC address */
  1043. u8 perm_addr[ETH_ALEN];
  1044. /* Supported interface modes, OR together BIT(NL80211_IFTYPE_...) */
  1045. u16 interface_modes;
  1046. bool custom_regulatory;
  1047. bool strict_regulatory;
  1048. bool disable_beacon_hints;
  1049. bool netnsok;
  1050. bool ps_default;
  1051. enum cfg80211_signal_type signal_type;
  1052. int bss_priv_size;
  1053. u8 max_scan_ssids;
  1054. u16 max_scan_ie_len;
  1055. int n_cipher_suites;
  1056. const u32 *cipher_suites;
  1057. u8 retry_short;
  1058. u8 retry_long;
  1059. u32 frag_threshold;
  1060. u32 rts_threshold;
  1061. char fw_version[ETHTOOL_BUSINFO_LEN];
  1062. u32 hw_version;
  1063. /* If multiple wiphys are registered and you're handed e.g.
  1064. * a regular netdev with assigned ieee80211_ptr, you won't
  1065. * know whether it points to a wiphy your driver has registered
  1066. * or not. Assign this to something global to your driver to
  1067. * help determine whether you own this wiphy or not. */
  1068. const void *privid;
  1069. struct ieee80211_supported_band *bands[IEEE80211_NUM_BANDS];
  1070. /* Lets us get back the wiphy on the callback */
  1071. int (*reg_notifier)(struct wiphy *wiphy,
  1072. struct regulatory_request *request);
  1073. /* fields below are read-only, assigned by cfg80211 */
  1074. const struct ieee80211_regdomain *regd;
  1075. /* the item in /sys/class/ieee80211/ points to this,
  1076. * you need use set_wiphy_dev() (see below) */
  1077. struct device dev;
  1078. /* dir in debugfs: ieee80211/<wiphyname> */
  1079. struct dentry *debugfsdir;
  1080. #ifdef CONFIG_NET_NS
  1081. /* the network namespace this phy lives in currently */
  1082. struct net *_net;
  1083. #endif
  1084. #ifdef CONFIG_CFG80211_WEXT
  1085. const struct iw_handler_def *wext;
  1086. #endif
  1087. char priv[0] __attribute__((__aligned__(NETDEV_ALIGN)));
  1088. };
  1089. #ifdef CONFIG_NET_NS
  1090. static inline struct net *wiphy_net(struct wiphy *wiphy)
  1091. {
  1092. return wiphy->_net;
  1093. }
  1094. static inline void wiphy_net_set(struct wiphy *wiphy, struct net *net)
  1095. {
  1096. wiphy->_net = net;
  1097. }
  1098. #else
  1099. static inline struct net *wiphy_net(struct wiphy *wiphy)
  1100. {
  1101. return &init_net;
  1102. }
  1103. static inline void wiphy_net_set(struct wiphy *wiphy, struct net *net)
  1104. {
  1105. }
  1106. #endif
  1107. /**
  1108. * wiphy_priv - return priv from wiphy
  1109. *
  1110. * @wiphy: the wiphy whose priv pointer to return
  1111. */
  1112. static inline void *wiphy_priv(struct wiphy *wiphy)
  1113. {
  1114. BUG_ON(!wiphy);
  1115. return &wiphy->priv;
  1116. }
  1117. /**
  1118. * priv_to_wiphy - return the wiphy containing the priv
  1119. *
  1120. * @priv: a pointer previously returned by wiphy_priv
  1121. */
  1122. static inline struct wiphy *priv_to_wiphy(void *priv)
  1123. {
  1124. BUG_ON(!priv);
  1125. return container_of(priv, struct wiphy, priv);
  1126. }
  1127. /**
  1128. * set_wiphy_dev - set device pointer for wiphy
  1129. *
  1130. * @wiphy: The wiphy whose device to bind
  1131. * @dev: The device to parent it to
  1132. */
  1133. static inline void set_wiphy_dev(struct wiphy *wiphy, struct device *dev)
  1134. {
  1135. wiphy->dev.parent = dev;
  1136. }
  1137. /**
  1138. * wiphy_dev - get wiphy dev pointer
  1139. *
  1140. * @wiphy: The wiphy whose device struct to look up
  1141. */
  1142. static inline struct device *wiphy_dev(struct wiphy *wiphy)
  1143. {
  1144. return wiphy->dev.parent;
  1145. }
  1146. /**
  1147. * wiphy_name - get wiphy name
  1148. *
  1149. * @wiphy: The wiphy whose name to return
  1150. */
  1151. static inline const char *wiphy_name(struct wiphy *wiphy)
  1152. {
  1153. return dev_name(&wiphy->dev);
  1154. }
  1155. /**
  1156. * wiphy_new - create a new wiphy for use with cfg80211
  1157. *
  1158. * @ops: The configuration operations for this device
  1159. * @sizeof_priv: The size of the private area to allocate
  1160. *
  1161. * Create a new wiphy and associate the given operations with it.
  1162. * @sizeof_priv bytes are allocated for private use.
  1163. *
  1164. * The returned pointer must be assigned to each netdev's
  1165. * ieee80211_ptr for proper operation.
  1166. */
  1167. struct wiphy *wiphy_new(const struct cfg80211_ops *ops, int sizeof_priv);
  1168. /**
  1169. * wiphy_register - register a wiphy with cfg80211
  1170. *
  1171. * @wiphy: The wiphy to register.
  1172. *
  1173. * Returns a non-negative wiphy index or a negative error code.
  1174. */
  1175. extern int wiphy_register(struct wiphy *wiphy);
  1176. /**
  1177. * wiphy_unregister - deregister a wiphy from cfg80211
  1178. *
  1179. * @wiphy: The wiphy to unregister.
  1180. *
  1181. * After this call, no more requests can be made with this priv
  1182. * pointer, but the call may sleep to wait for an outstanding
  1183. * request that is being handled.
  1184. */
  1185. extern void wiphy_unregister(struct wiphy *wiphy);
  1186. /**
  1187. * wiphy_free - free wiphy
  1188. *
  1189. * @wiphy: The wiphy to free
  1190. */
  1191. extern void wiphy_free(struct wiphy *wiphy);
  1192. /* internal structs */
  1193. struct cfg80211_conn;
  1194. struct cfg80211_internal_bss;
  1195. struct cfg80211_cached_keys;
  1196. #define MAX_AUTH_BSSES 4
  1197. /**
  1198. * struct wireless_dev - wireless per-netdev state
  1199. *
  1200. * This structure must be allocated by the driver/stack
  1201. * that uses the ieee80211_ptr field in struct net_device
  1202. * (this is intentional so it can be allocated along with
  1203. * the netdev.)
  1204. *
  1205. * @wiphy: pointer to hardware description
  1206. * @iftype: interface type
  1207. * @list: (private) Used to collect the interfaces
  1208. * @netdev: (private) Used to reference back to the netdev
  1209. * @current_bss: (private) Used by the internal configuration code
  1210. * @bssid: (private) Used by the internal configuration code
  1211. * @ssid: (private) Used by the internal configuration code
  1212. * @ssid_len: (private) Used by the internal configuration code
  1213. * @wext: (private) Used by the internal wireless extensions compat code
  1214. * @wext_bssid: (private) Used by the internal wireless extensions compat code
  1215. */
  1216. struct wireless_dev {
  1217. struct wiphy *wiphy;
  1218. enum nl80211_iftype iftype;
  1219. /* the remainder of this struct should be private to cfg80211 */
  1220. struct list_head list;
  1221. struct net_device *netdev;
  1222. struct mutex mtx;
  1223. struct work_struct cleanup_work;
  1224. /* currently used for IBSS and SME - might be rearranged later */
  1225. u8 ssid[IEEE80211_MAX_SSID_LEN];
  1226. u8 ssid_len;
  1227. enum {
  1228. CFG80211_SME_IDLE,
  1229. CFG80211_SME_CONNECTING,
  1230. CFG80211_SME_CONNECTED,
  1231. } sme_state;
  1232. struct cfg80211_conn *conn;
  1233. struct cfg80211_cached_keys *connect_keys;
  1234. struct list_head event_list;
  1235. spinlock_t event_lock;
  1236. struct cfg80211_internal_bss *authtry_bsses[MAX_AUTH_BSSES];
  1237. struct cfg80211_internal_bss *auth_bsses[MAX_AUTH_BSSES];
  1238. struct cfg80211_internal_bss *current_bss; /* associated / joined */
  1239. #ifdef CONFIG_CFG80211_WEXT
  1240. /* wext data */
  1241. struct {
  1242. struct cfg80211_ibss_params ibss;
  1243. struct cfg80211_connect_params connect;
  1244. struct cfg80211_cached_keys *keys;
  1245. u8 *ie;
  1246. size_t ie_len;
  1247. u8 bssid[ETH_ALEN], prev_bssid[ETH_ALEN];
  1248. u8 ssid[IEEE80211_MAX_SSID_LEN];
  1249. s8 default_key, default_mgmt_key;
  1250. bool ps, prev_bssid_valid;
  1251. int ps_timeout;
  1252. } wext;
  1253. #endif
  1254. };
  1255. /**
  1256. * wdev_priv - return wiphy priv from wireless_dev
  1257. *
  1258. * @wdev: The wireless device whose wiphy's priv pointer to return
  1259. */
  1260. static inline void *wdev_priv(struct wireless_dev *wdev)
  1261. {
  1262. BUG_ON(!wdev);
  1263. return wiphy_priv(wdev->wiphy);
  1264. }
  1265. /*
  1266. * Utility functions
  1267. */
  1268. /**
  1269. * ieee80211_channel_to_frequency - convert channel number to frequency
  1270. */
  1271. extern int ieee80211_channel_to_frequency(int chan);
  1272. /**
  1273. * ieee80211_frequency_to_channel - convert frequency to channel number
  1274. */
  1275. extern int ieee80211_frequency_to_channel(int freq);
  1276. /*
  1277. * Name indirection necessary because the ieee80211 code also has
  1278. * a function named "ieee80211_get_channel", so if you include
  1279. * cfg80211's header file you get cfg80211's version, if you try
  1280. * to include both header files you'll (rightfully!) get a symbol
  1281. * clash.
  1282. */
  1283. extern struct ieee80211_channel *__ieee80211_get_channel(struct wiphy *wiphy,
  1284. int freq);
  1285. /**
  1286. * ieee80211_get_channel - get channel struct from wiphy for specified frequency
  1287. */
  1288. static inline struct ieee80211_channel *
  1289. ieee80211_get_channel(struct wiphy *wiphy, int freq)
  1290. {
  1291. return __ieee80211_get_channel(wiphy, freq);
  1292. }
  1293. /**
  1294. * ieee80211_get_response_rate - get basic rate for a given rate
  1295. *
  1296. * @sband: the band to look for rates in
  1297. * @basic_rates: bitmap of basic rates
  1298. * @bitrate: the bitrate for which to find the basic rate
  1299. *
  1300. * This function returns the basic rate corresponding to a given
  1301. * bitrate, that is the next lower bitrate contained in the basic
  1302. * rate map, which is, for this function, given as a bitmap of
  1303. * indices of rates in the band's bitrate table.
  1304. */
  1305. struct ieee80211_rate *
  1306. ieee80211_get_response_rate(struct ieee80211_supported_band *sband,
  1307. u32 basic_rates, int bitrate);
  1308. /*
  1309. * Radiotap parsing functions -- for controlled injection support
  1310. *
  1311. * Implemented in net/wireless/radiotap.c
  1312. * Documentation in Documentation/networking/radiotap-headers.txt
  1313. */
  1314. /**
  1315. * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
  1316. * @rtheader: pointer to the radiotap header we are walking through
  1317. * @max_length: length of radiotap header in cpu byte ordering
  1318. * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
  1319. * @this_arg: pointer to current radiotap arg
  1320. * @arg_index: internal next argument index
  1321. * @arg: internal next argument pointer
  1322. * @next_bitmap: internal pointer to next present u32
  1323. * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
  1324. */
  1325. struct ieee80211_radiotap_iterator {
  1326. struct ieee80211_radiotap_header *rtheader;
  1327. int max_length;
  1328. int this_arg_index;
  1329. u8 *this_arg;
  1330. int arg_index;
  1331. u8 *arg;
  1332. __le32 *next_bitmap;
  1333. u32 bitmap_shifter;
  1334. };
  1335. extern int ieee80211_radiotap_iterator_init(
  1336. struct ieee80211_radiotap_iterator *iterator,
  1337. struct ieee80211_radiotap_header *radiotap_header,
  1338. int max_length);
  1339. extern int ieee80211_radiotap_iterator_next(
  1340. struct ieee80211_radiotap_iterator *iterator);
  1341. extern const unsigned char rfc1042_header[6];
  1342. extern const unsigned char bridge_tunnel_header[6];
  1343. /**
  1344. * ieee80211_get_hdrlen_from_skb - get header length from data
  1345. *
  1346. * Given an skb with a raw 802.11 header at the data pointer this function
  1347. * returns the 802.11 header length in bytes (not including encryption
  1348. * headers). If the data in the sk_buff is too short to contain a valid 802.11
  1349. * header the function returns 0.
  1350. *
  1351. * @skb: the frame
  1352. */
  1353. unsigned int ieee80211_get_hdrlen_from_skb(const struct sk_buff *skb);
  1354. /**
  1355. * ieee80211_hdrlen - get header length in bytes from frame control
  1356. * @fc: frame control field in little-endian format
  1357. */
  1358. unsigned int ieee80211_hdrlen(__le16 fc);
  1359. /**
  1360. * ieee80211_data_to_8023 - convert an 802.11 data frame to 802.3
  1361. * @skb: the 802.11 data frame
  1362. * @addr: the device MAC address
  1363. * @iftype: the virtual interface type
  1364. */
  1365. int ieee80211_data_to_8023(struct sk_buff *skb, u8 *addr,
  1366. enum nl80211_iftype iftype);
  1367. /**
  1368. * ieee80211_data_from_8023 - convert an 802.3 frame to 802.11
  1369. * @skb: the 802.3 frame
  1370. * @addr: the device MAC address
  1371. * @iftype: the virtual interface type
  1372. * @bssid: the network bssid (used only for iftype STATION and ADHOC)
  1373. * @qos: build 802.11 QoS data frame
  1374. */
  1375. int ieee80211_data_from_8023(struct sk_buff *skb, u8 *addr,
  1376. enum nl80211_iftype iftype, u8 *bssid, bool qos);
  1377. /**
  1378. * cfg80211_classify8021d - determine the 802.1p/1d tag for a data frame
  1379. * @skb: the data frame
  1380. */
  1381. unsigned int cfg80211_classify8021d(struct sk_buff *skb);
  1382. /*
  1383. * Regulatory helper functions for wiphys
  1384. */
  1385. /**
  1386. * regulatory_hint - driver hint to the wireless core a regulatory domain
  1387. * @wiphy: the wireless device giving the hint (used only for reporting
  1388. * conflicts)
  1389. * @alpha2: the ISO/IEC 3166 alpha2 the driver claims its regulatory domain
  1390. * should be in. If @rd is set this should be NULL. Note that if you
  1391. * set this to NULL you should still set rd->alpha2 to some accepted
  1392. * alpha2.
  1393. *
  1394. * Wireless drivers can use this function to hint to the wireless core
  1395. * what it believes should be the current regulatory domain by
  1396. * giving it an ISO/IEC 3166 alpha2 country code it knows its regulatory
  1397. * domain should be in or by providing a completely build regulatory domain.
  1398. * If the driver provides an ISO/IEC 3166 alpha2 userspace will be queried
  1399. * for a regulatory domain structure for the respective country.
  1400. *
  1401. * The wiphy must have been registered to cfg80211 prior to this call.
  1402. * For cfg80211 drivers this means you must first use wiphy_register(),
  1403. * for mac80211 drivers you must first use ieee80211_register_hw().
  1404. *
  1405. * Drivers should check the return value, its possible you can get
  1406. * an -ENOMEM.
  1407. */
  1408. extern int regulatory_hint(struct wiphy *wiphy, const char *alpha2);
  1409. /**
  1410. * wiphy_apply_custom_regulatory - apply a custom driver regulatory domain
  1411. * @wiphy: the wireless device we want to process the regulatory domain on
  1412. * @regd: the custom regulatory domain to use for this wiphy
  1413. *
  1414. * Drivers can sometimes have custom regulatory domains which do not apply
  1415. * to a specific country. Drivers can use this to apply such custom regulatory
  1416. * domains. This routine must be called prior to wiphy registration. The
  1417. * custom regulatory domain will be trusted completely and as such previous
  1418. * default channel settings will be disregarded. If no rule is found for a
  1419. * channel on the regulatory domain the channel will be disabled.
  1420. */
  1421. extern void wiphy_apply_custom_regulatory(
  1422. struct wiphy *wiphy,
  1423. const struct ieee80211_regdomain *regd);
  1424. /**
  1425. * freq_reg_info - get regulatory information for the given frequency
  1426. * @wiphy: the wiphy for which we want to process this rule for
  1427. * @center_freq: Frequency in KHz for which we want regulatory information for
  1428. * @desired_bw_khz: the desired max bandwidth you want to use per
  1429. * channel. Note that this is still 20 MHz if you want to use HT40
  1430. * as HT40 makes use of two channels for its 40 MHz width bandwidth.
  1431. * If set to 0 we'll assume you want the standard 20 MHz.
  1432. * @reg_rule: the regulatory rule which we have for this frequency
  1433. *
  1434. * Use this function to get the regulatory rule for a specific frequency on
  1435. * a given wireless device. If the device has a specific regulatory domain
  1436. * it wants to follow we respect that unless a country IE has been received
  1437. * and processed already.
  1438. *
  1439. * Returns 0 if it was able to find a valid regulatory rule which does
  1440. * apply to the given center_freq otherwise it returns non-zero. It will
  1441. * also return -ERANGE if we determine the given center_freq does not even have
  1442. * a regulatory rule for a frequency range in the center_freq's band. See
  1443. * freq_in_rule_band() for our current definition of a band -- this is purely
  1444. * subjective and right now its 802.11 specific.
  1445. */
  1446. extern int freq_reg_info(struct wiphy *wiphy,
  1447. u32 center_freq,
  1448. u32 desired_bw_khz,
  1449. const struct ieee80211_reg_rule **reg_rule);
  1450. /*
  1451. * Temporary wext handlers & helper functions
  1452. *
  1453. * In the future cfg80211 will simply assign the entire wext handler
  1454. * structure to netdevs it manages, but we're not there yet.
  1455. */
  1456. int cfg80211_wext_giwname(struct net_device *dev,
  1457. struct iw_request_info *info,
  1458. char *name, char *extra);
  1459. int cfg80211_wext_siwmode(struct net_device *dev, struct iw_request_info *info,
  1460. u32 *mode, char *extra);
  1461. int cfg80211_wext_giwmode(struct net_device *dev, struct iw_request_info *info,
  1462. u32 *mode, char *extra);
  1463. int cfg80211_wext_siwscan(struct net_device *dev,
  1464. struct iw_request_info *info,
  1465. union iwreq_data *wrqu, char *extra);
  1466. int cfg80211_wext_giwscan(struct net_device *dev,
  1467. struct iw_request_info *info,
  1468. struct iw_point *data, char *extra);
  1469. int cfg80211_wext_siwmlme(struct net_device *dev,
  1470. struct iw_request_info *info,
  1471. struct iw_point *data, char *extra);
  1472. int cfg80211_wext_giwrange(struct net_device *dev,
  1473. struct iw_request_info *info,
  1474. struct iw_point *data, char *extra);
  1475. int cfg80211_wext_siwgenie(struct net_device *dev,
  1476. struct iw_request_info *info,
  1477. struct iw_point *data, char *extra);
  1478. int cfg80211_wext_siwauth(struct net_device *dev,
  1479. struct iw_request_info *info,
  1480. struct iw_param *data, char *extra);
  1481. int cfg80211_wext_giwauth(struct net_device *dev,
  1482. struct iw_request_info *info,
  1483. struct iw_param *data, char *extra);
  1484. int cfg80211_wext_siwfreq(struct net_device *dev,
  1485. struct iw_request_info *info,
  1486. struct iw_freq *freq, char *extra);
  1487. int cfg80211_wext_giwfreq(struct net_device *dev,
  1488. struct iw_request_info *info,
  1489. struct iw_freq *freq, char *extra);
  1490. int cfg80211_wext_siwessid(struct net_device *dev,
  1491. struct iw_request_info *info,
  1492. struct iw_point *data, char *ssid);
  1493. int cfg80211_wext_giwessid(struct net_device *dev,
  1494. struct iw_request_info *info,
  1495. struct iw_point *data, char *ssid);
  1496. int cfg80211_wext_siwrate(struct net_device *dev,
  1497. struct iw_request_info *info,
  1498. struct iw_param *rate, char *extra);
  1499. int cfg80211_wext_giwrate(struct net_device *dev,
  1500. struct iw_request_info *info,
  1501. struct iw_param *rate, char *extra);
  1502. int cfg80211_wext_siwrts(struct net_device *dev,
  1503. struct iw_request_info *info,
  1504. struct iw_param *rts, char *extra);
  1505. int cfg80211_wext_giwrts(struct net_device *dev,
  1506. struct iw_request_info *info,
  1507. struct iw_param *rts, char *extra);
  1508. int cfg80211_wext_siwfrag(struct net_device *dev,
  1509. struct iw_request_info *info,
  1510. struct iw_param *frag, char *extra);
  1511. int cfg80211_wext_giwfrag(struct net_device *dev,
  1512. struct iw_request_info *info,
  1513. struct iw_param *frag, char *extra);
  1514. int cfg80211_wext_siwretry(struct net_device *dev,
  1515. struct iw_request_info *info,
  1516. struct iw_param *retry, char *extra);
  1517. int cfg80211_wext_giwretry(struct net_device *dev,
  1518. struct iw_request_info *info,
  1519. struct iw_param *retry, char *extra);
  1520. int cfg80211_wext_siwencodeext(struct net_device *dev,
  1521. struct iw_request_info *info,
  1522. struct iw_point *erq, char *extra);
  1523. int cfg80211_wext_siwencode(struct net_device *dev,
  1524. struct iw_request_info *info,
  1525. struct iw_point *erq, char *keybuf);
  1526. int cfg80211_wext_giwencode(struct net_device *dev,
  1527. struct iw_request_info *info,
  1528. struct iw_point *erq, char *keybuf);
  1529. int cfg80211_wext_siwtxpower(struct net_device *dev,
  1530. struct iw_request_info *info,
  1531. union iwreq_data *data, char *keybuf);
  1532. int cfg80211_wext_giwtxpower(struct net_device *dev,
  1533. struct iw_request_info *info,
  1534. union iwreq_data *data, char *keybuf);
  1535. struct iw_statistics *cfg80211_wireless_stats(struct net_device *dev);
  1536. int cfg80211_wext_siwpower(struct net_device *dev,
  1537. struct iw_request_info *info,
  1538. struct iw_param *wrq, char *extra);
  1539. int cfg80211_wext_giwpower(struct net_device *dev,
  1540. struct iw_request_info *info,
  1541. struct iw_param *wrq, char *extra);
  1542. int cfg80211_wext_siwap(struct net_device *dev,
  1543. struct iw_request_info *info,
  1544. struct sockaddr *ap_addr, char *extra);
  1545. int cfg80211_wext_giwap(struct net_device *dev,
  1546. struct iw_request_info *info,
  1547. struct sockaddr *ap_addr, char *extra);
  1548. /*
  1549. * callbacks for asynchronous cfg80211 methods, notification
  1550. * functions and BSS handling helpers
  1551. */
  1552. /**
  1553. * cfg80211_scan_done - notify that scan finished
  1554. *
  1555. * @request: the corresponding scan request
  1556. * @aborted: set to true if the scan was aborted for any reason,
  1557. * userspace will be notified of that
  1558. */
  1559. void cfg80211_scan_done(struct cfg80211_scan_request *request, bool aborted);
  1560. /**
  1561. * cfg80211_inform_bss - inform cfg80211 of a new BSS
  1562. *
  1563. * @wiphy: the wiphy reporting the BSS
  1564. * @bss: the found BSS
  1565. * @signal: the signal strength, type depends on the wiphy's signal_type
  1566. * @gfp: context flags
  1567. *
  1568. * This informs cfg80211 that BSS information was found and
  1569. * the BSS should be updated/added.
  1570. */
  1571. struct cfg80211_bss*
  1572. cfg80211_inform_bss_frame(struct wiphy *wiphy,
  1573. struct ieee80211_channel *channel,
  1574. struct ieee80211_mgmt *mgmt, size_t len,
  1575. s32 signal, gfp_t gfp);
  1576. struct cfg80211_bss*
  1577. cfg80211_inform_bss(struct wiphy *wiphy,
  1578. struct ieee80211_channel *channel,
  1579. const u8 *bssid,
  1580. u64 timestamp, u16 capability, u16 beacon_interval,
  1581. const u8 *ie, size_t ielen,
  1582. s32 signal, gfp_t gfp);
  1583. struct cfg80211_bss *cfg80211_get_bss(struct wiphy *wiphy,
  1584. struct ieee80211_channel *channel,
  1585. const u8 *bssid,
  1586. const u8 *ssid, size_t ssid_len,
  1587. u16 capa_mask, u16 capa_val);
  1588. static inline struct cfg80211_bss *
  1589. cfg80211_get_ibss(struct wiphy *wiphy,
  1590. struct ieee80211_channel *channel,
  1591. const u8 *ssid, size_t ssid_len)
  1592. {
  1593. return cfg80211_get_bss(wiphy, channel, NULL, ssid, ssid_len,
  1594. WLAN_CAPABILITY_IBSS, WLAN_CAPABILITY_IBSS);
  1595. }
  1596. struct cfg80211_bss *cfg80211_get_mesh(struct wiphy *wiphy,
  1597. struct ieee80211_channel *channel,
  1598. const u8 *meshid, size_t meshidlen,
  1599. const u8 *meshcfg);
  1600. void cfg80211_put_bss(struct cfg80211_bss *bss);
  1601. /**
  1602. * cfg80211_unlink_bss - unlink BSS from internal data structures
  1603. * @wiphy: the wiphy
  1604. * @bss: the bss to remove
  1605. *
  1606. * This function removes the given BSS from the internal data structures
  1607. * thereby making it no longer show up in scan results etc. Use this
  1608. * function when you detect a BSS is gone. Normally BSSes will also time
  1609. * out, so it is not necessary to use this function at all.
  1610. */
  1611. void cfg80211_unlink_bss(struct wiphy *wiphy, struct cfg80211_bss *bss);
  1612. /**
  1613. * cfg80211_send_rx_auth - notification of processed authentication
  1614. * @dev: network device
  1615. * @buf: authentication frame (header + body)
  1616. * @len: length of the frame data
  1617. *
  1618. * This function is called whenever an authentication has been processed in
  1619. * station mode. The driver is required to call either this function or
  1620. * cfg80211_send_auth_timeout() to indicate the result of cfg80211_ops::auth()
  1621. * call. This function may sleep.
  1622. */
  1623. void cfg80211_send_rx_auth(struct net_device *dev, const u8 *buf, size_t len);
  1624. /**
  1625. * cfg80211_send_auth_timeout - notification of timed out authentication
  1626. * @dev: network device
  1627. * @addr: The MAC address of the device with which the authentication timed out
  1628. *
  1629. * This function may sleep.
  1630. */
  1631. void cfg80211_send_auth_timeout(struct net_device *dev, const u8 *addr);
  1632. /**
  1633. * cfg80211_send_rx_assoc - notification of processed association
  1634. * @dev: network device
  1635. * @buf: (re)association response frame (header + body)
  1636. * @len: length of the frame data
  1637. *
  1638. * This function is called whenever a (re)association response has been
  1639. * processed in station mode. The driver is required to call either this
  1640. * function or cfg80211_send_assoc_timeout() to indicate the result of
  1641. * cfg80211_ops::assoc() call. This function may sleep.
  1642. */
  1643. void cfg80211_send_rx_assoc(struct net_device *dev, const u8 *buf, size_t len);
  1644. /**
  1645. * cfg80211_send_assoc_timeout - notification of timed out association
  1646. * @dev: network device
  1647. * @addr: The MAC address of the device with which the association timed out
  1648. *
  1649. * This function may sleep.
  1650. */
  1651. void cfg80211_send_assoc_timeout(struct net_device *dev, const u8 *addr);
  1652. /**
  1653. * cfg80211_send_deauth - notification of processed deauthentication
  1654. * @dev: network device
  1655. * @buf: deauthentication frame (header + body)
  1656. * @len: length of the frame data
  1657. *
  1658. * This function is called whenever deauthentication has been processed in
  1659. * station mode. This includes both received deauthentication frames and
  1660. * locally generated ones. This function may sleep.
  1661. */
  1662. void cfg80211_send_deauth(struct net_device *dev, const u8 *buf, size_t len);
  1663. /**
  1664. * __cfg80211_send_deauth - notification of processed deauthentication
  1665. * @dev: network device
  1666. * @buf: deauthentication frame (header + body)
  1667. * @len: length of the frame data
  1668. *
  1669. * Like cfg80211_send_deauth(), but doesn't take the wdev lock.
  1670. */
  1671. void __cfg80211_send_deauth(struct net_device *dev, const u8 *buf, size_t len);
  1672. /**
  1673. * cfg80211_send_disassoc - notification of processed disassociation
  1674. * @dev: network device
  1675. * @buf: disassociation response frame (header + body)
  1676. * @len: length of the frame data
  1677. *
  1678. * This function is called whenever disassociation has been processed in
  1679. * station mode. This includes both received disassociation frames and locally
  1680. * generated ones. This function may sleep.
  1681. */
  1682. void cfg80211_send_disassoc(struct net_device *dev, const u8 *buf, size_t len);
  1683. /**
  1684. * __cfg80211_send_disassoc - notification of processed disassociation
  1685. * @dev: network device
  1686. * @buf: disassociation response frame (header + body)
  1687. * @len: length of the frame data
  1688. *
  1689. * Like cfg80211_send_disassoc(), but doesn't take the wdev lock.
  1690. */
  1691. void __cfg80211_send_disassoc(struct net_device *dev, const u8 *buf,
  1692. size_t len);
  1693. /**
  1694. * cfg80211_michael_mic_failure - notification of Michael MIC failure (TKIP)
  1695. * @dev: network device
  1696. * @addr: The source MAC address of the frame
  1697. * @key_type: The key type that the received frame used
  1698. * @key_id: Key identifier (0..3)
  1699. * @tsc: The TSC value of the frame that generated the MIC failure (6 octets)
  1700. * @gfp: allocation flags
  1701. *
  1702. * This function is called whenever the local MAC detects a MIC failure in a
  1703. * received frame. This matches with MLME-MICHAELMICFAILURE.indication()
  1704. * primitive.
  1705. */
  1706. void cfg80211_michael_mic_failure(struct net_device *dev, const u8 *addr,
  1707. enum nl80211_key_type key_type, int key_id,
  1708. const u8 *tsc, gfp_t gfp);
  1709. /**
  1710. * cfg80211_ibss_joined - notify cfg80211 that device joined an IBSS
  1711. *
  1712. * @dev: network device
  1713. * @bssid: the BSSID of the IBSS joined
  1714. * @gfp: allocation flags
  1715. *
  1716. * This function notifies cfg80211 that the device joined an IBSS or
  1717. * switched to a different BSSID. Before this function can be called,
  1718. * either a beacon has to have been received from the IBSS, or one of
  1719. * the cfg80211_inform_bss{,_frame} functions must have been called
  1720. * with the locally generated beacon -- this guarantees that there is
  1721. * always a scan result for this IBSS. cfg80211 will handle the rest.
  1722. */
  1723. void cfg80211_ibss_joined(struct net_device *dev, const u8 *bssid, gfp_t gfp);
  1724. /**
  1725. * wiphy_rfkill_set_hw_state - notify cfg80211 about hw block state
  1726. * @wiphy: the wiphy
  1727. * @blocked: block status
  1728. */
  1729. void wiphy_rfkill_set_hw_state(struct wiphy *wiphy, bool blocked);
  1730. /**
  1731. * wiphy_rfkill_start_polling - start polling rfkill
  1732. * @wiphy: the wiphy
  1733. */
  1734. void wiphy_rfkill_start_polling(struct wiphy *wiphy);
  1735. /**
  1736. * wiphy_rfkill_stop_polling - stop polling rfkill
  1737. * @wiphy: the wiphy
  1738. */
  1739. void wiphy_rfkill_stop_polling(struct wiphy *wiphy);
  1740. #ifdef CONFIG_NL80211_TESTMODE
  1741. /**
  1742. * cfg80211_testmode_alloc_reply_skb - allocate testmode reply
  1743. * @wiphy: the wiphy
  1744. * @approxlen: an upper bound of the length of the data that will
  1745. * be put into the skb
  1746. *
  1747. * This function allocates and pre-fills an skb for a reply to
  1748. * the testmode command. Since it is intended for a reply, calling
  1749. * it outside of the @testmode_cmd operation is invalid.
  1750. *
  1751. * The returned skb (or %NULL if any errors happen) is pre-filled
  1752. * with the wiphy index and set up in a way that any data that is
  1753. * put into the skb (with skb_put(), nla_put() or similar) will end
  1754. * up being within the %NL80211_ATTR_TESTDATA attribute, so all that
  1755. * needs to be done with the skb is adding data for the corresponding
  1756. * userspace tool which can then read that data out of the testdata
  1757. * attribute. You must not modify the skb in any other way.
  1758. *
  1759. * When done, call cfg80211_testmode_reply() with the skb and return
  1760. * its error code as the result of the @testmode_cmd operation.
  1761. */
  1762. struct sk_buff *cfg80211_testmode_alloc_reply_skb(struct wiphy *wiphy,
  1763. int approxlen);
  1764. /**
  1765. * cfg80211_testmode_reply - send the reply skb
  1766. * @skb: The skb, must have been allocated with
  1767. * cfg80211_testmode_alloc_reply_skb()
  1768. *
  1769. * Returns an error code or 0 on success, since calling this
  1770. * function will usually be the last thing before returning
  1771. * from the @testmode_cmd you should return the error code.
  1772. * Note that this function consumes the skb regardless of the
  1773. * return value.
  1774. */
  1775. int cfg80211_testmode_reply(struct sk_buff *skb);
  1776. /**
  1777. * cfg80211_testmode_alloc_event_skb - allocate testmode event
  1778. * @wiphy: the wiphy
  1779. * @approxlen: an upper bound of the length of the data that will
  1780. * be put into the skb
  1781. * @gfp: allocation flags
  1782. *
  1783. * This function allocates and pre-fills an skb for an event on the
  1784. * testmode multicast group.
  1785. *
  1786. * The returned skb (or %NULL if any errors happen) is set up in the
  1787. * same way as with cfg80211_testmode_alloc_reply_skb() but prepared
  1788. * for an event. As there, you should simply add data to it that will
  1789. * then end up in the %NL80211_ATTR_TESTDATA attribute. Again, you must
  1790. * not modify the skb in any other way.
  1791. *
  1792. * When done filling the skb, call cfg80211_testmode_event() with the
  1793. * skb to send the event.
  1794. */
  1795. struct sk_buff *cfg80211_testmode_alloc_event_skb(struct wiphy *wiphy,
  1796. int approxlen, gfp_t gfp);
  1797. /**
  1798. * cfg80211_testmode_event - send the event
  1799. * @skb: The skb, must have been allocated with
  1800. * cfg80211_testmode_alloc_event_skb()
  1801. * @gfp: allocation flags
  1802. *
  1803. * This function sends the given @skb, which must have been allocated
  1804. * by cfg80211_testmode_alloc_event_skb(), as an event. It always
  1805. * consumes it.
  1806. */
  1807. void cfg80211_testmode_event(struct sk_buff *skb, gfp_t gfp);
  1808. #define CFG80211_TESTMODE_CMD(cmd) .testmode_cmd = (cmd),
  1809. #else
  1810. #define CFG80211_TESTMODE_CMD(cmd)
  1811. #endif
  1812. /**
  1813. * cfg80211_connect_result - notify cfg80211 of connection result
  1814. *
  1815. * @dev: network device
  1816. * @bssid: the BSSID of the AP
  1817. * @req_ie: association request IEs (maybe be %NULL)
  1818. * @req_ie_len: association request IEs length
  1819. * @resp_ie: association response IEs (may be %NULL)
  1820. * @resp_ie_len: assoc response IEs length
  1821. * @status: status code, 0 for successful connection, use
  1822. * %WLAN_STATUS_UNSPECIFIED_FAILURE if your device cannot give you
  1823. * the real status code for failures.
  1824. * @gfp: allocation flags
  1825. *
  1826. * It should be called by the underlying driver whenever connect() has
  1827. * succeeded.
  1828. */
  1829. void cfg80211_connect_result(struct net_device *dev, const u8 *bssid,
  1830. const u8 *req_ie, size_t req_ie_len,
  1831. const u8 *resp_ie, size_t resp_ie_len,
  1832. u16 status, gfp_t gfp);
  1833. /**
  1834. * cfg80211_roamed - notify cfg80211 of roaming
  1835. *
  1836. * @dev: network device
  1837. * @bssid: the BSSID of the new AP
  1838. * @req_ie: association request IEs (maybe be %NULL)
  1839. * @req_ie_len: association request IEs length
  1840. * @resp_ie: association response IEs (may be %NULL)
  1841. * @resp_ie_len: assoc response IEs length
  1842. * @gfp: allocation flags
  1843. *
  1844. * It should be called by the underlying driver whenever it roamed
  1845. * from one AP to another while connected.
  1846. */
  1847. void cfg80211_roamed(struct net_device *dev, const u8 *bssid,
  1848. const u8 *req_ie, size_t req_ie_len,
  1849. const u8 *resp_ie, size_t resp_ie_len, gfp_t gfp);
  1850. /**
  1851. * cfg80211_disconnected - notify cfg80211 that connection was dropped
  1852. *
  1853. * @dev: network device
  1854. * @ie: information elements of the deauth/disassoc frame (may be %NULL)
  1855. * @ie_len: length of IEs
  1856. * @reason: reason code for the disconnection, set it to 0 if unknown
  1857. * @gfp: allocation flags
  1858. *
  1859. * After it calls this function, the driver should enter an idle state
  1860. * and not try to connect to any AP any more.
  1861. */
  1862. void cfg80211_disconnected(struct net_device *dev, u16 reason,
  1863. u8 *ie, size_t ie_len, gfp_t gfp);
  1864. #endif /* __NET_CFG80211_H */