spl: Add function comments to spl_start_uboot()
authorSimon Glass <sjg@chromium.org>
Sun, 25 Sep 2016 00:19:55 +0000 (18:19 -0600)
committerTom Rini <trini@konsulko.com>
Thu, 6 Oct 2016 18:48:19 +0000 (14:48 -0400)
Add some comments to describe this function.

Signed-off-by: Simon Glass <sjg@chromium.org>
Reviewed-by: Tom Rini <trini@konsulko.com>
include/spl.h

index 7fba485..16f1ef4 100644 (file)
@@ -110,7 +110,18 @@ int spl_board_ubi_load_image(u32 boot_device);
  */
 void __noreturn jump_to_image_linux(struct spl_image_info *spl_image,
                                    void *arg);
+
+/**
+ * spl_start_uboot() - Check if SPL should start the kernel or U-Boot
+ *
+ * This is called by the various SPL loaders to determine whether the board
+ * wants to load the kernel or U-Boot. This function should be provided by
+ * the board.
+ *
+ * @return 0 if SPL should start the kernel, 1 if U-Boot must be started
+ */
 int spl_start_uboot(void);
+
 void spl_display_print(void);
 
 /* NAND SPL functions */