1 #ifndef __NET_CFG80211_H
2 #define __NET_CFG80211_H
4 #include <linux/netlink.h>
5 #include <linux/skbuff.h>
6 #include <linux/nl80211.h>
7 #include <net/genetlink.h>
8 /* remove once we remove the wext stuff */
9 #include <net/iw_handler.h>
12 * 802.11 configuration in-kernel interface
14 * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
18 * struct vif_params - describes virtual interface parameters
19 * @mesh_id: mesh ID to use
20 * @mesh_id_len: length of the mesh ID
27 /* Radiotap header iteration
28 * implemented in net/wireless/radiotap.c
29 * docs in Documentation/networking/radiotap-headers.txt
32 * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
33 * @rtheader: pointer to the radiotap header we are walking through
34 * @max_length: length of radiotap header in cpu byte ordering
35 * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
36 * @this_arg: pointer to current radiotap arg
37 * @arg_index: internal next argument index
38 * @arg: internal next argument pointer
39 * @next_bitmap: internal pointer to next present u32
40 * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
43 struct ieee80211_radiotap_iterator {
44 struct ieee80211_radiotap_header *rtheader;
55 extern int ieee80211_radiotap_iterator_init(
56 struct ieee80211_radiotap_iterator *iterator,
57 struct ieee80211_radiotap_header *radiotap_header,
60 extern int ieee80211_radiotap_iterator_next(
61 struct ieee80211_radiotap_iterator *iterator);
65 * struct key_params - key information
67 * Information about a key
70 * @key_len: length of key material
71 * @cipher: cipher suite selector
72 * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
73 * with the get_key() callback, must be in little endian,
74 * length given by @seq_len.
85 * struct beacon_parameters - beacon parameters
87 * Used to configure the beacon for an interface.
89 * @head: head portion of beacon (before TIM IE)
90 * or %NULL if not changed
91 * @tail: tail portion of beacon (after TIM IE)
92 * or %NULL if not changed
93 * @interval: beacon interval or zero if not changed
94 * @dtim_period: DTIM period or zero if not changed
95 * @head_len: length of @head
96 * @tail_len: length of @tail
98 struct beacon_parameters {
100 int interval, dtim_period;
101 int head_len, tail_len;
105 * enum station_flags - station flags
107 * Station capability flags. Note that these must be the bits
108 * according to the nl80211 flags.
110 * @STATION_FLAG_CHANGED: station flags were changed
111 * @STATION_FLAG_AUTHORIZED: station is authorized to send frames (802.1X)
112 * @STATION_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
113 * with short preambles
114 * @STATION_FLAG_WME: station is WME/QoS capable
115 * @STATION_FLAG_MFP: station uses management frame protection
118 STATION_FLAG_CHANGED = 1<<0,
119 STATION_FLAG_AUTHORIZED = 1<<NL80211_STA_FLAG_AUTHORIZED,
120 STATION_FLAG_SHORT_PREAMBLE = 1<<NL80211_STA_FLAG_SHORT_PREAMBLE,
121 STATION_FLAG_WME = 1<<NL80211_STA_FLAG_WME,
122 STATION_FLAG_MFP = 1<<NL80211_STA_FLAG_MFP,
126 * enum plink_action - actions to perform in mesh peers
128 * @PLINK_ACTION_INVALID: action 0 is reserved
129 * @PLINK_ACTION_OPEN: start mesh peer link establishment
130 * @PLINK_ACTION_BLOCL: block traffic from this mesh peer
133 PLINK_ACTION_INVALID,
139 * struct station_parameters - station parameters
141 * Used to change and create a new station.
143 * @vlan: vlan interface station should belong to
144 * @supported_rates: supported rates in IEEE 802.11 format
145 * (or NULL for no change)
146 * @supported_rates_len: number of supported rates
147 * @station_flags: station flags (see &enum station_flags)
148 * @listen_interval: listen interval or -1 for no change
149 * @aid: AID or zero for no change
151 struct station_parameters {
153 struct net_device *vlan;
157 u8 supported_rates_len;
159 struct ieee80211_ht_cap *ht_capa;
163 * enum station_info_flags - station information flags
165 * Used by the driver to indicate which info in &struct station_info
166 * it has filled in during get_station() or dump_station().
168 * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
169 * @STATION_INFO_RX_BYTES: @rx_bytes filled
170 * @STATION_INFO_TX_BYTES: @tx_bytes filled
171 * @STATION_INFO_LLID: @llid filled
172 * @STATION_INFO_PLID: @plid filled
173 * @STATION_INFO_PLINK_STATE: @plink_state filled
174 * @STATION_INFO_SIGNAL: @signal filled
175 * @STATION_INFO_TX_BITRATE: @tx_bitrate fields are filled
176 * (tx_bitrate, tx_bitrate_flags and tx_bitrate_mcs)
178 enum station_info_flags {
179 STATION_INFO_INACTIVE_TIME = 1<<0,
180 STATION_INFO_RX_BYTES = 1<<1,
181 STATION_INFO_TX_BYTES = 1<<2,
182 STATION_INFO_LLID = 1<<3,
183 STATION_INFO_PLID = 1<<4,
184 STATION_INFO_PLINK_STATE = 1<<5,
185 STATION_INFO_SIGNAL = 1<<6,
186 STATION_INFO_TX_BITRATE = 1<<7,
190 * enum station_info_rate_flags - bitrate info flags
192 * Used by the driver to indicate the specific rate transmission
193 * type for 802.11n transmissions.
195 * @RATE_INFO_FLAGS_MCS: @tx_bitrate_mcs filled
196 * @RATE_INFO_FLAGS_40_MHZ_WIDTH: 40 Mhz width transmission
197 * @RATE_INFO_FLAGS_SHORT_GI: 400ns guard interval
199 enum rate_info_flags {
200 RATE_INFO_FLAGS_MCS = 1<<0,
201 RATE_INFO_FLAGS_40_MHZ_WIDTH = 1<<1,
202 RATE_INFO_FLAGS_SHORT_GI = 1<<2,
206 * struct rate_info - bitrate information
208 * Information about a receiving or transmitting bitrate
210 * @flags: bitflag of flags from &enum rate_info_flags
211 * @mcs: mcs index if struct describes a 802.11n bitrate
212 * @legacy: bitrate in 100kbit/s for 802.11abg
221 * struct station_info - station information
223 * Station information filled by driver for get_station() and dump_station.
225 * @filled: bitflag of flags from &enum station_info_flags
226 * @inactive_time: time since last station activity (tx/rx) in milliseconds
227 * @rx_bytes: bytes received from this station
228 * @tx_bytes: bytes transmitted to this station
229 * @llid: mesh local link id
230 * @plid: mesh peer link id
231 * @plink_state: mesh peer link state
232 * @signal: signal strength of last received packet in dBm
233 * @txrate: current unicast bitrate to this station
235 struct station_info {
244 struct rate_info txrate;
248 * enum monitor_flags - monitor flags
250 * Monitor interface configuration flags. Note that these must be the bits
251 * according to the nl80211 flags.
253 * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
254 * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
255 * @MONITOR_FLAG_CONTROL: pass control frames
256 * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
257 * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
260 MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
261 MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
262 MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
263 MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
264 MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
268 * enum mpath_info_flags - mesh path information flags
270 * Used by the driver to indicate which info in &struct mpath_info it has filled
271 * in during get_station() or dump_station().
273 * MPATH_INFO_FRAME_QLEN: @frame_qlen filled
274 * MPATH_INFO_DSN: @dsn filled
275 * MPATH_INFO_METRIC: @metric filled
276 * MPATH_INFO_EXPTIME: @exptime filled
277 * MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
278 * MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
279 * MPATH_INFO_FLAGS: @flags filled
281 enum mpath_info_flags {
282 MPATH_INFO_FRAME_QLEN = BIT(0),
283 MPATH_INFO_DSN = BIT(1),
284 MPATH_INFO_METRIC = BIT(2),
285 MPATH_INFO_EXPTIME = BIT(3),
286 MPATH_INFO_DISCOVERY_TIMEOUT = BIT(4),
287 MPATH_INFO_DISCOVERY_RETRIES = BIT(5),
288 MPATH_INFO_FLAGS = BIT(6),
292 * struct mpath_info - mesh path information
294 * Mesh path information filled by driver for get_mpath() and dump_mpath().
296 * @filled: bitfield of flags from &enum mpath_info_flags
297 * @frame_qlen: number of queued frames for this destination
298 * @dsn: destination sequence number
299 * @metric: metric (cost) of this mesh path
300 * @exptime: expiration time for the mesh path from now, in msecs
301 * @flags: mesh path flags
302 * @discovery_timeout: total mesh path discovery timeout, in msecs
303 * @discovery_retries: mesh path discovery retries
311 u32 discovery_timeout;
312 u8 discovery_retries;
317 * struct bss_parameters - BSS parameters
319 * Used to change BSS parameters (mainly for AP mode).
321 * @use_cts_prot: Whether to use CTS protection
322 * (0 = no, 1 = yes, -1 = do not change)
323 * @use_short_preamble: Whether the use of short preambles is allowed
324 * (0 = no, 1 = yes, -1 = do not change)
325 * @use_short_slot_time: Whether the use of short slot time is allowed
326 * (0 = no, 1 = yes, -1 = do not change)
327 * @basic_rates: basic rates in IEEE 802.11 format
328 * (or NULL for no change)
329 * @basic_rates_len: number of basic rates
331 struct bss_parameters {
333 int use_short_preamble;
334 int use_short_slot_time;
340 * enum reg_set_by - Indicates who is trying to set the regulatory domain
341 * @REGDOM_SET_BY_INIT: regulatory domain was set by initialization. We will be
342 * using a static world regulatory domain by default.
343 * @REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world regulatory domain.
344 * @REGDOM_SET_BY_USER: User asked the wireless core to set the
346 * @REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the wireless core
347 * it thinks its knows the regulatory domain we should be in.
348 * @REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an 802.11 country
349 * information element with regulatory information it thinks we
356 REGDOM_SET_BY_DRIVER,
357 REGDOM_SET_BY_COUNTRY_IE,
361 * enum environment_cap - Environment parsed from country IE
362 * @ENVIRON_ANY: indicates country IE applies to both indoor and
364 * @ENVIRON_INDOOR: indicates country IE applies only to indoor operation
365 * @ENVIRON_OUTDOOR: indicates country IE applies only to outdoor operation
367 enum environment_cap {
374 * struct regulatory_request - receipt of last regulatory request
376 * @wiphy: this is set if this request's initiator is
377 * %REGDOM_SET_BY_COUNTRY_IE or %REGDOM_SET_BY_DRIVER. This
378 * can be used by the wireless core to deal with conflicts
379 * and potentially inform users of which devices specifically
380 * cased the conflicts.
381 * @initiator: indicates who sent this request, could be any of
382 * of those set in reg_set_by, %REGDOM_SET_BY_*
383 * @alpha2: the ISO / IEC 3166 alpha2 country code of the requested
384 * regulatory domain. We have a few special codes:
385 * 00 - World regulatory domain
386 * 99 - built by driver but a specific alpha2 cannot be determined
387 * 98 - result of an intersection between two regulatory domains
388 * @intersect: indicates whether the wireless core should intersect
389 * the requested regulatory domain with the presently set regulatory
391 * @country_ie_checksum: checksum of the last processed and accepted
393 * @country_ie_env: lets us know if the AP is telling us we are outdoor,
394 * indoor, or if it doesn't matter
396 struct regulatory_request {
398 enum reg_set_by initiator;
401 u32 country_ie_checksum;
402 enum environment_cap country_ie_env;
405 struct ieee80211_freq_range {
408 u32 max_bandwidth_khz;
411 struct ieee80211_power_rule {
412 u32 max_antenna_gain;
416 struct ieee80211_reg_rule {
417 struct ieee80211_freq_range freq_range;
418 struct ieee80211_power_rule power_rule;
422 struct ieee80211_regdomain {
425 struct ieee80211_reg_rule reg_rules[];
428 #define MHZ_TO_KHZ(freq) ((freq) * 1000)
429 #define KHZ_TO_MHZ(freq) ((freq) / 1000)
430 #define DBI_TO_MBI(gain) ((gain) * 100)
431 #define MBI_TO_DBI(gain) ((gain) / 100)
432 #define DBM_TO_MBM(gain) ((gain) * 100)
433 #define MBM_TO_DBM(gain) ((gain) / 100)
435 #define REG_RULE(start, end, bw, gain, eirp, reg_flags) { \
436 .freq_range.start_freq_khz = MHZ_TO_KHZ(start), \
437 .freq_range.end_freq_khz = MHZ_TO_KHZ(end), \
438 .freq_range.max_bandwidth_khz = MHZ_TO_KHZ(bw), \
439 .power_rule.max_antenna_gain = DBI_TO_MBI(gain), \
440 .power_rule.max_eirp = DBM_TO_MBM(eirp), \
441 .flags = reg_flags, \
446 /* Mesh plink management parameters */
447 u16 dot11MeshRetryTimeout;
448 u16 dot11MeshConfirmTimeout;
449 u16 dot11MeshHoldingTimeout;
450 u16 dot11MeshMaxPeerLinks;
451 u8 dot11MeshMaxRetries;
453 bool auto_open_plinks;
454 /* HWMP parameters */
455 u8 dot11MeshHWMPmaxPREQretries;
456 u32 path_refresh_time;
457 u16 min_discovery_timeout;
458 u32 dot11MeshHWMPactivePathTimeout;
459 u16 dot11MeshHWMPpreqMinInterval;
460 u16 dot11MeshHWMPnetDiameterTraversalTime;
464 * struct ieee80211_txq_params - TX queue parameters
465 * @queue: TX queue identifier (NL80211_TXQ_Q_*)
466 * @txop: Maximum burst time in units of 32 usecs, 0 meaning disabled
467 * @cwmin: Minimum contention window [a value of the form 2^n-1 in the range
469 * @cwmax: Maximum contention window [a value of the form 2^n-1 in the range
471 * @aifs: Arbitration interframe space [0..255]
473 struct ieee80211_txq_params {
474 enum nl80211_txq_q queue;
482 * struct mgmt_extra_ie_params - Extra management frame IE parameters
484 * Used to add extra IE(s) into management frames. If the driver cannot add the
485 * requested data into all management frames of the specified subtype that are
486 * generated in kernel or firmware/hardware, it must reject the configuration
487 * call. The IE data buffer is added to the end of the specified management
488 * frame body after all other IEs. This addition is not applied to frames that
489 * are injected through a monitor interface.
491 * @subtype: Management frame subtype
492 * @ies: IE data buffer or %NULL to remove previous data
493 * @ies_len: Length of @ies in octets
495 struct mgmt_extra_ie_params {
501 /* from net/wireless.h */
504 /* from net/ieee80211.h */
505 struct ieee80211_channel;
508 * struct cfg80211_ops - backend description for wireless configuration
510 * This struct is registered by fullmac card drivers and/or wireless stacks
511 * in order to handle configuration requests on their interfaces.
513 * All callbacks except where otherwise noted should return 0
514 * on success or a negative error code.
516 * All operations are currently invoked under rtnl for consistency with the
517 * wireless extensions but this is subject to reevaluation as soon as this
518 * code is used more widely and we have a first user without wext.
520 * @suspend: wiphy device needs to be suspended
521 * @resume: wiphy device needs to be resumed
523 * @add_virtual_intf: create a new virtual interface with the given name,
524 * must set the struct wireless_dev's iftype.
526 * @del_virtual_intf: remove the virtual interface determined by ifindex.
528 * @change_virtual_intf: change type/configuration of virtual interface,
529 * keep the struct wireless_dev's iftype updated.
531 * @add_key: add a key with the given parameters. @mac_addr will be %NULL
532 * when adding a group key.
534 * @get_key: get information about the key with the given parameters.
535 * @mac_addr will be %NULL when requesting information for a group
536 * key. All pointers given to the @callback function need not be valid
539 * @del_key: remove a key given the @mac_addr (%NULL for a group key)
542 * @set_default_key: set the default key on an interface
544 * @set_default_mgmt_key: set the default management frame key on an interface
546 * @add_beacon: Add a beacon with given parameters, @head, @interval
547 * and @dtim_period will be valid, @tail is optional.
548 * @set_beacon: Change the beacon parameters for an access point mode
549 * interface. This should reject the call when no beacon has been
551 * @del_beacon: Remove beacon configuration and stop sending the beacon.
553 * @add_station: Add a new station.
555 * @del_station: Remove a station; @mac may be NULL to remove all stations.
557 * @change_station: Modify a given station.
559 * @get_mesh_params: Put the current mesh parameters into *params
561 * @set_mesh_params: Set mesh parameters.
562 * The mask is a bitfield which tells us which parameters to
563 * set, and which to leave alone.
565 * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
567 * @change_bss: Modify parameters for a given BSS.
569 * @set_txq_params: Set TX queue parameters
571 * @set_channel: Set channel
573 * @set_mgmt_extra_ie: Set extra IE data for management frames
575 struct cfg80211_ops {
576 int (*suspend)(struct wiphy *wiphy);
577 int (*resume)(struct wiphy *wiphy);
579 int (*add_virtual_intf)(struct wiphy *wiphy, char *name,
580 enum nl80211_iftype type, u32 *flags,
581 struct vif_params *params);
582 int (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
583 int (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
584 enum nl80211_iftype type, u32 *flags,
585 struct vif_params *params);
587 int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
588 u8 key_index, u8 *mac_addr,
589 struct key_params *params);
590 int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
591 u8 key_index, u8 *mac_addr, void *cookie,
592 void (*callback)(void *cookie, struct key_params*));
593 int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
594 u8 key_index, u8 *mac_addr);
595 int (*set_default_key)(struct wiphy *wiphy,
596 struct net_device *netdev,
598 int (*set_default_mgmt_key)(struct wiphy *wiphy,
599 struct net_device *netdev,
602 int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
603 struct beacon_parameters *info);
604 int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
605 struct beacon_parameters *info);
606 int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
609 int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
610 u8 *mac, struct station_parameters *params);
611 int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
613 int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
614 u8 *mac, struct station_parameters *params);
615 int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
616 u8 *mac, struct station_info *sinfo);
617 int (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
618 int idx, u8 *mac, struct station_info *sinfo);
620 int (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
621 u8 *dst, u8 *next_hop);
622 int (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
624 int (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
625 u8 *dst, u8 *next_hop);
626 int (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
627 u8 *dst, u8 *next_hop,
628 struct mpath_info *pinfo);
629 int (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
630 int idx, u8 *dst, u8 *next_hop,
631 struct mpath_info *pinfo);
632 int (*get_mesh_params)(struct wiphy *wiphy,
633 struct net_device *dev,
634 struct mesh_config *conf);
635 int (*set_mesh_params)(struct wiphy *wiphy,
636 struct net_device *dev,
637 const struct mesh_config *nconf, u32 mask);
638 int (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
639 struct bss_parameters *params);
641 int (*set_txq_params)(struct wiphy *wiphy,
642 struct ieee80211_txq_params *params);
644 int (*set_channel)(struct wiphy *wiphy,
645 struct ieee80211_channel *chan,
646 enum nl80211_channel_type channel_type);
648 int (*set_mgmt_extra_ie)(struct wiphy *wiphy,
649 struct net_device *dev,
650 struct mgmt_extra_ie_params *params);
653 /* temporary wext handlers */
654 int cfg80211_wext_giwname(struct net_device *dev,
655 struct iw_request_info *info,
656 char *name, char *extra);
657 int cfg80211_wext_siwmode(struct net_device *dev, struct iw_request_info *info,
658 u32 *mode, char *extra);
659 int cfg80211_wext_giwmode(struct net_device *dev, struct iw_request_info *info,
660 u32 *mode, char *extra);
662 #endif /* __NET_CFG80211_H */