cbmem_console: Document known reimpementations of console structure/API

It turns out that there are quite a few other projects that can access
the CBMEM console by now. If we ever want to make another structural or
behavioral change to it, we need to know where these implementations are
so we can make sure they're all getting updated. Let's try to build a
comprehensive list in the file that should be the source of truth for
all (coreboot's own implementation).

Change-Id: Ia3d6a87230f5bfdde9d812bc7154e22880c1377a
Signed-off-by: Julius Werner <jwerner@chromium.org>
Reviewed-on: https://review.coreboot.org/19439
Tested-by: build bot (Jenkins)
Reviewed-by: Paul Menzel <paulepanter@users.sourceforge.net>
Reviewed-by: Aaron Durbin <adurbin@chromium.org>
This commit is contained in:
Julius Werner 2017-04-24 17:08:06 -07:00
parent dae95f0dfe
commit a915cea289
1 changed files with 10 additions and 0 deletions

View File

@ -28,6 +28,16 @@
* cursor field gets set to indicate that this happened. If the underlying
* storage allows this, the buffer will persist across multiple boots and append
* to the previous log.
*
* NOTE: These are known implementations accessing this console that need to be
* updated in case of structure/API changes:
*
* cbmem: [coreboot]/src/util/cbmem/cbmem.c
* libpayload: [coreboot]/payloads/libpayload/drivers/cbmem_console.c
* coreinfo: [coreboot]/payloads/coreinfo/bootlog_module.c
* Linux: drivers/firmware/google/memconsole-coreboot.c
* SeaBIOS: src/firmware/coreboot.c
* GRUB: grub-core/term/i386/coreboot/cbmemc.c
*/
struct cbmem_console {
u32 size;