cfg80211/nl80211: introduce key handling
[linux-2.6.git] / 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 /* 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 /* from net/wireless.h */
73 struct wiphy;
74
75 /**
76  * struct cfg80211_ops - backend description for wireless configuration
77  *
78  * This struct is registered by fullmac card drivers and/or wireless stacks
79  * in order to handle configuration requests on their interfaces.
80  *
81  * All callbacks except where otherwise noted should return 0
82  * on success or a negative error code.
83  *
84  * All operations are currently invoked under rtnl for consistency with the
85  * wireless extensions but this is subject to reevaluation as soon as this
86  * code is used more widely and we have a first user without wext.
87  *
88  * @add_virtual_intf: create a new virtual interface with the given name
89  *
90  * @del_virtual_intf: remove the virtual interface determined by ifindex.
91  *
92  * @change_virtual_intf: change type of virtual interface
93  *
94  * @add_key: add a key with the given parameters. @mac_addr will be %NULL
95  *      when adding a group key.
96  *
97  * @get_key: get information about the key with the given parameters.
98  *      @mac_addr will be %NULL when requesting information for a group
99  *      key. All pointers given to the @callback function need not be valid
100  *      after it returns.
101  *
102  * @del_key: remove a key given the @mac_addr (%NULL for a group key)
103  *      and @key_index
104  *
105  * @set_default_key: set the default key on an interface
106  */
107 struct cfg80211_ops {
108         int     (*add_virtual_intf)(struct wiphy *wiphy, char *name,
109                                     enum nl80211_iftype type);
110         int     (*del_virtual_intf)(struct wiphy *wiphy, int ifindex);
111         int     (*change_virtual_intf)(struct wiphy *wiphy, int ifindex,
112                                        enum nl80211_iftype type);
113
114         int     (*add_key)(struct wiphy *wiphy, struct net_device *netdev,
115                            u8 key_index, u8 *mac_addr,
116                            struct key_params *params);
117         int     (*get_key)(struct wiphy *wiphy, struct net_device *netdev,
118                            u8 key_index, u8 *mac_addr, void *cookie,
119                            void (*callback)(void *cookie, struct key_params*));
120         int     (*del_key)(struct wiphy *wiphy, struct net_device *netdev,
121                            u8 key_index, u8 *mac_addr);
122         int     (*set_default_key)(struct wiphy *wiphy,
123                                    struct net_device *netdev,
124                                    u8 key_index);
125 };
126
127 #endif /* __NET_CFG80211_H */