96bc89db8dc80790dea5b8596844e69ac89c4b85
[mirror_edk2.git] / ShellPkg / DynamicCommand / DpDynamicCommand / Dp.h
1 /** @file
2 Header file for 'dp' command functions.
3
4 Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
9
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
12
13 **/
14
15 #ifndef _DP_H_
16 #define _DP_H_
17
18
19 #include <Uefi.h>
20
21 #include <Guid/Performance.h>
22 #include <Guid/ExtendedFirmwarePerformance.h>
23 #include <Guid/FirmwarePerformance.h>
24 #include <Guid/Acpi.h>
25
26 #include <Protocol/HiiPackageList.h>
27 #include <Protocol/DevicePath.h>
28 #include <Protocol/LoadedImage.h>
29 #include <Protocol/UnicodeCollation.h>
30
31 #include <Library/BaseLib.h>
32 #include <Library/BaseMemoryLib.h>
33 #include <Library/DebugLib.h>
34 #include <Library/MemoryAllocationLib.h>
35 #include <Library/ShellLib.h>
36 #include <Library/UefiLib.h>
37 #include <Library/UefiRuntimeServicesTableLib.h>
38 #include <Library/UefiBootServicesTableLib.h>
39 #include <Library/PcdLib.h>
40 #include <Library/SortLib.h>
41 #include <Library/HiiLib.h>
42 #include <Library/FileHandleLib.h>
43 #include <Library/UefiHiiServicesLib.h>
44 #include <Library/Performancelib.h>
45
46 extern EFI_HANDLE mDpHiiHandle;
47
48 #define DP_MAJOR_VERSION 2
49 #define DP_MINOR_VERSION 5
50
51 /**
52 * The value assigned to DP_DEBUG controls which debug output
53 * is generated. Set it to ZERO to disable.
54 **/
55 #define DP_DEBUG 0
56
57 #define DEFAULT_THRESHOLD 1000 ///< One millisecond.
58 #define DEFAULT_DISPLAYCOUNT 50
59 #define MAXIMUM_DISPLAYCOUNT 999999 ///< Arbitrary maximum reasonable number.
60
61 #define PERF_MAXDUR 0xFFFFFFFFFFFFFFFFULL
62
63 /// Determine whether 0 <= C < L. If L == 0, return true regardless of C.
64 #define WITHIN_LIMIT( C, L) ( ((L) == 0) || ((C) < (L)) )
65
66 /// Structure for storing Timer specific information.
67 typedef struct {
68 UINT64 StartCount; ///< Value timer is initialized with.
69 UINT64 EndCount; ///< Value timer has just before it wraps.
70 UINT32 Frequency; ///< Timer count frequency in KHz.
71 BOOLEAN CountUp; ///< TRUE if the counter counts up.
72 } TIMER_INFO;
73
74 /** Initialize one PERF_CUM_DATA structure instance for token t.
75 *
76 * This parameterized macro takes a single argument, t, which is expected
77 * to resolve to a pointer to an ASCII string literal. This parameter may
78 * take any one of the following forms:
79 * - PERF_INIT_CUM_DATA("Token") A string literal
80 * - PERF_INIT_CUM_DATA(pointer) A pointer -- CHAR8 *pointer;
81 * - PERF_INIT_CUM_DATA(array) Address of an array -- CHAR8 array[N];
82 **/
83 #define PERF_INIT_CUM_DATA(t) { 0ULL, PERF_MAXDUR, 0ULL, (t), 0U }
84
85 typedef struct {
86 UINT64 Duration; ///< Cumulative duration for this item.
87 UINT64 MinDur; ///< Smallest duration encountered.
88 UINT64 MaxDur; ///< Largest duration encountered.
89 CHAR8 *Name; ///< ASCII name of this item.
90 UINT32 Count; ///< Total number of measurements accumulated.
91 } PERF_CUM_DATA;
92
93 typedef struct {
94 UINT32 NumTrace; ///< Number of recorded TRACE performance measurements.
95 UINT32 NumIncomplete; ///< Number of measurements with no END value.
96 UINT32 NumSummary; ///< Number of summary section measurements.
97 UINT32 NumHandles; ///< Number of measurements with handles.
98 UINT32 NumPEIMs; ///< Number of measurements of PEIMs.
99 UINT32 NumGlobal; ///< Number of measurements with END value and NULL handle.
100 } PERF_SUMMARY_DATA;
101
102 typedef struct {
103 CONST VOID *Handle;
104 CONST CHAR8 *Token; ///< Measured token string name.
105 CONST CHAR8 *Module; ///< Module string name.
106 UINT64 StartTimeStamp; ///< Start time point.
107 UINT64 EndTimeStamp; ///< End time point.
108 UINT32 Identifier; ///< Identifier.
109 } MEASUREMENT_RECORD;
110
111 typedef struct {
112 CHAR8 *Name; ///< Measured token string name.
113 UINT64 CumulativeTime; ///< Accumulated Elapsed Time.
114 UINT64 MinTime; ///< Minimum Elapsed Time.
115 UINT64 MaxTime; ///< Maximum Elapsed Time.
116 UINT32 Count; ///< Number of measurements accumulated.
117 } PROFILE_RECORD;
118
119 /**
120 Dump performance data.
121
122 @param[in] ImageHandle The image handle.
123 @param[in] SystemTable The system table.
124
125 @retval SHELL_SUCCESS Command completed successfully.
126 @retval SHELL_INVALID_PARAMETER Command usage error.
127 @retval SHELL_ABORTED The user aborts the operation.
128 @retval value Unknown error.
129 **/
130 SHELL_STATUS
131 RunDp (
132 IN EFI_HANDLE ImageHandle,
133 IN EFI_SYSTEM_TABLE *SystemTable
134 );
135
136 /**
137 Retrive HII package list from ImageHandle and publish to HII database.
138
139 @param ImageHandle The image handle of the process.
140
141 @return HII handle.
142 **/
143 EFI_HANDLE
144 InitializeHiiPackage (
145 EFI_HANDLE ImageHandle
146 );
147 #endif // _DP_H_