Documentation: man-page for command bootd
authorHeinrich Schuchardt <heinrich.schuchardt@canonical.com>
Mon, 14 Nov 2022 09:30:58 +0000 (10:30 +0100)
committerHeinrich Schuchardt <heinrich.schuchardt@canonical.com>
Wed, 16 Nov 2022 07:34:06 +0000 (08:34 +0100)
Provide a man-page for the bootd command.

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
doc/usage/cmd/bootd.rst [new file with mode: 0644]
doc/usage/index.rst

diff --git a/doc/usage/cmd/bootd.rst b/doc/usage/cmd/bootd.rst
new file mode 100644 (file)
index 0000000..380ef15
--- /dev/null
@@ -0,0 +1,38 @@
+.. SPDX-License-Identifier: GPL-2.0+:
+
+bootd command
+=============
+
+Synopsis
+--------
+
+::
+
+    bootd
+
+Description
+-----------
+
+The bootd command executes the command stored in the environment variable
+*bootcmd*, i.e. it does the same thing as *run bootcmd*.
+
+Example
+-------
+
+::
+
+    => setenv bootcmd 'echo Hello World'
+    => bootd
+    Hello World
+    => setenv bootcmd true
+    => bootd; echo $?
+    0
+    => setenv bootcmd false
+    => bootd; echo $?
+    1
+
+Return value
+------------
+
+The return value $? of the bootd command is the return value of the command in
+the environment variable *bootcmd*.
index f7f03ae..815b032 100644 (file)
@@ -23,6 +23,7 @@ Shell commands
    cmd/addrmap
    cmd/askenv
    cmd/base
+   cmd/bootd
    cmd/bootdev
    cmd/bootefi
    cmd/bootflow