diff mbox series

[RESEND,3/3] docs: aspeed: Give an example of booting a kernel

Message ID 20211117010947.297540-4-joel@jms.id.au (mailing list archive)
State New, archived
Headers show
Series docs: aspeed: Minor updates | expand

Commit Message

Joel Stanley Nov. 17, 2021, 1:09 a.m. UTC
A common use case for the ASPEED machine is to boot a Linux kernel.
Provide a full example command line.

Signed-off-by: Joel Stanley <joel@jms.id.au>
---
 docs/system/arm/aspeed.rst | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

Comments

Cédric Le Goater Nov. 17, 2021, 6:47 a.m. UTC | #1
On 11/17/21 02:09, Joel Stanley wrote:
> A common use case for the ASPEED machine is to boot a Linux kernel.
> Provide a full example command line.
> 
> Signed-off-by: Joel Stanley <joel@jms.id.au>

Reviewed-by: Cédric Le Goater <clg@kaod.org>

Thanks

C.


> ---
>   docs/system/arm/aspeed.rst | 15 ++++++++++++---
>   1 file changed, 12 insertions(+), 3 deletions(-)
> 
> diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
> index 4bed7b5221b4..de408b0364ea 100644
> --- a/docs/system/arm/aspeed.rst
> +++ b/docs/system/arm/aspeed.rst
> @@ -77,9 +77,9 @@ Missing devices
>   Boot options
>   ------------
>   
> -The Aspeed machines can be started using the ``-kernel`` option to
> -load a Linux kernel or from a firmware. Images can be downloaded from
> -the OpenBMC jenkins :
> +The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options
> +to load a Linux kernel or from a firmware. Images can be downloaded from the
> +OpenBMC jenkins :
>   
>      https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/
>   
> @@ -87,6 +87,15 @@ or directly from the OpenBMC GitHub release repository :
>   
>      https://github.com/openbmc/openbmc/releases
>   
> +To boot a kernel directly from a Linux build tree:
> +
> +.. code-block:: bash
> +
> +  $ qemu-system-arm -M ast2600-evb -nographic \
> +        -kernel arch/arm/boot/zImage \
> +        -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \
> +        -initrd rootfs.cpio
> +
>   The image should be attached as an MTD drive. Run :
>   
>   .. code-block:: bash
>
diff mbox series

Patch

diff --git a/docs/system/arm/aspeed.rst b/docs/system/arm/aspeed.rst
index 4bed7b5221b4..de408b0364ea 100644
--- a/docs/system/arm/aspeed.rst
+++ b/docs/system/arm/aspeed.rst
@@ -77,9 +77,9 @@  Missing devices
 Boot options
 ------------
 
-The Aspeed machines can be started using the ``-kernel`` option to
-load a Linux kernel or from a firmware. Images can be downloaded from
-the OpenBMC jenkins :
+The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options
+to load a Linux kernel or from a firmware. Images can be downloaded from the
+OpenBMC jenkins :
 
    https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/
 
@@ -87,6 +87,15 @@  or directly from the OpenBMC GitHub release repository :
 
    https://github.com/openbmc/openbmc/releases
 
+To boot a kernel directly from a Linux build tree:
+
+.. code-block:: bash
+
+  $ qemu-system-arm -M ast2600-evb -nographic \
+        -kernel arch/arm/boot/zImage \
+        -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \
+        -initrd rootfs.cpio
+
 The image should be attached as an MTD drive. Run :
 
 .. code-block:: bash