调用文档

qemu-system-x86_64 [options] [disk_image] disk_image是 IDE 硬盘 0 的原始硬盘映像。某些目标不需要磁盘映像。

标准参数 Standard options

`-h`

功能显示帮助信息并退出
子参数
调用实例
```
qemu-system-riscv32 -h
```

`-version`

功能显示 qemu 版本信息并退出
子参数
调用实例
```
qemu-system-riscv32 -version
```

`-machine [type=]name[,prop=value[,...]]`

功能通过名称选择模拟器。使用 -machine help 可以查看可用的模拟器。对于支持跨版本实时迁移兼容性的架构，每个版本都会引入一个新的版本化模拟器类型。例如，2.8.0 版本为 x86_64/i686 架构引入了“pc-i440fx-2.8”和“pc-q35-2.8”。
子参数为了允许用户从 QEMU 2.8.0 版实时迁移到 QEMU 2.9.0 版，2.9.0 版也必须支持“pc-i440fx-2.8”和“pc-q35-2.8”机器。为了允许用户在升级时实时迁移 VMs 跳过多个中间版本，QEMU 的新版本将支持多个以前版本的机器类型。支持的机器属性有：
- accel=accels1[:accels2[:...]] This is used to enable an accelerator. Depending on the target architecture, kvm, xen, hax, hvf, nvmm, whpx or tcg can be available. By default, tcg is used. If there is more than one accelerator specified, the next one is used if the previous one fails to initialize.
- vmport=on|off|auto Enables emulation of VMWare IO port, for vmmouse etc. auto says to select the value based on accel. For accel=xen the default is off otherwise the default is on.
- dump-guest-core=on|off Include guest memory in a core dump. The default is on.
- mem-merge=on|off Enables or disables memory merge support. This feature, when supported by the host, de-duplicates identical memory pages among VMs instances (enabled by default).
- aes-key-wrap=on|off Enables or disables AES key wrapping support on s390-ccw hosts. This feature controls whether AES wrapping keys will be created to allow execution of AES cryptographic functions. The default is on.
- dea-key-wrap=on|off Enables or disables DEA key wrapping support on s390-ccw hosts. This feature controls whether DEA wrapping keys will be created to allow execution of DEA cryptographic functions. The default is on.
- nvdimm=on|off Enables or disables NVDIMM support. The default is off.
- memory-encryption= Memory encryption object to use. The default is none.
- hmat=on|off Enables or disables ACPI Heterogeneous Memory Attribute Table (HMAT) support. The default is off.
- memory-backend='id' An alternative to legacy -mem-path and mem-prealloc options. Allows to use a memory backend as main RAM. For example: :: -object memory-backend-file,id=pc.ram,size=512M,mem-path=/hugetlbfs,prealloc=on,share=on -machine memory-backend=pc.ram -m 512M Migration compatibility note: a) as backend id one shall use value of ‘default-ram-id’, advertised by machine type (available via query-machines QMP command), if migration to/from old QEMU (<5.0) is expected. b) for machine types 4.0 and older, user shall use x-use-canonical-path-for-ramblock-id=off backend option if migration to/from old QEMU (<5.0) is expected. For example: :: -object memory-backend-ram,id=pc.ram,size=512M,x-use-canonical-path-for-ramblock-id=off -machine memory-backend=pc.ram -m 512M

调用实例：

qemu-system-riscv32 -machine virt,mem-merge=on

`-cpu model`

功能选择 CPU 型号（-cpu help显示帮助列表和附加功能的选项）

默认情况会给客户机提供 qemu64 或 qemu32 的基本 CPU 模型。这样做可以对 CPU 特性提供一些高级的过滤功能，让客户机在同一组硬件平台上的动态迁移会更加平滑和安全。在客户机中查看 CPU 信息 (cat /proc/cpuinfo)，model name 就是当前 CPU 模型的名称。

调用实例
```
qemu-system-riscv32 -cpu rv32
```

`accel name[,prop=value[,...]]`

