acrn-hypervisor/devicemodel
Peter Fang 3d99082411 dm: support OVMF split images
In addition to a single OVMF image (OVMF.fd), split images
(OVMF_CODE.fd, OVMF_VARS.fd) can be used to facilitate VM management.

From the OVMF Whitepaper:

  The variable store and the firmware executable are also available in
  the build output as separate files entitled: "OVMF_VARS.fd" and
  "OVMF_CODE.fd". This enables central management and updates of the
  firmware executable, while each virtual machine can retain its own
  variable store.

An example to launch acrn-dm with the split images:

  --ovmf code=/usr/share/acrn/bios/OVMF_CODE.fd, \
  vars=/usr/share/acrn/bios/OVMF_VARS.fd

v1 -> v2:
- use memory-mapped file I/O for writeback
- use fcntl to lock OVMF image files

Tracked-On: #5487
Signed-off-by: Peter Fang <peter.fang@intel.com>
Acked-by: Wang, Yu1 <yu1.wang@intel.com>
2020-11-11 09:53:28 +08:00
..
arch/x86 dm:use acrn-dm logger function instread of fprintf 2019-11-14 15:34:04 +08:00
bios OVMF release v2.3 2020-10-30 15:45:31 +08:00
core dm: support OVMF split images 2020-11-11 09:53:28 +08:00
hw dm: virtio: check for paddr_guest2host return value 2020-11-06 15:08:30 +08:00
include dm: support OVMF split images 2020-11-11 09:53:28 +08:00
lib dm: Fix some issues from string operations 2018-12-25 18:40:04 +08:00
log DM: add wall time info into disk log file 2020-04-22 08:39:25 +08:00
MAINTAINERS update home page information 2018-05-15 17:19:39 +08:00
Makefile dm: mmio_dev: add mmio device pass through support 2020-07-23 20:13:20 +08:00
README.rst Documentation: clean-up of isolated README.rst files 2018-11-20 11:09:53 -08:00
samples acrn-config: refactor xmls/samples folder for acrn-config 2020-07-28 10:46:27 +08:00

README.rst

ACRN Device Model
#################

Introduction
============
The ACRN Device Model provides **device sharing** capabilities between the
Service OS and Guest OSs. It is a component that is used in conjunction with
the `ACRN Hypervisor`_ and this is installed within the Service OS. You can
find out more about Project ACRN on the `Project ACRN documentation`_ website.

.. _`ACRN Hypervisor`: https://github.com/projectacrn/acrn-hypervisor
.. _`Project ACRN documentation`: https://projectacrn.github.io/