summaryrefslogtreecommitdiff
path: root/src/include
diff options
context:
space:
mode:
authorAaron Durbin <adurbin@chromium.org>2016-08-10 11:42:42 -0500
committerMartin Roth <martinroth@google.com>2016-08-19 03:07:05 +0200
commitdcbccd6a1ef1ee70d6e96f01c55c8ed270f37716 (patch)
tree42b75c89383427f56acc3c2f8a44f0b9d9233232 /src/include
parente8e118dd324e32070a1550e3f8ff90dd6fad72f8 (diff)
downloadcoreboot-dcbccd6a1ef1ee70d6e96f01c55c8ed270f37716.tar.xz
lib/boot_device: add RW boot device construct
The current boot device usage assumes read-only semantics to the boot device. Any time someone wants to write to the boot device a device-specific API is invoked such as SPI flash. Instead, provide a mechanism to retrieve an object that can be used to perform writes to the boot device. On systems where the implementations are symmetric these devices can be treated one-in-the-same. However, for x86 systems with memory mapped SPI the read-only boot device provides different operations. BUG=chrome-os-partner:55932 Change-Id: I0af324824f9e1a8e897c2453c36e865b59c4e004 Signed-off-by: Aaron Durbin <adurbin@chromium.org> Reviewed-on: https://review.coreboot.org/16194 Tested-by: build bot (Jenkins) Reviewed-by: Furquan Shaikh <furquan@google.com> Reviewed-by: Paul Menzel <paulepanter@users.sourceforge.net>
Diffstat (limited to 'src/include')
-rw-r--r--src/include/boot_device.h16
1 files changed, 16 insertions, 0 deletions
diff --git a/src/include/boot_device.h b/src/include/boot_device.h
index 3964a9508c..cc70442e1e 100644
--- a/src/include/boot_device.h
+++ b/src/include/boot_device.h
@@ -18,9 +18,18 @@
#include <commonlib/region.h>
+/*
+ * Please note that the read-only boot device may not be coherent with
+ * the read-write boot device. Thus, mixing mmap() and writeat() is
+ * most likely not to work so don't rely on such semantics.
+ */
+
/* Return the region_device for the read-only boot device. */
const struct region_device *boot_device_ro(void);
+/* Return the region_device for the read-write boot device. */
+const struct region_device *boot_device_rw(void);
+
/*
* Create a sub-region of the read-only boot device.
* Returns 0 on success, < 0 on error.
@@ -29,6 +38,13 @@ int boot_device_ro_subregion(const struct region *sub,
struct region_device *subrd);
/*
+ * Create a sub-region of the read-write boot device.
+ * Returns 0 on success, < 0 on error.
+ */
+int boot_device_rw_subregion(const struct region *sub,
+ struct region_device *subrd);
+
+/*
* Initialize the boot device. This may be called multiple times within
* a stage so boot device implementations should account for this behavior.
**/