Retire TCG platform protocol, which will be replaced by PI Security Architecture...

[mirror_edk2.git] / MdeModulePkg / Include / Protocol / NicIp4Config.h

/** @file\r
  This file defines NicIp4Config Protocol.\r
  EFI_NIC_IP4_CONFIG_PROTOCOL is a proprietary protocol, not defined by UEFI2.0.\r
\r
Copyright (c) 2006 - 2008, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#ifndef __NIC_IP4_CONFIG_H__\r
#define __NIC_IP4_CONFIG_H__\r
\r
#include <Protocol/Ip4Config.h>\r
\r
\r
#define EFI_NIC_IP4_CONFIG_PROTOCOL_GUID \\r
  { \\r
    0xdca3d4d, 0x12da, 0x4728, { 0xbf, 0x7e, 0x86, 0xce, 0xb9, 0x28, 0xd0, 0x67 } \\r
  }\r
\r
#define EFI_NIC_IP4_CONFIG_VARIABLE_GUID \\r
  { \\r
    0xd8944553, 0xc4dd, 0x41f4, { 0x9b, 0x30, 0xe1, 0x39, 0x7c, 0xfb, 0x26, 0x7b } \\r
  }\r
\r
#define EFI_NIC_IP4_CONFIG_VARIABLE          L"EfiNicIp4ConfigVariable"\r
\r
\r
typedef struct _EFI_NIC_IP4_CONFIG_PROTOCOL EFI_NIC_IP4_CONFIG_PROTOCOL;\r
\r
typedef enum {\r
  //\r
  // Config source: dhcp or static\r
  //\r
  IP4_CONFIG_SOURCE_DHCP     = 0,\r
  IP4_CONFIG_SOURCE_STATIC,\r
  IP4_CONFIG_SOURCE_MAX,\r
\r
  IP4_NIC_NAME_LENGTH        = 64,\r
  MAX_IP4_CONFIG_IN_VARIABLE = 16\r
} IP4_CONFIG_TYPE;\r
\r
//\r
// The following structures are used by drivers/applications other\r
// than EFI_IP4_PROTOCOL, such as ifconfig shell application, to\r
// communicate the IP configuration information to EFI_IP4_CONFIG_PROTOCOL.\r
// EFI_IP4_CONFIG_PROTOCOL in turn is used by EFI_IP4_PROTOCOL to get\r
// the default IP4 configuration. ifconfig can't use the EFI_IP4_PROTOCOL\r
// because it don't know how to configure the default IP address even\r
// it has got the address.\r
//\r
\r
///\r
/// NIC_ADDR contains the interface's type and MAC address to identify\r
/// a specific NIC.\r
///\r
typedef struct {\r
  UINT16                    Type;       ///< Interface type\r
  UINT8                     Len;        ///< Length of MAC address\r
  EFI_MAC_ADDRESS           MacAddr;    ///< MAC address of interface\r
} NIC_ADDR;\r
\r
///\r
/// NIC_IP4_CONFIG_INFO contains the IP4 configure\r
/// parameters for that NIC. NIC_IP4_CONFIG_INFO is\r
/// of variable length.\r
///\r
typedef struct {\r
  NIC_ADDR                  NicAddr;    ///< Link layer address to identify the NIC\r
  UINT32                    Source;     ///< Static or DHCP\r
  BOOLEAN                   Perment;    ///< Survive the reboot or not\r
  EFI_IP4_IPCONFIG_DATA     Ip4Info;    ///< IP addresses\r
} NIC_IP4_CONFIG_INFO;\r
\r
///\r
/// IP4_CONFIG_VARIABLE is the EFI variable to\r
/// save the configuration. IP4_CONFIG_VARIABLE is\r
/// of variable length.\r
///\r
typedef struct {\r
  UINT32                    Len;        ///< Total length of the variable\r
  UINT16                    CheckSum;   ///< CheckSum, the same as IP4 head checksum\r
  UINT32                    Count;      ///< Number of NIC_IP4_CONFIG_INFO follows\r
  NIC_IP4_CONFIG_INFO       ConfigInfo;\r
} IP4_CONFIG_VARIABLE;\r
\r
/**\r
  Get the configure parameter for this NIC.\r
\r
  @param  This                   The NIC IP4 CONFIG protocol.\r
  @param  Len                    The length of the NicConfig buffer.\r
  @param  NicConfig              The buffer to receive the NIC's configure\r
                                 parameter.\r
\r
  @retval EFI_SUCCESS            The configure parameter for this NIC was \r
                                 obtained successfully .\r
  @retval EFI_INVALID_PARAMETER  This or ConfigLen is NULL.\r
  @retval EFI_NOT_FOUND          There is no configure parameter for the NIC in\r
                                 NVRam.\r
  @retval EFI_BUFFER_TOO_SMALL   The ConfigLen is too small or the NicConfig is \r
                                 NULL.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_NIC_IP4_CONFIG_GET_INFO)(\r
  IN EFI_NIC_IP4_CONFIG_PROTOCOL  *This,\r
  IN OUT UINTN                    *Len,\r
  OUT NIC_IP4_CONFIG_INFO         *NicConfig     OPTIONAL\r
  );\r
\r
/**\r
  Set the IP configure parameters for this NIC. \r
\r
  If Reconfig is TRUE, the IP driver will be informed to discard current \r
  auto configure parameter and restart the auto configuration process. \r
  If current there is a pending auto configuration, EFI_ALREADY_STARTED is\r
  returned. You can only change the configure setting when either\r
  the configure has finished or not started yet. If NicConfig, the\r
  NIC's configure parameter is removed from the variable.\r
\r
  @param  This                   The NIC IP4 CONFIG protocol\r
  @param  NicConfig              The new NIC IP4 configure parameter\r
  @param  Reconfig               Inform the IP4 driver to restart the auto\r
                                 configuration\r
                                 \r
  @retval EFI_SUCCESS            The configure parameter for this NIC was \r
                                 set successfully .\r
  @retval EFI_INVALID_PARAMETER  This is NULL or the configure parameter is\r
                                 invalid.\r
  @retval EFI_ALREADY_STARTED    There is a pending auto configuration.\r
  @retval EFI_NOT_FOUND          No auto configure parameter is found\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_NIC_IP4_CONFIG_SET_INFO)(\r
  IN EFI_NIC_IP4_CONFIG_PROTOCOL  *This,\r
  IN NIC_IP4_CONFIG_INFO          *NicConfig     OPTIONAL,\r
  IN BOOLEAN                      ReConfig\r
  );\r
\r
/**\r
  Return the name and MAC address for the NIC. The Name, if not NULL,\r
  has at least IP4_NIC_NAME_LENGTH bytes.\r
\r
  @param  This                   The NIC IP4 CONFIG protocol\r
  @param  Name                   The buffer to return the name\r
  @param  NicAddr                The buffer to return the MAC addr\r
\r
  @retval EFI_INVALID_PARAMETER  This is NULL\r
  @retval EFI_SUCCESS            The name or address of the NIC are returned.\r
\r
**/\r
typedef\r
EFI_STATUS\r
(EFIAPI *EFI_NIC_IP4_CONFIG_GET_NAME)(\r
  IN  EFI_NIC_IP4_CONFIG_PROTOCOL *This,\r
  OUT  UINT16                     *Name          OPTIONAL,\r
  OUT  NIC_ADDR                   *NicAddr       OPTIONAL\r
  );\r
\r
struct _EFI_NIC_IP4_CONFIG_PROTOCOL {\r
  EFI_NIC_IP4_CONFIG_GET_NAME     GetName;\r
  EFI_NIC_IP4_CONFIG_GET_INFO     GetInfo;\r
  EFI_NIC_IP4_CONFIG_SET_INFO     SetInfo;\r
};\r
\r
extern EFI_GUID gEfiNicIp4ConfigVariableGuid;\r
extern EFI_GUID gEfiNicIp4ConfigProtocolGuid;\r
#endif\r