eapol.h

Go to the documentation of this file.

#ifndef _IPXE_EAPOL_H
#define _IPXE_EAPOL_H

/** @file
 *
 * Extensible Authentication Protocol over LAN (EAPoL)
 *
 */

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );

#include <stdint.h>
#include <ipxe/netdevice.h>
#include <ipxe/tables.h>
#include <ipxe/eap.h>

/** EAPoL header */
struct eapol_header {
        /** Version */
        uint8_t version;
        /** Type */
        uint8_t type;
        /** Payload length */
        uint16_t len;
} __attribute__ (( packed ));

/** 802.1X-2001 */
#define EAPOL_VERSION_2001 1

/** EAPoL-encapsulated EAP packets */
#define EAPOL_TYPE_EAP 0

/** EAPoL start */
#define EAPOL_TYPE_START 1

/** EAPoL key */
#define EAPOL_TYPE_KEY 5

/** An EAPoL supplicant */
struct eapol_supplicant {
        /** EAP supplicant */
        struct eap_supplicant eap;
        /** EAPoL-Start retransmission timer */
        struct retry_timer timer;
        /** EAPoL-Start transmission count */
        unsigned int count;
};

/** Delay between EAPoL-Start packets */
#define EAPOL_START_INTERVAL ( 2 * TICKS_PER_SEC )

/** Maximum number of EAPoL-Start packets to transmit */
#define EAPOL_START_COUNT 3

/** An EAPoL handler */
struct eapol_handler {
        /** Type */
        uint8_t type;
        /**
         * Process received packet
         *
         * @v supplicant        EAPoL supplicant
         * @v iobuf             I/O buffer
         * @v ll_source         Link-layer source address
         * @ret rc              Return status code
         *
         * This method takes ownership of the I/O buffer.
         */
        int ( * rx ) ( struct eapol_supplicant *supplicant,
                       struct io_buffer *iobuf, const void *ll_source );
};

/** EAPoL handler table */
#define EAPOL_HANDLERS __table ( struct eapol_handler, "eapol_handlers" )

/** Declare an EAPoL handler */
#define __eapol_handler __table_entry ( EAPOL_HANDLERS, 01 )

extern struct net_protocol eapol_protocol __net_protocol;

#endif /* _IPXE_EAPOL_H */