acrn-hypervisor/debian/grub-acrn.README.Debian
Helmut Buchsbaum f8ec83e628 debian: grub-acrn: Rework to provide configuration interface for GRUB
* Simplify grub-mkconfig helper script,
* Append Service VM kernel boot parameters to ACRN parameter in
  multiboot/multiboot2 line to avoid overriding the configured settings,
* Support GRUB configuration for pre-launched VMs,
* Extend and document the GRUB variables for controlling GRUB boot
  menu generation.

Tracked-On: #8274
Signed-off-by: Helmut Buchsbaum <helmut.buchsbaum@opensource.tttech-industrial.com>
2022-11-22 10:33:58 +08:00

32 lines
1.4 KiB
Plaintext

ACRN specific GRUB configuration items
--------------------------------------
The following variables can be set and exported in /etc/default/grub.d/acrn.cfg
to control GRUB boot menu generation for ACRN:
GRUB_CMDLINE_ACRN: command line parameter for the ACRN hypervisor. This will
be merged with parameters from ACRN configuration. E.g.
add a required uart parameter, see
https://projectacrn.github.io/latest/user-guides/hv-parameters.html
GRUB_CMDLINE_LINUX and GRUB_CMDLINE_LINUX_DEFAULT (in /etc/default/grub) can be
used as usual and apply to the ACRN Service VM only. They are appended to the
settings provided by ACRN configuration.
ACRN VM specific variables:
GRUB_ACRN_MOD_CMDLINE_<tagname>: kernel command line parameter for VM using the
kernel module tag <tagname> in its configuration.
Attention: Using GRUB_ACRN_MOD_CMDLINE_<tagname> for Service VM associated kernel
module tag will *OVERRIDE* the settings provided by ACRN configuration
and is *NOT* recommended! So, be careful!
GRUB_ACRN_MOD_<tagname>: path of the module tagged with <tagname>. This is valid
for kernel module tags, ramdisk module tags and acpi
module tags.
Remember: There is no need to set the acpi module tag, since it defaults to
generated /boot/ACPI_VMx.bin anyway!