eap_methods.c File Reference

hostapd / EAP method registration More...

#include "includes.h"
#include "common.h"
#include "eap_i.h"
#include "eap_methods.h"

Functions
struct eap_method *	eap_server_get_eap_method (int vendor, EapType method)
	Get EAP method based on type number.
EapType	eap_server_get_type (const char *name, int *vendor)
	Get EAP type for the given EAP method name.
struct eap_method *	eap_server_method_alloc (int version, int vendor, EapType method, const char *name)
	Allocate EAP server method structure.
void	eap_server_method_free (struct eap_method *method)
	Free EAP server method structure.
int	eap_server_method_register (struct eap_method *method)
	Register an EAP server method.
int	eap_server_register_methods (void)
	Register statically linked EAP server methods.
void	eap_server_unregister_methods (void)
	Unregister EAP server methods.

---

Detailed Description

hostapd / EAP method registration

Copyright

Copyright (c) 2004-2006, Jouni Malinen <j@w1.fi>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

Alternatively, this software may be distributed under the terms of BSD license.

See README and COPYING for more details.

---

Function Documentation

struct eap_method* eap_server_get_eap_method	(	int	vendor,
		EapType	method
	)			[read]

Get EAP method based on type number.

Parameters:

	vendor	EAP Vendor-Id (0 = IETF)
	method	EAP type number

Returns:

Pointer to EAP method or NULL if not found

EapType eap_server_get_type	(	const char *	name,
		int *	vendor
	)

Get EAP type for the given EAP method name.

Parameters:

	name	EAP method name, e.g., TLS
	vendor	Buffer for returning EAP Vendor-Id

Returns:

EAP method type or EAP_TYPE_NONE if not found

This function maps EAP type names into EAP type numbers based on the list of EAP methods included in the build.

struct eap_method* eap_server_method_alloc	(	int	version,
		int	vendor,
		EapType	method,
		const char *	name
	)			[read]

Allocate EAP server method structure.

Parameters:

	version	Version of the EAP server method interface (set to EAP_SERVER_METHOD_INTERFACE_VERSION)
	vendor	EAP Vendor-ID (EAP_VENDOR_*) (0 = IETF)
	method	EAP type number (EAP_TYPE_*)
	name	Name of the method (e.g., "TLS")

Returns:

Allocated EAP method structure or NULL on failure

The returned structure should be freed with eap_server_method_free() when it is not needed anymore.

void eap_server_method_free

(

struct eap_method *

method

)

Free EAP server method structure.

Parameters:

method

Method structure allocated with eap_server_method_alloc()

int eap_server_method_register

(

struct eap_method *

method

)

Register an EAP server method.

Parameters:

method

EAP method to register

Returns:

0 on success, -1 on invalid method, or -2 if a matching EAP method has already been registered

Each EAP server method needs to call this function to register itself as a supported EAP method.

int eap_server_register_methods

(

void

)

Register statically linked EAP server methods.

Returns:

0 on success, -1 on failure

This function is called at program initialization to register all EAP server methods that were linked in statically.

void eap_server_unregister_methods

(

void

)

Unregister EAP server methods.

This function is called at program termination to unregister all EAP server methods.