9344f09215
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com>
126 lines
6.1 KiB
C
126 lines
6.1 KiB
C
/** @file
|
|
EFI Driver Diagnostics Protocol
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef __EFI_DRIVER_DIAGNOSTICS_H__
|
|
#define __EFI_DRIVER_DIAGNOSTICS_H__
|
|
|
|
///
|
|
/// The global ID for the Driver Diagnostics Protocol as defined in EFI 1.1.
|
|
///
|
|
#define EFI_DRIVER_DIAGNOSTICS_PROTOCOL_GUID \
|
|
{ \
|
|
0x0784924f, 0xe296, 0x11d4, {0x9a, 0x49, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d } \
|
|
}
|
|
|
|
typedef struct _EFI_DRIVER_DIAGNOSTICS_PROTOCOL EFI_DRIVER_DIAGNOSTICS_PROTOCOL;
|
|
|
|
typedef enum {
|
|
///
|
|
/// Performs standard diagnostics on the controller.
|
|
///
|
|
EfiDriverDiagnosticTypeStandard = 0,
|
|
///
|
|
/// This is an optional diagnostic type that performs diagnostics on the controller that may
|
|
/// take an extended amount of time to execute.
|
|
///
|
|
EfiDriverDiagnosticTypeExtended = 1,
|
|
///
|
|
/// This is an optional diagnostic type that performs diagnostics on the controller that are
|
|
/// suitable for a manufacturing and test environment.
|
|
///
|
|
EfiDriverDiagnosticTypeManufacturing= 2,
|
|
///
|
|
/// This is an optional diagnostic type that would only be used in the situation where an
|
|
/// EFI_NOT_READY had been returned by a previous call to RunDiagnostics()
|
|
/// and there is a desire to cancel the current running diagnostics operation.
|
|
///
|
|
EfiDriverDiagnosticTypeCancel = 3,
|
|
EfiDriverDiagnosticTypeMaximum
|
|
} EFI_DRIVER_DIAGNOSTIC_TYPE;
|
|
|
|
/**
|
|
Runs diagnostics on a controller.
|
|
|
|
@param This A pointer to the EFI_DRIVER_DIAGNOSTICS_PROTOCOL instance.
|
|
@param ControllerHandle The handle of the controller to run diagnostics on.
|
|
@param ChildHandle The handle of the child controller to run diagnostics on
|
|
This is an optional parameter that may be NULL. It will
|
|
be NULL for device drivers. It will also be NULL for a
|
|
bus drivers that wish to run diagnostics on the bus
|
|
controller. It will not be NULL for a bus driver that
|
|
wishes to run diagnostics on one of its child controllers.
|
|
@param DiagnosticType Indicates type of diagnostics to perform on the controller
|
|
specified by ControllerHandle and ChildHandle. See
|
|
"Related Definitions" for the list of supported types.
|
|
@param Language A pointer to a three character ISO 639-2 language
|
|
identifier. This is the language in which the optional
|
|
error message should be returned in Buffer, and it must
|
|
match one of the languages specified in SupportedLanguages.
|
|
The number of languages supported by a driver is up to
|
|
the driver writer.
|
|
@param ErrorType A GUID that defines the format of the data returned in Buffer.
|
|
@param BufferSize The size, in bytes, of the data returned in Buffer.
|
|
@param Buffer A buffer that contains a Null-terminated string
|
|
plus some additional data whose format is defined by
|
|
ErrorType. Buffer is allocated by this function with
|
|
AllocatePool(), and it is the caller's responsibility
|
|
to free it with a call to FreePool().
|
|
|
|
@retval EFI_SUCCESS The controller specified by ControllerHandle and
|
|
ChildHandle passed the diagnostic.
|
|
@retval EFI_INVALID_PARAMETER ControllerHandle is NULL.
|
|
@retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid EFI_HANDLE.
|
|
@retval EFI_INVALID_PARAMETER Language is NULL.
|
|
@retval EFI_INVALID_PARAMETER ErrorType is NULL.
|
|
@retval EFI_INVALID_PARAMETER BufferType is NULL.
|
|
@retval EFI_INVALID_PARAMETER Buffer is NULL.
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support
|
|
running diagnostics for the controller specified
|
|
by ControllerHandle and ChildHandle.
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support the
|
|
type of diagnostic specified by DiagnosticType.
|
|
@retval EFI_UNSUPPORTED The driver specified by This does not support the
|
|
language specified by Language.
|
|
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to complete
|
|
the diagnostics.
|
|
@retval EFI_OUT_OF_RESOURCES There are not enough resources available to return
|
|
the status information in ErrorType, BufferSize,
|
|
and Buffer.
|
|
@retval EFI_DEVICE_ERROR The controller specified by ControllerHandle and
|
|
ChildHandle did not pass the diagnostic.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_DRIVER_DIAGNOSTICS_RUN_DIAGNOSTICS)(
|
|
IN EFI_DRIVER_DIAGNOSTICS_PROTOCOL *This,
|
|
IN EFI_HANDLE ControllerHandle,
|
|
IN EFI_HANDLE ChildHandle OPTIONAL,
|
|
IN EFI_DRIVER_DIAGNOSTIC_TYPE DiagnosticType,
|
|
IN CHAR8 *Language,
|
|
OUT EFI_GUID **ErrorType,
|
|
OUT UINTN *BufferSize,
|
|
OUT CHAR16 **Buffer
|
|
);
|
|
|
|
///
|
|
/// Used to perform diagnostics on a controller that an EFI Driver is managing.
|
|
///
|
|
struct _EFI_DRIVER_DIAGNOSTICS_PROTOCOL {
|
|
EFI_DRIVER_DIAGNOSTICS_RUN_DIAGNOSTICS RunDiagnostics;
|
|
///
|
|
/// A Null-terminated ASCII string that contains one or more ISO 639-2
|
|
/// language codes. This is the list of language codes that this protocol supports.
|
|
///
|
|
CHAR8 *SupportedLanguages;
|
|
};
|
|
|
|
extern EFI_GUID gEfiDriverDiagnosticsProtocolGuid;
|
|
|
|
#endif
|