功能 This is used to enable an accelerator. Depending on the target architecture, kvm, xen, hax, hvf, nvmm, whpx or tcg can be available. By default, tcg is used. If there is more than one accelerator specified, the next one is used if the previous one fails to initialize.
子参数
- igd-passthru=on|off When Xen is in use, this option controls whether Intel integrated graphics devices can be passed through to the guest (default=off)
- kernel-irqchip=on|off|split Controls KVM in-kernel irqchip support. The default is full acceleration of the interrupt controllers. On x86, split irqchip reduces the kernel attack surface, at a performance cost for non-MSI interrupts. Disabling the in-kernel irqchip completely is not recommended except for debugging purposes.
- kvm-shadow-mem=size Defines the size of the KVM shadow MMU.
- split-wx=on|off Controls the use of split w^x mapping for the TCG code generation buffer. Some operating systems require this to be enabled, and in such a case this will default on. On other operating systems, this will default off, but one may enable this for testing or debugging.
- tb-size=n Controls the size (in MiB) of the TCG translation block cache.
- thread=single|multi Controls number of TCG threads. When the TCG is multi-threaded there will be one thread per vCPU therefore taking advantage of additional host cores. The default is to enable multi-threading where both the back-end and front-ends support it and no incompatible TCG features have been enabled (e.g. icount/replay).
- dirty-ring-size=n When the KVM accelerator is used, it controls the size of the per-vCPU dirty page ring buffer (number of entries for each vCPU). It should be a value that is power of two, and it should be 1024 or bigger (but still less than the maximum value that the kernel supports). 4096 could be a good initial value if you have no idea which is the best. Set this value to 0 to disable the feature. By default, this feature is disabled (dirty-ring-size=0). When enabled, KVM will instead record dirty pages in a bitmap.

`smp [[cpus=]n][,maxcpus=maxcpus][,sockets=sockets][,dies=dies][,cores=cores][,threads=threads]`

功能配置客户机的 SMP（Symmetric Multi-Processing），对称多处理机
子参数
- [cpus=]n 设置客户机中使用逻辑的 CPU 数量（默认值是 1）。
- [,maxcpus=cpus] 设置客户机最大可能被使用的 CPU 数量（可以用热插拔 hot-plug 添加 CPU，不能超过 maxcpus 上限）。
- [,cores=cores] 设置每个 CPU socket 上的 core 数量（默认值是 1）。
- [,threads=threads] 设置每个 CPU core 上的线程数（默认值是 1）。
- [,sockets=sockets] 设置客户机中总的 CPU socket 数量。
调用实例

qemu-system-x86_64  -smp 1,sockets=1,cores=2,threads=2

`-numa node[,mem=size][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]`

`-numa node[,memdev=id][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]`

`-numa dist,src=source,dst=destination,val=distance`

`-numa cpu,node-id=node[,socket-id=x][,core-id=y][,thread-id=z]`

`-numa hmat-lb,initiator=node,target=node,hierarchy=hierarchy,data-type=tpye[,latency=lat][,bandwidth=bw]`

`-numa hmat-cache,node-id=node,size=size,level=level[,associativity=str][,policy=str][,line=size]`

功能
子参数
调用实例

`-add-fd fd=fd,set=set[,opaque=opaque]`

功能
子参数
调用实例

`-set group.id.arg=value`

功能
子参数
调用实例

`-global driver.prop=value`

功能
子参数
调用实例

`-global driver=driver,property=property,value=value`

功能
子参数
调用实例

`-boot [order=drives][,once=drives][,menu=on|off][,splash=sp_name][,splash-time=sp_time][,reboot-timeout=rb_timeout][,strict=on|off]`

功能设置客户机启动顺序

在 qemu 模拟的 x86 平台中，用"a"、“b"分别表示第一和第二软驱，用"c"表示第一个硬盘，用"d"表示 CD-ROM 光驱，用"n"表示从网络启动。默认从硬盘启动。

子参数
- [order=drives] 设置启动顺序。
- [,once=drives] 只设置下一次启动的顺序，再重启后无效。
- [,menu=on|off] 只要固件/BIOS 支持，就可以启用交互式引导菜单/提示。默认为非交互式引导。
- [,splash=sp_name] 如果固件/BIOS 支持选项 splash=sp_name 和 menu=on，则可以将启动画面传递给 bios，使用户能够将其显示为徽标。目前 Seabios for X86 系统支持它。限制：启动文件可以是 24 BPP 格式（真彩色）的 jpeg 文件或 BMP 文件。分辨率应该是 SVGA 模式支持的，推荐 320x240、640x480、800x640。
- [,splash-time=sp_time]
- [,reboot-timeout=rb_timeout] 引导失败时，客户机将暂停 rb_timeout 毫秒，然后重新启动。如果 rb_timeout 为 ‘-1’，客户机不会重启，qemu 默认将 ‘-1’ 传递给 bios。目前 Seabios for X86 系统支持它。
- [,strict=on|off] 只要固件/BIOS 支持，就通过严格启动。这仅在 bootindex 选项更改引导优先级时有效。默认为非严格引导。

调用实例

# 尝试先从网络启动，然后从硬盘启动
qemu-system-x86_64 -boot order=nc
# 先从光驱启动，重启后切换回默认顺序
qemu-system-x86_64 -boot once=d
# 5 秒钟的启动画面。
qemu-system-x86_64 -boot menu=on,splash=/root/boot.bmp,splash-time=5000

