mirror of https://github.com/acidanthera/audk.git
154 lines
5.2 KiB
C
154 lines
5.2 KiB
C
/** @file
|
|
The header file of IScsiConfig.c.
|
|
|
|
Copyright (c) 2004 - 2008, Intel Corporation.<BR>
|
|
All rights reserved. This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#ifndef _ISCSI_CONFIG_H_
|
|
#define _ISCSI_CONFIG_H_
|
|
|
|
#include <Library/HiiLib.h>
|
|
#include <Library/ExtendedHiiLib.h>
|
|
#include <Library/IfrSupportLib.h>
|
|
#include <Library/ExtendedIfrSupportLib.h>
|
|
#include <Library/DebugLib.h>
|
|
#include <Library/BaseLib.h>
|
|
#include <Library/NetLib.h>
|
|
|
|
extern UINT8 IScsiConfigDxeBin[];
|
|
extern UINT8 IScsiDxeStrings[];
|
|
|
|
#define ISCSI_INITATOR_NAME_VAR_NAME L"I_NAME"
|
|
|
|
#define ISCSI_CONFIG_VAR_ATTR (EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_NON_VOLATILE)
|
|
|
|
#define ISCSI_FORM_CALLBACK_INFO_SIGNATURE SIGNATURE_32 ('I', 'f', 'c', 'i')
|
|
|
|
|
|
|
|
/**
|
|
If the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is clear,
|
|
then this macro return a pointer to a data structure ISCSI_FORM_CALLBACK_INFO.
|
|
|
|
If the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set,
|
|
The Signature field of the data structure ISCSI_FORM_CALLBACK_INFO
|
|
is compared to TestSignature. If the signatures match, then a pointer
|
|
to the pointer to a data structure ISCSI_FORM_CALLBACK_INFO is returned.
|
|
If the signatures do not match, then DebugAssert() is called with a description
|
|
of "CR has a bad signature" and Callback is returned.
|
|
|
|
If the data type ISCSI_FORM_CALLBACK_INFO_SIGNATURE does not contain the field
|
|
specified by Callback, then the module will not compile.
|
|
|
|
If ISCSI_FORM_CALLBACK_INFO_SIGNATURE does not contain a field called Signature,
|
|
then the module will not compile.
|
|
|
|
@param Callback Pointer to the specified field within the data
|
|
structure ISCSI_FORM_CALLBACK_INFO.
|
|
@return a pointer to the pointer to a data structure ISCSI_FORM_CALLBACK_INFO.
|
|
@return Others Some unexpected error happened.
|
|
**/
|
|
|
|
#define ISCSI_FORM_CALLBACK_INFO_FROM_FORM_CALLBACK(Callback) \
|
|
CR ( \
|
|
Callback, \
|
|
ISCSI_FORM_CALLBACK_INFO, \
|
|
ConfigAccess, \
|
|
ISCSI_FORM_CALLBACK_INFO_SIGNATURE \
|
|
)
|
|
|
|
#pragma pack(1)
|
|
|
|
typedef struct _ISCSI_MAC_INFO {
|
|
EFI_MAC_ADDRESS Mac;
|
|
UINT8 Len;
|
|
} ISCSI_MAC_INFO;
|
|
|
|
typedef struct _ISCSI_DEVICE_LIST {
|
|
UINT8 NumDevice;
|
|
ISCSI_MAC_INFO MacInfo[1];
|
|
} ISCSI_DEVICE_LIST;
|
|
|
|
#pragma pack()
|
|
|
|
typedef struct _ISCSI_CONFIG_FORM_ENTRY {
|
|
LIST_ENTRY Link;
|
|
EFI_HANDLE Controller;
|
|
CHAR16 MacString[95];
|
|
EFI_STRING_ID PortTitleToken;
|
|
EFI_STRING_ID PortTitleHelpToken;
|
|
|
|
ISCSI_SESSION_CONFIG_NVDATA SessionConfigData;
|
|
ISCSI_CHAP_AUTH_CONFIG_NVDATA AuthConfigData;
|
|
} ISCSI_CONFIG_FORM_ENTRY;
|
|
|
|
typedef struct _ISCSI_FORM_CALLBACK_INFO {
|
|
UINTN Signature;
|
|
EFI_HANDLE DriverHandle;
|
|
EFI_HII_CONFIG_ACCESS_PROTOCOL ConfigAccess;
|
|
EFI_HII_DATABASE_PROTOCOL *HiiDatabase;
|
|
EFI_HII_CONFIG_ROUTING_PROTOCOL *ConfigRouting;
|
|
UINT16 *KeyList;
|
|
VOID *FormBuffer;
|
|
EFI_HII_HANDLE RegisteredHandle;
|
|
ISCSI_CONFIG_FORM_ENTRY *Current;
|
|
} ISCSI_FORM_CALLBACK_INFO;
|
|
|
|
/**
|
|
Updates the iSCSI configuration form to add/delete an entry for the iSCSI
|
|
device specified by the Controller.
|
|
|
|
@param[in] DriverBindingHandle The driverbinding handle.
|
|
@param[in] Controller The controller handle of the iSCSI device.
|
|
@param[in] AddForm Whether to add or delete a form entry.
|
|
|
|
@retval EFI_SUCCESS The iSCSI configuration form is updated.
|
|
@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.
|
|
@retval Others Other errors as indicated.
|
|
**/
|
|
EFI_STATUS
|
|
IScsiConfigUpdateForm (
|
|
IN EFI_HANDLE DriverBindingHandle,
|
|
IN EFI_HANDLE Controller,
|
|
IN BOOLEAN AddForm
|
|
);
|
|
|
|
/**
|
|
Initialize the iSCSI configuration form.
|
|
|
|
@param[in] DriverBindingHandle The iSCSI driverbinding handle.
|
|
|
|
@retval EFI_SUCCESS The iSCSI configuration form is initialized.
|
|
@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.
|
|
@retval Others Other errors as indicated.
|
|
**/
|
|
EFI_STATUS
|
|
IScsiConfigFormInit (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
Unload the iSCSI configuration form, this includes: delete all the iSCSI
|
|
device configuration entries, uninstall the form callback protocol and
|
|
free the resources used.
|
|
|
|
@param[in] DriverBindingHandle The iSCSI driverbinding handle.
|
|
|
|
@retval EFI_SUCCESS The iSCSI configuration form is unloaded.
|
|
@retval EFI_OUT_OF_RESOURCES Failed to allocate memory.
|
|
**/
|
|
EFI_STATUS
|
|
IScsiConfigFormUnload (
|
|
IN EFI_HANDLE DriverBindingHandle
|
|
);
|
|
|
|
#endif
|