coreboot-kgpe-d16/util/cbfstool/cbfs_sections.c
Hung-Te Lin 9497fcb742 cbfstool: Change FMD annotation to flags
The idea of "annotation" for firmware sections was pretty flexible, but
in future we will want multiple attributes applied to same area. For
example, indicate the section must be preserved when updating firmware
so serial number or MAC address can be preserved.

The solution here is to extend annotation so it can take multiple
identifiers (flags) in a row. For example, to declare a 64KB COREBOOT
section as CBFS using annotation:

 COREBOOT(CBFS)@0x0 64k

If there's a new flag "PRESERVE" indicating the section must be
preserved before update, we can declare it following CBFS flag:

 COREBOOT(CBFS PRESERVE)@0x0 64k

The flags are directly parsed in fmd_parser, and stored in an union
flashmap_flags. Output modules can choose to ignore or process the
flags.

Currently the only supported flag is "CBFS" (for backward compatible
with annotation). There will be more new flags in follow up patches.

BUG=chromium:936768
TEST=make; boots on x86 "google/eve" and arm "google/kukui" devices

Change-Id: Ie2d99f570e6faff6ed3a4344d6af7526a4515fae
Signed-off-by: Hung-Te Lin <hungte@chromium.org>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/31706
Reviewed-by: Julius Werner <jwerner@chromium.org>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2019-03-05 19:31:43 +00:00

117 lines
2.6 KiB
C

/*
* fmap_sections.c, track which sections of the image will contain CBFSes
*
* Copyright (C) 2015 Google, Inc.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; version 2 of the License.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/
#include "cbfs_sections.h"
#include <assert.h>
#include <stdlib.h>
#include <string.h>
struct descriptor_node {
const struct flashmap_descriptor *val;
struct descriptor_node *next;
};
static struct descriptor_list {
struct descriptor_node *head;
struct descriptor_node *tail;
} cbfs_sections;
static bool seen_primary_section = false;
static void descriptor_list_prepend(struct descriptor_list *list,
struct descriptor_node *new_head)
{
assert(list);
assert(new_head);
new_head->next = list->head;
list->head = new_head;
if (!list->tail)
list->tail = new_head;
}
static void descriptor_list_append(struct descriptor_list *list,
struct descriptor_node *new_tail)
{
assert(list);
assert(new_tail);
if (list->tail)
list->tail->next = new_tail;
list->tail = new_tail;
if (!list->head)
list->head = new_tail;
}
/* Implementation of cbfs module's callback; invoked during fmd file parsing */
bool fmd_process_flag_cbfs(const struct flashmap_descriptor *node)
{
struct descriptor_node *list_node;
if (node->list_len != 0)
return false;
list_node = (struct descriptor_node *)malloc(sizeof(*list_node));
list_node->val = node;
list_node->next = NULL;
if (strcmp(node->name, SECTION_NAME_PRIMARY_CBFS) == 0) {
descriptor_list_prepend(&cbfs_sections, list_node);
seen_primary_section = true;
} else {
descriptor_list_append(&cbfs_sections, list_node);
}
return true;
}
cbfs_section_iterator_t cbfs_sections_iterator(void)
{
return cbfs_sections.head;
}
bool cbfs_sections_iterator_advance(cbfs_section_iterator_t *it)
{
assert(it);
if (!*it)
return false;
*it = (*it)->next;
return true;
}
const struct flashmap_descriptor *cbfs_sections_iterator_deref(
cbfs_section_iterator_t it)
{
assert(it);
return it->val;
}
bool cbfs_sections_primary_cbfs_accounted_for(void)
{
return seen_primary_section;
}
void cbfs_sections_cleanup(void)
{
for (struct descriptor_node *cur = cbfs_sections.head, *next = NULL;
cur; cur = next) {
next = cur->next;
free(cur);
}
cbfs_sections.head = NULL;
cbfs_sections.tail = NULL;
}