`-m [size=]megs[,slots=n,maxmem=size]`

功能将客户机内存设置为 megs M字节。默认值为 128 MiB。或者，也可以使用“M”或“G”的后缀。齐。
子参数
- [size=]megs 将客户机内存设置为 megs M字节
- [,slots=n,maxmem=size] 可用于设置可热插拔内存插槽的数量和最大内存数量。maxmem 必须与页面大小对
调用实例以下命令行将客户机启动 RAM 大小设置为 1GB，创建 3 个插槽以热插拔额外内存，并将客户机可以达到的最大内存设置为 4GB：
```
qemu-system-x86_64 -m 1G,slots=3,maxmem=4G
```
如果未指定 slot 和 maxmem，则不会启用内存热插拔，并且客户机内存永远不会增加。

`-mem-path path`

功能使用huge page。对于内存访问密集型的应用，使用huge page是可以比较明显地提高客户机性能。使用huge page的内存不能被换出（swap out），也不能使用ballooning方式自动增长。
子参数
调用实例

`-mem-prealloc`

功能使宿主机在客户机启动时就全部分配好客户机的内存
子参数
调用实例

`-k language`

功能设置键盘布局语言，默认为en-us

子参数可用布局：

ar  de-ch  es  fo     fr-ca  hu  ja  mk     no  pt-br  sv
da  en-gb  et  fr     fr-ch  is  lt  nl     pl  ru     th
de  en-us  fi  fr-be  hr     it  lv  nl-be  pt  sl     tr

调用实例

块设备参数 Block device options

`fda file`

功能为客户机指定软盘设备，指定客户机的第一个软盘设备，在客户机中显示为/dev/fd0
子参数
调用实例

`fdb file`

功能为客户机指定软盘设备，指定客户机的第一个软盘设备，在客户机中显示为/dev/fd1
子参数
调用实例

`hda file`

`hdb file`

`hdc file`

`hdd file`

功能为客户机指定块存储设备，指定客户机种的第一个 IDE 设备
子参数若客户机使用PIIX_IDE驱动，显示为/dev/hda设备；若客户机使用ata_piix驱动，显示为/dev/sda设备。若没有使用-hdx的参数，则默认使用-hda参数；可以将宿主机的一块硬盘作为-hda的参数使用；若文件名包含逗号，应使用两个连续的逗号进行转义。
调用实例

`-cdrom file`

功能为客户机指定光盘 CD-ROM。可以将宿主机的光驱/dev/cdrom设备作为-cdrom参数使用。-cdrom参数不能与-hdc参数同时使用，因为-cdrom就是客户机里的第三个 IDE 设备
子参数
调用实例

`-blockdev option[,option[,option[,...]]]`

功能
子参数
调用实例

`-drive option[,option[,option[,...]]]`

功能定义一个存储驱动器
子参数
- [file=file] 加载file镜像文件到客户机的驱动器中。
- [,if=type] 指定驱动器使用的接口类型：可用的类类型有：ide、scsi、virtio、sd、floopy、pflash等。
- [,bus=n] 设置驱动器在客户机中的总线编号。
- [,unit=m] 设置驱动器在客户机中的单元编号。
- [,media=d] 设置驱动器中媒介的类型，值为 disk 或 cdrom。
- [,index=i] 设置在通一种接口的驱动器中的索引编号。
- [,snapshot=on|off] 当值为 on 时，qemu 不会将磁盘数据的更改写回到镜像文件中，而是写到临时文件中，可以在 qemu moinitor 中使用 commit 命令强制将磁盘数据保存回镜像文件中。
- [,cache=writethrough|writeback|none|directsync|unsafe] 设置宿主机对块设备数据访问的 cache 模式。， writethrough（直写模式）：调用 write 写入数据的同时将数据写入磁盘缓存和后端块设备中。 writeback（回写模式）：调用 write 写入数据时只将数据写入到磁盘缓存中，当数据被换出缓存时才写入到后端存储中。优点写入数据块，缺点系统掉电数据无法恢复。
- [,aio=threads|native] 选择异步 IO 的方式
- threads 为 aio 参数的默认值，让一个线程池去处理异步 IO；
- native 只适用于 cache=none 的情况，使用的是 Linux 原生的 AIO。
- [,format=f] 指定使用的磁盘格式，默认是 QEMU 自动检测磁盘格式的。
- [,serial=s] 指定分配给设备的序列号。
- [,addr=A] 分配给驱动器控制器的 PCI 地址，只在使用 virtio 接口时适用。
- [,id=name] 设置驱动器的 ID，可以在 QEMU monitor 中用 info block 看到。 [,readonly=on|off] 设置驱动器是否只读。
调用实例

