Home | History | Annotate | Line # | 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 software may be distributed under the terms of the BSD license.
      6  * See README for more details.
      7  */
      8 
      9 #include "includes.h"
     10 
     11 #include "common.h"
     12 #include "eap_i.h"
     13 #include "eap_methods.h"
     14 
     15 
     16 static struct eap_method *eap_methods;
     17 
     18 
     19 /**
     20  * eap_server_get_eap_method - Get EAP method based on type number
     21  * @vendor: EAP Vendor-Id (0 = IETF)
     22  * @method: EAP type number
     23  * Returns: Pointer to EAP method or %NULL if not found
     24  */
     25 const struct eap_method * eap_server_get_eap_method(int vendor,
     26 						    enum eap_type method)
     27 {
     28 	struct eap_method *m;
     29 	for (m = eap_methods; m; m = m->next) {
     30 		if (m->vendor == vendor && m->method == method)
     31 			return m;
     32 	}
     33 	return NULL;
     34 }
     35 
     36 
     37 /**
     38  * eap_server_get_type - Get EAP type for the given EAP method name
     39  * @name: EAP method name, e.g., TLS
     40  * @vendor: Buffer for returning EAP Vendor-Id
     41  * Returns: EAP method type or %EAP_TYPE_NONE if not found
     42  *
     43  * This function maps EAP type names into EAP type numbers based on the list of
     44  * EAP methods included in the build.
     45  */
     46 enum eap_type eap_server_get_type(const char *name, int *vendor)
     47 {
     48 	struct eap_method *m;
     49 	for (m = eap_methods; m; m = m->next) {
     50 		if (os_strcmp(m->name, name) == 0) {
     51 			*vendor = m->vendor;
     52 			return m->method;
     53 		}
     54 	}
     55 	*vendor = EAP_VENDOR_IETF;
     56 	return EAP_TYPE_NONE;
     57 }
     58 
     59 
     60 /**
     61  * eap_server_method_alloc - Allocate EAP server method structure
     62  * @version: Version of the EAP server method interface (set to
     63  * EAP_SERVER_METHOD_INTERFACE_VERSION)
     64  * @vendor: EAP Vendor-ID (EAP_VENDOR_*) (0 = IETF)
     65  * @method: EAP type number (EAP_TYPE_*)
     66  * @name: Name of the method (e.g., "TLS")
     67  * Returns: Allocated EAP method structure or %NULL on failure
     68  *
     69  * The returned structure should be freed with eap_server_method_free() when it
     70  * is not needed anymore.
     71  */
     72 struct eap_method * eap_server_method_alloc(int version, int vendor,
     73 					    enum eap_type method,
     74 					    const char *name)
     75 {
     76 	struct eap_method *eap;
     77 	eap = os_zalloc(sizeof(*eap));
     78 	if (eap == NULL)
     79 		return NULL;
     80 	eap->version = version;
     81 	eap->vendor = vendor;
     82 	eap->method = method;
     83 	eap->name = name;
     84 	return eap;
     85 }
     86 
     87 
     88 /**
     89  * eap_server_method_free - Free EAP server method structure
     90  * @method: Method structure allocated with eap_server_method_alloc()
     91  */
     92 static void eap_server_method_free(struct eap_method *method)
     93 {
     94 	os_free(method);
     95 }
     96 
     97 
     98 /**
     99  * eap_server_method_register - Register an EAP server method
    100  * @method: EAP method to register from eap_server_method_alloc()
    101  * Returns: 0 on success, -1 on invalid method, or -2 if a matching EAP method
    102  * has already been registered
    103  *
    104  * Each EAP server method needs to call this function to register itself as a
    105  * supported EAP method. The caller must not free the allocated method data
    106  * regardless of the return value.
    107  */
    108 int eap_server_method_register(struct eap_method *method)
    109 {
    110 	struct eap_method *m, *last = NULL;
    111 
    112 	if (method == NULL || method->name == NULL ||
    113 	    method->version != EAP_SERVER_METHOD_INTERFACE_VERSION) {
    114 		eap_server_method_free(method);
    115 		return -1;
    116 	}
    117 
    118 	for (m = eap_methods; m; m = m->next) {
    119 		if ((m->vendor == method->vendor &&
    120 		     m->method == method->method) ||
    121 		    os_strcmp(m->name, method->name) == 0) {
    122 			eap_server_method_free(method);
    123 			return -2;
    124 		}
    125 		last = m;
    126 	}
    127 
    128 	if (last)
    129 		last->next = method;
    130 	else
    131 		eap_methods = method;
    132 
    133 	return 0;
    134 }
    135 
    136 
    137 /**
    138  * eap_server_unregister_methods - Unregister EAP server methods
    139  *
    140  * This function is called at program termination to unregister all EAP server
    141  * methods.
    142  */
    143 void eap_server_unregister_methods(void)
    144 {
    145 	struct eap_method *m;
    146 
    147 	while (eap_methods) {
    148 		m = eap_methods;
    149 		eap_methods = eap_methods->next;
    150 
    151 		if (m->free)
    152 			m->free(m);
    153 		else
    154 			eap_server_method_free(m);
    155 	}
    156 }
    157 
    158 
    159 /**
    160  * eap_server_get_name - Get EAP method name for the given EAP type
    161  * @vendor: EAP Vendor-Id (0 = IETF)
    162  * @type: EAP method type
    163  * Returns: EAP method name, e.g., TLS, or "unknown" if not found
    164  *
    165  * This function maps EAP type numbers into EAP type names based on the list of
    166  * EAP methods included in the build.
    167  */
    168 const char * eap_server_get_name(int vendor, enum eap_type type)
    169 {
    170 	struct eap_method *m;
    171 	if (vendor == EAP_VENDOR_IETF && type == EAP_TYPE_EXPANDED)
    172 		return "expanded";
    173 	for (m = eap_methods; m; m = m->next) {
    174 		if (m->vendor == vendor && m->method == type)
    175 			return m->name;
    176 	}
    177 	return "unknown";
    178 }
    179