Next steps

After the first session works, pick the next chapter by goal. This page only routes readers; it does not duplicate chapter content.

Understand how the system works

Start with Architecture overview, read Components and responsibilities to understand the QEMU functional, gem5 performance and vfio-user split, then continue with Execution flow and Memory and shared memory model.

Use and extend the launcher

Commands, the YAML-to-plan pipeline, session lifecycle and debugging are in chapter 3:

• Commands and options

• YAML loading, templates and plans

• Session lifecycle and resources

• Debugging sessions

Go deeper into simulators and the driver

QEMU as vhost and device model, the gem5 MI300X performance model and guest driver requirements are in chapter 4:

• QEMU and gem5: functional and performance simulation

• MI300X performance model

• Guest driver requirements

Write your own topology

Machine catalog, host and device configuration, vHost and how to write a topology YAML are in chapter 5:

• Topology and hardware support

• Machine catalog

• How to write a topology YAML

Look up facts and troubleshoot

Schemas, parameters, versions, artifact paths and known issues are in chapter 6:

• Guest parameters

• Version matrix

• Files, artifacts and source map

• Known issues

Related pages

• Getting Started

• Verify the guest

• Architecture overview

• Cosim Launcher

• Topology and hardware support