MdePkg/Include/Protocol/Eap.h

   1 /** @file
   2   EFI EAP(Extended Authenticaton Protocol) Protocol Definition
   3   The EFI EAP Protocol is used to abstract the ability to configure and extend the
   4   EAP framework.
   5   The definitions in this file are defined in UEFI Specification 2.3, which have
   6   not been verified by one implementation yet.
   7
   8   Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>
   9   This program and the accompanying materials
  10   are licensed and made available under the terms and conditions of the BSD License
  11   which accompanies this distribution.  The full text of the license may be found at
  12   http://opensource.org/licenses/bsd-license.php
  13
  14   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  15   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  16
  17   @par Revision Reference:
  18   This Protocol is introduced in UEFI Specification 2.2
  19
  20 **/
  21
  22 #ifndef __EFI_EAP_PROTOCOL_H__
  23 #define __EFI_EAP_PROTOCOL_H__
  24
  25
  26 #define EFI_EAP_PROTOCOL_GUID \
  27   { \
  28     0x5d9f96db, 0xe731, 0x4caa, {0xa0, 0xd, 0x72, 0xe1, 0x87, 0xcd, 0x77, 0x62 } \
  29   }
  30
  31 typedef struct _EFI_EAP_PROTOCOL EFI_EAP_PROTOCOL;
  32
  33 ///
  34 /// Type for the identification number assigned to the Port by the
  35 /// System in which the Port resides.
  36 ///
  37 typedef VOID *  EFI_PORT_HANDLE;
  38
  39 ///
  40 /// EAP Authentication Method Type (RFC 2284 Section 3)
  41 ///@{
  42 #define EFI_EAP_TYPE_MD5                0x4   ///< REQUIRED
  43 #define EFI_EAP_TYPE_OTP                0x5   ///< OPTIONAL
  44 #define EFI_EAP_TYPE_TOKEN_CARD         0x6   ///< OPTIONAL
  45 ///@}
  46
  47
  48 /**
  49   One user provided EAP authentication method.
  50
  51   Build EAP response packet in response to the EAP request packet specified by
  52   (RequestBuffer, RequestSize).
  53
  54   @param[in]      PortNumber     Specified the Port where the EAP request packet comes.
  55   @param[in]      RequestBuffer  Pointer to the most recently received EAP- Request packet.
  56   @param[in]      RequestSize    Packet size in bytes for the most recently received
  57                                  EAP-Request packet.
  58   @param[in]      Buffer         Pointer to the buffer to hold the built packet.
  59   @param[in, out] BufferSize     Pointer to the buffer size in bytes.
  60                                  On input, it is the buffer size provided by the caller.
  61                                  On output, it is the buffer size in fact needed to contain
  62                                  the packet.
  63
  64   @retval EFI_SUCCESS            The required EAP response packet is built successfully.
  65   @retval others                 Failures are encountered during the packet building process.
  66
  67 **/
  68 typedef
  69 EFI_STATUS
  70 (EFIAPI *EFI_EAP_BUILD_RESPONSE_PACKET)(
  71   IN EFI_PORT_HANDLE        PortNumber,
  72   IN UINT8                  *RequestBuffer,
  73   IN UINTN                  RequestSize,
  74   IN UINT8                  *Buffer,
  75   IN OUT UINTN              *BufferSize
  76   );
  77
  78 /**
  79   Set the desired EAP authentication method for the Port.
  80
  81   The SetDesiredAuthMethod() function sets the desired EAP authentication method indicated
  82   by EapAuthType for the Port.
  83
  84   If EapAuthType is an invalid EAP authentication type, then EFI_INVALID_PARAMETER is
  85   returned.
  86   If the EAP authentication method of EapAuthType is unsupported by the Ports, then this
  87   function will return EFI_UNSUPPORTED.
  88
  89   @param[in] This                A pointer to the EFI_EAP_PROTOCOL instance that indicates
  90                                  the calling context.
  91   @param[in] EapAuthType         The type of the EAP authentication method to register. It should
  92                                  be the type value defined by RFC. See RFC 2284 for details.
  93   @param[in] Handler             The handler of the EAP authentication method to register.
  94
  95   @retval EFI_SUCCESS            The EAP authentication method of EapAuthType is
  96                                  registered successfully.
  97   @retval EFI_INVALID_PARAMETER  EapAuthType is an invalid EAP authentication type.
  98   @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to perform the registration.
  99
 100 **/
 101 typedef
 102 EFI_STATUS
 103 (EFIAPI *EFI_EAP_SET_DESIRED_AUTHENTICATION_METHOD)(
 104   IN EFI_EAP_PROTOCOL            *This,
 105   IN UINT8                       EapAuthType
 106   );
 107
 108 /**
 109   Register an EAP authentication method.
 110
 111   The RegisterAuthMethod() function registers the user provided EAP authentication method,
 112   the type of which is EapAuthType and the handler of which is Handler.
 113
 114   If EapAuthType is an invalid EAP authentication type, then EFI_INVALID_PARAMETER is
 115   returned.
 116   If there is not enough system memory to perform the registration, then
 117   EFI_OUT_OF_RESOURCES is returned.
 118
 119   @param[in] This                A pointer to the EFI_EAP_PROTOCOL instance that indicates
 120                                  the calling context.
 121   @param[in] EapAuthType         The type of the EAP authentication method to register. It should
 122                                  be the type value defined by RFC. See RFC 2284 for details.
 123   @param[in] Handler             The handler of the EAP authentication method to register.
 124
 125   @retval EFI_SUCCESS            The EAP authentication method of EapAuthType is
 126                                  registered successfully.
 127   @retval EFI_INVALID_PARAMETER  EapAuthType is an invalid EAP authentication type.
 128   @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to perform the registration.
 129
 130 **/
 131 typedef
 132 EFI_STATUS
 133 (EFIAPI *EFI_EAP_REGISTER_AUTHENTICATION_METHOD)(
 134   IN EFI_EAP_PROTOCOL                     *This,
 135   IN UINT8                                EapAuthType,
 136   IN EFI_EAP_BUILD_RESPONSE_PACKET        Handler
 137   );
 138
 139 ///
 140 /// EFI_EAP_PROTOCOL
 141 /// is used to configure the desired EAP authentication method for the EAP
 142 /// framework and extend the EAP framework by registering new EAP authentication
 143 /// method on a Port. The EAP framework is built on a per-Port basis. Herein, a
 144 /// Port means a NIC. For the details of EAP protocol, please refer to RFC 2284.
 145 ///
 146 struct _EFI_EAP_PROTOCOL {
 147   EFI_EAP_SET_DESIRED_AUTHENTICATION_METHOD   SetDesiredAuthMethod;
 148   EFI_EAP_REGISTER_AUTHENTICATION_METHOD      RegisterAuthMethod;
 149 };
 150
 151 extern EFI_GUID gEfiEapProtocolGuid;
 152
 153 #endif
 154