1 /** @file
2 Runtime memory status code worker.
3
4 Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>
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 #include "StatusCodeRuntimeDxe.h"
16
17 RUNTIME_MEMORY_STATUSCODE_HEADER *mRtMemoryStatusCodeTable;
18
19 /**
20 Initialize runtime memory status code table as initialization for runtime memory status code worker
21
22 @retval EFI_SUCCESS Runtime memory status code table successfully initialized.
23
24 **/
25 EFI_STATUS
RtMemoryStatusCodeInitializeWorker(VOID)26 RtMemoryStatusCodeInitializeWorker (
27 VOID
28 )
29 {
30 //
31 // Allocate runtime memory status code pool.
32 //
33 mRtMemoryStatusCodeTable = AllocateRuntimePool (
34 sizeof (RUNTIME_MEMORY_STATUSCODE_HEADER) +
35 PcdGet16 (PcdStatusCodeMemorySize) * 1024
36 );
37 ASSERT (mRtMemoryStatusCodeTable != NULL);
38
39 mRtMemoryStatusCodeTable->RecordIndex = 0;
40 mRtMemoryStatusCodeTable->NumberOfRecords = 0;
41 mRtMemoryStatusCodeTable->MaxRecordsNumber =
42 (PcdGet16 (PcdStatusCodeMemorySize) * 1024) / sizeof (MEMORY_STATUSCODE_RECORD);
43
44 return EFI_SUCCESS;
45 }
46
47
48 /**
49 Report status code into runtime memory. If the runtime pool is full, roll back to the
50 first record and overwrite it.
51
52 @param CodeType Indicates the type of status code being reported.
53 @param Value Describes the current status of a hardware or software entity.
54 This included information about the class and subclass that is used to
55 classify the entity as well as an operation.
56 @param Instance The enumeration of a hardware or software entity within
57 the system. Valid instance numbers start with 1.
58
59 @retval EFI_SUCCESS Status code successfully recorded in runtime memory status code table.
60
61 **/
62 EFI_STATUS
RtMemoryStatusCodeReportWorker(IN EFI_STATUS_CODE_TYPE CodeType,IN EFI_STATUS_CODE_VALUE Value,IN UINT32 Instance)63 RtMemoryStatusCodeReportWorker (
64 IN EFI_STATUS_CODE_TYPE CodeType,
65 IN EFI_STATUS_CODE_VALUE Value,
66 IN UINT32 Instance
67 )
68 {
69 MEMORY_STATUSCODE_RECORD *Record;
70
71 //
72 // Locate current record buffer.
73 //
74 Record = (MEMORY_STATUSCODE_RECORD *) (mRtMemoryStatusCodeTable + 1);
75 Record = &Record[mRtMemoryStatusCodeTable->RecordIndex++];
76
77 //
78 // Save status code.
79 //
80 Record->CodeType = CodeType;
81 Record->Value = Value;
82 Record->Instance = Instance;
83
84 //
85 // If record index equals to max record number, then wrap around record index to zero.
86 //
87 // The reader of status code should compare the number of records with max records number,
88 // If it is equal to or larger than the max number, then the wrap-around had happened,
89 // so the first record is pointed by record index.
90 // If it is less then max number, index of the first record is zero.
91 //
92 mRtMemoryStatusCodeTable->NumberOfRecords++;
93 if (mRtMemoryStatusCodeTable->RecordIndex == mRtMemoryStatusCodeTable->MaxRecordsNumber) {
94 //
95 // Wrap around record index.
96 //
97 mRtMemoryStatusCodeTable->RecordIndex = 0;
98 }
99
100 return EFI_SUCCESS;
101 }
102
103
104
105