Gitiles
Code Review Sign In
gerrit.openbmc.org / openbmc / libcper / cc36701137e8ad0e7a537c624cd486fb72fb66de / . / generator
tree: 030c7c285666aef25fa3302ef2b6f7cee7f00846 [path history] [tgz]
  1. sections/
  2. cper-generate-cli.c
  3. cper-generate.c
  4. gen-utils.c
  5. README.md
generator/README.md

cper-generator

This project allows you to generate pseudo-random CPER records for software testing purposes. The records are compliant (to an extent) with the CPER definitions present within UEFI Specification Appendix N.

Usage

An example usage of cper-generator is shown below.

cper-generator --out mycper.dump --sections generic dmarvtd ia32x64 arm

This command would generate a CPER log with a processor generic section, VT-d DMAr section, IA32x64 section and an ARM section, outputting to the given mycper.dump file. To see all available names and other command switches, you can run cper-generator --help.

Caveats

The generator is not completely random within the bounds of the specification, to make testing easier.

  • Validation bits are always set to "true" for optional fields, to ensure that translating from CPER binary -> JSON -> CPER binary yields the same binary output as started with, rather than changing due to optional fields being left out.
  • Parts of sections which are defined in other external specifications (i.e, not included in UEFI Appendix N) generally do not have their structures to specification, and are simply random bytes.