Sync our ieee80211*.9 manual pages with the recent upgrade.
[dragonfly.git] / sys / netproto / 802_11 / wlan_xauth / ieee80211_xauth.c
1 /*
2  * Copyright (c) 2004 Video54 Technologies, Inc.
3  * Copyright (c) 2004-2005 Sam Leffler, Errno Consulting
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  * 3. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission.
16  *
17  * Alternatively, this software may be distributed under the terms of the
18  * GNU General Public License ("GPL") version 2 as published by the Free
19  * Software Foundation.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  * $FreeBSD: src/sys/net80211/ieee80211_xauth.c,v 1.2 2004/12/31 22:42:38 sam Exp $
33  * $DragonFly: src/sys/netproto/802_11/wlan_xauth/ieee80211_xauth.c,v 1.1 2006/05/18 13:51:46 sephe Exp $
34  */
35
36 /*
37  * External authenticator placeholder module.
38  *
39  * This support is optional; it is only used when the 802.11 layer's
40  * authentication mode is set to use 802.1x or WPA is enabled separately
41  * (for WPA-PSK).  If compiled as a module this code does not need
42  * to be present unless 802.1x/WPA is in use.
43  *
44  * The authenticator hooks into the 802.11 layer.  At present we use none
45  * of the available callbacks--the user mode authenticator process works
46  * entirely from messages about stations joining and leaving.
47  */
48 #include <sys/param.h>
49 #include <sys/kernel.h>
50 #include <sys/systm.h> 
51 #include <sys/mbuf.h>   
52 #include <sys/module.h>
53
54 #include <sys/socket.h>
55
56 #include <net/if.h>
57 #include <net/if_arp.h>
58 #include <net/if_media.h>
59 #include <net/ethernet.h>
60 #include <net/route.h>
61
62 #include <netproto/802_11/ieee80211_var.h>
63
64 /*
65  * One module handles everything for now.  May want
66  * to split things up for embedded applications.
67  */
68 static const struct ieee80211_authenticator xauth = {
69         .ia_name        = "external",
70         .ia_attach      = NULL,
71         .ia_detach      = NULL,
72         .ia_node_join   = NULL,
73         .ia_node_leave  = NULL,
74 };
75
76 /*
77  * Module glue.
78  */
79 static int
80 wlan_xauth_modevent(module_t mod, int type, void *unused)
81 {
82         switch (type) {
83         case MOD_LOAD:
84                 ieee80211_authenticator_register(IEEE80211_AUTH_8021X, &xauth);
85                 ieee80211_authenticator_register(IEEE80211_AUTH_WPA, &xauth);
86                 return 0;
87         case MOD_UNLOAD:
88                 ieee80211_authenticator_unregister(IEEE80211_AUTH_8021X);
89                 ieee80211_authenticator_unregister(IEEE80211_AUTH_WPA);
90                 return 0;
91         }
92         return EINVAL;
93 }
94
95 static moduledata_t wlan_xauth_mod = {
96         "wlan_xauth",
97         wlan_xauth_modevent,
98         0
99 };
100 DECLARE_MODULE(wlan_xauth, wlan_xauth_mod, SI_SUB_DRIVERS, SI_ORDER_FIRST);
101 MODULE_VERSION(wlan_xauth, 1);
102 MODULE_DEPEND(wlan_xauth, wlan, 1, 1, 1);