nl80211.h 41 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097
  1. #ifndef __LINUX_NL80211_H
  2. #define __LINUX_NL80211_H
  3. /*
  4. * 802.11 netlink interface public header
  5. *
  6. * Copyright 2006, 2007, 2008 Johannes Berg <johannes@sipsolutions.net>
  7. * Copyright 2008 Michael Wu <flamingice@sourmilk.net>
  8. * Copyright 2008 Luis Carlos Cobo <luisca@cozybit.com>
  9. * Copyright 2008 Michael Buesch <mb@bu3sch.de>
  10. * Copyright 2008 Luis R. Rodriguez <lrodriguez@atheros.com>
  11. * Copyright 2008 Jouni Malinen <jouni.malinen@atheros.com>
  12. * Copyright 2008 Colin McCabe <colin@cozybit.com>
  13. *
  14. * Permission to use, copy, modify, and/or distribute this software for any
  15. * purpose with or without fee is hereby granted, provided that the above
  16. * copyright notice and this permission notice appear in all copies.
  17. *
  18. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  19. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  20. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  21. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  22. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  23. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  24. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  25. *
  26. */
  27. /**
  28. * DOC: Station handling
  29. *
  30. * Stations are added per interface, but a special case exists with VLAN
  31. * interfaces. When a station is bound to an AP interface, it may be moved
  32. * into a VLAN identified by a VLAN interface index (%NL80211_ATTR_STA_VLAN).
  33. * The station is still assumed to belong to the AP interface it was added
  34. * to.
  35. *
  36. * TODO: need more info?
  37. */
  38. /**
  39. * enum nl80211_commands - supported nl80211 commands
  40. *
  41. * @NL80211_CMD_UNSPEC: unspecified command to catch errors
  42. *
  43. * @NL80211_CMD_GET_WIPHY: request information about a wiphy or dump request
  44. * to get a list of all present wiphys.
  45. * @NL80211_CMD_SET_WIPHY: set wiphy parameters, needs %NL80211_ATTR_WIPHY or
  46. * %NL80211_ATTR_IFINDEX; can be used to set %NL80211_ATTR_WIPHY_NAME,
  47. * %NL80211_ATTR_WIPHY_TXQ_PARAMS, %NL80211_ATTR_WIPHY_FREQ, and/or
  48. * %NL80211_ATTR_WIPHY_CHANNEL_TYPE.
  49. * @NL80211_CMD_NEW_WIPHY: Newly created wiphy, response to get request
  50. * or rename notification. Has attributes %NL80211_ATTR_WIPHY and
  51. * %NL80211_ATTR_WIPHY_NAME.
  52. * @NL80211_CMD_DEL_WIPHY: Wiphy deleted. Has attributes
  53. * %NL80211_ATTR_WIPHY and %NL80211_ATTR_WIPHY_NAME.
  54. *
  55. * @NL80211_CMD_GET_INTERFACE: Request an interface's configuration;
  56. * either a dump request on a %NL80211_ATTR_WIPHY or a specific get
  57. * on an %NL80211_ATTR_IFINDEX is supported.
  58. * @NL80211_CMD_SET_INTERFACE: Set type of a virtual interface, requires
  59. * %NL80211_ATTR_IFINDEX and %NL80211_ATTR_IFTYPE.
  60. * @NL80211_CMD_NEW_INTERFACE: Newly created virtual interface or response
  61. * to %NL80211_CMD_GET_INTERFACE. Has %NL80211_ATTR_IFINDEX,
  62. * %NL80211_ATTR_WIPHY and %NL80211_ATTR_IFTYPE attributes. Can also
  63. * be sent from userspace to request creation of a new virtual interface,
  64. * then requires attributes %NL80211_ATTR_WIPHY, %NL80211_ATTR_IFTYPE and
  65. * %NL80211_ATTR_IFNAME.
  66. * @NL80211_CMD_DEL_INTERFACE: Virtual interface was deleted, has attributes
  67. * %NL80211_ATTR_IFINDEX and %NL80211_ATTR_WIPHY. Can also be sent from
  68. * userspace to request deletion of a virtual interface, then requires
  69. * attribute %NL80211_ATTR_IFINDEX.
  70. *
  71. * @NL80211_CMD_GET_KEY: Get sequence counter information for a key specified
  72. * by %NL80211_ATTR_KEY_IDX and/or %NL80211_ATTR_MAC.
  73. * @NL80211_CMD_SET_KEY: Set key attributes %NL80211_ATTR_KEY_DEFAULT,
  74. * %NL80211_ATTR_KEY_DEFAULT_MGMT, or %NL80211_ATTR_KEY_THRESHOLD.
  75. * @NL80211_CMD_NEW_KEY: add a key with given %NL80211_ATTR_KEY_DATA,
  76. * %NL80211_ATTR_KEY_IDX, %NL80211_ATTR_MAC and %NL80211_ATTR_KEY_CIPHER
  77. * attributes.
  78. * @NL80211_CMD_DEL_KEY: delete a key identified by %NL80211_ATTR_KEY_IDX
  79. * or %NL80211_ATTR_MAC.
  80. *
  81. * @NL80211_CMD_GET_BEACON: retrieve beacon information (returned in a
  82. * %NL80222_CMD_NEW_BEACON message)
  83. * @NL80211_CMD_SET_BEACON: set the beacon on an access point interface
  84. * using the %NL80211_ATTR_BEACON_INTERVAL, %NL80211_ATTR_DTIM_PERIOD,
  85. * %NL80211_ATTR_BEACON_HEAD and %NL80211_ATTR_BEACON_TAIL attributes.
  86. * @NL80211_CMD_NEW_BEACON: add a new beacon to an access point interface,
  87. * parameters are like for %NL80211_CMD_SET_BEACON.
  88. * @NL80211_CMD_DEL_BEACON: remove the beacon, stop sending it
  89. *
  90. * @NL80211_CMD_GET_STATION: Get station attributes for station identified by
  91. * %NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
  92. * @NL80211_CMD_SET_STATION: Set station attributes for station identified by
  93. * %NL80211_ATTR_MAC on the interface identified by %NL80211_ATTR_IFINDEX.
  94. * @NL80211_CMD_NEW_STATION: Add a station with given attributes to the
  95. * the interface identified by %NL80211_ATTR_IFINDEX.
  96. * @NL80211_CMD_DEL_STATION: Remove a station identified by %NL80211_ATTR_MAC
  97. * or, if no MAC address given, all stations, on the interface identified
  98. * by %NL80211_ATTR_IFINDEX.
  99. *
  100. * @NL80211_CMD_GET_MPATH: Get mesh path attributes for mesh path to
  101. * destination %NL80211_ATTR_MAC on the interface identified by
  102. * %NL80211_ATTR_IFINDEX.
  103. * @NL80211_CMD_SET_MPATH: Set mesh path attributes for mesh path to
  104. * destination %NL80211_ATTR_MAC on the interface identified by
  105. * %NL80211_ATTR_IFINDEX.
  106. * @NL80211_CMD_NEW_PATH: Add a mesh path with given attributes to the
  107. * the interface identified by %NL80211_ATTR_IFINDEX.
  108. * @NL80211_CMD_DEL_PATH: Remove a mesh path identified by %NL80211_ATTR_MAC
  109. * or, if no MAC address given, all mesh paths, on the interface identified
  110. * by %NL80211_ATTR_IFINDEX.
  111. * @NL80211_CMD_SET_BSS: Set BSS attributes for BSS identified by
  112. * %NL80211_ATTR_IFINDEX.
  113. *
  114. * @NL80211_CMD_GET_REG: ask the wireless core to send us its currently set
  115. * regulatory domain.
  116. * @NL80211_CMD_SET_REG: Set current regulatory domain. CRDA sends this command
  117. * after being queried by the kernel. CRDA replies by sending a regulatory
  118. * domain structure which consists of %NL80211_ATTR_REG_ALPHA set to our
  119. * current alpha2 if it found a match. It also provides
  120. * NL80211_ATTR_REG_RULE_FLAGS, and a set of regulatory rules. Each
  121. * regulatory rule is a nested set of attributes given by
  122. * %NL80211_ATTR_REG_RULE_FREQ_[START|END] and
  123. * %NL80211_ATTR_FREQ_RANGE_MAX_BW with an attached power rule given by
  124. * %NL80211_ATTR_REG_RULE_POWER_MAX_ANT_GAIN and
  125. * %NL80211_ATTR_REG_RULE_POWER_MAX_EIRP.
  126. * @NL80211_CMD_REQ_SET_REG: ask the wireless core to set the regulatory domain
  127. * to the the specified ISO/IEC 3166-1 alpha2 country code. The core will
  128. * store this as a valid request and then query userspace for it.
  129. *
  130. * @NL80211_CMD_GET_MESH_PARAMS: Get mesh networking properties for the
  131. * interface identified by %NL80211_ATTR_IFINDEX
  132. *
  133. * @NL80211_CMD_SET_MESH_PARAMS: Set mesh networking properties for the
  134. * interface identified by %NL80211_ATTR_IFINDEX
  135. *
  136. * @NL80211_CMD_SET_MGMT_EXTRA_IE: Set extra IEs for management frames. The
  137. * interface is identified with %NL80211_ATTR_IFINDEX and the management
  138. * frame subtype with %NL80211_ATTR_MGMT_SUBTYPE. The extra IE data to be
  139. * added to the end of the specified management frame is specified with
  140. * %NL80211_ATTR_IE. If the command succeeds, the requested data will be
  141. * added to all specified management frames generated by
  142. * kernel/firmware/driver.
  143. * Note: This command has been removed and it is only reserved at this
  144. * point to avoid re-using existing command number. The functionality this
  145. * command was planned for has been provided with cleaner design with the
  146. * option to specify additional IEs in NL80211_CMD_TRIGGER_SCAN,
  147. * NL80211_CMD_AUTHENTICATE, NL80211_CMD_ASSOCIATE,
  148. * NL80211_CMD_DEAUTHENTICATE, and NL80211_CMD_DISASSOCIATE.
  149. *
  150. * @NL80211_CMD_GET_SCAN: get scan results
  151. * @NL80211_CMD_TRIGGER_SCAN: trigger a new scan with the given parameters
  152. * @NL80211_CMD_NEW_SCAN_RESULTS: scan notification (as a reply to
  153. * NL80211_CMD_GET_SCAN and on the "scan" multicast group)
  154. * @NL80211_CMD_SCAN_ABORTED: scan was aborted, for unspecified reasons,
  155. * partial scan results may be available
  156. *
  157. * @NL80211_CMD_REG_CHANGE: indicates to userspace the regulatory domain
  158. * has been changed and provides details of the request information
  159. * that caused the change such as who initiated the regulatory request
  160. * (%NL80211_ATTR_REG_INITIATOR), the wiphy_idx
  161. * (%NL80211_ATTR_REG_ALPHA2) on which the request was made from if
  162. * the initiator was %NL80211_REGDOM_SET_BY_COUNTRY_IE or
  163. * %NL80211_REGDOM_SET_BY_DRIVER, the type of regulatory domain
  164. * set (%NL80211_ATTR_REG_TYPE), if the type of regulatory domain is
  165. * %NL80211_REG_TYPE_COUNTRY the alpha2 to which we have moved on
  166. * to (%NL80211_ATTR_REG_ALPHA2).
  167. *
  168. * @NL80211_CMD_AUTHENTICATE: authentication request and notification.
  169. * This command is used both as a command (request to authenticate) and
  170. * as an event on the "mlme" multicast group indicating completion of the
  171. * authentication process.
  172. * When used as a command, %NL80211_ATTR_IFINDEX is used to identify the
  173. * interface. %NL80211_ATTR_MAC is used to specify PeerSTAAddress (and
  174. * BSSID in case of station mode). %NL80211_ATTR_SSID is used to specify
  175. * the SSID (mainly for association, but is included in authentication
  176. * request, too, to help BSS selection. %NL80211_ATTR_WIPHY_FREQ is used
  177. * to specify the frequence of the channel in MHz. %NL80211_ATTR_AUTH_TYPE
  178. * is used to specify the authentication type. %NL80211_ATTR_IE is used to
  179. * define IEs (VendorSpecificInfo, but also including RSN IE and FT IEs)
  180. * to be added to the frame.
  181. * When used as an event, this reports reception of an Authentication
  182. * frame in station and IBSS modes when the local MLME processed the
  183. * frame, i.e., it was for the local STA and was received in correct
  184. * state. This is similar to MLME-AUTHENTICATE.confirm primitive in the
  185. * MLME SAP interface (kernel providing MLME, userspace SME). The
  186. * included NL80211_ATTR_FRAME attribute contains the management frame
  187. * (including both the header and frame body, but not FCS).
  188. * @NL80211_CMD_ASSOCIATE: association request and notification; like
  189. * NL80211_CMD_AUTHENTICATE but for Association and Reassociation
  190. * (similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,
  191. * MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives).
  192. * @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like
  193. * NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to
  194. * MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication
  195. * primitives).
  196. * @NL80211_CMD_DISASSOCIATE: disassociation request and notification; like
  197. * NL80211_CMD_AUTHENTICATE but for Disassociation frames (similar to
  198. * MLME-DISASSOCIATE.request and MLME-DISASSOCIATE.indication primitives).
  199. *
  200. * @NL80211_CMD_MICHAEL_MIC_FAILURE: notification of a locally detected Michael
  201. * MIC (part of TKIP) failure; sent on the "mlme" multicast group; the
  202. * event includes %NL80211_ATTR_MAC to describe the source MAC address of
  203. * the frame with invalid MIC, %NL80211_ATTR_KEY_TYPE to show the key
  204. * type, %NL80211_ATTR_KEY_IDX to indicate the key identifier, and
  205. * %NL80211_ATTR_KEY_SEQ to indicate the TSC value of the frame; this
  206. * event matches with MLME-MICHAELMICFAILURE.indication() primitive
  207. *
  208. * @NL80211_CMD_MAX: highest used command number
  209. * @__NL80211_CMD_AFTER_LAST: internal use
  210. */
  211. enum nl80211_commands {
  212. /* don't change the order or add anything inbetween, this is ABI! */
  213. NL80211_CMD_UNSPEC,
  214. NL80211_CMD_GET_WIPHY, /* can dump */
  215. NL80211_CMD_SET_WIPHY,
  216. NL80211_CMD_NEW_WIPHY,
  217. NL80211_CMD_DEL_WIPHY,
  218. NL80211_CMD_GET_INTERFACE, /* can dump */
  219. NL80211_CMD_SET_INTERFACE,
  220. NL80211_CMD_NEW_INTERFACE,
  221. NL80211_CMD_DEL_INTERFACE,
  222. NL80211_CMD_GET_KEY,
  223. NL80211_CMD_SET_KEY,
  224. NL80211_CMD_NEW_KEY,
  225. NL80211_CMD_DEL_KEY,
  226. NL80211_CMD_GET_BEACON,
  227. NL80211_CMD_SET_BEACON,
  228. NL80211_CMD_NEW_BEACON,
  229. NL80211_CMD_DEL_BEACON,
  230. NL80211_CMD_GET_STATION,
  231. NL80211_CMD_SET_STATION,
  232. NL80211_CMD_NEW_STATION,
  233. NL80211_CMD_DEL_STATION,
  234. NL80211_CMD_GET_MPATH,
  235. NL80211_CMD_SET_MPATH,
  236. NL80211_CMD_NEW_MPATH,
  237. NL80211_CMD_DEL_MPATH,
  238. NL80211_CMD_SET_BSS,
  239. NL80211_CMD_SET_REG,
  240. NL80211_CMD_REQ_SET_REG,
  241. NL80211_CMD_GET_MESH_PARAMS,
  242. NL80211_CMD_SET_MESH_PARAMS,
  243. NL80211_CMD_SET_MGMT_EXTRA_IE /* reserved; not used */,
  244. NL80211_CMD_GET_REG,
  245. NL80211_CMD_GET_SCAN,
  246. NL80211_CMD_TRIGGER_SCAN,
  247. NL80211_CMD_NEW_SCAN_RESULTS,
  248. NL80211_CMD_SCAN_ABORTED,
  249. NL80211_CMD_REG_CHANGE,
  250. NL80211_CMD_AUTHENTICATE,
  251. NL80211_CMD_ASSOCIATE,
  252. NL80211_CMD_DEAUTHENTICATE,
  253. NL80211_CMD_DISASSOCIATE,
  254. NL80211_CMD_MICHAEL_MIC_FAILURE,
  255. /* add new commands above here */
  256. /* used to define NL80211_CMD_MAX below */
  257. __NL80211_CMD_AFTER_LAST,
  258. NL80211_CMD_MAX = __NL80211_CMD_AFTER_LAST - 1
  259. };
  260. /*
  261. * Allow user space programs to use #ifdef on new commands by defining them
  262. * here
  263. */
  264. #define NL80211_CMD_SET_BSS NL80211_CMD_SET_BSS
  265. #define NL80211_CMD_SET_MGMT_EXTRA_IE NL80211_CMD_SET_MGMT_EXTRA_IE
  266. #define NL80211_CMD_REG_CHANGE NL80211_CMD_REG_CHANGE
  267. #define NL80211_CMD_AUTHENTICATE NL80211_CMD_AUTHENTICATE
  268. #define NL80211_CMD_ASSOCIATE NL80211_CMD_ASSOCIATE
  269. #define NL80211_CMD_DEAUTHENTICATE NL80211_CMD_DEAUTHENTICATE
  270. #define NL80211_CMD_DISASSOCIATE NL80211_CMD_DISASSOCIATE
  271. /**
  272. * enum nl80211_attrs - nl80211 netlink attributes
  273. *
  274. * @NL80211_ATTR_UNSPEC: unspecified attribute to catch errors
  275. *
  276. * @NL80211_ATTR_WIPHY: index of wiphy to operate on, cf.
  277. * /sys/class/ieee80211/<phyname>/index
  278. * @NL80211_ATTR_WIPHY_NAME: wiphy name (used for renaming)
  279. * @NL80211_ATTR_WIPHY_TXQ_PARAMS: a nested array of TX queue parameters
  280. * @NL80211_ATTR_WIPHY_FREQ: frequency of the selected channel in MHz
  281. * @NL80211_ATTR_WIPHY_CHANNEL_TYPE: included with NL80211_ATTR_WIPHY_FREQ
  282. * if HT20 or HT40 are allowed (i.e., 802.11n disabled if not included):
  283. * NL80211_CHAN_NO_HT = HT not allowed (i.e., same as not including
  284. * this attribute)
  285. * NL80211_CHAN_HT20 = HT20 only
  286. * NL80211_CHAN_HT40MINUS = secondary channel is below the primary channel
  287. * NL80211_CHAN_HT40PLUS = secondary channel is above the primary channel
  288. *
  289. * @NL80211_ATTR_IFINDEX: network interface index of the device to operate on
  290. * @NL80211_ATTR_IFNAME: network interface name
  291. * @NL80211_ATTR_IFTYPE: type of virtual interface, see &enum nl80211_iftype
  292. *
  293. * @NL80211_ATTR_MAC: MAC address (various uses)
  294. *
  295. * @NL80211_ATTR_KEY_DATA: (temporal) key data; for TKIP this consists of
  296. * 16 bytes encryption key followed by 8 bytes each for TX and RX MIC
  297. * keys
  298. * @NL80211_ATTR_KEY_IDX: key ID (u8, 0-3)
  299. * @NL80211_ATTR_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
  300. * section 7.3.2.25.1, e.g. 0x000FAC04)
  301. * @NL80211_ATTR_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
  302. * CCMP keys, each six bytes in little endian
  303. *
  304. * @NL80211_ATTR_BEACON_INTERVAL: beacon interval in TU
  305. * @NL80211_ATTR_DTIM_PERIOD: DTIM period for beaconing
  306. * @NL80211_ATTR_BEACON_HEAD: portion of the beacon before the TIM IE
  307. * @NL80211_ATTR_BEACON_TAIL: portion of the beacon after the TIM IE
  308. *
  309. * @NL80211_ATTR_STA_AID: Association ID for the station (u16)
  310. * @NL80211_ATTR_STA_FLAGS: flags, nested element with NLA_FLAG attributes of
  311. * &enum nl80211_sta_flags.
  312. * @NL80211_ATTR_STA_LISTEN_INTERVAL: listen interval as defined by
  313. * IEEE 802.11 7.3.1.6 (u16).
  314. * @NL80211_ATTR_STA_SUPPORTED_RATES: supported rates, array of supported
  315. * rates as defined by IEEE 802.11 7.3.2.2 but without the length
  316. * restriction (at most %NL80211_MAX_SUPP_RATES).
  317. * @NL80211_ATTR_STA_VLAN: interface index of VLAN interface to move station
  318. * to, or the AP interface the station was originally added to to.
  319. * @NL80211_ATTR_STA_INFO: information about a station, part of station info
  320. * given for %NL80211_CMD_GET_STATION, nested attribute containing
  321. * info as possible, see &enum nl80211_sta_info.
  322. *
  323. * @NL80211_ATTR_WIPHY_BANDS: Information about an operating bands,
  324. * consisting of a nested array.
  325. *
  326. * @NL80211_ATTR_MESH_ID: mesh id (1-32 bytes).
  327. * @NL80211_ATTR_PLINK_ACTION: action to perform on the mesh peer link.
  328. * @NL80211_ATTR_MPATH_NEXT_HOP: MAC address of the next hop for a mesh path.
  329. * @NL80211_ATTR_MPATH_INFO: information about a mesh_path, part of mesh path
  330. * info given for %NL80211_CMD_GET_MPATH, nested attribute described at
  331. * &enum nl80211_mpath_info.
  332. *
  333. * @NL80211_ATTR_MNTR_FLAGS: flags, nested element with NLA_FLAG attributes of
  334. * &enum nl80211_mntr_flags.
  335. *
  336. * @NL80211_ATTR_REG_ALPHA2: an ISO-3166-alpha2 country code for which the
  337. * current regulatory domain should be set to or is already set to.
  338. * For example, 'CR', for Costa Rica. This attribute is used by the kernel
  339. * to query the CRDA to retrieve one regulatory domain. This attribute can
  340. * also be used by userspace to query the kernel for the currently set
  341. * regulatory domain. We chose an alpha2 as that is also used by the
  342. * IEEE-802.11d country information element to identify a country.
  343. * Users can also simply ask the wireless core to set regulatory domain
  344. * to a specific alpha2.
  345. * @NL80211_ATTR_REG_RULES: a nested array of regulatory domain regulatory
  346. * rules.
  347. *
  348. * @NL80211_ATTR_BSS_CTS_PROT: whether CTS protection is enabled (u8, 0 or 1)
  349. * @NL80211_ATTR_BSS_SHORT_PREAMBLE: whether short preamble is enabled
  350. * (u8, 0 or 1)
  351. * @NL80211_ATTR_BSS_SHORT_SLOT_TIME: whether short slot time enabled
  352. * (u8, 0 or 1)
  353. * @NL80211_ATTR_BSS_BASIC_RATES: basic rates, array of basic
  354. * rates in format defined by IEEE 802.11 7.3.2.2 but without the length
  355. * restriction (at most %NL80211_MAX_SUPP_RATES).
  356. *
  357. * @NL80211_ATTR_HT_CAPABILITY: HT Capability information element (from
  358. * association request when used with NL80211_CMD_NEW_STATION)
  359. *
  360. * @NL80211_ATTR_SUPPORTED_IFTYPES: nested attribute containing all
  361. * supported interface types, each a flag attribute with the number
  362. * of the interface mode.
  363. *
  364. * @NL80211_ATTR_MGMT_SUBTYPE: Management frame subtype for
  365. * %NL80211_CMD_SET_MGMT_EXTRA_IE.
  366. *
  367. * @NL80211_ATTR_IE: Information element(s) data (used, e.g., with
  368. * %NL80211_CMD_SET_MGMT_EXTRA_IE).
  369. *
  370. * @NL80211_ATTR_MAX_NUM_SCAN_SSIDS: number of SSIDs you can scan with
  371. * a single scan request, a wiphy attribute.
  372. * @NL80211_ATTR_MAX_SCAN_IE_LEN: maximum length of information elements
  373. * that can be added to a scan request
  374. *
  375. * @NL80211_ATTR_SCAN_FREQUENCIES: nested attribute with frequencies (in MHz)
  376. * @NL80211_ATTR_SCAN_SSIDS: nested attribute with SSIDs, leave out for passive
  377. * scanning and include a zero-length SSID (wildcard) for wildcard scan
  378. * @NL80211_ATTR_SCAN_GENERATION: the scan generation increases whenever the
  379. * scan result list changes (BSS expired or added) so that applications
  380. * can verify that they got a single, consistent snapshot (when all dump
  381. * messages carried the same generation number)
  382. * @NL80211_ATTR_BSS: scan result BSS
  383. *
  384. * @NL80211_ATTR_REG_INITIATOR: indicates who requested the regulatory domain
  385. * currently in effect. This could be any of the %NL80211_REGDOM_SET_BY_*
  386. * @NL80211_ATTR_REG_TYPE: indicates the type of the regulatory domain currently
  387. * set. This can be one of the nl80211_reg_type (%NL80211_REGDOM_TYPE_*)
  388. *
  389. * @NL80211_ATTR_SUPPORTED_COMMANDS: wiphy attribute that specifies
  390. * an array of command numbers (i.e. a mapping index to command number)
  391. * that the driver for the given wiphy supports.
  392. *
  393. * @NL80211_ATTR_FRAME: frame data (binary attribute), including frame header
  394. * and body, but not FCS; used, e.g., with NL80211_CMD_AUTHENTICATE and
  395. * NL80211_CMD_ASSOCIATE events
  396. * @NL80211_ATTR_SSID: SSID (binary attribute, 0..32 octets)
  397. * @NL80211_ATTR_AUTH_TYPE: AuthenticationType, see &enum nl80211_auth_type,
  398. * represented as a u32
  399. * @NL80211_ATTR_REASON_CODE: ReasonCode for %NL80211_CMD_DEAUTHENTICATE and
  400. * %NL80211_CMD_DISASSOCIATE, u16
  401. *
  402. * @NL80211_ATTR_KEY_TYPE: Key Type, see &enum nl80211_key_type, represented as
  403. * a u32
  404. *
  405. * @NL80211_ATTR_MAX: highest attribute number currently defined
  406. * @__NL80211_ATTR_AFTER_LAST: internal use
  407. */
  408. enum nl80211_attrs {
  409. /* don't change the order or add anything inbetween, this is ABI! */
  410. NL80211_ATTR_UNSPEC,
  411. NL80211_ATTR_WIPHY,
  412. NL80211_ATTR_WIPHY_NAME,
  413. NL80211_ATTR_IFINDEX,
  414. NL80211_ATTR_IFNAME,
  415. NL80211_ATTR_IFTYPE,
  416. NL80211_ATTR_MAC,
  417. NL80211_ATTR_KEY_DATA,
  418. NL80211_ATTR_KEY_IDX,
  419. NL80211_ATTR_KEY_CIPHER,
  420. NL80211_ATTR_KEY_SEQ,
  421. NL80211_ATTR_KEY_DEFAULT,
  422. NL80211_ATTR_BEACON_INTERVAL,
  423. NL80211_ATTR_DTIM_PERIOD,
  424. NL80211_ATTR_BEACON_HEAD,
  425. NL80211_ATTR_BEACON_TAIL,
  426. NL80211_ATTR_STA_AID,
  427. NL80211_ATTR_STA_FLAGS,
  428. NL80211_ATTR_STA_LISTEN_INTERVAL,
  429. NL80211_ATTR_STA_SUPPORTED_RATES,
  430. NL80211_ATTR_STA_VLAN,
  431. NL80211_ATTR_STA_INFO,
  432. NL80211_ATTR_WIPHY_BANDS,
  433. NL80211_ATTR_MNTR_FLAGS,
  434. NL80211_ATTR_MESH_ID,
  435. NL80211_ATTR_STA_PLINK_ACTION,
  436. NL80211_ATTR_MPATH_NEXT_HOP,
  437. NL80211_ATTR_MPATH_INFO,
  438. NL80211_ATTR_BSS_CTS_PROT,
  439. NL80211_ATTR_BSS_SHORT_PREAMBLE,
  440. NL80211_ATTR_BSS_SHORT_SLOT_TIME,
  441. NL80211_ATTR_HT_CAPABILITY,
  442. NL80211_ATTR_SUPPORTED_IFTYPES,
  443. NL80211_ATTR_REG_ALPHA2,
  444. NL80211_ATTR_REG_RULES,
  445. NL80211_ATTR_MESH_PARAMS,
  446. NL80211_ATTR_BSS_BASIC_RATES,
  447. NL80211_ATTR_WIPHY_TXQ_PARAMS,
  448. NL80211_ATTR_WIPHY_FREQ,
  449. NL80211_ATTR_WIPHY_CHANNEL_TYPE,
  450. NL80211_ATTR_KEY_DEFAULT_MGMT,
  451. NL80211_ATTR_MGMT_SUBTYPE,
  452. NL80211_ATTR_IE,
  453. NL80211_ATTR_MAX_NUM_SCAN_SSIDS,
  454. NL80211_ATTR_SCAN_FREQUENCIES,
  455. NL80211_ATTR_SCAN_SSIDS,
  456. NL80211_ATTR_SCAN_GENERATION,
  457. NL80211_ATTR_BSS,
  458. NL80211_ATTR_REG_INITIATOR,
  459. NL80211_ATTR_REG_TYPE,
  460. NL80211_ATTR_SUPPORTED_COMMANDS,
  461. NL80211_ATTR_FRAME,
  462. NL80211_ATTR_SSID,
  463. NL80211_ATTR_AUTH_TYPE,
  464. NL80211_ATTR_REASON_CODE,
  465. NL80211_ATTR_KEY_TYPE,
  466. NL80211_ATTR_MAX_SCAN_IE_LEN,
  467. /* add attributes here, update the policy in nl80211.c */
  468. __NL80211_ATTR_AFTER_LAST,
  469. NL80211_ATTR_MAX = __NL80211_ATTR_AFTER_LAST - 1
  470. };
  471. /*
  472. * Allow user space programs to use #ifdef on new attributes by defining them
  473. * here
  474. */
  475. #define NL80211_ATTR_HT_CAPABILITY NL80211_ATTR_HT_CAPABILITY
  476. #define NL80211_ATTR_BSS_BASIC_RATES NL80211_ATTR_BSS_BASIC_RATES
  477. #define NL80211_ATTR_WIPHY_TXQ_PARAMS NL80211_ATTR_WIPHY_TXQ_PARAMS
  478. #define NL80211_ATTR_WIPHY_FREQ NL80211_ATTR_WIPHY_FREQ
  479. #define NL80211_ATTR_WIPHY_CHANNEL_TYPE NL80211_ATTR_WIPHY_CHANNEL_TYPE
  480. #define NL80211_ATTR_MGMT_SUBTYPE NL80211_ATTR_MGMT_SUBTYPE
  481. #define NL80211_ATTR_IE NL80211_ATTR_IE
  482. #define NL80211_ATTR_REG_INITIATOR NL80211_ATTR_REG_INITIATOR
  483. #define NL80211_ATTR_REG_TYPE NL80211_ATTR_REG_TYPE
  484. #define NL80211_ATTR_FRAME NL80211_ATTR_FRAME
  485. #define NL80211_ATTR_SSID NL80211_ATTR_SSID
  486. #define NL80211_ATTR_AUTH_TYPE NL80211_ATTR_AUTH_TYPE
  487. #define NL80211_ATTR_REASON_CODE NL80211_ATTR_REASON_CODE
  488. #define NL80211_MAX_SUPP_RATES 32
  489. #define NL80211_MAX_SUPP_REG_RULES 32
  490. #define NL80211_TKIP_DATA_OFFSET_ENCR_KEY 0
  491. #define NL80211_TKIP_DATA_OFFSET_TX_MIC_KEY 16
  492. #define NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY 24
  493. #define NL80211_HT_CAPABILITY_LEN 26
  494. /**
  495. * enum nl80211_iftype - (virtual) interface types
  496. *
  497. * @NL80211_IFTYPE_UNSPECIFIED: unspecified type, driver decides
  498. * @NL80211_IFTYPE_ADHOC: independent BSS member
  499. * @NL80211_IFTYPE_STATION: managed BSS member
  500. * @NL80211_IFTYPE_AP: access point
  501. * @NL80211_IFTYPE_AP_VLAN: VLAN interface for access points
  502. * @NL80211_IFTYPE_WDS: wireless distribution interface
  503. * @NL80211_IFTYPE_MONITOR: monitor interface receiving all frames
  504. * @NL80211_IFTYPE_MESH_POINT: mesh point
  505. * @NL80211_IFTYPE_MAX: highest interface type number currently defined
  506. * @__NL80211_IFTYPE_AFTER_LAST: internal use
  507. *
  508. * These values are used with the %NL80211_ATTR_IFTYPE
  509. * to set the type of an interface.
  510. *
  511. */
  512. enum nl80211_iftype {
  513. NL80211_IFTYPE_UNSPECIFIED,
  514. NL80211_IFTYPE_ADHOC,
  515. NL80211_IFTYPE_STATION,
  516. NL80211_IFTYPE_AP,
  517. NL80211_IFTYPE_AP_VLAN,
  518. NL80211_IFTYPE_WDS,
  519. NL80211_IFTYPE_MONITOR,
  520. NL80211_IFTYPE_MESH_POINT,
  521. /* keep last */
  522. __NL80211_IFTYPE_AFTER_LAST,
  523. NL80211_IFTYPE_MAX = __NL80211_IFTYPE_AFTER_LAST - 1
  524. };
  525. /**
  526. * enum nl80211_sta_flags - station flags
  527. *
  528. * Station flags. When a station is added to an AP interface, it is
  529. * assumed to be already associated (and hence authenticated.)
  530. *
  531. * @NL80211_STA_FLAG_AUTHORIZED: station is authorized (802.1X)
  532. * @NL80211_STA_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
  533. * with short barker preamble
  534. * @NL80211_STA_FLAG_WME: station is WME/QoS capable
  535. * @NL80211_STA_FLAG_MFP: station uses management frame protection
  536. */
  537. enum nl80211_sta_flags {
  538. __NL80211_STA_FLAG_INVALID,
  539. NL80211_STA_FLAG_AUTHORIZED,
  540. NL80211_STA_FLAG_SHORT_PREAMBLE,
  541. NL80211_STA_FLAG_WME,
  542. NL80211_STA_FLAG_MFP,
  543. /* keep last */
  544. __NL80211_STA_FLAG_AFTER_LAST,
  545. NL80211_STA_FLAG_MAX = __NL80211_STA_FLAG_AFTER_LAST - 1
  546. };
  547. /**
  548. * enum nl80211_rate_info - bitrate information
  549. *
  550. * These attribute types are used with %NL80211_STA_INFO_TXRATE
  551. * when getting information about the bitrate of a station.
  552. *
  553. * @__NL80211_RATE_INFO_INVALID: attribute number 0 is reserved
  554. * @NL80211_RATE_INFO_BITRATE: total bitrate (u16, 100kbit/s)
  555. * @NL80211_RATE_INFO_MCS: mcs index for 802.11n (u8)
  556. * @NL80211_RATE_INFO_40_MHZ_WIDTH: 40 Mhz dualchannel bitrate
  557. * @NL80211_RATE_INFO_SHORT_GI: 400ns guard interval
  558. * @NL80211_RATE_INFO_MAX: highest rate_info number currently defined
  559. * @__NL80211_RATE_INFO_AFTER_LAST: internal use
  560. */
  561. enum nl80211_rate_info {
  562. __NL80211_RATE_INFO_INVALID,
  563. NL80211_RATE_INFO_BITRATE,
  564. NL80211_RATE_INFO_MCS,
  565. NL80211_RATE_INFO_40_MHZ_WIDTH,
  566. NL80211_RATE_INFO_SHORT_GI,
  567. /* keep last */
  568. __NL80211_RATE_INFO_AFTER_LAST,
  569. NL80211_RATE_INFO_MAX = __NL80211_RATE_INFO_AFTER_LAST - 1
  570. };
  571. /**
  572. * enum nl80211_sta_info - station information
  573. *
  574. * These attribute types are used with %NL80211_ATTR_STA_INFO
  575. * when getting information about a station.
  576. *
  577. * @__NL80211_STA_INFO_INVALID: attribute number 0 is reserved
  578. * @NL80211_STA_INFO_INACTIVE_TIME: time since last activity (u32, msecs)
  579. * @NL80211_STA_INFO_RX_BYTES: total received bytes (u32, from this station)
  580. * @NL80211_STA_INFO_TX_BYTES: total transmitted bytes (u32, to this station)
  581. * @__NL80211_STA_INFO_AFTER_LAST: internal
  582. * @NL80211_STA_INFO_MAX: highest possible station info attribute
  583. * @NL80211_STA_INFO_SIGNAL: signal strength of last received PPDU (u8, dBm)
  584. * @NL80211_STA_INFO_TX_BITRATE: current unicast tx rate, nested attribute
  585. * containing info as possible, see &enum nl80211_sta_info_txrate.
  586. * @NL80211_STA_INFO_RX_PACKETS: total received packet (u32, from this station)
  587. * @NL80211_STA_INFO_TX_PACKETS: total transmitted packets (u32, to this
  588. * station)
  589. */
  590. enum nl80211_sta_info {
  591. __NL80211_STA_INFO_INVALID,
  592. NL80211_STA_INFO_INACTIVE_TIME,
  593. NL80211_STA_INFO_RX_BYTES,
  594. NL80211_STA_INFO_TX_BYTES,
  595. NL80211_STA_INFO_LLID,
  596. NL80211_STA_INFO_PLID,
  597. NL80211_STA_INFO_PLINK_STATE,
  598. NL80211_STA_INFO_SIGNAL,
  599. NL80211_STA_INFO_TX_BITRATE,
  600. NL80211_STA_INFO_RX_PACKETS,
  601. NL80211_STA_INFO_TX_PACKETS,
  602. /* keep last */
  603. __NL80211_STA_INFO_AFTER_LAST,
  604. NL80211_STA_INFO_MAX = __NL80211_STA_INFO_AFTER_LAST - 1
  605. };
  606. /**
  607. * enum nl80211_mpath_flags - nl80211 mesh path flags
  608. *
  609. * @NL80211_MPATH_FLAG_ACTIVE: the mesh path is active
  610. * @NL80211_MPATH_FLAG_RESOLVING: the mesh path discovery process is running
  611. * @NL80211_MPATH_FLAG_DSN_VALID: the mesh path contains a valid DSN
  612. * @NL80211_MPATH_FLAG_FIXED: the mesh path has been manually set
  613. * @NL80211_MPATH_FLAG_RESOLVED: the mesh path discovery process succeeded
  614. */
  615. enum nl80211_mpath_flags {
  616. NL80211_MPATH_FLAG_ACTIVE = 1<<0,
  617. NL80211_MPATH_FLAG_RESOLVING = 1<<1,
  618. NL80211_MPATH_FLAG_DSN_VALID = 1<<2,
  619. NL80211_MPATH_FLAG_FIXED = 1<<3,
  620. NL80211_MPATH_FLAG_RESOLVED = 1<<4,
  621. };
  622. /**
  623. * enum nl80211_mpath_info - mesh path information
  624. *
  625. * These attribute types are used with %NL80211_ATTR_MPATH_INFO when getting
  626. * information about a mesh path.
  627. *
  628. * @__NL80211_MPATH_INFO_INVALID: attribute number 0 is reserved
  629. * @NL80211_ATTR_MPATH_FRAME_QLEN: number of queued frames for this destination
  630. * @NL80211_ATTR_MPATH_DSN: destination sequence number
  631. * @NL80211_ATTR_MPATH_METRIC: metric (cost) of this mesh path
  632. * @NL80211_ATTR_MPATH_EXPTIME: expiration time for the path, in msec from now
  633. * @NL80211_ATTR_MPATH_FLAGS: mesh path flags, enumerated in
  634. * &enum nl80211_mpath_flags;
  635. * @NL80211_ATTR_MPATH_DISCOVERY_TIMEOUT: total path discovery timeout, in msec
  636. * @NL80211_ATTR_MPATH_DISCOVERY_RETRIES: mesh path discovery retries
  637. */
  638. enum nl80211_mpath_info {
  639. __NL80211_MPATH_INFO_INVALID,
  640. NL80211_MPATH_INFO_FRAME_QLEN,
  641. NL80211_MPATH_INFO_DSN,
  642. NL80211_MPATH_INFO_METRIC,
  643. NL80211_MPATH_INFO_EXPTIME,
  644. NL80211_MPATH_INFO_FLAGS,
  645. NL80211_MPATH_INFO_DISCOVERY_TIMEOUT,
  646. NL80211_MPATH_INFO_DISCOVERY_RETRIES,
  647. /* keep last */
  648. __NL80211_MPATH_INFO_AFTER_LAST,
  649. NL80211_MPATH_INFO_MAX = __NL80211_MPATH_INFO_AFTER_LAST - 1
  650. };
  651. /**
  652. * enum nl80211_band_attr - band attributes
  653. * @__NL80211_BAND_ATTR_INVALID: attribute number 0 is reserved
  654. * @NL80211_BAND_ATTR_FREQS: supported frequencies in this band,
  655. * an array of nested frequency attributes
  656. * @NL80211_BAND_ATTR_RATES: supported bitrates in this band,
  657. * an array of nested bitrate attributes
  658. * @NL80211_BAND_ATTR_HT_MCS_SET: 16-byte attribute containing the MCS set as
  659. * defined in 802.11n
  660. * @NL80211_BAND_ATTR_HT_CAPA: HT capabilities, as in the HT information IE
  661. * @NL80211_BAND_ATTR_HT_AMPDU_FACTOR: A-MPDU factor, as in 11n
  662. * @NL80211_BAND_ATTR_HT_AMPDU_DENSITY: A-MPDU density, as in 11n
  663. */
  664. enum nl80211_band_attr {
  665. __NL80211_BAND_ATTR_INVALID,
  666. NL80211_BAND_ATTR_FREQS,
  667. NL80211_BAND_ATTR_RATES,
  668. NL80211_BAND_ATTR_HT_MCS_SET,
  669. NL80211_BAND_ATTR_HT_CAPA,
  670. NL80211_BAND_ATTR_HT_AMPDU_FACTOR,
  671. NL80211_BAND_ATTR_HT_AMPDU_DENSITY,
  672. /* keep last */
  673. __NL80211_BAND_ATTR_AFTER_LAST,
  674. NL80211_BAND_ATTR_MAX = __NL80211_BAND_ATTR_AFTER_LAST - 1
  675. };
  676. #define NL80211_BAND_ATTR_HT_CAPA NL80211_BAND_ATTR_HT_CAPA
  677. /**
  678. * enum nl80211_frequency_attr - frequency attributes
  679. * @NL80211_FREQUENCY_ATTR_FREQ: Frequency in MHz
  680. * @NL80211_FREQUENCY_ATTR_DISABLED: Channel is disabled in current
  681. * regulatory domain.
  682. * @NL80211_FREQUENCY_ATTR_PASSIVE_SCAN: Only passive scanning is
  683. * permitted on this channel in current regulatory domain.
  684. * @NL80211_FREQUENCY_ATTR_NO_IBSS: IBSS networks are not permitted
  685. * on this channel in current regulatory domain.
  686. * @NL80211_FREQUENCY_ATTR_RADAR: Radar detection is mandatory
  687. * on this channel in current regulatory domain.
  688. * @NL80211_FREQUENCY_ATTR_MAX_TX_POWER: Maximum transmission power in mBm
  689. * (100 * dBm).
  690. */
  691. enum nl80211_frequency_attr {
  692. __NL80211_FREQUENCY_ATTR_INVALID,
  693. NL80211_FREQUENCY_ATTR_FREQ,
  694. NL80211_FREQUENCY_ATTR_DISABLED,
  695. NL80211_FREQUENCY_ATTR_PASSIVE_SCAN,
  696. NL80211_FREQUENCY_ATTR_NO_IBSS,
  697. NL80211_FREQUENCY_ATTR_RADAR,
  698. NL80211_FREQUENCY_ATTR_MAX_TX_POWER,
  699. /* keep last */
  700. __NL80211_FREQUENCY_ATTR_AFTER_LAST,
  701. NL80211_FREQUENCY_ATTR_MAX = __NL80211_FREQUENCY_ATTR_AFTER_LAST - 1
  702. };
  703. #define NL80211_FREQUENCY_ATTR_MAX_TX_POWER NL80211_FREQUENCY_ATTR_MAX_TX_POWER
  704. /**
  705. * enum nl80211_bitrate_attr - bitrate attributes
  706. * @NL80211_BITRATE_ATTR_RATE: Bitrate in units of 100 kbps
  707. * @NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE: Short preamble supported
  708. * in 2.4 GHz band.
  709. */
  710. enum nl80211_bitrate_attr {
  711. __NL80211_BITRATE_ATTR_INVALID,
  712. NL80211_BITRATE_ATTR_RATE,
  713. NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE,
  714. /* keep last */
  715. __NL80211_BITRATE_ATTR_AFTER_LAST,
  716. NL80211_BITRATE_ATTR_MAX = __NL80211_BITRATE_ATTR_AFTER_LAST - 1
  717. };
  718. /**
  719. * enum nl80211_initiator - Indicates the initiator of a reg domain request
  720. * @NL80211_REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world
  721. * regulatory domain.
  722. * @NL80211_REGDOM_SET_BY_USER: User asked the wireless core to set the
  723. * regulatory domain.
  724. * @NL80211_REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the
  725. * wireless core it thinks its knows the regulatory domain we should be in.
  726. * @NL80211_REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an
  727. * 802.11 country information element with regulatory information it
  728. * thinks we should consider.
  729. */
  730. enum nl80211_reg_initiator {
  731. NL80211_REGDOM_SET_BY_CORE,
  732. NL80211_REGDOM_SET_BY_USER,
  733. NL80211_REGDOM_SET_BY_DRIVER,
  734. NL80211_REGDOM_SET_BY_COUNTRY_IE,
  735. };
  736. /**
  737. * enum nl80211_reg_type - specifies the type of regulatory domain
  738. * @NL80211_REGDOM_TYPE_COUNTRY: the regulatory domain set is one that pertains
  739. * to a specific country. When this is set you can count on the
  740. * ISO / IEC 3166 alpha2 country code being valid.
  741. * @NL80211_REGDOM_TYPE_WORLD: the regulatory set domain is the world regulatory
  742. * domain.
  743. * @NL80211_REGDOM_TYPE_CUSTOM_WORLD: the regulatory domain set is a custom
  744. * driver specific world regulatory domain. These do not apply system-wide
  745. * and are only applicable to the individual devices which have requested
  746. * them to be applied.
  747. * @NL80211_REGDOM_TYPE_INTERSECTION: the regulatory domain set is the product
  748. * of an intersection between two regulatory domains -- the previously
  749. * set regulatory domain on the system and the last accepted regulatory
  750. * domain request to be processed.
  751. */
  752. enum nl80211_reg_type {
  753. NL80211_REGDOM_TYPE_COUNTRY,
  754. NL80211_REGDOM_TYPE_WORLD,
  755. NL80211_REGDOM_TYPE_CUSTOM_WORLD,
  756. NL80211_REGDOM_TYPE_INTERSECTION,
  757. };
  758. /**
  759. * enum nl80211_reg_rule_attr - regulatory rule attributes
  760. * @NL80211_ATTR_REG_RULE_FLAGS: a set of flags which specify additional
  761. * considerations for a given frequency range. These are the
  762. * &enum nl80211_reg_rule_flags.
  763. * @NL80211_ATTR_FREQ_RANGE_START: starting frequencry for the regulatory
  764. * rule in KHz. This is not a center of frequency but an actual regulatory
  765. * band edge.
  766. * @NL80211_ATTR_FREQ_RANGE_END: ending frequency for the regulatory rule
  767. * in KHz. This is not a center a frequency but an actual regulatory
  768. * band edge.
  769. * @NL80211_ATTR_FREQ_RANGE_MAX_BW: maximum allowed bandwidth for this
  770. * frequency range, in KHz.
  771. * @NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN: the maximum allowed antenna gain
  772. * for a given frequency range. The value is in mBi (100 * dBi).
  773. * If you don't have one then don't send this.
  774. * @NL80211_ATTR_POWER_RULE_MAX_EIRP: the maximum allowed EIRP for
  775. * a given frequency range. The value is in mBm (100 * dBm).
  776. */
  777. enum nl80211_reg_rule_attr {
  778. __NL80211_REG_RULE_ATTR_INVALID,
  779. NL80211_ATTR_REG_RULE_FLAGS,
  780. NL80211_ATTR_FREQ_RANGE_START,
  781. NL80211_ATTR_FREQ_RANGE_END,
  782. NL80211_ATTR_FREQ_RANGE_MAX_BW,
  783. NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN,
  784. NL80211_ATTR_POWER_RULE_MAX_EIRP,
  785. /* keep last */
  786. __NL80211_REG_RULE_ATTR_AFTER_LAST,
  787. NL80211_REG_RULE_ATTR_MAX = __NL80211_REG_RULE_ATTR_AFTER_LAST - 1
  788. };
  789. /**
  790. * enum nl80211_reg_rule_flags - regulatory rule flags
  791. *
  792. * @NL80211_RRF_NO_OFDM: OFDM modulation not allowed
  793. * @NL80211_RRF_NO_CCK: CCK modulation not allowed
  794. * @NL80211_RRF_NO_INDOOR: indoor operation not allowed
  795. * @NL80211_RRF_NO_OUTDOOR: outdoor operation not allowed
  796. * @NL80211_RRF_DFS: DFS support is required to be used
  797. * @NL80211_RRF_PTP_ONLY: this is only for Point To Point links
  798. * @NL80211_RRF_PTMP_ONLY: this is only for Point To Multi Point links
  799. * @NL80211_RRF_PASSIVE_SCAN: passive scan is required
  800. * @NL80211_RRF_NO_IBSS: no IBSS is allowed
  801. */
  802. enum nl80211_reg_rule_flags {
  803. NL80211_RRF_NO_OFDM = 1<<0,
  804. NL80211_RRF_NO_CCK = 1<<1,
  805. NL80211_RRF_NO_INDOOR = 1<<2,
  806. NL80211_RRF_NO_OUTDOOR = 1<<3,
  807. NL80211_RRF_DFS = 1<<4,
  808. NL80211_RRF_PTP_ONLY = 1<<5,
  809. NL80211_RRF_PTMP_ONLY = 1<<6,
  810. NL80211_RRF_PASSIVE_SCAN = 1<<7,
  811. NL80211_RRF_NO_IBSS = 1<<8,
  812. };
  813. /**
  814. * enum nl80211_mntr_flags - monitor configuration flags
  815. *
  816. * Monitor configuration flags.
  817. *
  818. * @__NL80211_MNTR_FLAG_INVALID: reserved
  819. *
  820. * @NL80211_MNTR_FLAG_FCSFAIL: pass frames with bad FCS
  821. * @NL80211_MNTR_FLAG_PLCPFAIL: pass frames with bad PLCP
  822. * @NL80211_MNTR_FLAG_CONTROL: pass control frames
  823. * @NL80211_MNTR_FLAG_OTHER_BSS: disable BSSID filtering
  824. * @NL80211_MNTR_FLAG_COOK_FRAMES: report frames after processing.
  825. * overrides all other flags.
  826. *
  827. * @__NL80211_MNTR_FLAG_AFTER_LAST: internal use
  828. * @NL80211_MNTR_FLAG_MAX: highest possible monitor flag
  829. */
  830. enum nl80211_mntr_flags {
  831. __NL80211_MNTR_FLAG_INVALID,
  832. NL80211_MNTR_FLAG_FCSFAIL,
  833. NL80211_MNTR_FLAG_PLCPFAIL,
  834. NL80211_MNTR_FLAG_CONTROL,
  835. NL80211_MNTR_FLAG_OTHER_BSS,
  836. NL80211_MNTR_FLAG_COOK_FRAMES,
  837. /* keep last */
  838. __NL80211_MNTR_FLAG_AFTER_LAST,
  839. NL80211_MNTR_FLAG_MAX = __NL80211_MNTR_FLAG_AFTER_LAST - 1
  840. };
  841. /**
  842. * enum nl80211_meshconf_params - mesh configuration parameters
  843. *
  844. * Mesh configuration parameters
  845. *
  846. * @__NL80211_MESHCONF_INVALID: internal use
  847. *
  848. * @NL80211_MESHCONF_RETRY_TIMEOUT: specifies the initial retry timeout in
  849. * millisecond units, used by the Peer Link Open message
  850. *
  851. * @NL80211_MESHCONF_CONFIRM_TIMEOUT: specifies the inital confirm timeout, in
  852. * millisecond units, used by the peer link management to close a peer link
  853. *
  854. * @NL80211_MESHCONF_HOLDING_TIMEOUT: specifies the holding timeout, in
  855. * millisecond units
  856. *
  857. * @NL80211_MESHCONF_MAX_PEER_LINKS: maximum number of peer links allowed
  858. * on this mesh interface
  859. *
  860. * @NL80211_MESHCONF_MAX_RETRIES: specifies the maximum number of peer link
  861. * open retries that can be sent to establish a new peer link instance in a
  862. * mesh
  863. *
  864. * @NL80211_MESHCONF_TTL: specifies the value of TTL field set at a source mesh
  865. * point.
  866. *
  867. * @NL80211_MESHCONF_AUTO_OPEN_PLINKS: whether we should automatically
  868. * open peer links when we detect compatible mesh peers.
  869. *
  870. * @NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES: the number of action frames
  871. * containing a PREQ that an MP can send to a particular destination (path
  872. * target)
  873. *
  874. * @NL80211_MESHCONF_PATH_REFRESH_TIME: how frequently to refresh mesh paths
  875. * (in milliseconds)
  876. *
  877. * @NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT: minimum length of time to wait
  878. * until giving up on a path discovery (in milliseconds)
  879. *
  880. * @NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT: The time (in TUs) for which mesh
  881. * points receiving a PREQ shall consider the forwarding information from the
  882. * root to be valid. (TU = time unit)
  883. *
  884. * @NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL: The minimum interval of time (in
  885. * TUs) during which an MP can send only one action frame containing a PREQ
  886. * reference element
  887. *
  888. * @NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME: The interval of time (in TUs)
  889. * that it takes for an HWMP information element to propagate across the mesh
  890. *
  891. * @NL80211_MESHCONF_ATTR_MAX: highest possible mesh configuration attribute
  892. *
  893. * @__NL80211_MESHCONF_ATTR_AFTER_LAST: internal use
  894. */
  895. enum nl80211_meshconf_params {
  896. __NL80211_MESHCONF_INVALID,
  897. NL80211_MESHCONF_RETRY_TIMEOUT,
  898. NL80211_MESHCONF_CONFIRM_TIMEOUT,
  899. NL80211_MESHCONF_HOLDING_TIMEOUT,
  900. NL80211_MESHCONF_MAX_PEER_LINKS,
  901. NL80211_MESHCONF_MAX_RETRIES,
  902. NL80211_MESHCONF_TTL,
  903. NL80211_MESHCONF_AUTO_OPEN_PLINKS,
  904. NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES,
  905. NL80211_MESHCONF_PATH_REFRESH_TIME,
  906. NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT,
  907. NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT,
  908. NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL,
  909. NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME,
  910. /* keep last */
  911. __NL80211_MESHCONF_ATTR_AFTER_LAST,
  912. NL80211_MESHCONF_ATTR_MAX = __NL80211_MESHCONF_ATTR_AFTER_LAST - 1
  913. };
  914. /**
  915. * enum nl80211_txq_attr - TX queue parameter attributes
  916. * @__NL80211_TXQ_ATTR_INVALID: Attribute number 0 is reserved
  917. * @NL80211_TXQ_ATTR_QUEUE: TX queue identifier (NL80211_TXQ_Q_*)
  918. * @NL80211_TXQ_ATTR_TXOP: Maximum burst time in units of 32 usecs, 0 meaning
  919. * disabled
  920. * @NL80211_TXQ_ATTR_CWMIN: Minimum contention window [a value of the form
  921. * 2^n-1 in the range 1..32767]
  922. * @NL80211_TXQ_ATTR_CWMAX: Maximum contention window [a value of the form
  923. * 2^n-1 in the range 1..32767]
  924. * @NL80211_TXQ_ATTR_AIFS: Arbitration interframe space [0..255]
  925. * @__NL80211_TXQ_ATTR_AFTER_LAST: Internal
  926. * @NL80211_TXQ_ATTR_MAX: Maximum TXQ attribute number
  927. */
  928. enum nl80211_txq_attr {
  929. __NL80211_TXQ_ATTR_INVALID,
  930. NL80211_TXQ_ATTR_QUEUE,
  931. NL80211_TXQ_ATTR_TXOP,
  932. NL80211_TXQ_ATTR_CWMIN,
  933. NL80211_TXQ_ATTR_CWMAX,
  934. NL80211_TXQ_ATTR_AIFS,
  935. /* keep last */
  936. __NL80211_TXQ_ATTR_AFTER_LAST,
  937. NL80211_TXQ_ATTR_MAX = __NL80211_TXQ_ATTR_AFTER_LAST - 1
  938. };
  939. enum nl80211_txq_q {
  940. NL80211_TXQ_Q_VO,
  941. NL80211_TXQ_Q_VI,
  942. NL80211_TXQ_Q_BE,
  943. NL80211_TXQ_Q_BK
  944. };
  945. enum nl80211_channel_type {
  946. NL80211_CHAN_NO_HT,
  947. NL80211_CHAN_HT20,
  948. NL80211_CHAN_HT40MINUS,
  949. NL80211_CHAN_HT40PLUS
  950. };
  951. /**
  952. * enum nl80211_bss - netlink attributes for a BSS
  953. *
  954. * @__NL80211_BSS_INVALID: invalid
  955. * @NL80211_BSS_FREQUENCY: frequency in MHz (u32)
  956. * @NL80211_BSS_TSF: TSF of the received probe response/beacon (u64)
  957. * @NL80211_BSS_BEACON_INTERVAL: beacon interval of the (I)BSS (u16)
  958. * @NL80211_BSS_CAPABILITY: capability field (CPU order, u16)
  959. * @NL80211_BSS_INFORMATION_ELEMENTS: binary attribute containing the
  960. * raw information elements from the probe response/beacon (bin)
  961. * @NL80211_BSS_SIGNAL_MBM: signal strength of probe response/beacon
  962. * in mBm (100 * dBm) (s32)
  963. * @NL80211_BSS_SIGNAL_UNSPEC: signal strength of the probe response/beacon
  964. * in unspecified units, scaled to 0..100 (u8)
  965. * @__NL80211_BSS_AFTER_LAST: internal
  966. * @NL80211_BSS_MAX: highest BSS attribute
  967. */
  968. enum nl80211_bss {
  969. __NL80211_BSS_INVALID,
  970. NL80211_BSS_BSSID,
  971. NL80211_BSS_FREQUENCY,
  972. NL80211_BSS_TSF,
  973. NL80211_BSS_BEACON_INTERVAL,
  974. NL80211_BSS_CAPABILITY,
  975. NL80211_BSS_INFORMATION_ELEMENTS,
  976. NL80211_BSS_SIGNAL_MBM,
  977. NL80211_BSS_SIGNAL_UNSPEC,
  978. /* keep last */
  979. __NL80211_BSS_AFTER_LAST,
  980. NL80211_BSS_MAX = __NL80211_BSS_AFTER_LAST - 1
  981. };
  982. /**
  983. * enum nl80211_auth_type - AuthenticationType
  984. *
  985. * @NL80211_AUTHTYPE_OPEN_SYSTEM: Open System authentication
  986. * @NL80211_AUTHTYPE_SHARED_KEY: Shared Key authentication (WEP only)
  987. * @NL80211_AUTHTYPE_FT: Fast BSS Transition (IEEE 802.11r)
  988. * @NL80211_AUTHTYPE_NETWORK_EAP: Network EAP (some Cisco APs and mainly LEAP)
  989. */
  990. enum nl80211_auth_type {
  991. NL80211_AUTHTYPE_OPEN_SYSTEM,
  992. NL80211_AUTHTYPE_SHARED_KEY,
  993. NL80211_AUTHTYPE_FT,
  994. NL80211_AUTHTYPE_NETWORK_EAP,
  995. };
  996. /**
  997. * enum nl80211_key_type - Key Type
  998. * @NL80211_KEYTYPE_GROUP: Group (broadcast/multicast) key
  999. * @NL80211_KEYTYPE_PAIRWISE: Pairwise (unicast/individual) key
  1000. * @NL80211_KEYTYPE_PEERKEY: PeerKey (DLS)
  1001. */
  1002. enum nl80211_key_type {
  1003. NL80211_KEYTYPE_GROUP,
  1004. NL80211_KEYTYPE_PAIRWISE,
  1005. NL80211_KEYTYPE_PEERKEY,
  1006. };
  1007. #endif /* __LINUX_NL80211_H */