[mirror_edk2.git] / MdePkg / Include / IndustryStandard / IScsiBootFirmwareTable.h

/** @file\r
  The definition for iSCSI Boot Firmware Table, it's defined in Microsoft's\r
  iSCSI Boot Firmware Table(iBFT) as Defined in ACPI 3.0b Specification. \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 _ISCSI_BOOT_FIRMWARE_TABLE_H_\r
#define _ISCSI_BOOT_FIRMWARE_TABLE_H_\r
\r
#include "Acpi30.h"\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_REVISION            0x01\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_ALIGNMENT 8\r
\r
///\r
/// Structure Type/ID\r
///\r
typedef enum {\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_RESERVED_STRUCTURE_ID = 0,\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE_ID,\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_ID,\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_ID,\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_ID,\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_EXTERNSIONS_STRUCTURE_ID\r
} EFI_ACPI_ISCSI_ID_DEFINITIONS;\r
\r
///\r
/// from the definition of IP_PREFIX_ORIGIN Enumeration in MSDN,\r
/// not defined in Microsoft iBFT document.\r
///\r
typedef enum {\r
  IpPrefixOriginOther = 0,\r
  IpPrefixOriginManual,\r
  IpPrefixOriginWellKnown,\r
  IpPrefixOriginDhcp,\r
  IpPrefixOriginRouterAdvertisement,\r
  IpPrefixOriginUnchanged = 16\r
} IP_PREFIX_VALUE;\r
\r
///\r
/// iBF Table Header\r
///\r
typedef struct {\r
  UINT32  Signature;\r
  UINT32  Length;\r
  UINT8   Revision;\r
  UINT8   Checksum;\r
  UINT8   OemId[6];\r
  UINT64  OemTableId;\r
  UINT8   Reserved[24];\r
} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_HEADER;\r
\r
///\r
/// Common Header of Boot Firmware Table Structure \r
///\r
typedef struct {\r
  UINT8   StructureId;\r
  UINT8   Version;\r
  UINT16  Length;\r
  UINT8   Index;\r
  UINT8   Flags;\r
} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER;\r
\r
///\r
/// Control Structure\r
///\r
typedef struct {\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER  Header;\r
  UINT16                                               Extensions;\r
  UINT16                                               InitiatorOffset;\r
  UINT16                                               NIC0Offset;\r
  UINT16                                               Target0Offset;\r
  UINT16                                               NIC1Offset;\r
  UINT16                                               Target1Offset;  \r
} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE;\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE_VERSION              0x1\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE_FLAG_BOOT_FAILOVER   BIT0\r
\r
///\r
/// Initiator Structure\r
///\r
typedef struct {\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER  Header;\r
  EFI_IPv6_ADDRESS                                     ISnsServer;\r
  EFI_IPv6_ADDRESS                                     SlpServer;\r
  EFI_IPv6_ADDRESS                                     PrimaryRadiusServer;\r
  EFI_IPv6_ADDRESS                                     SecondaryRadiusServer;\r
  UINT16                                               IScsiNameLength;\r
  UINT16                                               IScsiNameOffset;\r
} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE;\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_VERSION             0x1\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_FLAG_BLOCK_VALID    BIT0 \r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_FLAG_BOOT_SELECTED  BIT1 \r
\r
///\r
/// NIC Structure\r
///\r
typedef struct {\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER  Header;\r
  EFI_IPv6_ADDRESS                                     Ip;\r
  UINT8                                                SubnetMaskPrefixLength;\r
  UINT8                                                Origin;\r
  EFI_IPv6_ADDRESS                                     Gateway;\r
  EFI_IPv6_ADDRESS                                     PrimaryDns;\r
  EFI_IPv6_ADDRESS                                     SecondaryDns;\r
  EFI_IPv6_ADDRESS                                     DhcpServer;\r
  UINT16                                               VLanTag;\r
  UINT8                                                Mac[6];\r
  UINT16                                               PciLocation;\r
  UINT16                                               HostNameLength;\r
  UINT16                                               HostNameOffset;\r
} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE;\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_VERSION                 0x1\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_FLAG_BLOCK_VALID        BIT0\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_FLAG_BOOT_SELECTED      BIT1\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_FLAG_GLOBAL             BIT2\r
\r
///\r
/// Target Structure\r
///\r
typedef struct {\r
  EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER  Header;\r
  EFI_IPv6_ADDRESS                                     Ip;\r
  UINT16                                               Port;\r
  UINT8                                                BootLun[8];\r
  UINT8                                                CHAPType;\r
  UINT8                                                NicIndex;\r
  UINT16                                               IScsiNameLength;\r
  UINT16                                               IScsiNameOffset;\r
  UINT16                                               CHAPNameLength;\r
  UINT16                                               CHAPNameOffset;\r
  UINT16                                               CHAPSecretLength;\r
  UINT16                                               CHAPSecretOffset;\r
  UINT16                                               ReverseCHAPNameLength;\r
  UINT16                                               ReverseCHAPNameOffset;\r
  UINT16                                               ReverseCHAPSecretLength;\r
  UINT16                                               ReverseCHAPSecretOffset;\r
} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE;\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_VERSION               0x1\r
\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_BLOCK_VALID      BIT0\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_BOOT_SELECTED    BIT1\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_RADIUS_CHAP      BIT2\r
#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_RADIUS_RCHAP     BIT3\r
\r
#endif\r
\r
Commit	Line	Data
e3b1115e	1	/** @file\r
54569f0f	2	The definition for iSCSI Boot Firmware Table, it's defined in Microsoft's\r
54569f0f	3	iSCSI Boot Firmware Table(iBFT) as Defined in ACPI 3.0b Specification. \r
000f6a28	4	\r
000f6a28	5	Copyright (c) 2006 - 2008, Intel Corporation\r
c311f86b	6	All rights reserved. This program and the accompanying materials \r
	7	are licensed and made available under the terms and conditions of the BSD License \r
	8	which accompanies this distribution. The full text of the license may be found at \r
	9	http://opensource.org/licenses/bsd-license.php \r
	10	\r
	11	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	12	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	13	\r
e3b1115e	14	**/\r
	15	\r
	16	#ifndef _ISCSI_BOOT_FIRMWARE_TABLE_H_\r
	17	#define _ISCSI_BOOT_FIRMWARE_TABLE_H_\r
	18	\r
