summaryrefslogtreecommitdiffstats
path: root/include/bootm.h
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2020-11-05 10:33:48 -0700
committerTom Rini <trini@konsulko.com>2020-12-04 19:48:29 -0500
commit51bb33846ad2b045799d2c43ca773fafa36e6ec8 (patch)
treef87835b392c62414199e5fb926d0f4f63d92ec9e /include/bootm.h
parent1a62d64c7de7e7de3facf221eb8408ddfb675cb8 (diff)
downloadu-boot-51bb33846ad2b045799d2c43ca773fafa36e6ec8.tar.gz
u-boot-51bb33846ad2b045799d2c43ca773fafa36e6ec8.tar.xz
u-boot-51bb33846ad2b045799d2c43ca773fafa36e6ec8.zip
bootm: Support string substitution in bootargs
In some cases it is necessary to pass parameters to Linux so that it will boot correctly. For example, the rootdev parameter is often used to specify the root device. However the root device may change depending on whence U-Boot loads the kernel. At present it is necessary to build up the command line by adding device strings to it one by one. It is often more convenient to provide a template for bootargs, with U-Boot doing the substitution from other environment variables. Add a way to substitute strings in the bootargs variable. This allows things like "rootdev=${rootdev}" to be used in bootargs, with the ${rootdev} substitution providing the UUID of the root device. For example, to substitute the GUID of the kernel partition: setenv bootargs "console=/dev/ttyS0 rootdev=${uuid}/PARTNROFF=1 kern_guid=${uuid}" part uuid mmc 2:2 uuid bootm This is particularly useful when the command line from another place. For example, Chrome OS stores the command line next to the kernel itself. It depends on the kernel version being used as well as the hardware features, so it is extremely difficult to devise a U-Boot script that works on all boards and kernel versions. With this feature, the command line can be read from disk and used directly, with a few substitutions set up. Signed-off-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'include/bootm.h')
-rw-r--r--include/bootm.h14
1 files changed, 10 insertions, 4 deletions
diff --git a/include/bootm.h b/include/bootm.h
index 8d95fb2a90..7f88ec718b 100644
--- a/include/bootm.h
+++ b/include/bootm.h
@@ -78,8 +78,9 @@ void switch_to_non_secure_mode(void);
/* Flags to control bootm_process_cmdline() */
enum bootm_cmdline_t {
BOOTM_CL_SILENT = 1 << 0, /* Do silent console processing */
+ BOOTM_CL_SUBST = 1 << 1, /* Do substitution */
- BOOTM_CL_ALL = 1, /* All substitutions */
+ BOOTM_CL_ALL = 3, /* All substitutions */
};
/**
@@ -95,7 +96,10 @@ void board_preboot_os(void);
/*
* bootm_process_cmdline() - Process fix-ups for the command line
*
- * This handles: making Linux boot silently if requested ('silent_linux' envvar)
+ * This handles:
+ *
+ * - making Linux boot silently if requested ('silent_linux' envvar)
+ * - performing substitutions in the command line ('bootargs_subst' envvar)
*
* @maxlen must provide enough space for the string being processed plus the
* resulting string
@@ -111,8 +115,10 @@ int bootm_process_cmdline(char *buf, int maxlen, int flags);
/**
* bootm_process_cmdline_env() - Process fix-ups for the command line
*
- * Updates the 'bootargs' envvar as required. This handles making Linux boot
- * silently if requested ('silent_linux' envvar)
+ * Updates the 'bootargs' envvar as required. This handles:
+ *
+ * - making Linux boot silently if requested ('silent_linux' envvar)
+ * - performing substitutions in the command line ('bootargs_subst' envvar)
*
* @flags: Flags to control what happens (see bootm_cmdline_t)
* @return 0 if OK, -ENOMEM if out of memory