Edward O'Callaghan has uploaded this change for review.

View Change

layout: Hoist get_region_range() into libflashrom API

While using the libflashrom API to read specific regions
there is no currently no general way to find the offset
into the read buffer of the expected region.

flashrom_layout_include_region() probably should have
returned the region offset and size if it was included.
However to avoid a change in API signature we can instead
hoist up get_region_range() into the API to be called after.

BUG=b:207808292
TEST=`make`.

Change-Id: I8cf95b5eaec943a51d0ea668f26a56bf6d6b4446
Signed-off-by: Edward O'Callaghan <quasisec@google.com>
---
M cli_classic.c
M layout.c
M layout.h
M libflashrom.h
M tests/layout.c
5 files changed, 27 insertions(+), 16 deletions(-)

git pull ssh://review.coreboot.org:29418/flashrom refs/changes/81/60881/1
diff --git a/cli_classic.c b/cli_classic.c
index d69b798..fd5f90b 100644
--- a/cli_classic.c
+++ b/cli_classic.c
@@ -782,7 +782,7 @@
}

if (set_wp_region && wp_region) {
- if (get_region_range(layout, wp_region, &wp_start, &wp_len)) {
+ if (flashrom_get_region_range(layout, wp_region, &wp_start, &wp_len)) {
ret = 1;
goto out_release;
}
diff --git a/layout.c b/layout.c
index 534deba..e99348f 100644
--- a/layout.c
+++ b/layout.c
@@ -188,18 +188,6 @@
return 0;
}

-int get_region_range(struct flashrom_layout *const l, const char *name,
- unsigned int *start, unsigned int *len)
-{
- const struct romentry *const entry = _layout_entry_by_name(l, name);
- if (entry) {
- *start = entry->start;
- *len = entry->end - entry->start + 1;
- return 0;
- }
- return 1;
-}
-
/* process -i arguments
* returns 0 to indicate success, >0 to indicate failure
*/
@@ -445,6 +433,29 @@
}

/**
+ * @brief Get given region's offset and length.
+ *
+ * @param layout The layout to alter.
+ * @param name The name of the region.
+ * @param start The start address to be written.
+ * @param len The length of the region to be written.
+ *
+ * @return 0 on success,
+ * 1 if the given name can't be found.
+ */
+int flashrom_get_region_range(struct flashrom_layout *const l, const char *name,
+ unsigned int *start, unsigned int *len)
+{
+ const struct romentry *const entry = _layout_entry_by_name(l, name);
+ if (entry) {
+ *start = entry->start;
+ *len = entry->end - entry->start + 1;
+ return 0;
+ }
+ return 1;
+}
+
+/**
* @brief Free a layout.
*
* @param layout Layout to free.
diff --git a/layout.h b/layout.h
index 713241f..abbdc22 100644
--- a/layout.h
+++ b/layout.h
@@ -59,8 +59,6 @@
int process_include_args(struct flashrom_layout *, const struct layout_include_args *);
void cleanup_include_args(struct layout_include_args **);

-int get_region_range(struct flashrom_layout *, const char *name,
- unsigned int *start, unsigned int *len);
const struct romentry *layout_next_included_region(const struct flashrom_layout *, chipoff_t);
const struct romentry *layout_next_included(const struct flashrom_layout *, const struct romentry *);
const struct romentry *layout_next(const struct flashrom_layout *, const struct romentry *);
diff --git a/libflashrom.h b/libflashrom.h
index 3bd6855..5c6568a 100644
--- a/libflashrom.h
+++ b/libflashrom.h
@@ -114,6 +114,8 @@
struct flashrom_flashctx *, const uint8_t *buf, size_t len);
int flashrom_layout_add_region(struct flashrom_layout *, size_t start, size_t end, const char *name);
int flashrom_layout_include_region(struct flashrom_layout *, const char *name);
+int flashrom_get_region_range(struct flashrom_layout *, const char *name,
+ unsigned int *start, unsigned int *len);
void flashrom_layout_release(struct flashrom_layout *);
void flashrom_layout_set(struct flashrom_flashctx *, const struct flashrom_layout *);

diff --git a/tests/layout.c b/tests/layout.c
index 59e409b..c067e15 100644
--- a/tests/layout.c
+++ b/tests/layout.c
@@ -121,7 +121,7 @@
printf("done\n");

printf("Asserting region range... ");
- get_region_range(layout, "region", &start, &len);
+ flashrom_get_region_range(layout, "region", &start, &len);
assert_int_equal(start, region_start);
assert_int_equal(len, region_end - region_start + 1);
printf("done\n");

To view, visit change 60881. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-Project: flashrom
Gerrit-Branch: master
Gerrit-Change-Id: I8cf95b5eaec943a51d0ea668f26a56bf6d6b4446
Gerrit-Change-Number: 60881
Gerrit-PatchSet: 1
Gerrit-Owner: Edward O'Callaghan <quasisec@chromium.org>
Gerrit-MessageType: newchange