732fb201	19	#include "Acpi30.h"\r
e3b1115e	20	\r
	21	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_REVISION 0x01\r
	22	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_ALIGNMENT 8\r
	23	\r
000f6a28	24	///\r
	25	/// Structure Type/ID\r
	26	///\r
42eedea9	27	typedef enum {\r
e3b1115e	28	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_RESERVED_STRUCTURE_ID = 0,\r
	29	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE_ID,\r
	30	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_ID,\r
	31	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_ID,\r
	32	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_ID,\r
1b2afeaa	33	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_EXTERNSIONS_STRUCTURE_ID\r
42eedea9	34	} EFI_ACPI_ISCSI_ID_DEFINITIONS;\r
e3b1115e	35	\r
000f6a28	36	///\r
	37	/// from the definition of IP_PREFIX_ORIGIN Enumeration in MSDN,\r
	38	/// not defined in Microsoft iBFT document.\r
	39	///\r
42eedea9	40	typedef enum {\r
e3b1115e	41	IpPrefixOriginOther = 0,\r
	42	IpPrefixOriginManual,\r
	43	IpPrefixOriginWellKnown,\r
	44	IpPrefixOriginDhcp,\r
	45	IpPrefixOriginRouterAdvertisement,\r
	46	IpPrefixOriginUnchanged = 16\r
42eedea9	47	} IP_PREFIX_VALUE;\r
e3b1115e	48	\r
000f6a28	49	///\r
	50	/// iBF Table Header\r
	51	///\r
e3b1115e	52	typedef struct {\r
	53	UINT32 Signature;\r
	54	UINT32 Length;\r
	55	UINT8 Revision;\r
	56	UINT8 Checksum;\r
	57	UINT8 OemId[6];\r
	58	UINT64 OemTableId;\r
	59	UINT8 Reserved[24];\r
	60	} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_HEADER;\r
	61	\r
000f6a28	62	///\r
	63	/// Common Header of Boot Firmware Table Structure \r
	64	///\r
e3b1115e	65	typedef struct {\r
	66	UINT8 StructureId;\r
	67	UINT8 Version;\r
	68	UINT16 Length;\r
	69	UINT8 Index;\r
	70	UINT8 Flags;\r
	71	} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER;\r
	72	\r