USB 参数 USB convenience options

显示参数 Display options

仅限 i386 架构的参数 i386 target only

网络参数 Network options

字符设备参数 Character device options

TPM 设备 TPM device options

指定启动指引 Linux/Multiboot boot specific

当使用该调用参数时，你可以使用给定的 Linux 或者多重引导内核，而不需要安装内核到一个光盘中。这样可以更方便地测试不同内核。

-kernel bzImage
- 功能用 bzImage 作为内核镜像，也可以使用其他启动格式。
-append cmdline
- 功能用cmd命令行，作为内核的命令行
-initrd file
- 功能用文件作为初始化 ram
-initrd "file1 arg=foo,file2"
- 功能此语法仅适用于多重引导使用 file1 和 file2 作为模块并将 arg=foo 作为参数传递给第一个模块
-dtb file
- 功能将文件用作设备树二进制 (dtb) 映像并在启动时将其传递给内核

调用文档#

标准参数 Standard options#

-h#

-version#

-machine [type=]name[,prop=value[,...]]#

-cpu model#

accel name[,prop=value[,...]]#

smp [[cpus=]n][,maxcpus=maxcpus][,sockets=sockets][,dies=dies][,cores=cores][,threads=threads]#

-numa node[,mem=size][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]#

-numa node[,memdev=id][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]#

-numa dist,src=source,dst=destination,val=distance#

-numa cpu,node-id=node[,socket-id=x][,core-id=y][,thread-id=z]#

-numa hmat-lb,initiator=node,target=node,hierarchy=hierarchy,data-type=tpye[,latency=lat][,bandwidth=bw]#

-numa hmat-cache,node-id=node,size=size,level=level[,associativity=str][,policy=str][,line=size]#

-add-fd fd=fd,set=set[,opaque=opaque]#

-set group.id.arg=value#

-global driver.prop=value#

-global driver=driver,property=property,value=value#

-boot [order=drives][,once=drives][,menu=on|off][,splash=sp_name][,splash-time=sp_time][,reboot-timeout=rb_timeout][,strict=on|off]#

-m [size=]megs[,slots=n,maxmem=size]#

-mem-path path#

-mem-prealloc#

-k language#

块设备参数 Block device options#

fda file#

fdb file#

hda file#

hdb file#

hdc file#

hdd file#

-cdrom file#

-blockdev option[,option[,option[,...]]]#

-drive option[,option[,option[,...]]]#

USB 参数 USB convenience options#

显示参数 Display options#

仅限 i386 架构的参数 i386 target only#

网络参数 Network options#

字符设备参数 Character device options#

TPM 设备 TPM device options#

指定启动指引 Linux/Multiboot boot specific#

调用文档

标准参数 Standard options

`-h`

`-version`

`-machine [type=]name[,prop=value[,...]]`

`-cpu model`

`accel name[,prop=value[,...]]`

`smp [[cpus=]n][,maxcpus=maxcpus][,sockets=sockets][,dies=dies][,cores=cores][,threads=threads]`

`-numa node[,mem=size][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]`

`-numa node[,memdev=id][,cpus=firstcpu[-lastcpu]][,nodeid=node][,initiator=initiator]`

`-numa dist,src=source,dst=destination,val=distance`

`-numa cpu,node-id=node[,socket-id=x][,core-id=y][,thread-id=z]`

`-numa hmat-lb,initiator=node,target=node,hierarchy=hierarchy,data-type=tpye[,latency=lat][,bandwidth=bw]`

`-numa hmat-cache,node-id=node,size=size,level=level[,associativity=str][,policy=str][,line=size]`

`-add-fd fd=fd,set=set[,opaque=opaque]`

`-set group.id.arg=value`

`-global driver.prop=value`

`-global driver=driver,property=property,value=value`

`-boot [order=drives][,once=drives][,menu=on|off][,splash=sp_name][,splash-time=sp_time][,reboot-timeout=rb_timeout][,strict=on|off]`

`-m [size=]megs[,slots=n,maxmem=size]`

`-mem-path path`

`-mem-prealloc`

`-k language`

块设备参数 Block device options

`fda file`

`fdb file`

`hda file`

`hdb file`

`hdc file`

`hdd file`

`-cdrom file`

`-blockdev option[,option[,option[,...]]]`

`-drive option[,option[,option[,...]]]`

USB 参数 USB convenience options

显示参数 Display options

仅限 i386 架构的参数 i386 target only

网络参数 Network options

字符设备参数 Character device options

TPM 设备 TPM device options

指定启动指引 Linux/Multiboot boot specific