eapol.h

Go to the documentation of this file.

/*
 * 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 */