github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-07-31 15:30:56 +00:00
Code Issues Projects Releases Wiki Activity

doc: add a little info on how to configure the boot options

Browse Source 
Add a little information (at least pointers) as to how one can change the VM
(Pre-launched, Service or User) boot options.

Tracked-On: #3758
Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
This commit is contained in:
Geoffroy Van Cutsem 2019-10-03 11:03:54 +02:00 committed by deb-intel
parent ee8a3e3826
commit e0b323f5ef
1 changed files with 28 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/introduction/index.rst
View File

@ -378,6 +378,9 @@ and many other features.
Boot Sequence Boot Sequence
************* *************
.. _systemd-boot: https://www.freedesktop.org/software/systemd/man/systemd-boot.html
.. _grub: https://www.gnu.org/software/grub/manual/grub/
ACRN supports two kinds of boots: **De-privilege boot mode** and **Direct ACRN supports two kinds of boots: **De-privilege boot mode** and **Direct
boot mode**. boot mode**.
@ -408,6 +411,28 @@ The Boot process proceeds as follows:
services shall not use IOMMU. In addition, currently we only support services shall not use IOMMU. In addition, currently we only support
UEFI timer with HPET MSI. UEFI timer with HPET MSI.
In this boot mode, both the Service and User VM boot options (e.g. Linux
command-line parameters) are configured following the instructions for the EFI
bootloader used by the Operating System (OS).
* In the case of Clear Linux, this EFI bootloader is `systemd-boot`_ and Linux
kernel command-line parameters are defined in the ``.conf`` files.
* Another popular EFI bootloader used by Linux distributions is `grub`_.
Distributions like Ubuntu/Debian, Fedora/CentOS use `grub`_
.. note::
The `Slim Bootloader <https://www.intel.com/content/www/us/en/design/products-and-solutions/technologies/slim-bootloader/overview.html>`_
is an alternative boot firmware that can be used to boot ACRN. The `Boot ACRN Hyervisor <https://slimbootloader.github.io/how-tos/boot-acrn.html>`_
and :ref:`using-sbl-up2` tutorials have more information on how to use SBL with ACRN.
.. note::
A virtual `Slim Bootloader <https://www.intel.com/content/www/us/en/design/products-and-solutions/technologies/slim-bootloader/overview.html>`_
can also be used to start User VMs, it is called ``vSBL``. The :ref:`acrn-dm_parameters` has more information
on how to boot a User VM using ``vSBL``. Note that in this case, the kernel command-line parameters are
defined by the combination of the ``cmdline.txt`` passed on to the ``iasimage`` script and in the launch script, via the ``-B`` option.
Direct boot mode Direct boot mode
================ ================
@ -429,6 +454,9 @@ The Boot process proceeds as follows:
the ACRN Device Model and Virtual bootloader through dm-verity the ACRN Device Model and Virtual bootloader through dm-verity
#. Virtual bootloader starts the User-side verified boot process #. Virtual bootloader starts the User-side verified boot process
In this boot mode, the boot options are defined via the ``VM{x}_CONFIG_OS_BOOTARGS``
macro in the source code (replace ``{x}`` with the VM number).
ACRN Hypervisor Architecture ACRN Hypervisor Architecture
**************************** ****************************