nl80211.h 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818
  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_SEC_CHAN_OFFSET.
  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_BEACON_HEAD and %NL80211_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_SET_REG: Set current regulatory domain. CRDA sends this command
  115. * after being queried by the kernel. CRDA replies by sending a regulatory
  116. * domain structure which consists of %NL80211_ATTR_REG_ALPHA set to our
  117. * current alpha2 if it found a match. It also provides
  118. * NL80211_ATTR_REG_RULE_FLAGS, and a set of regulatory rules. Each
  119. * regulatory rule is a nested set of attributes given by
  120. * %NL80211_ATTR_REG_RULE_FREQ_[START|END] and
  121. * %NL80211_ATTR_FREQ_RANGE_MAX_BW with an attached power rule given by
  122. * %NL80211_ATTR_REG_RULE_POWER_MAX_ANT_GAIN and
  123. * %NL80211_ATTR_REG_RULE_POWER_MAX_EIRP.
  124. * @NL80211_CMD_REQ_SET_REG: ask the wireless core to set the regulatory domain
  125. * to the the specified ISO/IEC 3166-1 alpha2 country code. The core will
  126. * store this as a valid request and then query userspace for it.
  127. *
  128. * @NL80211_CMD_GET_MESH_PARAMS: Get mesh networking properties for the
  129. * interface identified by %NL80211_ATTR_IFINDEX
  130. *
  131. * @NL80211_CMD_SET_MESH_PARAMS: Set mesh networking properties for the
  132. * interface identified by %NL80211_ATTR_IFINDEX
  133. *
  134. * @NL80211_CMD_MAX: highest used command number
  135. * @__NL80211_CMD_AFTER_LAST: internal use
  136. */
  137. enum nl80211_commands {
  138. /* don't change the order or add anything inbetween, this is ABI! */
  139. NL80211_CMD_UNSPEC,
  140. NL80211_CMD_GET_WIPHY, /* can dump */
  141. NL80211_CMD_SET_WIPHY,
  142. NL80211_CMD_NEW_WIPHY,
  143. NL80211_CMD_DEL_WIPHY,
  144. NL80211_CMD_GET_INTERFACE, /* can dump */
  145. NL80211_CMD_SET_INTERFACE,
  146. NL80211_CMD_NEW_INTERFACE,
  147. NL80211_CMD_DEL_INTERFACE,
  148. NL80211_CMD_GET_KEY,
  149. NL80211_CMD_SET_KEY,
  150. NL80211_CMD_NEW_KEY,
  151. NL80211_CMD_DEL_KEY,
  152. NL80211_CMD_GET_BEACON,
  153. NL80211_CMD_SET_BEACON,
  154. NL80211_CMD_NEW_BEACON,
  155. NL80211_CMD_DEL_BEACON,
  156. NL80211_CMD_GET_STATION,
  157. NL80211_CMD_SET_STATION,
  158. NL80211_CMD_NEW_STATION,
  159. NL80211_CMD_DEL_STATION,
  160. NL80211_CMD_GET_MPATH,
  161. NL80211_CMD_SET_MPATH,
  162. NL80211_CMD_NEW_MPATH,
  163. NL80211_CMD_DEL_MPATH,
  164. NL80211_CMD_SET_BSS,
  165. NL80211_CMD_SET_REG,
  166. NL80211_CMD_REQ_SET_REG,
  167. NL80211_CMD_GET_MESH_PARAMS,
  168. NL80211_CMD_SET_MESH_PARAMS,
  169. /* add new commands above here */
  170. /* used to define NL80211_CMD_MAX below */
  171. __NL80211_CMD_AFTER_LAST,
  172. NL80211_CMD_MAX = __NL80211_CMD_AFTER_LAST - 1
  173. };
  174. /*
  175. * Allow user space programs to use #ifdef on new commands by defining them
  176. * here
  177. */
  178. #define NL80211_CMD_SET_BSS NL80211_CMD_SET_BSS
  179. /**
  180. * enum nl80211_attrs - nl80211 netlink attributes
  181. *
  182. * @NL80211_ATTR_UNSPEC: unspecified attribute to catch errors
  183. *
  184. * @NL80211_ATTR_WIPHY: index of wiphy to operate on, cf.
  185. * /sys/class/ieee80211/<phyname>/index
  186. * @NL80211_ATTR_WIPHY_NAME: wiphy name (used for renaming)
  187. * @NL80211_ATTR_WIPHY_TXQ_PARAMS: a nested array of TX queue parameters
  188. * @NL80211_ATTR_WIPHY_FREQ: frequency of the selected channel in MHz
  189. * @NL80211_ATTR_WIPHY_CHANNEL_TYPE: included with NL80211_ATTR_WIPHY_FREQ
  190. * if HT20 or HT40 are allowed (i.e., 802.11n disabled if not included):
  191. * NL80211_CHAN_NO_HT = HT not allowed (i.e., same as not including
  192. * this attribute)
  193. * NL80211_CHAN_HT20 = HT20 only
  194. * NL80211_CHAN_HT40MINUS = secondary channel is below the primary channel
  195. * NL80211_CHAN_HT40PLUS = secondary channel is above the primary channel
  196. *
  197. * @NL80211_ATTR_IFINDEX: network interface index of the device to operate on
  198. * @NL80211_ATTR_IFNAME: network interface name
  199. * @NL80211_ATTR_IFTYPE: type of virtual interface, see &enum nl80211_iftype
  200. *
  201. * @NL80211_ATTR_MAC: MAC address (various uses)
  202. *
  203. * @NL80211_ATTR_KEY_DATA: (temporal) key data; for TKIP this consists of
  204. * 16 bytes encryption key followed by 8 bytes each for TX and RX MIC
  205. * keys
  206. * @NL80211_ATTR_KEY_IDX: key ID (u8, 0-3)
  207. * @NL80211_ATTR_KEY_CIPHER: key cipher suite (u32, as defined by IEEE 802.11
  208. * section 7.3.2.25.1, e.g. 0x000FAC04)
  209. * @NL80211_ATTR_KEY_SEQ: transmit key sequence number (IV/PN) for TKIP and
  210. * CCMP keys, each six bytes in little endian
  211. *
  212. * @NL80211_ATTR_BEACON_INTERVAL: beacon interval in TU
  213. * @NL80211_ATTR_DTIM_PERIOD: DTIM period for beaconing
  214. * @NL80211_ATTR_BEACON_HEAD: portion of the beacon before the TIM IE
  215. * @NL80211_ATTR_BEACON_TAIL: portion of the beacon after the TIM IE
  216. *
  217. * @NL80211_ATTR_STA_AID: Association ID for the station (u16)
  218. * @NL80211_ATTR_STA_FLAGS: flags, nested element with NLA_FLAG attributes of
  219. * &enum nl80211_sta_flags.
  220. * @NL80211_ATTR_STA_LISTEN_INTERVAL: listen interval as defined by
  221. * IEEE 802.11 7.3.1.6 (u16).
  222. * @NL80211_ATTR_STA_SUPPORTED_RATES: supported rates, array of supported
  223. * rates as defined by IEEE 802.11 7.3.2.2 but without the length
  224. * restriction (at most %NL80211_MAX_SUPP_RATES).
  225. * @NL80211_ATTR_STA_VLAN: interface index of VLAN interface to move station
  226. * to, or the AP interface the station was originally added to to.
  227. * @NL80211_ATTR_STA_INFO: information about a station, part of station info
  228. * given for %NL80211_CMD_GET_STATION, nested attribute containing
  229. * info as possible, see &enum nl80211_sta_info.
  230. *
  231. * @NL80211_ATTR_WIPHY_BANDS: Information about an operating bands,
  232. * consisting of a nested array.
  233. *
  234. * @NL80211_ATTR_MESH_ID: mesh id (1-32 bytes).
  235. * @NL80211_ATTR_PLINK_ACTION: action to perform on the mesh peer link.
  236. * @NL80211_ATTR_MPATH_NEXT_HOP: MAC address of the next hop for a mesh path.
  237. * @NL80211_ATTR_MPATH_INFO: information about a mesh_path, part of mesh path
  238. * info given for %NL80211_CMD_GET_MPATH, nested attribute described at
  239. * &enum nl80211_mpath_info.
  240. *
  241. * @NL80211_ATTR_MNTR_FLAGS: flags, nested element with NLA_FLAG attributes of
  242. * &enum nl80211_mntr_flags.
  243. *
  244. * @NL80211_ATTR_REG_ALPHA2: an ISO-3166-alpha2 country code for which the
  245. * current regulatory domain should be set to or is already set to.
  246. * For example, 'CR', for Costa Rica. This attribute is used by the kernel
  247. * to query the CRDA to retrieve one regulatory domain. This attribute can
  248. * also be used by userspace to query the kernel for the currently set
  249. * regulatory domain. We chose an alpha2 as that is also used by the
  250. * IEEE-802.11d country information element to identify a country.
  251. * Users can also simply ask the wireless core to set regulatory domain
  252. * to a specific alpha2.
  253. * @NL80211_ATTR_REG_RULES: a nested array of regulatory domain regulatory
  254. * rules.
  255. *
  256. * @NL80211_ATTR_BSS_CTS_PROT: whether CTS protection is enabled (u8, 0 or 1)
  257. * @NL80211_ATTR_BSS_SHORT_PREAMBLE: whether short preamble is enabled
  258. * (u8, 0 or 1)
  259. * @NL80211_ATTR_BSS_SHORT_SLOT_TIME: whether short slot time enabled
  260. * (u8, 0 or 1)
  261. * @NL80211_ATTR_BSS_BASIC_RATES: basic rates, array of basic
  262. * rates in format defined by IEEE 802.11 7.3.2.2 but without the length
  263. * restriction (at most %NL80211_MAX_SUPP_RATES).
  264. *
  265. * @NL80211_ATTR_HT_CAPABILITY: HT Capability information element (from
  266. * association request when used with NL80211_CMD_NEW_STATION)
  267. *
  268. * @NL80211_ATTR_SUPPORTED_IFTYPES: nested attribute containing all
  269. * supported interface types, each a flag attribute with the number
  270. * of the interface mode.
  271. *
  272. * @NL80211_ATTR_MAX: highest attribute number currently defined
  273. * @__NL80211_ATTR_AFTER_LAST: internal use
  274. */
  275. enum nl80211_attrs {
  276. /* don't change the order or add anything inbetween, this is ABI! */
  277. NL80211_ATTR_UNSPEC,
  278. NL80211_ATTR_WIPHY,
  279. NL80211_ATTR_WIPHY_NAME,
  280. NL80211_ATTR_IFINDEX,
  281. NL80211_ATTR_IFNAME,
  282. NL80211_ATTR_IFTYPE,
  283. NL80211_ATTR_MAC,
  284. NL80211_ATTR_KEY_DATA,
  285. NL80211_ATTR_KEY_IDX,
  286. NL80211_ATTR_KEY_CIPHER,
  287. NL80211_ATTR_KEY_SEQ,
  288. NL80211_ATTR_KEY_DEFAULT,
  289. NL80211_ATTR_BEACON_INTERVAL,
  290. NL80211_ATTR_DTIM_PERIOD,
  291. NL80211_ATTR_BEACON_HEAD,
  292. NL80211_ATTR_BEACON_TAIL,
  293. NL80211_ATTR_STA_AID,
  294. NL80211_ATTR_STA_FLAGS,
  295. NL80211_ATTR_STA_LISTEN_INTERVAL,
  296. NL80211_ATTR_STA_SUPPORTED_RATES,
  297. NL80211_ATTR_STA_VLAN,
  298. NL80211_ATTR_STA_INFO,
  299. NL80211_ATTR_WIPHY_BANDS,
  300. NL80211_ATTR_MNTR_FLAGS,
  301. NL80211_ATTR_MESH_ID,
  302. NL80211_ATTR_STA_PLINK_ACTION,
  303. NL80211_ATTR_MPATH_NEXT_HOP,
  304. NL80211_ATTR_MPATH_INFO,
  305. NL80211_ATTR_BSS_CTS_PROT,
  306. NL80211_ATTR_BSS_SHORT_PREAMBLE,
  307. NL80211_ATTR_BSS_SHORT_SLOT_TIME,
  308. NL80211_ATTR_HT_CAPABILITY,
  309. NL80211_ATTR_SUPPORTED_IFTYPES,
  310. NL80211_ATTR_REG_ALPHA2,
  311. NL80211_ATTR_REG_RULES,
  312. NL80211_ATTR_MESH_PARAMS,
  313. NL80211_ATTR_BSS_BASIC_RATES,
  314. NL80211_ATTR_WIPHY_TXQ_PARAMS,
  315. NL80211_ATTR_WIPHY_FREQ,
  316. NL80211_ATTR_WIPHY_CHANNEL_TYPE,
  317. NL80211_ATTR_KEY_DEFAULT_MGMT,
  318. /* add attributes here, update the policy in nl80211.c */
  319. __NL80211_ATTR_AFTER_LAST,
  320. NL80211_ATTR_MAX = __NL80211_ATTR_AFTER_LAST - 1
  321. };
  322. /*
  323. * Allow user space programs to use #ifdef on new attributes by defining them
  324. * here
  325. */
  326. #define NL80211_ATTR_HT_CAPABILITY NL80211_ATTR_HT_CAPABILITY
  327. #define NL80211_ATTR_BSS_BASIC_RATES NL80211_ATTR_BSS_BASIC_RATES
  328. #define NL80211_ATTR_WIPHY_TXQ_PARAMS NL80211_ATTR_WIPHY_TXQ_PARAMS
  329. #define NL80211_ATTR_WIPHY_FREQ NL80211_ATTR_WIPHY_FREQ
  330. #define NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET NL80211_ATTR_WIPHY_SEC_CHAN_OFFSET
  331. #define NL80211_MAX_SUPP_RATES 32
  332. #define NL80211_MAX_SUPP_REG_RULES 32
  333. #define NL80211_TKIP_DATA_OFFSET_ENCR_KEY 0
  334. #define NL80211_TKIP_DATA_OFFSET_TX_MIC_KEY 16
  335. #define NL80211_TKIP_DATA_OFFSET_RX_MIC_KEY 24
  336. #define NL80211_HT_CAPABILITY_LEN 26
  337. /**
  338. * enum nl80211_iftype - (virtual) interface types
  339. *
  340. * @NL80211_IFTYPE_UNSPECIFIED: unspecified type, driver decides
  341. * @NL80211_IFTYPE_ADHOC: independent BSS member
  342. * @NL80211_IFTYPE_STATION: managed BSS member
  343. * @NL80211_IFTYPE_AP: access point
  344. * @NL80211_IFTYPE_AP_VLAN: VLAN interface for access points
  345. * @NL80211_IFTYPE_WDS: wireless distribution interface
  346. * @NL80211_IFTYPE_MONITOR: monitor interface receiving all frames
  347. * @NL80211_IFTYPE_MESH_POINT: mesh point
  348. * @NL80211_IFTYPE_MAX: highest interface type number currently defined
  349. * @__NL80211_IFTYPE_AFTER_LAST: internal use
  350. *
  351. * These values are used with the %NL80211_ATTR_IFTYPE
  352. * to set the type of an interface.
  353. *
  354. */
  355. enum nl80211_iftype {
  356. NL80211_IFTYPE_UNSPECIFIED,
  357. NL80211_IFTYPE_ADHOC,
  358. NL80211_IFTYPE_STATION,
  359. NL80211_IFTYPE_AP,
  360. NL80211_IFTYPE_AP_VLAN,
  361. NL80211_IFTYPE_WDS,
  362. NL80211_IFTYPE_MONITOR,
  363. NL80211_IFTYPE_MESH_POINT,
  364. /* keep last */
  365. __NL80211_IFTYPE_AFTER_LAST,
  366. NL80211_IFTYPE_MAX = __NL80211_IFTYPE_AFTER_LAST - 1
  367. };
  368. /**
  369. * enum nl80211_sta_flags - station flags
  370. *
  371. * Station flags. When a station is added to an AP interface, it is
  372. * assumed to be already associated (and hence authenticated.)
  373. *
  374. * @NL80211_STA_FLAG_AUTHORIZED: station is authorized (802.1X)
  375. * @NL80211_STA_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
  376. * with short barker preamble
  377. * @NL80211_STA_FLAG_WME: station is WME/QoS capable
  378. * @NL80211_STA_FLAG_MFP: station uses management frame protection
  379. */
  380. enum nl80211_sta_flags {
  381. __NL80211_STA_FLAG_INVALID,
  382. NL80211_STA_FLAG_AUTHORIZED,
  383. NL80211_STA_FLAG_SHORT_PREAMBLE,
  384. NL80211_STA_FLAG_WME,
  385. NL80211_STA_FLAG_MFP,
  386. /* keep last */
  387. __NL80211_STA_FLAG_AFTER_LAST,
  388. NL80211_STA_FLAG_MAX = __NL80211_STA_FLAG_AFTER_LAST - 1
  389. };
  390. /**
  391. * enum nl80211_rate_info - bitrate information
  392. *
  393. * These attribute types are used with %NL80211_STA_INFO_TXRATE
  394. * when getting information about the bitrate of a station.
  395. *
  396. * @__NL80211_RATE_INFO_INVALID: attribute number 0 is reserved
  397. * @NL80211_RATE_INFO_BITRATE: total bitrate (u16, 100kbit/s)
  398. * @NL80211_RATE_INFO_MCS: mcs index for 802.11n (u8)
  399. * @NL80211_RATE_INFO_40_MHZ_WIDTH: 40 Mhz dualchannel bitrate
  400. * @NL80211_RATE_INFO_SHORT_GI: 400ns guard interval
  401. * @NL80211_RATE_INFO_MAX: highest rate_info number currently defined
  402. * @__NL80211_RATE_INFO_AFTER_LAST: internal use
  403. */
  404. enum nl80211_rate_info {
  405. __NL80211_RATE_INFO_INVALID,
  406. NL80211_RATE_INFO_BITRATE,
  407. NL80211_RATE_INFO_MCS,
  408. NL80211_RATE_INFO_40_MHZ_WIDTH,
  409. NL80211_RATE_INFO_SHORT_GI,
  410. /* keep last */
  411. __NL80211_RATE_INFO_AFTER_LAST,
  412. NL80211_RATE_INFO_MAX = __NL80211_RATE_INFO_AFTER_LAST - 1
  413. };
  414. /**
  415. * enum nl80211_sta_info - station information
  416. *
  417. * These attribute types are used with %NL80211_ATTR_STA_INFO
  418. * when getting information about a station.
  419. *
  420. * @__NL80211_STA_INFO_INVALID: attribute number 0 is reserved
  421. * @NL80211_STA_INFO_INACTIVE_TIME: time since last activity (u32, msecs)
  422. * @NL80211_STA_INFO_RX_BYTES: total received bytes (u32, from this station)
  423. * @NL80211_STA_INFO_TX_BYTES: total transmitted bytes (u32, to this station)
  424. * @__NL80211_STA_INFO_AFTER_LAST: internal
  425. * @NL80211_STA_INFO_MAX: highest possible station info attribute
  426. * @NL80211_STA_INFO_SIGNAL: signal strength of last received PPDU (u8, dBm)
  427. * @NL80211_STA_INFO_TX_BITRATE: current unicast tx rate, nested attribute
  428. * containing info as possible, see &enum nl80211_sta_info_txrate.
  429. */
  430. enum nl80211_sta_info {
  431. __NL80211_STA_INFO_INVALID,
  432. NL80211_STA_INFO_INACTIVE_TIME,
  433. NL80211_STA_INFO_RX_BYTES,
  434. NL80211_STA_INFO_TX_BYTES,
  435. NL80211_STA_INFO_LLID,
  436. NL80211_STA_INFO_PLID,
  437. NL80211_STA_INFO_PLINK_STATE,
  438. NL80211_STA_INFO_SIGNAL,
  439. NL80211_STA_INFO_TX_BITRATE,
  440. /* keep last */
  441. __NL80211_STA_INFO_AFTER_LAST,
  442. NL80211_STA_INFO_MAX = __NL80211_STA_INFO_AFTER_LAST - 1
  443. };
  444. /**
  445. * enum nl80211_mpath_flags - nl80211 mesh path flags
  446. *
  447. * @NL80211_MPATH_FLAG_ACTIVE: the mesh path is active
  448. * @NL80211_MPATH_FLAG_RESOLVING: the mesh path discovery process is running
  449. * @NL80211_MPATH_FLAG_DSN_VALID: the mesh path contains a valid DSN
  450. * @NL80211_MPATH_FLAG_FIXED: the mesh path has been manually set
  451. * @NL80211_MPATH_FLAG_RESOLVED: the mesh path discovery process succeeded
  452. */
  453. enum nl80211_mpath_flags {
  454. NL80211_MPATH_FLAG_ACTIVE = 1<<0,
  455. NL80211_MPATH_FLAG_RESOLVING = 1<<1,
  456. NL80211_MPATH_FLAG_DSN_VALID = 1<<2,
  457. NL80211_MPATH_FLAG_FIXED = 1<<3,
  458. NL80211_MPATH_FLAG_RESOLVED = 1<<4,
  459. };
  460. /**
  461. * enum nl80211_mpath_info - mesh path information
  462. *
  463. * These attribute types are used with %NL80211_ATTR_MPATH_INFO when getting
  464. * information about a mesh path.
  465. *
  466. * @__NL80211_MPATH_INFO_INVALID: attribute number 0 is reserved
  467. * @NL80211_ATTR_MPATH_FRAME_QLEN: number of queued frames for this destination
  468. * @NL80211_ATTR_MPATH_DSN: destination sequence number
  469. * @NL80211_ATTR_MPATH_METRIC: metric (cost) of this mesh path
  470. * @NL80211_ATTR_MPATH_EXPTIME: expiration time for the path, in msec from now
  471. * @NL80211_ATTR_MPATH_FLAGS: mesh path flags, enumerated in
  472. * &enum nl80211_mpath_flags;
  473. * @NL80211_ATTR_MPATH_DISCOVERY_TIMEOUT: total path discovery timeout, in msec
  474. * @NL80211_ATTR_MPATH_DISCOVERY_RETRIES: mesh path discovery retries
  475. */
  476. enum nl80211_mpath_info {
  477. __NL80211_MPATH_INFO_INVALID,
  478. NL80211_MPATH_INFO_FRAME_QLEN,
  479. NL80211_MPATH_INFO_DSN,
  480. NL80211_MPATH_INFO_METRIC,
  481. NL80211_MPATH_INFO_EXPTIME,
  482. NL80211_MPATH_INFO_FLAGS,
  483. NL80211_MPATH_INFO_DISCOVERY_TIMEOUT,
  484. NL80211_MPATH_INFO_DISCOVERY_RETRIES,
  485. /* keep last */
  486. __NL80211_MPATH_INFO_AFTER_LAST,
  487. NL80211_MPATH_INFO_MAX = __NL80211_MPATH_INFO_AFTER_LAST - 1
  488. };
  489. /**
  490. * enum nl80211_band_attr - band attributes
  491. * @__NL80211_BAND_ATTR_INVALID: attribute number 0 is reserved
  492. * @NL80211_BAND_ATTR_FREQS: supported frequencies in this band,
  493. * an array of nested frequency attributes
  494. * @NL80211_BAND_ATTR_RATES: supported bitrates in this band,
  495. * an array of nested bitrate attributes
  496. * @NL80211_BAND_ATTR_HT_MCS_SET: 16-byte attribute containing the MCS set as
  497. * defined in 802.11n
  498. * @NL80211_BAND_ATTR_HT_CAPA: HT capabilities, as in the HT information IE
  499. * @NL80211_BAND_ATTR_HT_AMPDU_FACTOR: A-MPDU factor, as in 11n
  500. * @NL80211_BAND_ATTR_HT_AMPDU_DENSITY: A-MPDU density, as in 11n
  501. */
  502. enum nl80211_band_attr {
  503. __NL80211_BAND_ATTR_INVALID,
  504. NL80211_BAND_ATTR_FREQS,
  505. NL80211_BAND_ATTR_RATES,
  506. NL80211_BAND_ATTR_HT_MCS_SET,
  507. NL80211_BAND_ATTR_HT_CAPA,
  508. NL80211_BAND_ATTR_HT_AMPDU_FACTOR,
  509. NL80211_BAND_ATTR_HT_AMPDU_DENSITY,
  510. /* keep last */
  511. __NL80211_BAND_ATTR_AFTER_LAST,
  512. NL80211_BAND_ATTR_MAX = __NL80211_BAND_ATTR_AFTER_LAST - 1
  513. };
  514. #define NL80211_BAND_ATTR_HT_CAPA NL80211_BAND_ATTR_HT_CAPA
  515. /**
  516. * enum nl80211_frequency_attr - frequency attributes
  517. * @NL80211_FREQUENCY_ATTR_FREQ: Frequency in MHz
  518. * @NL80211_FREQUENCY_ATTR_DISABLED: Channel is disabled in current
  519. * regulatory domain.
  520. * @NL80211_FREQUENCY_ATTR_PASSIVE_SCAN: Only passive scanning is
  521. * permitted on this channel in current regulatory domain.
  522. * @NL80211_FREQUENCY_ATTR_NO_IBSS: IBSS networks are not permitted
  523. * on this channel in current regulatory domain.
  524. * @NL80211_FREQUENCY_ATTR_RADAR: Radar detection is mandatory
  525. * on this channel in current regulatory domain.
  526. * @NL80211_FREQUENCY_ATTR_MAX_TX_POWER: Maximum transmission power in mBm
  527. * (100 * dBm).
  528. */
  529. enum nl80211_frequency_attr {
  530. __NL80211_FREQUENCY_ATTR_INVALID,
  531. NL80211_FREQUENCY_ATTR_FREQ,
  532. NL80211_FREQUENCY_ATTR_DISABLED,
  533. NL80211_FREQUENCY_ATTR_PASSIVE_SCAN,
  534. NL80211_FREQUENCY_ATTR_NO_IBSS,
  535. NL80211_FREQUENCY_ATTR_RADAR,
  536. NL80211_FREQUENCY_ATTR_MAX_TX_POWER,
  537. /* keep last */
  538. __NL80211_FREQUENCY_ATTR_AFTER_LAST,
  539. NL80211_FREQUENCY_ATTR_MAX = __NL80211_FREQUENCY_ATTR_AFTER_LAST - 1
  540. };
  541. #define NL80211_FREQUENCY_ATTR_MAX_TX_POWER NL80211_FREQUENCY_ATTR_MAX_TX_POWER
  542. /**
  543. * enum nl80211_bitrate_attr - bitrate attributes
  544. * @NL80211_BITRATE_ATTR_RATE: Bitrate in units of 100 kbps
  545. * @NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE: Short preamble supported
  546. * in 2.4 GHz band.
  547. */
  548. enum nl80211_bitrate_attr {
  549. __NL80211_BITRATE_ATTR_INVALID,
  550. NL80211_BITRATE_ATTR_RATE,
  551. NL80211_BITRATE_ATTR_2GHZ_SHORTPREAMBLE,
  552. /* keep last */
  553. __NL80211_BITRATE_ATTR_AFTER_LAST,
  554. NL80211_BITRATE_ATTR_MAX = __NL80211_BITRATE_ATTR_AFTER_LAST - 1
  555. };
  556. /**
  557. * enum nl80211_reg_rule_attr - regulatory rule attributes
  558. * @NL80211_ATTR_REG_RULE_FLAGS: a set of flags which specify additional
  559. * considerations for a given frequency range. These are the
  560. * &enum nl80211_reg_rule_flags.
  561. * @NL80211_ATTR_FREQ_RANGE_START: starting frequencry for the regulatory
  562. * rule in KHz. This is not a center of frequency but an actual regulatory
  563. * band edge.
  564. * @NL80211_ATTR_FREQ_RANGE_END: ending frequency for the regulatory rule
  565. * in KHz. This is not a center a frequency but an actual regulatory
  566. * band edge.
  567. * @NL80211_ATTR_FREQ_RANGE_MAX_BW: maximum allowed bandwidth for this
  568. * frequency range, in KHz.
  569. * @NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN: the maximum allowed antenna gain
  570. * for a given frequency range. The value is in mBi (100 * dBi).
  571. * If you don't have one then don't send this.
  572. * @NL80211_ATTR_POWER_RULE_MAX_EIRP: the maximum allowed EIRP for
  573. * a given frequency range. The value is in mBm (100 * dBm).
  574. */
  575. enum nl80211_reg_rule_attr {
  576. __NL80211_REG_RULE_ATTR_INVALID,
  577. NL80211_ATTR_REG_RULE_FLAGS,
  578. NL80211_ATTR_FREQ_RANGE_START,
  579. NL80211_ATTR_FREQ_RANGE_END,
  580. NL80211_ATTR_FREQ_RANGE_MAX_BW,
  581. NL80211_ATTR_POWER_RULE_MAX_ANT_GAIN,
  582. NL80211_ATTR_POWER_RULE_MAX_EIRP,
  583. /* keep last */
  584. __NL80211_REG_RULE_ATTR_AFTER_LAST,
  585. NL80211_REG_RULE_ATTR_MAX = __NL80211_REG_RULE_ATTR_AFTER_LAST - 1
  586. };
  587. /**
  588. * enum nl80211_reg_rule_flags - regulatory rule flags
  589. *
  590. * @NL80211_RRF_NO_OFDM: OFDM modulation not allowed
  591. * @NL80211_RRF_NO_CCK: CCK modulation not allowed
  592. * @NL80211_RRF_NO_INDOOR: indoor operation not allowed
  593. * @NL80211_RRF_NO_OUTDOOR: outdoor operation not allowed
  594. * @NL80211_RRF_DFS: DFS support is required to be used
  595. * @NL80211_RRF_PTP_ONLY: this is only for Point To Point links
  596. * @NL80211_RRF_PTMP_ONLY: this is only for Point To Multi Point links
  597. * @NL80211_RRF_PASSIVE_SCAN: passive scan is required
  598. * @NL80211_RRF_NO_IBSS: no IBSS is allowed
  599. */
  600. enum nl80211_reg_rule_flags {
  601. NL80211_RRF_NO_OFDM = 1<<0,
  602. NL80211_RRF_NO_CCK = 1<<1,
  603. NL80211_RRF_NO_INDOOR = 1<<2,
  604. NL80211_RRF_NO_OUTDOOR = 1<<3,
  605. NL80211_RRF_DFS = 1<<4,
  606. NL80211_RRF_PTP_ONLY = 1<<5,
  607. NL80211_RRF_PTMP_ONLY = 1<<6,
  608. NL80211_RRF_PASSIVE_SCAN = 1<<7,
  609. NL80211_RRF_NO_IBSS = 1<<8,
  610. };
  611. /**
  612. * enum nl80211_mntr_flags - monitor configuration flags
  613. *
  614. * Monitor configuration flags.
  615. *
  616. * @__NL80211_MNTR_FLAG_INVALID: reserved
  617. *
  618. * @NL80211_MNTR_FLAG_FCSFAIL: pass frames with bad FCS
  619. * @NL80211_MNTR_FLAG_PLCPFAIL: pass frames with bad PLCP
  620. * @NL80211_MNTR_FLAG_CONTROL: pass control frames
  621. * @NL80211_MNTR_FLAG_OTHER_BSS: disable BSSID filtering
  622. * @NL80211_MNTR_FLAG_COOK_FRAMES: report frames after processing.
  623. * overrides all other flags.
  624. *
  625. * @__NL80211_MNTR_FLAG_AFTER_LAST: internal use
  626. * @NL80211_MNTR_FLAG_MAX: highest possible monitor flag
  627. */
  628. enum nl80211_mntr_flags {
  629. __NL80211_MNTR_FLAG_INVALID,
  630. NL80211_MNTR_FLAG_FCSFAIL,
  631. NL80211_MNTR_FLAG_PLCPFAIL,
  632. NL80211_MNTR_FLAG_CONTROL,
  633. NL80211_MNTR_FLAG_OTHER_BSS,
  634. NL80211_MNTR_FLAG_COOK_FRAMES,
  635. /* keep last */
  636. __NL80211_MNTR_FLAG_AFTER_LAST,
  637. NL80211_MNTR_FLAG_MAX = __NL80211_MNTR_FLAG_AFTER_LAST - 1
  638. };
  639. /**
  640. * enum nl80211_meshconf_params - mesh configuration parameters
  641. *
  642. * Mesh configuration parameters
  643. *
  644. * @__NL80211_MESHCONF_INVALID: internal use
  645. *
  646. * @NL80211_MESHCONF_RETRY_TIMEOUT: specifies the initial retry timeout in
  647. * millisecond units, used by the Peer Link Open message
  648. *
  649. * @NL80211_MESHCONF_CONFIRM_TIMEOUT: specifies the inital confirm timeout, in
  650. * millisecond units, used by the peer link management to close a peer link
  651. *
  652. * @NL80211_MESHCONF_HOLDING_TIMEOUT: specifies the holding timeout, in
  653. * millisecond units
  654. *
  655. * @NL80211_MESHCONF_MAX_PEER_LINKS: maximum number of peer links allowed
  656. * on this mesh interface
  657. *
  658. * @NL80211_MESHCONF_MAX_RETRIES: specifies the maximum number of peer link
  659. * open retries that can be sent to establish a new peer link instance in a
  660. * mesh
  661. *
  662. * @NL80211_MESHCONF_TTL: specifies the value of TTL field set at a source mesh
  663. * point.
  664. *
  665. * @NL80211_MESHCONF_AUTO_OPEN_PLINKS: whether we should automatically
  666. * open peer links when we detect compatible mesh peers.
  667. *
  668. * @NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES: the number of action frames
  669. * containing a PREQ that an MP can send to a particular destination (path
  670. * target)
  671. *
  672. * @NL80211_MESHCONF_PATH_REFRESH_TIME: how frequently to refresh mesh paths
  673. * (in milliseconds)
  674. *
  675. * @NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT: minimum length of time to wait
  676. * until giving up on a path discovery (in milliseconds)
  677. *
  678. * @NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT: The time (in TUs) for which mesh
  679. * points receiving a PREQ shall consider the forwarding information from the
  680. * root to be valid. (TU = time unit)
  681. *
  682. * @NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL: The minimum interval of time (in
  683. * TUs) during which an MP can send only one action frame containing a PREQ
  684. * reference element
  685. *
  686. * @NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME: The interval of time (in TUs)
  687. * that it takes for an HWMP information element to propagate across the mesh
  688. *
  689. * @NL80211_MESHCONF_ATTR_MAX: highest possible mesh configuration attribute
  690. *
  691. * @__NL80211_MESHCONF_ATTR_AFTER_LAST: internal use
  692. */
  693. enum nl80211_meshconf_params {
  694. __NL80211_MESHCONF_INVALID,
  695. NL80211_MESHCONF_RETRY_TIMEOUT,
  696. NL80211_MESHCONF_CONFIRM_TIMEOUT,
  697. NL80211_MESHCONF_HOLDING_TIMEOUT,
  698. NL80211_MESHCONF_MAX_PEER_LINKS,
  699. NL80211_MESHCONF_MAX_RETRIES,
  700. NL80211_MESHCONF_TTL,
  701. NL80211_MESHCONF_AUTO_OPEN_PLINKS,
  702. NL80211_MESHCONF_HWMP_MAX_PREQ_RETRIES,
  703. NL80211_MESHCONF_PATH_REFRESH_TIME,
  704. NL80211_MESHCONF_MIN_DISCOVERY_TIMEOUT,
  705. NL80211_MESHCONF_HWMP_ACTIVE_PATH_TIMEOUT,
  706. NL80211_MESHCONF_HWMP_PREQ_MIN_INTERVAL,
  707. NL80211_MESHCONF_HWMP_NET_DIAM_TRVS_TIME,
  708. /* keep last */
  709. __NL80211_MESHCONF_ATTR_AFTER_LAST,
  710. NL80211_MESHCONF_ATTR_MAX = __NL80211_MESHCONF_ATTR_AFTER_LAST - 1
  711. };
  712. /**
  713. * enum nl80211_txq_attr - TX queue parameter attributes
  714. * @__NL80211_TXQ_ATTR_INVALID: Attribute number 0 is reserved
  715. * @NL80211_TXQ_ATTR_QUEUE: TX queue identifier (NL80211_TXQ_Q_*)
  716. * @NL80211_TXQ_ATTR_TXOP: Maximum burst time in units of 32 usecs, 0 meaning
  717. * disabled
  718. * @NL80211_TXQ_ATTR_CWMIN: Minimum contention window [a value of the form
  719. * 2^n-1 in the range 1..32767]
  720. * @NL80211_TXQ_ATTR_CWMAX: Maximum contention window [a value of the form
  721. * 2^n-1 in the range 1..32767]
  722. * @NL80211_TXQ_ATTR_AIFS: Arbitration interframe space [0..255]
  723. * @__NL80211_TXQ_ATTR_AFTER_LAST: Internal
  724. * @NL80211_TXQ_ATTR_MAX: Maximum TXQ attribute number
  725. */
  726. enum nl80211_txq_attr {
  727. __NL80211_TXQ_ATTR_INVALID,
  728. NL80211_TXQ_ATTR_QUEUE,
  729. NL80211_TXQ_ATTR_TXOP,
  730. NL80211_TXQ_ATTR_CWMIN,
  731. NL80211_TXQ_ATTR_CWMAX,
  732. NL80211_TXQ_ATTR_AIFS,
  733. /* keep last */
  734. __NL80211_TXQ_ATTR_AFTER_LAST,
  735. NL80211_TXQ_ATTR_MAX = __NL80211_TXQ_ATTR_AFTER_LAST - 1
  736. };
  737. enum nl80211_txq_q {
  738. NL80211_TXQ_Q_VO,
  739. NL80211_TXQ_Q_VI,
  740. NL80211_TXQ_Q_BE,
  741. NL80211_TXQ_Q_BK
  742. };
  743. enum nl80211_channel_type {
  744. NL80211_CHAN_NO_HT,
  745. NL80211_CHAN_HT20,
  746. NL80211_CHAN_HT40MINUS,
  747. NL80211_CHAN_HT40PLUS
  748. };
  749. #endif /* __LINUX_NL80211_H */