IntelFrameworkModulePkg/Universal/StatusCode/RuntimeDxe/RtMemoryStatusCodeWorker.c

   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
  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
  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