include/net/cfg80211.h

   1 #ifndef __NET_CFG80211_H
   2 #define __NET_CFG80211_H
   3
   4 #include <linux/netlink.h>
   5 #include <linux/skbuff.h>
   6 #include <linux/nl80211.h>
   7 #include <net/genetlink.h>
   8
   9 /*
  10  * 802.11 configuration in-kernel interface
  11  *
  12  * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
  13  */
  14
  15 /**
  16  * struct vif_params - describes virtual interface parameters
  17  * @mesh_id: mesh ID to use
  18  * @mesh_id_len: length of the mesh ID
  19  */
  20 struct vif_params {
  21        u8 *mesh_id;
  22        int mesh_id_len;
  23 };
  24
  25 /* Radiotap header iteration
  26  *   implemented in net/wireless/radiotap.c
  27  *   docs in Documentation/networking/radiotap-headers.txt
  28  */
  29 /**
  30  * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
  31  * @rtheader: pointer to the radiotap header we are walking through
  32  * @max_length: length of radiotap header in cpu byte ordering
  33  * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
  34  * @this_arg: pointer to current radiotap arg
  35  * @arg_index: internal next argument index
  36  * @arg: internal next argument pointer
  37  * @next_bitmap: internal pointer to next present u32
  38  * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
  39  */
  40
  41 struct ieee80211_radiotap_iterator {
  42         struct ieee80211_radiotap_header *rtheader;
  43         int max_length;
  44         int this_arg_index;
  45         u8 *this_arg;
  46
  47         int arg_index;
  48         u8 *arg;
  49         __le32 *next_bitmap;
  50         u32 bitmap_shifter;
  51 };
  52
  53 extern int ieee80211_radiotap_iterator_init(
  54    struct ieee80211_radiotap_iterator *iterator,
  55    struct ieee80211_radiotap_header *radiotap_header,
  56    int max_length);
  57
  58 extern int ieee80211_radiotap_iterator_next(
  59    struct ieee80211_radiotap_iterator *iterator);
  60
  61
  62  /**
  63  * struct key_params - key information
  64  *
  65  * Information about a key
  66  *
  67  * @key: key material
  68  * @key_len: length of key material
  69  * @cipher: cipher suite selector
  70  * @seq: sequence counter (IV/PN) for TKIP and CCMP keys, only used
  71  *      with the get_key() callback, must be in little endian,
  72  *      length given by @seq_len.
  73  */
  74 struct key_params {
  75         u8 *key;
  76         u8 *seq;
  77         int key_len;
  78         int seq_len;
  79         u32 cipher;
  80 };
  81
  82 /**
  83  * struct beacon_parameters - beacon parameters
  84  *
  85  * Used to configure the beacon for an interface.
  86  *
  87  * @head: head portion of beacon (before TIM IE)
  88  *     or %NULL if not changed
  89  * @tail: tail portion of beacon (after TIM IE)
  90  *     or %NULL if not changed
  91  * @interval: beacon interval or zero if not changed
  92  * @dtim_period: DTIM period or zero if not changed
  93  * @head_len: length of @head
  94  * @tail_len: length of @tail
  95  */
  96 struct beacon_parameters {
  97         u8 *head, *tail;
  98         int interval, dtim_period;
  99         int head_len, tail_len;
 100 };
 101
 102 /**
 103  * enum station_flags - station flags
 104  *
 105  * Station capability flags. Note that these must be the bits
 106  * according to the nl80211 flags.
 107  *
 108  * @STATION_FLAG_CHANGED: station flags were changed
 109  * @STATION_FLAG_AUTHORIZED: station is authorized to send frames (802.1X)
 110  * @STATION_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
 111  *      with short preambles
 112  * @STATION_FLAG_WME: station is WME/QoS capable
 113  */
 114 enum station_flags {
 115         STATION_FLAG_CHANGED            = 1<<0,
 116         STATION_FLAG_AUTHORIZED         = 1<<NL80211_STA_FLAG_AUTHORIZED,
 117         STATION_FLAG_SHORT_PREAMBLE     = 1<<NL80211_STA_FLAG_SHORT_PREAMBLE,
 118         STATION_FLAG_WME                = 1<<NL80211_STA_FLAG_WME,
 119 };
 120
 121 /**
 122  * enum plink_action - actions to perform in mesh peers
 123  *
 124  * @PLINK_ACTION_INVALID: action 0 is reserved
 125  * @PLINK_ACTION_OPEN: start mesh peer link establishment
 126  * @PLINK_ACTION_BLOCL: block traffic from this mesh peer
 127  */
 128 enum plink_actions {
 129         PLINK_ACTION_INVALID,
 130         PLINK_ACTION_OPEN,
 131         PLINK_ACTION_BLOCK,
 132 };
 133
 134 /**
 135  * struct station_parameters - station parameters
 136  *
 137  * Used to change and create a new station.
 138  *
 139  * @vlan: vlan interface station should belong to
 140  * @supported_rates: supported rates in IEEE 802.11 format
 141  *      (or NULL for no change)
 142  * @supported_rates_len: number of supported rates
 143  * @station_flags: station flags (see &enum station_flags)
 144  * @listen_interval: listen interval or -1 for no change
 145  * @aid: AID or zero for no change
 146  */
 147 struct station_parameters {
 148         u8 *supported_rates;
 149         struct net_device *vlan;
 150         u32 station_flags;
 151         int listen_interval;
 152         u16 aid;
 153         u8 supported_rates_len;
 154         u8 plink_action;
 155         struct ieee80211_ht_cap *ht_capa;
 156 };
 157
 158 /**
 159  * enum station_info_flags - station information flags
 160  *
 161  * Used by the driver to indicate which info in &struct station_info
 162  * it has filled in during get_station() or dump_station().
 163  *
 164  * @STATION_INFO_INACTIVE_TIME: @inactive_time filled
 165  * @STATION_INFO_RX_BYTES: @rx_bytes filled
 166  * @STATION_INFO_TX_BYTES: @tx_bytes filled
 167  * @STATION_INFO_LLID: @llid filled
 168  * @STATION_INFO_PLID: @plid filled
 169  * @STATION_INFO_PLINK_STATE: @plink_state filled
 170  */
 171 enum station_info_flags {
 172         STATION_INFO_INACTIVE_TIME      = 1<<0,
 173         STATION_INFO_RX_BYTES           = 1<<1,
 174         STATION_INFO_TX_BYTES           = 1<<2,
 175         STATION_INFO_LLID               = 1<<3,
 176         STATION_INFO_PLID               = 1<<4,
 177         STATION_INFO_PLINK_STATE        = 1<<5,
 178 };
 179
 180 /**
 181  * struct station_info - station information
 182  *
 183  * Station information filled by driver for get_station() and dump_station.
 184  *
 185  * @filled: bitflag of flags from &enum station_info_flags
 186  * @inactive_time: time since last station activity (tx/rx) in milliseconds
 187  * @rx_bytes: bytes received from this station
 188  * @tx_bytes: bytes transmitted to this station
 189  * @llid: mesh local link id
 190  * @plid: mesh peer link id
 191  * @plink_state: mesh peer link state
 192  */
 193 struct station_info {
 194         u32 filled;
 195         u32 inactive_time;
 196         u32 rx_bytes;
 197         u32 tx_bytes;
 198         u16 llid;
 199         u16 plid;
 200         u8 plink_state;
 201 };
 202
 203 /**
 204  * enum monitor_flags - monitor flags
 205  *
 206  * Monitor interface configuration flags. Note that these must be the bits
 207  * according to the nl80211 flags.
 208  *
 209  * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
 210  * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
 211  * @MONITOR_FLAG_CONTROL: pass control frames
 212  * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
 213  * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
 214  */
 215 enum monitor_flags {
 216         MONITOR_FLAG_FCSFAIL            = 1<<NL80211_MNTR_FLAG_FCSFAIL,
 217         MONITOR_FLAG_PLCPFAIL           = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
 218         MONITOR_FLAG_CONTROL            = 1<<NL80211_MNTR_FLAG_CONTROL,
 219         MONITOR_FLAG_OTHER_BSS          = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
 220         MONITOR_FLAG_COOK_FRAMES        = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
 221 };
 222
 223 /**
 224  * enum mpath_info_flags -  mesh path information flags
 225  *
 226  * Used by the driver to indicate which info in &struct mpath_info it has filled
 227  * in during get_station() or dump_station().
 228  *
 229  * MPATH_INFO_FRAME_QLEN: @frame_qlen filled
 230  * MPATH_INFO_DSN: @dsn filled
 231  * MPATH_INFO_METRIC: @metric filled
 232  * MPATH_INFO_EXPTIME: @exptime filled
 233  * MPATH_INFO_DISCOVERY_TIMEOUT: @discovery_timeout filled
 234  * MPATH_INFO_DISCOVERY_RETRIES: @discovery_retries filled
 235  * MPATH_INFO_FLAGS: @flags filled
 236  */
 237 enum mpath_info_flags {
 238         MPATH_INFO_FRAME_QLEN           = BIT(0),
 239         MPATH_INFO_DSN                  = BIT(1),
 240         MPATH_INFO_METRIC               = BIT(2),
 241         MPATH_INFO_EXPTIME              = BIT(3),
 242         MPATH_INFO_DISCOVERY_TIMEOUT    = BIT(4),
 243         MPATH_INFO_DISCOVERY_RETRIES    = BIT(5),
 244         MPATH_INFO_FLAGS                = BIT(6),
 245 };
 246
 247 /**
 248  * struct mpath_info - mesh path information
 249  *
 250  * Mesh path information filled by driver for get_mpath() and dump_mpath().
 251  *
 252  * @filled: bitfield of flags from &enum mpath_info_flags
 253  * @frame_qlen: number of queued frames for this destination
 254  * @dsn: destination sequence number
 255  * @metric: metric (cost) of this mesh path
 256  * @exptime: expiration time for the mesh path from now, in msecs
 257  * @flags: mesh path flags
 258  * @discovery_timeout: total mesh path discovery timeout, in msecs
 259  * @discovery_retries: mesh path discovery retries
 260  */
 261 struct mpath_info {
 262         u32 filled;
 263         u32 frame_qlen;
 264         u32 dsn;
 265         u32 metric;
 266         u32 exptime;
 267         u32 discovery_timeout;
 268         u8 discovery_retries;
 269         u8 flags;
 270 };
 271
 272 /**
 273  * struct bss_parameters - BSS parameters
 274  *
 275  * Used to change BSS parameters (mainly for AP mode).
 276  *
 277  * @use_cts_prot: Whether to use CTS protection
 278  *      (0 = no, 1 = yes, -1 = do not change)
 279  * @use_short_preamble: Whether the use of short preambles is allowed
 280  *      (0 = no, 1 = yes, -1 = do not change)
 281  * @use_short_slot_time: Whether the use of short slot time is allowed
 282  *      (0 = no, 1 = yes, -1 = do not change)
 283  */
 284 struct bss_parameters {
 285         int use_cts_prot;
 286         int use_short_preamble;
 287         int use_short_slot_time;
 288 };
 289
 290 /**
 291  * enum reg_set_by - Indicates who is trying to set the regulatory domain
 292  * @REGDOM_SET_BY_INIT: regulatory domain was set by initialization. We will be
 293  *      using a static world regulatory domain by default.
 294  * @REGDOM_SET_BY_CORE: Core queried CRDA for a dynamic world regulatory domain.
 295  * @REGDOM_SET_BY_USER: User asked the wireless core to set the
 296  *      regulatory domain.
 297  * @REGDOM_SET_BY_DRIVER: a wireless drivers has hinted to the wireless core
 298  *      it thinks its knows the regulatory domain we should be in.
 299  * @REGDOM_SET_BY_COUNTRY_IE: the wireless core has received an 802.11 country
 300  *      information element with regulatory information it thinks we
 301  *      should consider.
 302  */
 303 enum reg_set_by {
 304         REGDOM_SET_BY_INIT,
 305         REGDOM_SET_BY_CORE,
 306         REGDOM_SET_BY_USER,
 307         REGDOM_SET_BY_DRIVER,
 308         REGDOM_SET_BY_COUNTRY_IE,
 309 };
 310
 311 struct ieee80211_freq_range {
 312         u32 start_freq_khz;
 313         u32 end_freq_khz;
 314         u32 max_bandwidth_khz;
 315 };
 316
 317 struct ieee80211_power_rule {
 318         u32 max_antenna_gain;
 319         u32 max_eirp;
 320 };
 321
 322 struct ieee80211_reg_rule {
 323         struct ieee80211_freq_range freq_range;
 324         struct ieee80211_power_rule power_rule;
 325         u32 flags;
 326 };
 327
 328 struct ieee80211_regdomain {
 329         u32 n_reg_rules;
 330         char alpha2[2];
 331         struct ieee80211_reg_rule reg_rules[];
 332 };
 333
 334 #define MHZ_TO_KHZ(freq) (freq * 1000)
 335 #define KHZ_TO_MHZ(freq) (freq / 1000)
 336 #define DBI_TO_MBI(gain) (gain * 100)
 337 #define MBI_TO_DBI(gain) (gain / 100)
 338 #define DBM_TO_MBM(gain) (gain * 100)
 339 #define MBM_TO_DBM(gain) (gain / 100)
 340
 341 #define REG_RULE(start, end, bw, gain, eirp, reg_flags) { \
 342         .freq_range.start_freq_khz = (start) * 1000, \
 343         .freq_range.end_freq_khz = (end) * 1000, \
 344         .freq_range.max_bandwidth_khz = (bw) * 1000, \
 345         .power_rule.max_antenna_gain = (gain) * 100, \
 346         .power_rule.max_eirp = (eirp) * 100, \
 347         .flags = reg_flags, \
 348         }
 349
 350 /* from net/wireless.h */
 351 struct wiphy;
 352
 353 /**
 354  * struct cfg80211_ops - backend description for wireless configuration
 355  *
 356  * This struct is registered by fullmac card drivers and/or wireless stacks
 357  * in order to handle configuration requests on their interfaces.
 358  *
 359  * All callbacks except where otherwise noted should return 0
 360  * on success or a negative error code.
 361  *
 362  * All operations are currently invoked under rtnl for consistency with the
 363  * wireless extensions but this is subject to reevaluation as soon as this
 364  * code is used more widely and we have a first user without wext.
 365  *
 366  * @add_virtual_intf: create a new virtual interface with the given name,
 367  *      must set the struct wireless_dev's iftype.
 368  *
 369  * @del_virtual_intf: remove the virtual interface determined by ifindex.
 370  *
 371  * @change_virtual_intf: change type/configuration of virtual interface,
 372  *      keep the struct wireless_dev's iftype updated.
 373  *
 374  * @add_key: add a key with the given parameters. @mac_addr will be %NULL
 375  *      when adding a group key.
 376  *
 377  * @get_key: get information about the key with the given parameters.
 378  *      @mac_addr will be %NULL when requesting information for a group
 379  *      key. All pointers given to the @callback function need not be valid
 380  *      after it returns.
 381  *
 382  * @del_key: remove a key given the @mac_addr (%NULL for a group key)
 383  *      and @key_index
 384  *
 385  * @set_default_key: set the default key on an interface
 386  *
 387  * @add_beacon: Add a beacon with given parameters, @head, @interval
 388  *      and @dtim_period will be valid, @tail is optional.
 389  * @set_beacon: Change the beacon parameters for an access point mode
 390  *      interface. This should reject the call when no beacon has been
 391  *      configured.
 392  * @del_beacon: Remove beacon configuration and stop sending the beacon.
 393  *
 394  * @add_station: Add a new station.
 395  *
 396  * @del_station: Remove a station; @mac may be NULL to remove all stations.
 397  *
 398  * @change_station: Modify a given station.
 399  *
 400  * @set_mesh_cfg: set mesh parameters (by now, just mesh id)
 401  *
 402  * @change_bss: Modify parameters for a given BSS.
 403  */
 404 struct cfg80211_ops {
 405         int     (*add_virtual_intf)(struct wiphy *wiphy, char *name,
 406                                     enum nl80211_iftype type, u32 *flags,
 407                                     struct vif_params *params);
 408         int     (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
 409         int     (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
 410                                        enum nl80211_iftype type, u32 *flags,
 411                                        struct vif_params *params);
 412
 413         int     (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
 414                            u8 key_index, u8 *mac_addr,
 415                            struct key_params *params);
 416         int     (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
 417                            u8 key_index, u8 *mac_addr, void *cookie,
 418                            void (*callback)(void *cookie, struct key_params*));
 419         int     (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
 420                            u8 key_index, u8 *mac_addr);
 421         int     (*set_default_key)(struct wiphy *wiphy,
 422                                    struct net_device *netdev,
 423                                    u8 key_index);
 424
 425         int     (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
 426                               struct beacon_parameters *info);
 427         int     (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
 428                               struct beacon_parameters *info);
 429         int     (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
 430
 431
 432         int     (*add_station)(struct wiphy *wiphy, struct net_device *dev,
 433                                u8 *mac, struct station_parameters *params);
 434         int     (*del_station)(struct wiphy *wiphy, struct net_device *dev,
 435                                u8 *mac);
 436         int     (*change_station)(struct wiphy *wiphy, struct net_device *dev,
 437                                   u8 *mac, struct station_parameters *params);
 438         int     (*get_station)(struct wiphy *wiphy, struct net_device *dev,
 439                                u8 *mac, struct station_info *sinfo);
 440         int     (*dump_station)(struct wiphy *wiphy, struct net_device *dev,
 441                                int idx, u8 *mac, struct station_info *sinfo);
 442
 443         int     (*add_mpath)(struct wiphy *wiphy, struct net_device *dev,
 444                                u8 *dst, u8 *next_hop);
 445         int     (*del_mpath)(struct wiphy *wiphy, struct net_device *dev,
 446                                u8 *dst);
 447         int     (*change_mpath)(struct wiphy *wiphy, struct net_device *dev,
 448                                   u8 *dst, u8 *next_hop);
 449         int     (*get_mpath)(struct wiphy *wiphy, struct net_device *dev,
 450                                u8 *dst, u8 *next_hop,
 451                                struct mpath_info *pinfo);
 452         int     (*dump_mpath)(struct wiphy *wiphy, struct net_device *dev,
 453                                int idx, u8 *dst, u8 *next_hop,
 454                                struct mpath_info *pinfo);
 455
 456         int     (*change_bss)(struct wiphy *wiphy, struct net_device *dev,
 457                               struct bss_parameters *params);
 458 };
 459
 460 #endif /* __NET_CFG80211_H */