Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  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 /* 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 
 31 struct 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 
 43 extern int ieee80211_radiotap_iterator_init(
 44    struct ieee80211_radiotap_iterator *iterator,
 45    struct ieee80211_radiotap_header *radiotap_header,
 46    int max_length);
 47 
 48 extern int ieee80211_radiotap_iterator_next(
 49    struct ieee80211_radiotap_iterator *iterator);
 50 
 51 
 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 /**
 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  */
 86 struct beacon_parameters {
 87         u8 *head, *tail;
 88         int interval, dtim_period;
 89         int head_len, tail_len;
 90 };
 91 
 92 /**
 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  */
104 enum 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  */
124 struct 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 
133 /**
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  */
143 enum 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  */
159 struct station_stats {
160         u32 filled;
161         u32 inactive_time;
162         u32 rx_bytes;
163         u32 tx_bytes;
164 };
165 
166 /* from net/wireless.h */
167 struct wiphy;
168 
169 /**
170  * struct cfg80211_ops - backend description for wireless configuration
171  *
172  * This struct is registered by fullmac card drivers and/or wireless stacks
173  * in order to handle configuration requests on their interfaces.
174  *
175  * All callbacks except where otherwise noted should return 0
176  * on success or a negative error code.
177  *
178  * All operations are currently invoked under rtnl for consistency with the
179  * wireless extensions but this is subject to reevaluation as soon as this
180  * code is used more widely and we have a first user without wext.
181  *
182  * @add_virtual_intf: create a new virtual interface with the given name
183  *
184  * @del_virtual_intf: remove the virtual interface determined by ifindex.
185  *
186  * @change_virtual_intf: change type of virtual interface
187  *
188  * @add_key: add a key with the given parameters. @mac_addr will be %NULL
189  *      when adding a group key.
190  *
191  * @get_key: get information about the key with the given parameters.
192  *      @mac_addr will be %NULL when requesting information for a group
193  *      key. All pointers given to the @callback function need not be valid
194  *      after it returns.
195  *
196  * @del_key: remove a key given the @mac_addr (%NULL for a group key)
197  *      and @key_index
198  *
199  * @set_default_key: set the default key on an interface
200  *
201  * @add_beacon: Add a beacon with given parameters, @head, @interval
202  *      and @dtim_period will be valid, @tail is optional.
203  * @set_beacon: Change the beacon parameters for an access point mode
204  *      interface. This should reject the call when no beacon has been
205  *      configured.
206  * @del_beacon: Remove beacon configuration and stop sending the beacon.
207  *
208  * @add_station: Add a new station.
209  *
210  * @del_station: Remove a station; @mac may be NULL to remove all stations.
211  *
212  * @change_station: Modify a given station.
213  */
214 struct cfg80211_ops {
215         int     (*add_virtual_intf)(struct wiphy *wiphy, char *name,
216                                     enum nl80211_iftype type);
217         int     (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
218         int     (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
219                                        enum nl80211_iftype type);
220 
221         int     (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
222                            u8 key_index, u8 *mac_addr,
223                            struct key_params *params);
224         int     (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
225                            u8 key_index, u8 *mac_addr, void *cookie,
226                            void (*callback)(void *cookie, struct key_params*));
227         int     (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
228                            u8 key_index, u8 *mac_addr);
229         int     (*set_default_key)(struct wiphy *wiphy,
230                                    struct net_device *netdev,
231                                    u8 key_index);
232 
233         int     (*add_beacon)(struct wiphy *wiphy, struct net_device *dev,
234                               struct beacon_parameters *info);
235         int     (*set_beacon)(struct wiphy *wiphy, struct net_device *dev,
236                               struct beacon_parameters *info);
237         int     (*del_beacon)(struct wiphy *wiphy, struct net_device *dev);
238 
239 
240         int     (*add_station)(struct wiphy *wiphy, struct net_device *dev,
241                                u8 *mac, struct station_parameters *params);
242         int     (*del_station)(struct wiphy *wiphy, struct net_device *dev,
243                                u8 *mac);
244         int     (*change_station)(struct wiphy *wiphy, struct net_device *dev,
245                                   u8 *mac, struct station_parameters *params);
246         int     (*get_station)(struct wiphy *wiphy, struct net_device *dev,
247                                u8 *mac, struct station_stats *stats);
248 };
249 
250 #endif /* __NET_CFG80211_H */
251 
  This page was automatically generated by the LXR engine.