| commit | 9021a06da0b0820250842d6a9a6c8beddcb4b246 | [log] [tgz] |
|---|---|---|
| author | Aryk Ledet <arykledet@google.com> | Fri May 17 03:00:32 2024 +0000 |
| committer | Aryk Ledet <arykledet@google.com> | Tue May 21 22:35:52 2024 +0000 |
| tree | 1a649a6b282a33d2c5cfcf255b454b6673d868ae | |
| parent | ef2967ab59ebaabe2892c8c15412f997d6fa80b1 [diff] |
Add polymorphic cper encoder class This class is intended to be the base of other CperEncoders, the mockEncoder is a generic example of how this would look. Change-Id: Ic0126a767ca8c2827ae32b6716c27c3b42803c5a Signed-off-by: Aryk Ledet <arykledet@google.com>
This is a header-only library which provides a generic interface for users to write application specific UEFI CPER log encoders.
The UEFI specification for CPER logs allows for many combinations of Record Header and Section Descriptor properties based on the application. However, the underlying data structure does not change from application to application. To make it easier for gBMC applications to log faults in the CPER format the user only needs to specify the type of Record and Section type(s) that the encoder will need to create.
When developing and testing your application specific encoders, you will need to install this library into your development container.
Below is some pseudo code of how a user would setup their application specific CPER encoder which takes in char array types.
class MyCperEncoder : public CperEncoder<char> { RecordHeader createRecordHeader(...) override {...} SectionDescriptor createSectionDescriptor(...) override { if (sectionType == kPlatformMemory) { return createPlatformMemoryDescriptor(); } else if (sectionType == kOemSection) { return createOemDescriptor(); } ... } SectionDescriptor createPlatformMemoryDescriptor() {...} SectionDescriptor createOemDescriptor() {...} }
meson setup -C builddir meson install -C builddir
meson test -C builddir