blob: ab4caf63954fae43fb426cf4406450f2a040def1 [file] [log] [blame]
Johannes Berg704232c2007-04-23 12:20:05 -07001#ifndef __NET_CFG80211_H
2#define __NET_CFG80211_H
3
4#include <linux/netlink.h>
5#include <linux/skbuff.h>
Johannes Berg55682962007-09-20 13:09:35 -04006#include <linux/nl80211.h>
Johannes Berg704232c2007-04-23 12:20:05 -07007#include <net/genetlink.h>
8
9/*
10 * 802.11 configuration in-kernel interface
11 *
Johannes Berg55682962007-09-20 13:09:35 -040012 * Copyright 2006, 2007 Johannes Berg <johannes@sipsolutions.net>
Johannes Berg704232c2007-04-23 12:20:05 -070013 */
14
Andy Green179f8312007-07-10 19:29:38 +020015/* Radiotap header iteration
16 * implemented in net/wireless/radiotap.c
17 * docs in Documentation/networking/radiotap-headers.txt
18 */
19/**
20 * struct ieee80211_radiotap_iterator - tracks walk thru present radiotap args
21 * @rtheader: pointer to the radiotap header we are walking through
22 * @max_length: length of radiotap header in cpu byte ordering
23 * @this_arg_index: IEEE80211_RADIOTAP_... index of current arg
24 * @this_arg: pointer to current radiotap arg
25 * @arg_index: internal next argument index
26 * @arg: internal next argument pointer
27 * @next_bitmap: internal pointer to next present u32
28 * @bitmap_shifter: internal shifter for curr u32 bitmap, b0 set == arg present
29 */
30
31struct ieee80211_radiotap_iterator {
32 struct ieee80211_radiotap_header *rtheader;
33 int max_length;
34 int this_arg_index;
35 u8 *this_arg;
36
37 int arg_index;
38 u8 *arg;
39 __le32 *next_bitmap;
40 u32 bitmap_shifter;
41};
42
43extern int ieee80211_radiotap_iterator_init(
44 struct ieee80211_radiotap_iterator *iterator,
45 struct ieee80211_radiotap_header *radiotap_header,
46 int max_length);
47
48extern int ieee80211_radiotap_iterator_next(
49 struct ieee80211_radiotap_iterator *iterator);
50
51
Johannes Berg41ade002007-12-19 02:03:29 +010052 /**
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 */
64struct key_params {
65 u8 *key;
66 u8 *seq;
67 int key_len;
68 int seq_len;
69 u32 cipher;
70};
71
Johannes Berged1b6cc2007-12-19 02:03:32 +010072/**
73 * struct beacon_parameters - beacon parameters
74 *
75 * Used to configure the beacon for an interface.
76 *
77 * @head: head portion of beacon (before TIM IE)
78 * or %NULL if not changed
79 * @tail: tail portion of beacon (after TIM IE)
80 * or %NULL if not changed
81 * @interval: beacon interval or zero if not changed
82 * @dtim_period: DTIM period or zero if not changed
83 * @head_len: length of @head
84 * @tail_len: length of @tail
85 */
86struct beacon_parameters {
87 u8 *head, *tail;
88 int interval, dtim_period;
89 int head_len, tail_len;
90};
91
Johannes Berg5727ef12007-12-19 02:03:34 +010092/**
93 * enum station_flags - station flags
94 *
95 * Station capability flags. Note that these must be the bits
96 * according to the nl80211 flags.
97 *
98 * @STATION_FLAG_CHANGED: station flags were changed
99 * @STATION_FLAG_AUTHORIZED: station is authorized to send frames (802.1X)
100 * @STATION_FLAG_SHORT_PREAMBLE: station is capable of receiving frames
101 * with short preambles
102 * @STATION_FLAG_WME: station is WME/QoS capable
103 */
104enum station_flags {
105 STATION_FLAG_CHANGED = 1<<0,
106 STATION_FLAG_AUTHORIZED = 1<<NL80211_STA_FLAG_AUTHORIZED,
107 STATION_FLAG_SHORT_PREAMBLE = 1<<NL80211_STA_FLAG_SHORT_PREAMBLE,
108 STATION_FLAG_WME = 1<<NL80211_STA_FLAG_WME,
109};
110
111/**
112 * struct station_parameters - station parameters
113 *
114 * Used to change and create a new station.
115 *
116 * @vlan: vlan interface station should belong to
117 * @supported_rates: supported rates in IEEE 802.11 format
118 * (or NULL for no change)
119 * @supported_rates_len: number of supported rates
120 * @station_flags: station flags (see &enum station_flags)
121 * @listen_interval: listen interval or -1 for no change
122 * @aid: AID or zero for no change
123 */
124struct station_parameters {
125 u8 *supported_rates;
126 struct net_device *vlan;
127 u32 station_flags;
128 int listen_interval;
129 u16 aid;
130 u8 supported_rates_len;
131};
132
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100133/**
134 * enum station_stats_flags - station statistics flags
135 *
136 * Used by the driver to indicate which info in &struct station_stats
137 * it has filled in during get_station().
138 *
139 * @STATION_STAT_INACTIVE_TIME: @inactive_time filled
140 * @STATION_STAT_RX_BYTES: @rx_bytes filled
141 * @STATION_STAT_TX_BYTES: @tx_bytes filled
142 */
143enum station_stats_flags {
144 STATION_STAT_INACTIVE_TIME = 1<<0,
145 STATION_STAT_RX_BYTES = 1<<1,
146 STATION_STAT_TX_BYTES = 1<<2,
147};
148
149/**
150 * struct station_stats - station statistics
151 *
152 * Station information filled by driver for get_station().
153 *
154 * @filled: bitflag of flags from &enum station_stats_flags
155 * @inactive_time: time since last station activity (tx/rx) in milliseconds
156 * @rx_bytes: bytes received from this station
157 * @tx_bytes: bytes transmitted to this station
158 */
159struct station_stats {
160 u32 filled;
161 u32 inactive_time;
162 u32 rx_bytes;
163 u32 tx_bytes;
164};
165
Michael Wu66f7ac52008-01-31 19:48:22 +0100166/**
167 * enum monitor_flags - monitor flags
168 *
169 * Monitor interface configuration flags. Note that these must be the bits
170 * according to the nl80211 flags.
171 *
172 * @MONITOR_FLAG_FCSFAIL: pass frames with bad FCS
173 * @MONITOR_FLAG_PLCPFAIL: pass frames with bad PLCP
174 * @MONITOR_FLAG_CONTROL: pass control frames
175 * @MONITOR_FLAG_OTHER_BSS: disable BSSID filtering
176 * @MONITOR_FLAG_COOK_FRAMES: report frames after processing
177 */
178enum monitor_flags {
179 MONITOR_FLAG_FCSFAIL = 1<<NL80211_MNTR_FLAG_FCSFAIL,
180 MONITOR_FLAG_PLCPFAIL = 1<<NL80211_MNTR_FLAG_PLCPFAIL,
181 MONITOR_FLAG_CONTROL = 1<<NL80211_MNTR_FLAG_CONTROL,
182 MONITOR_FLAG_OTHER_BSS = 1<<NL80211_MNTR_FLAG_OTHER_BSS,
183 MONITOR_FLAG_COOK_FRAMES = 1<<NL80211_MNTR_FLAG_COOK_FRAMES,
184};
185
Johannes Berg704232c2007-04-23 12:20:05 -0700186/* from net/wireless.h */
187struct wiphy;
188
189/**
190 * struct cfg80211_ops - backend description for wireless configuration
191 *
192 * This struct is registered by fullmac card drivers and/or wireless stacks
193 * in order to handle configuration requests on their interfaces.
194 *
195 * All callbacks except where otherwise noted should return 0
196 * on success or a negative error code.
197 *
Johannes Berg43fb45cb2007-04-24 14:07:27 -0700198 * All operations are currently invoked under rtnl for consistency with the
199 * wireless extensions but this is subject to reevaluation as soon as this
200 * code is used more widely and we have a first user without wext.
201 *
Johannes Berg704232c2007-04-23 12:20:05 -0700202 * @add_virtual_intf: create a new virtual interface with the given name
203 *
204 * @del_virtual_intf: remove the virtual interface determined by ifindex.
Johannes Berg55682962007-09-20 13:09:35 -0400205 *
206 * @change_virtual_intf: change type of virtual interface
207 *
Johannes Berg41ade002007-12-19 02:03:29 +0100208 * @add_key: add a key with the given parameters. @mac_addr will be %NULL
209 * when adding a group key.
210 *
211 * @get_key: get information about the key with the given parameters.
212 * @mac_addr will be %NULL when requesting information for a group
213 * key. All pointers given to the @callback function need not be valid
214 * after it returns.
215 *
216 * @del_key: remove a key given the @mac_addr (%NULL for a group key)
217 * and @key_index
218 *
219 * @set_default_key: set the default key on an interface
Johannes Berged1b6cc2007-12-19 02:03:32 +0100220 *
221 * @add_beacon: Add a beacon with given parameters, @head, @interval
222 * and @dtim_period will be valid, @tail is optional.
223 * @set_beacon: Change the beacon parameters for an access point mode
224 * interface. This should reject the call when no beacon has been
225 * configured.
226 * @del_beacon: Remove beacon configuration and stop sending the beacon.
Johannes Berg5727ef12007-12-19 02:03:34 +0100227 *
228 * @add_station: Add a new station.
229 *
230 * @del_station: Remove a station; @mac may be NULL to remove all stations.
231 *
232 * @change_station: Modify a given station.
Johannes Berg704232c2007-04-23 12:20:05 -0700233 */
234struct cfg80211_ops {
235 int (*add_virtual_intf)(struct wiphy *wiphy, char *name,
Michael Wu66f7ac52008-01-31 19:48:22 +0100236 enum nl80211_iftype type, u32 *flags);
Johannes Berg704232c2007-04-23 12:20:05 -0700237 int (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
Johannes Berg55682962007-09-20 13:09:35 -0400238 int (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
Michael Wu66f7ac52008-01-31 19:48:22 +0100239 enum nl80211_iftype type, u32 *flags);
Johannes Berg41ade002007-12-19 02:03:29 +0100240
241 int (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
242 u8 key_index, u8 *mac_addr,
243 struct key_params *params);
244 int (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
245 u8 key_index, u8 *mac_addr, void *cookie,
246 void (*callback)(void *cookie, struct key_params*));
247 int (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
248 u8 key_index, u8 *mac_addr);
249 int (*set_default_key)(struct wiphy *wiphy,
250 struct net_device *netdev,
251 u8 key_index);
Johannes Berged1b6cc2007-12-19 02:03:32 +0100252
253 int (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
254 struct beacon_parameters *info);
255 int (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
256 struct beacon_parameters *info);
257 int (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
Johannes Berg5727ef12007-12-19 02:03:34 +0100258
259
260 int (*add_station)(struct wiphy *wiphy, struct net_device *dev,
261 u8 *mac, struct station_parameters *params);
262 int (*del_station)(struct wiphy *wiphy, struct net_device *dev,
263 u8 *mac);
264 int (*change_station)(struct wiphy *wiphy, struct net_device *dev,
265 u8 *mac, struct station_parameters *params);
Johannes Bergfd5b74d2007-12-19 02:03:36 +0100266 int (*get_station)(struct wiphy *wiphy, struct net_device *dev,
267 u8 *mac, struct station_stats *stats);
Johannes Berg704232c2007-04-23 12:20:05 -0700268};
269
270#endif /* __NET_CFG80211_H */