Home | History | Annotate | Download | only in eap_server 
      1 /*
      2  * EAP server method registration
      3  * Copyright (c) 2004-2009, 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_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