1 /* 2 * EAP server method registration 3 * Copyright (c) 2004-2009, Jouni Malinen <j@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_unregister_methods - Unregister EAP server methods 138 * 139 * This function is called at program termination to unregister all EAP server 140 * methods. 141 */ 142 void eap_server_unregister_methods(void) 143 { 144 struct eap_method *m; 145 146 while (eap_methods) { 147 m = eap_methods; 148 eap_methods = eap_methods->next; 149 150 if (m->free) 151 m->free(m); 152 else 153 eap_server_method_free(m); 154 } 155 } 156 157 158 /** 159 * eap_server_get_name - Get EAP method name for the given EAP type 160 * @vendor: EAP Vendor-Id (0 = IETF) 161 * @type: EAP method type 162 * Returns: EAP method name, e.g., TLS, or %NULL if not found 163 * 164 * This function maps EAP type numbers into EAP type names based on the list of 165 * EAP methods included in the build. 166 */ 167 const char * eap_server_get_name(int vendor, EapType type) 168 { 169 struct eap_method *m; 170 for (m = eap_methods; m; m = m->next) { 171 if (m->vendor == vendor && m->method == type) 172 return m->name; 173 } 174 return NULL; 175 } 176