diff --git a/doc/user-guides/acrn-dm-parameters.rst b/doc/user-guides/acrn-dm-parameters.rst index 9e197fab2..4a3810686 100644 --- a/doc/user-guides/acrn-dm-parameters.rst +++ b/doc/user-guides/acrn-dm-parameters.rst @@ -14,7 +14,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: :widths: 22 78 :header-rows: 0 - * - :kbd:`-A, --acpi` + * - ``-A``, ``--acpi`` - Create ACPI tables. With this option, DM will build an ACPI table into its VMs F-Segment (0xf2400). This ACPI table includes full tables for RSDP, RSDT, XSDT, @@ -22,7 +22,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: according to acrn-dm command line configuration and derived from their default value. - * - :kbd:`-B, --bootargs ` + * - ``-B``, ``--bootargs `` - Set the User VM kernel command-line arguments. The maximum length is 1023. The bootargs string will be passed to the kernel as its cmdline. @@ -33,15 +33,15 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: specifies the kernel log level at 7 - * - :kbd:`--debugexit` + * - ``--debugexit`` - Enable guest to write io port 0xf4 to exit guest. It's mainly used by guest unit test. - * - :kbd:`-E, --elf_file ` + * - ``-E``, ``--elf_file `` - This option is to define a static elf binary which could be loaded by DM. DM will run elf as guest of ACRN. - * - :kbd:`--enable_trusty` + * - ``--enable_trusty`` - Enable trusty for guest. For Android guest OS, ACRN provides a VM environment with two worlds: normal world and trusty world. The Android OS runs in the the normal @@ -51,7 +51,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: By default, the trusty world is disabled. Use this option to enable it. - * - :kbd:`-G, --gvtargs ` + * - ``-G``, ``--gvtargs `` - ACRN implements GVT-g for graphics virtualization (aka AcrnGT). This option allows you to set some of its parameters. @@ -70,10 +70,10 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: sets up 10Mb for GVT-g aperture, 128M for GVT-g hidden memory, and 6 fence registers. - * - :kbd:`-h, --help` + * - ``-h``, ``--help`` - Show a summary of commands. - * - :kbd:`-i, --ioc_node ` + * - ``-i``, ``--ioc_node `` - IOC (IO Controller) is a bridge of an SoC to communicate with Vehicle Bus. It routes Vehicle Bus signals, for example extracted from CAN messages, from IOC to the SoC and back, as well as controlling the onboard @@ -110,7 +110,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: -i /run/acrn/ioc_$vm_name,0x20 -l com2,/run/acrn/ioc_$vm_name - * - :kbd:`--intr_monitor ` + * - ``--intr_monitor `` - Enable interrupt storm monitor for User VM. Use this option to prevent an interrupt storm from the User VM. @@ -128,16 +128,16 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: - ``100``: after 100ms, we will cancel the interrupt injection delay and restore to normal. - * - :kbd:`-k, --kernel ` + * - ``-k``, ``--kernel `` - Set the kernel (full path) for the User VM kernel. The maximum path length is 1023 characters. The DM handles bzImage image format. usage: ``-k /path/to/your/kernel_image`` - * - :kbd:`-l, --lpc ` - - (See :kbd:`-i, --ioc_node`) + * - ``-l``, ``--lpc `` + - (See ``-i``, ``--ioc_node``) - * - :kbd:`-m, --memsize ` + * - ``-m``, ``--memsize `` - Setup total memory size for User VM. memory_size format is: "{K/k, B/b, M/m, G/g}", and size is an @@ -145,7 +145,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: usage: ``-m 4g``: set User VM memory to 4 gigabytes. - * - :kbd:`--mac_seed ` + * - ``--mac_seed `` - Set a platform unique string as a seed to generate the mac address. Each VM should have a different "seed_string". The "seed_string" can be generated by the following method where $(vm_name) contains the @@ -155,16 +155,16 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: ``seed_string=${mac:9:8}-${vm_name}`` - * - :kbd:`--part_info ` + * - ``--part_info `` - Set guest partition info path. - * - :kbd:`-r, --ramdisk ` + * - ``-r``, ``--ramdisk `` - Set the ramdisk (full path) for the User VM. The maximum length is 1023. The supported ramdisk format depends on your User VM kernel configuration. usage: ``-r /path/to/your/ramdisk_image`` - * - :kbd:`-s, --pci_slot ` + * - ``-s``, ``--pci_slot `` - Setup PCI device configuration. slot_config format is:: @@ -197,7 +197,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: This add virtual block in PCI slot 9 and use ``/root/test.img`` as the disk image - * - :kbd:`-U, --uuid ` + * - ``-U``, ``--uuid `` - Set UUID for a VM. Every VM is identified by a UUID. You can define that UUID with this option. If you don't use this option, a default one @@ -209,10 +209,10 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: set the newly created VM's UUID to ``42795636-1d31-6512-7432-087d33b34756`` - * - :kbd:`-v, --version` + * - ``-v``, ``--version`` - Show Device Model version - * - :kbd:`--vsbl ` + * - ``--vsbl `` - Virtual Slim bootloader (vSBL) is the virtual bootloader supporting booting of the User VM on the ACRN hypervisor platform. The vSBL design is derived from Slim Bootloader, which follows a staged design approach @@ -235,8 +235,8 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: uses ``/usr/share/acrn/bios/VSBL.bin`` as the vSBL image - * - :kbd:`--ovmf [w,]` - :kbd:`--ovmf [w,]code=,vars=` + * - ``--ovmf [w,]`` + ``--ovmf [w,]code=,vars=`` - Open Virtual Machine Firmware (OVMF) is an EDK II based project to enable UEFI support for Virtual Machines. @@ -269,7 +269,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: --ovmf w,/usr/share/acrn/bios/OVMF.fd - * - :kbd:`--cpu_affinity ` + * - ``--cpu_affinity `` - list of pCPUs assigned to this VM. Example:: @@ -278,7 +278,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: to assign physical CPUs (pCPUs) 1 and 3 to this VM. - * - :kbd:`--virtio_poll ` + * - ``--virtio_poll `` - Enable virtio poll mode with poll interval xxx ns. Example:: @@ -287,7 +287,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: enable virtio poll mode with poll interval 1ms. - * - :kbd:`--acpidev_pt ` + * - ``--acpidev_pt `` - This option is to enable ACPI device passthrough support. The ``HID`` is a mandatory parameter for this option which is the Hardware ID of the ACPI device. @@ -298,7 +298,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: To pass through a TPM (which HID is MSFT0101) ACPI device to a User VM. - * - :kbd:`--mmiodev_pt ` + * - ``--mmiodev_pt `` - This option is to enable MMIO device passthrough support. The ``MMIO_Region`` is a mandatory parameter for this option which is the MMIO resource of the MMIO device. The ``MMIO_Region`` needs to be the base address followed by @@ -312,17 +312,17 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: The base address of this region is 0xFED40000 and the size of the region is 0x00005000. - * - :kbd:`--vtpm2 ` + * - ``--vtpm2 `` - This option is to enable virtual TPM support. The sock_path is a mandatory parameter for this option which is the path of swtpm socket fd. - * - :kbd:`-W, --virtio_msix` + * - ``-W, --virtio_msix`` - This option forces virtio to use single-vector MSI. By default, any virtio-based devices will use MSI-X as its interrupt method. If you want to use single-vector MSI interrupt, you can do so using this option. - * - :kbd:`-Y, --mptgen` + * - ``-Y, --mptgen`` - Disable MPtable generation. The MultiProcessor Specification (MPS) for the x86 architecture is an open standard describing enhancements to both operating systems and @@ -333,7 +333,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: By default, DM will create the MPtable for you. Use this option to disable it. - * - :kbd:`--lapic_pt` + * - ``--lapic_pt`` - This option is to create a VM with the local APIC (LAPIC) passed-through. With this option, a VM is created with ``LAPIC_PASSTHROUGH`` and ``IO_COMPLETION_POLLING`` mode. This option is typically used for hard @@ -341,7 +341,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: By default, this option is not enabled. - * - :kbd:`--rtvm` + * - ``--rtvm`` - This option is used to create a VM with real-time attributes. With this option, a VM is created with ``GUEST_FLAG_RT`` and ``GUEST_FLAG_IO_COMPLETION_POLLING`` mode. This kind of VM is @@ -352,7 +352,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: By default, this option is not enabled. - * - :kbd:`--logger_setting ` + * - ``--logger_setting `` - This option sets the level of logging that is used for each log channel. The general format of this option is ``,level=``. Different log channels are separated by a semi-colon (``;``). The various @@ -361,7 +361,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: By default, the log severity level is set to 4 (``info``). - * - :kbd:`--pm_notify_channel ` + * - ``--pm_notify_channel `` - This option is used to define which channel could be used DM to communicate with VM about power management event. @@ -373,7 +373,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: Use ioc as power management event motify channel. - * - :kbd:`--pm_by_vuart [pty|tty],` + * - ``--pm_by_vuart [pty|tty],`` - This option is used to set a user OS power management by virtual UART. With acrn-dm UART emulation and hypervisor UART emulation and configure, service OS can communicate with user OS through virtual UART. By this @@ -391,7 +391,7 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters: For different User VM, it can be configured as needed. - * - :kbd:`--windows` + * - ``--windows`` - This option is used to run Windows User VMs. It supports Oracle ``virtio-blk``, ``virtio-net`` and ``virtio-input`` devices for Windows guests with secure boot.