1214501Srpaulo/* 2214501Srpaulo * EAP server method registration 3214501Srpaulo * Copyright (c) 2004-2009, Jouni Malinen <j@w1.fi> 4214501Srpaulo * 5252726Srpaulo * This software may be distributed under the terms of the BSD license. 6252726Srpaulo * See README for more details. 7214501Srpaulo */ 8214501Srpaulo 9214501Srpaulo#include "includes.h" 10214501Srpaulo 11214501Srpaulo#include "common.h" 12214501Srpaulo#include "eap_i.h" 13214501Srpaulo#include "eap_methods.h" 14214501Srpaulo 15214501Srpaulo 16214501Srpaulostatic struct eap_method *eap_methods; 17214501Srpaulo 18214501Srpaulo 19214501Srpaulo/** 20214501Srpaulo * eap_server_get_eap_method - Get EAP method based on type number 21214501Srpaulo * @vendor: EAP Vendor-Id (0 = IETF) 22214501Srpaulo * @method: EAP type number 23214501Srpaulo * Returns: Pointer to EAP method or %NULL if not found 24214501Srpaulo */ 25214501Srpauloconst struct eap_method * eap_server_get_eap_method(int vendor, EapType method) 26214501Srpaulo{ 27214501Srpaulo struct eap_method *m; 28214501Srpaulo for (m = eap_methods; m; m = m->next) { 29214501Srpaulo if (m->vendor == vendor && m->method == method) 30214501Srpaulo return m; 31214501Srpaulo } 32214501Srpaulo return NULL; 33214501Srpaulo} 34214501Srpaulo 35214501Srpaulo 36214501Srpaulo/** 37214501Srpaulo * eap_server_get_type - Get EAP type for the given EAP method name 38214501Srpaulo * @name: EAP method name, e.g., TLS 39214501Srpaulo * @vendor: Buffer for returning EAP Vendor-Id 40214501Srpaulo * Returns: EAP method type or %EAP_TYPE_NONE if not found 41214501Srpaulo * 42214501Srpaulo * This function maps EAP type names into EAP type numbers based on the list of 43214501Srpaulo * EAP methods included in the build. 44214501Srpaulo */ 45214501SrpauloEapType eap_server_get_type(const char *name, int *vendor) 46214501Srpaulo{ 47214501Srpaulo struct eap_method *m; 48214501Srpaulo for (m = eap_methods; m; m = m->next) { 49214501Srpaulo if (os_strcmp(m->name, name) == 0) { 50214501Srpaulo *vendor = m->vendor; 51214501Srpaulo return m->method; 52214501Srpaulo } 53214501Srpaulo } 54214501Srpaulo *vendor = EAP_VENDOR_IETF; 55214501Srpaulo return EAP_TYPE_NONE; 56214501Srpaulo} 57214501Srpaulo 58214501Srpaulo 59214501Srpaulo/** 60214501Srpaulo * eap_server_method_alloc - Allocate EAP server method structure 61214501Srpaulo * @version: Version of the EAP server method interface (set to 62214501Srpaulo * EAP_SERVER_METHOD_INTERFACE_VERSION) 63214501Srpaulo * @vendor: EAP Vendor-ID (EAP_VENDOR_*) (0 = IETF) 64214501Srpaulo * @method: EAP type number (EAP_TYPE_*) 65214501Srpaulo * @name: Name of the method (e.g., "TLS") 66214501Srpaulo * Returns: Allocated EAP method structure or %NULL on failure 67214501Srpaulo * 68214501Srpaulo * The returned structure should be freed with eap_server_method_free() when it 69214501Srpaulo * is not needed anymore. 70214501Srpaulo */ 71214501Srpaulostruct eap_method * eap_server_method_alloc(int version, int vendor, 72214501Srpaulo EapType method, const char *name) 73214501Srpaulo{ 74214501Srpaulo struct eap_method *eap; 75214501Srpaulo eap = os_zalloc(sizeof(*eap)); 76214501Srpaulo if (eap == NULL) 77214501Srpaulo return NULL; 78214501Srpaulo eap->version = version; 79214501Srpaulo eap->vendor = vendor; 80214501Srpaulo eap->method = method; 81214501Srpaulo eap->name = name; 82214501Srpaulo return eap; 83214501Srpaulo} 84214501Srpaulo 85214501Srpaulo 86214501Srpaulo/** 87214501Srpaulo * eap_server_method_free - Free EAP server method structure 88214501Srpaulo * @method: Method structure allocated with eap_server_method_alloc() 89214501Srpaulo */ 90337817Scystatic void eap_server_method_free(struct eap_method *method) 91214501Srpaulo{ 92214501Srpaulo os_free(method); 93214501Srpaulo} 94214501Srpaulo 95214501Srpaulo 96214501Srpaulo/** 97214501Srpaulo * eap_server_method_register - Register an EAP server method 98337817Scy * @method: EAP method to register from eap_server_method_alloc() 99214501Srpaulo * Returns: 0 on success, -1 on invalid method, or -2 if a matching EAP method 100214501Srpaulo * has already been registered 101214501Srpaulo * 102214501Srpaulo * Each EAP server method needs to call this function to register itself as a 103337817Scy * supported EAP method. The caller must not free the allocated method data 104337817Scy * regardless of the return value. 105214501Srpaulo */ 106214501Srpauloint eap_server_method_register(struct eap_method *method) 107214501Srpaulo{ 108214501Srpaulo struct eap_method *m, *last = NULL; 109214501Srpaulo 110214501Srpaulo if (method == NULL || method->name == NULL || 111337817Scy method->version != EAP_SERVER_METHOD_INTERFACE_VERSION) { 112337817Scy eap_server_method_free(method); 113214501Srpaulo return -1; 114337817Scy } 115214501Srpaulo 116214501Srpaulo for (m = eap_methods; m; m = m->next) { 117214501Srpaulo if ((m->vendor == method->vendor && 118214501Srpaulo m->method == method->method) || 119337817Scy os_strcmp(m->name, method->name) == 0) { 120337817Scy eap_server_method_free(method); 121214501Srpaulo return -2; 122337817Scy } 123214501Srpaulo last = m; 124214501Srpaulo } 125214501Srpaulo 126214501Srpaulo if (last) 127214501Srpaulo last->next = method; 128214501Srpaulo else 129214501Srpaulo eap_methods = method; 130214501Srpaulo 131214501Srpaulo return 0; 132214501Srpaulo} 133214501Srpaulo 134214501Srpaulo 135214501Srpaulo/** 136214501Srpaulo * eap_server_unregister_methods - Unregister EAP server methods 137214501Srpaulo * 138214501Srpaulo * This function is called at program termination to unregister all EAP server 139214501Srpaulo * methods. 140214501Srpaulo */ 141214501Srpaulovoid eap_server_unregister_methods(void) 142214501Srpaulo{ 143214501Srpaulo struct eap_method *m; 144214501Srpaulo 145214501Srpaulo while (eap_methods) { 146214501Srpaulo m = eap_methods; 147214501Srpaulo eap_methods = eap_methods->next; 148214501Srpaulo 149214501Srpaulo if (m->free) 150214501Srpaulo m->free(m); 151214501Srpaulo else 152214501Srpaulo eap_server_method_free(m); 153214501Srpaulo } 154214501Srpaulo} 155214501Srpaulo 156214501Srpaulo 157214501Srpaulo/** 158214501Srpaulo * eap_server_get_name - Get EAP method name for the given EAP type 159214501Srpaulo * @vendor: EAP Vendor-Id (0 = IETF) 160214501Srpaulo * @type: EAP method type 161281806Srpaulo * Returns: EAP method name, e.g., TLS, or "unknown" if not found 162214501Srpaulo * 163214501Srpaulo * This function maps EAP type numbers into EAP type names based on the list of 164214501Srpaulo * EAP methods included in the build. 165214501Srpaulo */ 166214501Srpauloconst char * eap_server_get_name(int vendor, EapType type) 167214501Srpaulo{ 168214501Srpaulo struct eap_method *m; 169252726Srpaulo if (vendor == EAP_VENDOR_IETF && type == EAP_TYPE_EXPANDED) 170252726Srpaulo return "expanded"; 171214501Srpaulo for (m = eap_methods; m; m = m->next) { 172214501Srpaulo if (m->vendor == vendor && m->method == type) 173214501Srpaulo return m->name; 174214501Srpaulo } 175281806Srpaulo return "unknown"; 176214501Srpaulo} 177