000f6a28	73	///\r
	74	/// Control Structure\r
	75	///\r
e3b1115e	76	typedef struct {\r
	77	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER Header;\r
	78	UINT16 Extensions;\r
	79	UINT16 InitiatorOffset;\r
	80	UINT16 NIC0Offset;\r
	81	UINT16 Target0Offset;\r
	82	UINT16 NIC1Offset;\r
	83	UINT16 Target1Offset; \r
	84	} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE;\r
	85	\r
54569f0f	86	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE_VERSION 0x1\r
	87	\r
	88	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_CONTROL_STRUCTURE_FLAG_BOOT_FAILOVER BIT0\r
e3b1115e	89	\r
000f6a28	90	///\r
	91	/// Initiator Structure\r
	92	///\r
e3b1115e	93	typedef struct {\r
	94	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER Header;\r
	95	EFI_IPv6_ADDRESS ISnsServer;\r
	96	EFI_IPv6_ADDRESS SlpServer;\r
	97	EFI_IPv6_ADDRESS PrimaryRadiusServer;\r
	98	EFI_IPv6_ADDRESS SecondaryRadiusServer;\r
	99	UINT16 IScsiNameLength;\r
	100	UINT16 IScsiNameOffset;\r
	101	} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE;\r
	102	\r
54569f0f	103	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_VERSION 0x1\r
	104	\r
	105	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_FLAG_BLOCK_VALID BIT0 \r
	106	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_INITIATOR_STRUCTURE_FLAG_BOOT_SELECTED BIT1 \r
e3b1115e	107	\r
000f6a28	108	///\r
	109	/// NIC Structure\r
	110	///\r
e3b1115e	111	typedef struct {\r
	112	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER Header;\r
	113	EFI_IPv6_ADDRESS Ip;\r
	114	UINT8 SubnetMaskPrefixLength;\r
	115	UINT8 Origin;\r
	116	EFI_IPv6_ADDRESS Gateway;\r
	117	EFI_IPv6_ADDRESS PrimaryDns;\r
	118	EFI_IPv6_ADDRESS SecondaryDns;\r
	119	EFI_IPv6_ADDRESS DhcpServer;\r
	120	UINT16 VLanTag;\r
	121	UINT8 Mac[6];\r
	122	UINT16 PciLocation;\r
	123	UINT16 HostNameLength;\r
	124	UINT16 HostNameOffset;\r
	125	} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE;\r
	126	\r
54569f0f	127	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_VERSION 0x1\r
	128	\r
	129	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_FLAG_BLOCK_VALID BIT0\r
	130	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_FLAG_BOOT_SELECTED BIT1\r
	131	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_NIC_STRUCTURE_FLAG_GLOBAL BIT2\r
e3b1115e	132	\r
000f6a28	133	///\r
	134	/// Target Structure\r
	135	///\r
e3b1115e	136	typedef struct {\r
	137	EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_STRUCTURE_HEADER Header;\r
	138	EFI_IPv6_ADDRESS Ip;\r
	139	UINT16 Port;\r
	140	UINT8 BootLun[8];\r
	141	UINT8 CHAPType;\r
	142	UINT8 NicIndex;\r
	143	UINT16 IScsiNameLength;\r
	144	UINT16 IScsiNameOffset;\r
	145	UINT16 CHAPNameLength;\r
	146	UINT16 CHAPNameOffset;\r
	147	UINT16 CHAPSecretLength;\r
	148	UINT16 CHAPSecretOffset;\r
	149	UINT16 ReverseCHAPNameLength;\r
	150	UINT16 ReverseCHAPNameOffset;\r
	151	UINT16 ReverseCHAPSecretLength;\r
	152	UINT16 ReverseCHAPSecretOffset;\r
	153	} EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE;\r
	154	\r
54569f0f	155	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_VERSION 0x1\r
000f6a28	156	\r
54569f0f	157	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_BLOCK_VALID BIT0\r
	158	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_BOOT_SELECTED BIT1\r
	159	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_RADIUS_CHAP BIT2\r
	160	#define EFI_ACPI_ISCSI_BOOT_FIRMWARE_TABLE_TARGET_STRUCTURE_FLAG_RADIUS_RCHAP BIT3\r
e3b1115e	161	\r
	162	#endif\r
	163	\r