bootstd: Add a new bootmeth method to set the bootflow
authorSimon Glass <sjg@chromium.org>
Tue, 17 Jan 2023 17:48:01 +0000 (10:48 -0700)
committerTom Rini <trini@konsulko.com>
Mon, 23 Jan 2023 23:11:41 +0000 (18:11 -0500)
Normally the bootmeth driver reads the bootflow from the bootdev, since
it knows the correct way to do it.

However it is easier for some bootdevs to handle this themselves. For
example, reading from SPI flash is quite different from other devices.

Add a way for the bootdev to pass a bootflow to the bootmeth, so that
this can be supported.

Signed-off-by: Simon Glass <sjg@chromium.org>
boot/bootmeth-uclass.c
include/bootmeth.h

index 4c3529d..2aee1e0 100644 (file)
@@ -50,6 +50,17 @@ int bootmeth_read_bootflow(struct udevice *dev, struct bootflow *bflow)
        return ops->read_bootflow(dev, bflow);
 }
 
+int bootmeth_set_bootflow(struct udevice *dev, struct bootflow *bflow,
+                         char *buf, int size)
+{
+       const struct bootmeth_ops *ops = bootmeth_get_ops(dev);
+
+       if (!ops->set_bootflow)
+               return -ENOSYS;
+
+       return ops->set_bootflow(dev, bflow, buf, size);
+}
+
 int bootmeth_boot(struct udevice *dev, struct bootflow *bflow)
 {
        const struct bootmeth_ops *ops = bootmeth_get_ops(dev);
index bdce301..b12dfd4 100644 (file)
@@ -88,6 +88,22 @@ struct bootmeth_ops {
        int (*read_bootflow)(struct udevice *dev, struct bootflow *bflow);
 
        /**
+        * set_bootflow() - set the bootflow for a device
+        *
+        * This provides a bootflow file to the bootmeth, to see if it is valid.
+        * If it is, the bootflow is set up accordingly.
+        *
+        * @dev:        Bootmethod device to use
+        * @bflow:      On entry, provides bootdev.
+        *      Returns updated bootflow if found
+        * @buf:        Buffer containing the possible bootflow file
+        * @size:       Size of file
+        * Return: 0 if OK, -ve on error
+        */
+       int (*set_bootflow)(struct udevice *dev, struct bootflow *bflow,
+                           char *buf, int size);
+
+       /**
         * read_file() - read a file needed for a bootflow
         *
         * Read a file from the same place as the bootflow came from
@@ -174,6 +190,23 @@ int bootmeth_check(struct udevice *dev, struct bootflow_iter *iter);
 int bootmeth_read_bootflow(struct udevice *dev, struct bootflow *bflow);
 
 /**
+ * bootmeth_set_bootflow() - set the bootflow for a device
+ *
+ * This provides a bootflow file to the bootmeth, to see if it is valid.
+ * If it is, the bootflow is set up accordingly.
+ *
+ * @dev:       Bootmethod device to use
+ * @bflow:     On entry, provides bootdev.
+ *     Returns updated bootflow if found
+ * @buf:       Buffer containing the possible bootflow file (must be allocated
+ * by caller to @size + 1 bytes)
+ * @size:      Size of file
+ * Return: 0 if OK, -ve on error
+ */
+int bootmeth_set_bootflow(struct udevice *dev, struct bootflow *bflow,
+                         char *buf, int size);
+
+/**
  * bootmeth_read_file() - read a file needed for a bootflow
  *
  * Read a file from the same place as the bootflow came from