cfg80211.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375
  1. #ifndef __NET_CFG80211_H
  2. #define __NET_CFG80211_H
  3. #include <linux/netlink.h>
  4. #include <linux/skbuff.h>
  5. #include <linux/nl80211.h>
  6. #include <net/genetlink.h>
  7. /*
  8. * 802.11 configuration in-kernel interface
  9. *
  10. * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
  11. */
  12. /**
  13. * struct vif_params - describes virtual interface parameters
  14. * @mesh_id: mesh ID to use
  15. * @mesh_id_len: length of the mesh ID
  16. */
  17. struct vif_params {
  18. u8 *mesh_id;
  19. int mesh_id_len;
  20. };
  21. /* Radiotap header iteration
  22. * implemented in net/wireless/radiotap.c
  23. * docs in Documentation/networking/radiotap-headers.txt
  24. */
  25. /**
  26. * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
  27. * @rtheader: pointer to the radiotap header we are walking through
  28. * @max_length: length of radiotap header in cpu byte ordering
  29. * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
  30. * @this_arg: pointer to current radiotap arg
  31. * @arg_index: internal next argument index
  32. * @arg: internal next argument pointer
  33. * @next_bitmap: internal pointer to next present u32
  34. * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
  35. */
  36. struct ieee80211_radiotap_iterator {
  37. struct ieee80211_radiotap_header *rtheader;
  38. int max_length;
  39. int this_arg_index;
  40. u8 *this_arg;
  41. int arg_index;
  42. u8 *arg;
  43. __le32 *next_bitmap;
  44. u32 bitmap_shifter;
  45. };
  46. extern int ieee80211_radiotap_iterator_init(
  47. struct ieee80211_radiotap_iterator *iterator,
  48. struct ieee80211_radiotap_header *radiotap_header,
  49. int max_length);
  50. extern int ieee80211_radiotap_iterator_next(
  51. struct ieee80211_radiotap_iterator *iterator);
  52. /**
  53. * struct key_params - key information
  54. *
  55. * Information about a key
  56. *
  57. * @key: key material
  58. * @key_len: length of key material
  59. * @cipher: cipher suite selector
  60. * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
  61. * with the get_key() callback, must be in little endian,
  62. * length given by @seq_len.
  63. */
  64. struct key_params {
  65. u8 *key;
  66. u8 *seq;
  67. int key_len;
  68. int seq_len;
  69. u32 cipher;
  70. };
  71. /**
  72. * struct beacon_parameters - beacon parameters
  73. *
  74. * Used to configure the beacon for an interface.
  75. *
  76. * @head: head portion of beacon (before TIM IE)
  77. * or %NULL if not changed
  78. * @tail: tail portion of beacon (after TIM IE)
  79. * or %NULL if not changed
  80. * @interval: beacon interval or zero if not changed
  81. * @dtim_period: DTIM period or zero if not changed
  82. * @head_len: length of @head
  83. * @tail_len: length of @tail
  84. */
  85. struct beacon_parameters {
  86. u8 *head, *tail;
  87. int interval, dtim_period;
  88. int head_len, tail_len;
  89. };
  90. /**
  91. * enum station_flags - station flags
  92. *
  93. * Station capability flags. Note that these must be the bits
  94. * according to the nl80211 flags.
  95. *
  96. * @STATION_FLAG_CHANGED: station flags were changed
  97. * @STATION_FLAG_AUTHORIZED: station is authorized to send frames (802.1X)
  98. * @STATION_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
  99. * with short preambles
  100. * @STATION_FLAG_WME: station is WME/QoS capable
  101. */
  102. enum station_flags {
  103. STATION_FLAG_CHANGED = 1<<0,
  104. STATION_FLAG_AUTHORIZED = 1<<NL80211_STA_FLAG_AUTHORIZED,
  105. STATION_FLAG_SHORT_PREAMBLE = 1<<NL80211_STA_FLAG_SHORT_PREAMBLE,
  106. STATION_FLAG_WME = 1<<NL80211_STA_FLAG_WME,
  107. };
  108. /**
  109. * enum plink_action - actions to perform in mesh peers
  110. *
  111. * @PLINK_ACTION_INVALID: action 0 is reserved
  112. * @PLINK_ACTION_OPEN: start mesh peer link establishment
  113. * @PLINK_ACTION_BLOCL: block traffic from this mesh peer
  114. */
  115. enum plink_actions {
  116. PLINK_ACTION_INVALID,
  117. PLINK_ACTION_OPEN,
  118. PLINK_ACTION_BLOCK,
  119. };
  120. /**
  121. * struct station_parameters - station parameters
  122. *
  123. * Used to change and create a new station.
  124. *
  125. * @vlan: vlan interface station should belong to
  126. * @supported_rates: supported rates in IEEE 802.11 format
  127. * (or NULL for no change)
  128. * @supported_rates_len: number of supported rates
  129. * @station_flags: station flags (see &enum station_flags)
  130. * @listen_interval: listen interval or -1 for no change
  131. * @aid: AID or zero for no change
  132. */
  133. struct station_parameters {
  134. u8 *supported_rates;
  135. struct net_device *vlan;
  136. u32 station_flags;
  137. int listen_interval;
  138. u16 aid;
  139. u8 supported_rates_len;
  140. u8 plink_action;
  141. };
  142. /**
  143. * enum station_info_flags - station information flags
  144. *
  145. * Used by the driver to indicate which info in &struct station_info
  146. * it has filled in during get_station() or dump_station().
  147. *
  148. * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
  149. * @STATION_INFO_RX_BYTES: @rx_bytes filled
  150. * @STATION_INFO_TX_BYTES: @tx_bytes filled
  151. * @STATION_INFO_LLID: @llid filled
  152. * @STATION_INFO_PLID: @plid filled
  153. * @STATION_INFO_PLINK_STATE: @plink_state filled
  154. */
  155. enum station_info_flags {
  156. STATION_INFO_INACTIVE_TIME = 1<<0,
  157. STATION_INFO_RX_BYTES = 1<<1,
  158. STATION_INFO_TX_BYTES = 1<<2,
  159. STATION_INFO_LLID = 1<<3,
  160. STATION_INFO_PLID = 1<<4,
  161. STATION_INFO_PLINK_STATE = 1<<5,
  162. };
  163. /**
  164. * struct station_info - station information
  165. *
  166. * Station information filled by driver for get_station() and dump_station.
  167. *
  168. * @filled: bitflag of flags from &enum station_info_flags
  169. * @inactive_time: time since last station activity (tx/rx) in milliseconds
  170. * @rx_bytes: bytes received from this station
  171. * @tx_bytes: bytes transmitted to this station
  172. * @llid: mesh local link id
  173. * @plid: mesh peer link id
  174. * @plink_state: mesh peer link state
  175. */
  176. struct station_info {
  177. u32 filled;
  178. u32 inactive_time;
  179. u32 rx_bytes;
  180. u32 tx_bytes;
  181. u16 llid;
  182. u16 plid;
  183. u8 plink_state;
  184. };
  185. /**
  186. * enum monitor_flags - monitor flags
  187. *
  188. * Monitor interface configuration flags. Note that these must be the bits
  189. * according to the nl80211 flags.
  190. *
  191. * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
  192. * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
  193. * @MONITOR_FLAG_CONTROL: pass control frames
  194. * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
  195. * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
  196. */
  197. enum monitor_flags {
  198. MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
  199. MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
  200. MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
  201. MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
  202. MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
  203. };
  204. /**
  205. * enum mpath_info_flags - mesh path information flags
  206. *
  207. * Used by the driver to indicate which info in &struct mpath_info it has filled
  208. * in during get_station() or dump_station().
  209. *
  210. * MPATH_INFO_FRAME_QLEN: @frame_qlen filled
  211. * MPATH_INFO_DSN: @dsn filled
  212. * MPATH_INFO_METRIC: @metric filled
  213. * MPATH_INFO_EXPTIME: @exptime filled
  214. * MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
  215. * MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
  216. * MPATH_INFO_FLAGS: @flags filled
  217. */
  218. enum mpath_info_flags {
  219. MPATH_INFO_FRAME_QLEN = BIT(0),
  220. MPATH_INFO_DSN = BIT(1),
  221. MPATH_INFO_METRIC = BIT(2),
  222. MPATH_INFO_EXPTIME = BIT(3),
  223. MPATH_INFO_DISCOVERY_TIMEOUT = BIT(4),
  224. MPATH_INFO_DISCOVERY_RETRIES = BIT(5),
  225. MPATH_INFO_FLAGS = BIT(6),
  226. };
  227. /**
  228. * struct mpath_info - mesh path information
  229. *
  230. * Mesh path information filled by driver for get_mpath() and dump_mpath().
  231. *
  232. * @filled: bitfield of flags from &enum mpath_info_flags
  233. * @frame_qlen: number of queued frames for this destination
  234. * @dsn: destination sequence number
  235. * @metric: metric (cost) of this mesh path
  236. * @exptime: expiration time for the mesh path from now, in msecs
  237. * @flags: mesh path flags
  238. * @discovery_timeout: total mesh path discovery timeout, in msecs
  239. * @discovery_retries: mesh path discovery retries
  240. */
  241. struct mpath_info {
  242. u32 filled;
  243. u32 frame_qlen;
  244. u32 dsn;
  245. u32 metric;
  246. u32 exptime;
  247. u32 discovery_timeout;
  248. u8 discovery_retries;
  249. u8 flags;
  250. };
  251. /* from net/wireless.h */
  252. struct wiphy;
  253. /**
  254. * struct cfg80211_ops - backend description for wireless configuration
  255. *
  256. * This struct is registered by fullmac card drivers and/or wireless stacks
  257. * in order to handle configuration requests on their interfaces.
  258. *
  259. * All callbacks except where otherwise noted should return 0
  260. * on success or a negative error code.
  261. *
  262. * All operations are currently invoked under rtnl for consistency with the
  263. * wireless extensions but this is subject to reevaluation as soon as this
  264. * code is used more widely and we have a first user without wext.
  265. *
  266. * @add_virtual_intf: create a new virtual interface with the given name
  267. *
  268. * @del_virtual_intf: remove the virtual interface determined by ifindex.
  269. *
  270. * @change_virtual_intf: change type of virtual interface
  271. *
  272. * @add_key: add a key with the given parameters. @mac_addr will be %NULL
  273. * when adding a group key.
  274. *
  275. * @get_key: get information about the key with the given parameters.
  276. * @mac_addr will be %NULL when requesting information for a group
  277. * key. All pointers given to the @callback function need not be valid
  278. * after it returns.
  279. *
  280. * @del_key: remove a key given the @mac_addr (%NULL for a group key)
  281. * and @key_index
  282. *
  283. * @set_default_key: set the default key on an interface
  284. *
  285. * @add_beacon: Add a beacon with given parameters, @head, @interval
  286. * and @dtim_period will be valid, @tail is optional.
  287. * @set_beacon: Change the beacon parameters for an access point mode
  288. * interface. This should reject the call when no beacon has been
  289. * configured.
  290. * @del_beacon: Remove beacon configuration and stop sending the beacon.
  291. *
  292. * @add_station: Add a new station.
  293. *
  294. * @del_station: Remove a station; @mac may be NULL to remove all stations.
  295. *
  296. * @change_station: Modify a given station.
  297. *
  298. * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
  299. */
  300. struct cfg80211_ops {
  301. int (*add_virtual_intf)(struct wiphy *wiphy, char *name,
  302. enum nl80211_iftype type, u32 *flags,
  303. struct vif_params *params);
  304. int (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
  305. int (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
  306. enum nl80211_iftype type, u32 *flags,
  307. struct vif_params *params);
  308. int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
  309. u8 key_index, u8 *mac_addr,
  310. struct key_params *params);
  311. int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
  312. u8 key_index, u8 *mac_addr, void *cookie,
  313. void (*callback)(void *cookie, struct key_params*));
  314. int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
  315. u8 key_index, u8 *mac_addr);
  316. int (*set_default_key)(struct wiphy *wiphy,
  317. struct net_device *netdev,
  318. u8 key_index);
  319. int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
  320. struct beacon_parameters *info);
  321. int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
  322. struct beacon_parameters *info);
  323. int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
  324. int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
  325. u8 *mac, struct station_parameters *params);
  326. int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
  327. u8 *mac);
  328. int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
  329. u8 *mac, struct station_parameters *params);
  330. int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
  331. u8 *mac, struct station_info *sinfo);
  332. int (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
  333. int idx, u8 *mac, struct station_info *sinfo);
  334. int (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
  335. u8 *dst, u8 *next_hop);
  336. int (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
  337. u8 *dst);
  338. int (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
  339. u8 *dst, u8 *next_hop);
  340. int (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
  341. u8 *dst, u8 *next_hop,
  342. struct mpath_info *pinfo);
  343. int (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
  344. int idx, u8 *dst, u8 *next_hop,
  345. struct mpath_info *pinfo);
  346. };
  347. #endif /* __NET_CFG80211_H */