| /* |
| * Copyright (c) 2009 Joshua Oreman <oremanj@rwcr.net>. |
| * |
| * This program is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU General Public License as |
| * published by the Free Software Foundation; either version 2 of the |
| * License, or any later version. |
| * |
| * This program is distributed in the hope that it will be useful, but |
| * WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| * General Public License for more details. |
| * |
| * You should have received a copy of the GNU General Public License |
| * along with this program; if not, write to the Free Software |
| * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
| */ |
| |
| #ifndef _GPXE_EAPOL_H |
| #define _GPXE_EAPOL_H |
| |
| /** @file |
| * |
| * Definitions for EAPOL (Extensible Authentication Protocol over |
| * LANs) frames. Definitions for the packets usually encapsulated in |
| * them are elsewhere. |
| */ |
| |
| #include <gpxe/tables.h> |
| #include <stdint.h> |
| |
| FILE_LICENCE ( GPL2_OR_LATER ); |
| |
| |
| /** |
| * @defgroup eapol_type EAPOL archetype identifiers |
| * @{ |
| */ |
| #define EAPOL_TYPE_EAP 0 /**< EAP authentication handshake packet */ |
| #define EAPOL_TYPE_START 1 /**< Request by Peer to begin (no data) */ |
| #define EAPOL_TYPE_LOGOFF 2 /**< Request by Peer to terminate (no data) */ |
| #define EAPOL_TYPE_KEY 3 /**< EAPOL-Key packet */ |
| /** @} */ |
| |
| /** Expected EAPOL version field value |
| * |
| * Version 2 is often seen and has no format differences from version 1; |
| * however, many older APs will completely drop version-2 packets, so |
| * we advertise ourselves as version 1. |
| */ |
| #define EAPOL_THIS_VERSION 1 |
| |
| /** Length of an EAPOL frame header */ |
| #define EAPOL_HDR_LEN 4 |
| |
| /** An EAPOL frame |
| * |
| * This may encapsulate an eap_pkt, an eapol_key_pkt, or a Start or |
| * Logoff request with no data attached. It is transmitted directly in |
| * an Ethernet frame, with no IP packet header. |
| */ |
| struct eapol_frame |
| { |
| /** EAPOL version identifier, always 1 */ |
| u8 version; |
| |
| /** EAPOL archetype identifier indicating format of payload */ |
| u8 type; |
| |
| /** Length of payload, in network byte order */ |
| u16 length; |
| |
| /** Payload, if @a type is EAP or EAPOL-Key */ |
| u8 data[0]; |
| } __attribute__ (( packed )); |
| |
| |
| /** An EAPOL frame type handler |
| * |
| * Normally there will be at most two of these, one for EAP and one |
| * for EAPOL-Key frames. The EAPOL interface code handles Start and |
| * Logoff directly. |
| */ |
| struct eapol_handler |
| { |
| /** EAPOL archetype identifier for payload this handler will handle */ |
| u8 type; |
| |
| /** Receive EAPOL-encapsulated packet of specified type |
| * |
| * @v iob I/O buffer containing packet payload |
| * @v netdev Network device from which packet was received |
| * @v ll_source Source link-layer address from which packet was received |
| * @ret rc Return status code |
| * |
| * The I/O buffer will have the EAPOL header pulled off it, so |
| * @c iob->data points to the first byte of the payload. |
| * |
| * This function takes ownership of the I/O buffer passed to it. |
| */ |
| int ( * rx ) ( struct io_buffer *iob, struct net_device *netdev, |
| const void *ll_source ); |
| }; |
| |
| #define EAPOL_HANDLERS __table ( struct eapol_handler, "eapol_handlers" ) |
| #define __eapol_handler __table_entry ( EAPOL_HANDLERS, 01 ) |
| |
| |
| extern struct net_protocol eapol_protocol __net_protocol; |
| |
| |
| #endif /* _GPXE_EAPOL_H */ |