tree: 6c3da68ebb8a85fc449d0b5167a519cf4f413e21 [path history] [tgz]
  1. client_vm_csr/
  2. comm/
  3. demo_apk/
  4. fake_chain/
  5. manager/
  6. requests/
  7. test_apk/
  8. README.md
service_vm/README.md

Service VM

The Service VM is a lightweight, bare-metal virtual machine specifically designed to run various services for other virtual machines. It fulfills the following requirements:

  • Only one instance of the Service VM is allowed to run at any given time.
  • The instance ID of the Service VM remains unchanged during updates of both the client VMs and the Service VM.

The instance ID is incorporated into the CDI values calculation of each VM loaded by pVM Firmware to ensure consistent CDI values for the VM across all reboots.

Architecture

Rialto is used as the bare-metal kernel for the Service VM. It shares some low-level setup, such as memory management and virtio device parsing, with pvmfw. The common setup code is grouped in vmbase/.

Functionality

The main functionality of the Service VM is to process requests from the host and provide responses for each request. The requests and responses are serialized in CBOR format and transmitted over a virtio-vsock device.

  • ./comm contains the definitions for the requests and responses.
  • ./requests contains the library that processes the requests.
  • ./manager manages the Service VM session, ensuring that only one Service VM is active at any given time. The virtualizationservice process owns and manages the Service VM instance.

RKP VM (Remote Key Provisioning Virtual Machine)

Currently, the Service VM only supports VM remote attestation, and in that context we refer to it as the RKP VM. The RKP VM undergoes validation by the RKP Server and functions as a remotely provisioned component responsible for verifying the integrity of other virtual machines. See VM remote attestation for more details about the role of RKP VM in remote attestation.