1 /* 2 * hostapd / EAP method registration 3 * Copyright (c) 2004-2006, Jouni Malinen <j (at) w1.fi> 4 * 5 * This program is free software; you can redistribute it and/or modify 6 * it under the terms of the GNU General Public License version 2 as 7 * published by the Free Software Foundation. 8 * 9 * Alternatively, this software may be distributed under the terms of BSD 10 * license. 11 * 12 * See README and COPYING for more details. 13 */ 14 15 #include "includes.h" 16 17 #include "common.h" 18 #include "eap_i.h" 19 #include "eap_methods.h" 20 21 22 static struct eap_method *eap_methods; 23 24 25 /** 26 * eap_server_get_eap_method - Get EAP method based on type number 27 * @vendor: EAP Vendor-Id (0 = IETF) 28 * @method: EAP type number 29 * Returns: Pointer to EAP method or %NULL if not found 30 */ 31 const struct eap_method * eap_server_get_eap_method(int vendor, EapType method) 32 { 33 struct eap_method *m; 34 for (m = eap_methods; m; m = m->next) { 35 if (m->vendor == vendor && m->method == method) 36 return m; 37 } 38 return NULL; 39 } 40 41 42 /** 43 * eap_server_get_type - Get EAP type for the given EAP method name 44 * @name: EAP method name, e.g., TLS 45 * @vendor: Buffer for returning EAP Vendor-Id 46 * Returns: EAP method type or %EAP_TYPE_NONE if not found 47 * 48 * This function maps EAP type names into EAP type numbers based on the list of 49 * EAP methods included in the build. 50 */ 51 EapType eap_server_get_type(const char *name, int *vendor) 52 { 53 struct eap_method *m; 54 for (m = eap_methods; m; m = m->next) { 55 if (os_strcmp(m->name, name) == 0) { 56 *vendor = m->vendor; 57 return m->method; 58 } 59 } 60 *vendor = EAP_VENDOR_IETF; 61 return EAP_TYPE_NONE; 62 } 63 64 65 /** 66 * eap_server_method_alloc - Allocate EAP server method structure 67 * @version: Version of the EAP server method interface (set to 68 * EAP_SERVER_METHOD_INTERFACE_VERSION) 69 * @vendor: EAP Vendor-ID (EAP_VENDOR_*) (0 = IETF) 70 * @method: EAP type number (EAP_TYPE_*) 71 * @name: Name of the method (e.g., "TLS") 72 * Returns: Allocated EAP method structure or %NULL on failure 73 * 74 * The returned structure should be freed with eap_server_method_free() when it 75 * is not needed anymore. 76 */ 77 struct eap_method * eap_server_method_alloc(int version, int vendor, 78 EapType method, const char *name) 79 { 80 struct eap_method *eap; 81 eap = os_zalloc(sizeof(*eap)); 82 if (eap == NULL) 83 return NULL; 84 eap->version = version; 85 eap->vendor = vendor; 86 eap->method = method; 87 eap->name = name; 88 return eap; 89 } 90 91 92 /** 93 * eap_server_method_free - Free EAP server method structure 94 * @method: Method structure allocated with eap_server_method_alloc() 95 */ 96 void eap_server_method_free(struct eap_method *method) 97 { 98 os_free(method); 99 } 100 101 102 /** 103 * eap_server_method_register - Register an EAP server method 104 * @method: EAP method to register 105 * Returns: 0 on success, -1 on invalid method, or -2 if a matching EAP method 106 * has already been registered 107 * 108 * Each EAP server method needs to call this function to register itself as a 109 * supported EAP method. 110 */ 111 int eap_server_method_register(struct eap_method *method) 112 { 113 struct eap_method *m, *last = NULL; 114 115 if (method == NULL || method->name == NULL || 116 method->version != EAP_SERVER_METHOD_INTERFACE_VERSION) 117 return -1; 118 119 for (m = eap_methods; m; m = m->next) { 120 if ((m->vendor == method->vendor && 121 m->method == method->method) || 122 os_strcmp(m->name, method->name) == 0) 123 return -2; 124 last = m; 125 } 126 127 if (last) 128 last->next = method; 129 else 130 eap_methods = method; 131 132 return 0; 133 } 134 135 136 /** 137 * eap_server_register_methods - Register statically linked EAP server methods 138 * Returns: 0 on success, -1 on failure 139 * 140 * This function is called at program initialization to register all EAP server 141 * methods that were linked in statically. 142 */ 143 int eap_server_register_methods(void) 144 { 145 int ret = 0; 146 147 if (ret == 0) { 148 int eap_server_identity_register(void); 149 ret = eap_server_identity_register(); 150 } 151 152 #ifdef EAP_MD5 153 if (ret == 0) { 154 int eap_server_md5_register(void); 155 ret = eap_server_md5_register(); 156 } 157 #endif /* EAP_MD5 */ 158 159 #ifdef EAP_TLS 160 if (ret == 0) { 161 int eap_server_tls_register(void); 162 ret = eap_server_tls_register(); 163 } 164 #endif /* EAP_TLS */ 165 166 #ifdef EAP_MSCHAPv2 167 if (ret == 0) { 168 int eap_server_mschapv2_register(void); 169 ret = eap_server_mschapv2_register(); 170 } 171 #endif /* EAP_MSCHAPv2 */ 172 173 #ifdef EAP_PEAP 174 if (ret == 0) { 175 int eap_server_peap_register(void); 176 ret = eap_server_peap_register(); 177 } 178 #endif /* EAP_PEAP */ 179 180 #ifdef EAP_TLV 181 if (ret == 0) { 182 int eap_server_tlv_register(void); 183 ret = eap_server_tlv_register(); 184 } 185 #endif /* EAP_TLV */ 186 187 #ifdef EAP_GTC 188 if (ret == 0) { 189 int eap_server_gtc_register(void); 190 ret = eap_server_gtc_register(); 191 } 192 #endif /* EAP_GTC */ 193 194 #ifdef EAP_TTLS 195 if (ret == 0) { 196 int eap_server_ttls_register(void); 197 ret = eap_server_ttls_register(); 198 } 199 #endif /* EAP_TTLS */ 200 201 #ifdef EAP_SIM 202 if (ret == 0) { 203 int eap_server_sim_register(void); 204 ret = eap_server_sim_register(); 205 } 206 #endif /* EAP_SIM */ 207 208 #ifdef EAP_AKA 209 if (ret == 0) { 210 int eap_server_aka_register(void); 211 ret = eap_server_aka_register(); 212 } 213 #endif /* EAP_AKA */ 214 215 #ifdef EAP_AKA_PRIME 216 if (ret == 0) { 217 int eap_server_aka_prime_register(void); 218 ret = eap_server_aka_prime_register(); 219 } 220 #endif /* EAP_AKA_PRIME */ 221 222 #ifdef EAP_PAX 223 if (ret == 0) { 224 int eap_server_pax_register(void); 225 ret = eap_server_pax_register(); 226 } 227 #endif /* EAP_PAX */ 228 229 #ifdef EAP_PSK 230 if (ret == 0) { 231 int eap_server_psk_register(void); 232 ret = eap_server_psk_register(); 233 } 234 #endif /* EAP_PSK */ 235 236 #ifdef EAP_SAKE 237 if (ret == 0) { 238 int eap_server_sake_register(void); 239 ret = eap_server_sake_register(); 240 } 241 #endif /* EAP_SAKE */ 242 243 #ifdef EAP_GPSK 244 if (ret == 0) { 245 int eap_server_gpsk_register(void); 246 ret = eap_server_gpsk_register(); 247 } 248 #endif /* EAP_GPSK */ 249 250 #ifdef EAP_VENDOR_TEST 251 if (ret == 0) { 252 int eap_server_vendor_test_register(void); 253 ret = eap_server_vendor_test_register(); 254 } 255 #endif /* EAP_VENDOR_TEST */ 256 257 #ifdef EAP_FAST 258 if (ret == 0) { 259 int eap_server_fast_register(void); 260 ret = eap_server_fast_register(); 261 } 262 #endif /* EAP_FAST */ 263 264 #ifdef EAP_WSC 265 if (ret == 0) { 266 int eap_server_wsc_register(void); 267 ret = eap_server_wsc_register(); 268 } 269 #endif /* EAP_WSC */ 270 271 #ifdef EAP_IKEV2 272 if (ret == 0) { 273 int eap_server_ikev2_register(void); 274 ret = eap_server_ikev2_register(); 275 } 276 #endif /* EAP_IKEV2 */ 277 278 #ifdef EAP_TNC 279 if (ret == 0) { 280 int eap_server_tnc_register(void); 281 ret = eap_server_tnc_register(); 282 } 283 #endif /* EAP_TNC */ 284 285 return ret; 286 } 287 288 289 /** 290 * eap_server_unregister_methods - Unregister EAP server methods 291 * 292 * This function is called at program termination to unregister all EAP server 293 * methods. 294 */ 295 void eap_server_unregister_methods(void) 296 { 297 struct eap_method *m; 298 299 while (eap_methods) { 300 m = eap_methods; 301 eap_methods = eap_methods->next; 302 303 if (m->free) 304 m->free(m); 305 else 306 eap_server_method_free(m); 307 } 308 } 309